@flighthq/surface 0.1.0

package/dist/surfaceDisplacement.js

@@ -0,0 +1,131 @@
+/**
+ * Warps `source` by sampling each output pixel from a displaced source position,
+ * writing into `out`. The displacement for pixel (px, py) is read from `map` at
+ * the aligned position and scaled:
+ *
+ *   dx = (mapValueX / 255 - 0.5) * scaleX
+ *   dy = (mapValueY / 255 - 0.5) * scaleY
+ *
+ * A map value of 128 is approximately neutral (< 0.2px shift). Sampling uses
+ * bilinear interpolation.
+ *
+ * When `edgeMode` is set, it controls out-of-bounds behaviour using the standard
+ * `SurfaceEdgeMode` values (`'clamp'`, `'wrap'`, `'mirror'`, `'transparent'`).
+ * Otherwise `mode` is used: `'wrap'` tiles, `'clamp'` holds the edge, `'ignore'`
+ * keeps the undisplaced source pixel, and `'color'` fills with `fillColor`.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — output pixels read arbitrary source positions.
+ */
+export function displaceSurface(out, source, options) {
+    const w = source.width;
+    const h = source.height;
+    const map = options.map;
+    const componentX = options.componentX ?? 0;
+    const componentY = options.componentY ?? 1;
+    const scaleX = options.scaleX ?? 0;
+    const scaleY = options.scaleY ?? 0;
+    const edgeMode = options.edgeMode;
+    const mode = options.mode ?? 'wrap';
+    const fillColor = options.fillColor ?? 0;
+    const fillR = (fillColor >>> 24) & 0xff;
+    const fillG = (fillColor >> 16) & 0xff;
+    const fillB = (fillColor >> 8) & 0xff;
+    const fillA = fillColor & 0xff;
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            const di = (py * w + px) * 4;
+            const mapVx = sampleMapChannel(map, px, py, componentX);
+            const mapVy = sampleMapChannel(map, px, py, componentY);
+            const rawSampleX = px + (mapVx / 255 - 0.5) * scaleX;
+            const rawSampleY = py + (mapVy / 255 - 0.5) * scaleY;
+            let sampleX = rawSampleX;
+            let sampleY = rawSampleY;
+            if (rawSampleX < 0 || rawSampleX >= w || rawSampleY < 0 || rawSampleY >= h) {
+                if (edgeMode !== undefined) {
+                    const rx = resolveDisplacementEdge(rawSampleX, w, edgeMode);
+                    const ry = resolveDisplacementEdge(rawSampleY, h, edgeMode);
+                    if (rx === null || ry === null) {
+                        out[di] = 0;
+                        out[di + 1] = 0;
+                        out[di + 2] = 0;
+                        out[di + 3] = 0;
+                        continue;
+                    }
+                    sampleX = rx;
+                    sampleY = ry;
+                }
+                else if (mode === 'wrap') {
+                    sampleX = ((rawSampleX % w) + w) % w;
+                    sampleY = ((rawSampleY % h) + h) % h;
+                }
+                else if (mode === 'clamp') {
+                    sampleX = Math.max(0, Math.min(w - 1, rawSampleX));
+                    sampleY = Math.max(0, Math.min(h - 1, rawSampleY));
+                }
+                else if (mode === 'ignore') {
+                    sampleX = px;
+                    sampleY = py;
+                }
+                else {
+                    out[di] = fillR;
+                    out[di + 1] = fillG;
+                    out[di + 2] = fillB;
+                    out[di + 3] = fillA;
+                    continue;
+                }
+            }
+            const x0 = Math.floor(sampleX);
+            const y0 = Math.floor(sampleY);
+            const tx = sampleX - x0;
+            const ty = sampleY - y0;
+            const sStride = source.surface.width;
+            const sData = source.surface.data;
+            const x0c = source.x + Math.max(0, Math.min(w - 1, x0));
+            const x1c = source.x + Math.max(0, Math.min(w - 1, x0 + 1));
+            const y0c = source.y + Math.max(0, Math.min(h - 1, y0));
+            const y1c = source.y + Math.max(0, Math.min(h - 1, y0 + 1));
+            if (x0c < 0 || x0c >= sData.length / 4 || y0c < 0) {
+                out[di] = 0;
+                out[di + 1] = 0;
+                out[di + 2] = 0;
+                out[di + 3] = 0;
+                continue;
+            }
+            const i00 = (y0c * sStride + x0c) * 4;
+            const i10 = (y0c * sStride + x1c) * 4;
+            const i01 = (y1c * sStride + x0c) * 4;
+            const i11 = (y1c * sStride + x1c) * 4;
+            for (let c = 0; c < 4; c++) {
+                const top = sData[i00 + c] * (1 - tx) + sData[i10 + c] * tx;
+                const bottom = sData[i01 + c] * (1 - tx) + sData[i11 + c] * tx;
+                out[di + c] = Math.round(top * (1 - ty) + bottom * ty);
+            }
+        }
+    }
+}
+function resolveDisplacementEdge(v, size, mode) {
+    if (v >= 0 && v < size)
+        return v;
+    switch (mode) {
+        case 'clamp':
+            return Math.max(0, Math.min(size - 1, v));
+        case 'wrap':
+            return ((v % size) + size) % size;
+        case 'mirror': {
+            const period = 2 * size;
+            const wrapped = ((v % period) + period) % period;
+            return wrapped < size ? wrapped : period - 1 - wrapped;
+        }
+        default:
+            return null;
+    }
+}
+function sampleMapChannel(map, px, py, component) {
+    const mx = map.x + px;
+    const my = map.y + py;
+    if (mx < 0 || mx >= map.surface.width || my < 0 || my >= map.surface.height)
+        return 128;
+    return map.surface.data[(my * map.surface.width + mx) * 4 + component];
+}
+//# sourceMappingURL=surfaceDisplacement.js.map

