@cesium/engine 24.0.0 → 26.0.0

package/Source/Scene/GltfTextureLoader.js

@@ -83,7 +83,6 @@ class GltfTextureLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfTextureLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -96,7 +95,6 @@ class GltfTextureLoader extends ResourceLoader {
   /**
    * The texture.
    *
-   * @memberof GltfTextureLoader.prototype
    *
    * @type {Texture}
    * @readonly

package/Source/Scene/GltfVertexBufferLoader.js

@@ -135,7 +135,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * The cache key of the resource.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {string}
    * @readonly
@@ -148,7 +147,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * The vertex buffer. This is only defined when <code>loadAsTypedArray</code> is false.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {Buffer}
    * @readonly
@@ -161,7 +159,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * The typed array containing vertex buffer data. This is only defined when <code>loadAsTypedArray</code> is true.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {Uint8Array}
    * @readonly
@@ -174,7 +171,6 @@ class GltfVertexBufferLoader extends ResourceLoader {
   /**
    * Information about the quantized vertex attribute after Draco decode.
    *
-   * @memberof GltfVertexBufferLoader.prototype
    *
    * @type {ModelComponents.Quantization}
    * @readonly

package/Source/Scene/HeightReference.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Represents the position relative to the terrain.
  *
@@ -54,7 +56,9 @@ const HeightReference = {
   RELATIVE_TO_3D_TILE: 6,
 };
 
-export default Object.freeze(HeightReference);
+Object.freeze(HeightReference);
+
+export default HeightReference;
 
 /**
  * Returns true if the height should be clamped to the surface

package/Source/Scene/HorizontalOrigin.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * The horizontal location of an origin relative to an object, e.g., a {@link Billboard}
  * or {@link Label}.  For example, setting the horizontal origin to <code>LEFT</code>
@@ -38,4 +40,7 @@ const HorizontalOrigin = {
    */
   RIGHT: -1,
 };
-export default Object.freeze(HorizontalOrigin);
+
+Object.freeze(HorizontalOrigin);
+
+export default HorizontalOrigin;

package/Source/Scene/ImageryProvider.js

@@ -5,7 +5,7 @@ import loadKTX2 from "../Core/loadKTX2.js";
 import Resource from "../Core/Resource.js";
 
 /**
- * @typedef {HTMLImageElement|HTMLCanvasElement|ImageBitmap} ImageryTypes
+ * @typedef {HTMLImageElement|HTMLCanvasElement|ImageBitmap|OffscreenCanvas} ImageryTypes
  *
  * The format in which {@link ImageryProvider} methods return an image may
  * vary by provider, configuration, or server settings.  Most common are

package/Source/Scene/ImageryState.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * @private
  */
@@ -11,4 +13,7 @@ const ImageryState = {
   INVALID: 6,
   PLACEHOLDER: 7,
 };
-export default Object.freeze(ImageryState);
+
+Object.freeze(ImageryState);
+
+export default ImageryState;

package/Source/Scene/Implicit3DTileContent.js

@@ -27,219 +27,225 @@ import BoundingVolumeSemantics from "./BoundingVolumeSemantics.js";
  * </p>
  * This object is normally not instantiated directly, use {@link Implicit3DTileContent.fromSubtreeJson}.
  *
- * @alias Implicit3DTileContent
- * @constructor
- *
- * @param {Cesium3DTileset} tileset The tileset this content belongs to
- * @param {Cesium3DTile} tile The tile this content belongs to.
- * @param {Resource} resource The resource for the tileset
- * @param {object} [json] The JSON object containing the subtree. Mutually exclusive with arrayBuffer.
- * @param {ArrayBuffer} [arrayBuffer] The array buffer that stores the content payload. Mutually exclusive with json.
- * @param {number} [byteOffset=0] The offset into the array buffer, if one was provided
- *
- * @exception {DeveloperError} One of json and arrayBuffer must be defined.
- *
+ * @implements Cesium3DTileContent
  * @private
  * @experimental This feature is using part of the 3D Tiles spec that is not final and is subject to change without Cesium's standard deprecation policy.
  */
