@flighthq/surface 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+export * from './surface';
+export * from './surfaceAffine';
+export * from './surfaceAlpha';
+export * from './surfaceBevel';
+export * from './surfaceBlur';
+export * from './surfaceChannel';
+export * from './surfaceColorMatrix';
+export * from './surfaceCompare';
+export * from './surfaceComposite';
+export * from './surfaceConvolution';
+export * from './surfaceCopy';
+export * from './surfaceCoverage';
+export * from './surfaceCrop';
+export * from './surfaceDisplacement';
+export * from './surfaceDissolve';
+export * from './surfaceDraw';
+export * from './surfaceEncode';
+export * from './surfaceFill';
+export * from './surfaceFingerprint';
+export * from './surfaceFlip';
+export * from './surfaceFormat';
+export * from './surfaceFrom';
+export * from './surfaceGradient';
+export * from './surfaceGradientFill';
+export * from './surfaceHistogram';
+export * from './surfaceImageChannel';
+export * from './surfaceMedian';
+export * from './surfaceMorphological';
+export * from './surfaceNoise';
+export * from './surfacePaletteMap';
+export * from './surfacePixel';
+export * from './surfacePixelate';
+export * from './surfaceQuery';
+export * from './surfaceRegion';
+export * from './surfaceResize';
+export * from './surfaceRotate';
+export * from './surfaceShadow';
+export * from './surfaceSharpen';
+export * from './surfaceTone';
+export * from './surfaceTransform';
+export * from './surfaceWarp';
+export type { AlphaType, ImageFormat, PixelFormat, PixelOrder, RectangleLike, Surface, SurfaceEdgeMode, SurfaceFingerprint, SurfaceHistogram, SurfaceMismatch, SurfaceRegion, SurfaceResizeMode, ThresholdOperation, } from '@flighthq/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,EACb,OAAO,EACP,eAAe,EACf,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,42 @@
+export * from './surface';
+export * from './surfaceAffine';
+export * from './surfaceAlpha';
+export * from './surfaceBevel';
+export * from './surfaceBlur';
+export * from './surfaceChannel';
+export * from './surfaceColorMatrix';
+export * from './surfaceCompare';
+export * from './surfaceComposite';
+export * from './surfaceConvolution';
+export * from './surfaceCopy';
+export * from './surfaceCoverage';
+export * from './surfaceCrop';
+export * from './surfaceDisplacement';
+export * from './surfaceDissolve';
+export * from './surfaceDraw';
+export * from './surfaceEncode';
+export * from './surfaceFill';
+export * from './surfaceFingerprint';
+export * from './surfaceFlip';
+export * from './surfaceFormat';
+export * from './surfaceFrom';
+export * from './surfaceGradient';
+export * from './surfaceGradientFill';
+export * from './surfaceHistogram';
+export * from './surfaceImageChannel';
+export * from './surfaceMedian';
+export * from './surfaceMorphological';
+export * from './surfaceNoise';
+export * from './surfacePaletteMap';
+export * from './surfacePixel';
+export * from './surfacePixelate';
+export * from './surfaceQuery';
+export * from './surfaceRegion';
+export * from './surfaceResize';
+export * from './surfaceRotate';
+export * from './surfaceShadow';
+export * from './surfaceSharpen';
+export * from './surfaceTone';
+export * from './surfaceTransform';
+export * from './surfaceWarp';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC"}

package/dist/surface.d.ts

@@ -0,0 +1,16 @@
+import type { AlphaType, Surface } from '@flighthq/types';
+export declare function cloneSurface(source: Readonly<Surface>): Surface;
+/**
+ * Converts the alpha representation of `out` in place between `'straight'` and
+ * `'premultiplied'`. If `out.alphaType` already matches `target`, this is a
+ * no-op (neither pixel data nor the metadata field changes).
+ *
+ * - `'straight' → 'premultiplied'`: RGB channels are multiplied by alpha/255.
+ * - `'premultiplied' → 'straight'`: RGB channels are divided by alpha/255.
+ *   Pixels with alpha=0 are left as `(0,0,0,0)`.
+ *
+ * Updates `out.alphaType` to `target` after conversion.
+ */
+export declare function convertSurfaceAlphaType(out: Surface, target: AlphaType): void;
+export declare function createSurface(width: number, height: number, color?: number): Surface;
+//# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1D,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,OAAO,CAW/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA6B7E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAwBvF"}

package/dist/surface.js