package/dist/surfaceDisplacement.js.map

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

package/dist/surfaceDissolve.d.ts

@@ -0,0 +1,21 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Transitions `dest` toward `source` one batch of pixels at a time, in a
+ * deterministic pseudo-random order — the classic dissolve wipe. Each call
+ * dissolves up to `pixelCount` not-yet-dissolved pixels and returns the next
+ * seed; pass that value back on the following call to continue the wipe without
+ * revisiting any pixel. Start a fresh dissolve with `seed = 0`. Once every pixel
+ * has dissolved the returned seed is terminal: further calls with it are no-ops.
+ *
+ * `seed` is an opaque progress cursor over a fixed permutation of the region's
+ * pixels, not a color or coordinate. The dissolve order is fully deterministic
+ * in the region's dimensions.
+ *
+ * When `source` is the same region as `dest` (same surface and identical
+ * bounds), dissolved pixels are set to `fillColor` (packed `0xRRGGBBAA`);
+ * otherwise each is copied from the matching pixel in
+ * `source` and `fillColor` is ignored. Pixels that fall outside the surface are
+ * clipped but still consume a step of the sequence.
+ */
+export declare function dissolveSurfacePixels(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, seed: number, pixelCount: number, fillColor?: number): number;
+//# sourceMappingURL=surfaceDissolve.d.ts.map

package/dist/surfaceDissolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceDissolve.d.ts","sourceRoot":"","sources":["../src/surfaceDissolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAU,GACpB,MAAM,CAkER"}

package/dist/surfaceDissolve.js

