@walkthru-earth/objex 1.3.1 → 1.5.0

package/dist/utils/deck.d.ts

@@ -4,7 +4,7 @@
  * - GeoJSON overlay: used by FlatGeobufViewer
  * - GeoArrow overlay: used by GeoParquetMapViewer (zero-copy DuckDB → GPU pipeline)
  */
-import type { GeoArrowResult } from './geoarrow.js';
+import type { GeoArrowResult } from '@walkthru-earth/objex-utils';
 /**
  * Create an onHover callback that toggles the cursor on the MapLibre canvas.
  * With `interleaved: false`, deck.gl's own canvas has pointer-events: none,
@@ -17,6 +17,8 @@ export declare function hoverCursor(map: {
     picked?: boolean;
 }) => void;
 type RGBA = [number, number, number, number];
+/** RGBA used to highlight a hovered/selected feature across map viewers. */
+export declare const HIGHLIGHT_COLOR: [number, number, number, number];
 /** Distinct fill/line colors per geometry type. */
 export declare const GEOMETRY_COLORS: Record<string, {
     fill: RGBA;
@@ -35,17 +37,21 @@ export declare function loadDeckModules(): Promise<{
 }>;
 /** Lazy-load GeoArrow deck.gl layers + MapboxOverlay + GeoJsonLayer (for selection). */
 export declare function loadGeoArrowModules(): Promise<{
-    GeoArrowArcLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowArcLayer;
-    GeoArrowColumnLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowColumnLayer;
-    _GeoArrowH3HexagonLayer: typeof import("@geoarrow/deck.gl-layers")._GeoArrowH3HexagonLayer;
-    GeoArrowHeatmapLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowHeatmapLayer;
-    GeoArrowPathLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowPathLayer;
-    GeoArrowPointCloudLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowPointCloudLayer;
-    GeoArrowPolygonLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowPolygonLayer;
-    GeoArrowScatterplotLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowScatterplotLayer;
-    GeoArrowSolidPolygonLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowSolidPolygonLayer;
-    _GeoArrowTextLayer: typeof import("@geoarrow/deck.gl-layers")._GeoArrowTextLayer;
-    GeoArrowTripsLayer: typeof import("@geoarrow/deck.gl-layers").GeoArrowTripsLayer;
+    GeoArrowA5Layer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowA5Layer;
+    GeoArrowArcLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowArcLayer;
+    GeoArrowColumnLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowColumnLayer;
+    GeoArrowGeohashLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowGeohashLayer;
+    GeoArrowH3HexagonLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowH3HexagonLayer;
+    GeoArrowHeatmapLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowHeatmapLayer;
+    GeoArrowPathLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowPathLayer;
+    GeoArrowPointCloudLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowPointCloudLayer;
+    GeoArrowPolygonLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowPolygonLayer;
+    GeoArrowS2Layer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowS2Layer;
+    GeoArrowScatterplotLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowScatterplotLayer;
+    GeoArrowSolidPolygonLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowSolidPolygonLayer;
+    initEarcutPool: typeof import("@geoarrow/deck.gl-geoarrow").initEarcutPool;
+    _GeoArrowTextLayer: typeof import("@geoarrow/deck.gl-geoarrow")._GeoArrowTextLayer;
+    GeoArrowTripsLayer: typeof import("@geoarrow/deck.gl-geoarrow").GeoArrowTripsLayer;
     MapboxOverlay: typeof import("@deck.gl/mapbox").MapboxOverlay;
     GeoJsonLayer: typeof import("@deck.gl/layers").GeoJsonLayer;
 }>;

package/dist/utils/deck.js

@@ -16,6 +16,8 @@ export function hoverCursor(map) {
         map.getCanvas().style.cursor = info.picked ? 'pointer' : '';
     };
 }
