@flighthq/bitmap 0.3.0-edge.1458.0c01b63

package/dist/bitmapFrom.js

@@ -0,0 +1,90 @@
+import { createEntity } from '@flighthq/entity/contract';
+import { BitmapTextureSourceKind } from '@flighthq/types/contract';
+/**
+ * Reads a host-backed Image into a newly allocated, CPU-readable Bitmap. The readback draws
+ * through a detached canvas; callers that need both representations should retain both objects.
+ */
+export function captureBitmapFromImageResource(resource) {
+    const canvas = document.createElement('canvas');
+    canvas.width = resource.width;
+    canvas.height = resource.height;
+    const ctx = canvas.getContext('2d');
+    ctx.drawImage(resource.source, 0, 0);
+    const raw = ctx.getImageData(0, 0, resource.width, resource.height);
+    return createEntity({
+        alphaType: 'straight',
+        colorSpace: raw.colorSpace,
+        data: raw.data,
+        format: 'rgba8unorm',
+        height: resource.height,
+        kind: BitmapTextureSourceKind,
+        version: 0,
+        width: resource.width,
+    });
+}
+export function createBitmapFromCanvas(canvas, x = 0, y = 0, width, height) {
+    const w = width ?? canvas.width;
+    const h = height ?? canvas.height;
+    const ctx = canvas.getContext('2d');
+    const raw = ctx.getImageData(x, y, w, h);
+    return createEntity({
+        alphaType: 'straight',
+        colorSpace: raw.colorSpace,
+        data: raw.data,
+        format: 'rgba8unorm',
+        height: raw.height,
+        kind: BitmapTextureSourceKind,
+        version: 0,
+        width: raw.width,
+    });
+}
+/**
+ * Reads a bitmap out of any `CanvasImageSource` by drawing it into a scratch 2D canvas. Unlike
+ * createBitmapFromCanvas — which calls getContext('2d') and so only works on a 2D-rendered canvas —
+ * this captures a Gl or Wgpu canvas too, giving one readback path for every render backend.
+ * `width`/`height` are the device-pixel dimensions to capture (pass the render state's canvas size).
+ * For a Gl/Wgpu source, draw before the browser composites the frame away (in tests, enable the
+ * context's preserveDrawingBuffer, or read immediately after rendering).
+ *
+ * Returns `null` when the pixels cannot be read rather than letting a platform exception escape. A
+ * cross-origin source taints the scratch canvas and the platform refuses to return its pixels — that
+ * is an expected outcome of loading someone else's image, not a programmer error, so it takes the
+ * sentinel the diagnostics conventions reserve for expected failure. Call `explainBitmapReadback`
+ * with the same arguments for the reason; it re-derives it without allocating a bitmap.
+ */
+export function createBitmapFromImageSource(source, width, height) {
+    if (width <= 0 || height <= 0)
+        return null;
+    if (typeof document === 'undefined')
+        return null;
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext('2d');
+    if (ctx === null)
+        return null;
+    let raw;
+    try {
+        ctx.drawImage(source, 0, 0);
+        raw = ctx.getImageData(0, 0, width, height);
+    }
+    catch {
+        // A tainted canvas throws SecurityError from getImageData; a source the platform cannot draw
+        // throws from drawImage. Both mean "no pixels for you", which is the sentinel's job to say.
+        return null;
+    }
+    // Annotated rather than returned inline: with a `Bitmap | null` return the object literal loses the
+    // contextual typing that narrows its string fields to Bitmap's literal types.
+    const bitmap = createEntity({
+        alphaType: 'straight',
+        colorSpace: raw.colorSpace,
+        data: raw.data,
+        format: 'rgba8unorm',
+        height,
+        kind: BitmapTextureSourceKind,
+        version: 0,
+        width,
+    });
+    return bitmap;
+}
+//# sourceMappingURL=bitmapFrom.js.map

