@flighthq/surface 0.1.0

package/dist/surfaceColorMatrix.d.ts

@@ -0,0 +1,57 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Writes a brightness color matrix into `out` (length 20). Multiplies RGB by
+ * `amount` (CSS `brightness()` semantics): 1 is identity, 0 is black, >1 brightens.
+ */
+export declare function buildSurfaceBrightnessColorMatrix(out: number[], amount: number): void;
+/**
+ * Writes a contrast color matrix into `out` (length 20). Scales RGB around the
+ * midpoint (CSS `contrast()` semantics): 1 is identity, 0 is flat grey, >1 raises
+ * contrast.
+ */
+export declare function buildSurfaceContrastColorMatrix(out: number[], amount: number): void;
+/**
+ * Writes a grayscale color matrix into `out` (length 20). Equivalent to
+ * `buildSurfaceSaturationColorMatrix(out, 0)`; uses the W3C luma coefficients.
+ */
+export declare function buildSurfaceGrayscaleColorMatrix(out: number[]): void;
+/**
+ * Writes a hue-rotation color matrix into `out` (length 20). `degrees` rotates
+ * hue around the luma axis (CSS `hue-rotate()` semantics, W3C coefficients).
+ * 0° is identity; 180° inverts hue; values outside 0..360 wrap naturally.
+ */
+export declare function buildSurfaceHueRotationColorMatrix(out: number[], degrees: number): void;
+/**
+ * Writes an invert color matrix into `out` (length 20). Inverts RGB
+ * (`255 - channel`); alpha is preserved.
+ */
+export declare function buildSurfaceInvertColorMatrix(out: number[]): void;
+/**
+ * Writes a saturation color matrix into `out` (length 20). `amount` is 1 for
+ * identity, 0 for grayscale, >1 for oversaturated (CSS `saturate()` semantics,
+ * W3C luma coefficients).
+ */
+export declare function buildSurfaceSaturationColorMatrix(out: number[], amount: number): void;
+/**
+ * Writes a sepia color matrix into `out` (length 20), matching CSS `sepia(1)`.
+ */
+export declare function buildSurfaceSepiaColorMatrix(out: number[]): void;
+/**
+ * Applies a 4×5 color matrix to `source` and writes into `out`.
+ * `out` must be at least `source.width * source.height * 4` bytes.
+ *
+ * Safe to pass `source.surface.data` as `out` when the region covers the
+ * full surface — each pixel's input channels are read before any channel
+ * of that pixel is written.
+ */
+export declare function colorMatrixSurface(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>, matrix: ReadonlyArray<number>): void;
+/**
+ * Composes two 4×5 color matrices into `out` (length 20): the result applies
+ * `first`, then `second`. `out` must not alias `first` or `second`.
+ */
+export declare function concatSurfaceColorMatrix(out: number[], first: ReadonlyArray<number>, second: ReadonlyArray<number>): void;
+/**
+ * Writes the identity color matrix into `out` (length 20).
+ */
+export declare function setSurfaceColorMatrixIdentity(out: number[]): void;
+//# sourceMappingURL=surfaceColorMatrix.d.ts.map

package/dist/surfaceColorMatrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceColorMatrix.d.ts","sourceRoot":"","sources":["../src/surfaceColorMatrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAKrD;;;GAGG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAErF;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAGnF;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA2BvF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMrF;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAEhE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAqBN;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EAAE,EACb,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAC5B,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,GAC5B,IAAI,CAUN;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAEjE"}

package/dist/surfaceColorMatrix.js

