@loaders.gl/tiles 4.4.2 → 5.0.0-alpha.1

package/dist/raster-set.d.ts

@@ -0,0 +1,107 @@
+import type { GetRasterParameters, RasterData, RasterSource, RasterSourceMetadata } from '@loaders.gl/loader-utils';
+/** Accepted raster request currently retained by {@link RasterSet}. */
+export type RasterSetRequest<DataT = RasterData> = {
+    /** Unique request id assigned by the manager. */
+    requestId: number;
+    /** Raster request parameters that produced the accepted raster payload. */
+    parameters: GetRasterParameters;
+    /** Raster retained as the current output. */
+    raster: DataT;
+};
+/** Arguments supplied to {@link RasterSetBaseProps.shouldRefetch}. */
+export type RasterSetShouldRefetchArgs<DataT = RasterData> = {
+    /** Current accepted request retained by the raster manager, if any. */
+    currentRequest: RasterSetRequest<DataT> | null;
+    /** Source metadata resolved by {@link RasterSet.loadMetadata}, if available. */
+    metadata: RasterSourceMetadata | null;
+    /** Candidate raster request parameters under evaluation. */
+    nextParameters: GetRasterParameters;
+};
+/** Configuration shared by all {@link RasterSet} instances. */
+export type RasterSetBaseProps<DataT = RasterData> = {
+    /** Callback used to load source metadata. */
+    getMetadata: () => Promise<RasterSourceMetadata>;
+    /** Callback used to load raster data for a viewport-derived request. */
+    getRaster: (parameters: GetRasterParameters) => Promise<DataT>;
+    /** Debounce interval applied before issuing raster requests. */
+    debounceTime?: number;
+    /** Optional policy callback that can skip redundant raster requests. */
+    shouldRefetch?: (args: RasterSetShouldRefetchArgs<DataT>) => boolean;
+};
+/** Options for creating a {@link RasterSet}. */
+export type RasterSetProps<DataT = RasterData> = Partial<RasterSetBaseProps<DataT>> & {
+    /** Optional loaders.gl raster source backing this manager. */
+    rasterSource?: RasterSource | null;
+};
+/** Subscription callbacks emitted by {@link RasterSet}. */
+export type RasterSetListener<DataT = RasterData> = {
+    /** Fired when metadata/raster loading starts or stops. */
+    onLoadingStateChange?: (isLoading: boolean) => void;
+    /** Fired when source metadata resolves successfully. */
+    onMetadataLoad?: (metadata: RasterSourceMetadata) => void;
+    /** Fired when metadata loading fails. */
+    onMetadataLoadError?: (error: Error) => void;
+    /** Fired when a new raster request is issued. */
+    onRasterLoadStart?: (requestId: number, parameters: GetRasterParameters) => void;
+    /** Fired when a raster request resolves and becomes current. */
+    onRasterLoad?: (request: RasterSetRequest<DataT>) => void;
+    /** Fired when a raster request fails. */
+    onRasterLoadError?: (requestId: number, error: Error, parameters: GetRasterParameters) => void;
+    /** Fired when metadata or the current raster changes. */
+    onUpdate?: () => void;
+};
+/** Shared raster request manager used by viewport-driven raster examples and layers. */
+export declare class RasterSet<DataT = RasterData> {
+    /** Cached metadata returned by the backing source, if any. */
+    metadata: RasterSourceMetadata | null;
+    private _opts;
+    private _listeners;
+    private _currentRequest;
+    private _lastAcceptedRequestId;
+    private _nextRequestId;
+    private _loadCounter;
+    private _timeoutId;
+    private _abortController;
+    private _finalized;
+    /** Creates a raster manager from a source or direct callbacks. */
+    constructor(opts: RasterSetProps<DataT>);
+    /** Convenience factory for wrapping a loaders.gl {@link RasterSource}. */
+    static fromRasterSource<DataT = RasterData>(rasterSource: RasterSource, opts?: Omit<RasterSetProps<DataT>, 'rasterSource' | 'getRaster' | 'getMetadata'>): RasterSet<DataT>;
+    /** Whether the manager has no requests in flight and a current raster. */
+    get isLoaded(): boolean;
+    /** Current accepted raster, if any. */
+    get raster(): DataT | null;
+    /** Current accepted request and raster payload, if any. */
+    get currentRequest(): RasterSetRequest<DataT> | null;
+    /** Backing raster source when constructed from one. */
+    get rasterSource(): RasterSource | null;
+    /** Subscribes to metadata and raster lifecycle events. */
+    subscribe(listener: RasterSetListener<DataT>): () => void;
+    /** Updates source callbacks or debounce settings, resetting state when the source changes. */
+    setOptions(opts: RasterSetProps<DataT>): void;
+    /** Loads metadata from the current raster source or callbacks. */
+    loadMetadata(): Promise<RasterSourceMetadata>;
+    /** Debounces and issues a new raster request for the supplied parameters. */
+    requestRaster(parameters: GetRasterParameters, debounceTime?: number): number;
+    /** Returns `true` when the supplied parameters warrant a new raster fetch. */
+    shouldRefetchRaster(parameters: GetRasterParameters): boolean;
+    /** Clears timers and listeners held by the manager. */
+    finalize(): void;
+    /** Loads a raster immediately and accepts it only if it is the newest completed request. */
+    private _loadRaster;
+    /** Resolves current options from either a source or direct callbacks. */
+    private _normalizeOptions;
+    /** Emits one generic update notification to all subscribers. */
+    private _emitUpdate;
+    /** Emits one loading-state transition to all subscribers. */
+    private _emitLoadingStateChange;
+    /** Increments the active load count and emits loading-state transitions. */
+    private _startLoading;
+    /** Decrements the active load count and emits loading-state transitions. */
+    private _finishLoading;
+    /** Clears any pending debounced raster request before it hits the network. */
+    private _cancelScheduledRaster;
+    /** Aborts the currently active raster request, if one exists. */
+    private _abortActiveRequest;
+}
+//# sourceMappingURL=raster-set.d.ts.map

