@flighthq/bitmap 0.3.0-next.1021.f5f1ee0

package/dist/bitmapDissolve.js

@@ -0,0 +1,97 @@
+import { invalidateBitmap } from './bitmap';
+/**
+ * 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 bitmap 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 bitmap are
+ * clipped but still consume a step of the sequence.
+ */
+export function dissolveBitmapPixels(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.bitmap === dest.bitmap &&
+        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.bitmap.data;
+    const destStride = dest.bitmap.width;
+    const destBitmapHeight = dest.bitmap.height;
+    const sourceData = source.bitmap.data;
+    const sourceStride = source.bitmap.width;
+    const sourceBitmapHeight = source.bitmap.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 >= destBitmapHeight)
+            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 >= sourceBitmapHeight)
+            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];
+    }
+    invalidateBitmap(dest.bitmap);
+    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=bitmapDissolve.js.map

package/dist/bitmapDissolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapDissolve.js","sourceRoot":"","sources":["../src/bitmapDissolve.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAA4B,EAC5B,MAA8B,EAC9B,IAAY,EACZ,UAAkB,EAClB,YAAoB,CAAC;IAErB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACzB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC3B,MAAM,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC7B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE5B,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,OAAO,CAAC,IAAI,IAAI,GAAG,KAAK;QAAE,IAAI,EAAE,CAAC;IACjC,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,CAAC;IAExB,IAAI,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IAC9D,IAAI,UAAU,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAEnC,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC7B,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK;QAC3B,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;IAChC,MAAM,KAAK,GAAG,CAAC,SAAS,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IACxC,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACvC,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACtC,MAAM,KAAK,GAAG,SAAS,GAAG,IAAI,CAAC;IAE/B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IACrC,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5C,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;IACtC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;IACzC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;IAEhD,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,OAAO,SAAS,GAAG,UAAU,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;QACjD,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,EAAE,CAAC;QACT,IAAI,UAAU,IAAI,KAAK;YAAE,SAAS;QAClC,SAAS,EAAE,CAAC;QAEZ,MAAM,EAAE,GAAG,UAAU,GAAG,KAAK,CAAC;QAC9B,MAAM,EAAE,GAAG,CAAC,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,UAAU,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,gBAAgB;YAAE,SAAS;QAC7E,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,UAAU,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QAEtC,IAAI,MAAM,EAAE,CAAC;YACX,QAAQ,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;YACrB,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YACzB,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YACzB,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;YACzB,SAAS;QACX,CAAC;QAED,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QACzB,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,kBAAkB;YAAE,SAAS;QACjF,MAAM,EAAE,GAAG,CAAC,EAAE,GAAG,YAAY,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;QACxC,QAAQ,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QACtC,QAAQ,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,8EAA8E;AAC9E,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,SAAS,iBAAiB,CAAC,MAAc,EAAE,IAAY,EAAE,IAAY;IACnE,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IACpC,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC;IACjB,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,IAAI,CAAC;IACpC,CAAC,IAAI,UAAU,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,GAAG,IAAI,CAAC;AAClB,CAAC"}

package/dist/bitmapDraw.d.ts

