@flighthq/bitmap 0.3.0-edge.1458.0c01b63

package/dist/bitmapCopy.js

@@ -0,0 +1,78 @@
+import { invalidateBitmap } from './bitmap';
+/**
+ * Copies one channel of `source` into a channel of `dest`. The copied size is
+ * the overlap of the two regions; pixels outside either bitmap are skipped.
+ *
+ * Safe to pass the same bitmap in `dest` and `source` as long as `destChannel`
+ * and `sourceChannel` differ (each pixel writes a different byte than it reads).
+ * Copying a channel to itself is always a no-op regardless of aliasing.
+ */
+export function copyBitmapChannel(dest, destChannel, source, sourceChannel) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    for (let py = 0; py < h; py++) {
+        const sy = source.y + 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 + px;
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= source.bitmap.width || dx < 0 || dx >= dest.bitmap.width)
+                continue;
+            const si = (sy * source.bitmap.width + sx) * 4;
+            const di = (dy * dest.bitmap.width + dx) * 4;
+            dest.bitmap.data[di + destChannel] = source.bitmap.data[si + sourceChannel];
+        }
+    }
+    invalidateBitmap(dest.bitmap);
+}
+/**
+ * Copies `source` into `dest`. The copied size is the overlap of the two
+ * regions; pixels outside either bitmap are skipped. When `composite` is
+ * true, `source` is alpha-composited (Porter-Duff source-over) over `dest`
+ * instead of overwriting it.
+ *
+ * Safe to pass the same bitmap in `dest` and `source` when the regions do not
+ * overlap. Overlapping regions produce undefined results because pixels are
+ * written before all source reads are complete.
+ */
+export function copyBitmapPixels(dest, source, composite = false) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const sd = source.bitmap.data;
+    const dd = dest.bitmap.data;
+    for (let py = 0; py < h; py++) {
+        const sy = source.y + 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 + px;
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= source.bitmap.width || dx < 0 || dx >= dest.bitmap.width)
+                continue;
+            const si = (sy * source.bitmap.width + sx) * 4;
+            const di = (dy * dest.bitmap.width + dx) * 4;
+            if (composite) {
+                const srcA = sd[si + 3] / 255;
+                const dstA = dd[di + 3] / 255;
+                const outA = srcA + dstA * (1 - srcA);
+                if (outA > 0) {
+                    dd[di] = Math.round((sd[si] * srcA + dd[di] * dstA * (1 - srcA)) / outA);
+                    dd[di + 1] = Math.round((sd[si + 1] * srcA + dd[di + 1] * dstA * (1 - srcA)) / outA);
+                    dd[di + 2] = Math.round((sd[si + 2] * srcA + dd[di + 2] * dstA * (1 - srcA)) / outA);
+                    dd[di + 3] = Math.round(outA * 255);
+                }
+            }
+            else {
+                dd[di] = sd[si];
+                dd[di + 1] = sd[si + 1];
+                dd[di + 2] = sd[si + 2];
+                dd[di + 3] = sd[si + 3];
+            }
+        }
+    }
+    invalidateBitmap(dest.bitmap);
+}
+//# sourceMappingURL=bitmapCopy.js.map

package/dist/bitmapCopy.js.map

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

package/dist/bitmapCoverage.d.ts

@@ -0,0 +1,11 @@
+import type { Bitmap } from '@flighthq/types/contract';
+/**
+ * Returns the fraction of pixels (0..1) that differ from `backgroundColor` by more than
+ * `channelTolerance` on at least one RGBA channel. This is the "did anything render" signal: a blank
+ * frame (the whole bitmap still the clear colour, or fully transparent) returns ~0; a populated
+ * frame returns a meaningful fraction. `backgroundColor` is a packed 0xRRGGBBAA value — pass the
+ * render state's clear colour. `channelTolerance` (0..255) absorbs antialiasing fringe around the
+ * cleared edges so a genuinely empty frame does not creep above zero.
+ */
+export declare function getBitmapCoverage(source: Readonly<Bitmap>, backgroundColor: number, channelTolerance?: number): number;
+//# sourceMappingURL=bitmapCoverage.d.ts.map

package/dist/bitmapCoverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapCoverage.d.ts","sourceRoot":"","sources":["../src/bitmapCoverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,eAAe,EAAE,MAAM,EACvB,gBAAgB,GAAE,MAAU,GAC3B,MAAM,CAqBR"}

package/dist/bitmapCoverage.js

