@developmentseed/geotiff 0.3.0-beta.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Development Seed
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,125 @@
+# @developmentseed/geotiff
+
+Fast, high-level GeoTIFF reader written in TypeScript for the browser, wrapping [`@cogeotiff/core`][cogeotiff-lib].
+
+[cogeotiff-lib]: https://github.com/blacha/cogeotiff
+
+## Features
+
+### Easy access to COG tiles
+
+Use `GeoTIFF.fetchTile` to load `Tile` instances.
+
+```ts
+import { GeoTIFF } from "@developmentseed/geotiff";
+
+// RGB Sentinel-2 image over NYC
+const url = "https://sentinel-cogs.s3.us-west-2.amazonaws.com/sentinel-s2-l2a-cogs/18/T/WL/2026/1/S2B_18TWL_20260101_0_L2A/TCI.tif"
+const geotiff = await GeoTIFF.fromUrl(url);
+
+// Read full-resolution tile from bottom right of image.
+// tile ordering starts at top left.
+const tile = await geotiff.fetchTile(10, 10);
+const {
+    x, // 10
+    y, // 10
+} = tile;
+
+// tile.array holds data & relevant metadata
+const {
+    data, // Uint8Array(3145728) [49,  51,  46,  42, ...]
+    count, // 3 (RGB)
+    height, // 1024
+    width, // 1024
+    transform, // [ 10, 0, 602380, 0, -10, 4497620 ]
+    crs, // 32618 (EPSG code)
+    mask, // null
+    nodata, // 0
+} = tile.array;
+```
+
+### Convenient access to overviews
+
+The `.overviews` attribute on `GeoTIFF` contains an array of reduced-resolution overviews, ordered from highest to lowest resolution. Use these to fetch tiles at your desired resolution.
+
+```ts
+const geotiff = await GeoTIFF.fromUrl("https://example.com/image.tif");
+// Read from the first overview
+// (the next-highest resolution after the full-resolution image)
+const overview = geotiff.overviews[0];
+// Read top-left tile of the overview
+const tile = await overview.fetchTile(0, 0);
+```
+
+### Automatic Nodata Mask handling
+
+With a library like `geotiff.js` or the underlying `@cogeotiff/core`, you have to do extra work to keep track of which of the internal images represent _data_ versus _masks_. We automatically handle nodata values and mask arrays.
+
+### Easy CRS handling
+
+GeoTIFFs can be defined either by an integer EPSG code or by a user-defined CRS.
+
+For integer EPSG codes, the `GeoTIFF.crs` method returns the integer directly, allowing downstream applications to decide how to resolve the EPSG code into WKT or PROJJSON formats (e.g. by querying `https://epsg.io`).
+
+For user-defined CRSes, we automatically parse the CRS into a PROJJSON object, which can be passed directly into `proj4js`. This is natively implemented **without a large cache of PROJ data**. This avoids the need for a large additional dependency like [`geotiff-geokeys-to-proj4`], which would otherwise add 1.5MB to your bundle.
+
+[`geotiff-geokeys-to-proj4`]: https://github.com/matafokka/geotiff-geokeys-to-proj4
+
+If you have an image where the CRS fails to parse, please create an issue.
+
+### Dynamically load compressions as needed
+
+Instead of bundling support for all compressions out of the box, dynamically load the decompressors as required.
+
+Until you try to load an image compressed with, say, [LERC], you don't pay for the bundle size of the dependency.
+
+[LERC]: https://github.com/Esri/lerc
+
+### Full user control over caching and chunking
+
+There are a lot of great utilities in [`chunkd`](https://github.com/blacha/chunkd) that work out of the box here.
+
+```ts
+import { SourceCache, SourceChunk } from '@chunkd/middleware';
+import { SourceView } from '@chunkd/source';
+import { SourceHttp } from '@chunkd/source-http';
+import { GeoTIFF } from '@developmentseed/geotiff';
+
+// 16MB Cache
+const cache = new SourceCache({ size: 16 * 1024 * 1024 });
+
+// Chunk requests into 16KB fetches
+const chunk = new SourceChunk({ size: 16 * 1024 });
+
+// Raw source to HTTP file
+const httpSource = new SourceHttp('https://blayne.chard.com/world.webp.google.cog.tiff');
+
+// HTTP source with chunking and caching
+const tiffSource = new SourceView(httpSource, [chunk, cache]);
+const geotiff = await GeoTIFF.open(tiffSource);
+const tile = await geotiff.fetchTile(0, 0);
+```
+
+### Nearly-identical API to Python `async-geotiff`
+
+The TypeScript API is nearly identical to our Python project [`async-geotiff`].
+
+This is extremely useful for us as we build visualization projects for both Python and the browser.
+
+[`async-geotiff`]: https://github.com/developmentseed/async-geotiff
+
+## Why not build on top of geotiff.js?
+
+The initial implementation of deck.gl-raster used [geotiff.js], and geotiff.js was great for quickly getting started. But there's a few reasons why this project switched to [`@cogeotiff/core`][cogeotiff-lib].
+
+[geotiff.js]: https://geotiffjs.github.io/
+
+- **Fully typed**: `@cogeotiff/core` is fully typed in expressive TypeScript, making it much more enjoyable to build on top of. Even the low-level
+- `@cogeotiff/core` implements a bunch of optimizations, like reading [_and utilizing_](https://github.com/blacha/cogeotiff/blob/4781a6375adf419da9f0319d15c8a67284dfb0c4/packages/core/src/tiff.image.ts#L566-L572) the [GDAL "ghost header"](https://gdal.org/en/stable/drivers/raster/cog.html#header-ghost-area) out of the box. In contrast, geotiff.js [can parse](https://github.com/geotiffjs/geotiff.js/blob/ae88c5e8d7b254cdd86d84fcd50254863663980d/src/geotiff.js#L529) but won't automatically use the ghost values.
+- **Project scope**: geotiff.js has a _lot_ of code unrelated to the needs of deck.gl-raster. All we need here is really efficient access to individual tiles from the COG. geotiff.js has a bunch of features we don't need: resampling, tile-merging, conversion to RGB, overview choice based on a target resolution, or writing GeoTIFFs.
+- **Complexity**: this is subjective. Overall geotiff.js seems to be... fine. But there are various parts of geotiff.js that give me pause. Vendoring a full 1000-line JPEG decoder? Perhaps this is because they need to support JPEG decoding in Node as well (points to differences in project scopes), but it doesn't give me confidence that I could fix a problem there if I had to.
+- **Confidence to build on top of**: this is subjective, but geotiff.js doesn't feel focused, like the way that `@cogeotiff/core` is very focused on its targeted, narrow API.
+- **JSDoc is hard to read and contribute to**: this is very subjective, but I find it _much_ harder to read and contribute to geotiff.js code written with [JSDoc](https://jsdoc.app/) instead of pure TypeScript.
+- **Code quality**: there are various parts of geotiff.js with code just... [commented out](https://github.com/geotiffjs/geotiff.js/blob/ae88c5e8d7b254cdd86d84fcd50254863663980d/src/geotiffimage.js#L161-L174). And the function has [no documentation](https://github.com/geotiffjs/geotiff.js/blob/ae88c5e8d7b254cdd86d84fcd50254863663980d/src/geotiffimage.js#L100-L110). Why is it normalizing? The [`needsNormalization` function](https://github.com/geotiffjs/geotiff.js/blob/ae88c5e8d7b254cdd86d84fcd50254863663980d/src/geotiffimage.js#L86-L98) also has no documentation, and is hard to understand what the equality is checking because it doesn't use TypeScript-standard enums, which would make the code itself readable.
+
+Overall, geotiff.js seems like a fine library, and it was useful to get started with to prove my proof of concept quickly. But if I'm building an entire stack on top of a COG reader, I need to have a huge amount of confidence on what I'm building on, and `@cogeotiff/core` gives that confidence.

package/dist/api.d.ts

@@ -0,0 +1,34 @@
+import type { PlanarConfiguration } from "@cogeotiff/core";
+import { Compression, SampleFormat } from "@cogeotiff/core";
+import type { RasterTypedArray } from "./array.js";
+import type { Predictor } from "./ifd.js";
+/** The result of a decoding process */
+export type DecodedPixels = {
+    layout: "pixel-interleaved";
+    data: RasterTypedArray;
+} | {
+    layout: "band-separate";
+    bands: RasterTypedArray[];
+};
+/** Metadata from the TIFF IFD, passed to decoders that need it. */
+export type DecoderMetadata = {
+    sampleFormat: SampleFormat;
+    bitsPerSample: number;
+    samplesPerPixel: number;
+    width: number;
+    height: number;
+    predictor: Predictor;
+    planarConfiguration: PlanarConfiguration;
+};
+/**
+ * A decoder returns either:
+ * - An ArrayBuffer of raw decompressed bytes (byte-level codecs like deflate, zstd)
+ * - A DecodedPixels with typed pixel data (image codecs like LERC, JPEG)
+ */
+export type Decoder = (bytes: ArrayBuffer, metadata: DecoderMetadata) => Promise<ArrayBuffer | DecodedPixels>;
+export declare const registry: Map<Compression, () => Promise<Decoder>>;
+/**
+ * Decode a tile's bytes according to its compression and image metadata.
+ */
+export declare function decode(bytes: ArrayBuffer, compression: Compression, metadata: DecoderMetadata): Promise<DecodedPixels>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAGnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,uCAAuC;AACvC,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAE3D,mEAAmE;AACnE,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,YAAY,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,SAAS,CAAC;IACrB,mBAAmB,EAAE,mBAAmB,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,OAAO,GAAG,CACpB,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,eAAe,KACtB,OAAO,CAAC,WAAW,GAAG,aAAa,CAAC,CAAC;AAM1C,eAAO,MAAM,QAAQ,yBAA8B,OAAO,CAAC,OAAO,CAAC,CAAG,CAAC;AA4BvE;;GAEG;AACH,wBAAsB,MAAM,CAC1B,KAAK,EAAE,WAAW,EAClB,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,CAAC,CAkCxB"}

package/dist/api.js

@@ -0,0 +1,84 @@
+import { Compression, SampleFormat } from "@cogeotiff/core";
+import { decode as decodeViaCanvas } from "./codecs/canvas.js";
+import { applyPredictor } from "./codecs/predictor.js";
+async function decodeUncompressed(bytes) {
+    return bytes;
+}
+export const registry = new Map();
+registry.set(Compression.None, () => Promise.resolve(decodeUncompressed));
+registry.set(Compression.Deflate, () => import("./codecs/deflate.js").then((m) => m.decode));
+registry.set(Compression.DeflateOther, () => import("./codecs/deflate.js").then((m) => m.decode));
+registry.set(Compression.Lzw, () => import("./codecs/lzw.js").then((m) => m.decode));
+// registry.set(Compression.Zstd, () =>
+//   import("../codecs/zstd.js").then((m) => m.decode),
+// );
+// registry.set(Compression.Lzma, () =>
+//   import("../codecs/lzma.js").then((m) => m.decode),
+// );
+// registry.set(Compression.Jp2000, () =>
+//   import("../codecs/jp2000.js").then((m) => m.decode),
+// );
+registry.set(Compression.Jpeg, () => Promise.resolve(decodeViaCanvas));
+registry.set(Compression.Jpeg6, () => Promise.resolve(decodeViaCanvas));
+registry.set(Compression.Webp, () => Promise.resolve(decodeViaCanvas));
+registry.set(Compression.Lerc, () => import("./codecs/lerc.js").then((m) => m.decode));
+/**
+ * Decode a tile's bytes according to its compression and image metadata.
+ */
+export async function decode(bytes, compression, metadata) {
+    const loader = registry.get(compression);
+    if (!loader) {
+        throw new Error(`Unsupported compression: ${compression}`);
+    }
+    const decoder = await loader();
+    const result = await decoder(bytes, metadata);
+    if (result instanceof ArrayBuffer) {
+        const { predictor, width, height, bitsPerSample, samplesPerPixel, planarConfiguration, } = metadata;
+        const predicted = applyPredictor(result, predictor, width, height, bitsPerSample, samplesPerPixel, planarConfiguration);
+        return {
+            layout: "pixel-interleaved",
+            data: toTypedArray(predicted, metadata),
+        };
+    }
+    return result;
+}
+/**
+ * Convert a raw ArrayBuffer of pixel data into a typed array based on the
+ * sample format and bits per sample. This is used for codecs that return raw
+ * bytes.
+ */
+function toTypedArray(buffer, metadata) {
+    const { sampleFormat, bitsPerSample } = metadata;
+    switch (sampleFormat) {
+        case SampleFormat.Uint:
+            switch (bitsPerSample) {
+                case 8:
+                    return new Uint8Array(buffer);
+                case 16:
+                    return new Uint16Array(buffer);
+                case 32:
+                    return new Uint32Array(buffer);
+            }
+            break;
+        case SampleFormat.Int:
+            switch (bitsPerSample) {
+                case 8:
+                    return new Int8Array(buffer);
+                case 16:
+                    return new Int16Array(buffer);
+                case 32:
+                    return new Int32Array(buffer);
+            }
+            break;
+        case SampleFormat.Float:
+            switch (bitsPerSample) {
+                case 32:
+                    return new Float32Array(buffer);
+                case 64:
+                    return new Float64Array(buffer);
+            }
+            break;
+    }
+    throw new Error(`Unsupported sample format/depth: SampleFormat=${sampleFormat}, BitsPerSample=${bitsPerSample}`);
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/array.d.ts

@@ -0,0 +1,75 @@
+import type { Affine } from "@developmentseed/affine";
+import type { ProjJson } from "./crs.js";
+/** Typed arrays supported for raster sample storage. */
+export type RasterTypedArray = Int8Array | Uint8Array | Uint8ClampedArray | Int16Array | Uint16Array | Int32Array | Uint32Array | Float32Array | Float64Array;
+/** Common metadata shared by all raster layouts. */
+type RasterArrayBase = {
+    /** Number of bands (samples per pixel). */
+    count: number;
+    /** Height in pixels. */
+    height: number;
+    /** Width in pixels. */
+    width: number;
+    /**
+     * Optional validity mask.  Length = height * width.
+     * 1 = valid pixel, 0 = nodata.  null when no mask IFD is present.
+     */
+    mask: Uint8Array | null;
+    /**
+     * Affine geotransform [a, b, c, d, e, f] mapping pixel (col, row) to
+     * geographic (x, y):
+     *   x = a * col + b * row + c
+     *   y = d * col + e * row + f
+     */
+    transform: Affine;
+    crs: number | ProjJson;
+    nodata: number | null;
+};
+/** Raster stored in one typed array per band (band-major / planar). */
+export type BandRasterArray = RasterArrayBase & {
+    layout: "band-separate";
+    /**
+     * One typed array per band, each length = width * height.
+     *
+     * This is the preferred representation when uploading one texture per band.
+     */
+    bands: RasterTypedArray[];
+};
+/** Raster stored in one pixel-interleaved typed array. */
+export type PixelRasterArray = RasterArrayBase & {
+    layout: "pixel-interleaved";
+    /**
+     * Pixel-interleaved raster data:
+     * [p00_band0, p00_band1, ..., p01_band0, ...]
+     *
+     * Length = width * height * count.
+     */
+    data: RasterTypedArray;
+};
+/** Decoded raster data from a GeoTIFF region. */
+export type RasterArray = BandRasterArray | PixelRasterArray;
+/** Options for packing band data to a 4-channel pixel-interleaved array. */
+export type PackBandsToRGBAOptions = {
+    /**
+     * Source band index for each RGBA output channel.
+     * Use null to write `fillValue` for that output channel.
+     */
+    order?: [number | null, number | null, number | null, number | null];
+    /** Fill value used when an output channel has no source band. */
+    fillValue?: number;
+};
+/** Convert any raster layout to a band-separate representation. */
+export declare function toBandSeparate(array: RasterArray): BandRasterArray;
+/** Convert any raster layout to a pixel-interleaved representation. */
+export declare function toPixelInterleaved(array: RasterArray, order?: readonly number[]): PixelRasterArray;
+/** Reorder bands while keeping a band-separate representation. */
+export declare function reorderBands(array: RasterArray, order: readonly number[]): BandRasterArray;
+/**
+ * Pack selected source bands into an RGBA pixel-interleaved typed array.
+ *
+ * This is useful as a fallback path when a single 4-channel texture upload
+ * is preferred over one texture per band.
+ */
+export declare function packBandsToRGBA(array: RasterArray, options?: PackBandsToRGBAOptions): PixelRasterArray;
+export {};
+//# sourceMappingURL=array.d.ts.map

package/dist/array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"array.d.ts","sourceRoot":"","sources":["../src/array.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC,wDAAwD;AACxD,MAAM,MAAM,gBAAgB,GACxB,SAAS,GACT,UAAU,GACV,iBAAiB,GACjB,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,GACX,YAAY,GACZ,YAAY,CAAC;AAEjB,oDAAoD;AACpD,KAAK,eAAe,GAAG;IACrB,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IAEf,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IAExB;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC;IAEvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG;IAC9C,MAAM,EAAE,eAAe,CAAC;IACxB;;;;OAIG;IACH,KAAK,EAAE,gBAAgB,EAAE,CAAC;CAC3B,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,eAAe,GAAG;IAC/C,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;;;;OAKG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,MAAM,sBAAsB,GAAG;IACnC;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACrE,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,eAAe,CA4BlE;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAClB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,GACxB,gBAAgB,CAqClB;AAED,kEAAkE;AAClE,wBAAgB,YAAY,CAC1B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,eAAe,CASjB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,WAAW,EAClB,OAAO,GAAE,sBAA2B,GACnC,gBAAgB,CA2BlB"}

package/dist/array.js

@@ -0,0 +1,141 @@
+/** Convert any raster layout to a band-separate representation. */
+export function toBandSeparate(array) {
+    validateRasterShape(array);
+    if (array.layout === "band-separate") {
+        return array;
+    }
+    const sampleCount = array.width * array.height;
+    const bands = new Array(array.count);
+    const Ctor = array.data.constructor;
+    for (let b = 0; b < array.count; b++) {
+        bands[b] = new Ctor(sampleCount);
+    }
+    for (let i = 0; i < sampleCount; i++) {
+        const base = i * array.count;
+        for (let b = 0; b < array.count; b++) {
+            bands[b][i] = array.data[base + b];
+        }
+    }
+    return {
+        ...array,
+        layout: "band-separate",
+        bands,
+    };
+}
+/** Convert any raster layout to a pixel-interleaved representation. */
+export function toPixelInterleaved(array, order) {
+    validateRasterShape(array);
+    const defaultOrder = Array.from({ length: array.count }, (_, i) => i);
+    const bandOrder = order ?? defaultOrder;
+    validateBandOrder(bandOrder, array.count);
+    const sampleCount = array.width * array.height;
+    if (array.layout === "pixel-interleaved" && isIdentityOrder(bandOrder)) {
+        return array;
+    }
+    const Ctor = (array.layout === "pixel-interleaved"
+        ? array.data.constructor
+        : array.bands[0].constructor);
+    const data = new Ctor(sampleCount * bandOrder.length);
+    const bandSource = toBandSeparate(array).bands;
+    for (let i = 0; i < sampleCount; i++) {
+        const outBase = i * bandOrder.length;
+        for (let c = 0; c < bandOrder.length; c++) {
+            data[outBase + c] = bandSource[bandOrder[c]][i];
+        }
+    }
+    return {
+        ...array,
+        layout: "pixel-interleaved",
+        count: bandOrder.length,
+        data,
+    };
+}
+/** Reorder bands while keeping a band-separate representation. */
+export function reorderBands(array, order) {
+    validateRasterShape(array);
+    validateBandOrder(order, array.count);
+    const src = toBandSeparate(array);
+    return {
+        ...src,
+        count: order.length,
+        bands: order.map((bandIndex) => src.bands[bandIndex]),
+    };
+}
+/**
+ * Pack selected source bands into an RGBA pixel-interleaved typed array.
+ *
+ * This is useful as a fallback path when a single 4-channel texture upload
+ * is preferred over one texture per band.
+ */
+export function packBandsToRGBA(array, options = {}) {
+    const order = options.order ?? [0, 1, 2, null];
+    const fillValue = options.fillValue ?? 0;
+    validateRasterShape(array);
+    const src = toBandSeparate(array);
+    const sampleCount = src.width * src.height;
+    const Ctor = src.bands[0].constructor;
+    const data = new Ctor(sampleCount * 4);
+    for (let i = 0; i < sampleCount; i++) {
+        const outBase = i * 4;
+        for (let c = 0; c < 4; c++) {
+            const bandIndex = order[c];
+            data[outBase + c] =
+                bandIndex == null ? fillValue : src.bands[bandIndex][i];
+        }
+    }
+    return {
+        ...src,
+        layout: "pixel-interleaved",
+        count: 4,
+        data,
+    };
+}
+function validateBandOrder(order, count) {
+    if (order.length === 0) {
+        throw new Error("Band order must include at least one channel");
+    }
+    for (const bandIndex of order) {
+        if (!Number.isInteger(bandIndex)) {
+            throw new Error(`Band index must be an integer: ${String(bandIndex)}`);
+        }
+        if (bandIndex < 0 || bandIndex >= count) {
+            throw new Error(`Band index ${bandIndex} is out of range for ${count} band(s)`);
+        }
+    }
+}
+function validateRasterShape(array) {
+    if (array.width <= 0 || array.height <= 0) {
+        throw new Error("Raster width and height must be positive");
+    }
+    if (array.count <= 0) {
+        throw new Error("Raster count must be positive");
+    }
+    const sampleCount = array.width * array.height;
+    const expectedMaskLength = sampleCount;
+    if (array.mask != null && array.mask.length !== expectedMaskLength) {
+        throw new Error(`Mask length ${array.mask.length} does not match width * height (${expectedMaskLength})`);
+    }
+    if (array.layout === "band-separate") {
+        if (array.bands.length !== array.count) {
+            throw new Error(`Band count mismatch: bands.length=${array.bands.length}, count=${array.count}`);
+        }
+        for (const [index, band] of array.bands.entries()) {
+            if (band.length !== sampleCount) {
+                throw new Error(`Band ${index} length ${band.length} does not match width * height (${sampleCount})`);
+            }
+        }
+        return;
+    }
+    const expectedDataLength = sampleCount * array.count;
+    if (array.data.length !== expectedDataLength) {
+        throw new Error(`Data length ${array.data.length} does not match width * height * count (${expectedDataLength})`);
+    }
+}
+function isIdentityOrder(order) {
+    for (let i = 0; i < order.length; i++) {
+        if (order[i] !== i)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=array.js.map

package/dist/array.js.map

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

package/dist/codecs/canvas.d.ts

@@ -0,0 +1,3 @@
+import type { DecodedPixels, DecoderMetadata } from "../decode.js";
+export declare function decode(bytes: ArrayBuffer, metadata: DecoderMetadata): Promise<DecodedPixels>;
+//# sourceMappingURL=canvas.d.ts.map

package/dist/codecs/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/codecs/canvas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAOnE,wBAAsB,MAAM,CAC1B,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,aAAa,CAAC,CA8BxB"}

package/dist/codecs/canvas.js

@@ -0,0 +1,32 @@
+// TODO: in the future, have an API that returns an ImageBitmap directly from
+// the decoder, to avoid copying pixel data from GPU -> CPU memory
+// Then deck.gl could use the ImageBitmap directly as a texture source without
+// copying again from CPU -> GPU memory
+// https://github.com/developmentseed/deck.gl-raster/issues/228
+export async function decode(bytes, metadata) {
+    const blob = new Blob([bytes]);
+    const imageBitmap = await createImageBitmap(blob);
+    const canvas = new OffscreenCanvas(imageBitmap.width, imageBitmap.height);
+    const ctx = canvas.getContext("2d");
+    ctx.drawImage(imageBitmap, 0, 0);
+    imageBitmap.close();
+    const { width, height } = canvas;
+    const imageData = ctx.getImageData(0, 0, width, height);
+    const rgba = imageData.data;
+    const samplesPerPixel = metadata.samplesPerPixel;
+    if (samplesPerPixel === 4) {
+        return { layout: "pixel-interleaved", data: rgba };
+    }
+    if (samplesPerPixel === 3) {
+        const pixelCount = width * height;
+        const rgb = new Uint8ClampedArray(pixelCount * 3);
+        for (let i = 0, j = 0; i < rgb.length; i += 3, j += 4) {
+            rgb[i] = rgba[j];
+            rgb[i + 1] = rgba[j + 1];
+            rgb[i + 2] = rgba[j + 2];
+        }
+        return { layout: "pixel-interleaved", data: rgb };
+    }
+    throw new Error(`Unsupported SamplesPerPixel for JPEG: ${samplesPerPixel}`);
+}
+//# sourceMappingURL=canvas.js.map

package/dist/codecs/canvas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.js","sourceRoot":"","sources":["../../src/codecs/canvas.ts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,kEAAkE;AAClE,8EAA8E;AAC9E,uCAAuC;AACvC,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,KAAkB,EAClB,QAAyB;IAEzB,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,WAAW,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC;IACrC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,WAAW,CAAC,KAAK,EAAE,CAAC;IAEpB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IACjC,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;IAE5B,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,CAAC;IACjD,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,eAAe,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;QAClC,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACtD,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAE,CAAC;YAClB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;YAC1B,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAE,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IACpD,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,yCAAyC,eAAe,EAAE,CAAC,CAAC;AAC9E,CAAC"}

package/dist/codecs/decompression-stream.d.ts

@@ -0,0 +1,6 @@
+export declare function assert(expression: unknown, msg?: string | undefined): asserts expression;
+export declare function decompressWithDecompressionStream(data: ArrayBuffer | Response, { format, signal }: {
+    format: CompressionFormat;
+    signal?: AbortSignal;
+}): Promise<ArrayBuffer>;
+//# sourceMappingURL=decompression-stream.d.ts.map

package/dist/codecs/decompression-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompression-stream.d.ts","sourceRoot":"","sources":["../../src/codecs/decompression-stream.ts"],"names":[],"mappings":"AAAA,wBAAgB,MAAM,CACpB,UAAU,EAAE,OAAO,EACnB,GAAG,GAAE,MAAM,GAAG,SAAc,GAC3B,OAAO,CAAC,UAAU,CAIpB;AAED,wBAAsB,iCAAiC,CACrD,IAAI,EAAE,WAAW,GAAG,QAAQ,EAC5B,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACtE,OAAO,CAAC,WAAW,CAAC,CAatB"}

package/dist/codecs/decompression-stream.js

@@ -0,0 +1,19 @@
+export function assert(expression, msg = "") {
+    if (!expression) {
+        throw new Error(msg);
+    }
+}
+export async function decompressWithDecompressionStream(data, { format, signal }) {
+    const response = data instanceof Response ? data : new Response(data);
+    assert(response.body, "Response does not contain body.");
+    try {
+        const decompressedResponse = new Response(response.body.pipeThrough(new DecompressionStream(format), { signal }));
+        const buffer = await decompressedResponse.arrayBuffer();
+        return buffer;
+    }
+    catch {
+        signal?.throwIfAborted();
+        throw new Error(`Failed to decode ${format}`);
+    }
+}
+//# sourceMappingURL=decompression-stream.js.map

package/dist/codecs/decompression-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decompression-stream.js","sourceRoot":"","sources":["../../src/codecs/decompression-stream.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,MAAM,CACpB,UAAmB,EACnB,MAA0B,EAAE;IAE5B,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CACrD,IAA4B,EAC5B,EAAE,MAAM,EAAE,MAAM,EAAuD;IAEvE,MAAM,QAAQ,GAAG,IAAI,YAAY,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IACtE,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,IAAI,QAAQ,CACvC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CACvE,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,WAAW,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,EAAE,cAAc,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oBAAoB,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/codecs/deflate.d.ts

@@ -0,0 +1,2 @@
+export declare function decode(bytes: ArrayBuffer): Promise<ArrayBuffer>;
+//# sourceMappingURL=deflate.d.ts.map

package/dist/codecs/deflate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deflate.d.ts","sourceRoot":"","sources":["../../src/codecs/deflate.ts"],"names":[],"mappings":"AAEA,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAErE"}

package/dist/codecs/deflate.js

@@ -0,0 +1,5 @@
+import { decompressWithDecompressionStream } from "./decompression-stream.js";
+export async function decode(bytes) {
+    return decompressWithDecompressionStream(bytes, { format: "deflate" });
+}
+//# sourceMappingURL=deflate.js.map

package/dist/codecs/deflate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deflate.js","sourceRoot":"","sources":["../../src/codecs/deflate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,MAAM,2BAA2B,CAAC;AAE9E,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAAkB;IAC7C,OAAO,iCAAiC,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AACzE,CAAC"}

package/dist/codecs/lerc.d.ts

@@ -0,0 +1,3 @@
+import type { DecodedPixels } from "../decode.js";
+export declare function decode(bytes: ArrayBuffer): Promise<DecodedPixels>;
+//# sourceMappingURL=lerc.d.ts.map

package/dist/codecs/lerc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lerc.d.ts","sourceRoot":"","sources":["../../src/codecs/lerc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAgBlD,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAIvE"}

package/dist/codecs/lerc.js

@@ -0,0 +1,16 @@
+let wasmInitialized = false;
+async function getLerc() {
+    // This import is cached by the module loader
+    const lerc = await import("lerc");
+    if (!wasmInitialized) {
+        await lerc.load();
+        wasmInitialized = true;
+    }
+    return lerc;
+}
+export async function decode(bytes) {
+    const lerc = await getLerc();
+    const result = lerc.decode(bytes);
+    return { layout: "band-separate", bands: result.pixels };
+}
+//# sourceMappingURL=lerc.js.map