package/dist/raster-set.d.ts.map

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

package/dist/raster-set.js

@@ -0,0 +1,268 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+const DEFAULT_RASTERSET_PROPS = {
+    getMetadata: async () => ({
+        width: 0,
+        height: 0,
+        bandCount: 0,
+        dtype: 'uint8'
+    }),
+    getRaster: async () => ({
+        data: new Uint8Array(0),
+        width: 0,
+        height: 0,
+        bandCount: 0,
+        dtype: 'uint8'
+    }),
+    debounceTime: 0,
+    shouldRefetch: () => true
+};
+/** Shared raster request manager used by viewport-driven raster examples and layers. */
+export class RasterSet {
+    /** Cached metadata returned by the backing source, if any. */
+    metadata = null;
+    _opts;
+    _listeners = new Set();
+    _currentRequest = null;
+    _lastAcceptedRequestId = -1;
+    _nextRequestId = 0;
+    _loadCounter = 0;
+    _timeoutId = null;
+    _abortController = null;
+    _finalized = false;
+    /** Creates a raster manager from a source or direct callbacks. */
+    constructor(opts) {
+        this._opts = this._normalizeOptions(opts);
+        if (!this._opts.rasterSource && (!opts.getRaster || !opts.getMetadata)) {
+            throw new Error('RasterSet requires either `rasterSource` or both `getRaster` and `getMetadata`.');
+        }
+    }
+    /** Convenience factory for wrapping a loaders.gl {@link RasterSource}. */
+    static fromRasterSource(rasterSource, opts = {}) {
+        return new RasterSet({ ...opts, rasterSource });
+    }
+    /** Whether the manager has no requests in flight and a current raster. */
+    get isLoaded() {
+        return this._loadCounter === 0 && Boolean(this._currentRequest);
+    }
+    /** Current accepted raster, if any. */
+    get raster() {
+        return this._currentRequest?.raster || null;
+    }
+    /** Current accepted request and raster payload, if any. */
+    get currentRequest() {
+        return this._currentRequest;
+    }
+    /** Backing raster source when constructed from one. */
+    get rasterSource() {
+        return this._opts.rasterSource;
+    }
+    /** Subscribes to metadata and raster lifecycle events. */
+    subscribe(listener) {
+        this._listeners.add(listener);
+        return () => this._listeners.delete(listener);
+    }
+    /** Updates source callbacks or debounce settings, resetting state when the source changes. */
+    setOptions(opts) {
+        const previousRasterSource = this._opts.rasterSource;
+        const nextOptions = this._normalizeOptions({ ...this._opts, ...opts });
+        const sourceChanged = previousRasterSource !== nextOptions.rasterSource ||
+            this._opts.getRaster !== nextOptions.getRaster ||
+            this._opts.getMetadata !== nextOptions.getMetadata;
+        this._opts = nextOptions;
+        if (sourceChanged) {
+            this._cancelScheduledRaster();
+            this.metadata = null;
+            this._currentRequest = null;
+            this._lastAcceptedRequestId = -1;
+            this._nextRequestId = 0;
+            this._emitUpdate();
+        }
+    }
+    /** Loads metadata from the current raster source or callbacks. */
+    async loadMetadata() {
+        this._startLoading();
+        try {
+            const metadata = await this._opts.getMetadata();
+            if (this._finalized) {
+                return metadata;
+            }
+            this.metadata = metadata;
+            for (const listener of this._listeners) {
+                listener.onMetadataLoad?.(metadata);
+            }
+            this._emitUpdate();
+            return metadata;
+        }
+        catch (error) {
+            const normalizedError = normalizeRasterSetError(error, 'Raster metadata request failed');
+            if (!this._finalized) {
+                for (const listener of this._listeners) {
+                    listener.onMetadataLoadError?.(normalizedError);
+                }
+            }
+            throw normalizedError;
+        }
+        finally {
+            this._finishLoading();
+        }
+    }
+    /** Debounces and issues a new raster request for the supplied parameters. */
+    requestRaster(parameters, debounceTime = this._opts.debounceTime) {
+        if (!this.shouldRefetchRaster(parameters)) {
+            return this._currentRequest?.requestId ?? -1;
+        }
+        const requestId = this._nextRequestId++;
+        this._cancelScheduledRaster();
+        if (debounceTime > 0) {
+            this._timeoutId = setTimeout(() => {
+                this._timeoutId = null;
+                void this._loadRaster(requestId, parameters);
+            }, debounceTime);
+        }
+        else {
+            void this._loadRaster(requestId, parameters);
+        }
+        return requestId;
+    }
+    /** Returns `true` when the supplied parameters warrant a new raster fetch. */
+    shouldRefetchRaster(parameters) {
+        return this._opts.shouldRefetch({
+            currentRequest: this._currentRequest,
+            metadata: this.metadata,
+            nextParameters: parameters
+        });
+    }
+    /** Clears timers and listeners held by the manager. */
+    finalize() {
+        this._finalized = true;
+        this._cancelScheduledRaster();
+        this._abortActiveRequest();
+        this._listeners.clear();
+    }
+    /** Loads a raster immediately and accepts it only if it is the newest completed request. */
+    async _loadRaster(requestId, parameters) {
+        if (this._finalized) {
+            return;
+        }
+        this._startLoading();
+        for (const listener of this._listeners) {
+            listener.onRasterLoadStart?.(requestId, parameters);
+        }
+        try {
+            const abortController = new AbortController();
+            this._abortController = abortController;
+            const raster = await this._opts.getRaster({ ...parameters, signal: abortController.signal });
+            if (this._finalized ||
+                abortController.signal.aborted ||
+                requestId <= this._lastAcceptedRequestId) {
+                return;
+            }
+            this._lastAcceptedRequestId = requestId;
+            this._currentRequest = { requestId, parameters, raster };
+            for (const listener of this._listeners) {
+                listener.onRasterLoad?.(this._currentRequest);
+            }
+            this._emitUpdate();
+        }
+        catch (error) {
+            if (isAbortError(error)) {
+                return;
+            }
+            const normalizedError = normalizeRasterSetError(error, 'Raster request failed');
+            if (!this._finalized) {
+                for (const listener of this._listeners) {
+                    listener.onRasterLoadError?.(requestId, normalizedError, parameters);
+                }
+            }
+        }
+        finally {
+            this._abortController = null;
+            this._finishLoading();
+        }
+    }
+    /** Resolves current options from either a source or direct callbacks. */
+    _normalizeOptions(opts) {
+        const rasterSource = opts.rasterSource || null;
+        return {
+            ...DEFAULT_RASTERSET_PROPS,
+            ...opts,
+            rasterSource,
+            getMetadata: opts.getMetadata ||
+                (() => {
+                    if (rasterSource) {
+                        return rasterSource.getMetadata();
+                    }
+                    return DEFAULT_RASTERSET_PROPS.getMetadata();
+                }),
+            getRaster: opts.getRaster ||
+                ((parameters) => {
+                    if (rasterSource) {
+                        return rasterSource.getRaster(parameters);
+                    }
+                    return DEFAULT_RASTERSET_PROPS.getRaster(parameters);
+                }),
+            debounceTime: opts.debounceTime ?? DEFAULT_RASTERSET_PROPS.debounceTime,
+            shouldRefetch: opts.shouldRefetch ||
+                ((args) => DEFAULT_RASTERSET_PROPS.shouldRefetch(args))
+        };
+    }
+    /** Emits one generic update notification to all subscribers. */
+    _emitUpdate() {
+        for (const listener of this._listeners) {
+            listener.onUpdate?.();
+        }
+    }
+    /** Emits one loading-state transition to all subscribers. */
+    _emitLoadingStateChange(isLoading) {
+        for (const listener of this._listeners) {
+            listener.onLoadingStateChange?.(isLoading);
+        }
+    }
+    /** Increments the active load count and emits loading-state transitions. */
+    _startLoading() {
+        const wasLoading = this._loadCounter > 0;
+        this._loadCounter++;
+        if (!wasLoading) {
+            this._emitLoadingStateChange(true);
+            this._emitUpdate();
+        }
+    }
+    /** Decrements the active load count and emits loading-state transitions. */
+    _finishLoading() {
+        const wasLoading = this._loadCounter > 0;
+        this._loadCounter = Math.max(0, this._loadCounter - 1);
+        if (wasLoading && this._loadCounter === 0) {
+            this._emitLoadingStateChange(false);
+            this._emitUpdate();
+        }
+    }
+    /** Clears any pending debounced raster request before it hits the network. */
+    _cancelScheduledRaster() {
+        if (this._timeoutId !== null) {
+            clearTimeout(this._timeoutId);
+            this._timeoutId = null;
+        }
+    }
+    /** Aborts the currently active raster request, if one exists. */
+    _abortActiveRequest() {
+        this._abortController?.abort();
+        this._abortController = null;
+    }
+}
+/** Normalizes arbitrary thrown values to `Error` instances for raster-set callbacks. */
+function normalizeRasterSetError(error, message) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (typeof error === 'string') {
+        return new Error(error);
+    }
+    return new Error(message);
+}
+/** Returns true when an error came from an aborted request. */
+function isAbortError(error) {
+    return error instanceof Error && error.name === 'AbortError';
+}
+//# sourceMappingURL=raster-set.js.map