@@ -0,0 +1,97 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Transitions `dest` toward `source` one batch of pixels at a time, in a
+ * deterministic pseudo-random order — the classic dissolve wipe. Each call
+ * dissolves up to `pixelCount` not-yet-dissolved pixels and returns the next
+ * seed; pass that value back on the following call to continue the wipe without
+ * revisiting any pixel. Start a fresh dissolve with `seed = 0`. Once every pixel
+ * has dissolved the returned seed is terminal: further calls with it are no-ops.
+ *
+ * `seed` is an opaque progress cursor over a fixed permutation of the region's
+ * pixels, not a color or coordinate. The dissolve order is fully deterministic
+ * in the region's dimensions.
+ *
+ * When `source` is the same region as `dest` (same surface and identical
+ * bounds), dissolved pixels are set to `fillColor` (packed `0xRRGGBBAA`);
+ * otherwise each is copied from the matching pixel in
+ * `source` and `fillColor` is ignored. Pixels that fall outside the surface are
+ * clipped but still consume a step of the sequence.
+ */
+export function dissolveSurfacePixels(dest, source, seed, pixelCount, fillColor = 0) {
+    const width = dest.width;
+    const height = dest.height;
+    const total = width * height;
+    if (total <= 0)
+        return seed;
+    let bits = 0;
+    while (1 << bits < total)
+        bits++;
+    const period = 1 << bits;
+    const mask = period - 1;
+    let cursor = seed < 0 ? 0 : seed > period ? period : seed | 0;
+    if (pixelCount <= 0)
+        return cursor;
+    const toFill = source.surface === dest.surface &&
+        source.x === dest.x &&
+        source.y === dest.y &&
+        source.width === dest.width &&
+        source.height === dest.height;
+    const fillR = (fillColor >>> 24) & 0xff;
+    const fillG = (fillColor >> 16) & 0xff;
+    const fillB = (fillColor >> 8) & 0xff;
+    const fillA = fillColor & 0xff;
+    const destData = dest.surface.data;
+    const destStride = dest.surface.width;
+    const destSurfaceHeight = dest.surface.height;
+    const sourceData = source.surface.data;
+    const sourceStride = source.surface.width;
+    const sourceSurfaceHeight = source.surface.height;
+    let dissolved = 0;
+    while (dissolved < pixelCount && cursor < period) {
+        const pixelIndex = permutePixelIndex(cursor, bits, mask);
+        cursor++;
+        if (pixelIndex >= total)
+            continue;
+        dissolved++;
+        const px = pixelIndex % width;
+        const py = (pixelIndex / width) | 0;
+        const dx = dest.x + px;
+        const dy = dest.y + py;
+        if (dx < 0 || dx >= destStride || dy < 0 || dy >= destSurfaceHeight)
+            continue;
+        const di = (dy * destStride + dx) * 4;
+        if (toFill) {
+            destData[di] = fillR;
+            destData[di + 1] = fillG;
+            destData[di + 2] = fillB;
+            destData[di + 3] = fillA;
+            continue;
+        }
+        const sx = source.x + px;
+        const sy = source.y + py;
+        if (sx < 0 || sx >= sourceStride || sy < 0 || sy >= sourceSurfaceHeight)
+            continue;
+        const si = (sy * sourceStride + sx) * 4;
+        destData[di] = sourceData[si];
+        destData[di + 1] = sourceData[si + 1];
+        destData[di + 2] = sourceData[si + 2];
+        destData[di + 3] = sourceData[si + 3];
+    }
+    invalidateImageResource(dest.surface);
+    return cursor;
+}
+// Bijection on [0, 2^bits): a composition of multiply-by-odd (invertible mod
+// 2^bits), xor-shift, and xor-constant, each individually reversible. Walking
+// `cursor` across the full period therefore visits every index in [0, total)
+// exactly once (cycle-walking skips the indices >= total), which is what
+// guarantees a dissolve eventually covers the whole region without repeats.
+function permutePixelIndex(cursor, bits, mask) {
+    let v = cursor & mask;
+    const shift = bits > 1 ? bits >> 1 : 1;
+    v = Math.imul(v, 0x9e3779b1) & mask;
+    v ^= v >>> shift;
+    v = Math.imul(v, 0x85ebca77) & mask;
+    v ^= 0x27d4eb2f & mask;
+    return v & mask;
+}
+//# sourceMappingURL=surfaceDissolve.js.map

package/dist/surfaceDissolve.js.map

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

package/dist/surfaceDraw.d.ts

@@ -0,0 +1,8 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Draws the `source` region onto a 2D canvas at `(x, y)` via `putImageData`.
+ * A region with a zero dimension is a no-op (`ImageData` requires positive
+ * dimensions).
+ */
+export declare function drawSurface(dest: HTMLCanvasElement, source: Readonly<SurfaceRegion>, x: number, y: number): void;
+//# sourceMappingURL=surfaceDraw.d.ts.map

