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

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

@@ -0,0 +1,181 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/** Shared tile cache entry used by {@link Tileset2D}. */
+export class SharedTile2DHeader {
+    /** x/y/z tile coordinate. */
+    index;
+    /** Closest cached ancestor tile in the current tree. */
+    parent;
+    /** Cached child tiles beneath this tile. */
+    children;
+    /** Loaded tile payload. */
+    content;
+    /** Cached tile load error, if the last request failed. */
+    error;
+    /** Stable tile cache id. */
+    id;
+    /** Resolved zoom level for the tile. */
+    zoom;
+    /** Optional application data associated with the tile. */
+    userData;
+    /** Bounds represented as `[[minX, minY], [maxX, maxY]]` for loaders.gl compatibility. */
+    boundingBox;
+    _abortController;
+    _loader;
+    _loaderId;
+    _isLoaded;
+    _isCancelled;
+    _needsReload;
+    _bbox;
+    /** Creates a tile header for a specific tile index. */
+    constructor(index) {
+        this.index = index;
+        this.parent = null;
+        this.children = [];
+        this.content = null;
+        this.error = null;
+        this._loader = undefined;
+        this._abortController = null;
+        this._loaderId = 0;
+        this._isLoaded = false;
+        this._isCancelled = false;
+        this._needsReload = false;
+    }
+    /** Structured bounds for the tile in the active coordinate system. */
+    get bbox() {
+        return this._bbox;
+    }
+    /** Initializes the tile bounds once during tile creation. */
+    set bbox(value) {
+        if (this._bbox) {
+            return;
+        }
+        this._bbox = value;
+        if ('west' in value) {
+            this.boundingBox = [
+                [value.west, value.south],
+                [value.east, value.north]
+            ];
+        }
+        else {
+            this.boundingBox = [
+                [value.left, value.top],
+                [value.right, value.bottom]
+            ];
+        }
+    }
+    /** Resolves to loaded content while a request is in flight, otherwise returns cached content. */
+    get data() {
+        const loader = this._loader;
+        if (!this._isCancelled && loader !== undefined) {
+            return loader.then(() => this.data);
+        }
+        return this.content;
+    }
+    /** Indicates whether tile content is available and up to date. */
+    get isLoaded() {
+        return this._isLoaded && !this._needsReload;
+    }
+    /** Indicates whether a tile request is currently in flight. */
+    get isLoading() {
+        return Boolean(this._loader) && !this._isCancelled;
+    }
+    /** Indicates whether the tile is cached in a failed state. */
+    get hasError() {
+        return Boolean(this.error);
+    }
+    /** Indicates whether the tile should be requested again. */
+    get needsReload() {
+        return this._needsReload || this._isCancelled;
+    }
+    /** Estimated byte size of the cached payload. */
+    get byteLength() {
+        const result = this.content ? this.content.byteLength : 0;
+        return Number.isFinite(result) ? result : 0;
+    }
+    /** Internal request pipeline used by {@link loadData}. */
+    async _loadData({ getData, requestScheduler, onLoad, onError }) {
+        const completeLoad = (tileData, error, loaderId) => {
+            if (loaderId !== this._loaderId) {
+                return;
+            }
+            this._loader = undefined;
+            this.content = tileData;
+            this.error = error ? normalizeTileError(error) : null;
+            if (this._isCancelled && !tileData) {
+                this._isLoaded = false;
+                return;
+            }
+            this._isLoaded = true;
+            this._isCancelled = false;
+            if (error) {
+                onError(error, this);
+                return;
+            }
+            onLoad(this);
+        };
+        const { index, id, bbox, userData, zoom } = this;
+        const loaderId = this._loaderId;
+        this._abortController = new AbortController();
+        const { signal } = this._abortController;
+        const requestToken = await requestScheduler.scheduleRequest(this, () => 1);
+        if (!requestToken) {
+            this._isCancelled = true;
+            return;
+        }
+        if (this._isCancelled) {
+            requestToken.done();
+            return;
+        }
+        let tileData = null;
+        let error;
+        try {
+            tileData = await getData({ index, id, bbox, userData, zoom, signal });
+        }
+        catch (err) {
+            error = err || true;
+        }
+        finally {
+            requestToken.done();
+        }
+        completeLoad(tileData, error, loaderId);
+    }
+    /** Loads tile data through the shared scheduler. */
+    loadData(opts) {
+        this._isLoaded = false;
+        this._isCancelled = false;
+        this._needsReload = false;
+        this.error = null;
+        this._loaderId++;
+        this._loader = this._loadData(opts);
+        return this._loader;
+    }
+    /** Marks the tile stale so it is refreshed on the next traversal. */
+    setNeedsReload() {
+        if (this.isLoading) {
+            this.abort();
+            this._loader = undefined;
+        }
+        this._needsReload = true;
+    }
+    /** Cancels an in-flight tile request. */
+    abort() {
+        if (this.isLoaded) {
+            return;
+        }
+        this._isCancelled = true;
+        this._abortController?.abort();
+    }
+}
+/** Normalizes arbitrary thrown values to `Error` instances for tile cache bookkeeping. */
+function normalizeTileError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (typeof error === 'string') {
+        return new Error(error);
+    }
+    return new Error('Tile request failed');
+}
+//# sourceMappingURL=tile-2d-header.js.map

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

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

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