package/dist/raster-set.js.map

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

package/dist/tileset-2d/adapter.d.ts

@@ -0,0 +1,38 @@
+import type { Matrix4 } from '@math.gl/core';
+import type { Bounds, TileBoundingBox, TileIndex, ZRange } from "./types.js";
+/** Traversal inputs required by a {@link Tileset2DAdapter}. */
+export type Tileset2DTraversalContext<ViewStateT> = {
+    /** Consumer-defined view state used by the adapter. */
+    viewState: ViewStateT;
+    /** Tile size in pixels. */
+    tileSize: number;
+    /** Bounding box limiting tile generation. */
+    extent?: Bounds | null;
+    /** Minimum zoom level to request. */
+    minZoom?: number;
+    /** Maximum zoom level to request. */
+    maxZoom?: number;
+    /** Integer zoom offset applied during tile selection. */
+    zoomOffset?: number;
+    /** Elevation range used during geospatial tile selection. */
+    zRange?: ZRange | null;
+    /** Optional model matrix applied by the surrounding layer stack. */
+    modelMatrix?: Matrix4 | null;
+    /** Inverse of the current model matrix. */
+    modelMatrixInverse?: Matrix4 | null;
+};
+/** Minimal tile metadata inputs required by a {@link Tileset2DAdapter}. */
+export type Tileset2DTileContext<ViewStateT> = {
+    /** Consumer-defined view state used by the adapter. */
+    viewState: ViewStateT;
+    /** Tile size in pixels. */
+    tileSize: number;
+};
+/** Adapter used by {@link Tileset2D} to compute traversal and tile bounds. */
+export type Tileset2DAdapter<ViewStateT> = {
+    /** Returns tile indices that should be selected for one traversal context. */
+    getTileIndices: (context: Tileset2DTraversalContext<ViewStateT>) => TileIndex[];
+    /** Returns the structured bounding box for one tile index. */
+    getTileBoundingBox: (context: Tileset2DTileContext<ViewStateT>, index: TileIndex) => TileBoundingBox;
+};
+//# sourceMappingURL=adapter.d.ts.map