@@ -0,0 +1,84 @@
+import { createEntity } from '@flighthq/entity';
+import { invalidateImageResource } from '@flighthq/image';
+export function cloneSurface(source) {
+    return createEntity({
+        alphaType: source.alphaType,
+        colorSpace: source.colorSpace,
+        data: new Uint8ClampedArray(source.data),
+        format: source.format,
+        height: source.height,
+        source: null,
+        version: 0,
+        width: source.width,
+    });
+}
+/**
+ * Converts the alpha representation of `out` in place between `'straight'` and
+ * `'premultiplied'`. If `out.alphaType` already matches `target`, this is a
+ * no-op (neither pixel data nor the metadata field changes).
+ *
+ * - `'straight' → 'premultiplied'`: RGB channels are multiplied by alpha/255.
+ * - `'premultiplied' → 'straight'`: RGB channels are divided by alpha/255.
+ *   Pixels with alpha=0 are left as `(0,0,0,0)`.
+ *
+ * Updates `out.alphaType` to `target` after conversion.
+ */
+export function convertSurfaceAlphaType(out, target) {
+    if (out.alphaType === target)
+        return;
+    const data = out.data;
+    const len = out.width * out.height * 4;
+    if (target === 'premultiplied') {
+        for (let i = 0; i < len; i += 4) {
+            const a = data[i + 3] / 255;
+            data[i] = Math.round(data[i] * a);
+            data[i + 1] = Math.round(data[i + 1] * a);
+            data[i + 2] = Math.round(data[i + 2] * a);
+        }
+    }
+    else {
+        for (let i = 0; i < len; i += 4) {
+            const a = data[i + 3];
+            if (a === 0) {
+                data[i] = 0;
+                data[i + 1] = 0;
+                data[i + 2] = 0;
+            }
+            else {
+                const inv = 255 / a;
+                data[i] = Math.min(255, Math.round(data[i] * inv));
+                data[i + 1] = Math.min(255, Math.round(data[i + 1] * inv));
+                data[i + 2] = Math.min(255, Math.round(data[i + 2] * inv));
+            }
+        }
+    }
+    // Mutate the alphaType metadata field.
+    out.alphaType = target;
+    invalidateImageResource(out);
+}
+export function createSurface(width, height, color = 0) {
+    const data = new Uint8ClampedArray(width * height * 4);
+    if (color !== 0) {
+        const r = (color >>> 24) & 0xff;
+        const g = (color >> 16) & 0xff;
+        const b = (color >> 8) & 0xff;
+        const a = color & 0xff;
+        for (let i = 0; i < data.length; i += 4) {
+            data[i] = r;
+            data[i + 1] = g;
+            data[i + 2] = b;
+            data[i + 3] = a;
+        }
+    }
+    return createEntity({
+        alphaType: 'straight',
+        colorSpace: 'srgb',
+        data,
+        format: 'rgba8unorm',
+        height,
+        source: null,
+        version: 0,
+        width,
+    });
+}
+//# sourceMappingURL=surface.js.map

package/dist/surface.js.map

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

package/dist/surfaceAffine.d.ts

@@ -0,0 +1,27 @@
+import type { SurfaceEdgeMode, SurfaceRegion, SurfaceResizeMode } from '@flighthq/types';
+/**
+ * Applies a full 2×3 affine transform to the `source` region, writing into
+ * `dest`. The `matrix` is a 6-element array `[a, b, c, d, e, f]` representing:
+ *
+ * ```
+ *   [ a  c  e ]
+ *   [ b  d  f ]
+ * ```
+ *
+ * Maps each `dest` pixel `(x, y)` back to source coordinates by the inverse
+ * transform:
+ *
+ * ```
+ *   srcX = a * x + c * y + e
+ *   srcY = b * x + d * y + f
+ * ```
+ *
+ * This is a forward-mapping: for each output pixel the source position is
+ * computed, then sampled according to `sampleMode` (default `'bilinear'`).
+ * Out-of-bounds source positions are resolved with `edgeMode` (default
+ * `'transparent'`).
+ *
+ * `dest` must not alias `source` when their regions overlap.
+ */
+export declare function transformSurface(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, matrix: Readonly<[number, number, number, number, number, number]>, edgeMode?: SurfaceEdgeMode, sampleMode?: SurfaceResizeMode): void;
+//# sourceMappingURL=surfaceAffine.d.ts.map

package/dist/surfaceAffine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceAffine.d.ts","sourceRoot":"","sources":["../src/surfaceAffine.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,gBAAgB,CAC9B,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,CAAC,CAAC,EAClE,QAAQ,GAAE,eAA+B,EACzC,UAAU,GAAE,iBAA8B,GACzC,IAAI,CAuCN"}

package/dist/surfaceAffine.js

