@deck.gl-community/geo-layers 9.2.8 → 9.3.0-beta.2

package/dist/shared-tile-2d-layer/shared-tile-2d-view.js

@@ -0,0 +1,253 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { Matrix4, equals } from '@math.gl/core';
+import { memoize } from "../utils/memoize.js";
+import { STRATEGY_DEFAULT, STRATEGY_NEVER, STRATEGY_REPLACE } from "../tileset/index.js";
+import { getCullBounds, sharedTile2DDeckAdapter, transformBox } from "./deck-tileset-adapter.js";
+/** Bit flag marking a tile as visited during refinement traversal. */
+const TILE_STATE_VISITED = 1;
+/** Bit flag marking a tile as visible during refinement traversal. */
+const TILE_STATE_VISIBLE = 2;
+/** Built-in placeholder refinement handlers keyed by strategy name. */
+const STRATEGIES = {
+    [STRATEGY_DEFAULT]: updateTileStateDefault,
+    [STRATEGY_REPLACE]: updateTileStateReplace,
+    [STRATEGY_NEVER]: () => { }
+};
+/** Per-viewport traversal state for the deck-facing shared tile layer. */
+export class SharedTile2DView {
+    /** Unique consumer identifier used by the shared tileset cache. */
+    id = Symbol('tile-2d-view');
+    /** Shared tileset queried by this view. */
+    _tileset;
+    /** Tiles selected during the latest traversal. */
+    _selectedTiles = null;
+    /** Incremented whenever this view's visible tile set changes. */
+    _frameNumber = 0;
+    /** Last viewport used to compute tile selection. */
+    _viewport = null;
+    /** Last z-range used during tile selection. */
+    _zRange = null;
+    /** Last model matrix applied to tile selection. */
+    _modelMatrix = new Matrix4();
+    /** Inverse of the current model matrix. */
+    _modelMatrixInverse = new Matrix4();
+    /** Per-tile visibility and selection flags for this view. */
+    _state = new Map();
+    /** Creates a viewport-specific view of a shared tileset. */
+    constructor(tileset) {
+        this._tileset = tileset;
+        if (!this._tileset.adapter) {
+            this._tileset.setOptions({ adapter: sharedTile2DDeckAdapter });
+        }
+        this._tileset.attachConsumer(this.id);
+    }
+    /** Releases this view and detaches it from the shared tileset. */
+    finalize() {
+        this._tileset.detachConsumer(this.id);
+        this._selectedTiles = null;
+        this._state.clear();
+    }
+    /** Tiles selected for the last viewport update. */
+    get selectedTiles() {
+        return this._selectedTiles;
+    }
+    /** Indicates whether all selected tiles are fully loaded for this view. */
+    get isLoaded() {
+        return this._selectedTiles !== null && this._selectedTiles.every((tile) => tile.isLoaded);
+    }
+    /** Indicates whether any selected tile needs to be re-requested. */
+    get needsReload() {
+        return this._selectedTiles !== null && this._selectedTiles.some((tile) => tile.needsReload);
+    }
+    /** Updates tile selection and visibility for a viewport and returns the current frame number. */
+    update(viewport, { zRange, modelMatrix } = { zRange: null, modelMatrix: null }) {
+        const modelMatrixAsMatrix4 = modelMatrix ? new Matrix4(modelMatrix) : new Matrix4();
+        const isModelMatrixNew = !modelMatrixAsMatrix4.equals(this._modelMatrix);
+        if (!this._viewport ||
+            !viewport.equals(this._viewport) ||
+            !equals(this._zRange, zRange) ||
+            isModelMatrixNew) {
+            if (isModelMatrixNew) {
+                this._modelMatrixInverse = modelMatrixAsMatrix4.clone().invert();
+                this._modelMatrix = modelMatrixAsMatrix4;
+            }
+            this._viewport = viewport;
+            this._zRange = zRange;
+            const tileIndices = this._tileset.getTileIndices({
+                viewState: viewport,
+                maxZoom: this._tileset.maxZoom,
+                minZoom: this._tileset.minZoom,
+                zRange,
+                modelMatrix: this._modelMatrix,
+                modelMatrixInverse: this._modelMatrixInverse
+            });
+            this._selectedTiles = tileIndices.map((index) => this._tileset.getTile(index, true));
+            this._tileset.prepareTiles();
+        }
+        else if (this.needsReload) {
+            this._selectedTiles = (this._selectedTiles || []).map((tile) => this._tileset.getTile(tile.index, true));
+            this._tileset.prepareTiles();
+        }
+        const changed = this._updateTileStates();
+        this._tileset.updateConsumer(this.id, this._selectedTiles || [], this._getVisibleTiles());
+        if (changed) {
+            this._frameNumber++;
+        }
+        return this._frameNumber;
+    }
+    /** Tests whether a tile should render in the current viewport and culling rectangle. */
+    isTileVisible(tile, cullRect, modelMatrix) {
+        const state = this._state.get(tile);
+        if (!state?.isVisible) {
+            return false;
+        }
+        if (!cullRect || !this._viewport) {
+            return true;
+        }
+        const boundsArr = this._getCullBounds({
+            viewport: this._viewport,
+            z: this._zRange,
+            cullRect
+        });
+        return boundsArr.some((bounds) => this._tileOverlapsBounds(tile, bounds, modelMatrix));
+    }
+    /** Collects tiles currently marked visible for this view. */
+    _getVisibleTiles() {
+        const result = [];
+        for (const tile of this._tileset.tiles) {
+            if (this._state.get(tile)?.isVisible) {
+                result.push(tile);
+            }
+        }
+        return result;
+    }
+    /** Memoized screen-space culling bounds helper. */
+    _getCullBounds = memoize(getCullBounds);
+    /** Recomputes selected and placeholder-visible tiles for the current view. */
+    _updateTileStates() {
+        const refinementStrategy = this._tileset.refinementStrategy || STRATEGY_DEFAULT;
+        const allTiles = this._tileset.tiles;
+        const previousVisibility = new Map();
+        for (const tile of allTiles) {
+            const existing = this._state.get(tile);
+            previousVisibility.set(tile, existing?.isVisible || false);
+            this._state.set(tile, { isSelected: false, isVisible: false, state: 0 });
+        }
+        for (const tile of this._selectedTiles || []) {
+            const state = this._state.get(tile) || { isSelected: false, isVisible: false, state: 0 };
+            state.isSelected = true;
+            state.isVisible = true;
+            this._state.set(tile, state);
+        }
+        if (typeof refinementStrategy === 'function') {
+            refinementStrategy(allTiles);
+        }
+        else {
+            STRATEGIES[refinementStrategy](allTiles, this._state);
+        }
+        let changed = false;
+        for (const tile of allTiles) {
+            const state = this._state.get(tile);
+            if (state && state.isVisible !== previousVisibility.get(tile)) {
+                changed = true;
+            }
+        }
+        return changed;
+    }
+    /** Tests one tile against one culling bounds rectangle. */
+    _tileOverlapsBounds(tile, [minX, minY, maxX, maxY], modelMatrix) {
+        const bbox = this._getTileBoundingBox(tile, modelMatrix);
+        if ('west' in bbox) {
+            return bbox.west < maxX && bbox.east > minX && bbox.south < maxY && bbox.north > minY;
+        }
+        const y0 = Math.min(bbox.top, bbox.bottom);
+        const y1 = Math.max(bbox.top, bbox.bottom);
+        return bbox.left < maxX && bbox.right > minX && y0 < maxY && y1 > minY;
+    }
+    /** Applies model-matrix transforms to non-geospatial tile bounds when needed. */
+    _getTileBoundingBox(tile, modelMatrix) {
+        const { bbox } = tile;
+        if ('west' in bbox || !modelMatrix || Matrix4.IDENTITY.equals(modelMatrix)) {
+            return bbox;
+        }
+        const [left, top, right, bottom] = transformBox([bbox.left, bbox.top, bbox.right, bbox.bottom], modelMatrix);
+        return { left, top, right, bottom };
+    }
+}
+/** Default refinement strategy that prefers best available loaded descendants. */
+function updateTileStateDefault(allTiles, stateMap) {
+    for (const tile of allTiles) {
+        getTileState(stateMap, tile).state = 0;
+    }
+    for (const tile of allTiles) {
+        if (getTileState(stateMap, tile).isSelected && !getPlaceholderInAncestors(tile, stateMap)) {
+            getPlaceholderInChildren(tile, stateMap);
+        }
+    }
+    for (const tile of allTiles) {
+        const state = getTileState(stateMap, tile);
+        state.isVisible = Boolean(state.state & TILE_STATE_VISIBLE);
+    }
+}
+/** Replacement refinement strategy that avoids visible overlap between ancestors and descendants. */
+function updateTileStateReplace(allTiles, stateMap) {
+    for (const tile of allTiles) {
+        getTileState(stateMap, tile).state = 0;
+    }
+    for (const tile of allTiles) {
+        if (getTileState(stateMap, tile).isSelected) {
+            getPlaceholderInAncestors(tile, stateMap);
+        }
+    }
+    const sortedTiles = Array.from(allTiles).sort((t1, t2) => t1.zoom - t2.zoom);
+    for (const tile of sortedTiles) {
+        const tileState = getTileState(stateMap, tile);
+        tileState.isVisible = Boolean(tileState.state & TILE_STATE_VISIBLE);
+        if (tile.children && (tileState.isVisible || tileState.state & TILE_STATE_VISITED)) {
+            for (const child of tile.children) {
+                getTileState(stateMap, child).state = TILE_STATE_VISITED;
+            }
+        }
+        else if (tileState.isSelected) {
+            getPlaceholderInChildren(tile, stateMap);
+        }
+    }
+}
+/** Searches upward for a loaded ancestor that can stand in for an unavailable selected tile. */
+function getPlaceholderInAncestors(startTile, stateMap) {
+    let tile = startTile;
+    while ((tile = tile.parent)) {
+        const state = getTileState(stateMap, tile);
+        state.state |= TILE_STATE_VISIBLE | TILE_STATE_VISITED;
+        if (tile.isLoaded || tile.content) {
+            return true;
+        }
+    }
+    return false;
+}
+/** Searches downward for loaded descendants that can stand in for an unavailable selected tile. */
+function getPlaceholderInChildren(tile, stateMap) {
+    const state = getTileState(stateMap, tile);
+    state.state |= TILE_STATE_VISIBLE | TILE_STATE_VISITED;
+    if (!tile.children || !tile.children.length || tile.isLoaded || tile.content) {
+        return;
+    }
+    for (const child of tile.children) {
+        const childState = getTileState(stateMap, child);
+        if (!(childState.state & TILE_STATE_VISITED)) {
+            getPlaceholderInChildren(child, stateMap);
+        }
+    }
+}
+/** Returns view state for a tile, creating a default record when needed. */
+function getTileState(stateMap, tile) {
+    let tileState = stateMap.get(tile);
+    if (!tileState) {
+        tileState = { isSelected: false, isVisible: false, state: 0 };
+        stateMap.set(tile, tileState);
+    }
+    return tileState;
+}
+//# sourceMappingURL=shared-tile-2d-view.js.map

