@loaders.gl/tiles 5.0.0-alpha.11 → 5.0.0-alpha.13

package/dist/tile-matrix.d.ts

@@ -0,0 +1,52 @@
+import type { TileMatrixBounds, TileMatrixLimits, TileMatrixSet } from '@math.gl/geospatial/tile-matrix';
+import type { NonGeoBoundingBox, TileIndex } from "./tileset-2d/types.js";
+/** Renderer-independent view frame, already expressed in the grid's canonical X/Y coordinates. */
+export type TileMatrixViewFrame = {
+    /** Exact grid CRS identifier; no identifier equivalence or reprojection is inferred. */
+    crs: string;
+    /** Ordered finite [minimumX, minimumY, maximumX, maximumY] extent in grid coordinates. */
+    extent: TileMatrixBounds;
+    /** Positive coordinate units per pixel; both axes must meet this target. */
+    resolution: number;
+};
+/** The geometry and coverage subset of TileGrid needed for selection. */
+export type TileMatrixSelectionGrid = {
+    /** Complete native geometry; absence is rejected rather than inferred from partial fields. */
+    tileMatrixSet?: TileMatrixSet;
+    /** Optional inclusive per-matrix coverage; an empty list means no available tiles. */
+    limits?: readonly (TileMatrixLimits & {
+        /** Native matrix identifier addressed by this coverage rectangle. */
+        tileMatrix: string;
+    })[];
+};
+/** A native tile request; its Cartesian bbox stays in crs, including for geographic grids. */
+export type TileMatrixTile = {
+    /** Native column/row and compatibility z equal to the selected matrix's array position. */
+    index: TileIndex;
+    /** Stable source/grid-scoped identifier, independent of numeric z or matrix ordering. */
+    id: string;
+    /** Required native matrix identifier; numeric index.z is not a substitute. */
+    tileMatrix: string;
+    /** Cartesian native-coordinate bounds, with no automatic geographic reinterpretation. */
+    bbox: NonGeoBoundingBox;
+    /** Native CRS of bbox; this is not necessarily a longitude/latitude bounding box. */
+    crs: string;
+    /** The selected level's logical width and height in pixels. */
+    tileSize: readonly [number, number];
+};
+/** Resource budget for an eager fixed-frame selection. */
+export type TileMatrixSelectionOptions = {
+    /** Maximum tiles returned, default 4096. Oversized selections throw before allocation. */
+    maximumTileCount?: number;
+};
+/**
+ * Selects regular-grid tiles for an explicit native-CRS frame, with source coverage applied.
+ * Uses math.gl's coarsest level meeting the target, or its finest available fallback. z is the
+ * matrix's array index for compatibility; tileMatrix is authoritative. Cache ids encode the CRS,
+ * native matrix id and column/row, and are scoped to this source/grid, not globally unique.
+ * Returns an empty array outside the grid or available coverage. Partial geometry, coalesced
+ * rows, mismatched CRS identifiers and invalid coverage reject rather than approximating XYZ.
+ * This does not infer parents, transform a viewport, reproject content or configure a renderer.
+ */
+export declare function selectTileMatrixTiles(grid: TileMatrixSelectionGrid, frame: TileMatrixViewFrame, options?: TileMatrixSelectionOptions): TileMatrixTile[];
+//# sourceMappingURL=tile-matrix.d.ts.map