@@ -0,0 +1,159 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Applies a full 2×3 affine transform to the `source` region, writing into
+ * `dest`. The `matrix` is a 6-element array `[a, b, c, d, e, f]` representing:
+ *
+ * ```
+ *   [ a  c  e ]
+ *   [ b  d  f ]
+ * ```
+ *
+ * Maps each `dest` pixel `(x, y)` back to source coordinates by the inverse
+ * transform:
+ *
+ * ```
+ *   srcX = a * x + c * y + e
+ *   srcY = b * x + d * y + f
+ * ```
+ *
+ * This is a forward-mapping: for each output pixel the source position is
+ * computed, then sampled according to `sampleMode` (default `'bilinear'`).
+ * Out-of-bounds source positions are resolved with `edgeMode` (default
+ * `'transparent'`).
+ *
+ * `dest` must not alias `source` when their regions overlap.
+ */
+export function transformSurface(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 [a, b, c, d, e, f] = 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;
+            // Map dest pixel to source coordinates.
+            const sx = a * dx + c * dy + e;
+            const sy = b * dx + d * dy + f;
+            const di = (oy * dStride + ox) * 4;
+            sampleSurface(dd, di, sd, sw, sh, source.x, source.y, sStride, source.surface.height, sx, sy, sampleMode, edgeMode);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Samples the source surface at fractional coordinates `(sx, sy)` in
+ * source-region-local space, writing the result into `dd[di..di+3]`. Edge
+ * behaviour is controlled by `edgeMode`; sampling quality by `sampleMode`.
+ */
+function sampleSurface(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 = resolveEdge(ix, sw, edgeMode);
+        const cy = resolveEdge(iy, sh, edgeMode);
+        if (cx === null || cy === null) {
+            writeTransparent(dd, di);
+            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') {
+        sampleBicubic(dd, di, sd, sw, sh, originX, originY, sStride, sHeight, sx, sy, edgeMode);
+        return;
+    }
+    // bilinear (default)
+    sampleBilinear(dd, di, sd, sw, sh, originX, originY, sStride, sHeight, sx, sy, edgeMode);
+}
+function sampleBilinear(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 = resolveEdge(x0, sw, edgeMode);
+    const cx10 = resolveEdge(x0 + 1, sw, edgeMode);
+    const cy00 = resolveEdge(y0, sh, edgeMode);
+    const cy10 = resolveEdge(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 sampleBicubic(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 = resolveEdge(y1 + m, sh, edgeMode);
+            for (let n = -1; n <= 2; n++) {
+                const wx = catmullRomWeight(tx - n);
+                const rx = resolveEdge(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)));
+    }
+}
+/**
+ * Maps a local coordinate `v` in `[0, size)` using the edge mode.
+ * Returns `null` for `'transparent'` when out of bounds.
+ */
+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;
+    }
+}
+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;
+}
+function writeTransparent(dd, di) {
+    dd[di] = 0;
+    dd[di + 1] = 0;
+    dd[di + 2] = 0;
+    dd[di + 3] = 0;
+}
+//# sourceMappingURL=surfaceAffine.js.map

package/dist/surfaceAffine.js.map

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

package/dist/surfaceAlpha.d.ts