-function Implicit3DTileContent(tileset, tile, resource) {
-  //>>includeStart('debug', pragmas.debug);
-  Check.defined("tile.implicitTileset", tile.implicitTileset);
-  Check.defined("tile.implicitCoordinates", tile.implicitCoordinates);
-  //>>includeEnd('debug');
-
-  const implicitTileset = tile.implicitTileset;
-  const implicitCoordinates = tile.implicitCoordinates;
-
-  this._implicitTileset = implicitTileset;
-  this._implicitCoordinates = implicitCoordinates;
-  this._implicitSubtree = undefined;
-  this._tileset = tileset;
-  this._tile = tile;
-  this._resource = resource;
-
-  this._metadata = undefined;
-
-  this.featurePropertiesDirty = false;
-  this._group = undefined;
-
-  const templateValues = implicitCoordinates.getTemplateValues();
-  const subtreeResource = implicitTileset.subtreeUriTemplate.getDerivedResource(
-    {
-      templateValues: templateValues,
-    },
-  );
-  this._url = subtreeResource.getUrlComponent(true);
-
-  this._ready = false;
-}
+class Implicit3DTileContent {
+  /**
+   * @param {Cesium3DTileset} tileset The tileset this content belongs to
+   * @param {Cesium3DTile} tile The tile this content belongs to.
+   * @param {Resource} resource The resource for the tileset
+   * @param {object} [json] The JSON object containing the subtree. Mutually exclusive with arrayBuffer.
+   * @param {ArrayBuffer} [arrayBuffer] The array buffer that stores the content payload. Mutually exclusive with json.
+   * @param {number} [byteOffset=0] The offset into the array buffer, if one was provided
+   *
+   * @exception {DeveloperError} One of json and arrayBuffer must be defined.
+   */
+  constructor(tileset, tile, resource) {
+    //>>includeStart('debug', pragmas.debug);
+    Check.defined("tile.implicitTileset", tile.implicitTileset);
+    Check.defined("tile.implicitCoordinates", tile.implicitCoordinates);
+    //>>includeEnd('debug');
+
+    const implicitTileset = tile.implicitTileset;
+    const implicitCoordinates = tile.implicitCoordinates;
+
+    this._implicitTileset = implicitTileset;
+    this._implicitCoordinates = implicitCoordinates;
+    this._implicitSubtree = undefined;
+    this._tileset = tileset;
+    this._tile = tile;
+    this._resource = resource;
+
+    this._metadata = undefined;
+
+    this.featurePropertiesDirty = false;
+    this._group = undefined;
+
+    const templateValues = implicitCoordinates.getTemplateValues();
+    const subtreeResource =
+      implicitTileset.subtreeUriTemplate.getDerivedResource({
+        templateValues: templateValues,
+      });
+    this._url = subtreeResource.getUrlComponent(true);
+
+    this._ready = false;
+  }
 
-Object.defineProperties(Implicit3DTileContent.prototype, {
-  featuresLength: {
-    get: function () {
-      return 0;
-    },
-  },
+  get featuresLength() {
+    return 0;
+  }
 
-  pointsLength: {
-    get: function () {
-      return 0;
-    },
-  },
+  get pointsLength() {
+    return 0;
+  }
 
-  trianglesLength: {
-    get: function () {
-      return 0;
-    },
-  },
+  get trianglesLength() {
+    return 0;
+  }
 
-  geometryByteLength: {
-    get: function () {
-      return 0;
-    },
-  },
+  get geometryByteLength() {
+    return 0;
+  }
 
-  texturesByteLength: {
-    get: function () {
-      return 0;
-    },
-  },
+  get texturesByteLength() {
+    return 0;
+  }
 
-  batchTableByteLength: {
-    get: function () {
-      return 0;
-    },
-  },
+  get batchTableByteLength() {
+    return 0;
+  }
 
-  innerContents: {
-    get: function () {
-      return undefined;
-    },
-  },
+  get innerContents() {
+    return undefined;
+  }
 
   /**
    * Returns true when the tile's content is ready to render; otherwise false
    *
-   * @memberof Implicit3DTileContent.prototype
    *
    * @type {boolean}
    * @readonly
    * @private
    */
-  ready: {
-    get: function () {
-      return this._ready;
-    },
-  },
+  get ready() {
+    return this._ready;
+  }
 
-  tileset: {
-    get: function () {
-      return this._tileset;
-    },
-  },
+  get tileset() {
+    return this._tileset;
+  }
 
-  tile: {
-    get: function () {
-      return this._tile;
-    },
-  },
+  get tile() {
+    return this._tile;
+  }
 
-  url: {
-    get: function () {
-      return this._url;
-    },
-  },
+  get url() {
+    return this._url;
+  }
 
   /**
    * Part of the {@link Cesium3DTileContent} interface. <code>Implicit3DTileContent</code>
    * always returns <code>undefined</code>. Only transcoded tiles have content metadata.
-   * @memberof Implicit3DTileContent.prototype
    * @private
    */
-  metadata: {
-    get: function () {
-      return undefined;
-    },
-    set: function () {
-      //>>includeStart('debug', pragmas.debug);
-      throw new DeveloperError("Implicit3DTileContent cannot have metadata");
-      //>>includeEnd('debug');
-    },
-  },
-
-  batchTable: {
-    get: function () {
-      return undefined;
-    },
-  },
+  get metadata() {
+    return undefined;
+  }
 
-  group: {
-    get: function () {
-      return this._group;
-    },
-    set: function (value) {
-      this._group = value;
-    },
-  },
-});
+  set metadata(_) {
+    //>>includeStart('debug', pragmas.debug);
+    throw new DeveloperError("Implicit3DTileContent cannot have metadata");
+    //>>includeEnd('debug');
+  }
 
-/**
- * Initialize the implicit content by parsing the subtree resource and setting
- * up a promise chain to expand the immediate subtree.
- *
- * @param {Cesium3DTileset} tileset The tileset this content belongs to
- * @param {Cesium3DTile} tile The tile this content belongs to.
- * @param {Resource} resource The resource for the tileset
- * @param {object} [json] The JSON containing the subtree. Mutually exclusive with arrayBuffer.
- * @param {ArrayBuffer} [arrayBuffer] The ArrayBuffer containing a subtree binary. Mutually exclusive with json.
- * @param {number} [byteOffset=0] The byte offset into the arrayBuffer
- * @return {Promise<Implicit3DTileContent>}
- *
- * @exception {DeveloperError} One of json and arrayBuffer must be defined.
- *
- * @private
- */
-Implicit3DTileContent.fromSubtreeJson = async function (
-  tileset,
-  tile,
-  resource,
-  json,
-  arrayBuffer,
-  byteOffset,
-) {
-  //>>includeStart('debug', pragmas.debug);
-  Check.defined("tile.implicitTileset", tile.implicitTileset);
-  Check.defined("tile.implicitCoordinates", tile.implicitCoordinates);
-  if (defined(json) === defined(arrayBuffer)) {
-    throw new DeveloperError("One of json and arrayBuffer must be defined.");
+  get batchTable() {
+    return undefined;
   }
-  //>>includeEnd('debug');
 
-  byteOffset = byteOffset ?? 0;
-  let uint8Array;
-  if (defined(arrayBuffer)) {
-    uint8Array = new Uint8Array(arrayBuffer, byteOffset);
+  get group() {
+    return this._group;
   }
 
-  const implicitTileset = tile.implicitTileset;
-  const implicitCoordinates = tile.implicitCoordinates;
+  set group(value) {
+    this._group = value;
+  }
 
-  const subtree = await ImplicitSubtree.fromSubtreeJson(
+  /**
+   * Initialize the implicit content by parsing the subtree resource and setting
+   * up a promise chain to expand the immediate subtree.
+   *
+   * @param {Cesium3DTileset} tileset The tileset this content belongs to
+   * @param {Cesium3DTile} tile The tile this content belongs to.
+   * @param {Resource} resource The resource for the tileset
+   * @param {object} [json] The JSON containing the subtree. Mutually exclusive with arrayBuffer.
+   * @param {ArrayBuffer} [arrayBuffer] The ArrayBuffer containing a subtree binary. Mutually exclusive with json.
+   * @param {number} [byteOffset=0] The byte offset into the arrayBuffer
+   * @return {Promise<Implicit3DTileContent>}
+   *
+   * @exception {DeveloperError} One of json and arrayBuffer must be defined.
+   *
+   * @private
+   */
+  static async fromSubtreeJson(
+    tileset,
+    tile,
     resource,
     json,
-    uint8Array,
-    implicitTileset,
-    implicitCoordinates,
-  );
+    arrayBuffer,
+    byteOffset,
+  ) {
+    //>>includeStart('debug', pragmas.debug);
+    Check.defined("tile.implicitTileset", tile.implicitTileset);
+    Check.defined("tile.implicitCoordinates", tile.implicitCoordinates);
+    if (defined(json) === defined(arrayBuffer)) {
+      throw new DeveloperError("One of json and arrayBuffer must be defined.");
+    }
+    //>>includeEnd('debug');
+
+    byteOffset = byteOffset ?? 0;
+    let uint8Array;
+    if (defined(arrayBuffer)) {
+      uint8Array = new Uint8Array(arrayBuffer, byteOffset);
+    }
+
+    const implicitTileset = tile.implicitTileset;
+    const implicitCoordinates = tile.implicitCoordinates;
+
+    const subtree = await ImplicitSubtree.fromSubtreeJson(
+      resource,
+      json,
+      uint8Array,
+      implicitTileset,
+      implicitCoordinates,
+    );
+
+    const content = new Implicit3DTileContent(tileset, tile, resource);
 
-  const content = new Implicit3DTileContent(tileset, tile, resource);
+    content._implicitSubtree = subtree;
+    expandSubtree(content, subtree);
+    content._ready = true;
 
-  content._implicitSubtree = subtree;
-  expandSubtree(content, subtree);
-  content._ready = true;
+    return content;
+  }
 
-  return content;
-};
+  /**
+   * Part of the {@link Cesium3DTileContent} interface.  <code>Implicit3DTileContent</code>
+   * always returns <code>false</code> since a tile of this type does not have any features.
+   * @private
+   */
+  hasProperty(batchId, name) {
+    return false;
+  }
+
+  /**
+   * Part of the {@link Cesium3DTileContent} interface.  <code>Implicit3DTileContent</code>
+   * always returns <code>undefined</code> since a tile of this type does not have any features.
+   * @private
+   */
+  getFeature(batchId) {
+    return undefined;
+  }
+
+  applyDebugSettings(enabled, color) {}
+  applyStyle(style) {}
+  update(tileset, frameState) {}
+
+  pick(ray, frameState, result) {
+    return undefined;
+  }
+
+  isDestroyed() {
+    return false;
+  }
+
+  destroy() {
+    this._implicitSubtree =
+      this._implicitSubtree && this._implicitSubtree.destroy();
+    return destroyObject(this);
+  }
+}
 
 /**
  * Expand a single subtree placeholder tile. This transcodes the subtree into
@@ -1157,47 +1163,6 @@ function makeTile(content, baseResource, tileJson, parentTile) {
   return new Cesium3DTile(content._tileset, baseResource, tileJson, parentTile);
 }
 
-/**
- * Part of the {@link Cesium3DTileContent} interface.  <code>Implicit3DTileContent</code>
- * always returns <code>false</code> since a tile of this type does not have any features.
- * @private
- */
-Implicit3DTileContent.prototype.hasProperty = function (batchId, name) {
-  return false;
-};
-
-/**
- * Part of the {@link Cesium3DTileContent} interface.  <code>Implicit3DTileContent</code>
- * always returns <code>undefined</code> since a tile of this type does not have any features.
- * @private
- */
-Implicit3DTileContent.prototype.getFeature = function (batchId) {
-  return undefined;
-};
-
-Implicit3DTileContent.prototype.applyDebugSettings = function (
-  enabled,
-  color,
-) {};
-
-Implicit3DTileContent.prototype.applyStyle = function (style) {};
-
-Implicit3DTileContent.prototype.update = function (tileset, frameState) {};
-
-Implicit3DTileContent.prototype.pick = function (ray, frameState, result) {
-  return undefined;
-};
-
-Implicit3DTileContent.prototype.isDestroyed = function () {
-  return false;
-};
-
-Implicit3DTileContent.prototype.destroy = function () {
-  this._implicitSubtree =
-    this._implicitSubtree && this._implicitSubtree.destroy();
-  return destroyObject(this);
-};
-
 // Exposed for testing
 Implicit3DTileContent._deriveBoundingBox = deriveBoundingBox;
 Implicit3DTileContent._deriveBoundingRegion = deriveBoundingRegion;

package/Source/Scene/ImplicitSubdivisionScheme.js

@@ -45,4 +45,6 @@ ImplicitSubdivisionScheme.getBranchingFactor = function (subdivisionScheme) {
   }
 };
 
-export default Object.freeze(ImplicitSubdivisionScheme);
+Object.freeze(ImplicitSubdivisionScheme);
+
+export default ImplicitSubdivisionScheme;

package/Source/Scene/InstanceAttributeSemantic.js

@@ -76,4 +76,6 @@ InstanceAttributeSemantic.fromGltfSemantic = function (gltfSemantic) {
   return undefined;
 };
 
-export default Object.freeze(InstanceAttributeSemantic);
+Object.freeze(InstanceAttributeSemantic);
+
+export default InstanceAttributeSemantic;

package/Source/Scene/IonWorldImageryStyle.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 // Note, these values map directly to ion asset ids.
 
 /**
@@ -30,4 +32,7 @@ const IonWorldImageryStyle = {
    */
   ROAD: 4,
 };
-export default Object.freeze(IonWorldImageryStyle);
+
+Object.freeze(IonWorldImageryStyle);
+
+export default IonWorldImageryStyle;

package/Source/Scene/JobType.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * @private
  */
@@ -7,4 +9,7 @@ const JobType = {
   BUFFER: 2,
   NUMBER_OF_JOB_TYPES: 3,
 };
-export default Object.freeze(JobType);
+
+Object.freeze(JobType);
+
+export default JobType;

package/Source/Scene/LabelStyle.js

@@ -1,3 +1,5 @@
+// @ts-check
+
 /**
  * Describes how to draw a label.
  *
@@ -30,4 +32,7 @@ const LabelStyle = {
    */
   FILL_AND_OUTLINE: 2,
 };
-export default Object.freeze(LabelStyle);
+
+Object.freeze(LabelStyle);
+
+export default LabelStyle;