@developmentseed/deck.gl-raster 0.5.0-beta.1 → 0.6.0-alpha.1

package/dist/gpu-modules/colormap-names.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Mapping from matplotlib / rio-tiler colormap name to its layer index in
+ * the shipped `colormaps.png` sprite. Pass values from this object as the
+ * `colormapIndex` prop of the {@link Colormap} shader module:
+ *
+ * ```ts
+ * { module: Colormap, props: {
+ *     colormapTexture,
+ *     colormapIndex: COLORMAP_INDEX.viridis,
+ *   } }
+ * ```
+ *
+ * Names are sorted alphabetically. Reversed variants (`_r` suffix) are not
+ * listed separately — use the module's `reversed` uniform to flip a
+ * colormap at render time instead of binding a distinct layer.
+ */
+export declare const COLORMAP_INDEX: {
+    readonly accent: 0;
+    readonly afmhot: 1;
+    readonly algae: 2;
+    readonly amp: 3;
+    readonly autumn: 4;
+    readonly balance: 5;
+    readonly binary: 6;
+    readonly blues: 7;
+    readonly bone: 8;
+    readonly brbg: 9;
+    readonly brg: 10;
+    readonly bugn: 11;
+    readonly bupu: 12;
+    readonly bwr: 13;
+    readonly cfastie: 14;
+    readonly cividis: 15;
+    readonly cmrmap: 16;
+    readonly cool: 17;
+    readonly coolwarm: 18;
+    readonly copper: 19;
+    readonly cubehelix: 20;
+    readonly curl: 21;
+    readonly dark2: 22;
+    readonly deep: 23;
+    readonly delta: 24;
+    readonly dense: 25;
+    readonly diff: 26;
+    readonly flag: 27;
+    readonly gist_earth: 28;
+    readonly gist_gray: 29;
+    readonly gist_heat: 30;
+    readonly gist_ncar: 31;
+    readonly gist_rainbow: 32;
+    readonly gist_stern: 33;
+    readonly gist_yarg: 34;
+    readonly gnbu: 35;
+    readonly gnuplot: 36;
+    readonly gnuplot2: 37;
+    readonly gray: 38;
+    readonly greens: 39;
+    readonly greys: 40;
+    readonly haline: 41;
+    readonly hot: 42;
+    readonly hsv: 43;
+    readonly ice: 44;
+    readonly inferno: 45;
+    readonly jet: 46;
+    readonly magma: 47;
+    readonly matter: 48;
+    readonly nipy_spectral: 49;
+    readonly ocean: 50;
+    readonly oranges: 51;
+    readonly orrd: 52;
+    readonly oxy: 53;
+    readonly paired: 54;
+    readonly pastel1: 55;
+    readonly pastel2: 56;
+    readonly phase: 57;
+    readonly pink: 58;
+    readonly piyg: 59;
+    readonly plasma: 60;
+    readonly prgn: 61;
+    readonly prism: 62;
+    readonly pubu: 63;
+    readonly pubugn: 64;
+    readonly puor: 65;
+    readonly purd: 66;
+    readonly purples: 67;
+    readonly rain: 68;
+    readonly rainbow: 69;
+    readonly rdbu: 70;
+    readonly rdgy: 71;
+    readonly rdpu: 72;
+    readonly rdylbu: 73;
+    readonly rdylgn: 74;
+    readonly reds: 75;
+    readonly rplumbo: 76;
+    readonly schwarzwald: 77;
+    readonly seismic: 78;
+    readonly set1: 79;
+    readonly set2: 80;
+    readonly set3: 81;
+    readonly solar: 82;
+    readonly spectral: 83;
+    readonly speed: 84;
+    readonly spring: 85;
+    readonly summer: 86;
+    readonly tab10: 87;
+    readonly tab20: 88;
+    readonly tab20b: 89;
+    readonly tab20c: 90;
+    readonly tarn: 91;
+    readonly tempo: 92;
+    readonly terrain: 93;
+    readonly thermal: 94;
+    readonly topo: 95;
+    readonly turbid: 96;
+    readonly turbo: 97;
+    readonly twilight: 98;
+    readonly twilight_shifted: 99;
+    readonly viridis: 100;
+    readonly winter: 101;
+    readonly wistia: 102;
+    readonly ylgn: 103;
+    readonly ylgnbu: 104;
+    readonly ylorbr: 105;
+    readonly ylorrd: 106;
+};
+/** Name of any colormap in the shipped sprite; a key of {@link COLORMAP_INDEX}. */
+export type ColormapName = keyof typeof COLORMAP_INDEX;
+//# sourceMappingURL=colormap-names.d.ts.map