package/dist/shared-tile-2d-layer/shared-tile-2d-view.js.map

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

package/dist/shared-tile-2d-layer/url-template.d.ts

@@ -0,0 +1,9 @@
+import type { TileIndex } from "../tileset/types.js";
+/** URL template accepted by {@link SharedTile2DLayer} when loading tiles directly by URL. */
+export type URLTemplate = string | string[] | null;
+/** Expands one tile URL template for a given tile index. */
+export declare function getURLFromTemplate(template: URLTemplate, tile: {
+    index: TileIndex;
+    id: string;
+}): string | null;
+//# sourceMappingURL=url-template.d.ts.map

package/dist/shared-tile-2d-layer/url-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-template.d.ts","sourceRoot":"","sources":["../../src/shared-tile-2d-layer/url-template.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,SAAS,EAAC,4BAAyB;AAEhD,6FAA6F;AAC7F,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;AAMnD,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE;IACJ,KAAK,EAAE,SAAS,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;CACZ,GACA,MAAM,GAAG,IAAI,CAmBf"}

package/dist/shared-tile-2d-layer/url-template.js

@@ -0,0 +1,25 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+function stringHash(s) {
+    return Math.abs(s.split('').reduce((a, b) => ((a << 5) - a + b.charCodeAt(0)) | 0, 0));
+}
+/** Expands one tile URL template for a given tile index. */
+export function getURLFromTemplate(template, tile) {
+    if (!template || !template.length) {
+        return null;
+    }
+    const { index, id } = tile;
+    if (Array.isArray(template)) {
+        template = template[stringHash(id) % template.length];
+    }
+    let url = template;
+    for (const key of Object.keys(index)) {
+        url = url.replace(new RegExp(`{${key}}`, 'g'), String(index[key]));
+    }
+    if (Number.isInteger(index.y) && Number.isInteger(index.z)) {
+        url = url.replace(/\{-y\}/g, String(Math.pow(2, index.z) - index.y - 1));
+    }
+    return url;
+}
+//# sourceMappingURL=url-template.js.map

