@cesium/engine 2.0.0 → 2.2.0

package/Source/Scene/ImplicitSubtree.js

@@ -22,34 +22,24 @@ import ResourceCache from "./ResourceCache.js";
  * Subtrees also handle content metadata and metadata about the subtree itself.
  * </p>
  *
+ * This object is normally not instantiated directly, use {@link ImplicitSubtree.fromSubtreeJson}.
+ *
  * @see {@link https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_metadata#implicit-tile-properties|Implicit Tile Properties in the 3DTILES_metadata specification}
+ * @see ImplicitSubtree.fromSubtreeJson
  *
  * @alias ImplicitSubtree
  * @constructor
  *
  * @param {Resource} resource The resource for this subtree. This is used for fetching external buffers as needed.
- * @param {Object} [json] The JSON object for this subtree. Mutually exclusive with subtreeView.
- * @param {Uint8Array} [subtreeView] The contents of a subtree binary in a Uint8Array. Mutually exclusive with json.
  * @param {ImplicitTileset} implicitTileset The implicit tileset. This includes information about the size of subtrees
  * @param {ImplicitTileCoordinates} implicitCoordinates The coordinates of the subtree's root tile.
  *
- * @exception {DeveloperError} One of json and subtreeView must be defined.
- *
  * @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 ImplicitSubtree(
-  resource,
-  json,
-  subtreeView,
-  implicitTileset,
-  implicitCoordinates
-) {
+function ImplicitSubtree(resource, implicitTileset, implicitCoordinates) {
   //>>includeStart('debug', pragmas.debug);
   Check.typeOf.object("resource", resource);
-  if (defined(json) === defined(subtreeView)) {
-    throw new DeveloperError("One of json and subtreeView must be defined.");
-  }
   Check.typeOf.object("implicitTileset", implicitTileset);
   Check.typeOf.object("implicitCoordinates", implicitCoordinates);
   //>>includeEnd('debug');
@@ -77,21 +67,21 @@ function ImplicitSubtree(
   this._tileJumpBuffer = undefined;
   this._contentJumpBuffers = [];
 
-  this._readyPromise = initialize(this, json, subtreeView, implicitTileset);
+  this._ready = false;
 }
 
 Object.defineProperties(ImplicitSubtree.prototype, {
   /**
-   * A promise that resolves once all necessary availability buffers
+   * Returns true once all necessary availability buffers
    * are loaded.
    *
-   * @type {Promise}
+   * @type {boolean}
    * @readonly
    * @private
    */
-  readyPromise: {
+  ready: {
     get: function () {
-      return this._readyPromise;
+      return this._ready;
     },
   },
 
@@ -127,7 +117,7 @@ Object.defineProperties(ImplicitSubtree.prototype, {
    * this property stores the JSON from the extension. This is used by {@link TileMetadata}
    * to get the extras and extensions for the tiles in the subtree.
    *
-   * @type {Object}
+   * @type {object}
    * @readonly
    * @private
    */
@@ -183,8 +173,8 @@ Object.defineProperties(ImplicitSubtree.prototype, {
 /**
  * Check if a specific tile is available at an index of the tile availability bitstream
  *
- * @param {Number} index The index of the desired tile
- * @returns {Boolean} The value of the i-th bit
+ * @param {number} index The index of the desired tile
+ * @returns {boolean} The value of the i-th bit
  * @private
  */
 ImplicitSubtree.prototype.tileIsAvailableAtIndex = function (index) {
@@ -195,7 +185,7 @@ ImplicitSubtree.prototype.tileIsAvailableAtIndex = function (index) {
  * Check if a specific tile is available at an implicit tile coordinate
  *
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a tile
- * @returns {Boolean} The value of the i-th bit
+ * @returns {boolean} The value of the i-th bit
  * @private
  */
 ImplicitSubtree.prototype.tileIsAvailableAtCoordinates = function (
@@ -208,9 +198,9 @@ ImplicitSubtree.prototype.tileIsAvailableAtCoordinates = function (
 /**
  * Check if a specific tile's content is available at an index of the content availability bitstream
  *
- * @param {Number} index The index of the desired tile
- * @param {Number} [contentIndex=0] The index of the desired content when multiple contents are used.
- * @returns {Boolean} The value of the i-th bit
+ * @param {number} index The index of the desired tile
+ * @param {number} [contentIndex=0] The index of the desired content when multiple contents are used.
+ * @returns {boolean} The value of the i-th bit
  * @private
  */
 ImplicitSubtree.prototype.contentIsAvailableAtIndex = function (
@@ -234,8 +224,8 @@ ImplicitSubtree.prototype.contentIsAvailableAtIndex = function (
  * Check if a specific tile's content is available at an implicit tile coordinate
  *
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a tile
- * @param {Number} [contentIndex=0] The index of the desired content when the <code>3DTILES_multiple_contents</code> extension is used.
- * @returns {Boolean} The value of the i-th bit
+ * @param {number} [contentIndex=0] The index of the desired content when the <code>3DTILES_multiple_contents</code> extension is used.
+ * @returns {boolean} The value of the i-th bit
  * @private
  */
 ImplicitSubtree.prototype.contentIsAvailableAtCoordinates = function (
@@ -249,8 +239,8 @@ ImplicitSubtree.prototype.contentIsAvailableAtCoordinates = function (
 /**
  * Check if a child subtree is available at an index of the child subtree availability bitstream
  *
- * @param {Number} index The index of the desired child subtree
- * @returns {Boolean} The value of the i-th bit
+ * @param {number} index The index of the desired child subtree
+ * @returns {boolean} The value of the i-th bit
  * @private
  */
 ImplicitSubtree.prototype.childSubtreeIsAvailableAtIndex = function (index) {
@@ -261,7 +251,7 @@ ImplicitSubtree.prototype.childSubtreeIsAvailableAtIndex = function (index) {
  * Check if a specific child subtree is available at an implicit tile coordinate
  *
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a child subtree
- * @returns {Boolean} The value of the i-th bit
+ * @returns {boolean} The value of the i-th bit
  * @private
  */
 ImplicitSubtree.prototype.childSubtreeIsAvailableAtCoordinates = function (
@@ -280,8 +270,8 @@ ImplicitSubtree.prototype.childSubtreeIsAvailableAtCoordinates = function (
  * <li>Level 2 starts at index 5</li>
  * </ul>
  *
- * @param {Number} level The 0-indexed level number relative to the root of the subtree
- * @returns {Number} The first index at the desired level
+ * @param {number} level The 0-indexed level number relative to the root of the subtree
+ * @returns {number} The first index at the desired level
  * @private
  */
 ImplicitSubtree.prototype.getLevelOffset = function (level) {
@@ -294,8 +284,8 @@ ImplicitSubtree.prototype.getLevelOffset = function (level) {
  * chopping off the last 2 (quadtree) or 3 (octree) bits of the morton
  * index.
  *
- * @param {Number} childIndex The morton index of the child tile relative to its parent
- * @returns {Number} The index of the child's parent node
+ * @param {number} childIndex The morton index of the child tile relative to its parent
+ * @returns {number} The index of the child's parent node
  * @private
  */
 ImplicitSubtree.prototype.getParentMortonIndex = function (mortonIndex) {
@@ -309,16 +299,40 @@ ImplicitSubtree.prototype.getParentMortonIndex = function (mortonIndex) {
 
 /**
  * Parse all relevant information out of the subtree. This fetches any
- * external buffers that are used by the implicit tileset. When finished,
- * it resolves/rejects subtree.readyPromise.
+ * external buffers that are used by the implicit tileset.
  *
- * @param {ImplicitSubtree} subtree The subtree
- * @param {Object} [json] The JSON object for this subtree. If parsing from a binary subtree file, this will be undefined.
+ * @param {Resource} resource The resource for this subtree. This is used for fetching external buffers as needed.
+ * @param {object} [json] The JSON object for this subtree. If parsing from a binary subtree file, this will be undefined.
  * @param {Uint8Array} [subtreeView] The contents of the subtree binary
  * @param {ImplicitTileset} implicitTileset The implicit tileset this subtree belongs to.
+ * @param {ImplicitTileCoordinates} implicitCoordinates The coordinates of the subtree's root tile.
+ * @return {Promise<ImplicitSubtree>} The created subtree
  * @private
+ *
+ * @exception {DeveloperError} One of json and subtreeView must be defined.
  */
-function initialize(subtree, json, subtreeView, implicitTileset) {
+ImplicitSubtree.fromSubtreeJson = async function (
+  resource,
+  json,
+  subtreeView,
+  implicitTileset,
+  implicitCoordinates
+) {
+  //>>includeStart('debug', pragmas.debug);
+  Check.typeOf.object("resource", resource);
+  if (defined(json) === defined(subtreeView)) {
+    throw new DeveloperError("One of json and subtreeView must be defined.");
+  }
+  Check.typeOf.object("implicitTileset", implicitTileset);
+  Check.typeOf.object("implicitCoordinates", implicitCoordinates);
+  //>>includeEnd('debug');
+
+  const subtree = new ImplicitSubtree(
+    resource,
+    implicitTileset,
+    implicitCoordinates
+  );
+
   let chunks;
   if (defined(json)) {
     chunks = {
@@ -409,32 +423,31 @@ function initialize(subtree, json, subtreeView, implicitTileset) {
     markActiveMetadataBufferViews(contentPropertyTableJson, bufferViewHeaders);
   }
 
-  return requestActiveBuffers(subtree, bufferHeaders, chunks.binary).then(
-    function (buffersU8) {
-      const bufferViewsU8 = parseActiveBufferViews(
-        bufferViewHeaders,
-        buffersU8
-      );
-      parseAvailability(subtree, subtreeJson, implicitTileset, bufferViewsU8);
+  const buffersU8 = await requestActiveBuffers(
+    subtree,
+    bufferHeaders,
+    chunks.binary
+  );
+  const bufferViewsU8 = parseActiveBufferViews(bufferViewHeaders, buffersU8);
+  parseAvailability(subtree, subtreeJson, implicitTileset, bufferViewsU8);
 
-      if (defined(tilePropertyTableJson)) {
-        parseTileMetadataTable(subtree, implicitTileset, bufferViewsU8);
-        makeTileJumpBuffer(subtree);
-      }
+  if (defined(tilePropertyTableJson)) {
+    parseTileMetadataTable(subtree, implicitTileset, bufferViewsU8);
+    makeTileJumpBuffer(subtree);
+  }
 
-      parseContentMetadataTables(subtree, implicitTileset, bufferViewsU8);
-      makeContentJumpBuffers(subtree);
+  parseContentMetadataTables(subtree, implicitTileset, bufferViewsU8);
+  makeContentJumpBuffers(subtree);
 
-      return subtree;
-    }
-  );
-}
+  subtree._ready = true;
+  return subtree;
+};
 
 /**
  * A helper object for storing the two parts of the subtree binary
  *
- * @typedef {Object} SubtreeChunks
- * @property {Object} json The json chunk of the subtree
+ * @typedef {object} SubtreeChunks
+ * @property {object} json The json chunk of the subtree
  * @property {Uint8Array} binary The binary chunk of the subtree. This represents the internal buffer.
  * @private
  */
@@ -488,11 +501,11 @@ function parseSubtreeChunks(subtreeView) {
  * Buffers are assumed inactive until explicitly marked active. This is used
  * to avoid fetching unneeded buffers.
  *
- * @typedef {Object} BufferHeader
- * @property {Boolean} isExternal True if this is an external buffer
- * @property {Boolean} isActive Whether this buffer is currently used.
- * @property {String} [uri] The URI of the buffer (external buffers only)
- * @property {Number} byteLength The byte length of the buffer, including any padding contained within.
+ * @typedef {object} BufferHeader
+ * @property {boolean} isExternal True if this is an external buffer
+ * @property {boolean} isActive Whether this buffer is currently used.
+ * @property {string} [uri] The URI of the buffer (external buffers only)
+ * @property {number} byteLength The byte length of the buffer, including any padding contained within.
  * @private
  */
 
@@ -520,12 +533,12 @@ function preprocessBuffers(bufferHeaders) {
  * A buffer header is the JSON header from the subtree JSON chunk plus
  * the isActive flag and a reference to the header for the underlying buffer
  *
- * @typedef {Object} BufferViewHeader
+ * @typedef {object} BufferViewHeader
  * @property {BufferHeader} bufferHeader A reference to the header for the underlying buffer
- * @property {Boolean} isActive Whether this bufferView is currently used.
- * @property {Number} buffer The index of the underlying buffer.
- * @property {Number} byteOffset The start byte of the bufferView within the buffer.
- * @property {Number} byteLength The length of the bufferView. No padding is included in this length.
+ * @property {boolean} isActive Whether this bufferView is currently used.
+ * @property {number} buffer The index of the underlying buffer.
+ * @property {number} byteOffset The start byte of the bufferView within the buffer.
+ * @property {number} byteLength The length of the bufferView. No padding is included in this length.
  * @private
  */
 
@@ -619,7 +632,7 @@ function markActiveBufferViews(subtreeJson, bufferViewHeaders) {
  * allow filtering this to avoid downloading unneeded buffers.
  * </p>
  *
- * @param {Object} propertyTableJson The property table JSON for either a tile or some content
+ * @param {object} propertyTableJson The property table JSON for either a tile or some content
  * @param {BufferViewHeader[]} bufferViewHeaders The preprocessed buffer view headers
  * @private
  */
@@ -680,7 +693,7 @@ function markActiveMetadataBufferViews(propertyTableJson, bufferViewHeaders) {
  * @param {ImplicitSubtree} subtree The subtree
  * @param {BufferHeader[]} bufferHeaders The preprocessed buffer headers
  * @param {Uint8Array} internalBuffer The binary chunk of the subtree file
- * @returns {Promise<Object>} A promise resolving to the dictionary of active buffers
+ * @returns {Promise<object>} A promise resolving to the dictionary of active buffers
  * @private
  */
 function requestActiveBuffers(subtree, bufferHeaders, internalBuffer) {
@@ -708,20 +721,28 @@ function requestActiveBuffers(subtree, bufferHeaders, internalBuffer) {
   });
 }
 
-function requestExternalBuffer(subtree, bufferHeader) {
+async function requestExternalBuffer(subtree, bufferHeader) {
   const baseResource = subtree._resource;
   const bufferResource = baseResource.getDerivedResource({
     url: bufferHeader.uri,
   });
 
-  const bufferLoader = ResourceCache.loadExternalBuffer({
+  const bufferLoader = ResourceCache.getExternalBufferLoader({
     resource: bufferResource,
   });
   subtree._bufferLoader = bufferLoader;
 
-  return bufferLoader.promise.then(function (bufferLoader) {
-    return bufferLoader.typedArray;
-  });
+  try {
+    await bufferLoader.load();
+  } catch (error) {
+    if (bufferLoader.isDestroyed()) {
+      return;
+    }
+
+    throw error;
+  }
+
+  return bufferLoader.typedArray;
 }
 
 /**
@@ -729,8 +750,8 @@ function requestExternalBuffer(subtree, bufferHeader) {
  * extract a subarray from one of the active buffers.
  *
  * @param {BufferViewHeader[]} bufferViewHeaders
- * @param {Object} buffersU8 A dictionary of buffer index to a Uint8Array of its contents.
- * @returns {Object} A dictionary of buffer view index to a Uint8Array of its contents.
+ * @param {object} buffersU8 A dictionary of buffer index to a Uint8Array of its contents.
+ * @returns {object} A dictionary of buffer view index to a Uint8Array of its contents.
  * @private
  */
 function parseActiveBufferViews(bufferViewHeaders, buffersU8) {
@@ -755,9 +776,9 @@ function parseActiveBufferViews(bufferViewHeaders, buffersU8) {
  * Parse the three availability bitstreams and store them in the subtree
  *
  * @param {ImplicitSubtree} subtree The subtree to modify
- * @param {Object} subtreeJson The subtree JSON
+ * @param {object} subtreeJson The subtree JSON
  * @param {ImplicitTileset} implicitTileset The implicit tileset this subtree belongs to
- * @param {Object} bufferViewsU8 A dictionary of buffer view index to a Uint8Array of its contents.
+ * @param {object} bufferViewsU8 A dictionary of buffer view index to a Uint8Array of its contents.
  * @private
  */
 function parseAvailability(
@@ -812,10 +833,10 @@ function parseAvailability(
  * in-memory representation using an {@link ImplicitAvailabilityBitstream}
  * object. This handles both constants and bitstreams from a bufferView.
  *
- * @param {Object} availabilityJson A JSON object representing the availability
- * @param {Object} bufferViewsU8 A dictionary of bufferView index to its Uint8Array contents.
- * @param {Number} lengthBits The length of the availability bitstream in bits
- * @param {Boolean} [computeAvailableCountEnabled] If true and availabilityJson.availableCount is undefined, the availableCount will be computed.
+ * @param {object} availabilityJson A JSON object representing the availability
+ * @param {object} bufferViewsU8 A dictionary of bufferView index to its Uint8Array contents.
+ * @param {number} lengthBits The length of the availability bitstream in bits
+ * @param {boolean} [computeAvailableCountEnabled] If true and availabilityJson.availableCount is undefined, the availableCount will be computed.
  * @returns {ImplicitAvailabilityBitstream} The parsed bitstream object
  * @private
  */
@@ -857,7 +878,7 @@ function parseAvailabilityBitstream(
  *
  * @param {ImplicitSubtree} subtree The subtree
  * @param {ImplicitTileset} implicitTileset The implicit tileset this subtree belongs to.
- * @param {Object} bufferViewsU8 A dictionary of bufferView index to its Uint8Array contents.
+ * @param {object} bufferViewsU8 A dictionary of bufferView index to its Uint8Array contents.
  * @private
  */
 function parseTileMetadataTable(subtree, implicitTileset, bufferViewsU8) {
@@ -882,7 +903,7 @@ function parseTileMetadataTable(subtree, implicitTileset, bufferViewsU8) {
  *
  * @param {ImplicitSubtree} subtree The subtree
  * @param {ImplicitTileset} implicitTileset The implicit tileset this subtree belongs to.
- * @param {Object} bufferViewsU8 A dictionary of bufferView index to its Uint8Array contents.
+ * @param {object} bufferViewsU8 A dictionary of bufferView index to its Uint8Array contents.
  * @private
  */
 function parseContentMetadataTables(subtree, implicitTileset, bufferViewsU8) {
@@ -979,7 +1000,7 @@ function makeContentJumpBuffers(subtree) {
  * Given the implicit tiling coordinates for a tile, get the index within the
  * subtree's tile availability bitstream.
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a tile
- * @return {Number} The tile's index within the subtree.
+ * @return {number} The tile's index within the subtree.
  * @private
  */
 ImplicitSubtree.prototype.getTileIndex = function (implicitCoordinates) {
@@ -1001,7 +1022,7 @@ ImplicitSubtree.prototype.getTileIndex = function (implicitCoordinates) {
  * Given the implicit tiling coordinates for a child subtree, get the index within the
  * subtree's child subtree availability bitstream.
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a child subtree
- * @return {Number} The child subtree's index within the subtree's child subtree availability bitstream.
+ * @return {number} The child subtree's index within the subtree's child subtree availability bitstream.
  * @private
  */
 ImplicitSubtree.prototype.getChildSubtreeIndex = function (
@@ -1028,7 +1049,7 @@ ImplicitSubtree.prototype.getChildSubtreeIndex = function (
  * Get the entity ID for a tile within this subtree.
  * @param {ImplicitSubtree} subtree The subtree
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a tile
- * @return {Number} The entity ID for this tile for accessing tile metadata, or <code>undefined</code> if not applicable.
+ * @return {number} The entity ID for this tile for accessing tile metadata, or <code>undefined</code> if not applicable.
  *
  * @private
  */
@@ -1049,8 +1070,8 @@ function getTileEntityId(subtree, implicitCoordinates) {
  * Get the entity ID for a content within this subtree.
  * @param {ImplicitSubtree} subtree The subtree
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a content
- * @param {Number} contentIndex The content index, for distinguishing between multiple contents.
- * @return {Number} The entity ID for this content for accessing content metadata, or <code>undefined</code> if not applicable.
+ * @param {number} contentIndex The content index, for distinguishing between multiple contents.
+ * @return {number} The entity ID for this content for accessing content metadata, or <code>undefined</code> if not applicable.
  *
  * @private
  */
@@ -1100,7 +1121,7 @@ ImplicitSubtree.prototype.getTileMetadataView = function (implicitCoordinates) {
 /**
  * Create and return a metadata table view for a content within this subtree.
  * @param {ImplicitTileCoordinates} implicitCoordinates The global coordinates of a content
- * @param {Number} contentIndex The index of the content used to distinguish between multiple contents
+ * @param {number} contentIndex The index of the content used to distinguish between multiple contents
  * @return {ImplicitMetadataView} The metadata view for this content, or <code>undefined</code> if not applicable.
  *
  * @private

package/Source/Scene/ImplicitSubtreeCache.js

@@ -6,8 +6,8 @@ import DoubleEndedPriorityQueue from "../Core/DoubleEndedPriorityQueue.js";
  * @alias ImplicitSubtreeCache
  * @constructor
  *
- * @param {Object} [options] Object with the following properties
- * @param {Number} [options.maximumSubtreeCount=0] The total number of subtrees this cache can store. If adding a new subtree would exceed this limit, the lowest priority subtrees will be removed until there is room, unless the subtree that is going to be removed is the parent of the new subtree, in which case it will not be removed and the new subtree will still be added, exceeding the memory limit.
+ * @param {object} [options] Object with the following properties
+ * @param {number} [options.maximumSubtreeCount=0] The total number of subtrees this cache can store. If adding a new subtree would exceed this limit, the lowest priority subtrees will be removed until there is room, unless the subtree that is going to be removed is the parent of the new subtree, in which case it will not be removed and the new subtree will still be added, exceeding the memory limit.
  *
  * @private
  */
@@ -15,14 +15,14 @@ function ImplicitSubtreeCache(options) {
   options = defaultValue(options, defaultValue.EMPTY_OBJECT);
 
   /**
-   * @type {Number}
+   * @type {number}
    * @private
    */
   this._maximumSubtreeCount = defaultValue(options.maximumSubtreeCount, 0);
 
   /**
    * A counter that goes up whenever a subtree is added. Used to sort subtrees by recency.
-   * @type {Number}
+   * @type {number}
    * @private
    */
   this._subtreeRequestCounter = 0;
@@ -96,7 +96,7 @@ ImplicitSubtreeCache.prototype.find = function (subtreeCoord) {
 /**
  * @param {ImplicitSubtreeCacheNode} a
  * @param {ImplicitSubtreeCacheNode} b
- * @returns {Number}
+ * @returns {number}
  */
 ImplicitSubtreeCache.comparator = function (a, b) {
   const aCoord = a.subtree.implicitCoordinates;
@@ -115,7 +115,7 @@ ImplicitSubtreeCache.comparator = function (a, b) {
  * @constructor
  *
  * @param {ImplicitSubtree} subtree
- * @param {Number} stamp
+ * @param {number} stamp
  *
  * @private
  */

package/Source/Scene/ImplicitSubtreeMetadata.js

@@ -9,8 +9,8 @@ import MetadataEntity from "./MetadataEntity.js";
  * See the {@link https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_metadata|3DTILES_metadata Extension} for 3D Tiles
  * </p>
  *
- * @param {Object} options Object with the following properties:
- * @param {Object} options.subtreeMetadata The subtree metadata JSON object.
+ * @param {object} options Object with the following properties:
+ * @param {object} options.subtreeMetadata The subtree metadata JSON object.
  * @param {MetadataClass} options.class The class that subtree metadata conforms to.
  *
  * @alias ImplicitSubtreeMetadata
@@ -57,7 +57,7 @@ Object.defineProperties(ImplicitSubtreeMetadata.prototype, {
    * Extra user-defined properties.
    *
    * @memberof ImplicitSubtreeMetadata.prototype
-   * @type {Object}
+   * @type {object}
    * @readonly
    * @private
    */
@@ -71,7 +71,7 @@ Object.defineProperties(ImplicitSubtreeMetadata.prototype, {
    * An object containing extensions.
    *
    * @memberof ImplicitSubtreeMetadata.prototype
-   * @type {Object}
+   * @type {object}
    * @readonly
    * @private
    */
@@ -85,8 +85,8 @@ Object.defineProperties(ImplicitSubtreeMetadata.prototype, {
 /**
  * Returns whether the subtree has this property.
  *
- * @param {String} propertyId The case-sensitive ID of the property.
- * @returns {Boolean} Whether the subtree has this property.
+ * @param {string} propertyId The case-sensitive ID of the property.
+ * @returns {boolean} Whether the subtree has this property.
  * @private
  */
 ImplicitSubtreeMetadata.prototype.hasProperty = function (propertyId) {
@@ -96,8 +96,8 @@ ImplicitSubtreeMetadata.prototype.hasProperty = function (propertyId) {
 /**
  * Returns whether the subtree has a property with the given semantic.
  *
- * @param {String} semantic The case-sensitive semantic of the property.
- * @returns {Boolean} Whether the subtree has a property with the given semantic.
+ * @param {string} semantic The case-sensitive semantic of the property.
+ * @returns {boolean} Whether the subtree has a property with the given semantic.
  * @private
  */
 ImplicitSubtreeMetadata.prototype.hasPropertyBySemantic = function (semantic) {
@@ -111,8 +111,8 @@ ImplicitSubtreeMetadata.prototype.hasPropertyBySemantic = function (semantic) {
 /**
  * Returns an array of property IDs.
  *
- * @param {String[]} [results] An array into which to store the results.
- * @returns {String[]} The property IDs.
+ * @param {string[]} [results] An array into which to store the results.
+ * @returns {string[]} The property IDs.
  * @private
  */
 ImplicitSubtreeMetadata.prototype.getPropertyIds = function (results) {
@@ -125,7 +125,7 @@ ImplicitSubtreeMetadata.prototype.getPropertyIds = function (results) {
  * If the property is normalized the normalized value is returned.
  * </p>
  *
- * @param {String} propertyId The case-sensitive ID of the property.
+ * @param {string} propertyId The case-sensitive ID of the property.
  * @returns {*} The value of the property or <code>undefined</code> if the subtree does not have this property.
  * @private
  */
@@ -139,9 +139,9 @@ ImplicitSubtreeMetadata.prototype.getProperty = function (propertyId) {
  * If the property is normalized a normalized value must be provided to this function.
  * </p>
  *
- * @param {String} propertyId The case-sensitive ID of the property.
+ * @param {string} propertyId The case-sensitive ID of the property.
  * @param {*} value The value of the property that will be copied.
- * @returns {Boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
+ * @returns {boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
  * @private
  */
 ImplicitSubtreeMetadata.prototype.setProperty = function (propertyId, value) {
@@ -156,7 +156,7 @@ ImplicitSubtreeMetadata.prototype.setProperty = function (propertyId, value) {
 /**
  * Returns a copy of the value of the property with the given semantic.
  *
- * @param {String} semantic The case-sensitive semantic of the property.
+ * @param {string} semantic The case-sensitive semantic of the property.
  * @returns {*} The value of the property or <code>undefined</code> if the subtree does not have this semantic.
  * @private
  */
@@ -171,9 +171,9 @@ ImplicitSubtreeMetadata.prototype.getPropertyBySemantic = function (semantic) {
 /**
  * Sets the value of the property with the given semantic.
  *
- * @param {String} semantic The case-sensitive semantic of the property.
+ * @param {string} semantic The case-sensitive semantic of the property.
  * @param {*} value The value of the property that will be copied.
- * @returns {Boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
+ * @returns {boolean} <code>true</code> if the property was set, <code>false</code> otherwise.
  * @private
  */
 ImplicitSubtreeMetadata.prototype.setPropertyBySemantic = function (