package/dist/gpu-modules/colormap-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colormap-names.d.ts","sourceRoot":"","sources":["../../src/gpu-modules/colormap-names.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4GjB,CAAC;AAEX,mFAAmF;AACnF,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,cAAc,CAAC"}

package/dist/gpu-modules/colormap-names.js

@@ -0,0 +1,127 @@
+// Generated by scripts/generate_colormaps.py. Do not edit by hand.
+/**
+ * Mapping from matplotlib / rio-tiler colormap name to its layer index in
+ * the shipped `colormaps.png` sprite. Pass values from this object as the
+ * `colormapIndex` prop of the {@link Colormap} shader module:
+ *
+ * ```ts
+ * { module: Colormap, props: {
+ *     colormapTexture,
+ *     colormapIndex: COLORMAP_INDEX.viridis,
+ *   } }
+ * ```
+ *
+ * Names are sorted alphabetically. Reversed variants (`_r` suffix) are not
+ * listed separately — use the module's `reversed` uniform to flip a
+ * colormap at render time instead of binding a distinct layer.
+ */
+export const COLORMAP_INDEX = {
+    accent: 0,
+    afmhot: 1,
+    algae: 2,
+    amp: 3,
+    autumn: 4,
+    balance: 5,
+    binary: 6,
+    blues: 7,
+    bone: 8,
+    brbg: 9,
+    brg: 10,
+    bugn: 11,
+    bupu: 12,
+    bwr: 13,
+    cfastie: 14,
+    cividis: 15,
+    cmrmap: 16,
+    cool: 17,
+    coolwarm: 18,
+    copper: 19,
+    cubehelix: 20,
+    curl: 21,
+    dark2: 22,
+    deep: 23,
+    delta: 24,
+    dense: 25,
+    diff: 26,
+    flag: 27,
+    gist_earth: 28,
+    gist_gray: 29,
+    gist_heat: 30,
+    gist_ncar: 31,
+    gist_rainbow: 32,
+    gist_stern: 33,
+    gist_yarg: 34,
+    gnbu: 35,
+    gnuplot: 36,
+    gnuplot2: 37,
+    gray: 38,
+    greens: 39,
+    greys: 40,
+    haline: 41,
+    hot: 42,
+    hsv: 43,
+    ice: 44,
+    inferno: 45,
+    jet: 46,
+    magma: 47,
+    matter: 48,
+    nipy_spectral: 49,
+    ocean: 50,
+    oranges: 51,
+    orrd: 52,
+    oxy: 53,
+    paired: 54,
+    pastel1: 55,
+    pastel2: 56,
+    phase: 57,
+    pink: 58,
+    piyg: 59,
+    plasma: 60,
+    prgn: 61,
+    prism: 62,
+    pubu: 63,
+    pubugn: 64,
+    puor: 65,
+    purd: 66,
+    purples: 67,
+    rain: 68,
+    rainbow: 69,
+    rdbu: 70,
+    rdgy: 71,
+    rdpu: 72,
+    rdylbu: 73,
+    rdylgn: 74,
+    reds: 75,
+    rplumbo: 76,
+    schwarzwald: 77,
+    seismic: 78,
+    set1: 79,
+    set2: 80,
+    set3: 81,
+    solar: 82,
+    spectral: 83,
+    speed: 84,
+    spring: 85,
+    summer: 86,
+    tab10: 87,
+    tab20: 88,
+    tab20b: 89,
+    tab20c: 90,
+    tarn: 91,
+    tempo: 92,
+    terrain: 93,
+    thermal: 94,
+    topo: 95,
+    turbid: 96,
+    turbo: 97,
+    twilight: 98,
+    twilight_shifted: 99,
+    viridis: 100,
+    winter: 101,
+    wistia: 102,
+    ylgn: 103,
+    ylgnbu: 104,
+    ylorbr: 105,
+    ylorrd: 106,
+};
+//# sourceMappingURL=colormap-names.js.map