@@ -0,0 +1,127 @@
+// 4×5 color matrices are row-major: 4 rows (R, G, B, A output), each with 5
+// columns (R, G, B, A multipliers + a constant offset in 0..255 units).
+/**
+ * Writes a brightness color matrix into `out` (length 20). Multiplies RGB by
+ * `amount` (CSS `brightness()` semantics): 1 is identity, 0 is black, >1 brightens.
+ */
+export function buildSurfaceBrightnessColorMatrix(out, amount) {
+    setColorMatrix(out, amount, 0, 0, 0, 0, 0, amount, 0, 0, 0, 0, 0, amount, 0, 0, 0, 0, 0, 1, 0);
+}
+/**
+ * Writes a contrast color matrix into `out` (length 20). Scales RGB around the
+ * midpoint (CSS `contrast()` semantics): 1 is identity, 0 is flat grey, >1 raises
+ * contrast.
+ */
+export function buildSurfaceContrastColorMatrix(out, amount) {
+    const t = 127.5 * (1 - amount);
+    setColorMatrix(out, amount, 0, 0, 0, t, 0, amount, 0, 0, t, 0, 0, amount, 0, t, 0, 0, 0, 1, 0);
+}
+/**
+ * Writes a grayscale color matrix into `out` (length 20). Equivalent to
+ * `buildSurfaceSaturationColorMatrix(out, 0)`; uses the W3C luma coefficients.
+ */
+export function buildSurfaceGrayscaleColorMatrix(out) {
+    buildSurfaceSaturationColorMatrix(out, 0);
+}
+/**
+ * Writes a hue-rotation color matrix into `out` (length 20). `degrees` rotates
+ * hue around the luma axis (CSS `hue-rotate()` semantics, W3C coefficients).
+ * 0° is identity; 180° inverts hue; values outside 0..360 wrap naturally.
+ */
+export function buildSurfaceHueRotationColorMatrix(out, degrees) {
+    const radians = (degrees * Math.PI) / 180;
+    const c = Math.cos(radians);
+    const s = Math.sin(radians);
+    setColorMatrix(out, 0.213 + c * 0.787 - s * 0.213, 0.715 - c * 0.715 - s * 0.715, 0.072 - c * 0.072 + s * 0.928, 0, 0, 0.213 - c * 0.213 + s * 0.143, 0.715 + c * 0.285 + s * 0.14, 0.072 - c * 0.072 - s * 0.283, 0, 0, 0.213 - c * 0.213 - s * 0.787, 0.715 - c * 0.715 + s * 0.715, 0.072 + c * 0.928 + s * 0.072, 0, 0, 0, 0, 0, 1, 0);
+}
+/**
+ * Writes an invert color matrix into `out` (length 20). Inverts RGB
+ * (`255 - channel`); alpha is preserved.
+ */
+export function buildSurfaceInvertColorMatrix(out) {
+    setColorMatrix(out, -1, 0, 0, 0, 255, 0, -1, 0, 0, 255, 0, 0, -1, 0, 255, 0, 0, 0, 1, 0);
+}
+/**
+ * Writes a saturation color matrix into `out` (length 20). `amount` is 1 for
+ * identity, 0 for grayscale, >1 for oversaturated (CSS `saturate()` semantics,
+ * W3C luma coefficients).
+ */
+export function buildSurfaceSaturationColorMatrix(out, amount) {
+    const inv = 1 - amount;
+    const r = LUMA_R * inv;
+    const g = LUMA_G * inv;
+    const b = LUMA_B * inv;
+    setColorMatrix(out, r + amount, g, b, 0, 0, r, g + amount, b, 0, 0, r, g, b + amount, 0, 0, 0, 0, 0, 1, 0);
+}
+/**
+ * Writes a sepia color matrix into `out` (length 20), matching CSS `sepia(1)`.
+ */
+export function buildSurfaceSepiaColorMatrix(out) {
+    setColorMatrix(out, 0.393, 0.769, 0.189, 0, 0, 0.349, 0.686, 0.168, 0, 0, 0.272, 0.534, 0.131, 0, 0, 0, 0, 0, 1, 0);
+}
+/**
+ * Applies a 4×5 color matrix to `source` and writes into `out`.
+ * `out` must be at least `source.width * source.height * 4` bytes.
+ *
+ * Safe to pass `source.surface.data` as `out` when the region covers the
+ * full surface — each pixel's input channels are read before any channel
+ * of that pixel is written.
+ */
+export function colorMatrixSurface(out, source, matrix) {
+    if (matrix.length < 20)
+        throw new Error('Color matrix filter requires 20 values');
+    for (let py = 0; py < source.height; py++) {
+        const sourceY = source.y + py;
+        if (sourceY < 0 || sourceY >= source.surface.height)
+            continue;
+        for (let px = 0; px < source.width; px++) {
+            const sourceX = source.x + px;
+            if (sourceX < 0 || sourceX >= source.surface.width)
+                continue;
+            const si = (sourceY * source.surface.width + sourceX) * 4;
+            const di = (py * source.width + px) * 4;
+            const r = source.surface.data[si];
+            const g = source.surface.data[si + 1];
+            const b = source.surface.data[si + 2];
+            const a = source.surface.data[si + 3];
+            out[di] = clampByte(r * matrix[0] + g * matrix[1] + b * matrix[2] + a * matrix[3] + matrix[4]);
+            out[di + 1] = clampByte(r * matrix[5] + g * matrix[6] + b * matrix[7] + a * matrix[8] + matrix[9]);
+            out[di + 2] = clampByte(r * matrix[10] + g * matrix[11] + b * matrix[12] + a * matrix[13] + matrix[14]);
+            out[di + 3] = clampByte(r * matrix[15] + g * matrix[16] + b * matrix[17] + a * matrix[18] + matrix[19]);
+        }
+    }
+}
+/**
+ * Composes two 4×5 color matrices into `out` (length 20): the result applies
+ * `first`, then `second`. `out` must not alias `first` or `second`.
+ */
+export function concatSurfaceColorMatrix(out, first, second) {
+    for (let row = 0; row < 4; row++) {
+        for (let col = 0; col < 5; col++) {
+            let sum = col === 4 ? second[row * 5 + 4] : 0;
+            for (let k = 0; k < 4; k++) {
+                sum += second[row * 5 + k] * (col === 4 ? first[k * 5 + 4] : first[k * 5 + col]);
+            }
+            out[row * 5 + col] = sum;
+        }
+    }
+}
+/**
+ * Writes the identity color matrix into `out` (length 20).
+ */
+export function setSurfaceColorMatrixIdentity(out) {
+    setColorMatrix(out, 1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0, 0, 0, 0, 0, 1, 0);
+}
+// W3C luma coefficients (matching CSS saturate/grayscale), so the CPU result
+// agrees with the eventual CSS filter backend.
+const LUMA_R = 0.213;
+const LUMA_G = 0.715;
+const LUMA_B = 0.072;
+function clampByte(value) {
+    return Math.max(0, Math.min(255, Math.round(value)));
+}
+function setColorMatrix(out, ...values) {
+    for (let i = 0; i < 20; i++)
+        out[i] = values[i];
+}
+//# sourceMappingURL=surfaceColorMatrix.js.map

