@deck.gl/geo-layers 9.0.0-beta.1 → 9.0.0-beta.10

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

@@ -0,0 +1,207 @@
+import { CompositeLayer, _flatten as flatten } from '@deck.gl/core';
+import { GeoJsonLayer } from '@deck.gl/layers';
+import { Tileset2D, STRATEGY_DEFAULT } from "../tileset-2d/index.js";
+import { urlType, getURLFromTemplate } from "../tileset-2d/index.js";
+const defaultProps = {
+    TilesetClass: Tileset2D,
+    data: { type: 'data', value: [] },
+    dataComparator: urlType.equal,
+    renderSubLayers: { type: 'function', value: (props) => new GeoJsonLayer(props) },
+    getTileData: { type: 'function', optional: true, value: null },
+    // TODO - change to onViewportLoad to align with Tile3DLayer
+    onViewportLoad: { type: 'function', optional: true, value: null },
+    onTileLoad: { type: 'function', value: tile => { } },
+    onTileUnload: { type: 'function', value: tile => { } },
+    // eslint-disable-next-line
+    onTileError: { type: 'function', value: err => console.error(err) },
+    extent: { type: 'array', optional: true, value: null, compare: true },
+    tileSize: 512,
+    maxZoom: null,
+    minZoom: 0,
+    maxCacheSize: null,
+    maxCacheByteSize: null,
+    refinementStrategy: STRATEGY_DEFAULT,
+    zRange: null,
+    maxRequests: 6,
+    debounceTime: 0,
+    zoomOffset: 0
+};
+/**
+ * The TileLayer is a composite layer that makes it possible to visualize very large datasets.
+ *
+ * Instead of fetching the entire dataset, it only loads and renders what's visible in the current viewport.
+ */
+export default class TileLayer extends CompositeLayer {
+    static { this.defaultProps = defaultProps; }
+    static { this.layerName = 'TileLayer'; }
+    initializeState() {
+        this.state = {
+            tileset: null,
+            isLoaded: false
+        };
+    }
+    finalizeState() {
+        this.state?.tileset?.finalize();
+    }
+    get isLoaded() {
+        return Boolean(this.state?.tileset?.selectedTiles?.every(tile => tile.isLoaded && tile.layers && tile.layers.every(layer => layer.isLoaded)));
+    }
+    shouldUpdateState({ changeFlags }) {
+        return changeFlags.somethingChanged;
+    }
+    updateState({ changeFlags }) {
+        let { tileset } = this.state;
+        const propsChanged = changeFlags.propsOrDataChanged || changeFlags.updateTriggersChanged;
+        const dataChanged = changeFlags.dataChanged ||
+            (changeFlags.updateTriggersChanged &&
+                (changeFlags.updateTriggersChanged.all || changeFlags.updateTriggersChanged.getTileData));
+        if (!tileset) {
+            tileset = new this.props.TilesetClass(this._getTilesetOptions());
+            this.setState({ tileset });
+        }
+        else if (propsChanged) {
+            tileset.setOptions(this._getTilesetOptions());
+            if (dataChanged) {
+                // reload all tiles
+                // use cached layers until new content is loaded
+                tileset.reloadAll();
+            }
+            else {
+                // some render options changed, regenerate sub layers now
+                tileset.tiles.forEach(tile => {
+                    tile.layers = null;
+                });
+            }
+        }
+        this._updateTileset();
+    }
+    _getTilesetOptions() {
+        const { tileSize, maxCacheSize, maxCacheByteSize, refinementStrategy, extent, maxZoom, minZoom, maxRequests, debounceTime, zoomOffset } = this.props;
+        return {
+            maxCacheSize,
+            maxCacheByteSize,
+            maxZoom,
+            minZoom,
+            tileSize,
+            refinementStrategy,
+            extent,
+            maxRequests,
+            debounceTime,
+            zoomOffset,
+            getTileData: this.getTileData.bind(this),
+            onTileLoad: this._onTileLoad.bind(this),
+            onTileError: this._onTileError.bind(this),
+            onTileUnload: this._onTileUnload.bind(this)
+        };
+    }
+    _updateTileset() {
+        const tileset = this.state.tileset;
+        const { zRange, modelMatrix } = this.props;
+        const frameNumber = tileset.update(this.context.viewport, { zRange, modelMatrix });
+        const { isLoaded } = tileset;
+        const loadingStateChanged = this.state.isLoaded !== isLoaded;
+        const tilesetChanged = this.state.frameNumber !== frameNumber;
+        if (isLoaded && (loadingStateChanged || tilesetChanged)) {
+            this._onViewportLoad();
+        }
+        if (tilesetChanged) {
+            // Save the tileset frame number - trigger a rerender
+            this.setState({ frameNumber });
+        }
+        // Save the loaded state - should not trigger a rerender
+        this.state.isLoaded = isLoaded;
+    }
+    _onViewportLoad() {
+        const { tileset } = this.state;
+        const { onViewportLoad } = this.props;
+        if (onViewportLoad) {
+            // This method can only be called when tileset is defined and updated
+            onViewportLoad(tileset.selectedTiles);
+        }
+    }
+    _onTileLoad(tile) {
+        this.props.onTileLoad(tile);
+        tile.layers = null;
+        this.setNeedsUpdate();
+    }
+    _onTileError(error, tile) {
+        this.props.onTileError(error);
+        tile.layers = null;
+        this.setNeedsUpdate();
+    }
+    _onTileUnload(tile) {
+        this.props.onTileUnload(tile);
+    }
+    // Methods for subclass to override
+    getTileData(tile) {
+        const { data, getTileData, fetch } = this.props;
+        const { signal } = tile;
+        tile.url =
+            typeof data === 'string' || Array.isArray(data) ? getURLFromTemplate(data, tile) : null;
+        if (getTileData) {
+            return getTileData(tile);
+        }
+        if (fetch && tile.url) {
+            return fetch(tile.url, { propName: 'data', layer: this, signal });
+        }
+        return null;
+    }
+    renderSubLayers(props) {
+        return this.props.renderSubLayers(props);
+    }
+    getSubLayerPropsByTile(tile) {
+        return null;
+    }
+    getPickingInfo(params) {
+        const sourceTile = params.sourceLayer.props.tile;
+        const info = params.info;
+        if (info.picked) {
+            info.tile = sourceTile;
+        }
+        info.sourceTile = sourceTile;
+        return info;
+    }
+    _updateAutoHighlight(info) {
+        const sourceTile = info.sourceTile;
+        if (sourceTile && sourceTile.layers) {
+            for (const layer of sourceTile.layers) {
+                layer.updateAutoHighlight(info);
+            }
+        }
+    }
+    renderLayers() {
+        return this.state.tileset.tiles.map((tile) => {
+            const subLayerProps = this.getSubLayerPropsByTile(tile);
+            // cache the rendered layer in the tile
+            if (!tile.isLoaded && !tile.content) {
+                // nothing to show
+            }
+            else if (!tile.layers) {
+                const layers = this.renderSubLayers({
+                    ...this.props,
+                    ...this.getSubLayerProps({
+                        id: tile.id,
+                        updateTriggers: this.props.updateTriggers
+                    }),
+                    data: tile.content,
+                    _offset: 0,
+                    tile
+                });
+                tile.layers = flatten(layers, Boolean).map(layer => layer.clone({
+                    tile,
+                    ...subLayerProps
+                }));
+            }
+            else if (subLayerProps &&
+                tile.layers[0] &&
+                Object.keys(subLayerProps).some(propName => tile.layers[0].props[propName] !== subLayerProps[propName])) {
+                tile.layers = tile.layers.map(layer => layer.clone(subLayerProps));
+            }
+            return tile.layers;
+        });
+    }
+    filterSubLayer({ layer, cullRect }) {
+        const { tile } = layer.props;
+        return this.state.tileset.isTileVisible(tile, cullRect);
+    }
+}

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

