@loaders.gl/tiles 5.0.0-alpha.12 → 5.0.0-alpha.13

package/src/tileset-2d/tileset-2d.ts

@@ -2,8 +2,12 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 
-import {RequestScheduler, type TileSource, type TileSourceMetadata} from '@loaders.gl/loader-utils';
-import {Stats} from '@probe.gl/stats';
+import {
+  RequestScheduler,
+  type TileSource,
+  type TileSourceMetadata
+} from '@loaders.gl/core/loader-utils';
+import {Stats} from 'probe.gl/stats';
 import {SharedTile2DHeader} from './tile-2d-header';
 import type {Tileset2DAdapter, Tileset2DTileContext} from './adapter';
 import type {TileIndex, TileLoadProps, ZRange} from './types';
@@ -47,9 +51,9 @@ export type Tileset2DBaseProps<DataT = any, ViewStateT = unknown> = {
   maxZoom?: number | null;
   /** Minimum zoom level to request. */
   minZoom?: number | null;
-  /** Maximum number of tiles kept in cache. */
+  /** Tile-count high-water mark, default 100; selected and visible tiles remain retained. */
   maxCacheSize?: number | null;
-  /** Maximum bytes kept in cache. */
+  /** Byte high-water mark; selected and visible tiles can exceed this limit. */
   maxCacheByteSize?: number | null;
   /** Placeholder refinement strategy. */
   refinementStrategy?: RefinementStrategy;
@@ -92,7 +96,7 @@ export type Tile2DListener<DataT = any> = {
   onUpdate?: () => void;
   /** Fired when asynchronous metadata initialization fails. */
   onError?: (error: Error) => void;
-  /** Fired after live tileset counters are recomputed. */
+  /** Fired after counters refresh; synchronous tile requests are coalesced into one microtask. */
   onStatsChange?: (stats: Stats) => void;
 };
 
@@ -143,6 +147,10 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
   private _maxZoom?: number;
   private _minZoom?: number;
   private _lastTileContext: Tileset2DTileContext<ViewStateT> | null = null;
+  /** Whether a tile-request statistics notification is pending. */
+  private _statsUpdateScheduled = false;
+  /** Invalidates pending metadata initialization when the tileset is finalized. */
+  private _lifecycleVersion = 0;
 
   /** Creates a tileset from either `getTileData` or a loaders.gl `TileSource`. */
   constructor(opts: Tileset2DProps<DataT, ViewStateT>) {
@@ -226,7 +234,7 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     return Array.from(this._cache.values()).filter(tile => tile.isLoading);
   }
 
-  /** Tiles retained in cache that do not currently have loaded content. */
+  /** Pending, canceled, or stale cached tiles; settled failures are excluded until reloaded. */
   get unloadedTiles(): SharedTile2DHeader<DataT>[] {
     return Array.from(this._cache.values()).filter(tile => !tile.isLoaded);
   }
@@ -290,8 +298,9 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     }
   }
 
