@loaders.gl/tiles 4.0.0-alpha.6 → 4.0.0-alpha.8

package/dist/tileset/tileset-3d.d.ts

@@ -1,10 +1,12 @@
 import { Matrix4, Vector3 } from '@math.gl/core';
 import { Stats } from '@probe.gl/stats';
 import { RequestScheduler, LoaderWithParser, LoaderOptions } from '@loaders.gl/loader-utils';
+import { TilesetCache } from './tileset-cache';
 import { FrameState } from './helpers/frame-state';
+import type { Viewport } from '../types';
 import { Tile3D } from './tile-3d';
-import { Viewport } from '../types';
 import { TilesetTraverser } from './tileset-traverser';
+export type TilesetJSON = any;
 export type Tileset3DProps = {
     throttleRequests?: boolean;
     maxRequests?: number;
@@ -31,38 +33,78 @@ export type Tileset3DProps = {
 type Props = {
     description: string;
     ellipsoid: object;
+    /** A 4x4 transformation matrix this transforms the entire tileset. */
     modelMatrix: Matrix4;
+    /** Set to false to disable network request throttling */
     throttleRequests: boolean;
+    /** Number of simultaneous requsts, if throttleRequests is true */
+    maxRequests: number;
     maximumMemoryUsage: number;
+    /** Maximum number limit of tiles selected for show. 0 means no limit */
     maximumTilesSelected: number;
+    /** Delay time before the tileset traversal. It prevents traversal requests spam.*/
     debounceTime: number;
-    onTileLoad: (tile: Tile3D) => any;
-    onTileUnload: (tile: Tile3D) => any;
-    onTileError: (tile: Tile3D, message: string, url: string) => any;
+    /** Callback. Indicates this a tile's content was loaded */
+    onTileLoad: (tile: Tile3D) => void;
+    /** Callback. Indicates this a tile's content was unloaded (cache full) */
+    onTileUnload: (tile: Tile3D) => void;
+    /** Callback. Indicates this a tile's content failed to load */
+    onTileError: (tile: Tile3D, message: string, url: string) => void;
+    /** Callback. Allows post-process selectedTiles right after traversal. */
     onTraversalComplete: (selectedTiles: Tile3D[]) => Tile3D[];
+    /** The maximum screen space error used to drive level of detail refinement. */
     maximumScreenSpaceError: number;
-    viewportTraversersMap: any;
+    viewportTraversersMap: Record<string, any> | null;
     attributions: string[];
-    maxRequests: number;
     loadTiles: boolean;
     loadOptions: LoaderOptions;
     updateTransforms: boolean;
+    /** View distance scale modifier */
     viewDistanceScale: number;
     basePath: string;
+    /** Optional async tile content loader */
     contentLoader?: (tile: Tile3D) => Promise<void>;
-    i3s: {
-        [key: string]: any;
-    };
+    /** @todo I3S specific knowledge should be moved to I3S module */
+    i3s: Record<string, any>;
 };
+/**
+ * The Tileset loading and rendering flow is as below,
+ * A rendered (i.e. deck.gl `Tile3DLayer`) triggers `tileset.update()` after a `tileset` is loaded
+ * `tileset` starts traversing the tile tree and update `requestTiles` (tiles of which content need
+ * to be fetched) and `selectedTiles` (tiles ready for rendering under the current viewport).
+ * `Tile3DLayer` will update rendering based on `selectedTiles`.
+ * `Tile3DLayer` also listens to `onTileLoad` callback and trigger another round of `update and then traversal`
+ * when new tiles are loaded.
+
+ * As I3S tileset have stored `tileHeader` file (metadata) and tile content files (geometry, texture, ...) separately.
+ * During each traversal, it issues `tilHeader` requests if that `tileHeader` is not yet fetched,
+ * after the tile header is fulfilled, it will resume the traversal starting from the tile just fetched (not root).
+
+ * Tile3DLayer
+ *      |
+ *  await load(tileset)
+ *      |
+ *  tileset.update()
+ *      |                async load tileHeader
+ *  tileset.traverse() -------------------------- Queued
+ *      |        resume traversal after fetched  |
+ *      |----------------------------------------|
+ *      |
+ *      |                     async load tile content
+ * tilset.requestedTiles  ----------------------------- RequestScheduler
+ *                                                             |
+ * tilset.selectedTiles (ready for rendering)                  |
+ *      |         Listen to                                    |
+ *   Tile3DLayer ----------- onTileLoad  ----------------------|
+ *      |                         |   notify new tile is available
+ *   updateLayers                 |
+ *                       tileset.update // trigger another round of update
+*/
 export declare class Tileset3D {
     options: Props;
-    loadOptions: {
-        [key: string]: any;
-    };
+    loadOptions: LoaderOptions;
     type: string;
-    tileset: {
-        [key: string]: any;
-    };
+    tileset: TilesetJSON;
     loader: LoaderWithParser;
     url: string;
     basePath: string;
@@ -72,12 +114,9 @@ export declare class Tileset3D {
     lodMetricValue: number;
     refine: string;
     root: Tile3D | null;
-    roots: {
-        [key: string]: Tile3D;
-    };
-    asset: {
-        [key: string]: any;
-    };
+    roots: Record<string, Tile3D>;
+    /** @todo any->unknown */
+    asset: Record<string, any>;
     description: string;
     properties: any;
     extras: any;
@@ -91,37 +130,45 @@ export declare class Tileset3D {
         dds: boolean;
         ktx2: boolean;
     };
-    traverseCounter: number;
-    geometricError: number;
-    selectedTiles: Tile3D[];
-    private updatePromise;
-    tilesetInitializationPromise: Promise<void>;
     cartographicCenter: Vector3 | null;
     cartesianCenter: Vector3 | null;
     zoom: number;
     boundingVolume: any;
-    gpuMemoryUsageInBytes: any;
-    dynamicScreenSpaceErrorComputedDensity: any;
-    _traverser: TilesetTraverser;
-    private _cache;
-    _requestScheduler: RequestScheduler;
+    /** Updated based on the camera position and direction */
+    dynamicScreenSpaceErrorComputedDensity: number;
+    /**
+     * The maximum amount of GPU memory (in MB) that may be used to cache tiles
+     * Tiles not in view are unloaded to enforce private
+     */
+    maximumMemoryUsage: number;
+    /** The total amount of GPU memory in bytes used by the tileset. */
+    gpuMemoryUsageInBytes: number;
+    /** Update tracker. increase in each update cycle. */
     _frameNumber: number;
-    private _queryParamsString;
     private _queryParams;
     private _extensionsUsed;
     private _tiles;
+    /** counter for tracking tiles requests */
     private _pendingCount;
+    /** Hold traversal results */
+    selectedTiles: Tile3D[];
+    traverseCounter: number;
+    geometricError: number;
     private lastUpdatedVieports;
     private _requestedTiles;
     private _emptyTiles;
     private frameStateData;
-    maximumMemoryUsage: number;
+    _traverser: TilesetTraverser;
+    _cache: TilesetCache;
+    _requestScheduler: RequestScheduler;
+    private updatePromise;
+    tilesetInitializationPromise: Promise<void>;
     /**
      * Create a new Tileset3D
      * @param json
      * @param props
      */
-    constructor(json: any, options?: Tileset3DProps);
+    constructor(tileset: TilesetJSON, options?: Tileset3DProps);
     /** Release resources */
     destroy(): void;
     /** Is the tileset loaded (update needs to have been called at least once) */
@@ -171,11 +218,11 @@ export declare class Tileset3D {
      * Update tiles relying on data from all traversers
      */
     _updateTiles(): void;
-    _tilesChanged(oldSelectedTiles: any, selectedTiles: any): boolean;
+    _tilesChanged(oldSelectedTiles: Tile3D[], selectedTiles: Tile3D[]): boolean;
     _loadTiles(): void;
     _unloadTiles(): void;
     _updateStats(): void;
-    _initializeTileSet(tilesetJson: any): Promise<void>;
+    _initializeTileSet(tilesetJson: TilesetJSON): Promise<void>;
     /**
      * Called during initialize Tileset to initialize the tileset's cartographic center (longitude, latitude) and zoom.
      * These metrics help apps center view on tileset
@@ -191,12 +238,12 @@ export declare class Tileset3D {
      */
     private calculateViewPropsTiles3D;
     _initializeStats(): void;
-    _initializeTileHeaders(tilesetJson: any, parentTileHeader: any): Tile3D;
-    _initializeTraverser(): any;
-    _destroyTileHeaders(parentTile: any): void;
-    _loadTile(tile: any): Promise<void>;
-    _onTileLoadError(tile: any, error: any): void;
-    _onTileLoad(tile: any, loaded: any): void;
+    _initializeTileHeaders(tilesetJson: TilesetJSON, parentTileHeader?: any): Tile3D;
+    _initializeTraverser(): TilesetTraverser;
+    _destroyTileHeaders(parentTile: Tile3D): void;
+    _loadTile(tile: Tile3D): Promise<void>;
+    _onTileLoadError(tile: Tile3D, error: Error): void;
+    _onTileLoad(tile: Tile3D, loaded: boolean): void;
     /**
      * Update information about data types in nested tiles
      * @param tile instance of a nested Tile3D
@@ -204,7 +251,7 @@ export declare class Tileset3D {
     private updateContentTypes;
     _onStartTileLoading(): void;
     _onEndTileLoading(): void;
-    _addTileToCache(tile: any): void;
+    _addTileToCache(tile: Tile3D): void;
     _updateCacheStats(tile: any): void;
     _unloadTile(tile: any): void;
     _destroy(): void;

package/dist/tileset/tileset-3d.d.ts.map

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

package/dist/tileset/tileset-3d.js

@@ -4,40 +4,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Tileset3D = void 0;
 // 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
-/*
-
-  The Tileset loading and rendering flow is as below,
-  A rendered (i.e. deck.gl `Tile3DLayer`) triggers `tileset.update()` after a `tileset` is loaded
-  `tileset` starts traversing the tile tree and update `requestTiles` (tiles of which content need
-  to be fetched) and `selectedTiles` (tiles ready for rendering under the current viewport).
-  `Tile3DLayer` will update rendering based on `selectedTiles`.
-  `Tile3DLayer` also listens to `onTileLoad` callback and trigger another round of `update and then traversal`
-  when new tiles are loaded.
-
-  As I3S tileset have stored `tileHeader` file (metadata) and tile content files (geometry, texture, ...) separately.
-  During each traversal, it issues `tilHeader` requests if that `tileHeader` is not yet fetched,
-  after the tile header is fulfilled, it will resume the traversal starting from the tile just fetched (not root).
-
-  Tile3DLayer
-       |
-   await load(tileset)
-       |
-   tileset.update()
-       |                async load tileHeader
-   tileset.traverse() -------------------------- Queued
-       |        resume traversal after fetched  |
-       |----------------------------------------|
-       |
-       |                     async load tile content
-  tilset.requestedTiles  ----------------------------- RequestScheduler
-                                                              |
-  tilset.selectedTiles (ready for rendering)                  |
-       |         Listen to                                    |
-    Tile3DLayer ----------- onTileLoad  ----------------------|
-       |                         |   notify new tile is available
-    updateLayers                 |
-                        tileset.update // trigger another round of update
-*/
 const core_1 = require("@math.gl/core");
 const geospatial_1 = require("@math.gl/geospatial");
 const stats_1 = require("@probe.gl/stats");
@@ -55,39 +21,18 @@ const i3s_tileset_traverser_1 = require("./format-i3s/i3s-tileset-traverser");
 const DEFAULT_PROPS = {
     description: '',
     ellipsoid: geospatial_1.Ellipsoid.WGS84,
-    // A 4x4 transformation matrix this transforms the entire tileset.
     modelMatrix: new core_1.Matrix4(),
-    // Set to false to disable network request throttling
     throttleRequests: true,
-    // Number of simultaneous requsts, if throttleRequests is true
     maxRequests: 64,
     maximumMemoryUsage: 32,
-    /** Maximum number limit of tiles selected for show. 0 means no limit */
     maximumTilesSelected: 0,
-    /** Delay time before the tileset traversal. It prevents traversal requests spam.*/
     debounceTime: 0,
-    /**
-     * Callback. Indicates this a tile's content was loaded
-     * @param tile {TileHeader}
-     */
     onTileLoad: () => { },
-    /**
-     * Callback. Indicates this a tile's content was unloaded
-     * @param tile {TileHeader}
-     */
     onTileUnload: () => { },
     onTileError: () => { },
-    /**
-     * Callback. Allows post-process selectedTiles right after traversal.
-     * @param selectedTiles {TileHeader[]}
-     * @returns TileHeader[] - output array of tiles to return to deck.gl
-     */
     onTraversalComplete: (selectedTiles) => selectedTiles,
-    // Optional async tile content loader
     contentLoader: undefined,
-    // View distance scale modifier
     viewDistanceScale: 1.0,
-    // The maximum screen space error used to drive level of detail refinement.
     maximumScreenSpaceError: 8,
     loadTiles: true,
     updateTransforms: true,
@@ -108,6 +53,39 @@ const TILES_UNLOADED = 'Tiles Unloaded';
 const TILES_LOAD_FAILED = 'Failed Tile Loads';
 const POINTS_COUNT = 'Points/Vertices';
 const TILES_GPU_MEMORY = 'Tile Memory Use';
+/**
+ * The Tileset loading and rendering flow is as below,
+ * A rendered (i.e. deck.gl `Tile3DLayer`) triggers `tileset.update()` after a `tileset` is loaded
+ * `tileset` starts traversing the tile tree and update `requestTiles` (tiles of which content need
+ * to be fetched) and `selectedTiles` (tiles ready for rendering under the current viewport).
+ * `Tile3DLayer` will update rendering based on `selectedTiles`.
+ * `Tile3DLayer` also listens to `onTileLoad` callback and trigger another round of `update and then traversal`
+ * when new tiles are loaded.
+
+ * As I3S tileset have stored `tileHeader` file (metadata) and tile content files (geometry, texture, ...) separately.
+ * During each traversal, it issues `tilHeader` requests if that `tileHeader` is not yet fetched,
+ * after the tile header is fulfilled, it will resume the traversal starting from the tile just fetched (not root).
+
+ * Tile3DLayer
+ *      |
+ *  await load(tileset)
+ *      |
+ *  tileset.update()
+ *      |                async load tileHeader
+ *  tileset.traverse() -------------------------- Queued
+ *      |        resume traversal after fetched  |
+ *      |----------------------------------------|
+ *      |
+ *      |                     async load tile content
+ * tilset.requestedTiles  ----------------------------- RequestScheduler
+ *                                                             |
+ * tilset.selectedTiles (ready for rendering)                  |
+ *      |         Listen to                                    |
+ *   Tile3DLayer ----------- onTileLoad  ----------------------|
+ *      |                         |   notify new tile is available
+ *   updateLayers                 |
+ *                       tileset.update // trigger another round of update
+*/
 class Tileset3D {
     /**
      * Create a new Tileset3D
@@ -115,75 +93,80 @@ class Tileset3D {
      * @param props
      */
     // eslint-disable-next-line max-statements
-    constructor(json, options) {
+    constructor(tileset, options) {
+        this.root = null;
+        this.roots = {};
+        /** @todo any->unknown */
+        this.asset = {};
+        // Metadata for the entire tileset
+        this.description = '';
+        this.extras = null;
+        this.attributions = {};
+        this.credits = {};
         /** flags that contain information about data types in nested tiles */
         this.contentFormats = { draco: false, meshopt: false, dds: false, ktx2: false };
+        // view props
+        this.cartographicCenter = null;
+        this.cartesianCenter = null;
+        this.zoom = 1;
+        this.boundingVolume = null;
+        /** Updated based on the camera position and direction */
+        this.dynamicScreenSpaceErrorComputedDensity = 0.0;
+        // METRICS
+        /**
+         * The maximum amount of GPU memory (in MB) that may be used to cache tiles
+         * Tiles not in view are unloaded to enforce private
+         */
+        this.maximumMemoryUsage = 32;
+        /** The total amount of GPU memory in bytes used by the tileset. */
+        this.gpuMemoryUsageInBytes = 0;
+        /** Update tracker. increase in each update cycle. */
+        this._frameNumber = 0;
+        this._queryParams = {};
+        this._extensionsUsed = [];
+        this._tiles = {};
+        /** counter for tracking tiles requests */
+        this._pendingCount = 0;
+        /** Hold traversal results */
+        this.selectedTiles = [];
+        // TRAVERSAL
+        this.traverseCounter = 0;
+        this.geometricError = 0;
+        this.lastUpdatedVieports = null;
+        this._requestedTiles = [];
+        this._emptyTiles = [];
+        this.frameStateData = {};
+        this._cache = new tileset_cache_1.TilesetCache();
+        // Promise tracking
         this.updatePromise = null;
-        (0, loader_utils_1.assert)(json);
         // PUBLIC MEMBERS
         this.options = { ...DEFAULT_PROPS, ...options };
         // raw data
-        this.tileset = json;
-        this.loader = json.loader;
+        this.tileset = tileset;
+        this.loader = tileset.loader;
         // could be  3d tiles, i3s
-        this.type = json.type;
+        this.type = tileset.type;
         // The url to a tileset JSON file.
-        this.url = json.url;
-        this.basePath = json.basePath || loader_utils_1.path.dirname(this.url);
+        this.url = tileset.url;
+        this.basePath = tileset.basePath || loader_utils_1.path.dirname(this.url);
         this.modelMatrix = this.options.modelMatrix;
         this.ellipsoid = this.options.ellipsoid;
         // Geometric error when the tree is not rendered at all
-        this.lodMetricType = json.lodMetricType;
-        this.lodMetricValue = json.lodMetricValue;
-        this.refine = json.root.refine;
+        this.lodMetricType = tileset.lodMetricType;
+        this.lodMetricValue = tileset.lodMetricValue;
+        this.refine = tileset.root.refine;
         this.loadOptions = this.options.loadOptions || {};
-        this.root = null;
-        this.roots = {};
-        // view props
-        this.cartographicCenter = null;
-        this.cartesianCenter = null;
-        this.zoom = 1;
-        this.boundingVolume = null;
         // TRAVERSAL
-        this.traverseCounter = 0;
-        this.geometricError = 0;
         this._traverser = this._initializeTraverser();
-        this._cache = new tileset_cache_1.TilesetCache();
         this._requestScheduler = new loader_utils_1.RequestScheduler({
             throttleRequests: this.options.throttleRequests,
             maxRequests: this.options.maxRequests
         });
-        // update tracker
-        // increase in each update cycle
-        this._frameNumber = 0;
-        // counter for tracking tiles requests
-        this._pendingCount = 0;
-        // HOLD TRAVERSAL RESULTS
-        this._tiles = {};
-        this.selectedTiles = [];
-        this._emptyTiles = [];
-        this._requestedTiles = [];
-        this.frameStateData = {};
-        this.lastUpdatedVieports = null;
-        this._queryParams = {};
-        this._queryParamsString = '';
         // METRICS
-        // The maximum amount of GPU memory (in MB) that may be used to cache tiles.
-        // Tiles not in view are unloaded to enforce this.
-        this.maximumMemoryUsage = this.options.maximumMemoryUsage || 32;
         // The total amount of GPU memory in bytes used by the tileset.
-        this.gpuMemoryUsageInBytes = 0;
         this.stats = new stats_1.Stats({ id: this.url });
         this._initializeStats();
-        // EXTRACTED FROM TILESET
-        this._extensionsUsed = undefined;
-        this.dynamicScreenSpaceErrorComputedDensity = 0.0; // Updated based on the camera position and direction
-        // Metadata for the entire tileset
-        this.extras = null;
-        this.asset = {};
-        this.credits = {};
-        this.description = this.options.description || '';
-        this.tilesetInitializationPromise = this._initializeTileSet(json);
+        this.tilesetInitializationPromise = this._initializeTileSet(tileset);
     }
     /** Release resources */
     destroy() {
@@ -201,10 +184,7 @@ class Tileset3D {
         return this._frameNumber;
     }
     get queryParams() {
-        if (!this._queryParamsString) {
-            this._queryParamsString = getQueryParamString(this._queryParams);
-        }
-        return this._queryParamsString;
+        return new URLSearchParams(this._queryParams).toString();
     }
     setProps(props) {
         this.options = { ...this.options, ...props };
@@ -222,11 +202,11 @@ class Tileset3D {
         if (isDataUrl) {
             return tilePath;
         }
-        return `${tilePath}${this.queryParams}`;
+        return `${tilePath}${tilePath.includes('?') ? '&' : '?'}${this.queryParams}`;
     }
     // TODO CESIUM specific
     hasExtension(extensionName) {
-        return Boolean(this._extensionsUsed && this._extensionsUsed.indexOf(extensionName) > -1);
+        return Boolean(this._extensionsUsed.indexOf(extensionName) > -1);
     }
     /**
      * Update visible tiles relying on a list of viewports
@@ -468,7 +448,6 @@ class Tileset3D {
      */
     calculateViewPropsTiles3D() {
         const root = this.root;
-        (0, loader_utils_1.assert)(root);
         const { center } = root.boundingVolume;
         // TODO - handle all cases
         if (!center) {
@@ -522,6 +501,15 @@ class Tileset3D {
                 const children = tile.header.children || [];
                 for (const childHeader of children) {
                     const childTile = new tile_3d_1.Tile3D(this, childHeader, tile);
+                    // Special handling for Google
+                    // A session key must be used for all tile requests
+                    if (childTile.contentUrl?.includes('?session=')) {
+                        const url = new URL(childTile.contentUrl);
+                        const session = url.searchParams.get('session');
+                        if (session) {
+                            this._queryParams.session = session;
+                        }
+                    }
                     tile.children.push(childTile);
                     childTile.depth = tile.depth + 1;
                     stack.push(childTile);
@@ -558,7 +546,7 @@ class Tileset3D {
             loaded = await tile.loadContent();
         }
         catch (error) {
-            this._onTileLoadError(tile, error);
+            this._onTileLoadError(tile, error instanceof Error ? error : new Error('load failed'));
         }
         finally {
             this._onEndTileLoading();
@@ -638,11 +626,11 @@ class Tileset3D {
         this.stats.get(TILES_LOADED).incrementCount();
         this.stats.get(TILES_IN_MEMORY).incrementCount();
         // Good enough? Just use the raw binary ArrayBuffer's byte length.
-        this.gpuMemoryUsageInBytes += tile.content.byteLength || 0;
+        this.gpuMemoryUsageInBytes += tile.gpuMemoryUsageInBytes || 0;
         this.stats.get(TILES_GPU_MEMORY).count = this.gpuMemoryUsageInBytes;
     }
     _unloadTile(tile) {
-        this.gpuMemoryUsageInBytes -= (tile.content && tile.content.byteLength) || 0;
+        this.gpuMemoryUsageInBytes -= tile.gpuMemoryUsageInBytes || 0;
         this.stats.get(TILES_IN_MEMORY).decrementCount();
         this.stats.get(TILES_UNLOADED).incrementCount();
         this.stats.get(TILES_GPU_MEMORY).count = this.gpuMemoryUsageInBytes;
@@ -686,12 +674,19 @@ class Tileset3D {
         tile.destroy();
     }
     _initializeTiles3DTileset(tilesetJson) {
+        if (tilesetJson.queryString) {
+            const searchParams = new URLSearchParams(tilesetJson.queryString);
+            const queryParams = Object.fromEntries(searchParams.entries());
+            this._queryParams = { ...this._queryParams, ...queryParams };
+        }
         this.asset = tilesetJson.asset;
         if (!this.asset) {
             throw new Error('Tileset must have an asset property.');
         }
-        if (this.asset.version !== '0.0' && this.asset.version !== '1.0') {
-            throw new Error('The tileset must be 3D Tiles version 0.0 or 1.0.');
+        if (this.asset.version !== '0.0' &&
+            this.asset.version !== '1.0' &&
+            this.asset.version !== '1.1') {
+            throw new Error('The tileset must be 3D Tiles version either 0.0 or 1.0 or 1.1.');
         }
         // Note: `asset.tilesetVersion` is version of the tileset itself (not the version of the 3D TILES standard)
         // We add this version as a `v=1.0` query param to fetch the right version and not get an older cached version
@@ -706,28 +701,15 @@ class Tileset3D {
         // Gets the tileset's properties dictionary object, which contains metadata about per-feature properties.
         this.properties = tilesetJson.properties;
         this.geometricError = tilesetJson.geometricError;
-        this._extensionsUsed = tilesetJson.extensionsUsed;
+        this._extensionsUsed = tilesetJson.extensionsUsed || [];
         // Returns the extras property at the top of the tileset JSON (application specific metadata).
         this.extras = tilesetJson.extras;
     }
     _initializeI3STileset() {
+        // @ts-expect-error
         if (this.loadOptions.i3s && 'token' in this.loadOptions.i3s) {
             this._queryParams.token = this.loadOptions.i3s.token;
         }
     }
 }
 exports.Tileset3D = Tileset3D;
-function getQueryParamString(queryParams) {
-    const queryParamStrings = [];
-    for (const key of Object.keys(queryParams)) {
-        queryParamStrings.push(`${key}=${queryParams[key]}`);
-    }
-    switch (queryParamStrings.length) {
-        case 0:
-            return '';
-        case 1:
-            return `?${queryParamStrings[0]}`;
-        default:
-            return `?${queryParamStrings.join('&')}`;
-    }
-}

package/dist/tileset/tileset-cache.d.ts

@@ -1,6 +1,7 @@
+import type { Tileset3D } from './tileset-3d';
+import type { Tile3D } from './tile-3d';
 /**
  * Stores tiles with content loaded.
- *
  * @private
  */
 export declare class TilesetCache {
@@ -9,9 +10,9 @@ export declare class TilesetCache {
     private _trimTiles;
     constructor();
     reset(): void;
-    touch(tile: any): void;
-    add(tileset: any, tile: any, addCallback: any): void;
-    unloadTile(tileset: any, tile: any, unloadCallback?: any): void;
+    touch(tile: Tile3D): void;
+    add(tileset: Tileset3D, tile: Tile3D, addCallback?: (tileset: Tileset3D, tile: Tile3D) => void): void;
+    unloadTile(tileset: Tileset3D, tile: Tile3D, unloadCallback?: (tileset: Tileset3D, tile: Tile3D) => void): void;
     unloadTiles(tileset: any, unloadCallback: any): void;
     trim(): void;
 }

package/dist/tileset/tileset-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tileset-cache.d.ts","sourceRoot":"","sources":["../../src/tileset/tileset-cache.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,UAAU,CAAU;;IAU5B,KAAK;IAOL,KAAK,CAAC,IAAI,KAAA;IAOV,GAAG,CAAC,OAAO,KAAA,EAAE,IAAI,KAAA,EAAE,WAAW,KAAA;IAU9B,UAAU,CAAC,OAAO,KAAA,EAAE,IAAI,KAAA,EAAE,cAAc,CAAC,KAAA;IAazC,WAAW,CAAC,OAAO,KAAA,EAAE,cAAc,KAAA;IA0BnC,IAAI;CAGL"}
+{"version":3,"file":"tileset-cache.d.ts","sourceRoot":"","sources":["../../src/tileset/tileset-cache.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAC5C,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,WAAW,CAAC;AAGtC;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,UAAU,CAAU;;IAU5B,KAAK,IAAI,IAAI;IAOb,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOzB,GAAG,CACD,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GACvD,IAAI;IAUP,UAAU,CACR,OAAO,EAAE,SAAS,EAClB,IAAI,EAAE,MAAM,EACZ,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,GAC1D,IAAI;IAaP,WAAW,CAAC,OAAO,KAAA,EAAE,cAAc,KAAA,GAAG,IAAI;IA0B1C,IAAI,IAAI,IAAI;CAGb"}