@loaders.gl/tiles 4.5.3 → 5.0.0-alpha.10

package/dist/tileset-3d/common/tileset-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileset-source.js","sourceRoot":"","sources":["../../../src/tileset-3d/common/tileset-source.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AA2QpC;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,OAAO,CACZ,KAAK;QACH,OAAO,KAAK,KAAK,QAAQ;QACzB,YAAY,IAAI,KAAK;QACrB,gBAAgB,IAAI,KAAK;QACzB,uBAAuB,IAAI,KAAK;QAChC,iBAAiB,IAAI,KAAK,CAC7B,CAAC;AACJ,CAAC"}

package/dist/{tileset → tileset-3d/common}/tileset-traverser.d.ts

@@ -1,9 +1,17 @@
 import type { Tile3D } from "./tile-3d.js";
-import { ManagedArray } from "../utils/managed-array.js";
-import { FrameState } from "./helpers/frame-state.js";
+import { ManagedArray } from "../../utils/managed-array.js";
+import { FrameState } from "../helpers/frame-state.js";
 export type TilesetTraverserProps = {
     loadSiblings?: boolean;
     skipLevelOfDetail?: boolean;
+    /** SSE above which tiles remain part of the non-skipping base traversal. */
+    baseScreenSpaceError?: number;
+    /** Required SSE reduction from the nearest requested or loaded ancestor before loading a tile. */
+    skipScreenSpaceErrorFactor?: number;
+    /** Minimum hierarchy levels between requested tiles during skip-LOD traversal. */
+    skipLevels?: number;
+    /** Requests only final tiles that meet the active SSE target when skip-LOD is enabled. */
+    immediatelyLoadDesiredLevelOfDetail?: boolean;
     updateTransforms?: boolean;
     onTraversalEnd?: (frameState: any) => any;
     viewportTraversersMap?: Record<string, any>;
@@ -12,9 +20,13 @@ export type TilesetTraverserProps = {
 export declare const DEFAULT_PROPS: Required<TilesetTraverserProps>;
 export declare class TilesetTraverser {
     options: Required<TilesetTraverserProps>;
+    /** Whether loaded content has disabled skip-LOD traversal for this tileset. */
+    disableSkipLevelOfDetail: boolean;
     root: any;
     selectedTiles: Record<string, Tile3D>;
     requestedTiles: Record<string, Tile3D>;
+    /** Tiles intentionally held until the camera has remained still for the configured delay. */
+    deferredTiles: Record<string, Tile3D>;
     emptyTiles: Record<string, Tile3D>;
     protected lastUpdate: number;
     protected readonly updateDebounceTime = 1000;
@@ -25,6 +37,8 @@ export declare class TilesetTraverser {
     protected _frameNumber: number | null;
     protected traversalFinished(frameState: FrameState): boolean;
     constructor(options: TilesetTraverserProps);
+    /** Returns whether skip-LOD traversal is enabled and supported by the loaded content. */
+    isSkipLevelOfDetailEnabled(): boolean;
     traverse(root: any, frameState: any, options: any): void;
     reset(): void;
     /**
@@ -37,15 +51,33 @@ export declare class TilesetTraverser {
      * and rendering children and parent tiles simultaneously.
      */
     executeTraversal(root: any, frameState: FrameState): void;
+    /** Notifies the owning tileset when traversal is complete or its debounce interval expires. */
+    protected completeTraversal(frameState: FrameState): void;
     updateChildTiles(tile: Tile3D, frameState: FrameState): void;
     updateAndPushChildren(tile: Tile3D, frameState: FrameState, stack: any, depth: any): boolean;
     updateTile(tile: Tile3D, frameState: FrameState): void;
     selectTile(tile: Tile3D, frameState: FrameState): void;
     loadTile(tile: Tile3D, frameState: FrameState): void;
+    /**
+     * Returns whether an eligible peripheral request should wait for camera motion to settle.
+     *
+     * Eligibility and the current time window are calculated together when tile visibility updates.
+     * Keeping the active state on the tile also lets a queued scheduler callback cancel work that
+     * became deferred after its original traversal.
+     *
+     * @param tile - Tile considered for loading.
+     * @returns `true` when the request should be retried after the remaining delay.
+     */
+    shouldDeferTileRequest(tile: Tile3D): boolean;
     touchTile(tile: Tile3D, frameState: FrameState): void;
     canTraverse(tile: Tile3D, frameState: FrameState): boolean;
     shouldLoadTile(tile: Tile3D): boolean;
-    shouldSelectTile(tile: Tile3D): boolean;
+    /**
+     * Returns whether a tile's content is available and visible for rendering.
+     * @param tile Tile considered for rendering.
+     * @param frameState Current culling state.
+     */
+    shouldSelectTile(tile: Tile3D, frameState: FrameState): boolean;
     /** Decide if tile LoD (level of detail) is not sufficient under current viewport */
     shouldRefine(tile: Tile3D, frameState: FrameState, useParentMetric?: boolean): boolean;
     updateTileVisibility(tile: Tile3D, frameState: FrameState): void;

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

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

package/dist/{tileset → tileset-3d/common}/tileset-traverser.js

@@ -1,11 +1,15 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { ManagedArray } from "../utils/managed-array.js";
-import { TILE_REFINEMENT } from "../constants.js";
+import { ManagedArray } from "../../utils/managed-array.js";
+import { TILE_REFINEMENT } from "../../constants.js";
 export const DEFAULT_PROPS = {
     loadSiblings: false,
     skipLevelOfDetail: false,
+    baseScreenSpaceError: 1024,
+    skipScreenSpaceErrorFactor: 16,
+    skipLevels: 1,
+    immediatelyLoadDesiredLevelOfDetail: false,
     updateTransforms: true,
     onTraversalEnd: () => { },
     viewportTraversersMap: {},
@@ -13,12 +17,16 @@ export const DEFAULT_PROPS = {
 };
 export class TilesetTraverser {
     options;
+    /** Whether loaded content has disabled skip-LOD traversal for this tileset. */
+    disableSkipLevelOfDetail = false;
     // fulfill in traverse call
     root = null;
     // tiles should be rendered
     selectedTiles = {};
     // tiles should be loaded from server
     requestedTiles = {};
+    /** Tiles intentionally held until the camera has remained still for the configured delay. */
+    deferredTiles = {};
     // tiles does not have render content
     emptyTiles = {};
     lastUpdate = new Date().getTime();
@@ -36,6 +44,10 @@ export class TilesetTraverser {
     constructor(options) {
         this.options = { ...DEFAULT_PROPS, ...options };
     }
+    /** Returns whether skip-LOD traversal is enabled and supported by the loaded content. */
+    isSkipLevelOfDetailEnabled() {
+        return this.options.skipLevelOfDetail && !this.disableSkipLevelOfDetail;
+    }
     // tiles should be visible
     traverse(root, frameState, options) {
         this.root = root; // for root screen space error
@@ -49,6 +61,7 @@ export class TilesetTraverser {
     }
     reset() {
         this.requestedTiles = {};
+        this.deferredTiles = {};
         this.selectedTiles = {};
         this.emptyTiles = {};
         this._traversalStack.reset();
@@ -104,7 +117,9 @@ export class TilesetTraverser {
                 // Always load tiles in the base traversal
                 // Select tiles that can't refine further
                 this.loadTile(tile, frameState);
-                if (stoppedRefining) {
+                // Skip-LOD keeps a ready ancestor selected while descendants stream in. This prevents
+                // replacement holes when traversal jumps over one or more hierarchy levels.
+                if (stoppedRefining || this.isSkipLevelOfDetailEnabled()) {
                     this.selectTile(tile, frameState);
                 }
             }
@@ -113,6 +128,10 @@ export class TilesetTraverser {
             // 4. update tile refine prop and parent refinement status to trickle down to the descendants
             tile._shouldRefine = shouldRefine && parentRefines;
         }
+        this.completeTraversal(frameState);
+    }
+    /** Notifies the owning tileset when traversal is complete or its debounce interval expires. */
+    completeTraversal(frameState) {
         const newTime = new Date().getTime();
         if (this.traversalFinished(frameState) || newTime - this.lastUpdate > this.updateDebounceTime) {
             this.lastUpdate = newTime;
@@ -127,7 +146,8 @@ export class TilesetTraverser {
     }
     /* eslint-disable complexity, max-statements */
     updateAndPushChildren(tile, frameState, stack, depth) {
-        const { loadSiblings, skipLevelOfDetail } = this.options;
+        const { loadSiblings } = this.options;
+        const skipLevelOfDetail = this.isSkipLevelOfDetailEnabled();
         const children = tile.children;
         // sort children tiles
         children.sort(this.compareDistanceToCamera.bind(this));
@@ -145,9 +165,10 @@ export class TilesetTraverser {
                 stack.push(child);
                 hasVisibleChild = true;
             }
-            else if (checkRefines || loadSiblings) {
-                // Keep non-visible children loaded since they are still needed before the parent can refine.
-                // Or loadSiblings is true so always load tiles regardless of visibility.
+            else if ((checkRefines || loadSiblings) && child._inRequestVolume) {
+                // Keep non-visible children loaded when they are inside their viewer request volume;
+                // they may still be needed before a replacement parent can refine. The request-volume
+                // check intentionally applies to sibling loading as well, preventing off-volume work.
                 this.loadTile(child, frameState);
                 this.touchTile(child, frameState);
             }
@@ -179,7 +200,7 @@ export class TilesetTraverser {
     }
     // tile to render in the browser
     selectTile(tile, frameState) {
-        if (this.shouldSelectTile(tile)) {
+        if (this.shouldSelectTile(tile, frameState)) {
             // The tile can be selected right away and does not require traverseAndSelect
             tile._selectedFrame = frameState.frameNumber;
             this.selectedTiles[tile.id] = tile;
@@ -188,11 +209,28 @@ export class TilesetTraverser {
     // tile to load from server
     loadTile(tile, frameState) {
         if (this.shouldLoadTile(tile)) {
+            if (this.shouldDeferTileRequest(tile)) {
+                this.deferredTiles[tile.id] = tile;
+                return;
+            }
             tile._requestedFrame = frameState.frameNumber;
             tile._priority = tile._getPriority();
             this.requestedTiles[tile.id] = tile;
         }
     }
+    /**
+     * Returns whether an eligible peripheral request should wait for camera motion to settle.
+     *
+     * Eligibility and the current time window are calculated together when tile visibility updates.
+     * Keeping the active state on the tile also lets a queued scheduler callback cancel work that
+     * became deferred after its original traversal.
+     *
+     * @param tile - Tile considered for loading.
+     * @returns `true` when the request should be retried after the remaining delay.
+     */
+    shouldDeferTileRequest(tile) {
+        return tile.priorityDeferred;
+    }
     // cache tile
     touchTile(tile, frameState) {
         tile.tileset._cache.touch(tile);
@@ -218,10 +256,13 @@ export class TilesetTraverser {
         // and has unexpired render content
         return tile.hasUnloadedContent || tile.contentExpired;
     }
-    shouldSelectTile(tile) {
-        // if select tile is in current frame
-        // and content available
-        return tile.contentAvailable && !this.options.skipLevelOfDetail;
+    /**
+     * Returns whether a tile's content is available and visible for rendering.
+     * @param tile Tile considered for rendering.
+     * @param frameState Current culling state.
+     */
+    shouldSelectTile(tile, frameState) {
+        return tile.contentAvailable && tile.contentVisibility(frameState) !== 'outside';
     }
     /** Decide if tile LoD (level of detail) is not sufficient under current viewport */
     shouldRefine(tile, frameState, useParentMetric = false) {
@@ -264,12 +305,19 @@ export class TilesetTraverser {
     // Ignores visibility.
     executeEmptyTraversal(root, frameState) {
         let allDescendantsLoaded = true;
+        let hasPendingLazyChildren = false;
         const stack = this._emptyTraversalStack;
         stack.push(root);
         while (stack.length > 0) {
             const tile = stack.pop();
             const traverse = !tile.hasRenderContent && this.canTraverse(tile, frameState);
             const emptyLeaf = !tile.hasRenderContent && tile.children.length === 0;
+            if (tile.header.implicitSubtree) {
+                // An unresolved implicit boundary is not a proven empty leaf. Treating it as loaded would
+                // allow REPLACE traversal to drop its ancestor before availability and content are known.
+                hasPendingLazyChildren = true;
+                allDescendantsLoaded = false;
+            }
             // Traversal stops but the tile does not have content yet
             // There will be holes if the parent tries to refine to its children, so don't refine
             // One exception: a parent may refine even if one of its descendants is an empty leaf
@@ -288,7 +336,7 @@ export class TilesetTraverser {
                 }
             }
         }
-        return root.hasEmptyContent || allDescendantsLoaded;
+        return (root.hasEmptyContent && !hasPendingLazyChildren) || allDescendantsLoaded;
     }
 }
 //# sourceMappingURL=tileset-traverser.js.map

package/dist/tileset-3d/common/tileset-traverser.js.map

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

package/dist/tileset-3d/format-3d-tiles/implicit-tiling.d.ts

@@ -0,0 +1,182 @@
+import { LOD_METRIC_TYPE, TILE_REFINEMENT } from "../../constants.js";
+/** Global coordinates of a tile in an implicit quadtree or octree. */
+export type ImplicitTileCoordinates = {
+    /** Zero-based level relative to the implicit-tile root. */
+    level: number;
+    /** Zero-based horizontal coordinate at {@link level}. */
+    x: number;
+    /** Zero-based vertical coordinate at {@link level}. */
+    y: number;
+    /** Zero-based height coordinate at {@link level}; always zero for quadtrees. */
+    z: number;
+};
+/** Serializable information shared by every subtree in one implicit-tile hierarchy. */
+export type ImplicitTilingDescriptor = {
+    /** Absolute template URL for render content, or an empty string for a contentless hierarchy. */
+    contentUrlTemplate: string;
+    /** Absolute templates for every implicit content stream, in source order. */
+    contentUrlTemplates?: string[];
+    /** Non-URI content metadata inherited by each available implicit content resource. */
+    contentHeader?: Record<string, any>;
+    /** Metadata inherited by every implicit content stream, in source order. */
+    contentHeaders?: Array<Record<string, any>>;
+    /** Whether generated headers preserve the standard `contents` source representation. */
+    useCanonicalContents?: boolean;
+    /** Absolute template URL for subtree availability files. */
+    subtreesUrlTemplate: string;
+    /** Spatial subdivision used by the hierarchy. */
+    subdivisionScheme: 'QUADTREE' | 'OCTREE';
+    /** Number of tile levels represented inside each subtree file. */
+    subtreeLevels: number;
+    /** Last valid global tile level, where the implicit root is level zero. */
+    maximumLevel: number;
+    /** Refinement mode inherited by generated tiles. */
+    refine: TILE_REFINEMENT | string;
+    /** LOD metric used by generated tiles. */
+    lodMetricType: LOD_METRIC_TYPE.GEOMETRIC_ERROR;
+    /** Source geometric error of the implicit root, in local meters. */
+    rootLodMetricValue: number;
+    /** Bounding volume of the complete implicit hierarchy. */
+    rootBoundingVolume: Record<string, any>;
+    /** Whether runtime transforms scale geometric error; false for draft 2.0. */
+    scaleGeometricError?: boolean;
+    /** Package files that may satisfy concrete content and subtree template references. */
+    resourceFiles?: ImplicitPackageFile[];
+};
+/** Structured-cloneable file retained from a draft glTF package. */
+export type ImplicitPackageFile = {
+    name?: string;
+    mimeType: string;
+    uri?: string;
+    originalUri?: string;
+    data?: ArrayBuffer;
+    byteOffset: number;
+    byteLength: number;
+    bufferUri?: string;
+};
+/** Package reference attached to a generated content or subtree URL. */
+export type ImplicitPackageResource = {
+    fileIndex: number;
+    files: ImplicitPackageFile[];
+};
+/** Lazy pointer from a runtime tile to the subtree that defines it and its descendants. */
+export type ImplicitSubtreeReference = {
+    /** Global coordinates of the referenced subtree root. */
+    coordinates: ImplicitTileCoordinates;
+    /** Absolute subtree URL before source-level query inheritance is applied. */
+    subtreeUrl: string;
+    /** Serializable hierarchy description used to materialize the subtree. */
+    descriptor: ImplicitTilingDescriptor;
+    /** Embedded package resource matching {@link subtreeUrl}, when available. */
+    resource?: ImplicitPackageResource;
+};
+/** Constant or bitstream-backed availability declaration from a parsed subtree. */
+export type ImplicitAvailability = {
+    /** Constant availability value applied to every addressed element. */
+    constant?: number;
+    /** Expanded least-significant-bit-first availability buffer. */
+    explicitBitstream?: Uint8Array;
+};
+/** Parsed subset of the 3D Tiles subtree schema needed for hierarchy materialization. */
+export type ParsedImplicitSubtree = {
+    /** Availability of tiles inside this subtree. */
+    tileAvailability: ImplicitAvailability;
+    /**
+     * Availability of tile content. Array entries correspond to content templates in source order.
+     * Omitted availability denotes a metadata-only subtree with no render content.
+     */
+    contentAvailability?: ImplicitAvailability | ImplicitAvailability[];
+    /** Availability of subtree roots immediately below this subtree. */
+    childSubtreeAvailability: ImplicitAvailability;
+    /** Property-table payloads referenced by subtree metadata declarations. */
+    propertyTables?: unknown;
+    /** Property-table reference for metadata attached to each available tile. */
+    tileMetadata?: unknown;
+    /** Property-table references for metadata attached to each content stream. */
+    contentMetadata?: unknown;
+    /** Metadata entity attached to the subtree itself. */
+    subtreeMetadata?: unknown;
+    /** Decoded standard attribute accessors keyed by tile semantic. */
+    tileAttributes?: Record<string, ArrayLike<number>>;
+    /** Decoded standard attribute accessors keyed by content semantic. */
+    contentAttributes?: Record<string, ArrayLike<number>>;
+    /** Index of the property table assigned to available tiles. */
+    tileProperties?: unknown;
+    /** Index of the property table assigned to available contents. */
+    contentProperties?: unknown;
+    /** Fully decoded property rows for available tiles, in availability order. */
+    tilePropertyRows?: Array<Record<string, unknown>>;
+    /** Fully decoded property rows for available contents, in availability order. */
+    contentPropertyRows?: Array<Record<string, unknown>>;
+    /** Tile property rows filtered to values permitted in URI templates. */
+    tileTemplatePropertyRows?: Array<Record<string, unknown>>;
+    /** Content property rows filtered to values permitted in URI templates. */
+    contentTemplatePropertyRows?: Array<Record<string, unknown>>;
+    /** Files retained by a glTF subtree package for later content/subtree resolution. */
+    resourceFiles?: ImplicitPackageFile[];
+};
+/** Runtime header produced for an available implicit tile. */
+export type ImplicitTileHeader = Record<string, any> & {
+    /** Stable source identity, including global implicit coordinates. */
+    id: string;
+    /** Materialized children that are represented by the same subtree file. */
+    children: ImplicitTileHeader[];
+    /** Optional lazy reference when this tile begins a child subtree. */
+    implicitSubtree?: ImplicitSubtreeReference;
+    /** Raw subtree metadata references preserved for application-level interpretation. */
+    implicitMetadata?: ImplicitSubtreeMetadata;
+};
+/** Metadata references inherited by generated implicit tile headers. */
+export type ImplicitSubtreeMetadata = {
+    /** Property tables declared by the subtree. */
+    propertyTables?: unknown;
+    /** Tile-level metadata property-table reference. */
+    tileMetadata?: unknown;
+    /** Content-level metadata property-table references in content order. */
+    contentMetadata?: unknown;
+    /** Subtree-level metadata entity. */
+    subtreeMetadata?: unknown;
+    /** Decoded property-table row for this tile. */
+    tileProperties?: Record<string, unknown>;
+    /** Decoded property-table row for this tile's available content. */
+    contentProperties?: Record<string, unknown>;
+};
+/** Result of materializing exactly one subtree resource. */
+export type MaterializedImplicitSubtree = {
+    /** Header for the subtree root, including its in-subtree descendants. */
+    root: ImplicitTileHeader;
+    /** Number of available headers materialized from this subtree. */
+    tileCount: number;
+    /** Number of lazy child-subtree references created at the subtree boundary. */
+    childSubtreeCount: number;
+};
+/**
+ * Creates the lazy reference stored on an implicit subtree-root header.
+ *
+ * @param descriptor - Shared implicit hierarchy description.
+ * @param coordinates - Global coordinates of the subtree root.
+ * @returns Serializable reference with its concrete subtree URL.
+ */
+export declare function createImplicitSubtreeReference(descriptor: ImplicitTilingDescriptor, coordinates: ImplicitTileCoordinates): ImplicitSubtreeReference;
+/**
+ * Materializes the available tiles described by one subtree file without performing I/O.
+ *
+ * The function deliberately stops at the subtree boundary. Available child subtrees become lazy
+ * references so traversal, SSE, request-volume checks, and the request scheduler decide when the
+ * next network request is useful.
+ *
+ * @param subtree - Parsed availability data for one subtree resource.
+ * @param reference - Coordinates and hierarchy description for the subtree root.
+ * @returns Materialized root and diagnostic counts.
+ * @throws If the subtree root is unavailable or the descriptor is invalid.
+ */
+export declare function materializeImplicitSubtree(subtree: ParsedImplicitSubtree, reference: ImplicitSubtreeReference): MaterializedImplicitSubtree;
+/**
+ * Replaces implicit coordinate placeholders in a content or subtree URL.
+ *
+ * @param templateUrl - URL containing level/x/y/z placeholders.
+ * @param coordinates - Global coordinates to insert.
+ * @returns URL with all coordinate placeholders replaced.
+ */
+export declare function replaceImplicitUrlTemplate(templateUrl: string, coordinates: ImplicitTileCoordinates, properties?: Record<string, unknown>): string;
+//# sourceMappingURL=implicit-tiling.d.ts.map

package/dist/tileset-3d/format-3d-tiles/implicit-tiling.d.ts.map

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