@@ -0,0 +1,29 @@
+/**
+ * Returns the fraction of pixels (0..1) that differ from `backgroundColor` by more than
+ * `channelTolerance` on at least one RGBA channel. This is the "did anything render" signal: a blank
+ * frame (the whole bitmap still the clear colour, or fully transparent) returns ~0; a populated
+ * frame returns a meaningful fraction. `backgroundColor` is a packed 0xRRGGBBAA value — pass the
+ * render state's clear colour. `channelTolerance` (0..255) absorbs antialiasing fringe around the
+ * cleared edges so a genuinely empty frame does not creep above zero.
+ */
+export function getBitmapCoverage(source, backgroundColor, channelTolerance = 0) {
+    const br = (backgroundColor >>> 24) & 0xff;
+    const bg = (backgroundColor >> 16) & 0xff;
+    const bb = (backgroundColor >> 8) & 0xff;
+    const ba = backgroundColor & 0xff;
+    const data = source.data;
+    const totalPixels = source.width * source.height;
+    if (totalPixels === 0)
+        return 0;
+    let covered = 0;
+    for (let i = 0; i < data.length; i += 4) {
+        if (Math.abs(data[i] - br) > channelTolerance ||
+            Math.abs(data[i + 1] - bg) > channelTolerance ||
+            Math.abs(data[i + 2] - bb) > channelTolerance ||
+            Math.abs(data[i + 3] - ba) > channelTolerance) {
+            covered++;
+        }
+    }
+    return covered / totalPixels;
+}
+//# sourceMappingURL=bitmapCoverage.js.map

package/dist/bitmapCoverage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapCoverage.js","sourceRoot":"","sources":["../src/bitmapCoverage.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAAwB,EACxB,eAAuB,EACvB,mBAA2B,CAAC;IAE5B,MAAM,EAAE,GAAG,CAAC,eAAe,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAC3C,MAAM,EAAE,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAC1C,MAAM,EAAE,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACzC,MAAM,EAAE,GAAG,eAAe,GAAG,IAAI,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IACjD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IACE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,gBAAgB;YACzC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,gBAAgB;YAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,gBAAgB;YAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,gBAAgB,EAC7C,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,GAAG,WAAW,CAAC;AAC/B,CAAC"}

package/dist/bitmapCrop.d.ts

@@ -0,0 +1,33 @@
+import type { RectangleLike, Bitmap, BitmapEdgeMode } from '@flighthq/types/contract';
+/**
+ * Allocates a new `Bitmap` containing the pixels of `source` cropped to
+ * `rect`. `rect` coordinates are relative to the `source` bitmap origin
+ * (not to a region offset). Pixels of `rect` that fall outside the bitmap
+ * are filled with transparent black.
+ *
+ * Returns a new `Bitmap` with the same `colorSpace`, `alphaType`, and
+ * `format` as `source`, with dimensions equal to `rect.width × rect.height`.
+ */
+export declare function cropBitmap(source: Readonly<Bitmap>, rect: Readonly<RectangleLike>): Bitmap;
+/**
+ * Allocates a new `Bitmap` with `source` padded by `left`, `top`, `right`,
+ * and `bottom` pixels on each side. Added pixels are filled according to
+ * `edgeMode`:
+ * - `'transparent'` (default): filled with transparent black.
+ * - `'clamp'`: border pixels of `source` are repeated.
+ * - `'wrap'`: `source` is tiled.
+ * - `'mirror'`: `source` is mirrored at the edges.
+ *
+ * When `edgeMode` is `'transparent'`, the optional `fillColor` (packed RGBA,
+ * e.g. `0xffffffff` for opaque white) overrides the default transparent fill.
+ * It is ignored for all other edge modes.
+ */
+export declare function extendBitmap(source: Readonly<Bitmap>, left: number, top: number, right: number, bottom: number, edgeMode?: BitmapEdgeMode, fillColor?: number): Bitmap;
+/**
+ * Allocates a new `Bitmap` with the transparent border of `source` removed.
+ * Finds the tightest bounding box of all pixels with alpha > 0 and returns a
+ * new bitmap cropped to that box. If the entire bitmap is transparent,
+ * returns a 1×1 transparent bitmap.
+ */
+export declare function trimBitmap(source: Readonly<Bitmap>): Bitmap;
+//# sourceMappingURL=bitmapCrop.d.ts.map

package/dist/bitmapCrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapCrop.d.ts","sourceRoot":"","sources":["../src/bitmapCrop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAGtF;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,MAAM,CAiC1F;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,EACxB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,cAA8B,EACxC,SAAS,SAAI,GACZ,MAAM,CAkDR;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,CAgC3D"}

package/dist/bitmapCrop.js