package/dist/surfaceColorMatrix.js.map

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

package/dist/surfaceCompare.d.ts

@@ -0,0 +1,18 @@
+import type { Surface, SurfaceMismatch } from '@flighthq/types';
+/**
+ * Compares two surfaces pixel by pixel. Returns `null` if they are identical,
+ * or a new Surface showing per-channel absolute differences (with alpha set to
+ * 255 wherever any channel differs). Throws if the surfaces have different
+ * dimensions — comparing incompatible surfaces is a programmer error.
+ */
+export declare function compareSurface(source: Readonly<Surface>, other: Readonly<Surface>): Surface | null;
+/**
+ * Compares two equally sized surfaces with a per-channel tolerance and returns summary metrics rather
+ * than a diff image. A pixel is "mismatched" when its largest RGBA channel difference exceeds
+ * `channelTolerance` (0..255). Use a small tolerance plus a `fraction` threshold to assert that two
+ * backends rendered the same scene (cross-backend differential) or that a render still matches a prior
+ * one, while ignoring antialiasing noise. Throws if the surfaces differ in size — comparing
+ * incompatible surfaces is a programmer error (mirrors compareSurface).
+ */
+export declare function getSurfaceMismatch(source: Readonly<Surface>, other: Readonly<Surface>, channelTolerance?: number): SurfaceMismatch;
+//# sourceMappingURL=surfaceCompare.d.ts.map