@@ -0,0 +1,27 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Copies only the alpha channel from the `source` region into the `dest`
+ * region. RGB channels of `dest` are left unchanged. The copied size is the
+ * overlap of the two regions.
+ *
+ * Safe to pass the same surface and region in `dest` and `source` (no-op on
+ * alpha since each value is read and immediately written to the same location).
+ */
+export declare function copySurfaceAlpha(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+/**
+ * Scales every alpha value in the `out` region by `factor` (0–1). RGB channels
+ * are unchanged. A `factor` of 0 makes the region fully transparent; a `factor`
+ * of 1 leaves it unchanged; values in between fade it proportionally.
+ *
+ * `factor` is clamped to [0, 1].
+ */
+export declare function multiplySurfaceAlpha(out: Readonly<SurfaceRegion>, factor: number): void;
+/**
+ * Writes a constant `alpha` value (0–255) to every pixel in the `out` region.
+ * RGB channels are unchanged. Useful for making a region fully opaque or
+ * transparent in a single call.
+ *
+ * `alpha` is clamped to [0, 255].
+ */
+export declare function setSurfaceAlpha(out: Readonly<SurfaceRegion>, alpha: number): void;
+//# sourceMappingURL=surfaceAlpha.d.ts.map

package/dist/surfaceAlpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceAlpha.d.ts","sourceRoot":"","sources":["../src/surfaceAlpha.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAqBrG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAevF;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAcjF"}

package/dist/surfaceAlpha.js

@@ -0,0 +1,83 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Copies only the alpha channel from the `source` region into the `dest`
+ * region. RGB channels of `dest` are left unchanged. The copied size is the
+ * overlap of the two regions.
+ *
+ * Safe to pass the same surface and region in `dest` and `source` (no-op on
+ * alpha since each value is read and immediately written to the same location).
+ */
+export function copySurfaceAlpha(dest, source) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const sd = source.surface.data;
+    const dd = dest.surface.data;
+    for (let py = 0; py < h; py++) {
+        const sy = source.y + py;
+        const dy = dest.y + py;
+        if (sy < 0 || sy >= source.surface.height || dy < 0 || dy >= dest.surface.height)
+            continue;
+        for (let px = 0; px < w; px++) {
+            const sx = source.x + px;
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= source.surface.width || dx < 0 || dx >= dest.surface.width)
+                continue;
+            const si = (sy * source.surface.width + sx) * 4;
+            const di = (dy * dest.surface.width + dx) * 4;
+            // Read alpha before writing — safe for the aliased case.
+            const alpha = sd[si + 3];
+            dd[di + 3] = alpha;
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Scales every alpha value in the `out` region by `factor` (0–1). RGB channels
+ * are unchanged. A `factor` of 0 makes the region fully transparent; a `factor`
+ * of 1 leaves it unchanged; values in between fade it proportionally.
+ *
+ * `factor` is clamped to [0, 1].
+ */
+export function multiplySurfaceAlpha(out, factor) {
+    const f = Math.max(0, Math.min(1, factor));
+    const data = out.surface.data;
+    const surfaceWidth = out.surface.width;
+    for (let py = 0; py < out.height; py++) {
+        const y = out.y + py;
+        if (y < 0 || y >= out.surface.height)
+            continue;
+        for (let px = 0; px < out.width; px++) {
+            const x = out.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            const i = (y * surfaceWidth + x) * 4 + 3;
+            data[i] = Math.round(data[i] * f);
+        }
+    }
+    invalidateImageResource(out.surface);
+}
+/**
+ * Writes a constant `alpha` value (0–255) to every pixel in the `out` region.
+ * RGB channels are unchanged. Useful for making a region fully opaque or
+ * transparent in a single call.
+ *
+ * `alpha` is clamped to [0, 255].
+ */
+export function setSurfaceAlpha(out, alpha) {
+    const a = Math.max(0, Math.min(255, Math.round(alpha)));
+    const data = out.surface.data;
+    const surfaceWidth = out.surface.width;
+    for (let py = 0; py < out.height; py++) {
+        const y = out.y + py;
+        if (y < 0 || y >= out.surface.height)
+            continue;
+        for (let px = 0; px < out.width; px++) {
+            const x = out.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            data[(y * surfaceWidth + x) * 4 + 3] = a;
+        }
+    }
+    invalidateImageResource(out.surface);
+}
+//# sourceMappingURL=surfaceAlpha.js.map

package/dist/surfaceAlpha.js.map

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

package/dist/surfaceBevel.d.ts

@@ -0,0 +1,42 @@
+import type { SurfaceRegion } from '@flighthq/types';
+export type SurfaceBevelType = 'both' | 'inner' | 'outer';
+export interface SurfaceBevelOptions {
+    /** Light direction in radians, pointing toward the light source. Default π/4. */
+    angle?: number;
+    /** Sampling offset along the light axis, in pixels. Default 4. */
+    distance?: number;
+    radiusX?: number;
+    radiusY?: number;
+    passes?: number;
+    /** Packed 0xRRGGBBAA color of the lit edge. Default 0xffffffff. */
+    highlightColor?: number;
+    /** Packed 0xRRGGBBAA color of the shaded edge. Default 0x000000ff. */
+    shadowColor?: number;
+    /** Overall intensity multiplier. Default 1. */
+    intensity?: number;
+    /** Where the bevel is drawn relative to the shape. Default 'inner'. */
+    type?: SurfaceBevelType;
+}
+/**
+ * Produces a bevel mask in `out`: a tinted highlight on the edge facing the
+ * light and a shadow on the opposite edge, derived from the directional
+ * gradient of the source's blurred alpha.
+ *
+ * The edge gradient is `m(p - L) - m(p + L)` where `m` is the blurred alpha and
+ * `L = (cos(angle), sin(angle)) * distance`. A positive gradient (edge facing the
+ * light) draws the highlight color; a negative gradient draws the shadow color.
+ *
+ * `type` clips the result: 'inner' keeps it inside the shape, 'outer' outside,
+ * 'both' applies no clipping.
+ *
+ * To complete the effect, composite `out` over the original source.
+ *
+ * `scratch` must be at least `source.width * source.height * 4` bytes; it must
+ * be a distinct buffer from `out` (the blurred alpha is sampled while `out` is
+ * written). Its contents are undefined after the call.
+ *
+ * `out` must NOT alias `source.surface.data`: `out` is used as the blur scratch,
+ * and the source alpha is read again afterward for `inner`/`outer` clipping.
+ */
+export declare function bevelSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, options?: Readonly<SurfaceBevelOptions>): void;
+//# sourceMappingURL=surfaceBevel.d.ts.map

package/dist/surfaceBevel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceBevel.d.ts","sourceRoot":"","sources":["../src/surfaceBevel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,mBAAmB;IAClC,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,mBAAmB,CAAM,GAC1C,IAAI,CA+CN"}