@@ -0,0 +1,175 @@
+import { createEntity } from '@flighthq/entity/contract';
+import { BitmapTextureSourceKind } from '@flighthq/types/contract';
+/**
+ * Allocates a new `Bitmap` containing the pixels of `source` cropped to
+ * `rect`. `rect` coordinates are relative to the `source` bitmap origin
+ * (not to a region offset). Pixels of `rect` that fall outside the bitmap
+ * are filled with transparent black.
+ *
+ * Returns a new `Bitmap` with the same `colorSpace`, `alphaType`, and
+ * `format` as `source`, with dimensions equal to `rect.width × rect.height`.
+ */
+export function cropBitmap(source, rect) {
+    const sw = source.width;
+    const sh = source.height;
+    const rx = Math.round(rect.x);
+    const ry = Math.round(rect.y);
+    const rw = Math.max(0, Math.round(rect.width));
+    const rh = Math.max(0, Math.round(rect.height));
+    const data = new Uint8ClampedArray(rw * rh * 4);
+    const sd = source.data;
+    for (let py = 0; py < rh; py++) {
+        const sy = ry + py;
+        if (sy < 0 || sy >= sh)
+            continue;
+        for (let px = 0; px < rw; px++) {
+            const sx = rx + px;
+            if (sx < 0 || sx >= sw)
+                continue;
+            const si = (sy * sw + sx) * 4;
+            const di = (py * rw + px) * 4;
+            data[di] = sd[si];
+            data[di + 1] = sd[si + 1];
+            data[di + 2] = sd[si + 2];
+            data[di + 3] = sd[si + 3];
+        }
+    }
+    return createEntity({
+        alphaType: source.alphaType,
+        colorSpace: source.colorSpace,
+        data,
+        format: source.format,
+        height: rh,
+        kind: BitmapTextureSourceKind,
+        version: 0,
+        width: rw,
+    });
+}
+/**
+ * Allocates a new `Bitmap` with `source` padded by `left`, `top`, `right`,
+ * and `bottom` pixels on each side. Added pixels are filled according to
+ * `edgeMode`:
+ * - `'transparent'` (default): filled with transparent black.
+ * - `'clamp'`: border pixels of `source` are repeated.
+ * - `'wrap'`: `source` is tiled.
+ * - `'mirror'`: `source` is mirrored at the edges.
+ *
+ * When `edgeMode` is `'transparent'`, the optional `fillColor` (packed RGBA,
+ * e.g. `0xffffffff` for opaque white) overrides the default transparent fill.
+ * It is ignored for all other edge modes.
+ */
+export function extendBitmap(source, left, top, right, bottom, edgeMode = 'transparent', fillColor = 0) {
+    const sw = source.width;
+    const sh = source.height;
+    const dw = sw + left + right;
+    const dh = sh + top + bottom;
+    const data = new Uint8ClampedArray(dw * dh * 4);
+    const sd = source.data;
+    const fr = (fillColor >>> 24) & 0xff;
+    const fg = (fillColor >> 16) & 0xff;
+    const fb = (fillColor >> 8) & 0xff;
+    const fa = fillColor & 0xff;
+    for (let py = 0; py < dh; py++) {
+        for (let px = 0; px < dw; px++) {
+            const sx = px - left;
+            const sy = py - top;
+            const di = (py * dw + px) * 4;
+            if (sx >= 0 && sx < sw && sy >= 0 && sy < sh) {
+                const si = (sy * sw + sx) * 4;
+                data[di] = sd[si];
+                data[di + 1] = sd[si + 1];
+                data[di + 2] = sd[si + 2];
+                data[di + 3] = sd[si + 3];
+            }
+            else {
+                const cx = resolveEdge(sx, sw, edgeMode);
+                const cy = resolveEdge(sy, sh, edgeMode);
+                if (cx !== null && cy !== null) {
+                    const si = (cy * sw + cx) * 4;
+                    data[di] = sd[si];
+                    data[di + 1] = sd[si + 1];
+                    data[di + 2] = sd[si + 2];
+                    data[di + 3] = sd[si + 3];
+                }
+                else {
+                    data[di] = fr;
+                    data[di + 1] = fg;
+                    data[di + 2] = fb;
+                    data[di + 3] = fa;
+                }
+            }
+        }
+    }
+    return createEntity({
+        alphaType: source.alphaType,
+        colorSpace: source.colorSpace,
+        data,
+        format: source.format,
+        height: dh,
+        kind: BitmapTextureSourceKind,
+        version: 0,
+        width: dw,
+    });
+}
+/**
+ * Allocates a new `Bitmap` with the transparent border of `source` removed.
+ * Finds the tightest bounding box of all pixels with alpha > 0 and returns a
+ * new bitmap cropped to that box. If the entire bitmap is transparent,
+ * returns a 1×1 transparent bitmap.
+ */
+export function trimBitmap(source) {
+    const sw = source.width;
+    const sh = source.height;
+    const sd = source.data;
+    let minX = sw;
+    let minY = sh;
+    let maxX = -1;
+    let maxY = -1;
+    for (let py = 0; py < sh; py++) {
+        for (let px = 0; px < sw; px++) {
+            const a = sd[(py * sw + px) * 4 + 3];
+            if (a > 0) {
+                if (px < minX)
+                    minX = px;
+                if (px > maxX)
+                    maxX = px;
+                if (py < minY)
+                    minY = py;
+                if (py > maxY)
+                    maxY = py;
+            }
+        }
+    }
+    if (maxX < 0) {
+        return createEntity({
+            alphaType: source.alphaType,
+            colorSpace: source.colorSpace,
+            data: new Uint8ClampedArray(4),
+            format: source.format,
+            height: 1,
+            kind: BitmapTextureSourceKind,
+            version: 0,
+            width: 1,
+        });
+    }
+    return cropBitmap(source, { x: minX, y: minY, width: maxX - minX + 1, height: maxY - minY + 1 });
+}
+function resolveEdge(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:
+            // 'transparent'
+            return null;
+    }
+}
+//# sourceMappingURL=bitmapCrop.js.map