package/dist/surfaceCompare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceCompare.d.ts","sourceRoot":"","sources":["../src/surfaceCompare.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIhE;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,IAAI,CAyBlG;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,EACzB,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,EACxB,gBAAgB,GAAE,MAAU,GAC3B,eAAe,CA6BjB"}

package/dist/surfaceCompare.js

@@ -0,0 +1,64 @@
+import { createSurface } from './surface';
+/**
+ * Compares two surfaces pixel by pixel. Returns `null` if they are identical,
+ * or a new Surface showing per-channel absolute differences (with alpha set to
+ * 255 wherever any channel differs). Throws if the surfaces have different
+ * dimensions — comparing incompatible surfaces is a programmer error.
+ */
+export function compareSurface(source, other) {
+    if (source.width !== other.width || source.height !== other.height) {
+        throw new Error(`compareSurface: surface dimensions do not match (${source.width}×${source.height} vs ${other.width}×${other.height})`);
+    }
+    const result = createSurface(source.width, source.height);
+    let hasDiff = false;
+    for (let i = 0; i < source.data.length; i += 4) {
+        const dr = Math.abs(source.data[i] - other.data[i]);
+        const dg = Math.abs(source.data[i + 1] - other.data[i + 1]);
+        const db = Math.abs(source.data[i + 2] - other.data[i + 2]);
+        const da = Math.abs(source.data[i + 3] - other.data[i + 3]);
+        if (dr !== 0 || dg !== 0 || db !== 0 || da !== 0) {
+            result.data[i] = dr;
+            result.data[i + 1] = dg;
+            result.data[i + 2] = db;
+            result.data[i + 3] = 255;
+            hasDiff = true;
+        }
+    }
+    return hasDiff ? result : null;
+}
+/**
+ * Compares two equally sized surfaces with a per-channel tolerance and returns summary metrics rather
+ * than a diff image. A pixel is "mismatched" when its largest RGBA channel difference exceeds
+ * `channelTolerance` (0..255). Use a small tolerance plus a `fraction` threshold to assert that two
+ * backends rendered the same scene (cross-backend differential) or that a render still matches a prior
+ * one, while ignoring antialiasing noise. Throws if the surfaces differ in size — comparing
+ * incompatible surfaces is a programmer error (mirrors compareSurface).
+ */
+export function getSurfaceMismatch(source, other, channelTolerance = 0) {
+    if (source.width !== other.width || source.height !== other.height) {
+        throw new Error(`getSurfaceMismatch: surface dimensions do not match (${source.width}×${source.height} vs ${other.width}×${other.height})`);
+    }
+    const a = source.data;
+    const b = other.data;
+    const totalPixels = source.width * source.height;
+    let mismatchedPixels = 0;
+    let maxChannelDelta = 0;
+    for (let i = 0; i < a.length; i += 4) {
+        const dr = Math.abs(a[i] - b[i]);
+        const dg = Math.abs(a[i + 1] - b[i + 1]);
+        const db = Math.abs(a[i + 2] - b[i + 2]);
+        const da = Math.abs(a[i + 3] - b[i + 3]);
+        const pixelDelta = Math.max(dr, dg, db, da);
+        if (pixelDelta > maxChannelDelta)
+            maxChannelDelta = pixelDelta;
+        if (pixelDelta > channelTolerance)
+            mismatchedPixels++;
+    }
+    return {
+        mismatchedPixels,
+        totalPixels,
+        fraction: totalPixels === 0 ? 0 : mismatchedPixels / totalPixels,
+        maxChannelDelta,
+    };
+}
+//# sourceMappingURL=surfaceCompare.js.map

