@loaders.gl/tiles 4.4.5 → 5.0.0-alpha.2

package/dist/index.d.ts

@@ -1,11 +1,35 @@
-export type { Tileset3DProps } from "./tileset/tileset-3d.js";
-export { Tileset3D } from "./tileset/tileset-3d.js";
-export { Tile3D } from "./tileset/tile-3d.js";
-export { TilesetTraverser } from "./tileset/tileset-traverser.js";
-export { TilesetCache } from "./tileset/tileset-cache.js";
-export { createBoundingVolume } from "./tileset/helpers/bounding-volume.js";
-export { calculateTransformProps } from "./tileset/helpers/transform-utils.js";
-export { getFrameState } from "./tileset/helpers/frame-state.js";
-export { getLodStatus } from "./tileset/helpers/i3s-lod.js";
+export type { Tileset3DProps } from "./tileset-3d/common/tileset-3d.js";
+export type { FoveatedInterpolationCallback } from "./tileset-3d/helpers/tiles-3d-request-priority.js";
+export { Tileset3D } from "./tileset-3d/common/tileset-3d.js";
+export type { TileContentLoadResult, TileChildrenLoadResult, TilesetContentFormats, TilesetJSON, TilesetSourceInput, TilesetSourceMetadata, TilesetSourceRequest, TilesetSourceResolver, Tileset3DSource, TilesetSourceViewState } from "./tileset-3d/common/tileset-source.js";
+export { isTileset3DSource } from "./tileset-3d/common/tileset-source.js";
+export type { IndexedArchiveTilesetSourceOptions } from "./tileset-3d/common/indexed-archive-tileset-source.js";
+export { IndexedArchiveTilesetSource } from "./tileset-3d/common/indexed-archive-tileset-source.js";
+export { Tile3D } from "./tileset-3d/common/tile-3d.js";
+export type { TileChildrenState } from "./tileset-3d/common/tile-3d.js";
+export { Tiles3DSource } from "./tileset-3d/format-3d-tiles/tiles-3d-source.js";
+export type { ImplicitTilingStats } from "./tileset-3d/format-3d-tiles/tiles-3d-source.js";
+export type { ImplicitAvailability, ImplicitSubtreeReference, ImplicitTileCoordinates, ImplicitTileHeader, ImplicitTilingDescriptor, MaterializedImplicitSubtree, ParsedImplicitSubtree } from "./tileset-3d/format-3d-tiles/implicit-tiling.js";
+export { createImplicitSubtreeReference, materializeImplicitSubtree, replaceImplicitUrlTemplate } from "./tileset-3d/format-3d-tiles/implicit-tiling.js";
+export { I3SSource } from "./tileset-3d/format-i3s/i3s-source.js";
+export { TilesetTraverser } from "./tileset-3d/common/tileset-traverser.js";
+export { TilesetCache } from "./tileset-3d/common/tileset-cache.js";
+export type { Bounds, GeoBoundingBox, NonGeoBoundingBox, TileBoundingBox, TileIndex, TileLoadProps, ZRange } from "./tileset-2d.js";
+export type { Tileset2DAdapter, Tileset2DTileContext, Tileset2DTraversalContext } from "./tileset-2d.js";
+export type { RefinementStrategy, RefinementStrategyFunction, Tileset2DBaseProps, Tileset2DProps, Tile2DListener, Tile2DLoadDataProps } from "./tileset-2d.js";
+export { SharedTile2DHeader, Tileset2D, STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "./tileset-2d.js";
+export type { ImageSetBaseProps, ImageSetListener, ImageSetProps, ImageSetRequest } from "./image-set.js";
+export { ImageSet } from "./image-set.js";
+export type { RasterSetBaseProps, RasterSetListener, RasterSetProps, RasterSetRequest, RasterSetShouldRefetchArgs } from "./raster-set.js";
+export { RasterSet } from "./raster-set.js";
+export type { PointCloudAttribute, PointCloudBoundingVolume, PointCloudTileContent, PointCloudTileHeader, PointCloudTilesetSource, PointCloudTilesetViewState } from "./point-cloud/types.js";
+export type { PointCloudTilesetOptions } from "./point-cloud/point-cloud-tileset.js";
+export { PointCloudTileset } from "./point-cloud/point-cloud-tileset.js";
+export { PointCloudTile } from "./point-cloud/point-cloud-tile.js";
+export { createBoundingVolume } from "./tileset-3d/helpers/bounding-volume.js";
+export { calculateTransformProps } from "./tileset-3d/helpers/transform-utils.js";
+export { getFrameState } from "./tileset-3d/helpers/frame-state.js";
+export type { GetFrameStateOptions } from "./tileset-3d/helpers/frame-state.js";
+export { getLodStatus } from "./tileset-3d/helpers/i3s-lod.js";
 export { TILE_CONTENT_STATE, TILE_REFINEMENT, TILE_TYPE, TILESET_TYPE, LOD_METRIC_TYPE } from "./constants.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,cAAc,EAAC,gCAA6B;AACzD,OAAO,EAAC,SAAS,EAAC,gCAA6B;AAC/C,OAAO,EAAC,MAAM,EAAC,6BAA0B;AAEzC,OAAO,EAAC,gBAAgB,EAAC,uCAAoC;AAC7D,OAAO,EAAC,YAAY,EAAC,mCAAgC;AAErD,OAAO,EAAC,oBAAoB,EAAC,6CAA0C;AACvE,OAAO,EAAC,uBAAuB,EAAC,6CAA0C;AAE1E,OAAO,EAAC,aAAa,EAAC,yCAAsC;AAC5D,OAAO,EAAC,YAAY,EAAC,qCAAkC;AAEvD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,eAAe,EAChB,uBAAoB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,YAAY,EAAC,cAAc,EAAC,0CAAuC;AACnE,YAAY,EAAC,6BAA6B,EAAC,0DAAuD;AAClG,OAAO,EAAC,SAAS,EAAC,0CAAuC;AACzD,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,WAAW,EACX,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,eAAe,EACf,sBAAsB,EACvB,8CAA2C;AAC5C,OAAO,EAAC,iBAAiB,EAAC,8CAA2C;AACrE,YAAY,EAAC,kCAAkC,EAAC,8DAA2D;AAC3G,OAAO,EAAC,2BAA2B,EAAC,8DAA2D;AAC/F,OAAO,EAAC,MAAM,EAAC,uCAAoC;AACnD,YAAY,EAAC,iBAAiB,EAAC,uCAAoC;AACnE,OAAO,EAAC,aAAa,EAAC,wDAAqD;AAC3E,YAAY,EAAC,mBAAmB,EAAC,wDAAqD;AACtF,YAAY,EACV,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,wBAAwB,EACxB,2BAA2B,EAC3B,qBAAqB,EACtB,wDAAqD;AACtD,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC3B,wDAAqD;AACtD,OAAO,EAAC,SAAS,EAAC,8CAA2C;AAE7D,OAAO,EAAC,gBAAgB,EAAC,iDAA8C;AACvE,OAAO,EAAC,YAAY,EAAC,6CAA0C;AAE/D,YAAY,EACV,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,aAAa,EACb,MAAM,EACP,wBAAqB;AACtB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EAC1B,wBAAqB;AACtB,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,mBAAmB,EACpB,wBAAqB;AACtB,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,wBAAqB;AACtB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,eAAe,EAChB,uBAAoB;AACrB,OAAO,EAAC,QAAQ,EAAC,uBAAoB;AACrC,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,0BAA0B,EAC3B,wBAAqB;AACtB,OAAO,EAAC,SAAS,EAAC,wBAAqB;AACvC,YAAY,EACV,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,0BAA0B,EAC3B,+BAA4B;AAC7B,YAAY,EAAC,wBAAwB,EAAC,6CAA0C;AAChF,OAAO,EAAC,iBAAiB,EAAC,6CAA0C;AACpE,OAAO,EAAC,cAAc,EAAC,0CAAuC;AAC9D,OAAO,EAAC,oBAAoB,EAAC,gDAA6C;AAC1E,OAAO,EAAC,uBAAuB,EAAC,gDAA6C;AAE7E,OAAO,EAAC,aAAa,EAAC,4CAAyC;AAC/D,YAAY,EAAC,oBAAoB,EAAC,4CAAyC;AAC3E,OAAO,EAAC,YAAY,EAAC,wCAAqC;AAE1D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,eAAe,EAChB,uBAAoB"}