@@ -0,0 +1,8 @@
+import type { BitmapRegion } from '@flighthq/types/contract';
+/**
+ * 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 drawBitmap(dest: HTMLCanvasElement, source: Readonly<BitmapRegion>, x: number, y: number): void;
+//# sourceMappingURL=bitmapDraw.d.ts.map

package/dist/bitmapDraw.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapDraw.d.ts","sourceRoot":"","sources":["../src/bitmapDraw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAK9G"}

package/dist/bitmapDraw.js

@@ -0,0 +1,14 @@
+import { extractBitmapPixels } from './bitmapComposite';
+/**
+ * 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 drawBitmap(dest, source, x, y) {
+    if (source.width <= 0 || source.height <= 0)
+        return;
+    const domImageData = new globalThis.ImageData(source.width, source.height);
+    extractBitmapPixels(domImageData.data, source);
+    dest.getContext('2d').putImageData(domImageData, x, y);
+}
+//# sourceMappingURL=bitmapDraw.js.map

package/dist/bitmapDraw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapDraw.js","sourceRoot":"","sources":["../src/bitmapDraw.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,IAAuB,EAAE,MAA8B,EAAE,CAAS,EAAE,CAAS;IACtG,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,mBAAmB,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/bitmapEncode.d.ts

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

package/dist/bitmapEncode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapEncode.d.ts","sourceRoot":"","sources":["../src/bitmapEncode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEpE,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAE,WAAmB,EAAE,OAAO,GAAE,MAAY,GAAG,UAAU,CAgBrH"}

package/dist/bitmapEncode.js

@@ -0,0 +1,18 @@
+export function encodeBitmap(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=bitmapEncode.js.map

package/dist/bitmapEncode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapEncode.js","sourceRoot":"","sources":["../src/bitmapEncode.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,MAAwB,EAAE,SAAsB,KAAK,EAAE,UAAkB,GAAG;IACvG,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/bitmapFill.d.ts

@@ -0,0 +1,12 @@
+import type { Bitmap, BitmapRegion } from '@flighthq/types/contract';
+/**
+ * Fills the rectangular `dest` region with a packed RGBA `color`. Pixels of the
+ * region that fall outside the bitmap are skipped.
+ */
+export declare function fillBitmapRectangle(dest: Readonly<BitmapRegion>, 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 floodFillBitmap(out: Bitmap, x: number, y: number, color: number): void;
+//# sourceMappingURL=bitmapFill.d.ts.map

package/dist/bitmapFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFill.d.ts","sourceRoot":"","sources":["../src/bitmapFill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAMrE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAmBrF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAuDtF"}

package/dist/bitmapFill.js

@@ -0,0 +1,85 @@
+import { invalidateBitmap } from './bitmap';
+let _floodFillVisited = null;
+/**
+ * Fills the rectangular `dest` region with a packed RGBA `color`. Pixels of the
+ * region that fall outside the bitmap are skipped.
+ */
+export function fillBitmapRectangle(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.bitmap.height)
+            continue;
+        for (let px = 0; px < dest.width; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= dest.bitmap.width)
+                continue;
+            const i = (y * dest.bitmap.width + x) * 4;
+            dest.bitmap.data[i] = r;
+            dest.bitmap.data[i + 1] = g;
+            dest.bitmap.data[i + 2] = b;
+            dest.bitmap.data[i + 3] = a;
+        }
+    }
+    invalidateBitmap(dest.bitmap);
+}
+/**
+ * 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 floodFillBitmap(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);
+    }
+    invalidateBitmap(out);
+}
+//# sourceMappingURL=bitmapFill.js.map

package/dist/bitmapFill.js.map

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

package/dist/bitmapFingerprint.d.ts

@@ -0,0 +1,26 @@
+import type { Bitmap, BitmapFingerprint } from '@flighthq/types/contract';
+/**
+ * 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 compareBitmapFingerprints(a: Readonly<BitmapFingerprint>, b: Readonly<BitmapFingerprint>): number;
+/**
+ * Reduces a bitmap 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 bitmap yields an all-zero grid.
+ */
+export declare function createBitmapFingerprint(source: Readonly<Bitmap>, gridSize?: number): BitmapFingerprint;
+/**
+ * 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 formatBitmapFingerprint(fingerprint: Readonly<BitmapFingerprint>): string;
+/**
+ * Parses the text form produced by formatBitmapFingerprint. 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 parseBitmapFingerprint(text: string): BitmapFingerprint | null;
+//# sourceMappingURL=bitmapFingerprint.d.ts.map

package/dist/bitmapFingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFingerprint.d.ts","sourceRoot":"","sources":["../src/bitmapFingerprint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAQ1E;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAQhH;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAE,MAAW,GAAG,iBAAiB,CAkC1G;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,MAAM,CAOxF;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAiB7E"}

package/dist/bitmapFingerprint.js

@@ -0,0 +1,99 @@
+// A coarse downscaled RGB fingerprint: the bitmap 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 (formatBitmapFingerprint), 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 compareBitmapFingerprints(a, b) {
+    if (a.gridSize !== b.gridSize) {
+        throw new Error(`compareBitmapFingerprints: 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 bitmap 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 bitmap yields an all-zero grid.
+ */
+export function createBitmapFingerprint(source, gridSize = 16) {
+    if (gridSize < 1)
+        throw new Error(`createBitmapFingerprint: 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 formatBitmapFingerprint(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 formatBitmapFingerprint. 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 parseBitmapFingerprint(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=bitmapFingerprint.js.map

package/dist/bitmapFingerprint.js.map

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

package/dist/bitmapFlip.d.ts

@@ -0,0 +1,16 @@
+import type { BitmapRegion } from '@flighthq/types/contract';
+/**
+ * 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 bitmap 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 flipBitmapHorizontal(dest: Readonly<BitmapRegion>, source: Readonly<BitmapRegion>): 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 bitmap 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 flipBitmapVertical(dest: Readonly<BitmapRegion>, source: Readonly<BitmapRegion>): void;
+//# sourceMappingURL=bitmapFlip.d.ts.map

package/dist/bitmapFlip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFlip.d.ts","sourceRoot":"","sources":["../src/bitmapFlip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAqBvG;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAqBrG"}

package/dist/bitmapFlip.js

@@ -0,0 +1,98 @@
+import { invalidateBitmap } from './bitmap';
+/**
+ * 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 bitmap 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 function flipBitmapHorizontal(dest, source) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const data = dest.bitmap.data;
+    const stride = dest.bitmap.width;
+    if (isSameRegion(dest, source)) {
+        const half = w >> 1;
+        for (let py = 0; py < h; py++) {
+            const y = dest.y + py;
+            if (y < 0 || y >= dest.bitmap.height)
+                continue;
+            for (let px = 0; px < half; px++) {
+                const xa = dest.x + px;
+                const xb = dest.x + (w - 1 - px);
+                if (xa < 0 || xa >= stride || xb < 0 || xb >= stride)
+                    continue;
+                swapPixels(data, (y * stride + xa) * 4, (y * stride + xb) * 4);
+            }
+        }
+        return;
+    }
+    copyMirrored(dest, source, w, h, true, false);
+    invalidateBitmap(dest.bitmap);
+}
+/**
+ * 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 bitmap 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 function flipBitmapVertical(dest, source) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const data = dest.bitmap.data;
+    const stride = dest.bitmap.width;
+    if (isSameRegion(dest, source)) {
+        const half = h >> 1;
+        for (let py = 0; py < half; py++) {
+            const yTop = dest.y + py;
+            const yBottom = dest.y + (h - 1 - py);
+            if (yTop < 0 || yTop >= dest.bitmap.height || yBottom < 0 || yBottom >= dest.bitmap.height)
+                continue;
+            for (let px = 0; px < w; px++) {
+                const x = dest.x + px;
+                if (x < 0 || x >= stride)
+                    continue;
+                swapPixels(data, (yTop * stride + x) * 4, (yBottom * stride + x) * 4);
+            }
+        }
+        return;
+    }
+    copyMirrored(dest, source, w, h, false, true);
+    invalidateBitmap(dest.bitmap);
+}
+// Copies source -> dest with optional per-axis mirroring. Used for the
+// non-aliased flip path (distinct bitmaps or non-overlapping regions).
+function copyMirrored(dest, source, w, h, mirrorX, mirrorY) {
+    const sd = source.bitmap.data;
+    const dd = dest.bitmap.data;
+    const sStride = source.bitmap.width;
+    const dStride = dest.bitmap.width;
+    for (let py = 0; py < h; py++) {
+        const sy = source.y + (mirrorY ? h - 1 - py : py);
+        const dy = dest.y + py;
+        if (sy < 0 || sy >= source.bitmap.height || dy < 0 || dy >= dest.bitmap.height)
+            continue;
+        for (let px = 0; px < w; px++) {
+            const sx = source.x + (mirrorX ? w - 1 - px : px);
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= sStride || dx < 0 || dx >= dStride)
+                continue;
+            const si = (sy * sStride + sx) * 4;
+            const di = (dy * dStride + dx) * 4;
+            dd[di] = sd[si];
+            dd[di + 1] = sd[si + 1];
+            dd[di + 2] = sd[si + 2];
+            dd[di + 3] = sd[si + 3];
+        }
+    }
+}
+function isSameRegion(a, b) {
+    return a.bitmap === b.bitmap && a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+}
+function swapPixels(data, a, b) {
+    for (let c = 0; c < 4; c++) {
+        const t = data[a + c];
+        data[a + c] = data[b + c];
+        data[b + c] = t;
+    }
+}
+//# sourceMappingURL=bitmapFlip.js.map

package/dist/bitmapFlip.js.map

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

package/dist/bitmapFormat.d.ts

@@ -0,0 +1,26 @@
+import type { PixelOrder } from '@flighthq/types/contract';
+/**
+ * Converts a packed pixel buffer from one channel order to another.
+ * Safe to pass the same buffer as both `out` and `source` — all four
+ * channels are read into locals before any write.
+ */
+export declare function convertBitmapPixelOrder(out: Uint8ClampedArray, source: Readonly<Uint8ClampedArray>, length: number, from: PixelOrder, to: PixelOrder): void;
+/**
+ * Converts straight-alpha pixels to premultiplied alpha in place or into
+ * a separate buffer. RGB channels are multiplied by alpha/255.
+ * Safe to pass the same buffer as both `out` and `source`.
+ *
+ * Operates on a raw buffer, not a Bitmap — if the buffer belongs to an
+ * ImageResource, set its `alphaType` to `premultiplied` to keep it truthful.
+ */
+export declare function premultiplyBitmapPixels(out: Uint8ClampedArray, source: Readonly<Uint8ClampedArray>, length: number): void;
+/**
+ * Converts premultiplied-alpha pixels back to straight alpha in place or
+ * into a separate buffer. Pixels with alpha=0 are written as (0,0,0,0).
+ * Safe to pass the same buffer as both `out` and `source`.
+ *
+ * Operates on a raw buffer, not a Bitmap — if the buffer belongs to an
+ * ImageResource, set its `alphaType` to `straight` to keep it truthful.
+ */
+export declare function unpremultiplyBitmapPixels(out: Uint8ClampedArray, source: Readonly<Uint8ClampedArray>, length: number): void;
+//# sourceMappingURL=bitmapFormat.d.ts.map

package/dist/bitmapFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFormat.d.ts","sourceRoot":"","sources":["../src/bitmapFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,GACb,IAAI,CAiBN;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAQN;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAgBN"}