package/dist/bitmapFrom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapFrom.js","sourceRoot":"","sources":["../src/bitmapFrom.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,QAAyB;IACtE,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC9B,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC;IAChC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC;IACrC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,YAAY,CAAC;QAClB,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,GAAG,CAAC,UAAmC;QACnD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,QAAQ,CAAC,KAAK;KACtB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAyB,EACzB,IAAY,CAAC,EACb,IAAY,CAAC,EACb,KAAc,EACd,MAAe;IAEf,MAAM,CAAC,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC;IAChC,MAAM,CAAC,GAAG,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC;IACrC,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,OAAO,YAAY,CAAC;QAClB,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,GAAG,CAAC,UAAmC;QACnD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,YAAY;QACpB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,GAAG,CAAC,KAAK;KACjB,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAyB,EAAE,KAAa,EAAE,MAAc;IAClG,IAAI,KAAK,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,IAAI,GAAc,CAAC;IACnB,IAAI,CAAC;QACH,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,GAAG,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,6FAA6F;QAC7F,4FAA4F;QAC5F,OAAO,IAAI,CAAC;IACd,CAAC;IACD,oGAAoG;IACpG,8EAA8E;IAC9E,MAAM,MAAM,GAAW,YAAY,CAAC;QAClC,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,GAAG,CAAC,UAAmC;QACnD,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,YAAY;QACpB,MAAM;QACN,IAAI,EAAE,uBAAuB;QAC7B,OAAO,EAAE,CAAC;QACV,KAAK;KACN,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/bitmapGradient.d.ts

@@ -0,0 +1,36 @@
+import type { BitmapGradientBevelOptions, BitmapGradientGlowOptions, BitmapRegion } from '@flighthq/types/contract';
+/**
+ * Fills `out` (256 RGBA entries, 1024 bytes) with a gradient lookup table built
+ * from parallel `colors` (packed 0xRRGGBB), `alphas` (0..1), and `ratios`
+ * (0..255, ascending) arrays. Indices below the first ratio take the first stop;
+ * indices above the last take the last stop; in between, channels are linearly
+ * interpolated.
+ */
+export declare function buildBitmapGradientRamp(out: Uint8ClampedArray, colors: ReadonlyArray<number>, alphas: ReadonlyArray<number>, ratios: ReadonlyArray<number>): void;
+/**
+ * Produces a gradient bevel mask in `out`. Like `bevelBitmap`, but the signed
+ * edge gradient (-1..1) indexes the 256-entry `ramp` instead of selecting one of
+ * two flat colors: -1 maps to ramp index 0 (shadow side), 0 to 128 (flat,
+ * typically transparent), +1 to 255 (highlight side).
+ *
+ * `ramp` must be 256 RGBA entries (1024 bytes); build it with
+ * `buildBitmapGradientRamp`. `scratch` must be a distinct buffer from `out`,
+ * at least `source.width * source.height * 4` bytes; its contents are undefined
+ * after the call.
+ *
+ * `out` must NOT alias `source.bitmap.data`: `out` is used as the blur scratch,
+ * and the source alpha is read again afterward for `inner`/`outer` clipping.
+ */
+export declare function gradientBevelBitmap(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<BitmapRegion>, ramp: Readonly<Uint8ClampedArray>, options?: Readonly<BitmapGradientBevelOptions>): void;
+/**
+ * Produces a gradient glow mask in `out`. Like `glowBitmap`, but the blurred
+ * source alpha (0..255) indexes the 256-entry `ramp` for both color and opacity,
+ * so the glow color varies with distance from the shape.
+ *
+ * `ramp` must be 256 RGBA entries (1024 bytes); build it with
+ * `buildBitmapGradientRamp`. `scratch` must be at least
+ * `source.width * source.height * 4` bytes; its contents are undefined after the
+ * call. Safe to pass `source.bitmap.data` as `out` for a full-bitmap region.
+ */
+export declare function gradientGlowBitmap(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<BitmapRegion>, ramp: Readonly<Uint8ClampedArray>, options?: Readonly<BitmapGradientGlowOptions>): void;
+//# sourceMappingURL=bitmapGradient.d.ts.map

package/dist/bitmapGradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapGradient.d.ts","sourceRoot":"","sources":["../src/bitmapGradient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAIpH;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,EAC7B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAqCN;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,OAAO,GAAE,QAAQ,CAAC,0BAA0B,CAAM,GACjD,IAAI,CAyCN;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC9B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,OAAO,GAAE,QAAQ,CAAC,yBAAyB,CAAM,GAChD,IAAI,CA0BN"}

package/dist/bitmapGradient.js

