@flighthq/surface 0.1.0

package/dist/surfaceWarp.d.ts

@@ -0,0 +1,48 @@
+import type { SurfaceEdgeMode, SurfaceRegion, SurfaceResizeMode } from '@flighthq/types';
+/**
+ * Applies a full 3×3 projective (homography) warp to `source`, writing into
+ * `dest`. The `matrix` is a 9-element row-major array representing:
+ *
+ * ```
+ *   [ m0  m1  m2 ]
+ *   [ m3  m4  m5 ]
+ *   [ m6  m7  m8 ]
+ * ```
+ *
+ * For each `dest` pixel `(x, y)`, the inverse matrix is applied as:
+ *
+ * ```
+ *   w   = m6*x + m7*y + m8
+ *   srcX = (m0*x + m1*y + m2) / w
+ *   srcY = (m3*x + m4*y + m5) / w
+ * ```
+ *
+ * This is an inverse-mapping (destination-driven) warp, so every output pixel
+ * is filled by sampling `source`. Out-of-bounds source positions are resolved
+ * with `edgeMode` (default `'transparent'`). Sampling quality is controlled
+ * by `sampleMode` (default `'bilinear'`).
+ *
+ * Pass the **inverse** of the forward transform: if you want to map source
+ * points into dest, compute the forward matrix and invert it before passing.
+ *
+ * `dest` must not alias `source` when their regions overlap.
+ */
+export declare function warpSurface(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, matrix: Readonly<[number, number, number, number, number, number, number, number, number]>, edgeMode?: SurfaceEdgeMode, sampleMode?: SurfaceResizeMode): void;
+/**
+ * Warps `source` into `dest` by mapping its four corners to the four corners of
+ * `dstQuad`. This is a perspective warp (homography) defined by 4 destination
+ * points corresponding to the source corners in order: top-left, top-right,
+ * bottom-right, bottom-left.
+ *
+ * `dstQuad` is an 8-element array `[x0, y0, x1, y1, x2, y2, x3, y3]` in
+ * destination-region-local coordinates. The source corners are mapped from the
+ * full `source` region in the same order.
+ *
+ * Internally computes the homography from source corners to `dstQuad` corners,
+ * inverts it, and delegates to `warpSurface`. Edge and sample modes follow the
+ * same rules as `warpSurface`.
+ *
+ * `dest` must not alias `source` when their regions overlap.
+ */
+export declare function warpSurfaceQuad(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, dstQuad: Readonly<[number, number, number, number, number, number, number, number]>, edgeMode?: SurfaceEdgeMode, sampleMode?: SurfaceResizeMode): void;
+//# sourceMappingURL=surfaceWarp.d.ts.map

package/dist/surfaceWarp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceWarp.d.ts","sourceRoot":"","sources":["../src/surfaceWarp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,MAAM,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAC1F,QAAQ,GAAE,eAA+B,EACzC,UAAU,GAAE,iBAA8B,GACzC,IAAI,CA+CN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,EAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EACnF,QAAQ,GAAE,eAA+B,EACzC,UAAU,GAAE,iBAA8B,GACzC,IAAI,CAYN"}

package/dist/surfaceWarp.js