package/dist/tile-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-matrix.d.ts","sourceRoot":"","sources":["../src/tile-matrix.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAEV,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAC,iBAAiB,EAAE,SAAS,EAAC,8BAA2B;AAGrE,kGAAkG;AAClG,MAAM,MAAM,mBAAmB,GAAG;IAChC,wFAAwF;IACxF,GAAG,EAAE,MAAM,CAAC;IACZ,0FAA0F;IAC1F,MAAM,EAAE,gBAAgB,CAAC;IACzB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,yEAAyE;AACzE,MAAM,MAAM,uBAAuB,GAAG;IACpC,8FAA8F;IAC9F,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,sFAAsF;IACtF,MAAM,CAAC,EAAE,SAAS,CAAC,gBAAgB,GAAG;QACpC,qEAAqE;QACrE,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC,EAAE,CAAC;CACN,CAAC;AAEF,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GAAG;IAC3B,2FAA2F;IAC3F,KAAK,EAAE,SAAS,CAAC;IACjB,yFAAyF;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAC;IACnB,yFAAyF;IACzF,IAAI,EAAE,iBAAiB,CAAC;IACxB,qFAAqF;IACrF,GAAG,EAAE,MAAM,CAAC;IACZ,+DAA+D;IAC/D,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACrC,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,0BAA0B,GAAG;IACvC,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,uBAAuB,EAC7B,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE,0BAA+B,GACvC,cAAc,EAAE,CA8DlB"}

package/dist/tile-matrix.js

@@ -0,0 +1,75 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { getTileBounds, getTileRange, isTileIndexInRange, selectTileMatrix } from '@math.gl/geospatial/tile-matrix';
+/**
+ * Selects regular-grid tiles for an explicit native-CRS frame, with source coverage applied.
+ * Uses math.gl's coarsest level meeting the target, or its finest available fallback. z is the
+ * matrix's array index for compatibility; tileMatrix is authoritative. Cache ids encode the CRS,
+ * native matrix id and column/row, and are scoped to this source/grid, not globally unique.
+ * Returns an empty array outside the grid or available coverage. Partial geometry, coalesced
+ * rows, mismatched CRS identifiers and invalid coverage reject rather than approximating XYZ.
+ * This does not infer parents, transform a viewport, reproject content or configure a renderer.
+ */
+export function selectTileMatrixTiles(grid, frame, options = {}) {
+    const matrixSet = grid.tileMatrixSet;
+    if (!matrixSet || !matrixSet.crs || frame.crs !== matrixSet.crs) {
+        throw new Error('Tile selection requires complete geometry and a frame in the exact grid CRS.');
+    }
+    if (frame.extent.length !== 4 ||
+        !frame.extent.every(Number.isFinite) ||
+        frame.extent[0] > frame.extent[2] ||
+        frame.extent[1] > frame.extent[3]) {
+        throw new RangeError('Tile frame extent must be finite and ordered.');
+    }
+    const maximumTileCount = options.maximumTileCount ?? 4096;
+    if (!Number.isSafeInteger(maximumTileCount) || maximumTileCount < 0) {
+        throw new RangeError('maximumTileCount must be a nonnegative safe integer.');
+    }
+    for (const matrix of matrixSet.matrices) {
+        // Newer math.gl models can describe coalescence; this selector deliberately accepts regular grids only.
+        const coalescenceBands = matrix
+            .variableMatrixWidths;
+        if (coalescenceBands !== undefined &&
+            (!Array.isArray(coalescenceBands) || coalescenceBands.length > 0)) {
+            throw new Error('Regular-grid selection does not support variable-width rows.');
+        }
+    }
+    const selectedMatrix = selectTileMatrix(matrixSet, frame.resolution);
+    const coverage = new Map();
+    for (const limit of grid.limits ?? []) {
+        const matrix = matrixSet.matrices.find(candidate => candidate.id === limit.tileMatrix);
+        if (!matrix || coverage.has(limit.tileMatrix)) {
+            throw new RangeError('Tile coverage must reference unique, known matrix ids.');
+        }
+        // math.gl validates every endpoint of the inclusive rectangle, not just these two indices.
+        isTileIndexInRange(matrix, limit.minTileColumn, limit.minTileRow, limit);
+        coverage.set(limit.tileMatrix, limit);
+    }
+    if (!selectedMatrix || (grid.limits !== undefined && !coverage.has(selectedMatrix.id)))
+        return [];
+    const range = getTileRange(selectedMatrix, frame.extent, coverage.get(selectedMatrix.id));
+    if (!range)
+        return [];
+    const width = range.maxTileColumn - range.minTileColumn + 1;
+    const height = range.maxTileRow - range.minTileRow + 1;
+    if (width > maximumTileCount / height)
+        throw new RangeError('Tile selection exceeds maximumTileCount.');
+    const matrixIndex = matrixSet.matrices.indexOf(selectedMatrix);
+    const tiles = [];
+    for (let row = range.minTileRow; row <= range.maxTileRow; row++) {
+        for (let column = range.minTileColumn; column <= range.maxTileColumn; column++) {
+            const [left, bottom, right, top] = getTileBounds(selectedMatrix, column, row);
+            tiles.push({
+                index: { x: column, y: row, z: matrixIndex },
+                tileMatrix: selectedMatrix.id,
+                id: JSON.stringify([matrixSet.crs, selectedMatrix.id, column, row]),
+                bbox: { left, bottom, right, top },
+                crs: matrixSet.crs,
+                tileSize: [selectedMatrix.tileSize[0], selectedMatrix.tileSize[1]]
+            });
+        }
+    }
+    return tiles;
+}
+//# sourceMappingURL=tile-matrix.js.map