@@ -0,0 +1,176 @@
+import { blurBitmapPixelsHorizontal, blurBitmapPixelsVertical } from './bitmapBlur';
+/**
+ * Fills `out` (256 RGBA entries, 1024 bytes) with a gradient lookup table built
+ * from parallel `colors` (packed 0xRRGGBB), `alphas` (0..1), and `ratios`
+ * (0..255, ascending) arrays. Indices below the first ratio take the first stop;
+ * indices above the last take the last stop; in between, channels are linearly
+ * interpolated.
+ */
+export function buildBitmapGradientRamp(out, colors, alphas, ratios) {
+    const n = ratios.length;
+    if (n === 0) {
+        out.fill(0);
+        return;
+    }
+    for (let i = 0; i < 256; i++) {
+        let r;
+        let g;
+        let b;
+        let a;
+        if (i <= ratios[0]) {
+            r = (colors[0] >> 16) & 0xff;
+            g = (colors[0] >> 8) & 0xff;
+            b = colors[0] & 0xff;
+            a = alphas[0];
+        }
+        else if (i >= ratios[n - 1]) {
+            r = (colors[n - 1] >> 16) & 0xff;
+            g = (colors[n - 1] >> 8) & 0xff;
+            b = colors[n - 1] & 0xff;
+            a = alphas[n - 1];
+        }
+        else {
+            let j = 0;
+            while (j < n - 1 && ratios[j + 1] < i)
+                j++;
+            const span = ratios[j + 1] - ratios[j];
+            const t = span > 0 ? (i - ratios[j]) / span : 0;
+            r = lerp((colors[j] >> 16) & 0xff, (colors[j + 1] >> 16) & 0xff, t);
+            g = lerp((colors[j] >> 8) & 0xff, (colors[j + 1] >> 8) & 0xff, t);
+            b = lerp(colors[j] & 0xff, colors[j + 1] & 0xff, t);
+            a = lerp(alphas[j], alphas[j + 1], t);
+        }
+        const oi = i * 4;
+        out[oi] = Math.round(r);
+        out[oi + 1] = Math.round(g);
+        out[oi + 2] = Math.round(b);
+        out[oi + 3] = Math.round(a * 255);
+    }
+}
+/**
+ * Produces a gradient bevel mask in `out`. Like `bevelBitmap`, but the signed
+ * edge gradient (-1..1) indexes the 256-entry `ramp` instead of selecting one of
+ * two flat colors: -1 maps to ramp index 0 (shadow side), 0 to 128 (flat,
+ * typically transparent), +1 to 255 (highlight side).
+ *
+ * `ramp` must be 256 RGBA entries (1024 bytes); build it with
+ * `buildBitmapGradientRamp`. `scratch` must be a distinct buffer from `out`,
+ * at least `source.width * source.height * 4` bytes; its contents are undefined
+ * after the call.
+ *
+ * `out` must NOT alias `source.bitmap.data`: `out` is used as the blur scratch,
+ * and the source alpha is read again afterward for `inner`/`outer` clipping.
+ */
+export function gradientBevelBitmap(out, scratch, source, ramp, options = {}) {
+    const w = source.width;
+    const h = source.height;
+    const angle = options.angle ?? Math.PI / 4;
+    const distance = options.distance ?? 4;
+    const offsetX = Math.round(Math.cos(angle) * distance);
+    const offsetY = Math.round(Math.sin(angle) * distance);
+    const type = options.type ?? 'inner';
+    const intensity = options.intensity ?? 1;
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            const di = (py * w + px) * 4;
+            scratch[di] = 0;
+            scratch[di + 1] = 0;
+            scratch[di + 2] = 0;
+            scratch[di + 3] = readSourceAlpha(source, px, py);
+        }
+    }
+    blurAlphaField(scratch, out, w, h, options.radiusX, options.radiusY, options.passes);
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            const di = (py * w + px) * 4;
+            const lit = sampleField(scratch, w, h, px - offsetX, py - offsetY);
+            const shade = sampleField(scratch, w, h, px + offsetX, py + offsetY);
+            const gradient = lit - shade;
+            const idx = Math.max(0, Math.min(255, Math.round((gradient * 0.5 + 0.5) * 255)));
+            const ri = idx * 4;
+            const clip = type === 'inner'
+                ? readSourceAlpha(source, px, py) / 255
+                : type === 'outer'
+                    ? 1 - readSourceAlpha(source, px, py) / 255
+                    : 1;
+            out[di] = ramp[ri];
+            out[di + 1] = ramp[ri + 1];
+            out[di + 2] = ramp[ri + 2];
+            out[di + 3] = Math.min(255, Math.round(ramp[ri + 3] * intensity * clip));
+        }
+    }
+}
+/**
+ * Produces a gradient glow mask in `out`. Like `glowBitmap`, but the blurred
+ * source alpha (0..255) indexes the 256-entry `ramp` for both color and opacity,
+ * so the glow color varies with distance from the shape.
+ *
+ * `ramp` must be 256 RGBA entries (1024 bytes); build it with
+ * `buildBitmapGradientRamp`. `scratch` must be at least
+ * `source.width * source.height * 4` bytes; its contents are undefined after the
+ * call. Safe to pass `source.bitmap.data` as `out` for a full-bitmap region.
+ */
+export function gradientGlowBitmap(out, scratch, source, ramp, options = {}) {
+    const w = source.width;
+    const h = source.height;
+    const intensity = options.intensity ?? 1;
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            const di = (py * w + px) * 4;
+            out[di] = 0;
+            out[di + 1] = 0;
+            out[di + 2] = 0;
+            out[di + 3] = readSourceAlpha(source, px, py);
+        }
+    }
+    blurAlphaField(out, scratch, w, h, options.radiusX, options.radiusY, options.passes);
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            const di = (py * w + px) * 4;
+            const ri = out[di + 3] * 4;
+            out[di] = ramp[ri];
+            out[di + 1] = ramp[ri + 1];
+            out[di + 2] = ramp[ri + 2];
+            out[di + 3] = Math.min(255, Math.round(ramp[ri + 3] * intensity));
+        }
+    }
+}
+function blurAlphaField(field, scratch, w, h, radiusX, radiusY, passes) {
+    const rx = Math.max(0, Math.round(radiusX ?? 2));
+    const ry = Math.max(0, Math.round(radiusY ?? 2));
+    const p = Math.max(1, Math.round(passes ?? 1));
+    let a = field;
+    let b = scratch;
+    for (let pass = 0; pass < p; pass++) {
+        if (rx > 0) {
+            blurBitmapPixelsHorizontal(b, a, w, h, rx);
+            const t = a;
+            a = b;
+            b = t;
+        }
+        if (ry > 0) {
+            blurBitmapPixelsVertical(b, a, w, h, ry);
+            const t = a;
+            a = b;
+            b = t;
+        }
+    }
+    if (a !== field)
+        field.set(a.subarray(0, w * h * 4));
+}
+function lerp(from, to, t) {
+    return from + (to - from) * t;
+}
+function readSourceAlpha(source, px, py) {
+    const sx = source.x + px;
+    const sy = source.y + py;
+    if (sx < 0 || sx >= source.bitmap.width || sy < 0 || sy >= source.bitmap.height)
+        return 0;
+    return source.bitmap.data[(sy * source.bitmap.width + sx) * 4 + 3];
+}
+function sampleField(field, w, h, x, y) {
+    if (x < 0 || x >= w || y < 0 || y >= h)
+        return 0;
+    return field[(y * w + x) * 4 + 3] / 255;
+}
+//# sourceMappingURL=bitmapGradient.js.map