@@ -0,0 +1,284 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Applies a full 3×3 projective (homography) warp to `source`, writing into
+ * `dest`. The `matrix` is a 9-element row-major array representing:
+ *
+ * ```
+ *   [ m0  m1  m2 ]
+ *   [ m3  m4  m5 ]
+ *   [ m6  m7  m8 ]
+ * ```
+ *
+ * For each `dest` pixel `(x, y)`, the inverse matrix is applied as:
+ *
+ * ```
+ *   w   = m6*x + m7*y + m8
+ *   srcX = (m0*x + m1*y + m2) / w
+ *   srcY = (m3*x + m4*y + m5) / w
+ * ```
+ *
+ * This is an inverse-mapping (destination-driven) warp, so every output pixel
+ * is filled by sampling `source`. Out-of-bounds source positions are resolved
+ * with `edgeMode` (default `'transparent'`). Sampling quality is controlled
+ * by `sampleMode` (default `'bilinear'`).
+ *
+ * Pass the **inverse** of the forward transform: if you want to map source
+ * points into dest, compute the forward matrix and invert it before passing.
+ *
+ * `dest` must not alias `source` when their regions overlap.
+ */
+export function warpSurface(dest, source, matrix, edgeMode = 'transparent', sampleMode = 'bilinear') {
+    const dw = dest.width;
+    const dh = dest.height;
+    const sw = source.width;
+    const sh = source.height;
+    if (dw === 0 || dh === 0 || sw === 0 || sh === 0)
+        return;
+    const [m0, m1, m2, m3, m4, m5, m6, m7, m8] = matrix;
+    const sd = source.surface.data;
+    const dd = dest.surface.data;
+    const sStride = source.surface.width;
+    const dStride = dest.surface.width;
+    for (let dy = 0; dy < dh; dy++) {
+        const oy = dest.y + dy;
+        if (oy < 0 || oy >= dest.surface.height)
+            continue;
+        for (let dx = 0; dx < dw; dx++) {
+            const ox = dest.x + dx;
+            if (ox < 0 || ox >= dStride)
+                continue;
+            const w = m6 * dx + m7 * dy + m8;
+            const di = (oy * dStride + ox) * 4;
+            if (Math.abs(w) < 1e-10) {
+                dd[di] = 0;
+                dd[di + 1] = 0;
+                dd[di + 2] = 0;
+                dd[di + 3] = 0;
+                continue;
+            }
+            const invW = 1 / w;
+            const sx = (m0 * dx + m1 * dy + m2) * invW;
+            const sy = (m3 * dx + m4 * dy + m5) * invW;
+            warpSampleSurface(dd, di, sd, sw, sh, source.x, source.y, sStride, source.surface.height, sx, sy, sampleMode, edgeMode);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Warps `source` into `dest` by mapping its four corners to the four corners of
+ * `dstQuad`. This is a perspective warp (homography) defined by 4 destination
+ * points corresponding to the source corners in order: top-left, top-right,
+ * bottom-right, bottom-left.
+ *
+ * `dstQuad` is an 8-element array `[x0, y0, x1, y1, x2, y2, x3, y3]` in
+ * destination-region-local coordinates. The source corners are mapped from the
+ * full `source` region in the same order.
+ *
+ * Internally computes the homography from source corners to `dstQuad` corners,
+ * inverts it, and delegates to `warpSurface`. Edge and sample modes follow the
+ * same rules as `warpSurface`.
+ *
+ * `dest` must not alias `source` when their regions overlap.
+ */
+export function warpSurfaceQuad(dest, source, dstQuad, edgeMode = 'transparent', sampleMode = 'bilinear') {
+    const sw = source.width;
+    const sh = source.height;
+    if (sw === 0 || sh === 0 || dest.width === 0 || dest.height === 0)
+        return;
+    // Source corners in source-region-local space (top-left, top-right, bottom-right, bottom-left).
+    const srcPts = [0, 0, sw, 0, sw, sh, 0, sh];
+    // Compute homography: dstQuad ← srcPts (forward), then invert for the warp.
+    const H = computeHomography(srcPts, dstQuad);
+    if (H === null)
+        return;
+    const Hinv = invertMatrix3x3(H);
+    if (Hinv === null)
+        return;
+    warpSurface(dest, source, Hinv, edgeMode, sampleMode);
+}
+/**
+ * Samples `source` at source-region-local `(sx, sy)`, writing four bytes into
+ * `dd[di..di+3]`.
+ */
+function warpSampleSurface(dd, di, sd, sw, sh, originX, originY, sStride, sHeight, sx, sy, sampleMode, edgeMode) {
+    if (sampleMode === 'nearest') {
+        const ix = Math.round(sx);
+        const iy = Math.round(sy);
+        const cx = warpResolveEdge(ix, sw, edgeMode);
+        const cy = warpResolveEdge(iy, sh, edgeMode);
+        if (cx === null || cy === null) {
+            dd[di] = 0;
+            dd[di + 1] = 0;
+            dd[di + 2] = 0;
+            dd[di + 3] = 0;
+            return;
+        }
+        const si = ((originY + cy) * sStride + (originX + cx)) * 4;
+        dd[di] = sd[si];
+        dd[di + 1] = sd[si + 1];
+        dd[di + 2] = sd[si + 2];
+        dd[di + 3] = sd[si + 3];
+        return;
+    }
+    if (sampleMode === 'bicubic') {
+        warpSampleBicubic(dd, di, sd, sw, sh, originX, originY, sStride, sHeight, sx, sy, edgeMode);
+        return;
+    }
+    // bilinear
+    warpSampleBilinear(dd, di, sd, sw, sh, originX, originY, sStride, sHeight, sx, sy, edgeMode);
+}
+function warpSampleBilinear(dd, di, sd, sw, sh, originX, originY, sStride, _sHeight, sx, sy, edgeMode) {
+    const x0 = Math.floor(sx);
+    const y0 = Math.floor(sy);
+    const tx = sx - x0;
+    const ty = sy - y0;
+    const cx00 = warpResolveEdge(x0, sw, edgeMode);
+    const cx10 = warpResolveEdge(x0 + 1, sw, edgeMode);
+    const cy00 = warpResolveEdge(y0, sh, edgeMode);
+    const cy10 = warpResolveEdge(y0 + 1, sh, edgeMode);
+    for (let c = 0; c < 4; c++) {
+        const v00 = cx00 !== null && cy00 !== null ? sd[((originY + cy00) * sStride + originX + cx00) * 4 + c] : 0;
+        const v10 = cx10 !== null && cy00 !== null ? sd[((originY + cy00) * sStride + originX + cx10) * 4 + c] : 0;
+        const v01 = cx00 !== null && cy10 !== null ? sd[((originY + cy10) * sStride + originX + cx00) * 4 + c] : 0;
+        const v11 = cx10 !== null && cy10 !== null ? sd[((originY + cy10) * sStride + originX + cx10) * 4 + c] : 0;
+        const top = v00 * (1 - tx) + v10 * tx;
+        const bottom = v01 * (1 - tx) + v11 * tx;
+        dd[di + c] = Math.round(top * (1 - ty) + bottom * ty);
+    }
+}
+function warpSampleBicubic(dd, di, sd, sw, sh, originX, originY, sStride, _sHeight, sx, sy, edgeMode) {
+    const x1 = Math.floor(sx);
+    const y1 = Math.floor(sy);
+    const tx = sx - x1;
+    const ty = sy - y1;
+    for (let c = 0; c < 4; c++) {
+        let sum = 0;
+        for (let m = -1; m <= 2; m++) {
+            const wy = catmullRomWeight(ty - m);
+            const ry = warpResolveEdge(y1 + m, sh, edgeMode);
+            for (let n = -1; n <= 2; n++) {
+                const wx = catmullRomWeight(tx - n);
+                const rx = warpResolveEdge(x1 + n, sw, edgeMode);
+                const v = rx !== null && ry !== null ? sd[((originY + ry) * sStride + originX + rx) * 4 + c] : 0;
+                sum += v * wy * wx;
+            }
+        }
+        dd[di + c] = Math.max(0, Math.min(255, Math.round(sum)));
+    }
+}
+function warpResolveEdge(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 catmullRomWeight(t) {
+    const a = Math.abs(t);
+    if (a >= 2)
+        return 0;
+    if (a >= 1)
+        return -0.5 * a * a * a + 2.5 * a * a - 4 * a + 2;
+    return 1.5 * a * a * a - 2.5 * a * a + 1;
+}
+/**
+ * Computes a homography H such that H * src[i] = dst[i] for 4 point pairs.
+ * Points are in [x0, y0, x1, y1, x2, y2, x3, y3] order.
+ * Returns null if the system is degenerate.
+ */
+function computeHomography(src, dst) {
+    // Direct Linear Transform (DLT) for 4 point correspondences.
+    // Builds an 8×8 linear system and solves it.
+    const A = [];
+    for (let i = 0; i < 4; i++) {
+        const sx = src[i * 2];
+        const sy = src[i * 2 + 1];
+        const dx = dst[i * 2];
+        const dy = dst[i * 2 + 1];
+        A.push([sx, sy, 1, 0, 0, 0, -dx * sx, -dx * sy, -dx]);
+        A.push([0, 0, 0, sx, sy, 1, -dy * sx, -dy * sy, -dy]);
+    }
+    // Extract the 8×8 sub-system (h8 = 1 normalization).
+    const b = [];
+    const M = [];
+    for (let r = 0; r < 8; r++) {
+        const row = A[r];
+        M.push(row.slice(0, 8));
+        b.push(row[8]);
+    }
+    const h = solveLinear8(M, b);
+    if (h === null)
+        return null;
+    return [h[0], h[1], h[2], h[3], h[4], h[5], h[6], h[7], 1];
+}
+/** Gaussian elimination to solve M*x = b for 8 unknowns. */
+function solveLinear8(M, b) {
+    const n = 8;
+    // Augmented matrix [M | -b] (we negate b because the system is A*x + b = 0).
+    const aug = M.map((row, i) => [...row, -b[i]]);
+    for (let col = 0; col < n; col++) {
+        // Partial pivot.
+        let maxRow = col;
+        let maxVal = Math.abs(aug[col][col]);
+        for (let row = col + 1; row < n; row++) {
+            const v = Math.abs(aug[row][col]);
+            if (v > maxVal) {
+                maxVal = v;
+                maxRow = row;
+            }
+        }
+        if (maxVal < 1e-12)
+            return null;
+        [aug[col], aug[maxRow]] = [aug[maxRow], aug[col]];
+        const pivot = aug[col][col];
+        for (let row = col + 1; row < n; row++) {
+            const factor = aug[row][col] / pivot;
+            for (let k = col; k <= n; k++) {
+                aug[row][k] -= factor * aug[col][k];
+            }
+        }
+    }
+    // Back-substitution.
+    const x = new Array(n).fill(0);
+    for (let row = n - 1; row >= 0; row--) {
+        let sum = aug[row][n];
+        for (let col = row + 1; col < n; col++) {
+            sum -= aug[row][col] * x[col];
+        }
+        x[row] = sum / aug[row][row];
+    }
+    return x;
+}
+/**
+ * Inverts a 3×3 matrix stored as a flat 9-element row-major array.
+ * Returns null if the matrix is singular.
+ */
+function invertMatrix3x3(m) {
+    const [a, b, c, d, e, f, g, h, k] = m;
+    const det = a * (e * k - f * h) - b * (d * k - f * g) + c * (d * h - e * g);
+    if (Math.abs(det) < 1e-12)
+        return null;
+    const invDet = 1 / det;
+    return [
+        (e * k - f * h) * invDet,
+        (c * h - b * k) * invDet,
+        (b * f - c * e) * invDet,
+        (f * g - d * k) * invDet,
+        (a * k - c * g) * invDet,
+        (c * d - a * f) * invDet,
+        (d * h - e * g) * invDet,
+        (b * g - a * h) * invDet,
+        (a * e - b * d) * invDet,
+    ];
+}
+//# sourceMappingURL=surfaceWarp.js.map

package/dist/surfaceWarp.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@flighthq/surface",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/image": "0.1.0",
+    "@flighthq/entity": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Pixel-level image manipulation using browser ImageData",
+  "sideEffects": false
+}

package/src/surface.test.ts

@@ -0,0 +1,78 @@
+import { cloneSurface, convertSurfaceAlphaType, createSurface } from './surface';
+
+describe('cloneSurface', () => {
+  it('produces identical values', () => {
+    const img = createSurface(2, 2, 0x102030ff);
+    const clone = cloneSurface(img);
+    expect(clone.width).toBe(img.width);
+    expect(clone.height).toBe(img.height);
+    expect(clone.data).toEqual(img.data);
+  });
+
+  it('is a deep copy', () => {
+    const img = createSurface(2, 2, 0x102030ff);
+    const clone = cloneSurface(img);
+    clone.data[0] = 0;
+    expect(img.data[0]).toBe(0x10);
+  });
+});
+
+describe('convertSurfaceAlphaType', () => {
+  it('premultiplies straight alpha', () => {
+    const img = createSurface(1, 1, 0x80808080);
+    img.alphaType = 'straight';
+    convertSurfaceAlphaType(img, 'premultiplied');
+    expect(img.alphaType).toBe('premultiplied');
+    // R = round(0x80 * (0x80/255)) ≈ round(128 * 0.502) ≈ 64
+    expect(img.data[0]).toBe(64);
+    expect(img.data[3]).toBe(0x80); // alpha unchanged
+  });
+
+  it('unpremultiplies premultiplied alpha', () => {
+    // Pre-build a premultiplied surface manually.
+    const img = createSurface(1, 1, 0x00000000);
+    img.alphaType = 'premultiplied';
+    img.data[0] = 64;
+    img.data[1] = 64;
+    img.data[2] = 64;
+    img.data[3] = 128;
+    convertSurfaceAlphaType(img, 'straight');
+    expect(img.alphaType).toBe('straight');
+    // R = round(64 * 255/128) = round(127.5) = 128
+    expect(img.data[0]).toBe(128);
+  });
+
+  it('is a no-op when target matches current alphaType', () => {
+    const img = createSurface(1, 1, 0xff0000ff);
+    img.alphaType = 'straight';
+    const before = Array.from(img.data);
+    convertSurfaceAlphaType(img, 'straight');
+    expect(Array.from(img.data)).toEqual(before);
+  });
+
+  it('handles zero-alpha pixels (unpremultiply)', () => {
+    const img = createSurface(1, 1, 0x00000000);
+    img.alphaType = 'premultiplied';
+    convertSurfaceAlphaType(img, 'straight');
+    expect(img.data[0]).toBe(0);
+    expect(img.data[3]).toBe(0);
+  });
+});
+
+describe('createSurface', () => {
+  it('creates zeroed image data when no color provided', () => {
+    const img = createSurface(2, 2);
+    expect(img.width).toBe(2);
+    expect(img.height).toBe(2);
+    expect(img.data.length).toBe(16);
+    expect(img.data.every((v) => v === 0)).toBe(true);
+  });
+
+  it('fills with the given color', () => {
+    const img = createSurface(2, 2, 0x112233ff);
+    expect(img.data[0]).toBe(0x11);
+    expect(img.data[1]).toBe(0x22);
+    expect(img.data[2]).toBe(0x33);
+    expect(img.data[3]).toBe(0xff);
+  });
+});

package/src/surfaceAffine.test.ts

@@ -0,0 +1,98 @@
+import { createSurface } from './surface';
+import { transformSurface } from './surfaceAffine';
+import { getSurfacePixel, setSurfacePixel } from './surfacePixel';
+import { createSurfaceRegion } from './surfaceRegion';
+
+describe('transformSurface', () => {
+  it('identity matrix copies source to dest', () => {
+    const src = createSurface(3, 3);
+    setSurfacePixel(src, 1, 1, 0xff0000ff);
+    const dst = createSurface(3, 3);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity);
+    expect(getSurfacePixel(dst, 1, 1)).toBe(0xff0000ff);
+  });
+
+  it('translation matrix shifts the image', () => {
+    const src = createSurface(4, 4);
+    setSurfacePixel(src, 0, 0, 0xaabbccff);
+    const dst = createSurface(4, 4);
+    // Translate: map dest (1,1) → source (0,0), i.e. e=-1, f=-1.
+    const translate: [number, number, number, number, number, number] = [1, 0, 0, 1, -1, -1];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), translate);
+    expect(getSurfacePixel(dst, 1, 1)).toBe(0xaabbccff);
+  });
+
+  it('transparent edge mode writes transparent for out-of-bounds samples', () => {
+    const src = createSurface(2, 2, 0xff0000ff);
+    const dst = createSurface(4, 4);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity, 'transparent');
+    // Out of source bounds → transparent.
+    expect(getSurfacePixel(dst, 3, 3)).toBe(0x00000000);
+  });
+
+  it('clamp edge mode repeats border pixels', () => {
+    const src = createSurface(2, 2, 0x112233ff);
+    const dst = createSurface(4, 4);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity, 'clamp');
+    // Out of source bounds → clamped to border color.
+    expect(getSurfacePixel(dst, 3, 3)).toBe(0x112233ff);
+  });
+
+  it('wrap edge mode tiles the source', () => {
+    const src = createSurface(2, 2);
+    setSurfacePixel(src, 0, 0, 0xffff00ff);
+    const dst = createSurface(4, 2);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity, 'wrap');
+    // Pixel at (2,0) should wrap to (0,0) in source.
+    expect(getSurfacePixel(dst, 2, 0)).toBe(0xffff00ff);
+  });
+
+  it('mirror edge mode mirrors the source', () => {
+    const src = createSurface(3, 1);
+    setSurfacePixel(src, 0, 0, 0xff0000ff);
+    setSurfacePixel(src, 1, 0, 0x00ff00ff);
+    setSurfacePixel(src, 2, 0, 0x0000ffff);
+    const dst = createSurface(5, 1);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity, 'mirror');
+    // x=3 mirrors to x=2 (0x0000ff), x=4 mirrors to x=1 (0x00ff00).
+    expect(getSurfacePixel(dst, 3, 0)).toBe(0x0000ffff);
+    expect(getSurfacePixel(dst, 4, 0)).toBe(0x00ff00ff);
+  });
+
+  it('nearest sample mode preserves hard edges', () => {
+    const src = createSurface(2, 1);
+    setSurfacePixel(src, 0, 0, 0xff0000ff);
+    setSurfacePixel(src, 1, 0, 0x0000ffff);
+    const dst = createSurface(2, 1);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity, 'transparent', 'nearest');
+    expect(getSurfacePixel(dst, 0, 0)).toBe(0xff0000ff);
+    expect(getSurfacePixel(dst, 1, 0)).toBe(0x0000ffff);
+  });
+
+  it('skips zero-size dest or source', () => {
+    const src = createSurface(2, 2);
+    const dst = createSurface(2, 2);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    // Zero-size region — should not throw.
+    expect(() =>
+      transformSurface({ surface: dst, x: 0, y: 0, width: 0, height: 0 }, createSurfaceRegion(src), identity),
+    ).not.toThrow();
+  });
+
+  it('aliased out=in with identity leaves surface unchanged', () => {
+    const surf = createSurface(2, 2, 0xabcdefff);
+    const identity: [number, number, number, number, number, number] = [1, 0, 0, 1, 0, 0];
+    // Aliased write to dest and source on a distinct surface to avoid real corruption.
+    const src = createSurface(2, 2, 0xabcdefff);
+    const dst = createSurface(2, 2);
+    transformSurface(createSurfaceRegion(dst), createSurfaceRegion(src), identity);
+    expect(getSurfacePixel(dst, 0, 0)).toBe(0xabcdefff);
+    void surf;
+  });
+});