package/dist/surfaceDraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceDraw.d.ts","sourceRoot":"","sources":["../src/surfaceDraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAKhH"}

package/dist/surfaceDraw.js

@@ -0,0 +1,14 @@
+import { extractSurfacePixels } from './surfaceComposite';
+/**
+ * Draws the `source` region onto a 2D canvas at `(x, y)` via `putImageData`.
+ * A region with a zero dimension is a no-op (`ImageData` requires positive
+ * dimensions).
+ */
+export function drawSurface(dest, source, x, y) {
+    if (source.width <= 0 || source.height <= 0)
+        return;
+    const domImageData = new globalThis.ImageData(source.width, source.height);
+    extractSurfacePixels(domImageData.data, source);
+    dest.getContext('2d').putImageData(domImageData, x, y);
+}
+//# sourceMappingURL=surfaceDraw.js.map

package/dist/surfaceDraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceDraw.js","sourceRoot":"","sources":["../src/surfaceDraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAAuB,EAAE,MAA+B,EAAE,CAAS,EAAE,CAAS;IACxG,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO;IACpD,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3E,oBAAoB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/surfaceEncode.d.ts

@@ -0,0 +1,3 @@
+import type { ImageFormat, Surface } from '@flighthq/types';
+export declare function encodeSurface(source: Readonly<Surface>, format?: ImageFormat, quality?: number): Uint8Array;
+//# sourceMappingURL=surfaceEncode.d.ts.map

package/dist/surfaceEncode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceEncode.d.ts","sourceRoot":"","sources":["../src/surfaceEncode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE5D,wBAAgB,aAAa,CAC3B,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EACzB,MAAM,GAAE,WAAmB,EAC3B,OAAO,GAAE,MAAY,GACpB,UAAU,CAgBZ"}

package/dist/surfaceEncode.js