+/** RGBA used to highlight a hovered/selected feature across map viewers. */
+export const HIGHLIGHT_COLOR = [255, 255, 255, 100];
 /** Distinct fill/line colors per geometry type. */
 export const GEOMETRY_COLORS = {
     point: { fill: [66, 133, 244, 180], line: [25, 103, 210, 220] },
@@ -51,7 +53,7 @@ export async function loadDeckModules() {
 export async function loadGeoArrowModules() {
     const [{ MapboxOverlay }, geoarrowLayers, { GeoJsonLayer }] = await Promise.all([
         import('@deck.gl/mapbox'),
-        import('@geoarrow/deck.gl-layers'),
+        import('@geoarrow/deck.gl-geoarrow'),
         import('@deck.gl/layers')
     ]);
     return { MapboxOverlay, GeoJsonLayer, ...geoarrowLayers };
@@ -60,6 +62,12 @@ export async function loadGeoArrowModules() {
 function createLayerForResult(modules, result, layerId, onClick, onHover) {
     const { GeoArrowScatterplotLayer, GeoArrowPathLayer, GeoArrowPolygonLayer } = modules;
     const { table, geometryType, sourceIndices } = result;
+    // @geoarrow/deck.gl-geoarrow 0.4+ takes a single Arrow RecordBatch as `data`,
+    // not a Table. buildSingleTable() always assembles one batch per table, so the
+    // row index stays 0..N-1 and the sourceIndices click mapping is unaffected.
+    const batch = table.batches[0];
+    if (!batch)
+        return null;
     const { fill, line } = colorsForType(geometryType);
     const handleClick = (info) => {
         if (!onClick)
@@ -71,7 +79,7 @@ function createLayerForResult(modules, result, layerId, onClick, onHover) {
     if (geometryType === 'point' || geometryType === 'multipoint') {
         return new GeoArrowScatterplotLayer({
             id: layerId,
-            data: table,
+            data: batch,
             getFillColor: fill,
             getRadius: 6,
             radiusUnits: 'pixels',
@@ -79,7 +87,7 @@ function createLayerForResult(modules, result, layerId, onClick, onHover) {
             radiusMaxPixels: 12,
             pickable: true,
             autoHighlight: true,
-            highlightColor: [255, 255, 255, 100],
+            highlightColor: HIGHLIGHT_COLOR,
             _validate: false,
             onHover,
             onClick: handleClick
@@ -88,14 +96,14 @@ function createLayerForResult(modules, result, layerId, onClick, onHover) {
     else if (geometryType === 'linestring' || geometryType === 'multilinestring') {
         return new GeoArrowPathLayer({
             id: layerId,
-            data: table,
+            data: batch,
             getColor: line,
             getWidth: 2.5,
             widthUnits: 'pixels',
             widthMinPixels: 1.5,
             pickable: true,
             autoHighlight: true,
-            highlightColor: [255, 255, 255, 100],
+            highlightColor: HIGHLIGHT_COLOR,
             _validate: false,
             onHover,
             onClick: handleClick
@@ -104,14 +112,14 @@ function createLayerForResult(modules, result, layerId, onClick, onHover) {
     else {
         return new GeoArrowPolygonLayer({
             id: layerId,
-            data: table,
+            data: batch,
             getFillColor: fill,
             getLineColor: line,
             getLineWidth: 2,
             lineWidthMinPixels: 1.5,
             pickable: true,
             autoHighlight: true,
-            highlightColor: [255, 255, 255, 100],
+            highlightColor: HIGHLIGHT_COLOR,
             _validate: false,
             onHover,
             onClick: handleClick

package/dist/utils/media-query.svelte.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Reactive media-query helpers for Svelte 5 runes.
+ *
+ * Usage (inside a component .svelte file):
+ *   import { useIsWide } from '../utils/media-query.svelte.js';
+ *   const isWide = useIsWide();  // true when viewport >= 640 px (Tailwind sm)
+ *   // then: {#if isWide.value} ... {/if}
+ *
+ * SSR-safe: guards with `typeof window` (this is a CSR-only SPA, but be defensive).
+ */
+/** Reactive wrapper around a single MediaQueryList. */
+export declare function useIsWide(): {
+    readonly value: boolean;
+};

package/dist/utils/media-query.svelte.js

@@ -0,0 +1,29 @@
+/**
+ * Reactive media-query helpers for Svelte 5 runes.
+ *
+ * Usage (inside a component .svelte file):
+ *   import { useIsWide } from '../utils/media-query.svelte.js';
+ *   const isWide = useIsWide();  // true when viewport >= 640 px (Tailwind sm)
+ *   // then: {#if isWide.value} ... {/if}
+ *
+ * SSR-safe: guards with `typeof window` (this is a CSR-only SPA, but be defensive).
+ */
+/** Reactive wrapper around a single MediaQueryList. */
+export function useIsWide() {
+    let value = $state(typeof window !== 'undefined' ? window.matchMedia('(min-width: 640px)').matches : true);
+    if (typeof window !== 'undefined') {
+        const mq = window.matchMedia('(min-width: 640px)');
+        const handler = (e) => {
+            value = e.matches;
+        };
+        $effect(() => {
+            mq.addEventListener('change', handler);
+            return () => mq.removeEventListener('change', handler);
+        });
+    }
+    return {
+        get value() {
+            return value;
+        }
+    };
+}

package/dist/utils/pmtiles-tile.js

@@ -18,11 +18,11 @@ export async function decodeMvtTile(pmtiles, z, x, y) {
     const bytes = new Uint8Array(resp.data);
     const rawSize = bytes.length;
     // Lazy-load @mapbox/vector-tile + pbf (only when inspector is opened)
-    const [{ VectorTile }, { default: Pbf }] = await Promise.all([
+    const [{ VectorTile }, { PbfReader }] = await Promise.all([
         import('@mapbox/vector-tile'),
         import('pbf')
     ]);
-    const tile = new VectorTile(new Pbf(bytes));
+    const tile = new VectorTile(new PbfReader(bytes));
     const layers = [];
     for (const [name, vtLayer] of Object.entries(tile.layers)) {
         const features = [];

package/dist/utils/signed-url-effect.d.ts

@@ -0,0 +1,7 @@
+import type { Tab } from '../types.js';
+/**
+ * Resolve a tab's signed HTTPS URL reactively for iframe-style viewers.
+ * Call inside a component's $effect; returns a cleanup function.
+ * onResolved runs only if the tab is still current (guards the async race).
+ */
+export declare function resolveSignedTabUrl(tab: Tab, onResolved: (url: string) => void): () => void;

package/dist/utils/signed-url-effect.js

@@ -0,0 +1,19 @@
+import { buildHttpsUrlAsync } from './signed-url.js';
+/**
+ * Resolve a tab's signed HTTPS URL reactively for iframe-style viewers.
+ * Call inside a component's $effect; returns a cleanup function.
+ * onResolved runs only if the tab is still current (guards the async race).
+ */
+export function resolveSignedTabUrl(tab, onResolved) {
+    let cancelled = false;
+    const id = tab.id;
+    (async () => {
+        const url = await buildHttpsUrlAsync(tab);
+        if (cancelled || id !== tab.id)
+            return;
+        onResolved(url);
+    })();
+    return () => {
+        cancelled = true;
+    };
+}

package/dist/utils/{url.d.ts → signed-url.d.ts}

@@ -1,4 +1,18 @@
-import type { Tab } from '../types.js';
+import type { Connection, Tab } from '../types.js';
+/**
+ * Build an HTTPS URL for a file in a given connection. Provider-aware via
+ * `buildProviderBaseUrl` (AWS, GCS, R2, Wasabi, B2, DO, Storj, Contabo, Hetzner,
+ * Linode, OVH, MinIO), with the Azure container/blob + SAS special case. This is
+ * the single source of truth shared by `buildHttpsUrl` (tab-based) and the
+ * FileTreeSidebar "Copy HTTP URL" action, so neither can drift back to a
+ * hardcoded AWS fallback for non-AWS providers.
+ *
+ * @param opts.encode percent-encode each path segment (for copy-to-clipboard).
+ *   Off by default to preserve the raw streaming-URL behavior viewers rely on.
+ */
+export declare function buildHttpsUrlForConnection(conn: Connection, path: string, opts?: {
+    encode?: boolean;
+}): string;
 /**
  * Build an HTTPS URL for a tab's file.
  * Works for any viewer that needs an HTTP-accessible URL (COG, PMTiles, Zarr, etc.)

package/dist/utils/{url.js → signed-url.js}

@@ -1,8 +1,38 @@
+import { getNativeScheme, safeDecodeURIComponent } from '@walkthru-earth/objex-utils';
 import { presignHttpsUrl } from '../storage/presign.js';
 import { buildProviderBaseUrl, isPubliclyStreamable } from '../storage/providers.js';
 import { connections } from '../stores/connections.svelte.js';
 import { credentialStore } from '../stores/credentials.svelte.js';
-import { getNativeScheme, safeDecodeURIComponent } from './cloud-url.js';
+/** Percent-encode each path segment, preserving the slashes between them. */
+function encodeKeyPath(key) {
+    return key
+        .split('/')
+        .map((s) => encodeURIComponent(s))
+        .join('/');
+}
+/**
+ * Build an HTTPS URL for a file in a given connection. Provider-aware via
+ * `buildProviderBaseUrl` (AWS, GCS, R2, Wasabi, B2, DO, Storj, Contabo, Hetzner,
+ * Linode, OVH, MinIO), with the Azure container/blob + SAS special case. This is
+ * the single source of truth shared by `buildHttpsUrl` (tab-based) and the
+ * FileTreeSidebar "Copy HTTP URL" action, so neither can drift back to a
+ * hardcoded AWS fallback for non-AWS providers.
+ *
+ * @param opts.encode percent-encode each path segment (for copy-to-clipboard).
+ *   Off by default to preserve the raw streaming-URL behavior viewers rely on.
+ */
+export function buildHttpsUrlForConnection(conn, path, opts) {
+    const cleanPath = path.replace(/^\//, '');
+    const finalPath = opts?.encode ? encodeKeyPath(cleanPath) : cleanPath;
+    // Azure: <endpoint>/<container>/<blob>, append SAS if available
+    if (conn.provider === 'azure') {
+        const base = conn.endpoint
+            ? `${conn.endpoint.replace(/\/$/, '')}/${conn.bucket}/${finalPath}`
+            : `https://${conn.bucket}.blob.core.windows.net/${finalPath}`;
+        return appendAzureSas(base, conn.id);
+    }
+    return `${buildProviderBaseUrl(conn.provider, conn.endpoint, conn.bucket, conn.region)}/${finalPath}`;
+}
 /**
  * Build an HTTPS URL for a tab's file.
  * Works for any viewer that needs an HTTP-accessible URL (COG, PMTiles, Zarr, etc.)
@@ -11,15 +41,7 @@ export function buildHttpsUrl(tab) {
     const conn = tab.connectionId ? connections.getById(tab.connectionId) : null;
     if (!conn)
         return tab.path;
-    const cleanPath = tab.path.replace(/^\//, '');
-    // Azure: <endpoint>/<container>/<blob>, append SAS if available
-    if (conn.provider === 'azure') {
-        const base = conn.endpoint
-            ? `${conn.endpoint.replace(/\/$/, '')}/${conn.bucket}/${cleanPath}`
-            : `https://${conn.bucket}.blob.core.windows.net/${cleanPath}`;
-        return appendAzureSas(base, conn.id);
-    }
-    return `${buildProviderBaseUrl(conn.provider, conn.endpoint, conn.bucket, conn.region)}/${cleanPath}`;
+    return buildHttpsUrlForConnection(conn, tab.path);
 }
 /**
  * Async counterpart of `buildHttpsUrl`. For `signed-s3` connections, returns a

package/dist/utils/url-state.d.ts

@@ -28,8 +28,40 @@ export declare function syncUrlParam(conn: Connection, prefix?: string): void;
 export declare function updateUrlView(view: string): void;
 /**
  * Read the current #hash view mode from the URL.
+ *
+ * The hash is parsed as `#<mode>?<viewParams>`, where `<mode>` is the viewer
+ * token (`map`, `stac-map`, `code`, `multicog`, ...) and `<viewParams>` is an
+ * optional URLSearchParams-shaped string used by viewers that want richer
+ * shareable state (e.g. MultiCogViewer encoding its chosen R/G/B asset keys).
+ * Returns just the mode string for backwards compatibility; per-viewer
+ * params are retrieved via `getUrlViewParams()`.
  */
 export declare function getUrlView(): string;
+/**
+ * Pick a viewer's `viewMode` from the current URL hash, validated against the
+ * viewer's known token vocabulary. Centralises the "is this hash one of the
+ * modes I support?" decision so each viewer doesn't reimplement string-match
+ * ternary chains, and so we have one place to enforce the invariant: an
+ * explicit hash is honoured exactly, an unknown or empty hash falls back to
+ * `defaultMode` WITHOUT rewriting the URL. Viewers that mount transiently
+ * while another viewer farther up the stack is being chosen (e.g. CodeViewer
+ * during ViewerRouter's async STAC detection) MUST NOT clobber a hash they
+ * don't understand, because that hash is owned by the eventual viewer.
+ */
+export declare function pickViewMode<T extends string>(validModes: readonly T[], defaultMode: T): T;
+/**
+ * Read viewer-specific params from the URL hash query-string portion.
+ *
+ * Format: `#<mode>?k1=v1&k2=v2`. Returns a `URLSearchParams` so callers can
+ * `.get(key)` cleanly and merge their own state into it.
+ */
+export declare function getUrlViewParams(): URLSearchParams;
+/**
+ * Update the hash with both a mode and an optional set of viewer params.
+ * Empty / null `params` writes just `#<mode>`. Existing hash params are
+ * fully replaced — pass the merged set in.
+ */
+export declare function updateUrlViewParams(view: string, params?: URLSearchParams | null): void;
 /**
  * Read the prefix (file/folder path) from the ?url= param.
  */
@@ -40,6 +72,10 @@ export declare function getUrlPrefix(): string;
  * auto-migration is in progress (see `+page.svelte` tab-sync effect).
  */
 export declare function hasUrlParam(): boolean;
+/**
+ * Read the `?panel=` param (e.g. `?panel=settings`) to auto-open a panel on load.
+ */
+export declare function getPanelParam(): string | null;
 /**
  * Clear all URL state params.
  */

package/dist/utils/url-state.js

@@ -9,9 +9,9 @@
  *
  * Uses SvelteKit's replaceState to avoid conflicts with the router.
  */
+import { parseStorageUrl } from '@walkthru-earth/objex-utils';
 import { replaceState } from '$app/navigation';
 import { buildProviderBaseUrl } from '../storage/providers.js';
-import { parseStorageUrl } from './storage-url.js';
 /**
  * Build the base HTTPS URL for a connection (endpoint + bucket).
  */
@@ -68,15 +68,74 @@ export function updateUrlView(view) {
 }
 /**
  * Read the current #hash view mode from the URL.
+ *
+ * The hash is parsed as `#<mode>?<viewParams>`, where `<mode>` is the viewer
+ * token (`map`, `stac-map`, `code`, `multicog`, ...) and `<viewParams>` is an
+ * optional URLSearchParams-shaped string used by viewers that want richer
+ * shareable state (e.g. MultiCogViewer encoding its chosen R/G/B asset keys).
+ * Returns just the mode string for backwards compatibility; per-viewer
+ * params are retrieved via `getUrlViewParams()`.
  */
 export function getUrlView() {
     try {
-        return window.location.hash.replace('#', '');
+        const raw = window.location.hash.replace('#', '');
+        const q = raw.indexOf('?');
+        return q >= 0 ? raw.slice(0, q) : raw;
     }
     catch {
         return '';
     }
 }
+/**
+ * Pick a viewer's `viewMode` from the current URL hash, validated against the
+ * viewer's known token vocabulary. Centralises the "is this hash one of the
+ * modes I support?" decision so each viewer doesn't reimplement string-match
+ * ternary chains, and so we have one place to enforce the invariant: an
+ * explicit hash is honoured exactly, an unknown or empty hash falls back to
+ * `defaultMode` WITHOUT rewriting the URL. Viewers that mount transiently
+ * while another viewer farther up the stack is being chosen (e.g. CodeViewer
+ * during ViewerRouter's async STAC detection) MUST NOT clobber a hash they
+ * don't understand, because that hash is owned by the eventual viewer.
+ */
+export function pickViewMode(validModes, defaultMode) {
+    const view = getUrlView();
+    if (view && validModes.includes(view))
+        return view;
+    return defaultMode;
+}
+/**
+ * Read viewer-specific params from the URL hash query-string portion.
+ *
+ * Format: `#<mode>?k1=v1&k2=v2`. Returns a `URLSearchParams` so callers can
+ * `.get(key)` cleanly and merge their own state into it.
+ */
+export function getUrlViewParams() {
+    try {
+        const raw = window.location.hash.replace('#', '');
+        const q = raw.indexOf('?');
+        if (q < 0)
+            return new URLSearchParams();
+        return new URLSearchParams(raw.slice(q + 1));
+    }
+    catch {
+        return new URLSearchParams();
+    }
+}
+/**
+ * Update the hash with both a mode and an optional set of viewer params.
+ * Empty / null `params` writes just `#<mode>`. Existing hash params are
+ * fully replaced — pass the merged set in.
+ */
+export function updateUrlViewParams(view, params) {
+    const qs = params?.toString();
+    writeLocation((url) => {
+        if (!view) {
+            url.hash = '';
+            return;
+        }
+        url.hash = qs ? `${view}?${qs}` : view;
+    });
+}
 /**
  * Read the prefix (file/folder path) from the ?url= param.
  */
@@ -105,6 +164,17 @@ export function hasUrlParam() {
         return false;
     }
 }
+/**
+ * Read the `?panel=` param (e.g. `?panel=settings`) to auto-open a panel on load.
+ */
+export function getPanelParam() {
+    try {
+        return new URL(window.location.href).searchParams.get('panel');
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Clear all URL state params.
  */

package/dist/utils/zarr-tab.d.ts

@@ -1,7 +1,6 @@
 /**
  * Zarr tab-opening helper.
- * Centralizes Zarr store tab creation to avoid duplicating the same logic
- * across FileBrowser, FileRow, FileTreeSidebar, and +page.svelte.
+ * Centralizes Zarr store tab creation across FileTreeSidebar and +page.svelte.
  *
  * Kept separate from zarr.ts to avoid adding a store dependency to a pure utility.
  */

package/dist/utils/zarr-tab.js

@@ -1,7 +1,6 @@
 /**
  * Zarr tab-opening helper.
- * Centralizes Zarr store tab creation to avoid duplicating the same logic
- * across FileBrowser, FileRow, FileTreeSidebar, and +page.svelte.
+ * Centralizes Zarr store tab creation across FileTreeSidebar and +page.svelte.
  *
  * Kept separate from zarr.ts to avoid adding a store dependency to a pure utility.
  */

package/dist/utils/zarr.d.ts

@@ -61,23 +61,6 @@ export interface GeoZarrInfo {
  * caller to the `@carbonplan/zarr-layer` fallback.
  */
 export declare function detectGeoZarr(hierarchy: ZarrHierarchy): GeoZarrInfo | null;
-/**
- * Convert a decoded GeoZarr tile (band-planar or packed RGB) into RGBA
- * `ImageData` for deck.gl-zarr's `renderTile` callback. Input is expected to
- * be a Uint8 or Uint16 typed array with either 3 interleaved bytes per pixel
- * or 3 planar bands of width*height values.
- *
- * For 16-bit data the caller supplies the rescale range so the CPU
- * normalization matches what the GPU `LinearRescale` module would produce.
- */
-export declare function zarrTileToImageData(raw: ArrayLike<number> & {
-    length: number;
-}, width: number, height: number, opts?: {
-    layout?: 'packed' | 'planar';
-    bands?: 1 | 3;
-    rescaleMin?: number;
-    rescaleMax?: number;
-}): ImageData;
 /** Dimension-like variable names treated as coordinates. */
 export declare const DIM_LIKE_NAMES: Set<string>;
 /** Guess dimension names from shape length when metadata is absent. */

package/dist/utils/zarr.js

@@ -4,7 +4,7 @@
  * Builds a hierarchical tree of groups and arrays from consolidated metadata
  * (Zarr v2 .zmetadata, v3 zarr.json), with zarrita fallback for non-consolidated stores.
  */
-import { formatFileSize } from './format.js';
+import { formatFileSize } from '@walkthru-earth/objex-utils';
 // ---------------------------------------------------------------------------
 // Register numcodecs-wrapped codecs with zarrita's codec registry.
 // Zarr v3 stores produced by Python's zarr-python may wrap codecs with the
@@ -163,50 +163,6 @@ function isGeoZarrAttrs(attrs) {
         Boolean(attrs.crs_wkt);
     return hasMultiscales && hasSpatial && hasCrs;
 }
-/**
- * Convert a decoded GeoZarr tile (band-planar or packed RGB) into RGBA
- * `ImageData` for deck.gl-zarr's `renderTile` callback. Input is expected to
- * be a Uint8 or Uint16 typed array with either 3 interleaved bytes per pixel
- * or 3 planar bands of width*height values.
- *
- * For 16-bit data the caller supplies the rescale range so the CPU
- * normalization matches what the GPU `LinearRescale` module would produce.
- */
-export function zarrTileToImageData(raw, width, height, opts = {}) {
-    const bands = opts.bands ?? 3;
-    const layout = opts.layout ?? 'packed';
-    const min = opts.rescaleMin ?? 0;
-    const max = opts.rescaleMax ?? 255;
-    const range = max - min || 1;
-    const pixelCount = width * height;
-    const rgba = new Uint8ClampedArray(pixelCount * 4);
-    for (let i = 0; i < pixelCount; i++) {
-        let r = 0;
-        let g = 0;
-        let b = 0;
-        if (bands === 1) {
-            const v = Number(raw[i]);
-            r = g = b = (v - min) / range;
-        }
-        else if (layout === 'planar') {
-            r = (Number(raw[i]) - min) / range;
-            g = (Number(raw[pixelCount + i]) - min) / range;
-            b = (Number(raw[2 * pixelCount + i]) - min) / range;
-        }
-        else {
-            const base = i * 3;
-            r = (Number(raw[base]) - min) / range;
-            g = (Number(raw[base + 1]) - min) / range;
-            b = (Number(raw[base + 2]) - min) / range;
-        }
-        const idx = i * 4;
-        rgba[idx] = Math.round(Math.max(0, Math.min(1, r)) * 255);
-        rgba[idx + 1] = Math.round(Math.max(0, Math.min(1, g)) * 255);
-        rgba[idx + 2] = Math.round(Math.max(0, Math.min(1, b)) * 255);
-        rgba[idx + 3] = 255;
-    }
-    return new ImageData(rgba, width, height);
-}
 // ---------------------------------------------------------------------------
 // Kept helpers
 // ---------------------------------------------------------------------------