@walkthru-earth/objex 1.3.0 → 1.4.0

package/dist/utils/colormap-sprite.d.ts

@@ -17,8 +17,6 @@ export { COLORMAP_INDEX, type ColormapName } from '@developmentseed/deck.gl-rast
 export declare const COLORMAP_SPRITE_URL: any;
 /** Number of distinct ramps encoded as 1-pixel-tall rows in the sprite. */
 export declare const COLORMAP_SPRITE_LAYERS: number;
-/** Width of each ramp row in pixels (also the sampling resolution). */
-export declare const COLORMAP_SPRITE_WIDTH = 256;
 /** All ramp names, sorted alphabetically (matches `COLORMAP_INDEX` key order). */
 export declare const COLORMAP_NAMES: ColormapName[];
 /** Decode the shipped sprite once per session. Safe to call repeatedly. */
@@ -30,10 +28,3 @@ export declare function loadColormapSprite(): Promise<ImageData>;
  * `Colormap` shader module.
  */
 export declare function getColormapTexture(device: Device): Promise<Texture>;
-/**
- * CSS `background` properties that render a single colormap row from the
- * shipped sprite. Vertically scales the sprite so each 1-pixel row fills
- * the container's full height, then offsets to land on the requested layer.
- * Returns `undefined` for unknown ramp names so the caller can fall back.
- */
-export declare function spriteBackgroundStyle(name: ColormapName, heightPx: number): string | undefined;

package/dist/utils/colormap-sprite.js

@@ -21,8 +21,6 @@ export { COLORMAP_INDEX } from '@developmentseed/deck.gl-raster/gpu-modules';
 export const COLORMAP_SPRITE_URL = colormapsPngUrl;
 /** Number of distinct ramps encoded as 1-pixel-tall rows in the sprite. */
 export const COLORMAP_SPRITE_LAYERS = Object.keys(COLORMAP_INDEX).length;
-/** Width of each ramp row in pixels (also the sampling resolution). */
-export const COLORMAP_SPRITE_WIDTH = 256;
 /** All ramp names, sorted alphabetically (matches `COLORMAP_INDEX` key order). */
 export const COLORMAP_NAMES = Object.keys(COLORMAP_INDEX).sort();
 let spritePromise = null;
@@ -56,22 +54,3 @@ export async function getColormapTexture(device) {
     textureCache.set(device, texture);
     return texture;
 }
-/**
- * CSS `background` properties that render a single colormap row from the
- * shipped sprite. Vertically scales the sprite so each 1-pixel row fills
- * the container's full height, then offsets to land on the requested layer.
- * Returns `undefined` for unknown ramp names so the caller can fall back.
- */
-export function spriteBackgroundStyle(name, heightPx) {
-    const index = COLORMAP_INDEX[name];
-    if (index === undefined)
-        return undefined;
-    const totalHeight = COLORMAP_SPRITE_LAYERS * heightPx;
-    const yOffset = index * heightPx;
-    return [
-        `background-image: url("${COLORMAP_SPRITE_URL}")`,
-        'background-repeat: no-repeat',
-        `background-size: 100% ${totalHeight}px`,
-        `background-position: 0 -${yOffset}px`
-    ].join('; ');
-}

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,
@@ -35,17 +35,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

@@ -51,7 +51,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 +60,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 +77,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',
@@ -88,7 +94,7 @@ 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',
@@ -104,7 +110,7 @@ function createLayerForResult(modules, result, layerId, onClick, onHover) {
     else {
         return new GeoArrowPolygonLayer({
             id: layerId,
-            data: table,
+            data: batch,
             getFillColor: fill,
             getLineColor: line,
             getLineWidth: 2,

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/{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
 // ---------------------------------------------------------------------------