@deck.gl-community/infovis-layers 9.3.5 → 9.3.7

package/dist/utils/utf8-string-view.test.js

@@ -0,0 +1,88 @@
+import * as arrow from 'apache-arrow';
+import { describe, expect, it } from 'vitest';
+import { arrowFindUtf8, getArrowUtf8ColumnSource, getArrowUtf8RowView, getUtf8ColumnSourceRowView, makeUtf8StringView } from "./utf8-string-view.js";
+describe('utf8-string-view', () => {
+    it('finds matching Utf8 rows without materializing a lookup map', () => {
+        const column = arrow.vectorFromArray(['alpha', null, '6149800612493239450'], new arrow.Utf8());
+        expect(arrowFindUtf8(column, makeUtf8StringView('alpha'))).toBe(0);
+        expect(arrowFindUtf8(column, makeUtf8StringView('6149800612493239450'))).toBe(2);
+        expect(arrowFindUtf8(column, makeUtf8StringView('alpha'), 1)).toBe(-1);
+        expect(arrowFindUtf8(column, makeUtf8StringView('missing'))).toBe(-1);
+    });
+    it('finds exact UTF-8 strings in Arrow columns', () => {
+        const column = buildArrowUtf8Vector([
+            'span-a',
+            '6149800612493239450',
+            'span-b',
+            '6149800612493239450'
+        ]);
+        const view = makeUtf8StringView('6149800612493239450');
+        expect(arrowFindUtf8(column, view)).toBe(1);
+        expect(arrowFindUtf8(column, view, 2)).toBe(3);
+        expect(arrowFindUtf8(column, view, 4)).toBe(-1);
+    });
+    it('falls back safely for nullable Arrow string columns', () => {
+        const column = arrow.vectorFromArray(['span-a', null, 'span-c'], new arrow.Utf8());
+        expect(arrowFindUtf8(column, makeUtf8StringView('span-c'))).toBe(2);
+        expect(arrowFindUtf8(column, makeUtf8StringView('missing'))).toBe(-1);
+    });
+    it('fills a reusable row view for direct Utf8 values', () => {
+        const column = buildArrowUtf8Vector(['alpha', '', 'gamma']);
+        const out = makeEmptyUtf8View();
+        expect(getArrowUtf8RowView(column, 0, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([97, 108, 112, 104, 97]);
+        expect(getArrowUtf8RowView(column, 1, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([]);
+        expect(getArrowUtf8RowView(column, 3, out)).toBe(false);
+    });
+    it('fills a reusable row view for nullable Utf8 values', () => {
+        const column = arrow.vectorFromArray(['span-a', null, 'span-c'], new arrow.Utf8());
+        const out = makeEmptyUtf8View();
+        expect(getArrowUtf8RowView(column, 1, out)).toBe(false);
+        expect(getArrowUtf8RowView(column, 2, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([115, 112, 97, 110, 45, 99]);
+    });
+    it('fills a reusable row view for sliced Utf8 values', () => {
+        const column = buildArrowUtf8Vector(['skip', 'first', 'second']).slice(1, 3);
+        const out = makeEmptyUtf8View();
+        expect(getArrowUtf8RowView(column, 0, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([102, 105, 114, 115, 116]);
+        expect(getArrowUtf8RowView(column, 1, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([115, 101, 99, 111, 110, 100]);
+        expect(arrowFindUtf8(column, makeUtf8StringView('second'))).toBe(1);
+    });
+    it('fills normalized column source row views for sliced Utf8 values', () => {
+        const column = buildArrowUtf8Vector(['skip', 'first', 'second']).slice(1, 3);
+        const source = getArrowUtf8ColumnSource(column);
+        const out = makeEmptyUtf8View();
+        expect(source).not.toBeNull();
+        expect(getUtf8ColumnSourceRowView(source, 0, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([102, 105, 114, 115, 116]);
+        expect(getUtf8ColumnSourceRowView(source, 1, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([115, 101, 99, 111, 110, 100]);
+    });
+    it('fills a reusable row view for chunked Utf8 values', () => {
+        const leftTable = new arrow.Table({
+            name: arrow.vectorFromArray(['left'], new arrow.Utf8())
+        });
+        const rightTable = new arrow.Table({
+            name: arrow.vectorFromArray(['right', 'last'], new arrow.Utf8())
+        });
+        const column = leftTable.concat(rightTable).getChild('name');
+        const out = makeEmptyUtf8View();
+        expect(getArrowUtf8RowView(column, 0, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([108, 101, 102, 116]);
+        expect(getArrowUtf8RowView(column, 2, out)).toBe(true);
+        expect(readUtf8ViewBytes(out)).toEqual([108, 97, 115, 116]);
+    });
+});
+function makeEmptyUtf8View() {
+    return { data: new Uint8Array(), start: 0, end: 0 };
+}
+function readUtf8ViewBytes(view) {
+    return Array.from(view.data.subarray(view.start, view.end));
+}
+function buildArrowUtf8Vector(values) {
+    return arrow.vectorFromArray(values, new arrow.Utf8());
+}
+//# sourceMappingURL=utf8-string-view.test.js.map

package/dist/utils/utf8-string-view.test.js.map

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

package/dist/views/bounds-utils.d.ts

@@ -0,0 +1,23 @@
+/** Two-dimensional world-space bounds represented by minimum and maximum corners. */
+export type Bounds = [[number, number], [number, number]];
+/** Interleaved X/Y block geometry values accepted by {@link getPaddedBlockBounds}. */
+export type Geometry = ArrayLike<number> | null | undefined;
+/** Padding configuration for {@link getPaddedBlockBounds}. */
+export type PaddedBlockBoundsOptions = {
+    /** Padding added as a fraction of geometry width and height. @defaultValue 0.1 */
+    paddingFraction?: number;
+    /** Minimum world-space padding added on each axis. @defaultValue 1 */
+    minimumPadding?: number;
+};
+/**
+ * Computes padded bounds for a block geometry represented as an interleaved array of X/Y
+ * coordinates.
+ *
+ * @param geometry - The geometry describing the block perimeter, or `null`/`undefined` when the
+ * block has not been rendered.
+ * @param options - Optional padding configuration. When omitted, a small percentage padding is
+ * applied so that the block does not touch the viewport edges.
+ * @returns The padded bounds for the geometry or `null` if the input does not contain any points.
+ */
+export declare function getPaddedBlockBounds(geometry: Geometry, options?: PaddedBlockBoundsOptions): Bounds | null;
+//# sourceMappingURL=bounds-utils.d.ts.map

package/dist/views/bounds-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds-utils.d.ts","sourceRoot":"","sources":["../../src/views/bounds-utils.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1D,sFAAsF;AACtF,MAAM,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5D,8DAA8D;AAC9D,MAAM,MAAM,wBAAwB,GAAG;IACrC,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,QAAQ,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACjC,MAAM,GAAG,IAAI,CASf"}

package/dist/views/bounds-utils.js

@@ -0,0 +1,65 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Computes padded bounds for a block geometry represented as an interleaved array of X/Y
+ * coordinates.
+ *
+ * @param geometry - The geometry describing the block perimeter, or `null`/`undefined` when the
+ * block has not been rendered.
+ * @param options - Optional padding configuration. When omitted, a small percentage padding is
+ * applied so that the block does not touch the viewport edges.
+ * @returns The padded bounds for the geometry or `null` if the input does not contain any points.
+ */
+export function getPaddedBlockBounds(geometry, options) {
+    const bounds = getGeometryBounds(geometry);
+    if (!bounds) {
+        return null;
+    }
+    const paddingFraction = options?.paddingFraction ?? 0.1;
+    const minimumPadding = options?.minimumPadding ?? 1;
+    return padBounds(bounds, paddingFraction, minimumPadding);
+}
+function getGeometryBounds(geometry) {
+    if (!geometry || geometry.length < 2) {
+        return null;
+    }
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (let index = 0; index < geometry.length; index += 2) {
+        const x = geometry[index];
+        const y = geometry[index + 1];
+        if (x < minX)
+            minX = x;
+        if (y < minY)
+            minY = y;
+        if (x > maxX)
+            maxX = x;
+        if (y > maxY)
+            maxY = y;
+    }
+    if (!Number.isFinite(minX) ||
+        !Number.isFinite(minY) ||
+        !Number.isFinite(maxX) ||
+        !Number.isFinite(maxY)) {
+        return null;
+    }
+    return [
+        [minX, minY],
+        [maxX, maxY]
+    ];
+}
+function padBounds(bounds, paddingFraction, minimumPadding) {
+    const [[minX, minY], [maxX, maxY]] = bounds;
+    const width = maxX - minX;
+    const height = maxY - minY;
+    const paddingX = Math.max(width * paddingFraction, minimumPadding);
+    const paddingY = Math.max(height * paddingFraction, minimumPadding);
+    return [
+        [minX - paddingX, minY - paddingY],
+        [maxX + paddingX, maxY + paddingY]
+    ];
+}
+//# sourceMappingURL=bounds-utils.js.map

package/dist/views/bounds-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounds-utils.js","sourceRoot":"","sources":["../../src/views/bounds-utils.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAepC;;;;;;;;;GASG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAkB,EAClB,OAAkC;IAElC,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,EAAE,eAAe,IAAI,GAAG,CAAC;IACxD,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,CAAC,CAAC;IACpD,OAAO,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAkB;IAC3C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IACrB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IAErB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAE,CAAC;QAE/B,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI;YAAE,IAAI,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;QACtB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EACtB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,CAAC,IAAI,EAAE,IAAI,CAAC;QACZ,CAAC,IAAI,EAAE,IAAI,CAAC;KACb,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,MAAc,EAAE,eAAuB,EAAE,cAAsB;IAChF,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC;IAC1B,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,eAAe,EAAE,cAAc,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,eAAe,EAAE,cAAc,CAAC,CAAC;IAEpE,OAAO;QACL,CAAC,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,QAAQ,CAAC;QAClC,CAAC,IAAI,GAAG,QAAQ,EAAE,IAAI,GAAG,QAAQ,CAAC;KACnC,CAAC;AACJ,CAAC"}

package/dist/views/layer-bounds-filter.d.ts

@@ -0,0 +1,48 @@
+import type { FilterContext } from '@deck.gl/core';
+/** Deck.gl layer filter callback or `null` when no filter should be applied. */
+export type LayerFilter = ((context: FilterContext) => boolean) | null;
+/** Flat two-dimensional bounds represented as `[minX, minY, maxX, maxY]`. */
+export type Bounds = [number, number, number, number];
+/** Reason emitted when the viewport bounds filter makes or skips a filter decision. */
+export type LayerBoundsFilterDecision = {
+    /** Indicates that the layer was filtered because it missed the viewport. */
+    decision: 'filter';
+    /** Deck.gl filter context evaluated by the filter. */
+    context: FilterContext;
+    /** Layer bounds evaluated by the filter. */
+    layerBounds: Bounds;
+    /** Viewport bounds evaluated by the filter. */
+    viewportBounds: Bounds;
+} | {
+    /** Indicates that the layer did not expose usable bounds. */
+    decision: 'missing-layer-bounds';
+    /** Deck.gl filter context evaluated by the filter. */
+    context: FilterContext;
+} | {
+    /** Indicates that the viewport did not expose usable bounds. */
+    decision: 'missing-viewport-bounds';
+    /** Deck.gl filter context evaluated by the filter. */
+    context: FilterContext;
+    /** Layer bounds evaluated before viewport bounds were found missing. */
+    layerBounds: Bounds;
+};
+/** Configuration for {@link createViewportBoundsFilter}. */
+export type LayerBoundsFilterOptions = {
+    /** Callback invoked when the filter skips or applies a bounds decision. */
+    onDecision?: (decision: LayerBoundsFilterDecision) => void;
+};
+/**
+ * Combine multiple layer filters.
+ * Returns null when none of the supplied filters are defined.
+ * @param filters - Layer filters to evaluate in order.
+ * @returns One filter that requires every defined filter to pass, or `null`.
+ */
+export declare function combineLayerFilters(filters: (LayerFilter | undefined | null)[]): LayerFilter;
+/**
+ * Creates a layer filter that compares layer and viewport bounds.
+ * Layers that do not intersect the viewport bounds are filtered out.
+ * @param options - Optional decision callback configuration.
+ * @returns Layer filter that keeps only layers intersecting the current viewport.
+ */
+export declare function createViewportBoundsFilter(options?: LayerBoundsFilterOptions): LayerFilter;
+//# sourceMappingURL=layer-bounds-filter.d.ts.map

package/dist/views/layer-bounds-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layer-bounds-filter.d.ts","sourceRoot":"","sources":["../../src/views/layer-bounds-filter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,EAAkB,MAAM,eAAe,CAAC;AAElE,gFAAgF;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC,GAAG,IAAI,CAAC;AAEvE,6EAA6E;AAC7E,MAAM,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtD,uFAAuF;AACvF,MAAM,MAAM,yBAAyB,GACjC;IACE,4EAA4E;IAC5E,QAAQ,EAAE,QAAQ,CAAC;IACnB,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;CACxB,GACD;IACE,6DAA6D;IAC7D,QAAQ,EAAE,sBAAsB,CAAC;IACjC,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;CACxB,GACD;IACE,gEAAgE;IAChE,QAAQ,EAAE,yBAAyB,CAAC;IACpC,sDAAsD;IACtD,OAAO,EAAE,aAAa,CAAC;IACvB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,4DAA4D;AAC5D,MAAM,MAAM,wBAAwB,GAAG;IACrC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,yBAAyB,KAAK,IAAI,CAAC;CAC5D,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,WAAW,CAS5F;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE,wBAAwB,GAAG,WAAW,CAiC1F"}

package/dist/views/layer-bounds-filter.js

@@ -0,0 +1,99 @@
+// deck.gl-community
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Combine multiple layer filters.
+ * Returns null when none of the supplied filters are defined.
+ * @param filters - Layer filters to evaluate in order.
+ * @returns One filter that requires every defined filter to pass, or `null`.
+ */
+export function combineLayerFilters(filters) {
+    const definedFilters = filters.filter(Boolean);
+    if (!definedFilters.length) {
+        return null;
+    }
+    if (definedFilters.length === 1) {
+        return definedFilters[0];
+    }
+    return context => definedFilters.every(filter => filter(context));
+}
+/**
+ * Creates a layer filter that compares layer and viewport bounds.
+ * Layers that do not intersect the viewport bounds are filtered out.
+ * @param options - Optional decision callback configuration.
+ * @returns Layer filter that keeps only layers intersecting the current viewport.
+ */
+export function createViewportBoundsFilter(options) {
+    const layerBoundsCache = new WeakMap();
+    const viewportBoundsCache = new WeakMap();
+    return (context) => {
+        const { layer, viewport } = context;
+        let layerBounds = layerBoundsCache.get(layer);
+        if (layerBounds === undefined) {
+            layerBounds = getLayerBounds(layer);
+            layerBoundsCache.set(layer, layerBounds);
+        }
+        if (!layerBounds) {
+            options?.onDecision?.({ decision: 'missing-layer-bounds', context });
+            return true;
+        }
+        let viewportBounds = viewportBoundsCache.get(viewport);
+        if (viewportBounds === undefined) {
+            viewportBounds = getViewportBounds(viewport);
+            viewportBoundsCache.set(viewport, viewportBounds);
+        }
+        if (!viewportBounds) {
+            options?.onDecision?.({ decision: 'missing-viewport-bounds', context, layerBounds });
+            return true;
+        }
+        const shouldRender = boundsOverlap(layerBounds, viewportBounds);
+        if (!shouldRender) {
+            options?.onDecision?.({ decision: 'filter', context, layerBounds, viewportBounds });
+        }
+        return shouldRender;
+    };
+}
+function getLayerBounds(layer) {
+    const bounds = layer.getBounds();
+    if (!bounds || bounds.length < 2) {
+        return null;
+    }
+    return normalizeBounds(bounds[0], bounds[1]);
+}
+function getViewportBounds(viewport) {
+    const bounds = viewport.getBounds();
+    if (!bounds || bounds.length < 4) {
+        return null;
+    }
+    const [minX, minY, maxX, maxY] = bounds;
+    if (!isFiniteNumber(minX) ||
+        !isFiniteNumber(minY) ||
+        !isFiniteNumber(maxX) ||
+        !isFiniteNumber(maxY)) {
+        return null;
+    }
+    return normalizeBounds([minX, minY], [maxX, maxY]);
+}
+function normalizeBounds(min, max) {
+    if (!min || !max || min.length < 2 || max.length < 2) {
+        return null;
+    }
+    const minX = Math.min(min[0], max[0]);
+    const minY = Math.min(min[1], max[1]);
+    const maxX = Math.max(min[0], max[0]);
+    const maxY = Math.max(min[1], max[1]);
+    if (!isFiniteNumber(minX) ||
+        !isFiniteNumber(minY) ||
+        !isFiniteNumber(maxX) ||
+        !isFiniteNumber(maxY)) {
+        return null;
+    }
+    return [minX, minY, maxX, maxY];
+}
+function boundsOverlap(a, b) {
+    return !(a[2] < b[0] || b[2] < a[0] || a[3] < b[1] || b[3] < a[1]);
+}
+function isFiniteNumber(value) {
+    return Number.isFinite(value);
+}
+//# sourceMappingURL=layer-bounds-filter.js.map

package/dist/views/layer-bounds-filter.js.map

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

package/dist/views/orthographic-utils.d.ts

@@ -1,11 +1,39 @@
-type Bounds = [[number, number], [number, number]];
+import type { Bounds } from "./bounds-utils.js";
+/**
+ * Fits two-dimensional bounds into an orthographic viewport using one shared zoom value.
+ * @param width - Viewport width in pixels.
+ * @param height - Viewport height in pixels.
+ * @param bounds - World-space bounds to fit.
+ * @param zoomMode - Shared-zoom mode selector.
+ * @returns View target and shared/per-axis zoom values.
+ */
 export declare function fitBoundsOrthographic(width: number, height: number, bounds: Readonly<Bounds>, zoomMode: 'single'): {
     target: [number, number];
     zoom: number;
+    zoomX: number;
+    zoomY: number;
 };
+/**
+ * Fits two-dimensional bounds into an orthographic viewport using one zoom per axis.
+ * @param width - Viewport width in pixels.
+ * @param height - Viewport height in pixels.
+ * @param bounds - World-space bounds to fit.
+ * @param zoomMode - Per-axis zoom mode selector.
+ * @returns View target and per-axis zoom values.
+ */
 export declare function fitBoundsOrthographic(width: number, height: number, bounds: Readonly<Bounds>, zoomMode: 'per-axis'): {
     target: [number, number];
     zoom: [number, number];
+    zoomX: number;
+    zoomY: number;
 };
-export {};
+/**
+ * Computes world-space bounds covered by an orthographic viewport.
+ * @param width - Viewport width in pixels.
+ * @param height - Viewport height in pixels.
+ * @param zoom - Deck.gl orthographic zoom level, as one value or `[zoomX, zoomY]`.
+ * @param target - Deck.gl orthographic target `[centerX, centerY]`.
+ * @returns World-space bounds covered by the viewport.
+ */
+export declare function getBoundsOrthographic(width: number, height: number, zoom: number | [number, number], target: [number, number]): Bounds;
 //# sourceMappingURL=orthographic-utils.d.ts.map

package/dist/views/orthographic-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orthographic-utils.d.ts","sourceRoot":"","sources":["../../src/views/orthographic-utils.ts"],"names":[],"mappings":"AAIA,KAAK,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAEnD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAQ,EAAE,QAAQ,GACjB;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAC;AAE5C,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAQ,EAAE,UAAU,GACnB;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAC,CAAC"}
+{"version":3,"file":"orthographic-utils.d.ts","sourceRoot":"","sources":["../../src/views/orthographic-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,MAAM,EAAC,0BAAuB;AAE3C;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAQ,EAAE,QAAQ,GACjB;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;AAE1E;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,QAAQ,EAAE,UAAU,GACnB;IAAC,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;AA0DpF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GACvB,MAAM,CAWR"}

package/dist/views/orthographic-utils.js

@@ -2,14 +2,12 @@
 // SPDX-License-Identifier: MIT
 // Copyright (c) vis.gl contributors
 /**
- * Compute center & zoom for an OrthographicViewport so that `bounds` fills the viewport.
- * @param width  viewport width in px
- * @param height viewport height in px
- * @param bounds [[minX,minY],[maxX,maxY]] in the same world units you’re rendering
- * @returns { target: [number, number], zoom: number }
- *   target: center of the viewport in world units
- *   zoom: deck.gl orthographic zoom level (log2(scale))
- *   (deck.gl orthographic zoom is the log2 of the scale factor)
+ * Fits two-dimensional bounds into an orthographic viewport.
+ * @param width - Viewport width in pixels.
+ * @param height - Viewport height in pixels.
+ * @param bounds - World-space bounds to fit.
+ * @param zoomMode - Whether to use one shared zoom or one zoom per axis.
+ * @returns View target plus deck.gl orthographic zoom values.
  */
 export function fitBoundsOrthographic(width, height, bounds, zoomMode = 'per-axis') {
     const [[minX, minY], [maxX, maxY]] = bounds;
@@ -17,11 +15,11 @@ export function fitBoundsOrthographic(width, height, bounds, zoomMode = 'per-axi
     const centerX = (minX + maxX) / 2;
     const centerY = (minY + maxY) / 2;
     // size of the box
-    const boxW = maxX - minX;
-    const boxH = maxY - minY;
+    const boxW = Math.max(0, maxX - minX);
+    const boxH = Math.max(0, maxY - minY);
     // scale (world units → screen pixels)
-    const scaleX = width / boxW;
-    const scaleY = height / boxH;
+    const scaleX = boxW ? Math.max(1, width) / boxW : 1;
+    const scaleY = boxH ? Math.max(1, height) / boxH : 1;
     // pick the smaller scale so the whole box fits
     const scale = Math.min(scaleX, scaleY);
     // deck.gl orthographic zoom is log2(scale)
@@ -29,13 +27,34 @@ export function fitBoundsOrthographic(width, height, bounds, zoomMode = 'per-axi
     // 3) axis‐specific zooms (deck.gl’s orthographic zoom = log2(scale))
     const zoomX = Math.log2(scaleX);
     const zoomY = Math.log2(scaleY);
-    if (Number.isNaN(zoom) || Number.isNaN(zoomX) || Number.isNaN(zoom)) {
+    if (Number.isNaN(zoom) || Number.isNaN(zoomX) || Number.isNaN(zoomY)) {
         // eslint-disable-next-line no-console
         console.warn('Invalid zoom values:', { zoom, zoomX, zoomY });
     }
     return {
         target: [centerX, centerY],
-        zoom: zoomMode === 'single' ? zoom : [zoomX, zoomY]
+        zoom: zoomMode === 'single' ? zoom : [zoomX, zoomY],
+        zoomX: zoomMode === 'single' ? zoom : zoomX,
+        zoomY: zoomMode === 'single' ? zoom : zoomY
     };
 }
+/**
+ * Computes world-space bounds covered by an orthographic viewport.
+ * @param width - Viewport width in pixels.
+ * @param height - Viewport height in pixels.
+ * @param zoom - Deck.gl orthographic zoom level, as one value or `[zoomX, zoomY]`.
+ * @param target - Deck.gl orthographic target `[centerX, centerY]`.
+ * @returns World-space bounds covered by the viewport.
+ */
+export function getBoundsOrthographic(width, height, zoom, target) {
+    const [centerX, centerY] = target;
+    const scaleX = Array.isArray(zoom) ? 2 ** zoom[0] : 2 ** zoom;
+    const scaleY = Array.isArray(zoom) ? 2 ** zoom[1] : 2 ** zoom;
+    const worldW = width / scaleX;
+    const worldH = height / scaleY;
+    return [
+        [centerX - worldW / 2, centerY - worldH / 2],
+        [centerX + worldW / 2, centerY + worldH / 2]
+    ];
+}
 //# sourceMappingURL=orthographic-utils.js.map

package/dist/views/orthographic-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"orthographic-utils.js","sourceRoot":"","sources":["../../src/views/orthographic-utils.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,+BAA+B;AAC/B,oCAAoC;AAkBpC;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,MAAc,EACd,MAAwB,EACxB,WAAkC,UAAU;IAE5C,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;IAE5C,oBAAoB;IACpB,MAAM,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAElC,kBAAkB;IAClB,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAEzB,sCAAsC;IACtC,MAAM,MAAM,GAAG,KAAK,GAAG,IAAI,CAAC;IAC5B,MAAM,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAE7B,+CAA+C;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC,2CAA2C;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9B,qEAAqE;IACrE,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpE,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO;QACL,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;QAC1B,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC;KACpD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"orthographic-utils.js","sourceRoot":"","sources":["../../src/views/orthographic-utils.ts"],"names":[],"mappings":"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"}

package/dist/views/view-layout/build-views-from-view-layout.d.ts

@@ -0,0 +1,37 @@
+import { View } from '@deck.gl/core';
+import { ViewLayoutItem } from "./view-layout-item.js";
+/** Rectangle resolved by the layout compiler for one view id. */
+export type ViewLayoutRect = {
+    /** Left coordinate in deck pixels. */
+    x: number;
+    /** Top coordinate in deck pixels. */
+    y: number;
+    /** Width in deck pixels. */
+    width: number;
+    /** Height in deck pixels. */
+    height: number;
+};
+/** Concrete views plus resolved rectangles produced by `buildViewsFromViewLayout`. */
+export type CompiledDeckViews = {
+    /** Concrete deck.gl views with numeric bounds resolved for the current canvas size. */
+    views: View[];
+    /** Resolved rectangles keyed by deck view id. */
+    rectsById: Record<string, ViewLayoutRect>;
+};
+/**
+ * Compiles one `ViewLayoutItem` tree into concrete deck.gl views and resolved rectangles.
+ *
+ * @param args - Root layout plus the current canvas size and optional previous compilation.
+ * @returns Concrete views with numeric bounds plus resolved rectangles keyed by view id.
+ */
+export declare function buildViewsFromViewLayout(args: {
+    /** Root layout tree to compile. */
+    layout: ViewLayoutItem;
+    /** Current deck width in pixels. */
+    width: number;
+    /** Current deck height in pixels. */
+    height: number;
+    /** Optional previous compilation used for structural view reuse. */
+    previous?: CompiledDeckViews;
+}): CompiledDeckViews;
+//# sourceMappingURL=build-views-from-view-layout.d.ts.map

package/dist/views/view-layout/build-views-from-view-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-views-from-view-layout.d.ts","sourceRoot":"","sources":["../../../src/views/view-layout/build-views-from-view-layout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,IAAI,EAAC,MAAM,eAAe,CAAC;AAEnC,OAAO,EAAC,cAAc,EAAC,8BAA2B;AAIlD,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG;IAC3B,sCAAsC;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,qCAAqC;IACrC,CAAC,EAAE,MAAM,CAAC;IACV,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,sFAAsF;AACtF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,uFAAuF;IACvF,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C,CAAC;AAgBF;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE;IAC7C,mCAAmC;IACnC,MAAM,EAAE,cAAc,CAAC;IACvB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B,GAAG,iBAAiB,CA2BpB"}