@loaders.gl/3d-tiles 4.0.0-alpha.7 → 4.0.0-alpha.9

package/dist/types.d.ts

@@ -1,5 +1,7 @@
 import type { GLTFPostprocessed } from '@loaders.gl/gltf';
+import { LoaderWithParser } from '@loaders.gl/loader-utils';
 import { Matrix4, Vector3 } from '@math.gl/core';
+import { TILESET_TYPE, LOD_METRIC_TYPE, TILE_TYPE, TILE_REFINEMENT } from '@loaders.gl/tiles';
 export type FeatureTableJson = {
     [key: string]: any[];
 };
@@ -31,19 +33,247 @@ export type GLTFHeader = {
     featureTableBinaryByteLength: number;
     featureTableJsonByteLength: number;
 };
-export type Node3D = {
-    boundingVolume: BoundingVolume;
-    children: any;
-    geometricError: number;
-    content?: {
-        uri: string;
-        boundingVolume: BoundingVolume;
+/**
+ * A 3D Tiles tileset JSON
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#property-reference
+ */
+export type Tiles3DTilesetJSON = {
+    /** Metadata about the entire tileset.
+     * https://github.com/CesiumGS/3d-tiles/tree/main/specification#asset
+     */
+    asset: {
+        /** The 3D Tiles version. The version defines the JSON schema for the tileset JSON and the base set of tile formats. */
+        version: string;
+        /** Application-specific version of this tileset, e.g., for when an existing tileset is updated. */
+        tilesetVersion?: string;
+        /** Dictionary object with extension-specific objects. */
+        extensions?: object;
+        /** Application-specific data. */
+        extras?: any;
+        /** Not mentioned in 1.0 spec but some tilesets contain this option */
+        gltfUpAxis?: string;
     };
+    /** A dictionary object of metadata about per-feature properties. */
+    properties?: Record<string, TilesetProperty>;
+    /** The error, in meters, introduced if this tileset is not rendered. At runtime, the geometric error is used to compute screen space error (SSE), i.e., the error measured in pixels. */
+    geometricError: number;
+    /** A tile in a 3D Tiles tileset. */
+    root: Tiles3DTileJSON;
+    /** Names of 3D Tiles extensions used somewhere in this tileset. */
+    extensionsUsed?: string[];
+    /** Names of 3D Tiles extensions required to properly load this tileset. */
+    extensionsRequired?: string[];
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+/** TilesetJSON postprocessed by Tiles3DLoader */
+export type Tiles3DTilesetJSONPostprocessed = Omit<Tiles3DTilesetJSON, 'root'> & {
+    /**
+     * Loader used
+     * @deprecated
+     */
+    loader: LoaderWithParser;
+    /** URL used to load a tileset resource */
+    url: string;
+    /** HTTP request query string */
+    queryString: string;
+    /** base path that non-absolute paths in tileset are relative to. */
+    basePath: string;
+    /** tileset type */
+    type: TILESET_TYPE.TILES3D;
+    /** LOD metric type */
+    lodMetricType: LOD_METRIC_TYPE.GEOMETRIC_ERROR;
+    /** LOD metric value */
+    lodMetricValue: number;
+    /** Postprocessed root */
+    root: Tiles3DTileJSONPostprocessed;
 };
-export type BoundingVolume = {
+/**
+ * A tile in a 3D Tiles tileset.
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#tile
+ */
+export type Tiles3DTileJSON = {
+    /** A bounding volume that encloses a tile or its content. */
+    boundingVolume: Tile3DBoundingVolume;
+    /** A bounding volume that encloses a tile or its content. */
+    viewerRequestVolume?: object;
+    /** The error, in meters, introduced if this tile is rendered and its children are not. At runtime, the geometric error is used to compute screen space error (SSE), i.e., the error measured in pixels. */
+    geometricError: number;
+    /**
+     * Specifies if additive or replacement refinement is used when traversing the tileset for rendering. This property is required for the root tile of a tileset; it is optional for all other tiles.
+     * The default is to inherit from the parent tile.
+     */
+    refine?: string;
+    /** A floating-point 4x4 affine transformation matrix, stored in column-major order, that transforms the tile's content */
+    transform?: number[];
+    /** Metadata about the tile's content and a link to the content. */
+    content?: Tiles3DTileContentJSON;
+    /** An array of objects that define child tiles. */
+    children: Tiles3DTileJSON[];
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+    /** 3DTiles v1.1 properties
+     * https://github.com/CesiumGS/3d-tiles/blob/draft-1.1/specification/schema/tile.schema.json
+     */
+    /** This object allows a tile to be implicitly subdivided. Tile and content availability and metadata is stored in subtrees which are referenced externally. */
+    implicitTiling?: ImplicitTilingData;
+};
+export type Tiles3DTileJSONPostprocessed = Omit<Tiles3DTileJSON, 'refine' | 'children'> & {
+    /** Unique ID */
+    id?: string;
+    /** Content full URL */
+    contentUrl?: string;
+    /** LOD metric type */
+    lodMetricType?: LOD_METRIC_TYPE.GEOMETRIC_ERROR;
+    /** LOD metric value */
+    lodMetricValue?: number;
+    /** Duplicate of transform */
+    transformMatrix?: number[];
+    /** Type of tile */
+    type?: TILE_TYPE | string;
+    /**
+     * Specifies if additive or replacement refinement is used when traversing the tileset for rendering. This property is required for the root tile of a tileset; it is optional for all other tiles.
+     * The default is to inherit from the parent tile.
+     */
+    refine?: TILE_REFINEMENT | string;
+    /** An array of objects that define child tiles. */
+    children: Tiles3DTileJSONPostprocessed[];
+};
+/** Metadata about the tile's content and a link to the content. */
+export type Tiles3DTileContentJSON = {
+    /** A uri that points to the tile's content. When the uri is relative, it is relative to the referring tileset JSON file. */
+    uri: string;
+    /** url doesn't allign the spec but we support it same way as uri */
+    url?: string;
+    /** A bounding volume that encloses a tile or its content. At least one bounding volume property is required. Bounding volumes include box, region, or sphere. */
+    boundingVolume?: Tile3DBoundingVolume;
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+/** A bounding volume that encloses a tile or its content.
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#bounding-volume
+ */
+export type Tile3DBoundingVolume = {
+    /** An array of 12 numbers that define an oriented bounding box. The first three elements define the x, y, and z values for the center of the box.
+     * The next three elements (with indices 3, 4, and 5) define the x axis direction and half-length. The next three elements (indices 6, 7, and 8) define
+     * the y axis direction and half-length. The last three elements (indices 9, 10, and 11) define the z axis direction and half-length. */
     box?: number[];
+    /** An array of four numbers that define a bounding sphere. The first three elements define the x, y, and z values for the center of the sphere.
+     * The last element (with index 3) defines the radius in meters. */
     sphere?: number[];
+    /** An array of six numbers that define a bounding geographic region in EPSG:4979 coordinates with the order [west, south, east, north, minimum height, maximum height].
+     * Longitudes and latitudes are in radians, and heights are in meters above (or below) the WGS84 ellipsoid. */
     region?: number[];
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+/**
+ * A dictionary object of metadata about per-feature properties.
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#properties
+ */
+export type TilesetProperty = {
+    /** The maximum value of this property of all the features in the tileset. */
+    maximum: number;
+    /** The minimum value of this property of all the features in the tileset. */
+    minimum: number;
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+export type Tiles3DTileContent = {
+    /** Common properties */
+    byteOffset?: number;
+    type?: string;
+    featureIds?: null;
+    /** 3DTile header */
+    magic?: number;
+    version?: number;
+    byteLength?: number;
+    /** 3DTile tables header */
+    header?: {
+        featureTableJsonByteLength?: number;
+        featureTableBinaryByteLength?: number;
+        batchTableJsonByteLength?: number;
+        batchTableBinaryByteLength?: number;
+        batchLength?: number;
+    };
+    /** 3DTile tables */
+    featureTableJson?: {
+        BATCH_LENGTH?: number;
+    } | Record<string, any>;
+    featureTableBinary?: Uint8Array;
+    batchTableJson?: Record<string, (string | number)[]>;
+    batchTableBinary?: Uint8Array;
+    rtcCenter?: number[];
+    /** 3DTile glTF */
+    gltfArrayBuffer?: ArrayBuffer;
+    gltfByteOffset?: number;
+    gltfByteLength?: number;
+    rotateYtoZ?: boolean;
+    gltfUpAxis?: 'x' | 'X' | 'y' | 'Y' | 'z' | 'Z';
+    gltfUrl?: string;
+    gpuMemoryUsageInBytes?: number;
+    gltf?: GLTFPostprocessed;
+    /** For Composite tiles */
+    tilesLength?: number;
+    tiles?: Tiles3DTileContent[];
+    /** For Instances model and Pointcloud tiles */
+    featuresLength?: number;
+    /** For Instanced model tiles */
+    gltfFormat?: number;
+    eastNorthUp?: boolean;
+    normalUp?: number[];
+    normalRight?: number[];
+    hasCustomOrientation?: boolean;
+    octNormalUp?: number[];
+    octNormalRight?: number[];
+    instances?: {
+        modelMatrix: Matrix4;
+        batchId: number;
+    }[];
+    /** For Pointcloud tiles */
+    attributes?: {
+        positions: null | number[];
+        colors: null | number[] | {
+            type: number;
+            value: Uint8ClampedArray;
+            size: number;
+            normalized: boolean;
+        };
+        normals: null | number[] | {
+            type: number;
+            size: number;
+            value: Float32Array;
+        };
+        batchIds: null | number[];
+    };
+    constantRGBA?: number[];
+    isQuantized?: boolean;
+    isTranslucent?: boolean;
+    isRGB565?: boolean;
+    isOctEncoded16P?: boolean;
+    pointsLength?: number;
+    pointCount?: number;
+    batchIds?: number[];
+    hasPositions?: boolean;
+    hasColors?: boolean;
+    hasNormals?: boolean;
+    hasBatchIds?: boolean;
+    quantizedVolumeScale?: Vector3;
+    quantizedVolumeOffset?: Vector3;
+    quantizedRange?: number;
+    isQuantizedDraco?: boolean;
+    octEncodedRange?: number;
+    isOctEncodedDraco?: boolean;
 };
 /**
  * 3DTILES_implicit_tiling types
@@ -79,15 +309,27 @@ type BufferView = {
 /**
  * Spec - https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_implicit_tiling
  */
-export type ImplicitTilingExtension = {
-    subdivisionScheme: 'QUADTREE' | 'OCTREE';
+export type ImplicitTilingExensionData = ImplicitTilingData & {
     maximumLevel?: number;
-    availableLevels: number;
-    subtreeLevels: number;
-    subtrees: SubtreeUri;
 };
-type SubtreeUri = {
-    uri: string;
+/** 3DTiles v1.1 types */
+/**
+ * This object allows a tile to be implicitly subdivided. Tile and content availability and metadata is stored in subtrees which are referenced externally.
+ * https://github.com/CesiumGS/3d-tiles/blob/draft-1.1/specification/schema/tile.implicitTiling.schema.json
+ * */
+type ImplicitTilingData = {
+    /** A string describing the subdivision scheme used within the tileset. */
+    subdivisionScheme: 'QUADTREE' | 'OCTREE' | string;
+    /** The number of distinct levels in each subtree. For example, a quadtree with `subtreeLevels = 2` will have subtrees with 5 nodes (one root and 4 children). */
+    subtreeLevels: number;
+    /** The numbers of the levels in the tree with available tiles. */
+    availableLevels: number;
+    /** An object describing the location of subtree files. */
+    subtrees: {
+        /** A template URI pointing to subtree files. A subtree is a fixed-depth (defined by `subtreeLevels`) portion of the tree to keep memory use bounded.
+         * The URI of each file is substituted with the subtree root's global level, x, and y. For subdivision scheme `OCTREE`, z shall also be given. Relative paths are relative to the tileset JSON. */
+        uri: string;
+    };
 };
 export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/3d-tiles",
-  "version": "4.0.0-alpha.7",
+  "version": "4.0.0-alpha.9",
   "description": "3D Tiles, an open standard for streaming massive heterogeneous 3D geospatial datasets.",
   "license": "MIT",
   "publishConfig": {
@@ -34,17 +34,17 @@
     "build-bundle": "esbuild src/bundle.ts --bundle --outfile=dist/dist.min.js"
   },
   "dependencies": {
-    "@loaders.gl/draco": "4.0.0-alpha.7",
-    "@loaders.gl/gltf": "4.0.0-alpha.7",
-    "@loaders.gl/loader-utils": "4.0.0-alpha.7",
-    "@loaders.gl/math": "4.0.0-alpha.7",
-    "@loaders.gl/tiles": "4.0.0-alpha.7",
+    "@loaders.gl/draco": "4.0.0-alpha.9",
+    "@loaders.gl/gltf": "4.0.0-alpha.9",
+    "@loaders.gl/loader-utils": "4.0.0-alpha.9",
+    "@loaders.gl/math": "4.0.0-alpha.9",
+    "@loaders.gl/tiles": "4.0.0-alpha.9",
     "@math.gl/core": "^3.5.1",
     "@math.gl/geospatial": "^3.5.1",
     "long": "^5.2.1"
   },
   "peerDependencies": {
-    "@loaders.gl/core": "4.0.0-alpha.6"
+    "@loaders.gl/core": "^4.0.0-alpha.8"
   },
-  "gitHead": "afb59c4d8e5d8ebb9c28f111cb0c96c5527d0ffd"
+  "gitHead": "03ff81ab468f20f3bddeec787aa88d477a7e1c72"
 }

package/src/index.ts

@@ -13,4 +13,15 @@ export {default as Tile3DBatchTable} from './lib/classes/tile-3d-batch-table';
 // EXPERIMENTAL
 export {TILE3D_TYPE} from './lib/constants';
 export {getIonTilesetMetadata as _getIonTilesetMetadata} from './lib/ion/ion';
-export type {FeatureTableJson, B3DMContent, Node3D, ImplicitTilingExtension} from './types';
+export type {
+  FeatureTableJson,
+  B3DMContent,
+  Tile3DBoundingVolume,
+  Tiles3DTileJSON,
+  Tiles3DTileJSONPostprocessed,
+  Tiles3DTilesetJSON,
+  Tiles3DTilesetJSONPostprocessed,
+  Tiles3DTileContent,
+  ImplicitTilingExensionData
+} from './types';
+export type {Tiles3DLoaderOptions} from './tiles-3d-loader';

package/src/lib/parsers/helpers/normalize-3d-tile-colors.ts

@@ -1,13 +1,19 @@
+import {Tile3DBatchTable} from '@loaders.gl/3d-tiles';
 import {decodeRGB565, GL} from '@loaders.gl/math';
+import {Tiles3DTileContent} from '../../../types';
 
 /* eslint-disable complexity*/
-export function normalize3DTileColorAttribute(tile, colors, batchTable?) {
+export function normalize3DTileColorAttribute(
+  tile: Tiles3DTileContent,
+  colors: Uint8ClampedArray | null,
+  batchTable?: Tile3DBatchTable
+): {type: number; value: Uint8ClampedArray; size: number; normalized: boolean} | null {
   // no colors defined
   if (!colors && (!tile || !tile.batchIds || !batchTable)) {
     return null;
   }
 
-  const {batchIds, isRGB565, pointCount} = tile;
+  const {batchIds, isRGB565, pointCount = 0} = tile;
   // Batch table, look up colors in table
   if (batchIds && batchTable) {
     const colorArray = new Uint8ClampedArray(pointCount * 3);
@@ -29,7 +35,7 @@ export function normalize3DTileColorAttribute(tile, colors, batchTable?) {
   }
 
   // RGB565 case, convert to RGB
-  if (isRGB565) {
+  if (colors && isRGB565) {
     const colorArray = new Uint8ClampedArray(pointCount * 3);
     for (let i = 0; i < pointCount; i++) {
       const color = decodeRGB565(colors[i]);
@@ -58,7 +64,7 @@ export function normalize3DTileColorAttribute(tile, colors, batchTable?) {
   // DEFAULT: RGBA case
   return {
     type: GL.UNSIGNED_BYTE,
-    value: colors,
+    value: colors || new Uint8ClampedArray(),
     size: 4,
     normalized: true
   };

package/src/lib/parsers/helpers/normalize-3d-tile-normals.ts

@@ -1,16 +1,20 @@
 import {Vector3} from '@math.gl/core';
 import {GL, octDecode} from '@loaders.gl/math';
+import {Tiles3DTileContent} from '../../../types';
 
 const scratchNormal = new Vector3();
 
-export function normalize3DTileNormalAttribute(tile, normals) {
+export function normalize3DTileNormalAttribute(
+  tile: Tiles3DTileContent,
+  normals: Float32Array | null
+): {type: number; size: number; value: Float32Array} | null {
   if (!normals) {
     return null;
   }
 
   if (tile.isOctEncoded16P) {
-    const decodedArray = new Float32Array(tile.pointsLength * 3);
-    for (let i = 0; i < tile.pointsLength; i++) {
+    const decodedArray = new Float32Array((tile.pointsLength || 0) * 3);
+    for (let i = 0; i < (tile.pointsLength || 0); i++) {
       octDecode(normals[i * 2], normals[i * 2 + 1], scratchNormal);
       // @ts-ignore
       scratchNormal.toArray(decodedArray, i * 3);

package/src/lib/parsers/helpers/parse-3d-implicit-tiles.ts

@@ -1,4 +1,4 @@
-import type {Availability, BoundingVolume, Subtree} from '../../../types';
+import type {Availability, Tile3DBoundingVolume, Subtree} from '../../../types';
 import {Tile3DSubtreeLoader} from '../../../tile-3d-subtree-loader';
 import {load} from '@loaders.gl/core';
 
@@ -263,7 +263,7 @@ function formatTileData(
   const uri = tile.contentUrl && tile.contentUrl.replace(`${basePath}/`, '');
   const lodMetricValue = rootLodMetricValue / 2 ** level;
 
-  const boundingVolume: BoundingVolume = s2VolumeBox?.box
+  const boundingVolume: Tile3DBoundingVolume = s2VolumeBox?.box
     ? {box: s2VolumeBox.box}
     : rootBoundingVolume;
 
@@ -297,9 +297,9 @@ function formatTileData(
  */
 function calculateBoundingVolumeForChildTile(
   level: number,
-  rootBoundingVolume: BoundingVolume,
+  rootBoundingVolume: Tile3DBoundingVolume,
   childCoordinates: {childTileX: number; childTileY: number; childTileZ: number}
-): BoundingVolume {
+): Tile3DBoundingVolume {
   if (rootBoundingVolume.region) {
     const {childTileX, childTileY, childTileZ} = childCoordinates;
     const [west, south, east, north, minimumHeight, maximumHeight] = rootBoundingVolume.region;

package/src/lib/parsers/helpers/parse-3d-tile-gltf-view.ts

@@ -8,28 +8,35 @@
 // - Also, should we have hard dependency on gltf module or use injection or auto-discovery for gltf parser?
 
 import {GLTFLoader, postProcessGLTF, _getMemoryUsageGLTF} from '@loaders.gl/gltf';
-import {sliceArrayBuffer} from '@loaders.gl/loader-utils';
+import {LoaderContext, sliceArrayBuffer} from '@loaders.gl/loader-utils';
+import {Tiles3DTileContent} from '../../../types';
+import {Tiles3DLoaderOptions} from '../../../tiles-3d-loader';
 
 export const GLTF_FORMAT = {
   URI: 0,
   EMBEDDED: 1
 };
 
-export function parse3DTileGLTFViewSync(tile, arrayBuffer, byteOffset, options) {
+export function parse3DTileGLTFViewSync(
+  tile: Tiles3DTileContent,
+  arrayBuffer: ArrayBuffer,
+  byteOffset: number,
+  options: Tiles3DLoaderOptions | undefined
+) {
   // Set flags
   // glTF models need to be rotated from Y to Z up
   // https://github.com/AnalyticalGraphicsInc/3d-tiles/tree/master/specification#y-up-to-z-up
   tile.rotateYtoZ = true;
 
   // Assume glTF consumes rest of tile
-  const gltfByteLength = tile.byteOffset + tile.byteLength - byteOffset;
+  const gltfByteLength = (tile.byteOffset || 0) + (tile.byteLength || 0) - byteOffset;
   if (gltfByteLength === 0) {
     throw new Error('glTF byte length must be greater than 0.');
   }
 
   // Save gltf up axis
   tile.gltfUpAxis =
-    options['3d-tiles'] && options['3d-tiles'].assetGltfUpAxis
+    options?.['3d-tiles'] && options['3d-tiles'].assetGltfUpAxis
       ? options['3d-tiles'].assetGltfUpAxis
       : 'Y';
 
@@ -50,18 +57,27 @@ export function parse3DTileGLTFViewSync(tile, arrayBuffer, byteOffset, options)
   }
 
   // Entire tile is consumed
-  return tile.byteOffset + tile.byteLength;
+  return (tile.byteOffset || 0) + (tile.byteLength || 0);
 }
 
-export async function extractGLTF(tile, gltfFormat, options, context) {
-  const tile3DOptions = options['3d-tiles'] || {};
+export async function extractGLTF(
+  tile: Tiles3DTileContent,
+  gltfFormat: number,
+  options?: Tiles3DLoaderOptions,
+  context?: LoaderContext
+): Promise<void> {
+  const tile3DOptions = options?.['3d-tiles'] || {};
 
   extractGLTFBufferOrURL(tile, gltfFormat, options);
 
   if (tile3DOptions.loadGLTF) {
+    if (!context) {
+      return;
+    }
     const {parse, fetch} = context;
     if (tile.gltfUrl) {
-      tile.gltfArrayBuffer = await fetch(tile.gltfUrl, options);
+      const response = await fetch(tile.gltfUrl, options);
+      tile.gltfArrayBuffer = await response.arrayBuffer();
       tile.gltfByteOffset = 0;
     }
     if (tile.gltfArrayBuffer) {
@@ -76,15 +92,21 @@ export async function extractGLTF(tile, gltfFormat, options, context) {
   }
 }
 
-function extractGLTFBufferOrURL(tile, gltfFormat, options) {
+function extractGLTFBufferOrURL(
+  tile: Tiles3DTileContent,
+  gltfFormat: number,
+  options: Tiles3DLoaderOptions | undefined
+) {
   switch (gltfFormat) {
     case GLTF_FORMAT.URI:
       // We need to remove padding from the end of the model URL in case this tile was part of a composite tile.
       // This removes all white space and null characters from the end of the string.
-      const gltfUrlBytes = new Uint8Array(tile.gltfArrayBuffer, tile.gltfByteOffset);
-      const textDecoder = new TextDecoder();
-      const gltfUrl = textDecoder.decode(gltfUrlBytes);
-      tile.gltfUrl = gltfUrl.replace(/[\s\0]+$/, '');
+      if (tile.gltfArrayBuffer) {
+        const gltfUrlBytes = new Uint8Array(tile.gltfArrayBuffer, tile.gltfByteOffset);
+        const textDecoder = new TextDecoder();
+        const gltfUrl = textDecoder.decode(gltfUrlBytes);
+        tile.gltfUrl = gltfUrl.replace(/[\s\0]+$/, '');
+      }
       delete tile.gltfArrayBuffer;
       delete tile.gltfByteOffset;
       delete tile.gltfByteLength;

package/src/lib/parsers/helpers/parse-3d-tile-header.ts

@@ -1,6 +1,8 @@
 // This file is derived from the Cesium code base under Apache 2 license
 // See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
 
+import {Tiles3DTileContent} from '../../../types';
+
 const SIZEOF_UINT32 = 4;
 
 /* PARSE FIXED HEADER:
@@ -10,7 +12,11 @@ Populates
   version,
   byteLength
  */
-export function parse3DTileHeaderSync(tile, arrayBuffer, byteOffset = 0) {
+export function parse3DTileHeaderSync(
+  tile: Tiles3DTileContent,
+  arrayBuffer: ArrayBuffer,
+  byteOffset: number = 0
+) {
   const view = new DataView(arrayBuffer);
 
   tile.magic = view.getUint32(byteOffset, true);