package/dist/tileset-2d/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/tileset-2d/adapter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,OAAO,EAAC,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAC,mBAAgB;AAExE,+DAA+D;AAC/D,MAAM,MAAM,yBAAyB,CAAC,UAAU,IAAI;IAClD,uDAAuD;IACvD,SAAS,EAAE,UAAU,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oEAAoE;IACpE,WAAW,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7B,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,CAAC,UAAU,IAAI;IAC7C,uDAAuD;IACvD,SAAS,EAAE,UAAU,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,8EAA8E;AAC9E,MAAM,MAAM,gBAAgB,CAAC,UAAU,IAAI;IACzC,8EAA8E;IAC9E,cAAc,EAAE,CAAC,OAAO,EAAE,yBAAyB,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;IAChF,8DAA8D;IAC9D,kBAAkB,EAAE,CAClB,OAAO,EAAE,oBAAoB,CAAC,UAAU,CAAC,EACzC,KAAK,EAAE,SAAS,KACb,eAAe,CAAC;CACtB,CAAC"}

package/dist/tileset-2d/adapter.js

@@ -0,0 +1,5 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export {};
+//# sourceMappingURL=adapter.js.map

package/dist/tileset-2d/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/tileset-2d/adapter.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC"}

package/dist/tileset-2d/index.d.ts