package/dist/shared-tile-2d-layer/url-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-template.js","sourceRoot":"","sources":["../../src/shared-tile-2d-layer/url-template.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAOpC,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACzF,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,kBAAkB,CAChC,QAAqB,EACrB,IAGC;IAED,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,EAAC,KAAK,EAAE,EAAE,EAAC,GAAG,IAAI,CAAC;IAEzB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACrC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAsB,CAAC,CAAC,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tile-grid-layer/tile-grid-layer.d.ts

@@ -0,0 +1,47 @@
+import { CompositeLayer, type Color, type DefaultProps } from '@deck.gl/core';
+import { PathLayer, TextLayer } from '@deck.gl/layers';
+import type { SharedTile2DHeader } from "../tileset/index.js";
+/** Label content or formatter used by {@link TileGridLayer}. */
+type TileGridLabelAccessor = string | ((tile: SharedTile2DHeader<unknown>) => string);
+/**
+ * Props for {@link TileGridLayer}, a helper overlay for visualizing tile loading
+ * and tile selection in tiled layers.
+ */
+export type TileGridLayerProps = {
+    /** Tile header whose bounds and index should be visualized. */
+    tile: SharedTile2DHeader<unknown>;
+    /** Whether to draw an outline around the tile bounds. Defaults to `true`. */
+    showBorder?: boolean;
+    /** Whether to render a label at the tile center. Defaults to `true`. */
+    showLabel?: boolean;
+    /** Static label text or formatter for per-tile label content. */
+    getLabel?: TileGridLabelAccessor;
+    /** Stroke color used for the tile border. */
+    borderColor?: Color;
+    /** Text color used for the tile label. */
+    labelColor?: Color;
+    /** Background color used behind the tile label text. */
+    labelBackgroundColor?: Color;
+    /** Minimum screen-space width of the tile border in pixels. */
+    borderWidthMinPixels?: number;
+    /** Screen-space font size of the tile label in pixels. */
+    labelSize?: number;
+};
+/** Internal derived geometry used to render one tile grid overlay. */
+type TileGridLayerItem = {
+    path: [number, number][];
+    center: [number, number];
+    label: string;
+};
+/**
+ * Helper layer that renders a tile outline and optional label for visualizing tile
+ * loading, coverage, and traversal.
+ */
+export declare class TileGridLayer extends CompositeLayer<TileGridLayerProps> {
+    static layerName: string;
+    static defaultProps: DefaultProps<TileGridLayerProps>;
+    /** Builds the tile border and label sublayers. */
+    renderLayers(): (PathLayer<TileGridLayerItem, {}> | TextLayer<TileGridLayerItem, {}>)[];
+}
+export {};
+//# sourceMappingURL=tile-grid-layer.d.ts.map