package/dist/bitmapGradient.js.map

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

package/dist/bitmapGradientFill.d.ts

@@ -0,0 +1,32 @@
+import type { GradientSpread, BitmapRegion } from '@flighthq/types/contract';
+/**
+ * Fills the `dest` region with a linear gradient defined by two points `(x0, y0)`
+ * and `(x1, y1)` in region-local coordinates. Each pixel's position along the
+ * gradient axis maps to a ramp index (0–255), which is looked up in the 256-entry
+ * RGBA `ramp` (1024 bytes). Build the ramp with `buildBitmapGradientRamp`.
+ *
+ * `spread` controls what happens outside the axis span:
+ * - `'pad'` (default): extends the first or last stop color.
+ * - `'repeat'`: tiles the gradient.
+ * - `'reflect'`: mirrors the gradient alternately.
+ *
+ * Pixels outside the bitmap bounds are skipped.
+ */
+export declare function fillBitmapLinearGradient(dest: Readonly<BitmapRegion>, ramp: Readonly<Uint8ClampedArray>, x0: number, y0: number, x1: number, y1: number, spread?: GradientSpread): void;
+/**
+ * Fills the `dest` region with a radial gradient centered at `(cx, cy)` in
+ * region-local coordinates with the given `radius`. An optional focal point
+ * `(focalX, focalY)` shifts the gradient origin (defaults to the center).
+ * Each pixel's normalized distance maps to a ramp index (0–255), looked up in
+ * the 256-entry RGBA `ramp` (1024 bytes). Build the ramp with
+ * `buildBitmapGradientRamp`.
+ *
+ * `spread` controls what happens outside the radius:
+ * - `'pad'` (default): extends the last stop color.
+ * - `'repeat'`: tiles the gradient.
+ * - `'reflect'`: mirrors the gradient alternately.
+ *
+ * Pixels outside the bitmap bounds are skipped.
+ */
+export declare function fillBitmapRadialGradient(dest: Readonly<BitmapRegion>, ramp: Readonly<Uint8ClampedArray>, cx: number, cy: number, radius: number, focalX?: number, focalY?: number, spread?: GradientSpread): void;
+//# sourceMappingURL=bitmapGradientFill.d.ts.map