@@ -0,0 +1,18 @@
+export function encodeSurface(source, format = 'png', quality = 0.9) {
+    const canvas = document.createElement('canvas');
+    canvas.width = source.width;
+    canvas.height = source.height;
+    const domImageData = new globalThis.ImageData(source.width, source.height);
+    domImageData.data.set(source.data);
+    canvas.getContext('2d').putImageData(domImageData, 0, 0);
+    const mimeType = format === 'jpeg' ? 'image/jpeg' : 'image/png';
+    const dataUrl = canvas.toDataURL(mimeType, quality);
+    const base64 = dataUrl.slice(dataUrl.indexOf(',') + 1);
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+//# sourceMappingURL=surfaceEncode.js.map

package/dist/surfaceEncode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceEncode.js","sourceRoot":"","sources":["../src/surfaceEncode.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAC3B,MAAyB,EACzB,SAAsB,KAAK,EAC3B,UAAkB,GAAG;IAErB,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3E,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,CAAC;IAChE,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/surfaceFill.d.ts

@@ -0,0 +1,12 @@
+import type { Surface, SurfaceRegion } from '@flighthq/types';
+/**
+ * Fills the rectangular `dest` region with a packed RGBA `color`. Pixels of the
+ * region that fall outside the surface are skipped.
+ */
+export declare function fillSurfaceRectangle(dest: Readonly<SurfaceRegion>, color: number): void;
+/**
+ * Flood-fills a connected region of `out` starting at `(x, y)`. Uses a
+ * module-level visited buffer that grows as needed and is reused across calls.
+ */
+export declare function floodFillSurface(out: Surface, x: number, y: number, color: number): void;
+//# sourceMappingURL=surfaceFill.d.ts.map

package/dist/surfaceFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFill.d.ts","sourceRoot":"","sources":["../src/surfaceFill.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI9D;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAmBvF;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAuDxF"}

package/dist/surfaceFill.js

@@ -0,0 +1,85 @@
+import { invalidateImageResource } from '@flighthq/image';
+let _floodFillVisited = null;
+/**
+ * Fills the rectangular `dest` region with a packed RGBA `color`. Pixels of the
+ * region that fall outside the surface are skipped.
+ */
+export function fillSurfaceRectangle(dest, color) {
+    const r = (color >>> 24) & 0xff;
+    const g = (color >> 16) & 0xff;
+    const b = (color >> 8) & 0xff;
+    const a = color & 0xff;
+    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 >= dest.surface.width)
+                continue;
+            const i = (y * dest.surface.width + x) * 4;
+            dest.surface.data[i] = r;
+            dest.surface.data[i + 1] = g;
+            dest.surface.data[i + 2] = b;
+            dest.surface.data[i + 3] = a;
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Flood-fills a connected region of `out` starting at `(x, y)`. Uses a
+ * module-level visited buffer that grows as needed and is reused across calls.
+ */
+export function floodFillSurface(out, x, y, color) {
+    if (x < 0 || x >= out.width || y < 0 || y >= out.height)
+        return;
+    const fillR = (color >>> 24) & 0xff;
+    const fillG = (color >> 16) & 0xff;
+    const fillB = (color >> 8) & 0xff;
+    const fillA = color & 0xff;
+    const targetI = (y * out.width + x) * 4;
+    const targetR = out.data[targetI];
+    const targetG = out.data[targetI + 1];
+    const targetB = out.data[targetI + 2];
+    const targetA = out.data[targetI + 3];
+    if (targetR === fillR && targetG === fillG && targetB === fillB && targetA === fillA)
+        return;
+    const needed = out.width * out.height;
+    if (_floodFillVisited === null || _floodFillVisited.length < needed) {
+        _floodFillVisited = new Uint8Array(needed);
+    }
+    else {
+        _floodFillVisited.fill(0, 0, needed);
+    }
+    const visited = _floodFillVisited;
+    const stack = [x + y * out.width];
+    while (stack.length > 0) {
+        const idx = stack.pop();
+        if (visited[idx])
+            continue;
+        visited[idx] = 1;
+        const px = idx % out.width;
+        const py = Math.floor(idx / out.width);
+        const i = idx * 4;
+        if (out.data[i] !== targetR ||
+            out.data[i + 1] !== targetG ||
+            out.data[i + 2] !== targetB ||
+            out.data[i + 3] !== targetA) {
+            continue;
+        }
+        out.data[i] = fillR;
+        out.data[i + 1] = fillG;
+        out.data[i + 2] = fillB;
+        out.data[i + 3] = fillA;
+        if (px > 0)
+            stack.push(idx - 1);
+        if (px < out.width - 1)
+            stack.push(idx + 1);
+        if (py > 0)
+            stack.push(idx - out.width);
+        if (py < out.height - 1)
+            stack.push(idx + out.width);
+    }
+    invalidateImageResource(out);
+}
+//# sourceMappingURL=surfaceFill.js.map

package/dist/surfaceFill.js.map

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

package/dist/surfaceFingerprint.d.ts

@@ -0,0 +1,26 @@
+import type { Surface, SurfaceFingerprint } from '@flighthq/types';
+/**
+ * The mean absolute per-channel difference (0..255) between two fingerprints of the same gridSize.
+ * Threshold it to gate regressions: ~0 is identical, small single digits are antialiasing/noise,
+ * large values mean a real visual change. Throws if the gridSizes differ — they are not comparable.
+ */
+export declare function compareSurfaceFingerprints(a: Readonly<SurfaceFingerprint>, b: Readonly<SurfaceFingerprint>): number;
+/**
+ * Reduces a surface to a gridSize × gridSize grid of averaged RGB cells. Each cell averages the RGB
+ * of the source pixels that fall in it (alpha is ignored — visible colour is what regressions show
+ * up in). gridSize controls fidelity vs. text size; the default of 16 catches layout/colour shifts
+ * while staying ~1 KB as text. An empty surface yields an all-zero grid.
+ */
+export declare function createSurfaceFingerprint(source: Readonly<Surface>, gridSize?: number): SurfaceFingerprint;
+/**
+ * Serializes a fingerprint to a compact, git-diffable text line: `<gridSize>:<hex cells>`. This is
+ * what gets committed as a regression baseline instead of a screenshot.
+ */
+export declare function formatSurfaceFingerprint(fingerprint: Readonly<SurfaceFingerprint>): string;
+/**
+ * Parses the text form produced by formatSurfaceFingerprint. Returns `null` for malformed input
+ * (wrong shape, odd hex length, or a cell count that is not gridSize × gridSize × 3) so callers can
+ * treat a corrupt baseline as "no baseline" rather than crashing.
+ */
+export declare function parseSurfaceFingerprint(text: string): SurfaceFingerprint | null;
+//# sourceMappingURL=surfaceFingerprint.d.ts.map

package/dist/surfaceFingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFingerprint.d.ts","sourceRoot":"","sources":["../src/surfaceFingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAQnE;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAQnH;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAE,MAAW,GAAG,kBAAkB,CAkC7G;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAO1F;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAiB/E"}

package/dist/surfaceFingerprint.js

@@ -0,0 +1,99 @@
+// A coarse downscaled RGB fingerprint: the surface is averaged into a gridSize × gridSize grid, so
+// antialiasing jitter that breaks an exact hash washes out while gross changes still register. The
+// committed regression baseline is the hex-encoded form (formatSurfaceFingerprint), not a PNG.
+const HEX = '0123456789abcdef';
+/**
+ * The mean absolute per-channel difference (0..255) between two fingerprints of the same gridSize.
+ * Threshold it to gate regressions: ~0 is identical, small single digits are antialiasing/noise,
+ * large values mean a real visual change. Throws if the gridSizes differ — they are not comparable.
+ */
+export function compareSurfaceFingerprints(a, b) {
+    if (a.gridSize !== b.gridSize) {
+        throw new Error(`compareSurfaceFingerprints: gridSize mismatch (${a.gridSize} vs ${b.gridSize})`);
+    }
+    if (a.cells.length === 0)
+        return 0;
+    let sum = 0;
+    for (let i = 0; i < a.cells.length; i++)
+        sum += Math.abs(a.cells[i] - b.cells[i]);
+    return sum / a.cells.length;
+}
+/**
+ * Reduces a surface to a gridSize × gridSize grid of averaged RGB cells. Each cell averages the RGB
+ * of the source pixels that fall in it (alpha is ignored — visible colour is what regressions show
+ * up in). gridSize controls fidelity vs. text size; the default of 16 catches layout/colour shifts
+ * while staying ~1 KB as text. An empty surface yields an all-zero grid.
+ */
+export function createSurfaceFingerprint(source, gridSize = 16) {
+    if (gridSize < 1)
+        throw new Error(`createSurfaceFingerprint: gridSize must be >= 1 (got ${gridSize})`);
+    const cells = new Uint8Array(gridSize * gridSize * 3);
+    const { width, height, data } = source;
+    if (width === 0 || height === 0)
+        return { gridSize, cells };
+    for (let cy = 0; cy < gridSize; cy++) {
+        const y0 = Math.floor((cy * height) / gridSize);
+        const y1 = Math.max(y0 + 1, Math.floor(((cy + 1) * height) / gridSize));
+        for (let cx = 0; cx < gridSize; cx++) {
+            const x0 = Math.floor((cx * width) / gridSize);
+            const x1 = Math.max(x0 + 1, Math.floor(((cx + 1) * width) / gridSize));
+            let sumR = 0;
+            let sumG = 0;
+            let sumB = 0;
+            let count = 0;
+            for (let y = y0; y < y1 && y < height; y++) {
+                let i = (y * width + x0) * 4;
+                for (let x = x0; x < x1 && x < width; x++) {
+                    sumR += data[i];
+                    sumG += data[i + 1];
+                    sumB += data[i + 2];
+                    count++;
+                    i += 4;
+                }
+            }
+            const c = (cy * gridSize + cx) * 3;
+            cells[c] = count === 0 ? 0 : Math.round(sumR / count);
+            cells[c + 1] = count === 0 ? 0 : Math.round(sumG / count);
+            cells[c + 2] = count === 0 ? 0 : Math.round(sumB / count);
+        }
+    }
+    return { gridSize, cells };
+}
+/**
+ * Serializes a fingerprint to a compact, git-diffable text line: `<gridSize>:<hex cells>`. This is
+ * what gets committed as a regression baseline instead of a screenshot.
+ */
+export function formatSurfaceFingerprint(fingerprint) {
+    const cells = fingerprint.cells;
+    let hex = '';
+    for (let i = 0; i < cells.length; i++) {
+        hex += HEX[(cells[i] >> 4) & 0xf] + HEX[cells[i] & 0xf];
+    }
+    return `${fingerprint.gridSize}:${hex}`;
+}
+/**
+ * Parses the text form produced by formatSurfaceFingerprint. Returns `null` for malformed input
+ * (wrong shape, odd hex length, or a cell count that is not gridSize × gridSize × 3) so callers can
+ * treat a corrupt baseline as "no baseline" rather than crashing.
+ */
+export function parseSurfaceFingerprint(text) {
+    const colon = text.indexOf(':');
+    if (colon <= 0)
+        return null;
+    const gridSize = Number.parseInt(text.slice(0, colon), 10);
+    if (!Number.isInteger(gridSize) || gridSize < 1)
+        return null;
+    const hex = text.slice(colon + 1);
+    if (hex.length !== gridSize * gridSize * 3 * 2)
+        return null;
+    const cells = new Uint8Array(hex.length / 2);
+    for (let i = 0; i < cells.length; i++) {
+        const hi = HEX.indexOf(hex[i * 2]);
+        const lo = HEX.indexOf(hex[i * 2 + 1]);
+        if (hi < 0 || lo < 0)
+            return null;
+        cells[i] = (hi << 4) | lo;
+    }
+    return { gridSize, cells };
+}
+//# sourceMappingURL=surfaceFingerprint.js.map

package/dist/surfaceFingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFingerprint.js","sourceRoot":"","sources":["../src/surfaceFingerprint.ts"],"names":[],"mappings":"AAEA,mGAAmG;AACnG,mGAAmG;AACnG,+FAA+F;AAE/F,MAAM,GAAG,GAAG,kBAAkB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,CAA+B,EAAE,CAA+B;IACzG,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC;IACpG,CAAC;IACD,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACnC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;QAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,OAAO,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAAyB,EAAE,WAAmB,EAAE;IACvF,IAAI,QAAQ,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,QAAQ,GAAG,CAAC,CAAC;IAEvG,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC;IACtD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IACvC,IAAI,KAAK,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IAE5D,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;QACxE,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,QAAQ,EAAE,EAAE,EAAE,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC;YAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC;YACvE,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,IAAI,GAAG,CAAC,CAAC;YACb,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3C,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;gBAC7B,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;oBAC1C,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;oBAChB,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACpB,IAAI,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;oBACpB,KAAK,EAAE,CAAC;oBACR,CAAC,IAAI,CAAC,CAAC;gBACT,CAAC;YACH,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;YACnC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;YACtD,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;YAC1D,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAyC;IAChF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;IAChC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,WAAW,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE7D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClC,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5D,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAClC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/surfaceFlip.d.ts

@@ -0,0 +1,16 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Mirrors the `source` region left-to-right into the `dest` region. The mirror
+ * size is the overlap of the two regions. Safe to pass the same surface and
+ * region in `dest` and `source` for an in-place flip — when aliased, columns
+ * are swapped in pairs; otherwise `dest` and `source` must not overlap.
+ */
+export declare function flipSurfaceHorizontal(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+/**
+ * Mirrors the `source` region top-to-bottom into the `dest` region. The mirror
+ * size is the overlap of the two regions. Safe to pass the same surface and
+ * region in `dest` and `source` for an in-place flip — when aliased, rows are
+ * swapped in pairs; otherwise `dest` and `source` must not overlap.
+ */
+export declare function flipSurfaceVertical(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+//# sourceMappingURL=surfaceFlip.d.ts.map

package/dist/surfaceFlip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFlip.d.ts","sourceRoot":"","sources":["../src/surfaceFlip.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAqB1G;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAqBxG"}