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

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":"AAIA,OAAO,EAAC,eAAe,EAAE,eAAe,EAAY,2BAAwB;AAK5E,sEAAsE;AACtE,MAAM,MAAM,uBAAuB,GAAG;IACpC,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,CAAC,EAAE,MAAM,CAAC;IACV,uDAAuD;IACvD,CAAC,EAAE,MAAM,CAAC;IACV,gFAAgF;IAChF,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,wBAAwB,GAAG;IACrC,gGAAgG;IAChG,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sFAAsF;IACtF,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACpC,4DAA4D;IAC5D,mBAAmB,EAAE,MAAM,CAAC;IAC5B,iDAAiD;IACjD,iBAAiB,EAAE,UAAU,GAAG,QAAQ,CAAC;IACzC,kEAAkE;IAClE,aAAa,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,oDAAoD;IACpD,MAAM,EAAE,eAAe,GAAG,MAAM,CAAC;IACjC,0CAA0C;IAC1C,aAAa,EAAE,eAAe,CAAC,eAAe,CAAC;IAC/C,oEAAoE;IACpE,kBAAkB,EAAE,MAAM,CAAC;IAC3B,0DAA0D;IAC1D,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACzC,CAAC;AAEF,2FAA2F;AAC3F,MAAM,MAAM,wBAAwB,GAAG;IACrC,yDAAyD;IACzD,WAAW,EAAE,uBAAuB,CAAC;IACrC,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,UAAU,EAAE,wBAAwB,CAAC;CACtC,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,oBAAoB,GAAG;IACjC,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,UAAU,CAAC;CAChC,CAAC;AAEF,yFAAyF;AACzF,MAAM,MAAM,qBAAqB,GAAG;IAClC,iDAAiD;IACjD,gBAAgB,EAAE,oBAAoB,CAAC;IACvC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,EAAE,CAAC;IACpE,oEAAoE;IACpE,wBAAwB,EAAE,oBAAoB,CAAC;CAChD,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;IACrD,qEAAqE;IACrE,EAAE,EAAE,MAAM,CAAC;IACX,2EAA2E;IAC3E,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,qEAAqE;IACrE,eAAe,CAAC,EAAE,wBAAwB,CAAC;CAC5C,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,2BAA2B,GAAG;IACxC,yEAAyE;IACzE,IAAI,EAAE,kBAAkB,CAAC;IACzB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,wBAAwB,EACpC,WAAW,EAAE,uBAAuB,GACnC,wBAAwB,CAM1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,qBAAqB,EAC9B,SAAS,EAAE,wBAAwB,GAClC,2BAA2B,CAoB7B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,uBAAuB,GACnC,MAAM,CAUR"}

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