package/dist/bitmapGradientFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapGradientFill.d.ts","sourceRoot":"","sources":["../src/bitmapGradientFill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAI7E;;;;;;;;;;;;GAYG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC5B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,cAAsB,GAC7B,IAAI,CA4BN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAC5B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAW,EACnB,MAAM,GAAE,MAAW,EACnB,MAAM,GAAE,cAAsB,GAC7B,IAAI,CAgCN"}

package/dist/bitmapGradientFill.js

@@ -0,0 +1,120 @@
+import { invalidateBitmap } from './bitmap';
+/**
+ * Fills the `dest` region with a linear gradient defined by two points `(x0, y0)`
+ * and `(x1, y1)` in region-local coordinates. Each pixel's position along the
+ * gradient axis maps to a ramp index (0–255), which is looked up in the 256-entry
+ * RGBA `ramp` (1024 bytes). Build the ramp with `buildBitmapGradientRamp`.
+ *
+ * `spread` controls what happens outside the axis span:
+ * - `'pad'` (default): extends the first or last stop color.
+ * - `'repeat'`: tiles the gradient.
+ * - `'reflect'`: mirrors the gradient alternately.
+ *
+ * Pixels outside the bitmap bounds are skipped.
+ */
+export function fillBitmapLinearGradient(dest, ramp, x0, y0, x1, y1, spread = 'pad') {
+    const dw = dest.width;
+    const dh = dest.height;
+    const data = dest.bitmap.data;
+    const bitmapWidth = dest.bitmap.width;
+    const bitmapHeight = dest.bitmap.height;
+    const axisX = x1 - x0;
+    const axisY = y1 - y0;
+    const lenSq = axisX * axisX + axisY * axisY;
+    const invLen = lenSq > 0 ? 1 / lenSq : 0;
+    for (let py = 0; py < dh; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= bitmapHeight)
+            continue;
+        for (let px = 0; px < dw; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= bitmapWidth)
+                continue;
+            // Project pixel onto gradient axis → t in [0, 1] maps x0→x1.
+            const t = ((px - x0) * axisX + (py - y0) * axisY) * invLen;
+            const idx = spreadIndex(t, spread);
+            const ri = idx * 4;
+            const i = (y * bitmapWidth + x) * 4;
+            data[i] = ramp[ri];
+            data[i + 1] = ramp[ri + 1];
+            data[i + 2] = ramp[ri + 2];
+            data[i + 3] = ramp[ri + 3];
+        }
+    }
+    invalidateBitmap(dest.bitmap);
+}
+/**
+ * Fills the `dest` region with a radial gradient centered at `(cx, cy)` in
+ * region-local coordinates with the given `radius`. An optional focal point
+ * `(focalX, focalY)` shifts the gradient origin (defaults to the center).
+ * Each pixel's normalized distance maps to a ramp index (0–255), looked up in
+ * the 256-entry RGBA `ramp` (1024 bytes). Build the ramp with
+ * `buildBitmapGradientRamp`.
+ *
+ * `spread` controls what happens outside the radius:
+ * - `'pad'` (default): extends the last stop color.
+ * - `'repeat'`: tiles the gradient.
+ * - `'reflect'`: mirrors the gradient alternately.
+ *
+ * Pixels outside the bitmap bounds are skipped.
+ */
+export function fillBitmapRadialGradient(dest, ramp, cx, cy, radius, focalX = cx, focalY = cy, spread = 'pad') {
+    const dw = dest.width;
+    const dh = dest.height;
+    const data = dest.bitmap.data;
+    const bitmapWidth = dest.bitmap.width;
+    const bitmapHeight = dest.bitmap.height;
+    const invRadius = radius > 0 ? 1 / radius : 0;
+    // Focal-point offset from center.
+    const fdx = focalX - cx;
+    const fdy = focalY - cy;
+    for (let py = 0; py < dh; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= bitmapHeight)
+            continue;
+        for (let px = 0; px < dw; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= bitmapWidth)
+                continue;
+            // Distance from focal point, normalized by radius → t in [0, 1].
+            const dx = px - focalX;
+            const dy = py - focalY;
+            // Use the cone-ray formula for two-point focal gradient (standard SVG model).
+            // When focal === center this simplifies to Euclidean distance / radius.
+            const t = Math.sqrt(dx * dx + dy * dy) * invRadius - (dx * fdx + dy * fdy) * invRadius * invRadius;
+            const idx = spreadIndex(t, spread);
+            const ri = idx * 4;
+            const i = (y * bitmapWidth + x) * 4;
+            data[i] = ramp[ri];
+            data[i + 1] = ramp[ri + 1];
+            data[i + 2] = ramp[ri + 2];
+            data[i + 3] = ramp[ri + 3];
+        }
+    }
+    invalidateBitmap(dest.bitmap);
+}
+/**
+ * Converts a normalized gradient parameter `t` (range [0, 1]) into a ramp
+ * index (0–255), applying the requested `spread` mode for values outside [0, 1].
+ */
+function spreadIndex(t, spread) {
+    let s;
+    switch (spread) {
+        case 'repeat': {
+            s = t - Math.floor(t);
+            break;
+        }
+        case 'reflect': {
+            const wrapped = t - Math.floor(t / 2) * 2;
+            s = wrapped <= 1 ? wrapped : 2 - wrapped;
+            break;
+        }
+        default: {
+            // 'pad'
+            s = Math.max(0, Math.min(1, t));
+            break;
+        }
+    }
+    return Math.min(255, Math.round(s * 255));
+}
+//# sourceMappingURL=bitmapGradientFill.js.map