package/dist/tile-grid-layer/tile-grid-layer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-grid-layer.d.ts","sourceRoot":"","sources":["../../src/tile-grid-layer/tile-grid-layer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,cAAc,EAAE,KAAK,KAAK,EAAE,KAAK,YAAY,EAAC,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAC,SAAS,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAC,kBAAkB,EAAC,4BAAyB;AAGzD,gEAAgE;AAChE,KAAK,qBAAqB,GAAG,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,MAAM,CAAC,CAAC;AAEtF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,+DAA+D;IAC/D,IAAI,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAClC,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,KAAK,CAAC;IAC7B,+DAA+D;IAC/D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,sEAAsE;AACtE,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;IACzB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAiDF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IACnE,MAAM,CAAC,SAAS,SAAmB;IACnC,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAAgB;IAErE,kDAAkD;IAClD,YAAY;CAwDb"}

package/dist/tile-grid-layer/tile-grid-layer.js

@@ -0,0 +1,94 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { CompositeLayer } from '@deck.gl/core';
+import { PathLayer, TextLayer } from '@deck.gl/layers';
+/** Default prop values for {@link TileGridLayer}. */
+const defaultProps = {
+    tile: { type: 'object', value: undefined },
+    showBorder: true,
+    showLabel: true,
+    getLabel: {
+        type: 'function',
+        value: (tile) => `z${tile.index.z} x${tile.index.x} y${tile.index.y}`
+    },
+    borderColor: [255, 255, 255, 180],
+    labelColor: [255, 255, 255, 255],
+    labelBackgroundColor: [15, 23, 42, 210],
+    borderWidthMinPixels: 1,
+    labelSize: 12
+};
+/** Converts a tile bounding box into a closed outline path. */
+function getTilePath(bbox) {
+    if ('west' in bbox) {
+        return [
+            [bbox.west, bbox.north],
+            [bbox.west, bbox.south],
+            [bbox.east, bbox.south],
+            [bbox.east, bbox.north],
+            [bbox.west, bbox.north]
+        ];
+    }
+    return [
+        [bbox.left, bbox.top],
+        [bbox.left, bbox.bottom],
+        [bbox.right, bbox.bottom],
+        [bbox.right, bbox.top],
+        [bbox.left, bbox.top]
+    ];
+}
+/** Returns the center point of a tile bounding box. */
+function getTileCenter(bbox) {
+    if ('west' in bbox) {
+        return [(bbox.west + bbox.east) / 2, (bbox.north + bbox.south) / 2];
+    }
+    return [(bbox.left + bbox.right) / 2, (bbox.top + bbox.bottom) / 2];
+}
+/**
+ * Helper layer that renders a tile outline and optional label for visualizing tile
+ * loading, coverage, and traversal.
+ */
+export class TileGridLayer extends CompositeLayer {
+    static layerName = 'TileGridLayer';
+    static defaultProps = defaultProps;
+    /** Builds the tile border and label sublayers. */
+    renderLayers() {
+        const { tile, showBorder, showLabel, getLabel, borderColor, labelColor, labelBackgroundColor, borderWidthMinPixels, labelSize } = this.props;
+        const item = {
+            path: getTilePath(tile.bbox),
+            center: getTileCenter(tile.bbox),
+            label: typeof getLabel === 'function' ? getLabel(tile) : getLabel
+        };
+        return [
+            showBorder
+                ? new PathLayer(this.getSubLayerProps({
+                    id: 'border'
+                }), {
+                    data: [item],
+                    getPath: (d) => d.path,
+                    getColor: borderColor,
+                    widthMinPixels: borderWidthMinPixels,
+                    pickable: false
+                })
+                : null,
+            showLabel
+                ? new TextLayer(this.getSubLayerProps({
+                    id: 'label'
+                }), {
+                    data: [item],
+                    getPosition: (d) => d.center,
+                    getText: (d) => d.label,
+                    getColor: labelColor,
+                    getBackgroundColor: labelBackgroundColor,
+                    getSize: labelSize,
+                    sizeUnits: 'pixels',
+                    background: true,
+                    getTextAnchor: 'middle',
+                    getAlignmentBaseline: 'center',
+                    pickable: false
+                })
+                : null
+        ];
+    }
+}
+//# sourceMappingURL=tile-grid-layer.js.map