package/dist/tile-matrix.js.map

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

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

@@ -1,4 +1,4 @@
-import { RequestScheduler } from '@loaders.gl/loader-utils';
+import { RequestScheduler } from '@loaders.gl/core/loader-utils';
 import type { TileBoundingBox, TileIndex, TileLoadProps } from "./types.js";
 /** Parameters used by {@link SharedTile2DHeader.loadData}. */
 export type Tile2DLoadDataProps<DataT = any> = {
@@ -62,7 +62,7 @@ export declare class SharedTile2DHeader<DataT = any> {
     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. */
+    /** Cancels a request and invalidates its result even if the loader ignores the abort signal. */
     abort(): void;
 }
 //# sourceMappingURL=tile-2d-header.d.ts.map

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

@@ -1 +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"}
+{"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,+BAA+B,CAAC;AAC/D,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;IA0DvB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzD,qEAAqE;IACrE,cAAc,IAAI,IAAI;IAQtB,gGAAgG;IAChG,KAAK,IAAI,IAAI;CASd"}

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

@@ -96,17 +96,14 @@ export class SharedTile2DHeader {
     }
     /** Internal request pipeline used by {@link loadData}. */
     async _loadData({ getData, requestScheduler, onLoad, onError }) {
+        /** Publishes only the current, uncanceled request's content or error. */
         const completeLoad = (tileData, error, loaderId) => {
-            if (loaderId !== this._loaderId) {
+            if (loaderId !== this._loaderId || this._isCancelled) {
                 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) {
@@ -119,13 +116,14 @@ export class SharedTile2DHeader {
         const loaderId = this._loaderId;
         this._abortController = new AbortController();
         const { signal } = this._abortController;
-        const requestToken = await requestScheduler.scheduleRequest(this, () => 1);
-        if (!requestToken) {
-            this._isCancelled = true;
+        // Reloads must not reuse the scheduler token of an aborted request for this tile.
+        const requestToken = await requestScheduler.scheduleRequest({ tile: this, loaderId }, () => loaderId === this._loaderId && !this._isCancelled ? 1 : -1);
+        if (this._isCancelled || loaderId !== this._loaderId) {
+            requestToken?.done();
             return;
         }
-        if (this._isCancelled) {
-            requestToken.done();
+        if (!requestToken) {
+            this._isCancelled = true;
             return;
         }
         let tileData = null;
@@ -159,12 +157,14 @@ export class SharedTile2DHeader {
         }
         this._needsReload = true;
     }
-    /** Cancels an in-flight tile request. */
+    /** Cancels a request and invalidates its result even if the loader ignores the abort signal. */
     abort() {
         if (this.isLoaded) {
             return;
         }
         this._isCancelled = true;
+        this._loaderId++;
+        this._loader = undefined;
         this._abortController?.abort();
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"tile-2d-header.js","sourceRoot":"","sources":["../../src/tileset-2d/tile-2d-header.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAkBpC,yDAAyD;AACzD,MAAM,OAAO,kBAAkB;IAC7B,6BAA6B;IAC7B,KAAK,CAAY;IACjB,wDAAwD;IACxD,MAAM,CAA4B;IAClC,4CAA4C;IAC5C,QAAQ,CAA8B;IACtC,2BAA2B;IAC3B,OAAO,CAAe;IACtB,0DAA0D;IAC1D,KAAK,CAAe;IACpB,4BAA4B;IAC5B,EAAE,CAAU;IACZ,wCAAwC;IACxC,IAAI,CAAU;IACd,0DAA0D;IAC1D,QAAQ,CAAuB;IAC/B,yFAAyF;IACzF,WAAW,CAAkC;IAErC,gBAAgB,CAAyB;IACzC,OAAO,CAA4B;IACnC,SAAS,CAAS;IAClB,SAAS,CAAU;IACnB,YAAY,CAAU;IACtB,YAAY,CAAU;IACtB,KAAK,CAAmB;IAEhC,uDAAuD;IACvD,YAAY,KAAgB;QAC1B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;IAC5B,CAAC;IAED,sEAAsE;IACtE,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,6DAA6D;IAC7D,IAAI,IAAI,CAAC,KAAsB;QAC7B,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,MAAM,IAAI,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,GAAG;gBACjB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;gBACzB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC;aAC1B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,GAAG;gBACjB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;gBACvB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC;aAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iGAAiG;IACjG,IAAI,IAAI;QACN,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,kEAAkE;IAClE,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IAC9C,CAAC;IAED,+DAA+D;IAC/D,IAAI,SAAS;QACX,OAAO,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;IACrD,CAAC;IAED,8DAA8D;IAC9D,IAAI,QAAQ;QACV,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,4DAA4D;IAC5D,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC;IAChD,CAAC;IAED,iDAAiD;IACjD,IAAI,UAAU;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAE,IAAI,CAAC,OAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,0DAA0D;IAClD,KAAK,CAAC,SAAS,CAAC,EACtB,OAAO,EACP,gBAAgB,EAChB,MAAM,EACN,OAAO,EACoB;QAC3B,MAAM,YAAY,GAAG,CAAC,QAAsB,EAAE,KAAc,EAAE,QAAgB,EAAQ,EAAE;YACtF,IAAI,QAAQ,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAChC,OAAO;YACT,CAAC;YAED,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;YACxB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAEtD,IAAI,IAAI,CAAC,YAAY,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,OAAO;YACT,CAAC;YAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YACtB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAE1B,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;gBACrB,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,CAAC;QACf,CAAC,CAAC;QAEF,MAAM,EAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAC,GAAG,IAAI,CAAC;QAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAEhC,IAAI,CAAC,gBAAgB,GAAG,IAAI,eAAe,EAAE,CAAC;QAC9C,MAAM,EAAC,MAAM,EAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACvC,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3E,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,YAAY,CAAC,IAAI,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,IAAI,QAAQ,GAAiB,IAAI,CAAC;QAClC,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,OAAO,CAAC,EAAC,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAC,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,KAAK,GAAG,GAAG,IAAI,IAAI,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,IAAI,EAAE,CAAC;QACtB,CAAC;QAED,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,oDAAoD;IACpD,QAAQ,CAAC,IAAgC;QACvC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,qEAAqE;IACrE,cAAc;QACZ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,yCAAyC;IACzC,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC;IACjC,CAAC;CACF;AAED,0FAA0F;AAC1F,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC;AAC1C,CAAC"}
+{"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

@@ -1,5 +1,5 @@
-import { type TileSource, type TileSourceMetadata } from '@loaders.gl/loader-utils';
-import { Stats } from '@probe.gl/stats';
+import { type TileSource, type TileSourceMetadata } from '@loaders.gl/core/loader-utils';
+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";
@@ -32,9 +32,9 @@ export type Tileset2DBaseProps<DataT = any, ViewStateT = unknown> = {
     maxZoom?: number | null;
     /** Minimum zoom level to request. */
     minZoom?: number | null;
-    /** Maximum number of tiles kept in cache. */
+    /** Tile-count high-water mark, default 100; selected and visible tiles remain retained. */
     maxCacheSize?: number | null;
-    /** Maximum bytes kept in cache. */
+    /** Byte high-water mark; selected and visible tiles can exceed this limit. */
     maxCacheByteSize?: number | null;
     /** Placeholder refinement strategy. */
     refinementStrategy?: RefinementStrategy;
@@ -72,7 +72,7 @@ export type Tile2DListener<DataT = any> = {
     onUpdate?: () => void;
     /** Fired when asynchronous metadata initialization fails. */
     onError?: (error: Error) => void;
-    /** Fired after live tileset counters are recomputed. */
+    /** Fired after counters refresh; synchronous tile requests are coalesced into one microtask. */
     onStatsChange?: (stats: Stats) => void;
 };
 /** Shared tile cache and loading engine for one or more consumers. */
@@ -96,6 +96,10 @@ export declare class Tileset2D<DataT = any, ViewStateT = unknown> {
     private _maxZoom?;
     private _minZoom?;
     private _lastTileContext;
+    /** Whether a tile-request statistics notification is pending. */
+    private _statsUpdateScheduled;
+    /** Invalidates pending metadata initialization when the tileset is finalized. */
+    private _lifecycleVersion;
     /** Creates a tileset from either `getTileData` or a loaders.gl `TileSource`. */
     constructor(opts: Tileset2DProps<DataT, ViewStateT>);
     /** Convenience factory for wrapping a loaders.gl `TileSource`. */
@@ -110,7 +114,7 @@ export declare class Tileset2D<DataT = any, ViewStateT = unknown> {
     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. */
+    /** Pending, canceled, or stale cached tiles; settled failures are excluded until reloaded. */
     get unloadedTiles(): SharedTile2DHeader<DataT>[];
     /** Maximum resolved zoom level after applying metadata and explicit options. */
     get maxZoom(): number | undefined;
@@ -128,9 +132,9 @@ export declare class Tileset2D<DataT = any, ViewStateT = unknown> {
     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. */
+    /** Clears consumers and cache, aborting requests and suppressing late tile and metadata results. */
     finalize(): void;
-    /** Marks all retained tiles stale and drops unused cached tiles. */
+    /** Marks selected and visible fallback 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;
@@ -153,7 +157,10 @@ export declare class Tileset2D<DataT = any, ViewStateT = unknown> {
     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. */
+    /**
+     * Returns a cached tile, updating its LRU recency, and optionally creates and loads it.
+     * Cache/loading counters update immediately; request statistics notifications are coalesced.
+     */
     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. */
@@ -174,7 +181,9 @@ export declare class Tileset2D<DataT = any, ViewStateT = unknown> {
     private _notifyUpdate;
     /** Notifies listeners about asynchronous metadata errors. */
     private _notifyError;
-    /** Recomputes absolute counter stats and notifies listeners. */
+    /** Coalesces tile-request notifications without scanning the cache per requested tile. */
+    private _scheduleStatsUpdate;
+    /** Recomputes absolute counters and publishes a consistent batch snapshot. */
     private _updateStats;
     /** Writes an absolute count into a probe.gl stat. */
     private _setStatCount;

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

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

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

@@ -1,8 +1,8 @@
 // loaders.gl
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
-import { RequestScheduler } from '@loaders.gl/loader-utils';
-import { Stats } from '@probe.gl/stats';
+import { RequestScheduler } from '@loaders.gl/core/loader-utils';
+import { Stats } from 'probe.gl/stats';
 import { SharedTile2DHeader } from "./tile-2d-header.js";
 /** Never show ancestor or descendant placeholder tiles. */
 export const STRATEGY_NEVER = 'never';
@@ -49,6 +49,10 @@ export class Tileset2D {
     _maxZoom;
     _minZoom;
     _lastTileContext = null;
+    /** Whether a tile-request statistics notification is pending. */
+    _statsUpdateScheduled = false;
+    /** Invalidates pending metadata initialization when the tileset is finalized. */
+    _lifecycleVersion = 0;
     /** Creates a tileset from either `getTileData` or a loaders.gl `TileSource`. */
     constructor(opts) {
         this.stats = new Stats({
@@ -116,7 +120,7 @@ export class Tileset2D {
     get loadingTiles() {
         return Array.from(this._cache.values()).filter(tile => tile.isLoading);
     }
-    /** Tiles retained in cache that do not currently have loaded content. */
+    /** Pending, canceled, or stale cached tiles; settled failures are excluded until reloaded. */
     get unloadedTiles() {
         return Array.from(this._cache.values()).filter(tile => !tile.isLoaded);
     }
@@ -169,8 +173,9 @@ export class Tileset2D {
             });
         }
     }
-    /** Aborts in-flight requests and clears the shared cache. */
+    /** Clears consumers and cache, aborting requests and suppressing late tile and metadata results. */
     finalize() {
+        this._lifecycleVersion++;
         for (const tile of this._cache.values()) {
             if (tile.isLoading) {
                 tile.abort();
@@ -183,12 +188,13 @@ export class Tileset2D {
         this._unloadedTileCount = 0;
         this._updateStats();
     }
-    /** Marks all retained tiles stale and drops unused cached tiles. */
+    /** Marks selected and visible fallback tiles stale and drops unused cached tiles. */
     reloadAll() {
         const selectedTiles = this._getSelectedTilesUnion();
+        const visibleTiles = this._getVisibleTilesUnion();
         for (const id of this._cache.keys()) {
             const tile = this._cache.get(id);
-            if (tile && !selectedTiles.has(tile)) {
+            if (tile && !selectedTiles.has(tile) && !visibleTiles.has(tile)) {
                 this._cache.delete(id);
                 this._handleTileUnload(tile);
                 this._dirty = true;
@@ -271,7 +277,8 @@ export class Tileset2D {
             needsReload = true;
             this._cache.set(id, tile);
             this._dirty = true;
-            this._updateStats();
+            this._setStatCount('Tiles In Cache', this._cache.size);
+            this._scheduleStatsUpdate();
         }
         else if (tile && tile.needsReload) {
             needsReload = true;
@@ -280,6 +287,7 @@ export class Tileset2D {
             this._touchTile(id, tile);
         }
         if (tile && needsReload && create) {
+            const wasLoading = tile.isLoading;
             tile
                 .loadData({
                 getData: this.opts.getTileData,
@@ -288,19 +296,30 @@ export class Tileset2D {
                 onError: this._handleTileError.bind(this)
             })
                 .catch(() => { });
-            this._updateStats();
+            if (!wasLoading) {
+                this.stats.get('Loading Tiles').incrementCount();
+            }
+            this._scheduleStatsUpdate();
         }
         return tile;
     }
     /** Loads metadata from a TileSource and reapplies derived option overrides. */
     async _initializeTileSource(tileSource) {
+        const lifecycleVersion = this._lifecycleVersion;
         try {
-            this.sourceMetadata = await tileSource.getMetadata();
+            const metadata = await tileSource.getMetadata();
+            if (lifecycleVersion !== this._lifecycleVersion) {
+                return;
+            }
+            this.sourceMetadata = metadata;
             this._sourceMetadataOverrides = this._getMetadataOverrides(this.sourceMetadata);
             this._applyResolvedOptions();
             this._notifyUpdate();
         }
         catch (error) {
+            if (lifecycleVersion !== this._lifecycleVersion) {
+                return;
+            }
             const normalizedError = error instanceof Error ? error : new Error(`TileSource metadata error: ${String(error)}`);
             this._notifyError(normalizedError);
         }
@@ -356,30 +375,52 @@ export class Tileset2D {
     }
     /** Handles successful tile loads. */
     _handleTileLoad(tile) {
+        const lifecycleVersion = this._lifecycleVersion;
+        if (this._cache.get(tile.id) !== tile) {
+            return;
+        }
         this.opts.onTileLoad?.(tile);
+        if (this._cache.get(tile.id) !== tile) {
+            return;
+        }
         this._cacheByteSize = this._getCacheByteSize();
         this._resizeCache();
+        this._updateStats();
         for (const listener of this._listeners) {
+            if (lifecycleVersion !== this._lifecycleVersion) {
+                return;
+            }
             listener.onTileLoad?.(tile);
         }
-        this._updateStats();
     }
     /** Handles tile load failures. */
     _handleTileError(error, tile) {
+        const lifecycleVersion = this._lifecycleVersion;
+        if (this._cache.get(tile.id) !== tile) {
+            return;
+        }
         this.opts.onTileError?.(error, tile);
+        if (this._cache.get(tile.id) !== tile) {
+            return;
+        }
+        this._cacheByteSize = this._getCacheByteSize();
+        this._resizeCache();
+        this._updateStats();
         for (const listener of this._listeners) {
+            if (lifecycleVersion !== this._lifecycleVersion) {
+                return;
+            }
             listener.onTileError?.(error, tile);
         }
-        this._updateStats();
     }
     /** Handles tile eviction from cache. */
     _handleTileUnload(tile) {
+        tile.abort();
         this._unloadedTileCount++;
         this.opts.onTileUnload?.(tile);
         for (const listener of this._listeners) {
             listener.onTileUnload?.(tile);
         }
-        this._updateStats();
     }
     /** Notifies listeners that metadata or effective options changed. */
     _notifyUpdate() {
@@ -393,8 +434,21 @@ export class Tileset2D {
             listener.onError?.(error);
         }
     }
-    /** Recomputes absolute counter stats and notifies listeners. */
+    /** Coalesces tile-request notifications without scanning the cache per requested tile. */
+    _scheduleStatsUpdate() {
+        if (this._statsUpdateScheduled) {
+            return;
+        }
+        this._statsUpdateScheduled = true;
+        queueMicrotask(() => {
+            if (this._statsUpdateScheduled) {
+                this._updateStats();
+            }
+        });
+    }
+    /** Recomputes absolute counters and publishes a consistent batch snapshot. */
     _updateStats() {
+        this._statsUpdateScheduled = false;
         this._setStatCount('Tiles In Cache', this._cache.size);
         this._setStatCount('Cache Size', this.cacheByteSize);
         this._setStatCount('Visible Tiles', this.visibleTiles.length);
@@ -497,7 +551,7 @@ export class Tileset2D {
             for (const [id, tile] of this._cache) {
                 if (!visibleTiles.has(tile) && !selectedTiles.has(tile)) {
                     this._cache.delete(id);
-                    this._cacheByteSize = this._getCacheByteSize();
+                    this._cacheByteSize -= tile.byteLength;
                     this._handleTileUnload(tile);
                 }
                 if (this._cache.size <= maxCacheSize && this._cacheByteSize <= maxCacheByteSize) {
@@ -518,7 +572,7 @@ export class Tileset2D {
         let index = tile.index;
         while (this.getTileZoom(index) > _minZoom) {
             index = this.getParentIndex(index);
-            const parent = this.getTile(index);
+            const parent = this._cache.get(this.getTileId(index));
             if (parent) {
                 return parent;
             }