@@ -0,0 +1,7 @@
+export type { Bounds, GeoBoundingBox, NonGeoBoundingBox, TileBoundingBox, TileIndex, TileLoadProps, ZRange } from "./types.js";
+export type { Tileset2DAdapter, Tileset2DTileContext, Tileset2DTraversalContext } from "./adapter.js";
+export type { Tile2DLoadDataProps } from "./tile-2d-header.js";
+export { SharedTile2DHeader } from "./tile-2d-header.js";
+export type { RefinementStrategy, RefinementStrategyFunction, Tileset2DBaseProps, Tileset2DProps, Tile2DListener } from "./tileset-2d.js";
+export { Tileset2D, STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "./tileset-2d.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tileset-2d/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tileset-2d/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,SAAS,EACT,aAAa,EACb,MAAM,EACP,mBAAgB;AACjB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,EAC1B,qBAAkB;AACnB,YAAY,EAAC,mBAAmB,EAAC,4BAAyB;AAC1D,OAAO,EAAC,kBAAkB,EAAC,4BAAyB;AACpD,YAAY,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,kBAAkB,EAClB,cAAc,EACd,cAAc,EACf,wBAAqB;AACtB,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,wBAAqB"}

package/dist/tileset-2d/index.js

@@ -0,0 +1,6 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+export { SharedTile2DHeader } from "./tile-2d-header.js";
+export { Tileset2D, STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "./tileset-2d.js";
+//# sourceMappingURL=index.js.map

package/dist/tileset-2d/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tileset-2d/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAiBpC,OAAO,EAAC,kBAAkB,EAAC,4BAAyB;AAQpD,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EACjB,wBAAqB"}

package/dist/tileset-2d/tile-2d-header.d.ts

@@ -0,0 +1,68 @@
+import { RequestScheduler } from '@loaders.gl/loader-utils';
+import type { TileBoundingBox, TileIndex, TileLoadProps } from "./types.js";
+/** Parameters used by {@link SharedTile2DHeader.loadData}. */
+export type Tile2DLoadDataProps<DataT = any> = {
+    /** Shared request scheduler for throttling tile fetches. */
+    requestScheduler: RequestScheduler;
+    /** Application-provided tile data loader. */
+    getData: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;
+    /** Callback fired after tile content resolves successfully. */
+    onLoad: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Callback fired after tile content fails to load. */
+    onError: (error: any, tile: SharedTile2DHeader<DataT>) => void;
+};
+/** Shared tile cache entry used by {@link Tileset2D}. */
+export declare class SharedTile2DHeader<DataT = any> {
+    /** x/y/z tile coordinate. */
+    index: TileIndex;
+    /** Closest cached ancestor tile in the current tree. */
+    parent: SharedTile2DHeader | null;
+    /** Cached child tiles beneath this tile. */
+    children: SharedTile2DHeader[] | null;
+    /** Loaded tile payload. */
+    content: DataT | null;
+    /** Cached tile load error, if the last request failed. */
+    error: Error | null;
+    /** Stable tile cache id. */
+    id: string;
+    /** Resolved zoom level for the tile. */
+    zoom: number;
+    /** Optional application data associated with the tile. */
+    userData?: Record<string, any>;
+    /** Bounds represented as `[[minX, minY], [maxX, maxY]]` for loaders.gl compatibility. */
+    boundingBox: [min: number[], max: number[]];
+    private _abortController;
+    private _loader;
+    private _loaderId;
+    private _isLoaded;
+    private _isCancelled;
+    private _needsReload;
+    private _bbox;
+    /** Creates a tile header for a specific tile index. */
+    constructor(index: TileIndex);
+    /** Structured bounds for the tile in the active coordinate system. */
+    get bbox(): TileBoundingBox;
+    /** Initializes the tile bounds once during tile creation. */
+    set bbox(value: TileBoundingBox);
+    /** Resolves to loaded content while a request is in flight, otherwise returns cached content. */
+    get data(): Promise<DataT | null> | DataT | null;
+    /** Indicates whether tile content is available and up to date. */
+    get isLoaded(): boolean;
+    /** Indicates whether a tile request is currently in flight. */
+    get isLoading(): boolean;
+    /** Indicates whether the tile is cached in a failed state. */
+    get hasError(): boolean;
+    /** Indicates whether the tile should be requested again. */
+    get needsReload(): boolean;
+    /** Estimated byte size of the cached payload. */
+    get byteLength(): number;
+    /** Internal request pipeline used by {@link loadData}. */
+    private _loadData;
+    /** Loads tile data through the shared scheduler. */
+    loadData(opts: Tile2DLoadDataProps<DataT>): Promise<void>;
+    /** Marks the tile stale so it is refreshed on the next traversal. */
+    setNeedsReload(): void;
+    /** Cancels an in-flight tile request. */
+    abort(): void;
+}
+//# sourceMappingURL=tile-2d-header.d.ts.map

package/dist/tileset-2d/tile-2d-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-2d-header.d.ts","sourceRoot":"","sources":["../../src/tileset-2d/tile-2d-header.ts"],"names":[],"mappings":"AAKA,OAAO,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,KAAK,EAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAC,mBAAgB;AAEvE,8DAA8D;AAC9D,MAAM,MAAM,mBAAmB,CAAC,KAAK,GAAG,GAAG,IAAI;IAC7C,4DAA4D;IAC5D,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,6CAA6C;IAC7C,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAAC;IACxE,+DAA+D;IAC/D,MAAM,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAClD,uDAAuD;IACvD,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CAChE,CAAC;AAEF,yDAAyD;AACzD,qBAAa,kBAAkB,CAAC,KAAK,GAAG,GAAG;IACzC,6BAA6B;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,wDAAwD;IACxD,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAClC,4CAA4C;IAC5C,QAAQ,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;IACtC,2BAA2B;IAC3B,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IACtB,0DAA0D;IAC1D,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,4BAA4B;IAC5B,EAAE,EAAG,MAAM,CAAC;IACZ,wCAAwC;IACxC,IAAI,EAAG,MAAM,CAAC;IACd,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,yFAAyF;IACzF,WAAW,EAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7C,OAAO,CAAC,gBAAgB,CAAyB;IACjD,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAU;IAC3B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,KAAK,CAAmB;IAEhC,uDAAuD;gBAC3C,KAAK,EAAE,SAAS;IAc5B,sEAAsE;IACtE,IAAI,IAAI,IAAI,eAAe,CAE1B;IAED,6DAA6D;IAC7D,IAAI,IAAI,CAAC,KAAK,EAAE,eAAe,EAiB9B;IAED,iGAAiG;IACjG,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAM/C;IAED,kEAAkE;IAClE,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,+DAA+D;IAC/D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,8DAA8D;IAC9D,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,4DAA4D;IAC5D,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,iDAAiD;IACjD,IAAI,UAAU,IAAI,MAAM,CAGvB;IAED,0DAA0D;YAC5C,SAAS;IA2DvB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD,qEAAqE;IACrE,cAAc,IAAI,IAAI;IAQtB,yCAAyC;IACzC,KAAK,IAAI,IAAI;CAOd"}