@@ -0,0 +1,7 @@
+export type { TileLoadProps, Bounds, ZRange, GeoBoundingBox, NonGeoBoundingBox, TileBoundingBox } from "./types.js";
+export type { Tileset2DProps, RefinementStrategy } from "./tileset-2d.js";
+export { Tileset2D, STRATEGY_DEFAULT } from "./tileset-2d.js";
+export { Tile2DHeader } from "./tile-2d-header.js";
+export type { URLTemplate } from "./utils.js";
+export { isGeoBoundingBox, isURLTemplate, urlType, getURLFromTemplate, getTileIndices, tileToBoundingBox } from "./utils.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":"AAEA,YAAY,EACV,aAAa,EACb,MAAM,EACN,MAAM,EACN,cAAc,EACd,iBAAiB,EACjB,eAAe,EAChB,mBAAgB;AAEjB,YAAY,EAAC,cAAc,EAAE,kBAAkB,EAAC,wBAAqB;AACrE,OAAO,EAAC,SAAS,EAAE,gBAAgB,EAAC,wBAAqB;AAEzD,OAAO,EAAC,YAAY,EAAC,4BAAyB;AAE9C,YAAY,EAAC,WAAW,EAAC,mBAAgB;AACzC,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,OAAO,EACP,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EAClB,mBAAgB"}

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

