Create @cesium/utils package

Specs/BadGeometry.js

@@ -1,4 +1,5 @@
-import { queryToObject, RuntimeError } from "@cesium/engine";
+import { queryToObject } from "@cesium/engine";
+import { RuntimeError } from "@cesium/utils";
 
 function BadGeometry() {
   this._workerName = "../../Build/Specs/TestWorkers/createBadGeometry";

Specs/Cesium3DTilesTester.js

@@ -1,15 +1,15 @@
 import {
   Cartesian3,
+  Cesium3DTileContentFactory,
+  Cesium3DTileset,
   Color,
   Frozen,
-  defined,
-  JulianDate,
   ImageBasedLighting,
+  JulianDate,
   Resource,
-  Cesium3DTileContentFactory,
-  Cesium3DTileset,
   TileBoundingSphere,
 } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 import pollToPromise from "./pollToPromise.js";
 

Specs/DomEventSimulator.js

@@ -1,4 +1,5 @@
-import { Frozen, FeatureDetection } from "@cesium/engine";
+import { Frozen } from "@cesium/engine";
+import { FeatureDetection } from "@cesium/utils";
 
 function createMouseEvent(type, options) {
   options = options ?? Frozen.EMPTY_OBJECT;

Specs/ImplicitTilingTester.js

@@ -1,4 +1,4 @@
-import { defined } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 import concatTypedArrays from "./concatTypedArrays.js";
 import MetadataTester from "./MetadataTester.js";
 

Specs/MetadataTester.js

@@ -1,15 +1,13 @@
 import {
-  defined,
   Frozen,
-  DeveloperError,
-  FeatureDetection,
-  PropertyTable,
   MetadataClass,
   MetadataComponentType,
   MetadataEnum,
   MetadataTable,
   MetadataType,
+  PropertyTable,
 } from "@cesium/engine";
+import { defined, DeveloperError, FeatureDetection } from "@cesium/utils";
 
 function MetadataTester() {}
 

Specs/MockDataSource.js

@@ -1,4 +1,4 @@
-import { Event, EntityCluster, EntityCollection } from "@cesium/engine";
+import { EntityCluster, EntityCollection, Event } from "@cesium/engine";
 
 function MockDataSource() {
   //Values to be fiddled with by the test

Specs/MockImageryProvider.js

@@ -1,11 +1,7 @@
+import { Event, GeographicTilingScheme, Resource } from "@cesium/engine";
+import { RuntimeError } from "@cesium/utils";
 import createTileKey from "./createTileKey.js";
 import runLater from "./runLater.js";
-import {
-  Event,
-  GeographicTilingScheme,
-  Resource,
-  RuntimeError,
-} from "@cesium/engine";
 
 function MockImageryProvider() {
   this.tilingScheme = new GeographicTilingScheme();

Specs/MockTerrainProvider.js

@@ -1,13 +1,12 @@
-import createTileKey from "./createTileKey.js";
-import runLater from "./runLater.js";
 import {
-  defined,
   Event,
   GeographicTilingScheme,
   HeightmapTerrainData,
-  RuntimeError,
   TerrainProvider,
 } from "@cesium/engine";
+import { defined, RuntimeError } from "@cesium/utils";
+import createTileKey from "./createTileKey.js";
+import runLater from "./runLater.js";
 
 function MockTerrainProvider() {
   this.tilingScheme = new GeographicTilingScheme();

Specs/TerrainTileProcessor.js

@@ -1,7 +1,7 @@
 import {
   clone,
-  ImageryLayer,
   GlobeSurfaceTile,
+  ImageryLayer,
   TerrainState,
   Texture,
 } from "@cesium/engine";

Specs/ViewportPrimitive.js

@@ -1,4 +1,5 @@
-import { defined, destroyObject, Pass, RenderState } from "@cesium/engine";
+import { destroyObject, Pass, RenderState } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 const ViewportPrimitive = function (fragmentShader) {
   this._fs = fragmentShader;

Specs/addDefaultMatchers.js

@@ -1,17 +1,15 @@
 import {
-  Cartesian2,
-  defined,
-  DeveloperError,
-  FeatureDetection,
-  PrimitiveType,
   Buffer,
   BufferUsage,
+  Cartesian2,
   ClearCommand,
   DrawCommand,
+  Math as CesiumMath,
+  PrimitiveType,
   ShaderProgram,
   VertexArray,
-  Math as CesiumMath,
 } from "@cesium/engine";
+import { defined, DeveloperError, FeatureDetection } from "@cesium/utils";
 import equals from "./equals.js";
 
 function createMissingFunctionMessageFunction(

Specs/createCamera.js

@@ -1,11 +1,11 @@
 import {
+  Camera,
   Cartesian3,
   Frozen,
-  defined,
   GeographicProjection,
   Matrix4,
-  Camera,
 } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 function MockScene(canvas) {
   canvas = canvas ?? {

Specs/createDynamicGeometryUpdaterSpecs.js

@@ -1,10 +1,10 @@
 import {
   BoundingSphere,
-  JulianDate,
   BoundingSphereState,
   EllipsoidGeometryUpdater,
-  PrimitiveCollection,
+  JulianDate,
   Math as CesiumMath,
+  PrimitiveCollection,
 } from "@cesium/engine";
 
 import createDynamicProperty from "./createDynamicProperty.js";

Specs/createFrameState.js

@@ -1,11 +1,11 @@
 import {
   Atmosphere,
-  GeographicProjection,
-  JulianDate,
   Camera,
   CreditDisplay,
   FrameState,
+  GeographicProjection,
   JobScheduler,
+  JulianDate,
 } from "@cesium/engine";
 
 function createFrameState(context, camera, frameNumber, time) {

Specs/createGeometryUpdaterGroundGeometrySpecs.js

@@ -1,14 +1,14 @@
 import {
+  ClassificationType,
   Color,
-  GeometryOffsetAttribute,
-  JulianDate,
   ColorMaterialProperty,
   ConstantProperty,
-  SampledProperty,
-  ClassificationType,
+  GeometryOffsetAttribute,
   GroundPrimitive,
   HeightReference,
+  JulianDate,
   PrimitiveCollection,
+  SampledProperty,
 } from "@cesium/engine";
 
 function createGeometryUpdaterGroundGeometrySpecs(

Specs/createGeometryUpdaterSpecs.js

@@ -1,19 +1,19 @@
 import {
   Color,
   ColorGeometryInstanceAttribute,
-  DistanceDisplayCondition,
-  DistanceDisplayConditionGeometryInstanceAttribute,
-  JulianDate,
-  ShowGeometryInstanceAttribute,
-  TimeInterval,
   ColorMaterialProperty,
   ConstantProperty,
+  DistanceDisplayCondition,
+  DistanceDisplayConditionGeometryInstanceAttribute,
   EllipsoidGeometryUpdater,
   Entity,
   GridMaterialProperty,
+  JulianDate,
   SampledProperty,
-  TimeIntervalCollectionProperty,
   ShadowMode,
+  ShowGeometryInstanceAttribute,
+  TimeInterval,
+  TimeIntervalCollectionProperty,
 } from "@cesium/engine";
 
 function createGeometryUpdaterSpecs(

Specs/createPackableSpecs.js

@@ -1,4 +1,5 @@
-import { defined, Math as CesiumMath } from "@cesium/engine";
+import { Math as CesiumMath } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 function createPackableSpecs(packable, instance, packedInstance, namePrefix) {
   namePrefix = namePrefix ?? "";

Specs/createScene.js

@@ -1,4 +1,5 @@
-import { Cartesian2, clone, defined, Scene } from "@cesium/engine";
+import { Cartesian2, clone, Scene } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 import createCanvas from "./createCanvas.js";
 import getWebGLStub from "./getWebGLStub.js";

Specs/createTileKey.js

@@ -1,4 +1,4 @@
-import { defined, DeveloperError } from "@cesium/engine";
+import { defined, DeveloperError } from "@cesium/utils";
 
 function createTileKey(xOrTile, y, level) {
   if (!defined(xOrTile)) {

Specs/equals.js

@@ -1,4 +1,4 @@
-import { FeatureDetection } from "@cesium/engine";
+import { FeatureDetection } from "@cesium/utils";
 
 function isTypedArray(o) {
   return FeatureDetection.typedArrayTypes.some(function (type) {

Specs/equalsMethodEqualityTester.js

@@ -1,4 +1,4 @@
-import { defined } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 function equalsMethodEqualityTester(a, b) {
   let to_run;

Specs/getWebGLStub.js

@@ -1,4 +1,5 @@
-import { clone, defined, DeveloperError, WebGLConstants } from "@cesium/engine";
+import { clone, WebGLConstants } from "@cesium/engine";
+import { defined, DeveloperError } from "@cesium/utils";
 
 function getWebGLStub(canvas, options) {
   const stub = clone(WebGLConstants);

Specs/pick.js

@@ -1,14 +1,14 @@
 import {
   BoundingRectangle,
-  Color,
-  defined,
   ClearCommand,
-  Pass,
+  Color,
   CreditDisplay,
   FrameState,
   JobScheduler,
+  Pass,
   PickFramebuffer,
 } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 function executeCommands(context, passState, commands) {
   const length = commands.length;

Specs/render.js

@@ -1,4 +1,5 @@
-import { defined, Intersect, Pass, SceneMode } from "@cesium/engine";
+import { Intersect, Pass, SceneMode } from "@cesium/engine";
+import { defined } from "@cesium/utils";
 
 function executeCommands(frameState, commands) {
   let commandsExecuted = 0;

Specs/spec-main.js

@@ -1,5 +1,6 @@
+import { defined } from "@cesium/utils";
+import { queryToObject } from "../packages/engine/index.js";
 import customizeJasmine from "./customizeJasmine.js";
-import { defined, queryToObject } from "../packages/engine/index.js";
 
 const queryString = queryToObject(window.location.search.substring(1));
 

Tools/jsdoc/conf.json

@@ -5,19 +5,25 @@
     "source": {
         "include": [
             "packages/engine/Source",
-            "packages/widgets/Source"
+            "packages/widgets/Source",
+            "packages/utils/Source"
         ],
         "exclude": [
             "packages/engine/Source/ThirdParty",
             "packages/engine/Source/Workers",
             "packages/widgets/Source/ThirdParty"
         ],
-        "includePattern": ".+\\.js(doc)?$",
+        "includePattern": ".+\\.(js(doc)?|ts)$",
         "excludePattern": "(^|\\/|\\\\)_"
     },
     "plugins": [
-        "./Tools/jsdoc/cesiumTags"
+      "./node_modules/jsdoc-babel",
+      "./Tools/jsdoc/cesiumTags"
     ],
+    "babel": {
+      "extensions": ["ts"],
+      "presets": ["@babel/preset-typescript"]
+    },
     "templates": {
         "cleverLinks": true,
         "default": {
@@ -30,4 +36,4 @@
         "template": "./Tools/jsdoc/cesium_template",
         "recurse": true
     }
-}
+}