@@ -0,0 +1,340 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+import { TILE_TYPE } from "../../constants.js";
+const QUADTREE_CHILD_COUNT = 4;
+const OCTREE_CHILD_COUNT = 8;
+/**
+ * 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 function createImplicitSubtreeReference(descriptor, coordinates) {
+    return {
+        coordinates,
+        subtreeUrl: replaceImplicitUrlTemplate(descriptor.subtreesUrlTemplate, coordinates),
+        descriptor
+    };
+}
+/**
+ * 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 function materializeImplicitSubtree(subtree, reference) {
+    const { descriptor } = reference;
+    validateImplicitDescriptor(descriptor);
+    const counters = { tileCount: 0, childSubtreeCount: 0 };
+    const root = materializeAvailableTile(subtree, reference, { localLevel: 0, mortonIndex: 0 }, reference.coordinates, counters);
+    if (!root) {
+        throw new Error(`Invalid 3D Tiles subtree: root tile is unavailable at ${reference.subtreeUrl}`);
+    }
+    return { root, ...counters };
+}
+/**
+ * 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 function replaceImplicitUrlTemplate(templateUrl, coordinates) {
+    const values = {
+        level: coordinates.level,
+        x: coordinates.x,
+        y: coordinates.y,
+        z: coordinates.z
+    };
+    return templateUrl.replace(/{(level|x|y|z)}/gi, (_match, coordinateName) => String(values[coordinateName.toLowerCase()]));
+}
+/**
+ * Builds one available tile and recursively materializes descendants in the same subtree.
+ *
+ * @param subtree - Parsed availability declarations.
+ * @param reference - Current subtree reference.
+ * @param localCoordinates - Level and Morton index relative to the current subtree.
+ * @param globalCoordinates - Coordinates relative to the complete implicit hierarchy.
+ * @param counters - Mutable diagnostic counters owned by the public materializer call.
+ * @returns Header for an available tile, or `null` for a sparse unavailable position.
+ */
+function materializeAvailableTile(subtree, reference, localCoordinates, globalCoordinates, counters) {
+    const { descriptor } = reference;
+    const childCount = getImplicitChildCount(descriptor.subdivisionScheme);
+    const availabilityIndex = getLevelOffset(childCount, localCoordinates.localLevel) + localCoordinates.mortonIndex;
+    if (!getAvailabilityValue(subtree.tileAvailability, availabilityIndex)) {
+        return null;
+    }
+    counters.tileCount++;
+    const contentAvailable = getAvailabilityValue(getPrimaryContentAvailability(subtree.contentAvailability), availabilityIndex);
+    const children = [];
+    if (globalCoordinates.level < descriptor.maximumLevel) {
+        if (localCoordinates.localLevel + 1 < descriptor.subtreeLevels) {
+            for (let childIndex = 0; childIndex < childCount; childIndex++) {
+                const childCoordinates = getChildCoordinates(globalCoordinates, childIndex, descriptor.subdivisionScheme);
+                const childHeader = materializeAvailableTile(subtree, reference, {
+                    localLevel: localCoordinates.localLevel + 1,
+                    mortonIndex: localCoordinates.mortonIndex * childCount + childIndex
+                }, childCoordinates, counters);
+                if (childHeader) {
+                    children.push(childHeader);
+                }
+            }
+        }
+        else {
+            for (let childIndex = 0; childIndex < childCount; childIndex++) {
+                const childSubtreeIndex = localCoordinates.mortonIndex * childCount + childIndex;
+                if (getAvailabilityValue(subtree.childSubtreeAvailability, childSubtreeIndex)) {
+                    const childCoordinates = getChildCoordinates(globalCoordinates, childIndex, descriptor.subdivisionScheme);
+                    children.push(createLazyImplicitTileHeader(descriptor, childCoordinates));
+                    counters.childSubtreeCount++;
+                }
+            }
+        }
+    }
+    return formatImplicitTileHeader(descriptor, reference, globalCoordinates, contentAvailable, children);
+}
+/**
+ * Creates a contentless placeholder for an available child subtree.
+ *
+ * @param descriptor - Shared implicit hierarchy description.
+ * @param coordinates - Global coordinates of the child subtree root.
+ * @returns Header that participates in culling and SSE before its subtree is requested.
+ */
+function createLazyImplicitTileHeader(descriptor, coordinates) {
+    const reference = createImplicitSubtreeReference(descriptor, coordinates);
+    return {
+        id: getImplicitTileId(reference, coordinates),
+        children: [],
+        implicitSubtree: reference,
+        boundingVolume: calculateImplicitBoundingVolume(descriptor.rootBoundingVolume, coordinates, descriptor.subdivisionScheme),
+        geometricError: descriptor.rootLodMetricValue / 2 ** coordinates.level,
+        lodMetricType: descriptor.lodMetricType,
+        lodMetricValue: descriptor.rootLodMetricValue / 2 ** coordinates.level,
+        refine: descriptor.refine,
+        type: TILE_TYPE.EMPTY
+    };
+}
+/**
+ * Formats an available implicit tile as a runtime header.
+ *
+ * @param descriptor - Shared implicit hierarchy description.
+ * @param reference - Current subtree reference used to build stable IDs.
+ * @param coordinates - Global tile coordinates.
+ * @param contentAvailable - Whether the subtree declares render content for this tile.
+ * @param children - Materialized or lazy child headers.
+ * @returns Runtime tile header.
+ */
+function formatImplicitTileHeader(descriptor, reference, coordinates, contentAvailable, children) {
+    const contentUrl = contentAvailable && descriptor.contentUrlTemplate
+        ? replaceImplicitUrlTemplate(descriptor.contentUrlTemplate, coordinates)
+        : undefined;
+    const lodMetricValue = descriptor.rootLodMetricValue / 2 ** coordinates.level;
+    return {
+        id: getImplicitTileId(reference, coordinates),
+        children,
+        contentUrl,
+        content: contentUrl ? { ...descriptor.contentHeader, uri: contentUrl } : undefined,
+        refine: descriptor.refine,
+        type: getImplicitTileType(contentUrl),
+        lodMetricType: descriptor.lodMetricType,
+        lodMetricValue,
+        geometricError: lodMetricValue,
+        boundingVolume: calculateImplicitBoundingVolume(descriptor.rootBoundingVolume, coordinates, descriptor.subdivisionScheme)
+    };
+}
+/**
+ * Returns a stable identity for contentless and content-bearing implicit tiles.
+ *
+ * @param reference - Owning subtree reference.
+ * @param coordinates - Global tile coordinates.
+ * @returns Stable source identity independent of content availability.
+ */
+function getImplicitTileId(reference, coordinates) {
+    return `${reference.subtreeUrl}#implicit=${coordinates.level}/${coordinates.x}/${coordinates.y}/${coordinates.z}`;
+}
+/**
+ * Reads an availability bit without assuming 32-bit coordinate or Morton arithmetic.
+ *
+ * @param availability - Constant or expanded bitstream availability.
+ * @param index - Zero-based availability index.
+ * @returns Whether the addressed tile, content, or child subtree exists.
+ */
+function getAvailabilityValue(availability, index) {
+    if (typeof availability?.constant === 'number') {
+        return Boolean(availability.constant);
+    }
+    const bitstream = availability?.explicitBitstream;
+    if (!bitstream) {
+        return false;
+    }
+    const byteIndex = Math.floor(index / 8);
+    const bitIndex = index % 8;
+    return Boolean((bitstream[byteIndex] >> bitIndex) & 1);
+}
+/**
+ * Selects the first content availability stream until multiple contents are supported.
+ *
+ * @param availability - Single or multiple-content availability declaration.
+ * @returns Primary content availability declaration.
+ */
+function getPrimaryContentAvailability(availability) {
+    return Array.isArray(availability)
+        ? availability[0] || { constant: 0 }
+        : availability || { constant: 0 };
+}
+/**
+ * Calculates the breadth-first availability offset for a local subtree level.
+ *
+ * @param childCount - Branching factor of the subdivision scheme.
+ * @param localLevel - Level relative to the subtree root.
+ * @returns First availability index for the requested level.
+ */
+function getLevelOffset(childCount, localLevel) {
+    return (childCount ** localLevel - 1) / (childCount - 1);
+}
+/**
+ * Calculates one child's global implicit coordinates.
+ *
+ * @param parent - Global parent coordinates.
+ * @param childIndex - Morton-ordered child index.
+ * @param subdivisionScheme - Quadtree or octree subdivision.
+ * @returns Global child coordinates.
+ */
+function getChildCoordinates(parent, childIndex, subdivisionScheme) {
+    return {
+        level: parent.level + 1,
+        x: parent.x * 2 + (childIndex & 1),
+        y: parent.y * 2 + ((childIndex >> 1) & 1),
+        z: subdivisionScheme === 'OCTREE' ? parent.z * 2 + ((childIndex >> 2) & 1) : 0
+    };
+}
+/**
+ * Returns the branching factor for a supported implicit subdivision scheme.
+ *
+ * @param subdivisionScheme - Quadtree or octree subdivision.
+ * @returns Four for quadtrees or eight for octrees.
+ */
+function getImplicitChildCount(subdivisionScheme) {
+    return subdivisionScheme === 'OCTREE' ? OCTREE_CHILD_COUNT : QUADTREE_CHILD_COUNT;
+}
+/**
+ * Calculates the bounding volume for global implicit coordinates.
+ *
+ * Region volumes are divided in longitude/latitude and, for octrees, height. Oriented boxes are
+ * divided along their half-axis vectors. S2-derived boxes retain the root box conservatively: the
+ * lower-level tiles module intentionally does not duplicate the S2 geometry implementation owned
+ * by `@loaders.gl/3d-tiles`, and a conservative volume avoids incorrect culling.
+ *
+ * @param rootBoundingVolume - Bounding volume of the complete implicit hierarchy.
+ * @param coordinates - Global tile coordinates.
+ * @param subdivisionScheme - Quadtree or octree subdivision.
+ * @returns Bounding volume for the addressed tile.
+ */
+function calculateImplicitBoundingVolume(rootBoundingVolume, coordinates, subdivisionScheme) {
+    if (rootBoundingVolume.region) {
+        const [west, south, east, north, minimumHeight, maximumHeight] = rootBoundingVolume.region;
+        const divisionCount = 2 ** coordinates.level;
+        const longitudeSize = (east - west) / divisionCount;
+        const latitudeSize = (north - south) / divisionCount;
+        const childWest = west + longitudeSize * coordinates.x;
+        const childSouth = south + latitudeSize * coordinates.y;
+        let childMinimumHeight = minimumHeight;
+        let childMaximumHeight = maximumHeight;
+        if (subdivisionScheme === 'OCTREE') {
+            const heightSize = (maximumHeight - minimumHeight) / divisionCount;
+            childMinimumHeight = minimumHeight + heightSize * coordinates.z;
+            childMaximumHeight = childMinimumHeight + heightSize;
+        }
+        return {
+            region: [
+                childWest,
+                childSouth,
+                childWest + longitudeSize,
+                childSouth + latitudeSize,
+                childMinimumHeight,
+                childMaximumHeight
+            ]
+        };
+    }
+    if (rootBoundingVolume.box) {
+        if (rootBoundingVolume.s2VolumeInfo) {
+            return { box: [...rootBoundingVolume.box], s2VolumeInfo: rootBoundingVolume.s2VolumeInfo };
+        }
+        const box = rootBoundingVolume.box;
+        const divisionCount = 2 ** coordinates.level;
+        const xOffset = -1 + (2 * coordinates.x + 1) / divisionCount;
+        const yOffset = -1 + (2 * coordinates.y + 1) / divisionCount;
+        const zOffset = -1 + (2 * coordinates.z + 1) / divisionCount;
+        const divideHeight = subdivisionScheme === 'OCTREE';
+        const center = [
+            box[0] + box[3] * xOffset + box[6] * yOffset + (divideHeight ? box[9] * zOffset : 0),
+            box[1] + box[4] * xOffset + box[7] * yOffset + (divideHeight ? box[10] * zOffset : 0),
+            box[2] + box[5] * xOffset + box[8] * yOffset + (divideHeight ? box[11] * zOffset : 0)
+        ];
+        return {
+            box: [
+                ...center,
+                box[3] / divisionCount,
+                box[4] / divisionCount,
+                box[5] / divisionCount,
+                box[6] / divisionCount,
+                box[7] / divisionCount,
+                box[8] / divisionCount,
+                divideHeight ? box[9] / divisionCount : box[9],
+                divideHeight ? box[10] / divisionCount : box[10],
+                divideHeight ? box[11] / divisionCount : box[11]
+            ]
+        };
+    }
+    throw new Error(`Unsupported implicit 3D Tiles bounding volume: ${JSON.stringify(rootBoundingVolume)}`);
+}
+/**
+ * Detects the runtime tile category from an available content URL.
+ *
+ * @param contentUrl - Concrete content URL, if content is available.
+ * @returns Runtime tile category.
+ */
+function getImplicitTileType(contentUrl) {
+    if (!contentUrl) {
+        return TILE_TYPE.EMPTY;
+    }
+    const extension = contentUrl.split('?')[0].split('.').pop()?.toLowerCase();
+    switch (extension) {
+        case 'pnts':
+            return TILE_TYPE.POINTCLOUD;
+        case 'i3dm':
+        case 'b3dm':
+        case 'glb':
+        case 'gltf':
+            return TILE_TYPE.SCENEGRAPH;
+        default:
+            return extension || TILE_TYPE.EMPTY;
+    }
+}
+/**
+ * Validates descriptor invariants before allocating a runtime subtree.
+ *
+ * @param descriptor - Serializable implicit hierarchy description.
+ * @throws If levels, scheme, or maximum-level semantics are invalid.
+ */
+function validateImplicitDescriptor(descriptor) {
+    if (descriptor.subdivisionScheme !== 'QUADTREE' && descriptor.subdivisionScheme !== 'OCTREE') {
+        throw new Error(`Unsupported implicit subdivision scheme: ${descriptor.subdivisionScheme}`);
+    }
+    if (!Number.isInteger(descriptor.subtreeLevels) || descriptor.subtreeLevels < 1) {
+        throw new Error('Implicit subtreeLevels must be a positive integer');
+    }
+    if (!Number.isInteger(descriptor.maximumLevel) || descriptor.maximumLevel < 0) {
+        throw new Error('Implicit availableLevels must describe at least the root level');
+    }
+}
+//# sourceMappingURL=implicit-tiling.js.map

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

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