package/dist/gpu-modules/colormap-names.js.map

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

package/dist/gpu-modules/colormap.d.ts

@@ -1,19 +1,43 @@
 import type { Texture } from "@luma.gl/core";
+/** Props for the {@link Colormap} shader module. */
 export type ColormapProps = {
+    /**
+     * The colormap sprite as a 2D array texture. Each layer of the array is
+     * one 256×1 RGBA8 colormap. Build from the shipped `colormaps.png` with
+     * `decodeColormapSprite` + `createColormapTexture`, or bring your own.
+     */
     colormapTexture: Texture;
+    /**
+     * Which layer of `colormapTexture` to sample. Pass values from the
+     * generated `COLORMAP_INDEX` for the shipped sprite, or any valid layer
+     * index for a custom sprite. Defaults to `0`.
+     */
+    colormapIndex?: number;
+    /**
+     * When true, samples the colormap in reverse — equivalent to matplotlib's
+     * `_r` suffix (e.g. `viridis_r`). Defaults to false.
+     */
+    reversed?: boolean;
 };
 /**
- * A shader module that injects a unorm texture and uses a sampler2D to assign
- * to a color.
+ * A shader module that injects a 2D-array colormap texture and samples one
+ * layer per fragment, indexed by `colormapIndex`.
  */
 export declare const Colormap: {
     readonly name: "colormap";
+    readonly fs: "uniform colormapUniforms {\n  int colormapIndex;\n  float reversed;\n} colormap;\n";
     readonly inject: {
-        readonly "fs:#decl": "uniform sampler2D colormapTexture;";
-        readonly "fs:DECKGL_FILTER_COLOR": "\n      color = texture(colormapTexture, vec2(color.r, 0.));\n    ";
+        readonly "fs:#decl": "uniform sampler2DArray colormapTexture;";
+        readonly "fs:DECKGL_FILTER_COLOR": "\n      float idx = mix(color.r, 1.0 - color.r, colormap.reversed);\n      color = texture(\n        colormapTexture,\n        vec3(idx, 0.5, float(colormap.colormapIndex))\n      );\n    ";
+    };
+    readonly uniformTypes: {
+        readonly colormapIndex: "i32";
+        readonly reversed: "f32";
     };
     readonly getUniforms: (props: Partial<ColormapProps>) => {
         colormapTexture: Texture | undefined;
+        colormapIndex: number;
+        reversed: boolean;
     };
 };
 //# sourceMappingURL=colormap.d.ts.map