package/dist/bitmapGradientFill.js.map

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

package/dist/bitmapHistogram.d.ts

@@ -0,0 +1,20 @@
+import type { BitmapHistogram, BitmapRegion } from '@flighthq/types/contract';
+/**
+ * Applies histogram equalization to `source`, writing into `dest`. Each RGB
+ * channel is equalized independently using its cumulative distribution function,
+ * spreading the tonal range across the full 0..255 output. The alpha channel is
+ * copied unchanged.
+ *
+ * Safe to pass the same bitmap and region in `dest` and `source` for in-place
+ * equalization (the palette map reads each pixel before writing it).
+ */
+export declare function equalizeBitmapHistogram(dest: Readonly<BitmapRegion>, source: Readonly<BitmapRegion>): void;
+/**
+ * Counts how many pixels in the `source` region fall into each 0..255 value,
+ * per channel, and returns four 256-entry arrays. Region pixels outside the
+ * bitmap are skipped; an empty region yields all-zero bins.
+ *
+ * Allocates the result arrays; this is an analysis query, not a hot-path pass.
+ */
+export declare function getBitmapHistogram(source: Readonly<BitmapRegion>): BitmapHistogram;
+//# sourceMappingURL=bitmapHistogram.d.ts.map

package/dist/bitmapHistogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapHistogram.d.ts","sourceRoot":"","sources":["../src/bitmapHistogram.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAK9E;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI,CAa1G;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,eAAe,CAqBlF"}

package/dist/bitmapHistogram.js