package/dist/tile-grid-layer/tile-grid-layer.js.map

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

package/dist/tile-source-layer/tile-source-layer.d.ts

@@ -3,7 +3,7 @@ import type { TileLayerProps } from '@deck.gl/geo-layers';
 import { TileLayer } from '@deck.gl/geo-layers';
 import type { TileSource } from '@loaders.gl/loader-utils';
 export type TileSourceLayerProps = TileLayerProps & {
-    tileSource: TileSource<any>;
+    tileSource: TileSource;
     showTileBorders?: boolean;
 };
 /**
@@ -18,7 +18,7 @@ export declare class TileSourceLayer extends CompositeLayer<TileSourceLayerProps
         showTileBorders: boolean;
     };
     state: {
-        tileSource: TileSource<any> | null;
+        tileSource: TileSource | null;
     };
     initializeState(): void;
     updateState({ props, changeFlags }: {

package/dist/tile-source-layer/tile-source-layer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tile-source-layer.d.ts","sourceRoot":"","sources":["../../src/tile-source-layer/tile-source-layer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,cAAc,EAAQ,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAC,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAE9C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAKzD,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,oBAAoB,CAAC;IACvE,MAAM,CAAC,SAAS,SAAqB;IACrC,MAAM,CAAC,YAAY;;MAGjB;IAEF,KAAK,EAAE;QACL,UAAU,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;KACpC,CAAc;IAEf,eAAe;IAMf,WAAW,CAAC,EAAC,KAAK,EAAE,WAAW,EAAC;;;KAAA;IAMhC,YAAY;;;;;;;;;;;;yBAsB8B,GAAG;;;;CAQ9C"}
+{"version":3,"file":"tile-source-layer.d.ts","sourceRoot":"","sources":["../../src/tile-source-layer/tile-source-layer.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,cAAc,EAAQ,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAC,SAAS,EAAC,MAAM,qBAAqB,CAAC;AAE9C,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,0BAA0B,CAAC;AAKzD,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG;IAClD,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,cAAc,CAAC,oBAAoB,CAAC;IACvE,MAAM,CAAC,SAAS,SAAqB;IACrC,MAAM,CAAC,YAAY;;MAGjB;IAEF,KAAK,EAAE;QACL,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;KAC/B,CAAc;IAEf,eAAe;IAMf,WAAW,CAAC,EAAC,KAAK,EAAE,WAAW,EAAC;;;KAAA;IAMhC,YAAY;;;;;;;;;;;;yBAsB8B,GAAG;;;;CAQ9C"}

package/dist/tileset/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 SharedTileset2DAdapter}. */
+export type SharedTileset2DTraversalContext<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 SharedTileset2DAdapter}. */
+export type SharedTileset2DTileContext<ViewStateT> = {
+    /** Consumer-defined view state used by the adapter. */
+    viewState: ViewStateT;
+    /** Tile size in pixels. */
+    tileSize: number;
+};
+/** Adapter used by {@link SharedTileset2D} to compute traversal and tile bounds without depending on a specific viewport implementation. */
+export type SharedTileset2DAdapter<ViewStateT> = {
+    /** Returns tile indices that should be selected for one traversal context. */
+    getTileIndices: (context: SharedTileset2DTraversalContext<ViewStateT>) => TileIndex[];
+    /** Returns the structured bounding box for one tile index. */
+    getTileBoundingBox: (context: SharedTileset2DTileContext<ViewStateT>, index: TileIndex) => TileBoundingBox;
+};
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/tileset/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,qEAAqE;AACrE,MAAM,MAAM,+BAA+B,CAAC,UAAU,IAAI;IACxD,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,iFAAiF;AACjF,MAAM,MAAM,0BAA0B,CAAC,UAAU,IAAI;IACnD,uDAAuD;IACvD,SAAS,EAAE,UAAU,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,4IAA4I;AAC5I,MAAM,MAAM,sBAAsB,CAAC,UAAU,IAAI;IAC/C,8EAA8E;IAC9E,cAAc,EAAE,CAAC,OAAO,EAAE,+BAA+B,CAAC,UAAU,CAAC,KAAK,SAAS,EAAE,CAAC;IACtF,8DAA8D;IAC9D,kBAAkB,EAAE,CAClB,OAAO,EAAE,0BAA0B,CAAC,UAAU,CAAC,EAC/C,KAAK,EAAE,SAAS,KACb,eAAe,CAAC;CACtB,CAAC"}

package/dist/tileset/adapter.js

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

package/dist/tileset/adapter.js.map

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