package/dist/gpu-modules/colormap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"colormap.d.ts","sourceRoot":"","sources":["../../src/gpu-modules/colormap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;kCAQE,OAAO,CAAC,aAAa,CAAC;;;CAKG,CAAC"}
+{"version":3,"file":"colormap.d.ts","sourceRoot":"","sources":["../../src/gpu-modules/colormap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAG7C,oDAAoD;AACpD,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;OAIG;IACH,eAAe,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAIF;;;GAGG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;kCAsBE,OAAO,CAAC,aAAa,CAAC;;;;;CAOG,CAAC"}

package/dist/gpu-modules/colormap.js

@@ -1,18 +1,35 @@
+const MODULE_NAME = "colormap";
 /**
- * A shader module that injects a unorm texture and uses a sampler2D to assign
- * to a color.
+ * A shader module that injects a 2D-array colormap texture and samples one
+ * layer per fragment, indexed by `colormapIndex`.
  */
 export const Colormap = {
-    name: "colormap",
+    name: MODULE_NAME,
+    fs: `\
+uniform ${MODULE_NAME}Uniforms {
+  int colormapIndex;
+  float reversed;
+} ${MODULE_NAME};
+`,
     inject: {
-        "fs:#decl": `uniform sampler2D colormapTexture;`,
+        "fs:#decl": `uniform sampler2DArray colormapTexture;`,
         "fs:DECKGL_FILTER_COLOR": /* glsl */ `
-      color = texture(colormapTexture, vec2(color.r, 0.));
+      float idx = mix(color.r, 1.0 - color.r, ${MODULE_NAME}.reversed);
+      color = texture(
+        colormapTexture,
+        vec3(idx, 0.5, float(${MODULE_NAME}.colormapIndex))
+      );
     `,
     },
+    uniformTypes: {
+        colormapIndex: "i32",
+        reversed: "f32",
+    },
     getUniforms: (props) => {
         return {
             colormapTexture: props.colormapTexture,
+            colormapIndex: props.colormapIndex ?? 0,
+            reversed: props.reversed ?? false,
         };
     },
 };

package/dist/gpu-modules/colormap.js.map

@@ -1 +1 @@
-{"version":3,"file":"colormap.js","sourceRoot":"","sources":["../../src/gpu-modules/colormap.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE;QACN,UAAU,EAAE,oCAAoC;QAChD,wBAAwB,EAAE,UAAU,CAAC;;KAEpC;KACF;IACD,WAAW,EAAE,CAAC,KAA6B,EAAE,EAAE;QAC7C,OAAO;YACL,eAAe,EAAE,KAAK,CAAC,eAAe;SACvC,CAAC;IACJ,CAAC;CAC6C,CAAC"}
+{"version":3,"file":"colormap.js","sourceRoot":"","sources":["../../src/gpu-modules/colormap.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,IAAI,EAAE,WAAW;IACjB,EAAE,EAAE;UACI,WAAW;;;IAGjB,WAAW;CACd;IACC,MAAM,EAAE;QACN,UAAU,EAAE,yCAAyC;QACrD,wBAAwB,EAAE,UAAU,CAAC;gDACO,WAAW;;;+BAG5B,WAAW;;KAErC;KACF;IACD,YAAY,EAAE;QACZ,aAAa,EAAE,KAAK;QACpB,QAAQ,EAAE,KAAK;KAChB;IACD,WAAW,EAAE,CAAC,KAA6B,EAAE,EAAE;QAC7C,OAAO;YACL,eAAe,EAAE,KAAK,CAAC,eAAe;YACtC,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;YACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,KAAK;SAClC,CAAC;IACJ,CAAC;CAC6C,CAAC"}

package/dist/gpu-modules/composite-bands.d.ts

@@ -0,0 +1,85 @@
+import type { Texture } from "@luma.gl/core";
+import type { UvTransform } from "../multi-raster-tileset/index.js";
+/**
+ * Maximum number of band texture slots supported by {@link CompositeBands}.
+ */
+export declare const MAX_BAND_SLOTS = 4;
+/**
+ * Props for the {@link CompositeBands} shader module.
+ *
+ * Textures (`band0`–`band3`) are bound via `getUniforms`. Scalar uniforms
+ * (`uvTransform0`–`uvTransform3`, `channelMap`) go through a uniform block.
+ */
+export type CompositeBandsProps = {
+    band0: Texture;
+    band1: Texture;
+    band2: Texture;
+    band3: Texture;
+    uvTransform0: UvTransform;
+    uvTransform1: UvTransform;
+    uvTransform2: UvTransform;
+    uvTransform3: UvTransform;
+    channelMap: [number, number, number, number];
+};
+/**
+ * A shader module that samples up to 4 band textures with per-band UV
+ * transforms and composites them into a `vec4` color.
+ *
+ * Uses fixed uniform slots (`band0`–`band3`) for textures (bound via
+ * `getUniforms`) and a uniform block for scalar values (`uvTransform0`–
+ * `uvTransform3`, `channelMap`).
+ *
+ * @see {@link CompositeBandsProps}
+ * @see {@link buildCompositeBandsProps} for a helper that maps named bands
+ *   to slot indices.
+ */
+export declare const CompositeBands: {
+    readonly name: "compositeBands";
+    readonly inject: {
+        readonly "fs:#decl": "\nuniform sampler2D band0;\nuniform sampler2D band1;\nuniform sampler2D band2;\nuniform sampler2D band3;\n\nvec2 compositeBands_applyUv(vec2 uv, vec4 transform) {\n  return uv * transform.zw + transform.xy;\n}\n\nfloat compositeBands_sampleSlot(int slot, vec2 uv) {\n  if (slot == 0) return texture(band0, compositeBands_applyUv(uv, compositeBands.uvTransform0)).r;\n  if (slot == 1) return texture(band1, compositeBands_applyUv(uv, compositeBands.uvTransform1)).r;\n  if (slot == 2) return texture(band2, compositeBands_applyUv(uv, compositeBands.uvTransform2)).r;\n  if (slot == 3) return texture(band3, compositeBands_applyUv(uv, compositeBands.uvTransform3)).r;\n  return 0.0;\n}\n";
+        readonly "fs:DECKGL_FILTER_COLOR": "\n  float r = compositeBands.channelMap.r >= 0 ? compositeBands_sampleSlot(compositeBands.channelMap.r, geometry.uv) : 0.0;\n  float g = compositeBands.channelMap.g >= 0 ? compositeBands_sampleSlot(compositeBands.channelMap.g, geometry.uv) : 0.0;\n  float b = compositeBands.channelMap.b >= 0 ? compositeBands_sampleSlot(compositeBands.channelMap.b, geometry.uv) : 0.0;\n  float a = compositeBands.channelMap.a >= 0 ? compositeBands_sampleSlot(compositeBands.channelMap.a, geometry.uv) : 1.0;\n  color = vec4(r, g, b, a);\n";
+    };
+    readonly fs: "uniform compositeBandsUniforms {\n  vec4 uvTransform0;\n  vec4 uvTransform1;\n  vec4 uvTransform2;\n  vec4 uvTransform3;\n  ivec4 channelMap;\n} compositeBands;\n";
+    readonly uniformTypes: {
+        readonly uvTransform0: "vec4<f32>";
+        readonly uvTransform1: "vec4<f32>";
+        readonly uvTransform2: "vec4<f32>";
+        readonly uvTransform3: "vec4<f32>";
+        readonly channelMap: "vec4<i32>";
+    };
+    readonly getUniforms: (props: Partial<CompositeBandsProps>) => {
+        band0: Texture | undefined;
+        band1: Texture | undefined;
+        band2: Texture | undefined;
+        band3: Texture | undefined;
+        uvTransform0: UvTransform;
+        uvTransform1: UvTransform;
+        uvTransform2: UvTransform;
+        uvTransform3: UvTransform;
+        channelMap: [number, number, number, number];
+    };
+};
+/**
+ * Maps named bands and their UV transforms to {@link CompositeBandsProps}
+ * slot indices.
+ *
+ * Assigns each unique band name to a fixed slot (0–3), builds the
+ * `channelMap` that maps RGBA output channels to slots, and fills unused
+ * slots with a placeholder texture to satisfy WebGL binding requirements.
+ *
+ * @param mapping - Which named band goes to which RGBA channel.
+ * @param bands - Map of band name to texture + UV transform.
+ * @returns Props ready to pass to `{ module: CompositeBands, props: ... }`.
+ *
+ * @see {@link CompositeBands}
+ */
+export declare function buildCompositeBandsProps(mapping: {
+    r: string;
+    g?: string;
+    b?: string;
+    a?: string;
+}, bands: Map<string, {
+    texture: Texture;
+    uvTransform: UvTransform;
+}>): Partial<CompositeBandsProps>;
+//# sourceMappingURL=composite-bands.d.ts.map

package/dist/gpu-modules/composite-bands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-bands.d.ts","sourceRoot":"","sources":["../../src/gpu-modules/composite-bands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;GAEG;AACH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,YAAY,EAAE,WAAW,CAAC;IAC1B,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9C,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;kCA+CJ,OAAO,CAAC,mBAAmB,CAAC;;;;;;;;;;;CAeG,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC1D,KAAK,EAAE,GAAG,CACR,MAAM,EACN;IACE,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,WAAW,CAAC;CAC1B,CACF,GACA,OAAO,CAAC,mBAAmB,CAAC,CAsD9B"}

package/dist/gpu-modules/composite-bands.js

@@ -0,0 +1,141 @@
+/**
+ * Maximum number of band texture slots supported by {@link CompositeBands}.
+ */
+export const MAX_BAND_SLOTS = 4;
+const MODULE_NAME = "compositeBands";
+/**
+ * A shader module that samples up to 4 band textures with per-band UV
+ * transforms and composites them into a `vec4` color.
+ *
+ * Uses fixed uniform slots (`band0`–`band3`) for textures (bound via
+ * `getUniforms`) and a uniform block for scalar values (`uvTransform0`–
+ * `uvTransform3`, `channelMap`).
+ *
+ * @see {@link CompositeBandsProps}
+ * @see {@link buildCompositeBandsProps} for a helper that maps named bands
+ *   to slot indices.
+ */
+export const CompositeBands = {
+    name: MODULE_NAME,
+    // Texture samplers — declared via inject, bound via getUniforms
+    inject: {
+        "fs:#decl": /* glsl */ `
+uniform sampler2D band0;
+uniform sampler2D band1;
+uniform sampler2D band2;
+uniform sampler2D band3;
+
+vec2 compositeBands_applyUv(vec2 uv, vec4 transform) {
+  return uv * transform.zw + transform.xy;
+}
+
+float compositeBands_sampleSlot(int slot, vec2 uv) {
+  if (slot == 0) return texture(band0, compositeBands_applyUv(uv, ${MODULE_NAME}.uvTransform0)).r;
+  if (slot == 1) return texture(band1, compositeBands_applyUv(uv, ${MODULE_NAME}.uvTransform1)).r;
+  if (slot == 2) return texture(band2, compositeBands_applyUv(uv, ${MODULE_NAME}.uvTransform2)).r;
+  if (slot == 3) return texture(band3, compositeBands_applyUv(uv, ${MODULE_NAME}.uvTransform3)).r;
+  return 0.0;
+}
+`,
+        "fs:DECKGL_FILTER_COLOR": /* glsl */ `
+  float r = ${MODULE_NAME}.channelMap.r >= 0 ? compositeBands_sampleSlot(${MODULE_NAME}.channelMap.r, geometry.uv) : 0.0;
+  float g = ${MODULE_NAME}.channelMap.g >= 0 ? compositeBands_sampleSlot(${MODULE_NAME}.channelMap.g, geometry.uv) : 0.0;
+  float b = ${MODULE_NAME}.channelMap.b >= 0 ? compositeBands_sampleSlot(${MODULE_NAME}.channelMap.b, geometry.uv) : 0.0;
+  float a = ${MODULE_NAME}.channelMap.a >= 0 ? compositeBands_sampleSlot(${MODULE_NAME}.channelMap.a, geometry.uv) : 1.0;
+  color = vec4(r, g, b, a);
+`,
+    },
+    // Scalar uniforms — declared via fs uniform block + uniformTypes
+    fs: `\
+uniform ${MODULE_NAME}Uniforms {
+  vec4 uvTransform0;
+  vec4 uvTransform1;
+  vec4 uvTransform2;
+  vec4 uvTransform3;
+  ivec4 channelMap;
+} ${MODULE_NAME};
+`,
+    uniformTypes: {
+        uvTransform0: "vec4<f32>",
+        uvTransform1: "vec4<f32>",
+        uvTransform2: "vec4<f32>",
+        uvTransform3: "vec4<f32>",
+        channelMap: "vec4<i32>",
+    },
+    getUniforms: (props) => {
+        return {
+            // Texture bindings
+            band0: props.band0,
+            band1: props.band1,
+            band2: props.band2,
+            band3: props.band3,
+            // Scalar uniforms (uniform block)
+            uvTransform0: props.uvTransform0 ?? [0, 0, 1, 1],
+            uvTransform1: props.uvTransform1 ?? [0, 0, 1, 1],
+            uvTransform2: props.uvTransform2 ?? [0, 0, 1, 1],
+            uvTransform3: props.uvTransform3 ?? [0, 0, 1, 1],
+            channelMap: props.channelMap ?? [0, 1, 2, -1],
+        };
+    },
+};
+/**
+ * Maps named bands and their UV transforms to {@link CompositeBandsProps}
+ * slot indices.
+ *
+ * Assigns each unique band name to a fixed slot (0–3), builds the
+ * `channelMap` that maps RGBA output channels to slots, and fills unused
+ * slots with a placeholder texture to satisfy WebGL binding requirements.
+ *
+ * @param mapping - Which named band goes to which RGBA channel.
+ * @param bands - Map of band name to texture + UV transform.
+ * @returns Props ready to pass to `{ module: CompositeBands, props: ... }`.
+ *
+ * @see {@link CompositeBands}
+ */
+export function buildCompositeBandsProps(mapping, bands) {
+    // Collect unique band names in mapping order and assign slot indices
+    const slotNames = [];
+    const slotIndex = new Map();
+    for (const name of [mapping.r, mapping.g, mapping.b, mapping.a]) {
+        if (name && !slotIndex.has(name)) {
+            if (slotNames.length >= MAX_BAND_SLOTS) {
+                throw new Error(`CompositeBands supports at most ${MAX_BAND_SLOTS} band slots`);
+            }
+            slotIndex.set(name, slotNames.length);
+            slotNames.push(name);
+        }
+    }
+    function slotFor(name) {
+        return name ? (slotIndex.get(name) ?? -1) : -1;
+    }
+    const props = {
+        channelMap: [
+            slotFor(mapping.r),
+            slotFor(mapping.g),
+            slotFor(mapping.b),
+            slotFor(mapping.a),
+        ],
+    };
+    // Get the first texture to use as a placeholder for unused slots.
+    // WebGL requires all declared samplers to have a valid texture bound,
+    // even if the channelMap never references them.
+    const firstBandName = slotNames[0];
+    if (!firstBandName) {
+        throw new Error("At least one band is required");
+    }
+    const firstTexture = bands.get(firstBandName).texture;
+    for (const [name, slot] of slotIndex) {
+        const band = bands.get(name);
+        if (!band) {
+            throw new Error(`Band "${name}" not found in fetched bands`);
+        }
+        props[`band${slot}`] = band.texture;
+        props[`uvTransform${slot}`] = band.uvTransform;
+    }
+    // Fill unused slots with the first texture as a placeholder
+    for (let i = slotNames.length; i < MAX_BAND_SLOTS; i++) {
+        props[`band${i}`] = firstTexture;
+    }
+    return props;
+}
+//# sourceMappingURL=composite-bands.js.map

package/dist/gpu-modules/composite-bands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-bands.js","sourceRoot":"","sources":["../../src/gpu-modules/composite-bands.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAoBhC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,WAAW;IACjB,gEAAgE;IAChE,MAAM,EAAE;QACN,UAAU,EAAE,UAAU,CAAC;;;;;;;;;;;oEAWyC,WAAW;oEACX,WAAW;oEACX,WAAW;oEACX,WAAW;;;CAG9E;QACG,wBAAwB,EAAE,UAAU,CAAC;cAC3B,WAAW,kDAAkD,WAAW;cACxE,WAAW,kDAAkD,WAAW;cACxE,WAAW,kDAAkD,WAAW;cACxE,WAAW,kDAAkD,WAAW;;CAErF;KACE;IACD,iEAAiE;IACjE,EAAE,EAAE;UACI,WAAW;;;;;;IAMjB,WAAW;CACd;IACC,YAAY,EAAE;QACZ,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,WAAW;QACzB,YAAY,EAAE,WAAW;QACzB,UAAU,EAAE,WAAW;KACxB;IACD,WAAW,EAAE,CAAC,KAAmC,EAAE,EAAE;QACnD,OAAO;YACL,mBAAmB;YACnB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,kCAAkC;YAClC,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SAC9C,CAAC;IACJ,CAAC;CACmD,CAAC;AAEvD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA0D,EAC1D,KAMC;IAED,qEAAqE;IACrE,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjC,IAAI,SAAS,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CACb,mCAAmC,cAAc,aAAa,CAC/D,CAAC;YACJ,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,SAAS,OAAO,CAAC,IAAwB;QACvC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAA4B;QACrC,UAAU,EAAE;YACV,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;YAClB,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;SACnB;KACF,CAAC;IAEF,kEAAkE;IAClE,sEAAsE;IACtE,gDAAgD;IAChD,MAAM,aAAa,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,aAAa,CAAE,CAAC,OAAO,CAAC;IAEvD,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,SAAS,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,SAAS,IAAI,8BAA8B,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACpC,KAAK,CAAC,cAAc,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC;IACjD,CAAC;IAED,4DAA4D;IAC5D,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,GAAG,cAAc,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,OAAO,KAAqC,CAAC;AAC/C,CAAC"}

package/dist/gpu-modules/create-colormap-texture.d.ts

@@ -0,0 +1,16 @@
+import type { Device, Texture } from "@luma.gl/core";
+/**
+ * Upload a decoded colormap sprite to the GPU as a 2D array texture.
+ *
+ * The image must be exactly 256 pixels wide; each row becomes one layer
+ * of the returned `Texture` (`dimension: "2d-array"`, `format:
+ * "rgba8unorm"`). Use the result as the `colormapTexture` prop of the
+ * `Colormap` shader module.
+ *
+ * Synchronous — pair with `decodeColormapSprite` when you have a URL or
+ * raw bytes rather than an already-decoded `ImageData`.
+ *
+ * @throws when `imageData.width` is not 256.
+ */
+export declare function createColormapTexture(device: Device, imageData: ImageData): Texture;
+//# sourceMappingURL=create-colormap-texture.d.ts.map

package/dist/gpu-modules/create-colormap-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-colormap-texture.d.ts","sourceRoot":"","sources":["../../src/gpu-modules/create-colormap-texture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GACnB,OAAO,CAgCT"}

package/dist/gpu-modules/create-colormap-texture.js

@@ -0,0 +1,41 @@
+/**
+ * Upload a decoded colormap sprite to the GPU as a 2D array texture.
+ *
+ * The image must be exactly 256 pixels wide; each row becomes one layer
+ * of the returned `Texture` (`dimension: "2d-array"`, `format:
+ * "rgba8unorm"`). Use the result as the `colormapTexture` prop of the
+ * `Colormap` shader module.
+ *
+ * Synchronous — pair with `decodeColormapSprite` when you have a URL or
+ * raw bytes rather than an already-decoded `ImageData`.
+ *
+ * @throws when `imageData.width` is not 256.
+ */
+export function createColormapTexture(device, imageData) {
+    if (imageData.width !== 256) {
+        throw new Error(`Expected a 256-pixel-wide colormap sprite, got width ${imageData.width}.`);
+    }
+    // ImageData row-major layout (RGBA row 0, RGBA row 1, …) matches luma.gl's
+    // 2D-array upload layout (layer-major). Each layer is one image row and
+    // exactly one texel tall, so no re-packing is needed.
+    const bytes = new Uint8Array(imageData.data.buffer, imageData.data.byteOffset, imageData.data.byteLength);
+    return device.createTexture({
+        dimension: "2d-array",
+        format: "rgba8unorm",
+        width: 256,
+        height: 1,
+        depth: imageData.height,
+        data: bytes,
+        mipLevels: 1,
+        sampler: {
+            minFilter: "linear",
+            magFilter: "linear",
+            // Clamp in every axis so an out-of-range colormapIndex yields an
+            // edge color rather than wrapping to an unrelated colormap.
+            addressModeU: "clamp-to-edge",
+            addressModeV: "clamp-to-edge",
+            addressModeW: "clamp-to-edge",
+        },
+    });
+}
+//# sourceMappingURL=create-colormap-texture.js.map

package/dist/gpu-modules/create-colormap-texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-colormap-texture.js","sourceRoot":"","sources":["../../src/gpu-modules/create-colormap-texture.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CACnC,MAAc,EACd,SAAoB;IAEpB,IAAI,SAAS,CAAC,KAAK,KAAK,GAAG,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,wDAAwD,SAAS,CAAC,KAAK,GAAG,CAC3E,CAAC;IACJ,CAAC;IACD,2EAA2E;IAC3E,wEAAwE;IACxE,sDAAsD;IACtD,MAAM,KAAK,GAAG,IAAI,UAAU,CAC1B,SAAS,CAAC,IAAI,CAAC,MAAM,EACrB,SAAS,CAAC,IAAI,CAAC,UAAU,EACzB,SAAS,CAAC,IAAI,CAAC,UAAU,CAC1B,CAAC;IACF,OAAO,MAAM,CAAC,aAAa,CAAC;QAC1B,SAAS,EAAE,UAAU;QACrB,MAAM,EAAE,YAAY;QACpB,KAAK,EAAE,GAAG;QACV,MAAM,EAAE,CAAC;QACT,KAAK,EAAE,SAAS,CAAC,MAAM;QACvB,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE;YACP,SAAS,EAAE,QAAQ;YACnB,SAAS,EAAE,QAAQ;YACnB,iEAAiE;YACjE,4DAA4D;YAC5D,YAAY,EAAE,eAAe;YAC7B,YAAY,EAAE,eAAe;YAC7B,YAAY,EAAE,eAAe;SAC9B;KACF,CAAC,CAAC;AACL,CAAC"}