package/dist/bitmapCrop.js.map

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

package/dist/bitmapDisplacement.d.ts

@@ -0,0 +1,22 @@
+import type { BitmapDisplacementMapOptions, BitmapRegion } from '@flighthq/types/contract';
+/**
+ * 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
+ * `BitmapEdgeMode` 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.bitmap.data` — output pixels read arbitrary source positions.
+ */
+export declare function displaceBitmap(out: Uint8ClampedArray, source: Readonly<BitmapRegion>, options: Readonly<BitmapDisplacementMapOptions>): void;
+//# sourceMappingURL=bitmapDisplacement.d.ts.map

package/dist/bitmapDisplacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapDisplacement.d.ts","sourceRoot":"","sources":["../src/bitmapDisplacement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAkB,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE3G;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,OAAO,EAAE,QAAQ,CAAC,4BAA4B,CAAC,GAC9C,IAAI,CAqEN"}

package/dist/bitmapDisplacement.js

@@ -0,0 +1,111 @@
+/**
+ * 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
+ * `BitmapEdgeMode` 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.bitmap.data` — output pixels read arbitrary source positions.
+ */
+export function displaceBitmap(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 (edgeMode === undefined && (rawSampleX < 0 || rawSampleX >= w || rawSampleY < 0 || rawSampleY >= h)) {
+                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.bitmap.width;
+            const sData = source.bitmap.data;
+            const rx0 = edgeMode === undefined ? Math.max(0, Math.min(w - 1, x0)) : resolveDisplacementEdge(x0, w, edgeMode);
+            const rx1 = edgeMode === undefined ? Math.max(0, Math.min(w - 1, x0 + 1)) : resolveDisplacementEdge(x0 + 1, w, edgeMode);
+            const ry0 = edgeMode === undefined ? Math.max(0, Math.min(h - 1, y0)) : resolveDisplacementEdge(y0, h, edgeMode);
+            const ry1 = edgeMode === undefined ? Math.max(0, Math.min(h - 1, y0 + 1)) : resolveDisplacementEdge(y0 + 1, h, edgeMode);
+            const i00 = rx0 === null || ry0 === null ? -1 : ((source.y + ry0) * sStride + source.x + rx0) * 4;
+            const i10 = rx1 === null || ry0 === null ? -1 : ((source.y + ry0) * sStride + source.x + rx1) * 4;
+            const i01 = rx0 === null || ry1 === null ? -1 : ((source.y + ry1) * sStride + source.x + rx0) * 4;
+            const i11 = rx1 === null || ry1 === null ? -1 : ((source.y + ry1) * sStride + source.x + rx1) * 4;
+            for (let c = 0; c < 4; c++) {
+                const top = (i00 < 0 ? 0 : sData[i00 + c]) * (1 - tx) + (i10 < 0 ? 0 : sData[i10 + c]) * tx;
+                const bottom = (i01 < 0 ? 0 : sData[i01 + c]) * (1 - tx) + (i11 < 0 ? 0 : 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.bitmap.width || my < 0 || my >= map.bitmap.height)
+        return 128;
+    return map.bitmap.data[(my * map.bitmap.width + mx) * 4 + component];
+}
+//# sourceMappingURL=bitmapDisplacement.js.map

package/dist/bitmapDisplacement.js.map

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

package/dist/bitmapDissolve.d.ts

@@ -0,0 +1,21 @@
+import type { BitmapRegion } from '@flighthq/types/contract';
+/**
+ * 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 declare function dissolveBitmapPixels(dest: Readonly<BitmapRegion>, source: Readonly<BitmapRegion>, seed: number, pixelCount: number, fillColor?: number): number;
+//# sourceMappingURL=bitmapDissolve.d.ts.map

package/dist/bitmapDissolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapDissolve.d.ts","sourceRoot":"","sources":["../src/bitmapDissolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC5B,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAU,GACpB,MAAM,CAkER"}

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