@@ -0,0 +1,201 @@
+import { type TileSource, type TileSourceMetadata } from '@loaders.gl/loader-utils';
+import type { Matrix4 } from '@math.gl/core';
+import { Stats } from '@probe.gl/stats';
+import { SharedTile2DHeader } from "./tile-2d-header.js";
+import type { Tileset2DAdapter } from "./adapter.js";
+import type { TileIndex, TileLoadProps, ZRange } from "./types.js";
+/** Never show ancestor or descendant placeholder tiles. */
+export declare const STRATEGY_NEVER = "never";
+/** Prefer non-overlapping loaded tiles while replacements stream in. */
+export declare const STRATEGY_REPLACE = "no-overlap";
+/** Prefer the best currently available loaded ancestor or descendant tiles. */
+export declare const STRATEGY_DEFAULT = "best-available";
+/**
+ * Function form of a refinement strategy.
+ *
+ * The callback receives the current cached tiles and a visibility setter that can be used
+ * to control placeholder visibility for individual tiles.
+ */
+export type RefinementStrategyFunction = (tiles: SharedTile2DHeader[], setVisible: (tile: SharedTile2DHeader, isVisible: boolean) => void) => void;
+/** Strategy controlling how parent and child placeholder tiles are displayed while content loads. */
+export type RefinementStrategy = typeof STRATEGY_NEVER | typeof STRATEGY_REPLACE | typeof STRATEGY_DEFAULT | RefinementStrategyFunction;
+/** Core configuration shared by all {@link Tileset2D} instances. */
+export type Tileset2DBaseProps<DataT = any, ViewStateT = unknown> = {
+    /** Callback used to load tile payloads. */
+    getTileData: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;
+    /** Adapter used to compute tile traversal and tile metadata. */
+    adapter?: Tileset2DAdapter<ViewStateT> | null;
+    /** Bounding box limiting tile generation. */
+    extent?: number[] | null;
+    /** Tile size in pixels. */
+    tileSize?: number;
+    /** Maximum zoom level to request. */
+    maxZoom?: number | null;
+    /** Minimum zoom level to request. */
+    minZoom?: number | null;
+    /** Maximum number of tiles kept in cache. */
+    maxCacheSize?: number | null;
+    /** Maximum bytes kept in cache. */
+    maxCacheByteSize?: number | null;
+    /** Placeholder refinement strategy. */
+    refinementStrategy?: RefinementStrategy;
+    /** Elevation range used by geospatial tile selection. */
+    zRange?: ZRange | null;
+    /** Maximum concurrent tile requests. */
+    maxRequests?: number;
+    /** Debounce interval applied before issuing queued requests. */
+    debounceTime?: number;
+    /** Integer zoom offset applied when choosing tile levels. */
+    zoomOffset?: number;
+    /** Callback fired when a tile loads successfully. */
+    onTileLoad?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Callback fired when a tile is evicted from cache. */
+    onTileUnload?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Callback fired when a tile request fails. */
+    onTileError?: (err: any, tile: SharedTile2DHeader<DataT>) => void;
+};
+/** Options for creating a shared tile cache that can be reused by multiple layers and views. */
+export type Tileset2DProps<DataT = any, ViewStateT = unknown> = Omit<Tileset2DBaseProps<DataT, ViewStateT>, 'getTileData'> & {
+    /** Optional tile loader used when not sourcing data from a loaders.gl TileSource. */
+    getTileData?: (props: TileLoadProps) => Promise<DataT | null> | DataT | null;
+    /** Optional loaders.gl TileSource backing this shared tileset. */
+    tileSource?: TileSource | null;
+};
+/** Subscription callbacks emitted by {@link Tileset2D}. */
+export type Tile2DListener<DataT = any> = {
+    /** Fired after a tile loads successfully. */
+    onTileLoad?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Fired after a tile request fails. */
+    onTileError?: (error: any, tile: SharedTile2DHeader<DataT>) => void;
+    /** Fired after a tile is evicted from cache. */
+    onTileUnload?: (tile: SharedTile2DHeader<DataT>) => void;
+    /** Fired when metadata or effective configuration changes. */
+    onUpdate?: () => void;
+    /** Fired when asynchronous metadata initialization fails. */
+    onError?: (error: Error) => void;
+    /** Fired after live tileset counters are recomputed. */
+    onStatsChange?: (stats: Stats) => void;
+};
+/** Shared tile cache and loading engine for one or more consumers. */
+export declare class Tileset2D<DataT = any, ViewStateT = unknown> {
+    /** Live counters describing shared tileset state. */
+    readonly stats: Stats;
+    /** Cached metadata returned by the backing TileSource, if any. */
+    sourceMetadata: TileSourceMetadata | null;
+    protected opts: Required<Tileset2DProps<DataT, ViewStateT>>;
+    private _requestScheduler;
+    private _cache;
+    private _dirty;
+    private _tiles;
+    private _cacheByteSize;
+    private _unloadedTileCount;
+    private _listeners;
+    private _consumers;
+    private _explicitOptionKeys;
+    private _baseOpts;
+    private _sourceMetadataOverrides;
+    private _maxZoom?;
+    private _minZoom?;
+    private _lastTileContext;
+    /** Creates a tileset from either `getTileData` or a loaders.gl `TileSource`. */
+    constructor(opts: Tileset2DProps<DataT, ViewStateT>);
+    /** Convenience factory for wrapping a loaders.gl `TileSource`. */
+    static fromTileSource<DataT = any>(tileSource: TileSource, opts?: Omit<Tileset2DProps<DataT>, 'tileSource' | 'getTileData'>): Tileset2D<DataT>;
+    /** All tiles currently present in the shared cache. */
+    get tiles(): SharedTile2DHeader<DataT>[];
+    /** Estimated byte size of all tile content currently retained in cache. */
+    get cacheByteSize(): number;
+    /** Union of tiles selected by all attached consumers. */
+    get selectedTiles(): SharedTile2DHeader<DataT>[];
+    /** Union of tiles contributing to the visible result across all consumers and views. */
+    get visibleTiles(): SharedTile2DHeader<DataT>[];
+    /** Tiles currently loading anywhere in the shared cache. */
+    get loadingTiles(): SharedTile2DHeader<DataT>[];
+    /** Tiles retained in cache that do not currently have loaded content. */
+    get unloadedTiles(): SharedTile2DHeader<DataT>[];
+    /** Maximum resolved zoom level after applying metadata and explicit options. */
+    get maxZoom(): number | undefined;
+    /** Minimum resolved zoom level after applying metadata and explicit options. */
+    get minZoom(): number | undefined;
+    /** Active refinement strategy for placeholder handling. */
+    get refinementStrategy(): RefinementStrategy;
+    /** Adapter currently used for traversal and tile metadata. */
+    get adapter(): Tileset2DAdapter<ViewStateT> | null;
+    /** Subscribes to tileset lifecycle events. */
+    subscribe(listener: Tile2DListener<DataT>): () => void;
+    /** Registers a consumer so cache pruning can account for its selected tiles. */
+    attachConsumer(id: symbol): void;
+    /** Unregisters a consumer and prunes unused requests and tiles. */
+    detachConsumer(id: symbol): void;
+    /** Updates tileset options and reapplies TileSource metadata overrides. */
+    setOptions(opts: Partial<Tileset2DProps<DataT, ViewStateT>>): void;
+    /** Aborts in-flight requests and clears the shared cache. */
+    finalize(): void;
+    /** Marks all retained tiles stale and drops unused cached tiles. */
+    reloadAll(): void;
+    /** Updates the selected and visible tile sets for one consumer. */
+    updateConsumer(id: symbol, selectedTiles: SharedTile2DHeader<DataT>[], visibleTiles: SharedTile2DHeader<DataT>[]): void;
+    /** Rebuilds parent/child links if the cache changed since the last traversal. */
+    prepareTiles(): void;
+    /** Returns tile indices needed to cover a viewport. */
+    getTileIndices({ viewState, maxZoom, minZoom, zRange, modelMatrix, modelMatrixInverse }: {
+        viewState: ViewStateT;
+        maxZoom?: number;
+        minZoom?: number;
+        zRange: ZRange | null;
+        modelMatrix?: Matrix4 | null;
+        modelMatrixInverse?: Matrix4 | null;
+    }): TileIndex[];
+    /** Returns the stable cache id for a tile index. */
+    getTileId(index: TileIndex): string;
+    /** Returns the zoom level represented by a tile index. */
+    getTileZoom(index: TileIndex): number;
+    /** Returns derived metadata used to initialize a tile header. */
+    getTileMetadata(index: TileIndex): Record<string, any>;
+    /** Returns the parent tile index in the quadtree. */
+    getParentIndex(index: TileIndex): TileIndex;
+    /** Returns a cached tile and optionally creates and loads it on demand. */
+    getTile(index: TileIndex, create: true): SharedTile2DHeader<DataT>;
+    getTile(index: TileIndex, create?: false): SharedTile2DHeader<DataT> | undefined;
+    /** Loads metadata from a TileSource and reapplies derived option overrides. */
+    private _initializeTileSource;
+    /** Tracks which options were explicitly set by the caller. */
+    private _rememberExplicitOptions;
+    /** Resolves defaults, metadata overrides, and caller options into runtime settings. */
+    private _applyResolvedOptions;
+    /** Maps TileSource metadata into supported tileset options. */
+    private _getMetadataOverrides;
+    /** Handles successful tile loads. */
+    private _handleTileLoad;
+    /** Handles tile load failures. */
+    private _handleTileError;
+    /** Handles tile eviction from cache. */
+    private _handleTileUnload;
+    /** Notifies listeners that metadata or effective options changed. */
+    private _notifyUpdate;
+    /** Notifies listeners about asynchronous metadata errors. */
+    private _notifyError;
+    /** Recomputes absolute counter stats and notifies listeners. */
+    private _updateStats;
+    /** Writes an absolute count into a probe.gl stat. */
+    private _setStatCount;
+    /** Returns the union of selected tiles across all consumers. */
+    private _getSelectedTilesUnion;
+    /** Returns the union of visible tiles across all consumers. */
+    private _getVisibleTilesUnion;
+    /** Moves a touched tile to the back of the cache map for LRU eviction ordering. */
+    private _touchTile;
+    /** Computes the total byte size of all cached tile content. */
+    private _getCacheByteSize;
+    /** Cancels low-priority requests when consumers no longer need them. */
+    private _pruneRequests;
+    /** Rebuilds parent and child links for all cached tiles. */
+    private _rebuildTree;
+    /** Updates the sorted tile list used by traversal and rendering. */
+    private _syncTiles;
+    /** Evicts unused cached tiles when configured cache limits are exceeded. */
+    private _resizeCache;
+    /** Finds the nearest cached ancestor tile for placeholder rendering. */
+    private _getNearestAncestor;
+}
+//# sourceMappingURL=tileset-2d.d.ts.map

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

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