package/dist/surfaceCompare.js.map

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

package/dist/surfaceComposite.d.ts

@@ -0,0 +1,53 @@
+import type { SurfaceRegion } from '@flighthq/types';
+import { BlendMode } from '@flighthq/types';
+/**
+ * Alpha-composites `pixels` over `dest`. `pixels` must be at least
+ * `dest.width * dest.height * 4` bytes in row-major RGBA order.
+ *
+ * `blendMode` selects how the source combines with the backdrop. Separable
+ * blends applied before the Porter-Duff source-over: Normal (default) and Layer
+ * (= Normal), Multiply, Screen, Add, Subtract, Darken, Lighten, Difference,
+ * Overlay, Hardlight, Invert. Erase is a destination-out knockout. Alpha and
+ * Shader are display-list concepts with no surface meaning and throw.
+ */
+export declare function compositeSurfacePixels(dest: Readonly<SurfaceRegion>, pixels: Readonly<Uint8ClampedArray>, blendMode?: BlendMode): void;
+/**
+ * Alpha-composites `source` over `dest`. See `compositeSurfacePixels` for the
+ * `blendMode` semantics.
+ */
+export declare function compositeSurfaceRegion(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, blendMode?: BlendMode): void;
+/**
+ * Copies `source` into `out` in row-major, tightly-packed RGBA order
+ * (stride = source.width). `out` must be at least
+ * `source.width * source.height * 4` bytes.
+ *
+ * Safe to pass `source.surface.data` as `out` when the region covers the
+ * full surface (x=0, y=0, width=source.surface.width,
+ * height=source.surface.height).
+ */
+export declare function extractSurfacePixels(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>): void;
+/**
+ * Copies `source` into `out` as one packed `0xRRGGBBAA` color per pixel
+ * (`0xRRGGBBAA` packed colors, the same packing `getSurfacePixel` returns), in row-major order with
+ * stride = source.width. `out` must hold at least
+ * `source.width * source.height` entries.
+ *
+ * This is the bulk, color-per-element counterpart to the byte-per-channel
+ * `extractSurfacePixels`: use it when you want to read or compare whole
+ * regions of colors without reassembling channel bytes.
+ */
+export declare function extractSurfacePixels32(out: Uint32Array, source: Readonly<SurfaceRegion>): void;
+/**
+ * Writes `pixels` into `dest`, overwriting existing content.
+ * `pixels` must be at least `dest.width * dest.height * 4` bytes in
+ * row-major RGBA order.
+ */
+export declare function writeSurfacePixels(dest: Readonly<SurfaceRegion>, pixels: Readonly<Uint8ClampedArray>): void;
+/**
+ * Writes `pixels` into `dest`, overwriting existing content. Each entry is a
+ * packed `0xRRGGBBAA` color (the form `setSurfacePixel` takes), read in
+ * row-major order. `pixels` must hold at least `dest.width * dest.height`
+ * entries. This is the color-per-element counterpart to `writeSurfacePixels`.
+ */
+export declare function writeSurfacePixels32(dest: Readonly<SurfaceRegion>, pixels: Readonly<Uint32Array>): void;
+//# sourceMappingURL=surfaceComposite.d.ts.map

package/dist/surfaceComposite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceComposite.d.ts","sourceRoot":"","sources":["../src/surfaceComposite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,SAAS,GAAE,SAA4B,GACtC,IAAI,CAqBN;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,SAAS,GAAE,SAA4B,GACtC,IAAI,CAyBN;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAelG;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAgB9F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAgB3G;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAgBvG"}

package/dist/surfaceComposite.js

