@flighthq/surface 0.1.0

package/dist/surfaceNoise.js

@@ -0,0 +1,245 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Fills the `dest` region with uniform random noise in `[low, high]`, derived
+ * deterministically from `seed` (the same seed always produces the same image,
+ * which a `Math.random()` fill could not guarantee — important for reproducible
+ * tests and a future C port). Region pixels outside the surface are skipped.
+ *
+ * When `grayScale` is true, R, G, and B share one value per pixel; otherwise
+ * each channel is independent. Alpha is set fully opaque (255).
+ */
+export function fillSurfaceNoise(dest, seed, low = 0, high = 255, grayScale = false) {
+    let state = (seed | 0) >>> 0 || 1;
+    const lo = Math.max(0, Math.min(255, low));
+    const span = Math.max(0, Math.min(255, high)) - lo;
+    const data = dest.surface.data;
+    const surfaceWidth = dest.surface.width;
+    for (let py = 0; py < dest.height; py++) {
+        const y = dest.y + py;
+        for (let px = 0; px < dest.width; px++) {
+            // Advance the generator for every region pixel so the field stays
+            // deterministic regardless of which pixels fall outside the surface.
+            state = nextRandomState(state);
+            const r = lo + (state / 0x100000000) * span;
+            let g = r;
+            let b = r;
+            if (!grayScale) {
+                state = nextRandomState(state);
+                g = lo + (state / 0x100000000) * span;
+                state = nextRandomState(state);
+                b = lo + (state / 0x100000000) * span;
+            }
+            const x = dest.x + px;
+            if (y < 0 || y >= dest.surface.height || x < 0 || x >= surfaceWidth)
+                continue;
+            const i = (y * surfaceWidth + x) * 4;
+            data[i] = Math.round(r);
+            data[i + 1] = Math.round(g);
+            data[i + 2] = Math.round(b);
+            data[i + 3] = 255;
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Fills `out` with fractal value noise summed over `octaves`. `baseX` and
+ * `baseY` are the wavelengths (in pixels) of the first octave: larger values
+ * produce smoother, lower-frequency noise. Each successive octave doubles the
+ * frequency and halves the amplitude. Output is normalized to 0..255.
+ *
+ * - `baseX`, `baseY`: wavelengths in pixels of the first octave (larger = smoother).
+ * - `octaves`: number of frequency doublings (1 = smooth; higher = more detail).
+ * - `seed`: deterministic integer seed.
+ * - `stitch`: when `true`, the noise field tiles seamlessly at the region borders.
+ * - `grayScale`: when `true`, R=G=B share one noise channel. Overrides
+ *   `channelOptions` for the RGB channels.
+ * - `channelOptions`: bitmask of channels to fill (default `0x7` = RGB, matching
+ *   OpenFL's `perlinNoise` default). Channels not selected are left unchanged in
+ *   `dest`, except alpha: when the A bit is not selected, alpha is set opaque
+ *   (255) rather than left as-is. Use `SURFACE_NOISE_CHANNEL_*` constants. When
+ *   `grayScale` is true the same field drives all selected RGB channels.
+ *
+ * Output range is normalized to 0..255. Alpha defaults to 255 unless the A
+ * bit is explicitly included in `channelOptions`.
+ */
+export function fillSurfacePerlinNoise(dest, baseX, baseY, octaves, seed, grayScale = false, stitch = false, channelOptions = 0x7) {
+    const fx0 = baseX > 0 ? 1 / baseX : 0;
+    const fy0 = baseY > 0 ? 1 / baseY : 0;
+    const passes = Math.max(1, Math.round(octaves));
+    const data = dest.surface.data;
+    const surfaceWidth = dest.surface.width;
+    const w = dest.width;
+    const h = dest.height;
+    for (let py = 0; py < dest.height; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= dest.surface.height)
+            continue;
+        for (let px = 0; px < dest.width; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            const di = (y * surfaceWidth + x) * 4;
+            const nx = stitch ? stitchedCoord(px * fx0, w * fx0) : px * fx0;
+            const ny = stitch ? stitchedCoord(py * fy0, h * fy0) : py * fy0;
+            if (grayScale) {
+                const value = fractalValueNoise(nx, ny, passes, seed | 0);
+                const byte = Math.round(value * 255);
+                if (channelOptions & SURFACE_NOISE_CHANNEL_R)
+                    data[di] = byte;
+                if (channelOptions & SURFACE_NOISE_CHANNEL_G)
+                    data[di + 1] = byte;
+                if (channelOptions & SURFACE_NOISE_CHANNEL_B)
+                    data[di + 2] = byte;
+            }
+            else {
+                if (channelOptions & SURFACE_NOISE_CHANNEL_R) {
+                    data[di] = Math.round(fractalValueNoise(nx, ny, passes, seed | 0) * 255);
+                }
+                if (channelOptions & SURFACE_NOISE_CHANNEL_G) {
+                    data[di + 1] = Math.round(fractalValueNoise(nx, ny, passes, (seed | 0) + 0x9e3779b1) * 255);
+                }
+                if (channelOptions & SURFACE_NOISE_CHANNEL_B) {
+                    data[di + 2] = Math.round(fractalValueNoise(nx, ny, passes, (seed | 0) + 0x9e3779b2) * 255);
+                }
+            }
+            if (channelOptions & SURFACE_NOISE_CHANNEL_A) {
+                data[di + 3] = Math.round(fractalValueNoise(nx, ny, passes, (seed | 0) + 0x9e3779b3) * 255);
+            }
+            else {
+                data[di + 3] = 255;
+            }
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Fills `dest` with fractal **turbulence** (absolute-value fBm) value noise,
+ * matching OpenFL's `BitmapData.perlinNoise` with `fractalNoise: false`.
+ * Turbulence sums `abs(octave)` values, producing a more vigorous, ridge-like
+ * texture than the smooth fractal sum.
+ *
+ * Parameters are identical to `fillSurfacePerlinNoise` except there is no
+ * `fractalNoise` flag (this function _is_ the turbulence variant).
+ */
+export function fillSurfaceTurbulence(dest, baseX, baseY, octaves, seed, grayScale = false, stitch = false, channelOptions = 0x7) {
+    const fx0 = baseX > 0 ? 1 / baseX : 0;
+    const fy0 = baseY > 0 ? 1 / baseY : 0;
+    const passes = Math.max(1, Math.round(octaves));
+    const data = dest.surface.data;
+    const surfaceWidth = dest.surface.width;
+    const w = dest.width;
+    const h = dest.height;
+    for (let py = 0; py < dest.height; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= dest.surface.height)
+            continue;
+        for (let px = 0; px < dest.width; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            const di = (y * surfaceWidth + x) * 4;
+            const nx = stitch ? stitchedCoord(px * fx0, w * fx0) : px * fx0;
+            const ny = stitch ? stitchedCoord(py * fy0, h * fy0) : py * fy0;
+            if (grayScale) {
+                const value = turbulenceNoise(nx, ny, passes, seed | 0);
+                const byte = Math.round(value * 255);
+                if (channelOptions & SURFACE_NOISE_CHANNEL_R)
+                    data[di] = byte;
+                if (channelOptions & SURFACE_NOISE_CHANNEL_G)
+                    data[di + 1] = byte;
+                if (channelOptions & SURFACE_NOISE_CHANNEL_B)
+                    data[di + 2] = byte;
+            }
+            else {
+                if (channelOptions & SURFACE_NOISE_CHANNEL_R) {
+                    data[di] = Math.round(turbulenceNoise(nx, ny, passes, seed | 0) * 255);
+                }
+                if (channelOptions & SURFACE_NOISE_CHANNEL_G) {
+                    data[di + 1] = Math.round(turbulenceNoise(nx, ny, passes, (seed | 0) + 0x9e3779b1) * 255);
+                }
+                if (channelOptions & SURFACE_NOISE_CHANNEL_B) {
+                    data[di + 2] = Math.round(turbulenceNoise(nx, ny, passes, (seed | 0) + 0x9e3779b2) * 255);
+                }
+            }
+            if (channelOptions & SURFACE_NOISE_CHANNEL_A) {
+                data[di + 3] = Math.round(turbulenceNoise(nx, ny, passes, (seed | 0) + 0x9e3779b3) * 255);
+            }
+            else {
+                data[di + 3] = 255;
+            }
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+export const SURFACE_NOISE_CHANNEL_A = 0x8;
+export const SURFACE_NOISE_CHANNEL_B = 0x4;
+export const SURFACE_NOISE_CHANNEL_G = 0x2;
+export const SURFACE_NOISE_CHANNEL_R = 0x1;
+// Fractal sum of value noise: doubling frequency, halving amplitude per octave,
+// normalized back to 0..1 by the total amplitude.
+function fractalValueNoise(x, y, octaves, seed) {
+    let sum = 0;
+    let amplitude = 1;
+    let amplitudeSum = 0;
+    let frequency = 1;
+    for (let o = 0; o < octaves; o++) {
+        sum += valueNoise(x * frequency, y * frequency, seed + o * 0x85ebca6b) * amplitude;
+        amplitudeSum += amplitude;
+        amplitude *= 0.5;
+        frequency *= 2;
+    }
+    return amplitudeSum > 0 ? sum / amplitudeSum : 0;
+}
+// Integer hash to a deterministic 0..1 value; the lattice corners of valueNoise.
+function hashLattice(ix, iy, seed) {
+    let h = (Math.imul(ix, 374761393) + Math.imul(iy, 668265263) + Math.imul(seed, 0x9e3779b1)) | 0;
+    h = Math.imul(h ^ (h >>> 13), 1274126177);
+    return ((h ^ (h >>> 16)) >>> 0) / 0x100000000;
+}
+// Mulberry32 step: maps one 32-bit state to the next, used as an unsigned int.
+function nextRandomState(state) {
+    let t = (state + 0x6d2b79f5) | 0;
+    t = Math.imul(t ^ (t >>> 15), t | 1);
+    t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+    return (t ^ (t >>> 14)) >>> 0 || 1;
+}
+// Smoothstep, so lattice cells blend without visible seams.
+function smoothStep(t) {
+    return t * t * (3 - 2 * t);
+}
+// Wraps t into [0, period) so that integer lattice indices repeat, producing seamless tiling.
+function stitchedCoord(t, period) {
+    if (period <= 0)
+        return t;
+    return ((t % period) + period) % period;
+}
+// Fractal turbulence: abs(2*v - 1) fBm, producing a more vigorous ridge-like texture than
+// the smooth fractal sum (matches OpenFL perlinNoise with fractalNoise=false).
+function turbulenceNoise(x, y, octaves, seed) {
+    let sum = 0;
+    let amplitude = 1;
+    let amplitudeSum = 0;
+    let frequency = 1;
+    for (let o = 0; o < octaves; o++) {
+        sum += Math.abs(valueNoise(x * frequency, y * frequency, seed + o * 0x85ebca6b) * 2 - 1) * amplitude;
+        amplitudeSum += amplitude;
+        amplitude *= 0.5;
+        frequency *= 2;
+    }
+    return amplitudeSum > 0 ? sum / amplitudeSum : 0;
+}
+// Bilinearly-interpolated lattice hash — one octave of value noise in 0..1.
+function valueNoise(x, y, seed) {
+    const ix = Math.floor(x);
+    const iy = Math.floor(y);
+    const fx = smoothStep(x - ix);
+    const fy = smoothStep(y - iy);
+    const v00 = hashLattice(ix, iy, seed);
+    const v10 = hashLattice(ix + 1, iy, seed);
+    const v01 = hashLattice(ix, iy + 1, seed);
+    const v11 = hashLattice(ix + 1, iy + 1, seed);
+    const top = v00 + (v10 - v00) * fx;
+    const bottom = v01 + (v11 - v01) * fx;
+    return top + (bottom - top) * fy;
+}
+//# sourceMappingURL=surfaceNoise.js.map

package/dist/surfaceNoise.js.map

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

package/dist/surfacePaletteMap.d.ts

@@ -0,0 +1,17 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Remaps each color channel of `source` independently through a 256-entry
+ * lookup table, writing into `dest`. Each table is indexed by the 0..255 input
+ * channel value and supplies the 0..255 output value; a `null` table leaves
+ * that channel unchanged. The remapped size is the overlap of the two regions.
+ *
+ * This is the building block for levels, curves, gamma, posterize, and
+ * per-channel inversion. Unlike Flash's 32-bit-summing `paletteMap`, the
+ * channels are mapped independently, which is what level/curve adjustments
+ * need; build a table once and reuse it across frames.
+ *
+ * Safe to pass the same surface and region in `dest` and `source` — each
+ * pixel's channels are read before any channel of that pixel is written.
+ */
+export declare function applySurfacePaletteMap(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, redMap: ReadonlyArray<number> | null, greenMap: ReadonlyArray<number> | null, blueMap: ReadonlyArray<number> | null, alphaMap: ReadonlyArray<number> | null): void;
+//# sourceMappingURL=surfacePaletteMap.d.ts.map

package/dist/surfacePaletteMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfacePaletteMap.d.ts","sourceRoot":"","sources":["../src/surfacePaletteMap.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,EACpC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,EACtC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,EACrC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,GACrC,IAAI,CA0BN"}

package/dist/surfacePaletteMap.js

@@ -0,0 +1,45 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Remaps each color channel of `source` independently through a 256-entry
+ * lookup table, writing into `dest`. Each table is indexed by the 0..255 input
+ * channel value and supplies the 0..255 output value; a `null` table leaves
+ * that channel unchanged. The remapped size is the overlap of the two regions.
+ *
+ * This is the building block for levels, curves, gamma, posterize, and
+ * per-channel inversion. Unlike Flash's 32-bit-summing `paletteMap`, the
+ * channels are mapped independently, which is what level/curve adjustments
+ * need; build a table once and reuse it across frames.
+ *
+ * Safe to pass the same surface and region in `dest` and `source` — each
+ * pixel's channels are read before any channel of that pixel is written.
+ */
+export function applySurfacePaletteMap(dest, source, redMap, greenMap, blueMap, alphaMap) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const sd = source.surface.data;
+    const dd = dest.surface.data;
+    for (let py = 0; py < h; py++) {
+        const sy = source.y + py;
+        const dy = dest.y + py;
+        if (sy < 0 || sy >= source.surface.height || dy < 0 || dy >= dest.surface.height)
+            continue;
+        for (let px = 0; px < w; px++) {
+            const sx = source.x + px;
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= source.surface.width || dx < 0 || dx >= dest.surface.width)
+                continue;
+            const si = (sy * source.surface.width + sx) * 4;
+            const di = (dy * dest.surface.width + dx) * 4;
+            const r = sd[si];
+            const g = sd[si + 1];
+            const b = sd[si + 2];
+            const a = sd[si + 3];
+            dd[di] = redMap ? redMap[r] : r;
+            dd[di + 1] = greenMap ? greenMap[g] : g;
+            dd[di + 2] = blueMap ? blueMap[b] : b;
+            dd[di + 3] = alphaMap ? alphaMap[a] : a;
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+//# sourceMappingURL=surfacePaletteMap.js.map

package/dist/surfacePaletteMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfacePaletteMap.js","sourceRoot":"","sources":["../src/surfacePaletteMap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAG1D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,sBAAsB,CACpC,IAA6B,EAC7B,MAA+B,EAC/B,MAAoC,EACpC,QAAsC,EACtC,OAAqC,EACrC,QAAsC;IAEtC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC7B,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;YAAE,SAAS;QAC3F,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;YACzB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;YACvB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK;gBAAE,SAAS;YACzF,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAChD,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YAC9C,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACjB,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACrB,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;YACrB,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/surfacePixel.d.ts

@@ -0,0 +1,9 @@
+import type { Surface } from '@flighthq/types';
+import type { ImageChannel } from './surfaceImageChannel';
+export declare function getSurfacePixel(source: Readonly<Surface>, x: number, y: number): number;
+export declare function getSurfacePixelChannel(source: Readonly<Surface>, x: number, y: number, channel: ImageChannel): number;
+export declare function getSurfacePixelLuminance(source: Readonly<Surface>, x: number, y: number): number;
+export declare function getSurfacePixelRgb(source: Readonly<Surface>, x: number, y: number): number;
+export declare function setSurfacePixel(out: Surface, x: number, y: number, color: number): void;
+export declare function setSurfacePixelRgb(out: Surface, x: number, y: number, color: number): void;
+//# sourceMappingURL=surfacePixel.d.ts.map

package/dist/surfacePixel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfacePixel.d.ts","sourceRoot":"","sources":["../src/surfacePixel.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAO1D,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGvF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAErH;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAGhG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1F;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOvF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAM1F"}

package/dist/surfacePixel.js

@@ -0,0 +1,36 @@
+import { invalidateImageResource } from '@flighthq/image';
+// W3C luma coefficients for perceptual luminance (same as CSS saturate/grayscale).
+const LUMA_R = 0.2126;
+const LUMA_G = 0.7152;
+const LUMA_B = 0.0722;
+export function getSurfacePixel(source, x, y) {
+    const i = (y * source.width + x) * 4;
+    return ((source.data[i] << 24) | (source.data[i + 1] << 16) | (source.data[i + 2] << 8) | source.data[i + 3]) >>> 0;
+}
+export function getSurfacePixelChannel(source, x, y, channel) {
+    return source.data[(y * source.width + x) * 4 + channel];
+}
+export function getSurfacePixelLuminance(source, x, y) {
+    const i = (y * source.width + x) * 4;
+    return Math.round(source.data[i] * LUMA_R + source.data[i + 1] * LUMA_G + source.data[i + 2] * LUMA_B);
+}
+export function getSurfacePixelRgb(source, x, y) {
+    const i = (y * source.width + x) * 4;
+    return ((source.data[i] << 16) | (source.data[i + 1] << 8) | source.data[i + 2]) >>> 0;
+}
+export function setSurfacePixel(out, x, y, color) {
+    const i = (y * out.width + x) * 4;
+    out.data[i] = (color >>> 24) & 0xff;
+    out.data[i + 1] = (color >> 16) & 0xff;
+    out.data[i + 2] = (color >> 8) & 0xff;
+    out.data[i + 3] = color & 0xff;
+    invalidateImageResource(out);
+}
+export function setSurfacePixelRgb(out, x, y, color) {
+    const i = (y * out.width + x) * 4;
+    out.data[i] = (color >> 16) & 0xff;
+    out.data[i + 1] = (color >> 8) & 0xff;
+    out.data[i + 2] = color & 0xff;
+    invalidateImageResource(out);
+}
+//# sourceMappingURL=surfacePixel.js.map

package/dist/surfacePixel.js.map

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

package/dist/surfacePixelate.d.ts

@@ -0,0 +1,13 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Pixelates (mosaics) `source` into `out`: the region is divided into
+ * `blockSize × blockSize` cells, each cell is averaged, and every output pixel
+ * in the cell takes that average color. `blockSize` is clamped to at least 1
+ * (a no-op copy at 1). Edge cells are clipped to the region.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes. Safe to pass
+ * `source.surface.data` as `out` for a full-surface region — each cell is fully
+ * read before it is written, and cells do not overlap.
+ */
+export declare function pixelateSurface(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>, blockSize: number): void;
+//# sourceMappingURL=surfacePixelate.d.ts.map

package/dist/surfacePixelate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfacePixelate.d.ts","sourceRoot":"","sources":["../src/surfacePixelate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CA+ChH"}

package/dist/surfacePixelate.js

@@ -0,0 +1,61 @@
+/**
+ * Pixelates (mosaics) `source` into `out`: the region is divided into
+ * `blockSize × blockSize` cells, each cell is averaged, and every output pixel
+ * in the cell takes that average color. `blockSize` is clamped to at least 1
+ * (a no-op copy at 1). Edge cells are clipped to the region.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes. Safe to pass
+ * `source.surface.data` as `out` for a full-surface region — each cell is fully
+ * read before it is written, and cells do not overlap.
+ */
+export function pixelateSurface(out, source, blockSize) {
+    const block = Math.max(1, Math.round(blockSize));
+    const w = source.width;
+    const h = source.height;
+    const surfaceWidth = source.surface.width;
+    const surfaceHeight = source.surface.height;
+    const data = source.surface.data;
+    for (let by = 0; by < h; by += block) {
+        const yEnd = Math.min(by + block, h);
+        for (let bx = 0; bx < w; bx += block) {
+            const xEnd = Math.min(bx + block, w);
+            let r = 0;
+            let g = 0;
+            let b = 0;
+            let a = 0;
+            let count = 0;
+            for (let py = by; py < yEnd; py++) {
+                const sy = source.y + py;
+                if (sy < 0 || sy >= surfaceHeight)
+                    continue;
+                for (let px = bx; px < xEnd; px++) {
+                    const sx = source.x + px;
+                    if (sx < 0 || sx >= surfaceWidth)
+                        continue;
+                    const si = (sy * surfaceWidth + sx) * 4;
+                    r += data[si];
+                    g += data[si + 1];
+                    b += data[si + 2];
+                    a += data[si + 3];
+                    count++;
+                }
+            }
+            if (count === 0)
+                continue;
+            const ar = Math.round(r / count);
+            const ag = Math.round(g / count);
+            const ab = Math.round(b / count);
+            const aa = Math.round(a / count);
+            for (let py = by; py < yEnd; py++) {
+                for (let px = bx; px < xEnd; px++) {
+                    const di = (py * w + px) * 4;
+                    out[di] = ar;
+                    out[di + 1] = ag;
+                    out[di + 2] = ab;
+                    out[di + 3] = aa;
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=surfacePixelate.js.map

package/dist/surfacePixelate.js.map

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

package/dist/surfaceQuery.d.ts

@@ -0,0 +1,13 @@
+import type { RectangleLike, SurfaceRegion } from '@flighthq/types';
+/**
+ * Scans the `source` region for pixels matching `color` under `mask`
+ * (`findColor` true) or not matching it (false), and returns the tightest
+ * bounding rectangle of those pixels in surface-absolute coordinates, or `null`
+ * if none match. Region pixels outside the surface are skipped.
+ *
+ * The comparison is performed on the full packed 0xRRGGBBAA pixel value. To
+ * match by a subset of channels, supply a `mask` that isolates the relevant
+ * bytes — e.g. 0xffffff00 to ignore alpha.
+ */
+export declare function getSurfaceColorBoundsRectangle(source: Readonly<SurfaceRegion>, mask: number, color: number, findColor?: boolean): RectangleLike | null;
+//# sourceMappingURL=surfaceQuery.d.ts.map

package/dist/surfaceQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceQuery.d.ts","sourceRoot":"","sources":["../src/surfaceQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,OAAc,GACxB,aAAa,GAAG,IAAI,CA6BtB"}

package/dist/surfaceQuery.js

@@ -0,0 +1,46 @@
+/**
+ * Scans the `source` region for pixels matching `color` under `mask`
+ * (`findColor` true) or not matching it (false), and returns the tightest
+ * bounding rectangle of those pixels in surface-absolute coordinates, or `null`
+ * if none match. Region pixels outside the surface are skipped.
+ *
+ * The comparison is performed on the full packed 0xRRGGBBAA pixel value. To
+ * match by a subset of channels, supply a `mask` that isolates the relevant
+ * bytes — e.g. 0xffffff00 to ignore alpha.
+ */
+export function getSurfaceColorBoundsRectangle(source, mask, color, findColor = true) {
+    const data = source.surface.data;
+    const surfaceWidth = source.surface.width;
+    const maskedColor = (color >>> 0) & (mask >>> 0);
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -1;
+    let maxY = -1;
+    for (let py = 0; py < source.height; py++) {
+        const y = source.y + py;
+        if (y < 0 || y >= source.surface.height)
+            continue;
+        for (let px = 0; px < source.width; px++) {
+            const x = source.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            const i = (y * surfaceWidth + x) * 4;
+            const pixel = (((data[i] << 24) | (data[i + 1] << 16) | (data[i + 2] << 8) | data[i + 3]) >>> 0) & (mask >>> 0);
+            const matches = pixel === maskedColor;
+            if (matches === findColor) {
+                if (x < minX)
+                    minX = x;
+                if (x > maxX)
+                    maxX = x;
+                if (y < minY)
+                    minY = y;
+                if (y > maxY)
+                    maxY = y;
+            }
+        }
+    }
+    if (maxX === -1)
+        return null;
+    return { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 };
+}
+//# sourceMappingURL=surfaceQuery.js.map

package/dist/surfaceQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceQuery.js","sourceRoot":"","sources":["../src/surfaceQuery.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAC5C,MAA+B,EAC/B,IAAY,EACZ,KAAa,EACb,YAAqB,IAAI;IAEzB,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;IACjC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;IAC1C,MAAM,WAAW,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACjD,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IACd,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC;IAEd,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM;YAAE,SAAS;QAClD,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,YAAY;gBAAE,SAAS;YACzC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;YACrC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;YAChH,MAAM,OAAO,GAAG,KAAK,KAAK,WAAW,CAAC;YACtC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;gBACvB,IAAI,CAAC,GAAG,IAAI;oBAAE,IAAI,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/surfaceRegion.d.ts

@@ -0,0 +1,20 @@
+import type { Surface, SurfaceRegion } from '@flighthq/types';
+/**
+ * Allocates a `SurfaceRegion`. With no bounds it covers the whole surface, so
+ * `createSurfaceRegion(surface)` is the fast path for "operate on everything".
+ *
+ * Region functions read these fields synchronously and never retain the object,
+ * so in a hot loop you can allocate one region up front and reuse it with
+ * `setSurfaceRegion` instead of building a literal per call.
+ */
+export declare function createSurfaceRegion(surface: Surface, x?: number, y?: number, width?: number, height?: number): SurfaceRegion;
+/**
+ * Writes region fields into an existing `out` region without allocating, and
+ * returns `out`. With no bounds it covers the whole surface. Use this to thread
+ * a single reusable region through a hot loop:
+ *
+ *   const r = createSurfaceRegion(surface);
+ *   for (…) fillSurfaceRectangle(setSurfaceRegion(r, surface, x, y, w, h), color);
+ */
+export declare function setSurfaceRegion(out: SurfaceRegion, surface: Surface, x?: number, y?: number, width?: number, height?: number): SurfaceRegion;
+//# sourceMappingURL=surfaceRegion.d.ts.map

package/dist/surfaceRegion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceRegion.d.ts","sourceRoot":"","sources":["../src/surfaceRegion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,CAAC,GAAE,MAAU,EACb,CAAC,GAAE,MAAU,EACb,KAAK,GAAE,MAAsB,EAC7B,MAAM,GAAE,MAAuB,GAC9B,aAAa,CAEf;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,OAAO,EAChB,CAAC,GAAE,MAAU,EACb,CAAC,GAAE,MAAU,EACb,KAAK,GAAE,MAAsB,EAC7B,MAAM,GAAE,MAAuB,GAC9B,aAAa,CAOf"}

package/dist/surfaceRegion.js

@@ -0,0 +1,28 @@
+/**
+ * Allocates a `SurfaceRegion`. With no bounds it covers the whole surface, so
+ * `createSurfaceRegion(surface)` is the fast path for "operate on everything".
+ *
+ * Region functions read these fields synchronously and never retain the object,
+ * so in a hot loop you can allocate one region up front and reuse it with
+ * `setSurfaceRegion` instead of building a literal per call.
+ */
+export function createSurfaceRegion(surface, x = 0, y = 0, width = surface.width, height = surface.height) {
+    return { surface, x, y, width, height };
+}
+/**
+ * Writes region fields into an existing `out` region without allocating, and
+ * returns `out`. With no bounds it covers the whole surface. Use this to thread
+ * a single reusable region through a hot loop:
+ *
+ *   const r = createSurfaceRegion(surface);
+ *   for (…) fillSurfaceRectangle(setSurfaceRegion(r, surface, x, y, w, h), color);
+ */
+export function setSurfaceRegion(out, surface, x = 0, y = 0, width = surface.width, height = surface.height) {
+    out.surface = surface;
+    out.x = x;
+    out.y = y;
+    out.width = width;
+    out.height = height;
+    return out;
+}
+//# sourceMappingURL=surfaceRegion.js.map

package/dist/surfaceRegion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceRegion.js","sourceRoot":"","sources":["../src/surfaceRegion.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CACjC,OAAgB,EAChB,IAAY,CAAC,EACb,IAAY,CAAC,EACb,QAAgB,OAAO,CAAC,KAAK,EAC7B,SAAiB,OAAO,CAAC,MAAM;IAE/B,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,GAAkB,EAClB,OAAgB,EAChB,IAAY,CAAC,EACb,IAAY,CAAC,EACb,QAAgB,OAAO,CAAC,KAAK,EAC7B,SAAiB,OAAO,CAAC,MAAM;IAE/B,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IACtB,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACV,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACV,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IAClB,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC"}