package/dist/tileset-3d/format-3d-tiles/tiles-3d-source.d.ts

@@ -0,0 +1,189 @@
+import type { CoreAPI, LoaderOptions, LoaderWithParser } from '@loaders.gl/loader-utils';
+import type { Tile3D } from "../common/tile-3d.js";
+import type { Tileset3D } from "../common/tileset-3d.js";
+import type { TileChildrenLoadResult, TileContentLoadResult, TilesetContentFormats, TilesetJSON, Tileset3DSource, TilesetSourceInput, TilesetSourceMetadata, TilesetSourceViewState } from "../common/tileset-source.js";
+import { TILESET_TYPE } from "../../constants.js";
+import type { TilesetTraverser, TilesetTraverserProps } from "../common/tileset-traverser.js";
+import type { FrameState } from "../helpers/frame-state.js";
+/** Diagnostics for source-managed implicit subtree loading. */
+export type ImplicitTilingStats = {
+    /** Subtree resources requested from the resolver or core API. */
+    requestedSubtrees: number;
+    /** Successful subtree materializations, including parsed-cache hits. */
+    loadedSubtrees: number;
+    /** Requests served by the source's parsed-subtree cache. */
+    cacheHits: number;
+    /** Parsed subtree resources currently retained for reuse. */
+    cachedSubtrees: number;
+    /** Subtree resource requests currently in flight. */
+    pendingSubtrees: number;
+    /** Runtime headers created below already-existing subtree-root placeholders. */
+    materializedTiles: number;
+};
+/**
+ * {@link Tileset3DSource} implementation for 3D Tiles datasets.
+ */
+export declare class Tiles3DSource implements Tileset3DSource {
+    /** 3D Tiles format discriminator. */
+    readonly type = TILESET_TYPE.TILES3D;
+    /** Loader used for tile content requests. */
+    readonly loader: LoaderWithParser;
+    /** Root tileset URL. */
+    readonly url: string;
+    /** Base path used for relative tile resource resolution. */
+    readonly basePath: string;
+    /** Parsed root tileset payload. */
+    tileset: TilesetJSON | null;
+    /** Loader options forwarded to content requests. */
+    readonly loadOptions: LoaderOptions;
+    /** Core API used for root and tile-content loads when injected by the caller. */
+    coreApi?: CoreAPI;
+    /** Aggregate content-format flags discovered during streaming. */
+    readonly contentFormats: TilesetContentFormats;
+    /** Top-level 3D Tiles asset metadata. */
+    asset?: Record<string, any>;
+    /** Top-level per-feature properties metadata. */
+    properties?: any;
+    /** Top-level application-specific metadata. */
+    extras?: any;
+    /** Source-provided attribution metadata. */
+    credits?: any;
+    /** Normalized source metadata after initialization. */
+    metadata?: TilesetSourceMetadata;
+    private readonly queryParams;
+    /** Final request URLs cached by unmodified tile content URL. */
+    private readonly tileUrlCache;
+    /** Parsed subtree promises keyed by final source URL for request deduplication and LRU reuse. */
+    private readonly implicitSubtreeCache;
+    /** URLs whose subtree resource requests have not settled. */
+    private readonly pendingImplicitSubtreeUrls;
+    /** Maximum number of settled parsed subtrees retained by this source. */
+    private readonly maximumCachedSubtrees;
+    /** Mutable counters exposed as a defensive snapshot through {@link getImplicitTilingStats}. */
+    private readonly implicitTilingStats;
+    /** Whether the owning tileset has released this source. */
+    private destroyed;
+    private readonly extensionsUsed;
+    private readonly resolver?;
+    private rootTileset;
+    /**
+     * Creates a 3D Tiles source.
+     * @param input Root metadata request, or preloaded root metadata for tests and internal callers.
+     * @param loadOptions Loader options forwarded to tile requests.
+     */
+    constructor(input: TilesetSourceInput, loadOptions?: LoaderOptions);
+    /**
+     * Releases URL and parsed-subtree caches and blocks late subtree installation.
+     *
+     * The injected resolver or core API remains responsible for transport-level abort signals. A
+     * request that cannot be aborted may finish parsing, but it will not mutate destroyed tiles.
+     */
+    destroy(): void;
+    /**
+     * Fetches and validates top-level metadata, then normalizes common fields used by {@link Tileset3D}.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Returns normalized source metadata after initialization.
+     */
+    getMetadata(): TilesetSourceMetadata;
+    /**
+     * Returns the root 3D Tiles payload.
+     */
+    getRootTileset(): Promise<TilesetJSON>;
+    /**
+     * Builds explicit runtime headers while leaving implicit subtree references lazy.
+     */
+    initializeTileHeaders(tileset: Tileset3D, tilesetJson: TilesetJSON, parentTile?: Tile3D | null): Tile3D;
+    /**
+     * Creates the standard 3D Tiles traverser.
+     */
+    createTraverser(options: TilesetTraverserProps): TilesetTraverser;
+    /**
+     * Loads binary content or nested tileset JSON for a runtime tile.
+     */
+    loadTileContent(tile: Tile3D): Promise<TileContentLoadResult>;
+    /**
+     * Loads, materializes, and installs exactly one implicit subtree.
+     *
+     * Final URLs pass through the same query inheritance and archive/custom resolver path as render
+     * content. Parsed resources are deduplicated by final URL, while the pure materializer creates
+     * lazy placeholders for every available child subtree instead of recursively fetching them.
+     *
+     * @param tile - Existing contentless subtree-root placeholder.
+     * @param frameState - View state that made this request eligible; priority is consumed earlier.
+     * @returns Counts describing the installed subtree.
+     */
+    loadTileChildren(tile: Tile3D, frameState: FrameState): Promise<TileChildrenLoadResult>;
+    /**
+     * Returns a snapshot of implicit-subtree request, cache, and materialization counters.
+     *
+     * @returns Immutable-by-convention diagnostic values for runtime inspection.
+     */
+    getImplicitTilingStats(): ImplicitTilingStats;
+    /**
+     * Resolves a tile content URL with source-managed query parameters.
+     *
+     * Existing per-resource parameters take precedence over inherited root, version, and session
+     * values. Completed URLs are cached by the original tile path; {@link setQueryParameter}
+     * invalidates the cache before changed source state can be observed.
+     *
+     * @param tilePath - Unmodified absolute content URL or data URL from the tile header.
+     * @returns Content URL with any missing source parameters appended.
+     */
+    getTileUrl(tilePath: string): string;
+    /**
+     * Updates an inherited source query parameter and invalidates derived request URLs.
+     *
+     * Root tokens and tileset versions normally settle during initialization. Some providers expose
+     * a session parameter on a child URL, so invalidation is required to prevent URLs cached earlier
+     * in header construction from retaining stale authentication state.
+     *
+     * @param parameterName - Query parameter name.
+     * @param parameterValue - Query parameter value.
+     */
+    private setQueryParameter;
+    /**
+     * Derives the default view state from the root bounding volume.
+     */
+    getViewState(rootTile: Tile3D | null): TilesetSourceViewState;
+    /**
+     * Checks whether the root tileset declares the given extension.
+     */
+    hasExtension(extensionName: string): boolean;
+    /**
+     * Updates content-format flags and installs nested tileset subtrees.
+     */
+    onTileLoaded(tileset: Tileset3D, tile: Tile3D, loadResult: TileContentLoadResult): void;
+    /**
+     * Loads data through injected core APIs so this module stays independent from `@loaders.gl/core`.
+     */
+    private loadWithCoreApi;
+    /**
+     * Loads data through an injected resolver when present, otherwise through the injected core API.
+     */
+    private loadRootData;
+    /**
+     * Loads an arbitrary source resource through an injected resolver or core API.
+     */
+    private loadResourceData;
+    /**
+     * Returns a parsed subtree from the LRU cache or starts one source-managed request.
+     *
+     * @param subtreeUrl - Final subtree URL after query inheritance.
+     * @returns Parsed subtree availability data.
+     */
+    private loadImplicitSubtreeResource;
+    /**
+     * Instantiates every header represented by one materialized subtree.
+     *
+     * @param tileset - Owning runtime tileset.
+     * @param parentTile - Existing materialized parent.
+     * @param childHeaders - Headers to install below the parent.
+     * @returns Number of newly allocated runtime tile nodes.
+     */
+    private initializeMaterializedChildren;
+    /** Evicts least-recently-used settled subtree entries until the configured bound is met. */
+    private trimImplicitSubtreeCache;
+}
+//# sourceMappingURL=tiles-3d-source.d.ts.map

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

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