-  /** Aborts in-flight requests and clears the shared cache. */
+  /** Clears consumers and cache, aborting requests and suppressing late tile and metadata results. */
   finalize(): void {
+    this._lifecycleVersion++;
     for (const tile of this._cache.values()) {
       if (tile.isLoading) {
         tile.abort();
@@ -305,12 +314,13 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     this._updateStats();
   }
 
-  /** Marks all retained tiles stale and drops unused cached tiles. */
+  /** Marks selected and visible fallback tiles stale and drops unused cached tiles. */
   reloadAll(): void {
     const selectedTiles = this._getSelectedTilesUnion();
+    const visibleTiles = this._getVisibleTilesUnion();
     for (const id of this._cache.keys()) {
       const tile = this._cache.get(id);
-      if (tile && !selectedTiles.has(tile)) {
+      if (tile && !selectedTiles.has(tile) && !visibleTiles.has(tile)) {
         this._cache.delete(id);
         this._handleTileUnload(tile);
         this._dirty = true;
@@ -407,7 +417,10 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     return {x: Math.floor(index.x / 2), y: Math.floor(index.y / 2), z: index.z - 1};
   }
 
-  /** Returns a cached tile and optionally creates and loads it on demand. */
+  /**
+   * Returns a cached tile, updating its LRU recency, and optionally creates and loads it.
+   * Cache/loading counters update immediately; request statistics notifications are coalesced.
+   */
   getTile(index: TileIndex, create: true): SharedTile2DHeader<DataT>;
   getTile(index: TileIndex, create?: false): SharedTile2DHeader<DataT> | undefined;
   getTile(index: TileIndex, create?: boolean): SharedTile2DHeader<DataT> | undefined {
@@ -422,7 +435,8 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
       needsReload = true;
       this._cache.set(id, tile);
       this._dirty = true;
-      this._updateStats();
+      this._setStatCount('Tiles In Cache', this._cache.size);
+      this._scheduleStatsUpdate();
     } else if (tile && tile.needsReload) {
       needsReload = true;
     }
@@ -432,6 +446,7 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     }
 
     if (tile && needsReload && create) {
+      const wasLoading = tile.isLoading;
       tile
         .loadData({
           getData: this.opts.getTileData,
@@ -440,7 +455,10 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
           onError: this._handleTileError.bind(this)
         })
         .catch(() => {});
-      this._updateStats();
+      if (!wasLoading) {
+        this.stats.get('Loading Tiles').incrementCount();
+      }
+      this._scheduleStatsUpdate();
     }
 
     return tile;
@@ -448,12 +466,20 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
 
   /** Loads metadata from a TileSource and reapplies derived option overrides. */
   private async _initializeTileSource(tileSource: TileSource): Promise<void> {
+    const lifecycleVersion = this._lifecycleVersion;
     try {
-      this.sourceMetadata = await tileSource.getMetadata();
+      const metadata = await tileSource.getMetadata();
+      if (lifecycleVersion !== this._lifecycleVersion) {
+        return;
+      }
+      this.sourceMetadata = metadata;
       this._sourceMetadataOverrides = this._getMetadataOverrides(this.sourceMetadata);
       this._applyResolvedOptions();
       this._notifyUpdate();
     } catch (error: any) {
+      if (lifecycleVersion !== this._lifecycleVersion) {
+        return;
+      }
       const normalizedError =
         error instanceof Error ? error : new Error(`TileSource metadata error: ${String(error)}`);
       this._notifyError(normalizedError);
@@ -519,32 +545,54 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
 
   /** Handles successful tile loads. */
   private _handleTileLoad(tile: SharedTile2DHeader<DataT>): void {
+    const lifecycleVersion = this._lifecycleVersion;
+    if (this._cache.get(tile.id) !== tile) {
+      return;
+    }
     this.opts.onTileLoad?.(tile);
+    if (this._cache.get(tile.id) !== tile) {
+      return;
+    }
     this._cacheByteSize = this._getCacheByteSize();
     this._resizeCache();
+    this._updateStats();
     for (const listener of this._listeners) {
+      if (lifecycleVersion !== this._lifecycleVersion) {
+        return;
+      }
       listener.onTileLoad?.(tile);
     }
-    this._updateStats();
   }
 
   /** Handles tile load failures. */
   private _handleTileError(error: any, tile: SharedTile2DHeader<DataT>): void {
+    const lifecycleVersion = this._lifecycleVersion;
+    if (this._cache.get(tile.id) !== tile) {
+      return;
+    }
     this.opts.onTileError?.(error, tile);
+    if (this._cache.get(tile.id) !== tile) {
+      return;
+    }
+    this._cacheByteSize = this._getCacheByteSize();
+    this._resizeCache();
+    this._updateStats();
     for (const listener of this._listeners) {
+      if (lifecycleVersion !== this._lifecycleVersion) {
+        return;
+      }
       listener.onTileError?.(error, tile);
     }
-    this._updateStats();
   }
 
   /** Handles tile eviction from cache. */
   private _handleTileUnload(tile: SharedTile2DHeader<DataT>): void {
+    tile.abort();
     this._unloadedTileCount++;
     this.opts.onTileUnload?.(tile);
     for (const listener of this._listeners) {
       listener.onTileUnload?.(tile);
     }
-    this._updateStats();
   }
 
   /** Notifies listeners that metadata or effective options changed. */
@@ -561,8 +609,22 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     }
   }
 
-  /** Recomputes absolute counter stats and notifies listeners. */
+  /** Coalesces tile-request notifications without scanning the cache per requested tile. */
+  private _scheduleStatsUpdate(): void {
+    if (this._statsUpdateScheduled) {
+      return;
+    }
+    this._statsUpdateScheduled = true;
+    queueMicrotask(() => {
+      if (this._statsUpdateScheduled) {
+        this._updateStats();
+      }
+    });
+  }
+
+  /** Recomputes absolute counters and publishes a consistent batch snapshot. */
   private _updateStats(): void {
+    this._statsUpdateScheduled = false;
     this._setStatCount('Tiles In Cache', this._cache.size);
     this._setStatCount('Cache Size', this.cacheByteSize);
     this._setStatCount('Visible Tiles', this.visibleTiles.length);
@@ -678,7 +740,7 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
       for (const [id, tile] of this._cache) {
         if (!visibleTiles.has(tile) && !selectedTiles.has(tile)) {
           this._cache.delete(id);
-          this._cacheByteSize = this._getCacheByteSize();
+          this._cacheByteSize -= tile.byteLength;
           this._handleTileUnload(tile);
         }
         if (this._cache.size <= maxCacheSize && this._cacheByteSize <= maxCacheByteSize) {
@@ -701,7 +763,7 @@ export class Tileset2D<DataT = any, ViewStateT = unknown> {
     let index = tile.index;
     while (this.getTileZoom(index) > _minZoom) {
       index = this.getParentIndex(index);
-      const parent = this.getTile(index);
+      const parent = this._cache.get(this.getTileId(index));
       if (parent) {
         return parent;
       }

package/dist/constants.d.ts

@@ -1,38 +0,0 @@
-export type TileContentState = 'unloaded' | 'loading' | 'processing' | 'ready' | 'expired' | 'failed';
-export declare const TILE_CONTENT_STATE: {
-    UNLOADED: number;
-    LOADING: number;
-    PROCESSING: number;
-    READY: number;
-    EXPIRED: number;
-    FAILED: number;
-};
-export type TileRefinement = 'add' | 'replace';
-export declare enum TILE_REFINEMENT {
-    ADD = 1,// Render tile and, if screen space error exceeded, also refine to its children.
-    REPLACE = 2
-}
-export type TileType = 'empty' | 'scenegraph' | 'pointcloud' | 'mesh';
-export declare enum TILE_TYPE {
-    EMPTY = "empty",
-    SCENEGRAPH = "scenegraph",
-    POINTCLOUD = "pointcloud",
-    MESH = "mesh"
-}
-export type TilesetType = 'I3S' | 'TILES3D';
-export declare enum TILESET_TYPE {
-    I3S = "I3S",
-    TILES3D = "TILES3D"
-}
-export type LODMetricType = 'geometricError' | 'maxScreenThreshold';
-export declare enum LOD_METRIC_TYPE {
-    GEOMETRIC_ERROR = "geometricError",
-    MAX_SCREEN_THRESHOLD = "maxScreenThreshold"
-}
-export type Tile3DOptimizationHint = 'NOT_COMPUTED' | 'USE_OPTIMIZATION' | 'SKIP_OPTIMIZATION';
-export declare const TILE3D_OPTIMIZATION_HINT: {
-    NOT_COMPUTED: number;
-    USE_OPTIMIZATION: number;
-    SKIP_OPTIMIZATION: number;
-};
-//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GACxB,UAAU,GACV,SAAS,GACT,YAAY,GACZ,OAAO,GACP,SAAS,GACT,QAAQ,CAAC;AAEb,eAAO,MAAM,kBAAkB;;;;;;;CAO9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,CAAC;AAE/C,oBAAY,eAAe;IACzB,GAAG,IAAI,CAAE,gFAAgF;IACzF,OAAO,IAAI;CACZ;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,MAAM,CAAC;AAEtE,oBAAY,SAAS;IACnB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,IAAI,SAAS;CACd;AAED,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,SAAS,CAAC;AAE5C,oBAAY,YAAY;IACtB,GAAG,QAAQ;IACX,OAAO,YAAY;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,oBAAoB,CAAC;AAEpE,oBAAY,eAAe;IACzB,eAAe,mBAAmB;IAClC,oBAAoB,uBAAuB;CAC5C;AAGD,MAAM,MAAM,sBAAsB,GAAG,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAE/F,eAAO,MAAM,wBAAwB;;;;CAIpC,CAAC"}

package/dist/constants.js

@@ -1,39 +0,0 @@
-// loaders.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-export const TILE_CONTENT_STATE = {
-    UNLOADED: 0, // Has never been requested
-    LOADING: 1, // Is waiting on a pending request
-    PROCESSING: 2, // Request received.  Contents are being processed for rendering.  Depending on the content, it might make its own requests for external data.
-    READY: 3, // Ready to render.
-    EXPIRED: 4, // Is expired and will be unloaded once new content is loaded.
-    FAILED: 5 // Request failed.
-};
-export var TILE_REFINEMENT;
-(function (TILE_REFINEMENT) {
-    TILE_REFINEMENT[TILE_REFINEMENT["ADD"] = 1] = "ADD";
-    TILE_REFINEMENT[TILE_REFINEMENT["REPLACE"] = 2] = "REPLACE"; // Render tile or, if screen space error exceeded, refine to its descendants instead.
-})(TILE_REFINEMENT || (TILE_REFINEMENT = {}));
-export var TILE_TYPE;
-(function (TILE_TYPE) {
-    TILE_TYPE["EMPTY"] = "empty";
-    TILE_TYPE["SCENEGRAPH"] = "scenegraph";
-    TILE_TYPE["POINTCLOUD"] = "pointcloud";
-    TILE_TYPE["MESH"] = "mesh";
-})(TILE_TYPE || (TILE_TYPE = {}));
-export var TILESET_TYPE;
-(function (TILESET_TYPE) {
-    TILESET_TYPE["I3S"] = "I3S";
-    TILESET_TYPE["TILES3D"] = "TILES3D";
-})(TILESET_TYPE || (TILESET_TYPE = {}));
-export var LOD_METRIC_TYPE;
-(function (LOD_METRIC_TYPE) {
-    LOD_METRIC_TYPE["GEOMETRIC_ERROR"] = "geometricError";
-    LOD_METRIC_TYPE["MAX_SCREEN_THRESHOLD"] = "maxScreenThreshold";
-})(LOD_METRIC_TYPE || (LOD_METRIC_TYPE = {}));
-export const TILE3D_OPTIMIZATION_HINT = {
-    NOT_COMPUTED: -1,
-    USE_OPTIMIZATION: 1,
-    SKIP_OPTIMIZATION: 0
-};
-//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAUpC,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,QAAQ,EAAE,CAAC,EAAE,2BAA2B;IACxC,OAAO,EAAE,CAAC,EAAE,kCAAkC;IAC9C,UAAU,EAAE,CAAC,EAAE,8IAA8I;IAC7J,KAAK,EAAE,CAAC,EAAE,mBAAmB;IAC7B,OAAO,EAAE,CAAC,EAAE,8DAA8D;IAC1E,MAAM,EAAE,CAAC,CAAC,kBAAkB;CAC7B,CAAC;AAIF,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,mDAAO,CAAA;IACP,2DAAW,CAAA,CAAC,qFAAqF;AACnG,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAID,MAAM,CAAN,IAAY,SAKX;AALD,WAAY,SAAS;IACnB,4BAAe,CAAA;IACf,sCAAyB,CAAA;IACzB,sCAAyB,CAAA;IACzB,0BAAa,CAAA;AACf,CAAC,EALW,SAAS,KAAT,SAAS,QAKpB;AAID,MAAM,CAAN,IAAY,YAGX;AAHD,WAAY,YAAY;IACtB,2BAAW,CAAA;IACX,mCAAmB,CAAA;AACrB,CAAC,EAHW,YAAY,KAAZ,YAAY,QAGvB;AAID,MAAM,CAAN,IAAY,eAGX;AAHD,WAAY,eAAe;IACzB,qDAAkC,CAAA;IAClC,8DAA2C,CAAA;AAC7C,CAAC,EAHW,eAAe,KAAf,eAAe,QAG1B;AAKD,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,YAAY,EAAE,CAAC,CAAC;IAChB,gBAAgB,EAAE,CAAC;IACnB,iBAAiB,EAAE,CAAC;CACrB,CAAC"}

package/dist/point-cloud/point-cloud-tile.d.ts

@@ -1,47 +0,0 @@
-import type { PointCloudTileContent, PointCloudTileHeader } from "./types.js";
-/**
- * Runtime tile state for PointCloudTileset traversal and loading.
- */
-export declare class PointCloudTile {
-    header: PointCloudTileHeader;
-    parent: PointCloudTile | null;
-    children: PointCloudTile[];
-    childrenLoaded: boolean;
-    childrenPromise: Promise<PointCloudTile[]> | null;
-    selected: boolean;
-    viewportIds: string[];
-    content: PointCloudTileContent | null;
-    contentAvailable: boolean;
-    contentFailed: boolean;
-    isContentLoading: boolean;
-    constructor(header: PointCloudTileHeader, parent?: PointCloudTile | null);
-    /**
-     * Tile identifier.
-     */
-    get id(): string;
-    /**
-     * Tile depth level.
-     */
-    get level(): number;
-    /**
-     * Tile point count.
-     */
-    get pointCount(): number;
-    /**
-     * Tile geometric error.
-     */
-    get geometricError(): number;
-    /**
-     * Tile bounds.
-     */
-    get boundingVolume(): import("./types").PointCloudBoundingVolume;
-    /**
-     * Update the selected state for a traversal cycle.
-     */
-    setSelected(viewportId: string): void;
-    /**
-     * Clear transient selection state.
-     */
-    clearSelection(): void;
-}
-//# sourceMappingURL=point-cloud-tile.d.ts.map

package/dist/point-cloud/point-cloud-tile.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"point-cloud-tile.d.ts","sourceRoot":"","sources":["../../src/point-cloud/point-cloud-tile.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,qBAAqB,EAAE,oBAAoB,EAAC,mBAAgB;AAEzE;;GAEG;AACH,qBAAa,cAAc;IACzB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,MAAM,EAAE,cAAc,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,cAAc,EAAE,CAAM;IAChC,cAAc,UAAS;IACvB,eAAe,EAAE,OAAO,CAAC,cAAc,EAAE,CAAC,GAAG,IAAI,CAAQ;IACzD,QAAQ,UAAS;IACjB,WAAW,EAAE,MAAM,EAAE,CAAM;IAC3B,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAQ;IAC7C,gBAAgB,UAAS;IACzB,aAAa,UAAS;IACtB,gBAAgB,UAAS;gBAEb,MAAM,EAAE,oBAAoB,EAAE,MAAM,GAAE,cAAc,GAAG,IAAW;IAK9E;;OAEG;IACH,IAAI,EAAE,IAAI,MAAM,CAEf;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;OAEG;IACH,IAAI,cAAc,+CAEjB;IAED;;OAEG;IACH,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOrC;;OAEG;IACH,cAAc,IAAI,IAAI;CAIvB"}

package/dist/point-cloud/point-cloud-tile.js

@@ -1,70 +0,0 @@
-// loaders.gl
-// SPDX-License-Identifier: MIT
-// Copyright (c) vis.gl contributors
-/**
- * Runtime tile state for PointCloudTileset traversal and loading.
- */
-export class PointCloudTile {
-    header;
-    parent;
-    children = [];
-    childrenLoaded = false;
-    childrenPromise = null;
-    selected = false;
-    viewportIds = [];
-    content = null;
-    contentAvailable = false;
-    contentFailed = false;
-    isContentLoading = false;
-    constructor(header, parent = null) {
-        this.header = header;
-        this.parent = parent;
-    }
-    /**
-     * Tile identifier.
-     */
-    get id() {
-        return this.header.id;
-    }
-    /**
-     * Tile depth level.
-     */
-    get level() {
-        return this.header.level;
-    }
-    /**
-     * Tile point count.
-     */
-    get pointCount() {
-        return this.header.pointCount;
-    }
-    /**
-     * Tile geometric error.
-     */
-    get geometricError() {
-        return this.header.geometricError;
-    }
-    /**
-     * Tile bounds.
-     */
-    get boundingVolume() {
-        return this.header.boundingVolume;
-    }
-    /**
-     * Update the selected state for a traversal cycle.
-     */
-    setSelected(viewportId) {
-        this.selected = true;
-        if (!this.viewportIds.includes(viewportId)) {
-            this.viewportIds.push(viewportId);
-        }
-    }
-    /**
-     * Clear transient selection state.
-     */
-    clearSelection() {
-        this.selected = false;
-        this.viewportIds = [];
-    }
-}
-//# sourceMappingURL=point-cloud-tile.js.map

package/dist/point-cloud/point-cloud-tile.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"point-cloud-tile.js","sourceRoot":"","sources":["../../src/point-cloud/point-cloud-tile.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC;;GAEG;AACH,MAAM,OAAO,cAAc;IACzB,MAAM,CAAuB;IAC7B,MAAM,CAAwB;IAC9B,QAAQ,GAAqB,EAAE,CAAC;IAChC,cAAc,GAAG,KAAK,CAAC;IACvB,eAAe,GAAqC,IAAI,CAAC;IACzD,QAAQ,GAAG,KAAK,CAAC;IACjB,WAAW,GAAa,EAAE,CAAC;IAC3B,OAAO,GAAiC,IAAI,CAAC;IAC7C,gBAAgB,GAAG,KAAK,CAAC;IACzB,aAAa,GAAG,KAAK,CAAC;IACtB,gBAAgB,GAAG,KAAK,CAAC;IAEzB,YAAY,MAA4B,EAAE,SAAgC,IAAI;QAC5E,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,UAAkB;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/point-cloud/point-cloud-tileset.d.ts

@@ -1,135 +0,0 @@
-import { Vector3 } from '@math.gl/core';
-import type { Viewport } from "../types.js";
-import { PointCloudTile } from "./point-cloud-tile.js";
-import type { PointCloudBoundingVolume, PointCloudTilesetSource } from "./types.js";
-export type PointCloudTilesetOptions = {
-    debounceTime?: number;
-    minimumNodePixelSize?: number;
-    maximumScreenSpaceError?: number;
-    /** Override source LOD metric for point-cloud traversal. */
-    lodSelectionMetricType?: 'maxScreenThresholdSQ' | 'density-threshold';
-    /** Minimum projected point density at which a node is refined. */
-    densityThreshold?: number;
-    pointBudget?: number;
-    maxDepth?: number;
-    onTileLoad?: (tile: PointCloudTile) => void;
-    onTileError?: (tile: PointCloudTile, error: Error) => void;
-    onTraversalComplete?: (selectedTiles: PointCloudTile[]) => PointCloudTile[];
-    onUpdate?: () => void;
-};
-type PointCloudTilesetProps = Required<PointCloudTilesetOptions>;
-/**
- * A minimal point-cloud-oriented tileset manager backed by a DataSource.
- */
-export declare class PointCloudTileset {
-    readonly dataSource: PointCloudTilesetSource;
-    options: PointCloudTilesetProps;
-    root: PointCloudTile | null;
-    cartographicCenter: Vector3 | null;
-    zoom: number;
-    boundingVolume: PointCloudBoundingVolume | null;
-    visibleTilesCount: number;
-    private frameNumberValue;
-    private pendingCount;
-    private lastUpdatedViewports;
-    private updatePromise;
-    private readonly tilesMap;
-    constructor(dataSource: PointCloudTilesetSource, options?: Partial<PointCloudTilesetOptions>);
-    readonly tilesetInitializationPromise: Promise<void>;
-    /**
-     * Whether the tileset finished initialization.
-     */
-    get isReady(): boolean;
-    /**
-     * Runtime frame number.
-     */
-    get frameNumber(): number;
-    /**
-     * All discovered tiles.
-     */
-    get tiles(): PointCloudTile[];
-    /**
-     * Whether all currently selected tiles have finished loading.
-     */
-    isLoaded(): boolean;
-    /**
-     * Currently selected tiles.
-     */
-    selectedTiles: PointCloudTile[];
-    /**
-     * Fire-and-forget update helper.
-     */
-    update(viewports?: Viewport[] | Viewport | null): void;
-    /**
-     * Releases traversal state held by this tileset.
-     */
-    destroy(): void;
-    /**
-     * Initialize the underlying source and the root tile.
-     */
-    initialize(): Promise<void>;
-    /**
-     * Debounced async tile selection.
-     */
-    selectTiles(viewports?: Viewport[] | Viewport | null): Promise<number>;
-    private doSelectTiles;
-    /**
-     * Traverses visible tiles in descending projected-size order, similar to Potree's viewer update loop.
-     */
-    private traverseTiles;
-    /** Whether a tile should refine to children based on its projected screen radius. */
-    private shouldRefine;
-    /**
-     * Build per-viewport traversal state once per traversal pass.
-     */
-    private getTraversalContext;
-    /**
-     * Check tile visibility against the viewport frustum when possible.
-     */
-    private isVisible;
-    /**
-     * Returns true when the viewport frustum appears usable for this tileset's coordinate space.
-     */
-    private shouldUseCullingVolume;
-    /**
-     * Checks whether a common-space bounding sphere intersects a culling volume.
-     */
-    private isBoundingSphereInsideCullingVolume;
-    /**
-     * Checks a projected screen-space footprint against the viewport rectangle.
-     */
-    private isProjectedFootprintVisible;
-    /** Estimate traversal priority from projected node radius in screen pixels. */
-    private estimateScreenRadius;
-    /**
-     * Project a tile AABB into screen space and return its 2D footprint.
-     */
-    private projectBounds;
-    /**
-     * Project a tile to a screen-space center/radius footprint.
-     */
-    private getProjectedFootprint;
-    /**
-     * Returns visible children ordered by their projected importance.
-     */
-    private getVisibleChildren;
-    private getChildren;
-    private getOrCreateTile;
-    private loadTile;
-    private estimateZoom;
-    private haveSameIds;
-    /**
-     * Convert a tile bounding box into its eight corners.
-     */
-    private getBoundingVolumeCorners;
-    /**
-     * Build a culling volume directly from the viewport frustum in common space.
-     */
-    private getCullingVolume;
-    /**
-     * Approximate a tile AABB by a common-space bounding sphere for frustum culling.
-     */
-    private getCommonSpaceBoundingSphere;
-}
-export {};
-//# sourceMappingURL=point-cloud-tileset.d.ts.map

package/dist/point-cloud/point-cloud-tileset.d.ts.map

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