@@ -0,0 +1,4 @@
+// deck.gl, MIT license
+export { Tileset2D, STRATEGY_DEFAULT } from "./tileset-2d.js";
+export { Tile2DHeader } from "./tile-2d-header.js";
+export { isGeoBoundingBox, isURLTemplate, urlType, getURLFromTemplate, getTileIndices, tileToBoundingBox } from "./utils.js";

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

@@ -0,0 +1,41 @@
+// deck.gl, MIT license
+// @note - this is a duplicate of the deck.gl core export (because Tileset2D should be deck.gl independent)
+/**
+ * Speed up consecutive function calls by caching the result of calls with identical input
+ * https://en.wikipedia.org/wiki/Memoization
+ * @param compute - the function to be memoized
+ */
+export function memoize(compute) {
+    let cachedArgs = {};
+    let cachedResult;
+    return (args) => {
+        for (const key in args) {
+            if (!isEqual(args[key], cachedArgs[key])) {
+                cachedResult = compute(args);
+                cachedArgs = args;
+                break;
+            }
+        }
+        return cachedResult;
+    };
+}
+function isEqual(a, b) {
+    if (a === b) {
+        return true;
+    }
+    if (Array.isArray(a)) {
+        // Special treatment for arrays: compare 1-level deep
+        // This is to support equality of matrix/coordinate props
+        const len = a.length;
+        if (!b || b.length !== len) {
+            return false;
+        }
+        for (let i = 0; i < len; i++) {
+            if (a[i] !== b[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    return false;
+}

package/{typed → dist}/tileset-2d/tile-2d-header.d.ts

@@ -1,5 +1,6 @@
 import { RequestScheduler } from '@loaders.gl/loader-utils';
-import { TileBoundingBox, TileIndex, TileLoadProps } from './types';
+import { TileBoundingBox, TileIndex, TileLoadProps } from "./types.js";
+import type { Layer } from '@deck.gl/core';
 export type TileLoadDataProps<DataT = any> = {
     requestScheduler: RequestScheduler;
     getData: (props: TileLoadProps) => Promise<DataT>;
@@ -14,7 +15,7 @@ export declare class Tile2DHeader<DataT = any> {
     children: Tile2DHeader[] | null;
     content: DataT | null;
     state?: number;
-    layers?: any[] | null;
+    layers?: Layer[] | null;
     id: string;
     zoom: number;
     userData?: Record<string, any>;

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":"AACA,OAAO,EAAC,gBAAgB,EAAC,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAC,eAAe,EAAE,SAAS,EAAE,aAAa,EAAC,mBAAgB;AAClE,OAAO,KAAK,EAAC,KAAK,EAAC,MAAM,eAAe,CAAC;AAEzC,MAAM,MAAM,iBAAiB,CAAC,KAAK,GAAG,GAAG,IAAI;IAC3C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,OAAO,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAClD,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;IAC5C,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,qBAAa,YAAY,CAAC,KAAK,GAAG,GAAG;IACnC,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAExB,EAAE,EAAG,MAAM,CAAC;IACZ,IAAI,EAAG,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC/B,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;gBAEpB,KAAK,EAAE,SAAS;IAiB5B,4CAA4C;IAC5C,IAAI,IAAI,IAAI,eAAe,CAE1B;IAGD,IAAI,IAAI,CAAC,KAAK,EAAE,eAAe,EAgB9B;IAED,IAAI,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,IAAI,CAE/C;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,IAAI,UAAU,IAAI,MAAM,CAOvB;YAGa,SAAS;IA8DvB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAShD,cAAc,IAAI,IAAI;IAQtB,KAAK,IAAI,IAAI;CAQd"}

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

@@ -0,0 +1,135 @@
+export class Tile2DHeader {
+    constructor(index) {
+        this.index = index;
+        this.isVisible = false;
+        this.isSelected = false;
+        this.parent = null;
+        this.children = [];
+        this.content = null;
+        this._loader = undefined;
+        this._abortController = null;
+        this._loaderId = 0;
+        this._isLoaded = false;
+        this._isCancelled = false;
+        this._needsReload = false;
+    }
+    /** @deprecated use `boundingBox` instead */
+    get bbox() {
+        return this._bbox;
+    }
+    // TODO - remove in v9
+    set bbox(value) {
+        // Only set once from `Tileset2D.getTileMetadata`
+        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]
+            ];
+        }
+    }
+    get data() {
+        return this.isLoading && this._loader ? this._loader.then(() => this.data) : this.content;
+    }
+    get isLoaded() {
+        return this._isLoaded && !this._needsReload;
+    }
+    get isLoading() {
+        return Boolean(this._loader) && !this._isCancelled;
+    }
+    get needsReload() {
+        return this._needsReload || this._isCancelled;
+    }
+    get byteLength() {
+        const result = this.content ? this.content.byteLength : 0;
+        if (!Number.isFinite(result)) {
+            // eslint-disable-next-line no-console
+            console.error('byteLength not defined in tile data');
+        }
+        return result;
+    }
+    /* eslint-disable max-statements */
+    async _loadData({ getData, requestScheduler, onLoad, onError }) {
+        const { index, id, bbox, userData, zoom } = this;
+        const loaderId = this._loaderId;
+        this._abortController = new AbortController();
+        const { signal } = this._abortController;
+        // @ts-expect-error (2345) Argument of type '(tile: any) => 1 | -1' is not assignable ...
+        const requestToken = await requestScheduler.scheduleRequest(this, tile => {
+            return tile.isSelected ? 1 : -1;
+        });
+        if (!requestToken) {
+            this._isCancelled = true;
+            return;
+        }
+        // A tile can be cancelled while being scheduled
+        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();
+        }
+        // If loadData has been called with a newer version, discard the result from this operation
+        if (loaderId !== this._loaderId) {
+            return;
+        }
+        // Clear the `isLoading` flag
+        this._loader = undefined;
+        // Rewrite tile content with the result of getTileData if successful, or `null` in case of
+        // error or cancellation
+        this.content = tileData;
+        // If cancelled, do not invoke the callbacks
+        // Consider it loaded if we tried to cancel but `getTileData` still returned data
+        if (this._isCancelled && !tileData) {
+            this._isLoaded = false;
+            return;
+        }
+        this._isLoaded = true;
+        this._isCancelled = false;
+        if (error) {
+            onError(error, this);
+        }
+        else {
+            onLoad(this);
+        }
+    }
+    loadData(opts) {
+        this._isLoaded = false;
+        this._isCancelled = false;
+        this._needsReload = false;
+        this._loaderId++;
+        this._loader = this._loadData(opts);
+        return this._loader;
+    }
+    setNeedsReload() {
+        if (this.isLoading) {
+            this.abort();
+            this._loader = undefined;
+        }
+        this._needsReload = true;
+    }
+    abort() {
+        if (this.isLoaded) {
+            return;
+        }
+        this._isCancelled = true;
+        this._abortController?.abort();
+    }
+}

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

@@ -0,0 +1,4 @@
+import { Viewport } from '@deck.gl/core';
+import { Bounds, TileIndex, ZRange } from "./types.js";
+export declare function getOSMTileIndices(viewport: Viewport, maxZ: number, zRange: ZRange | null, bounds?: Bounds): TileIndex[];
+//# sourceMappingURL=tile-2d-traversal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tile-2d-traversal.d.ts","sourceRoot":"","sources":["../../src/tileset-2d/tile-2d-traversal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAsC,MAAM,eAAe,CAAC;AAS5E,OAAO,EAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAC,mBAAgB;AA6KlD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,MAAM,CAAC,EAAE,MAAM,GACd,SAAS,EAAE,CAiEb"}

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

@@ -0,0 +1,182 @@
+import { WebMercatorViewport, _GlobeViewport } from '@deck.gl/core';
+import { CullingVolume, Plane, AxisAlignedBoundingBox, makeOrientedBoundingBoxFromPoints } from '@math.gl/culling';
+import { lngLatToWorld } from '@math.gl/web-mercator';
+import { osmTile2lngLat } from "./utils.js";
+const TILE_SIZE = 512;
+// number of world copies to check
+const MAX_MAPS = 3;
+// for calculating bounding volume of a tile in a non-web-mercator viewport
+const REF_POINTS_5 = [
+    [0.5, 0.5],
+    [0, 0],
+    [0, 1],
+    [1, 0],
+    [1, 1]
+]; // 4 corners and center
+const REF_POINTS_9 = REF_POINTS_5.concat([
+    [0, 0.5],
+    [0.5, 0],
+    [1, 0.5],
+    [0.5, 1]
+]); // 4 corners, center and 4 mid points
+const REF_POINTS_11 = REF_POINTS_9.concat([
+    [0.25, 0.5],
+    [0.75, 0.5]
+]); // 2 additional points on equator for top tile
+class OSMNode {
+    constructor(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    get children() {
+        if (!this._children) {
+            const x = this.x * 2;
+            const y = this.y * 2;
+            const z = this.z + 1;
+            this._children = [
+                new OSMNode(x, y, z),
+                new OSMNode(x, y + 1, z),
+                new OSMNode(x + 1, y, z),
+                new OSMNode(x + 1, y + 1, z)
+            ];
+        }
+        return this._children;
+    }
+    // eslint-disable-next-line complexity
+    update(params) {
+        const { viewport, cullingVolume, elevationBounds, minZ, maxZ, bounds, offset, project } = params;
+        const boundingVolume = this.getBoundingVolume(elevationBounds, offset, project);
+        // First, check if this tile is visible
+        if (bounds && !this.insideBounds(bounds)) {
+            return false;
+        }
+        const isInside = cullingVolume.computeVisibility(boundingVolume);
+        if (isInside < 0) {
+            return false;
+        }
+        // Avoid loading overlapping tiles - if a descendant is requested, do not request the ancester
+        if (!this.childVisible) {
+            let { z } = this;
+            if (z < maxZ && z >= minZ) {
+                // Adjust LOD
+                // If the tile is far enough from the camera, accept a lower zoom level
+                const distance = (boundingVolume.distanceTo(viewport.cameraPosition) * viewport.scale) / viewport.height;
+                z += Math.floor(Math.log2(distance));
+            }
+            if (z >= maxZ) {
+                // LOD is acceptable
+                this.selected = true;
+                return true;
+            }
+        }
+        // LOD is not enough, recursively test child tiles
+        this.selected = false;
+        this.childVisible = true;
+        for (const child of this.children) {
+            child.update(params);
+        }
+        return true;
+    }
+    getSelected(result = []) {
+        if (this.selected) {
+            result.push(this);
+        }
+        if (this._children) {
+            for (const node of this._children) {
+                node.getSelected(result);
+            }
+        }
+        return result;
+    }
+    insideBounds([minX, minY, maxX, maxY]) {
+        const scale = Math.pow(2, this.z);
+        const extent = TILE_SIZE / scale;
+        return (this.x * extent < maxX &&
+            this.y * extent < maxY &&
+            (this.x + 1) * extent > minX &&
+            (this.y + 1) * extent > minY);
+    }
+    getBoundingVolume(zRange, worldOffset, project) {
+        if (project) {
+            // Custom projection
+            // Estimate bounding box from sample points
+            // At low zoom level we need more samples to calculate the bounding volume correctly
+            const refPoints = this.z < 1 ? REF_POINTS_11 : this.z < 2 ? REF_POINTS_9 : REF_POINTS_5;
+            // Convert from tile-relative coordinates to common space
+            const refPointPositions = [];
+            for (const p of refPoints) {
+                const lngLat = osmTile2lngLat(this.x + p[0], this.y + p[1], this.z);
+                lngLat[2] = zRange[0];
+                refPointPositions.push(project(lngLat));
+                if (zRange[0] !== zRange[1]) {
+                    // Account for the elevation volume
+                    lngLat[2] = zRange[1];
+                    refPointPositions.push(project(lngLat));
+                }
+            }
+            return makeOrientedBoundingBoxFromPoints(refPointPositions);
+        }
+        // Use WebMercator projection
+        const scale = Math.pow(2, this.z);
+        const extent = TILE_SIZE / scale;
+        const originX = this.x * extent + worldOffset * TILE_SIZE;
+        // deck's common space is y-flipped
+        const originY = TILE_SIZE - (this.y + 1) * extent;
+        return new AxisAlignedBoundingBox([originX, originY, zRange[0]], [originX + extent, originY + extent, zRange[1]]);
+    }
+}
+// eslint-disable-next-line complexity
+export function getOSMTileIndices(viewport, maxZ, zRange, bounds) {
+    const project = viewport instanceof _GlobeViewport && viewport.resolution
+        ? // eslint-disable-next-line @typescript-eslint/unbound-method
+            viewport.projectPosition
+        : null;
+    // Get the culling volume of the current camera
+    const planes = Object.values(viewport.getFrustumPlanes()).map(({ normal, distance }) => new Plane(normal.clone().negate(), distance));
+    const cullingVolume = new CullingVolume(planes);
+    // Project zRange from meters to common space
+    const unitsPerMeter = viewport.distanceScales.unitsPerMeter[2];
+    const elevationMin = (zRange && zRange[0] * unitsPerMeter) || 0;
+    const elevationMax = (zRange && zRange[1] * unitsPerMeter) || 0;
+    // Always load at the current zoom level if pitch is small
+    const minZ = viewport instanceof WebMercatorViewport && viewport.pitch <= 60 ? maxZ : 0;
+    // Map extent to OSM position
+    if (bounds) {
+        const [minLng, minLat, maxLng, maxLat] = bounds;
+        const topLeft = lngLatToWorld([minLng, maxLat]);
+        const bottomRight = lngLatToWorld([maxLng, minLat]);
+        bounds = [topLeft[0], TILE_SIZE - topLeft[1], bottomRight[0], TILE_SIZE - bottomRight[1]];
+    }
+    const root = new OSMNode(0, 0, 0);
+    const traversalParams = {
+        viewport,
+        project,
+        cullingVolume,
+        elevationBounds: [elevationMin, elevationMax],
+        minZ,
+        maxZ,
+        bounds,
+        // num. of worlds from the center. For repeated maps
+        offset: 0
+    };
+    root.update(traversalParams);
+    if (viewport instanceof WebMercatorViewport &&
+        viewport.subViewports &&
+        viewport.subViewports.length > 1) {
+        // Check worlds in repeated maps
+        traversalParams.offset = -1;
+        while (root.update(traversalParams)) {
+            if (--traversalParams.offset < -MAX_MAPS) {
+                break;
+            }
+        }
+        traversalParams.offset = 1;
+        while (root.update(traversalParams)) {
+            if (++traversalParams.offset > MAX_MAPS) {
+                break;
+            }
+        }
+    }
+    return root.getSelected();
+}

package/{typed → dist}/tileset-2d/tileset-2d.d.ts

@@ -1,8 +1,8 @@
 import { Viewport } from '@deck.gl/core';
 import { Matrix4, NumericArray } from '@math.gl/core';
-import { Tile2DHeader } from './tile-2d-header';
-import { TileIndex, ZRange } from './types';
-import { TileLoadProps } from './types';
+import { Tile2DHeader } from "./tile-2d-header.js";
+import { TileIndex, ZRange } from "./types.js";
+import { TileLoadProps } from "./types.js";
 export declare const STRATEGY_NEVER = "never";
 export declare const STRATEGY_REPLACE = "no-overlap";
 export declare const STRATEGY_DEFAULT = "best-available";
@@ -29,6 +29,8 @@ export type Tileset2DProps<DataT = any> = {
     zRange?: ZRange | null;
     /** The maximum number of concurrent getTileData calls. @default 6 */
     maxRequests?: number;
+    /** Queue tile requests until no new tiles have been requested for at least `debounceTime` milliseconds. @default 0 */
+    debounceTime?: number;
     /** Changes the zoom level at which the tiles are fetched. Needs to be an integer. @default 0 */
     zoomOffset?: number;
     /** Called when a tile successfully loads. */
@@ -51,7 +53,7 @@ export declare class Tileset2D {
     private _tiles;
     private _cacheByteSize;
     private _viewport;
-    private _zRange?;
+    private _zRange;
     private _selectedTiles;
     private _frameNumber;
     private _modelMatrix;
@@ -75,8 +77,8 @@ export declare class Tileset2D {
      * Update the cache with the given viewport and model matrix and triggers callback onUpdate.
      */
     update(viewport: Viewport, { zRange, modelMatrix }?: {
-        zRange?: ZRange | null;
-        modelMatrix?: NumericArray | null;
+        zRange: ZRange | null;
+        modelMatrix: NumericArray | null;
     }): number;
     isTileVisible(tile: Tile2DHeader, cullRect?: {
         x: number;
@@ -89,7 +91,7 @@ export declare class Tileset2D {
         viewport: Viewport;
         maxZoom?: number;
         minZoom?: number;
-        zRange?: ZRange | null;
+        zRange: ZRange | null;
         tileSize?: number;
         modelMatrix?: Matrix4;
         modelMatrixInverse?: Matrix4;

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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"}