@@ -0,0 +1,230 @@
+import { invalidateImageResource } from '@flighthq/image';
+import { BlendMode } from '@flighthq/types';
+/**
+ * Alpha-composites `pixels` over `dest`. `pixels` must be at least
+ * `dest.width * dest.height * 4` bytes in row-major RGBA order.
+ *
+ * `blendMode` selects how the source combines with the backdrop. Separable
+ * blends applied before the Porter-Duff source-over: Normal (default) and Layer
+ * (= Normal), Multiply, Screen, Add, Subtract, Darken, Lighten, Difference,
+ * Overlay, Hardlight, Invert. Erase is a destination-out knockout. Alpha and
+ * Shader are display-list concepts with no surface meaning and throw.
+ */
+export function compositeSurfacePixels(dest, pixels, blendMode = BlendMode.Normal) {
+    assertCompositeBlendMode(blendMode);
+    for (let py = 0; py < dest.height; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= dest.surface.height)
+            continue;
+        for (let px = 0; px < dest.width; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= dest.surface.width)
+                continue;
+            const si = (py * dest.width + px) * 4;
+            compositePixelInto(dest.surface.data, (y * dest.surface.width + x) * 4, pixels[si], pixels[si + 1], pixels[si + 2], pixels[si + 3], blendMode);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Alpha-composites `source` over `dest`. See `compositeSurfacePixels` for the
+ * `blendMode` semantics.
+ */
+export function compositeSurfaceRegion(dest, source, blendMode = BlendMode.Normal) {
+    assertCompositeBlendMode(blendMode);
+    const sw = Math.min(dest.width, source.width);
+    const sh = Math.min(dest.height, source.height);
+    for (let py = 0; py < sh; py++) {
+        const sourceY = source.y + py;
+        const y = dest.y + py;
+        if (sourceY < 0 || sourceY >= source.surface.height || y < 0 || y >= dest.surface.height)
+            continue;
+        for (let px = 0; px < sw; px++) {
+            const sourceX = source.x + px;
+            const x = dest.x + px;
+            if (sourceX < 0 || sourceX >= source.surface.width || x < 0 || x >= dest.surface.width)
+                continue;
+            const si = (sourceY * source.surface.width + sourceX) * 4;
+            compositePixelInto(dest.surface.data, (y * dest.surface.width + x) * 4, source.surface.data[si], source.surface.data[si + 1], source.surface.data[si + 2], source.surface.data[si + 3], blendMode);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Copies `source` into `out` in row-major, tightly-packed RGBA order
+ * (stride = source.width). `out` must be at least
+ * `source.width * source.height * 4` bytes.
+ *
+ * Safe to pass `source.surface.data` as `out` when the region covers the
+ * full surface (x=0, y=0, width=source.surface.width,
+ * height=source.surface.height).
+ */
+export function extractSurfacePixels(out, source) {
+    for (let py = 0; py < source.height; py++) {
+        const sourceY = source.y + py;
+        if (sourceY < 0 || sourceY >= source.surface.height)
+            continue;
+        for (let px = 0; px < source.width; px++) {
+            const sourceX = source.x + px;
+            if (sourceX < 0 || sourceX >= source.surface.width)
+                continue;
+            const si = (sourceY * source.surface.width + sourceX) * 4;
+            const di = (py * source.width + px) * 4;
+            out[di] = source.surface.data[si];
+            out[di + 1] = source.surface.data[si + 1];
+            out[di + 2] = source.surface.data[si + 2];
+            out[di + 3] = source.surface.data[si + 3];
+        }
+    }
+}
+/**
+ * Copies `source` into `out` as one packed `0xRRGGBBAA` color per pixel
+ * (`0xRRGGBBAA` packed colors, the same packing `getSurfacePixel` returns), in row-major order with
+ * stride = source.width. `out` must hold at least
+ * `source.width * source.height` entries.
+ *
+ * This is the bulk, color-per-element counterpart to the byte-per-channel
+ * `extractSurfacePixels`: use it when you want to read or compare whole
+ * regions of colors without reassembling channel bytes.
+ */
+export function extractSurfacePixels32(out, source) {
+    for (let py = 0; py < source.height; py++) {
+        const sourceY = source.y + py;
+        if (sourceY < 0 || sourceY >= source.surface.height)
+            continue;
+        for (let px = 0; px < source.width; px++) {
+            const sourceX = source.x + px;
+            if (sourceX < 0 || sourceX >= source.surface.width)
+                continue;
+            const si = (sourceY * source.surface.width + sourceX) * 4;
+            out[py * source.width + px] =
+                ((source.surface.data[si] << 24) |
+                    (source.surface.data[si + 1] << 16) |
+                    (source.surface.data[si + 2] << 8) |
+                    source.surface.data[si + 3]) >>>
+                    0;
+        }
+    }
+}
+/**
+ * Writes `pixels` into `dest`, overwriting existing content.
+ * `pixels` must be at least `dest.width * dest.height * 4` bytes in
+ * row-major RGBA order.
+ */
+export function writeSurfacePixels(dest, pixels) {
+    for (let py = 0; py < dest.height; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= dest.surface.height)
+            continue;
+        for (let px = 0; px < dest.width; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= dest.surface.width)
+                continue;
+            const si = (py * dest.width + px) * 4;
+            const di = (y * dest.surface.width + x) * 4;
+            dest.surface.data[di] = pixels[si];
+            dest.surface.data[di + 1] = pixels[si + 1];
+            dest.surface.data[di + 2] = pixels[si + 2];
+            dest.surface.data[di + 3] = pixels[si + 3];
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Writes `pixels` into `dest`, overwriting existing content. Each entry is a
+ * packed `0xRRGGBBAA` color (the form `setSurfacePixel` takes), read in
+ * row-major order. `pixels` must hold at least `dest.width * dest.height`
+ * entries. This is the color-per-element counterpart to `writeSurfacePixels`.
+ */
+export function writeSurfacePixels32(dest, pixels) {
+    for (let py = 0; py < dest.height; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= dest.surface.height)
+            continue;
+        for (let px = 0; px < dest.width; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= dest.surface.width)
+                continue;
+            const color = pixels[py * dest.width + px];
+            const di = (y * dest.surface.width + x) * 4;
+            dest.surface.data[di] = (color >>> 24) & 0xff;
+            dest.surface.data[di + 1] = (color >> 16) & 0xff;
+            dest.surface.data[di + 2] = (color >> 8) & 0xff;
+            dest.surface.data[di + 3] = color & 0xff;
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+// Throws once, up front, for blend modes that have no surface-compositing meaning,
+// rather than silently degrading to Normal mid-loop.
+function assertCompositeBlendMode(blendMode) {
+    if (blendMode === BlendMode.Alpha || blendMode === BlendMode.Shader) {
+        throw new Error(`BlendMode.${BlendMode[blendMode]} is not supported by surface compositing`);
+    }
+}
+// Separable per-channel blend on 0..255 values. Normal/Layer (and any mode not
+// listed) return the source channel unchanged, reducing the composite to
+// source-over.
+function blendChannel(mode, cb, cs) {
+    switch (mode) {
+        case BlendMode.Multiply:
+            return (cb * cs) / 255;
+        case BlendMode.Screen:
+            return cb + cs - (cb * cs) / 255;
+        case BlendMode.Add:
+            return Math.min(255, cb + cs);
+        case BlendMode.Subtract:
+            return Math.max(0, cb - cs);
+        case BlendMode.Darken:
+            return Math.min(cb, cs);
+        case BlendMode.Lighten:
+            return Math.max(cb, cs);
+        case BlendMode.Difference:
+            return Math.abs(cb - cs);
+        case BlendMode.Overlay:
+            return cb < 128 ? (2 * cb * cs) / 255 : 255 - (2 * (255 - cb) * (255 - cs)) / 255;
+        case BlendMode.Hardlight:
+            return cs < 128 ? (2 * cb * cs) / 255 : 255 - (2 * (255 - cb) * (255 - cs)) / 255;
+        case BlendMode.Invert:
+            return 255 - cb;
+        default:
+            return cs;
+    }
+}
+function compositePixelInto(dest, di, r, g, b, a, blendMode) {
+    const srcA = a / 255;
+    const dstA = dest[di + 3] / 255;
+    // Erase is a destination-out knockout: the source alpha carves into the
+    // backdrop's alpha, leaving its color untouched.
+    if (blendMode === BlendMode.Erase) {
+        const eraseA = dstA * (1 - srcA);
+        if (eraseA <= 0) {
+            dest[di] = 0;
+            dest[di + 1] = 0;
+            dest[di + 2] = 0;
+        }
+        dest[di + 3] = Math.round(eraseA * 255);
+        return;
+    }
+    const outA = srcA + dstA * (1 - srcA);
+    if (outA <= 0) {
+        dest[di] = 0;
+        dest[di + 1] = 0;
+        dest[di + 2] = 0;
+        dest[di + 3] = 0;
+        return;
+    }
+    // W3C compositing: mix the blended color into the source by the backdrop alpha,
+    // then source-over. Read backdrop channels before writing any of them.
+    const cbR = dest[di];
+    const cbG = dest[di + 1];
+    const cbB = dest[di + 2];
+    const csR = (1 - dstA) * r + dstA * blendChannel(blendMode, cbR, r);
+    const csG = (1 - dstA) * g + dstA * blendChannel(blendMode, cbG, g);
+    const csB = (1 - dstA) * b + dstA * blendChannel(blendMode, cbB, b);
+    dest[di] = Math.round((csR * srcA + cbR * dstA * (1 - srcA)) / outA);
+    dest[di + 1] = Math.round((csG * srcA + cbG * dstA * (1 - srcA)) / outA);
+    dest[di + 2] = Math.round((csB * srcA + cbB * dstA * (1 - srcA)) / outA);
+    dest[di + 3] = Math.round(outA * 255);
+}
+//# sourceMappingURL=surfaceComposite.js.map

package/dist/surfaceComposite.js.map

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

package/dist/surfaceConvolution.d.ts

@@ -0,0 +1,27 @@
+import type { SurfaceEdgeMode, SurfaceRegion } from '@flighthq/types';
+export interface SurfaceConvolutionOptions {
+    bias?: number;
+    /** How to handle kernel samples outside the surface. Default 'clamp'. */
+    edge?: SurfaceEdgeMode;
+    divisor?: number;
+    matrix: ReadonlyArray<number>;
+    matrixX: number;
+    matrixY: number;
+    preserveAlpha?: boolean;
+}
+/**
+ * Applies a convolution kernel to `source` and writes into `out`.
+ * `out` must be at least `source.width * source.height * 4` bytes.
+ *
+ * `out` must not alias `source.surface.data` — convolution reads neighboring
+ * pixels during kernel evaluation; overlapping source and destination produces
+ * undefined results.
+ *
+ * Edge modes:
+ *   - `'clamp'` (default): repeat the nearest edge pixel
+ *   - `'transparent'`: treat out-of-bounds samples as transparent black
+ *   - `'wrap'`: tile the surface toroidally
+ *   - `'mirror'`: reflect the image at boundaries
+ */
+export declare function convolveSurface(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>, options: Readonly<SurfaceConvolutionOptions>): void;
+//# sourceMappingURL=surfaceConvolution.d.ts.map

package/dist/surfaceConvolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceConvolution.d.ts","sourceRoot":"","sources":["../src/surfaceConvolution.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEtE,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,EAAE,QAAQ,CAAC,yBAAyB,CAAC,GAC3C,IAAI,CAqEN"}