@@ -0,0 +1,61 @@
+import { invalidateBitmap } from './bitmap';
+import { applyBitmapPaletteMap } from './bitmapPaletteMap';
+/**
+ * Applies histogram equalization to `source`, writing into `dest`. Each RGB
+ * channel is equalized independently using its cumulative distribution function,
+ * spreading the tonal range across the full 0..255 output. The alpha channel is
+ * copied unchanged.
+ *
+ * Safe to pass the same bitmap and region in `dest` and `source` for in-place
+ * equalization (the palette map reads each pixel before writing it).
+ */
+export function equalizeBitmapHistogram(dest, source) {
+    const histogram = getBitmapHistogram(source);
+    const total = source.width * source.height;
+    applyBitmapPaletteMap(dest, source, buildEqualizeMap(histogram.red, total), buildEqualizeMap(histogram.green, total), buildEqualizeMap(histogram.blue, total), null);
+    invalidateBitmap(dest.bitmap);
+}
+/**
+ * Counts how many pixels in the `source` region fall into each 0..255 value,
+ * per channel, and returns four 256-entry arrays. Region pixels outside the
+ * bitmap are skipped; an empty region yields all-zero bins.
+ *
+ * Allocates the result arrays; this is an analysis query, not a hot-path pass.
+ */
+export function getBitmapHistogram(source) {
+    const red = new Array(256).fill(0);
+    const green = new Array(256).fill(0);
+    const blue = new Array(256).fill(0);
+    const alpha = new Array(256).fill(0);
+    const data = source.bitmap.data;
+    const bitmapWidth = source.bitmap.width;
+    for (let py = 0; py < source.height; py++) {
+        const y = source.y + py;
+        if (y < 0 || y >= source.bitmap.height)
+            continue;
+        for (let px = 0; px < source.width; px++) {
+            const x = source.x + px;
+            if (x < 0 || x >= bitmapWidth)
+                continue;
+            const i = (y * bitmapWidth + x) * 4;
+            red[data[i]]++;
+            green[data[i + 1]]++;
+            blue[data[i + 2]]++;
+            alpha[data[i + 3]]++;
+        }
+    }
+    return { alpha, blue, green, red };
+}
+function buildEqualizeMap(bins, total) {
+    const map = new Array(256);
+    let cdf = 0;
+    let cdfMin = -1;
+    for (let i = 0; i < 256; i++) {
+        cdf += bins[i];
+        if (bins[i] > 0 && cdfMin === -1)
+            cdfMin = cdf;
+        map[i] = total === cdfMin ? i : Math.round(((cdf - cdfMin) / (total - cdfMin)) * 255);
+    }
+    return map;
+}
+//# sourceMappingURL=bitmapHistogram.js.map

package/dist/bitmapHistogram.js.map

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

package/dist/bitmapImageChannel.d.ts

@@ -0,0 +1,2 @@
+export { ImageChannel } from '@flighthq/types/contract';
+//# sourceMappingURL=bitmapImageChannel.d.ts.map

package/dist/bitmapImageChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapImageChannel.d.ts","sourceRoot":"","sources":["../src/bitmapImageChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/bitmapImageChannel.js

@@ -0,0 +1,2 @@
+export { ImageChannel } from '@flighthq/types/contract';
+//# sourceMappingURL=bitmapImageChannel.js.map

package/dist/bitmapImageChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapImageChannel.js","sourceRoot":"","sources":["../src/bitmapImageChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/bitmapMedian.d.ts

@@ -0,0 +1,14 @@
+import type { BitmapRegion } from '@flighthq/types/contract';
+/**
+ * Applies a median filter to `source`, writing into `out`. Each output channel
+ * is the median of that channel over the `(2 * radius + 1)²` neighborhood,
+ * clamped at the bitmap edges. Median filtering removes salt-and-pepper noise
+ * and despeckles while preserving edges — something a linear convolution blur
+ * cannot do.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.bitmap.data` — each output pixel reads a neighborhood of
+ * source pixels.
+ */
+export declare function medianBitmap(out: Uint8ClampedArray, source: Readonly<BitmapRegion>, radius: number): void;
+//# sourceMappingURL=bitmapMedian.d.ts.map

package/dist/bitmapMedian.d.ts.map

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