package/dist/index.js

@@ -1,13 +1,23 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-export { Tileset3D } from "./tileset/tileset-3d.js";
-export { Tile3D } from "./tileset/tile-3d.js";
-export { TilesetTraverser } from "./tileset/tileset-traverser.js";
-export { TilesetCache } from "./tileset/tileset-cache.js";
-export { createBoundingVolume } from "./tileset/helpers/bounding-volume.js";
-export { calculateTransformProps } from "./tileset/helpers/transform-utils.js";
-export { getFrameState } from "./tileset/helpers/frame-state.js";
-export { getLodStatus } from "./tileset/helpers/i3s-lod.js";
+export { Tileset3D } from "./tileset-3d/common/tileset-3d.js";
+export { isTileset3DSource } from "./tileset-3d/common/tileset-source.js";
+export { IndexedArchiveTilesetSource } from "./tileset-3d/common/indexed-archive-tileset-source.js";
+export { Tile3D } from "./tileset-3d/common/tile-3d.js";
+export { Tiles3DSource } from "./tileset-3d/format-3d-tiles/tiles-3d-source.js";
+export { createImplicitSubtreeReference, materializeImplicitSubtree, replaceImplicitUrlTemplate } from "./tileset-3d/format-3d-tiles/implicit-tiling.js";
+export { I3SSource } from "./tileset-3d/format-i3s/i3s-source.js";
+export { TilesetTraverser } from "./tileset-3d/common/tileset-traverser.js";
+export { TilesetCache } from "./tileset-3d/common/tileset-cache.js";
+export { SharedTile2DHeader, Tileset2D, STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "./tileset-2d.js";
+export { ImageSet } from "./image-set.js";
+export { RasterSet } from "./raster-set.js";
+export { PointCloudTileset } from "./point-cloud/point-cloud-tileset.js";
+export { PointCloudTile } from "./point-cloud/point-cloud-tile.js";
+export { createBoundingVolume } from "./tileset-3d/helpers/bounding-volume.js";
+export { calculateTransformProps } from "./tileset-3d/helpers/transform-utils.js";
+export { getFrameState } from "./tileset-3d/helpers/frame-state.js";
+export { getLodStatus } from "./tileset-3d/helpers/i3s-lod.js";
 export { TILE_CONTENT_STATE, TILE_REFINEMENT, TILE_TYPE, TILESET_TYPE, LOD_METRIC_TYPE } from "./constants.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,SAAS,EAAC,gCAA6B;AAC/C,OAAO,EAAC,MAAM,EAAC,6BAA0B;AAEzC,OAAO,EAAC,gBAAgB,EAAC,uCAAoC;AAC7D,OAAO,EAAC,YAAY,EAAC,mCAAgC;AAErD,OAAO,EAAC,oBAAoB,EAAC,6CAA0C;AACvE,OAAO,EAAC,uBAAuB,EAAC,6CAA0C;AAE1E,OAAO,EAAC,aAAa,EAAC,yCAAsC;AAC5D,OAAO,EAAC,YAAY,EAAC,qCAAkC;AAEvD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,eAAe,EAChB,uBAAoB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAIpC,OAAO,EAAC,SAAS,EAAC,0CAAuC;AAazD,OAAO,EAAC,iBAAiB,EAAC,8CAA2C;AAErE,OAAO,EAAC,2BAA2B,EAAC,8DAA2D;AAC/F,OAAO,EAAC,MAAM,EAAC,uCAAoC;AAEnD,OAAO,EAAC,aAAa,EAAC,wDAAqD;AAW3E,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,0BAA0B,EAC3B,wDAAqD;AACtD,OAAO,EAAC,SAAS,EAAC,8CAA2C;AAE7D,OAAO,EAAC,gBAAgB,EAAC,iDAA8C;AACvE,OAAO,EAAC,YAAY,EAAC,6CAA0C;AAwB/D,OAAO,EACL,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,wBAAqB;AAOtB,OAAO,EAAC,QAAQ,EAAC,uBAAoB;AAQrC,OAAO,EAAC,SAAS,EAAC,wBAAqB;AAUvC,OAAO,EAAC,iBAAiB,EAAC,6CAA0C;AACpE,OAAO,EAAC,cAAc,EAAC,0CAAuC;AAC9D,OAAO,EAAC,oBAAoB,EAAC,gDAA6C;AAC1E,OAAO,EAAC,uBAAuB,EAAC,gDAA6C;AAE7E,OAAO,EAAC,aAAa,EAAC,4CAAyC;AAE/D,OAAO,EAAC,YAAY,EAAC,wCAAqC;AAE1D,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,eAAe,EAChB,uBAAoB"}

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

@@ -0,0 +1,47 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,70 @@
+// 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,131 @@
+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;
+    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

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