@flighthq/surface 0.1.0

package/dist/surfaceFlip.js

@@ -0,0 +1,98 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Mirrors the `source` region left-to-right into the `dest` region. The mirror
+ * size is the overlap of the two regions. Safe to pass the same surface and
+ * region in `dest` and `source` for an in-place flip — when aliased, columns
+ * are swapped in pairs; otherwise `dest` and `source` must not overlap.
+ */
+export function flipSurfaceHorizontal(dest, source) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const data = dest.surface.data;
+    const stride = dest.surface.width;
+    if (isSameRegion(dest, source)) {
+        const half = w >> 1;
+        for (let py = 0; py < h; py++) {
+            const y = dest.y + py;
+            if (y < 0 || y >= dest.surface.height)
+                continue;
+            for (let px = 0; px < half; px++) {
+                const xa = dest.x + px;
+                const xb = dest.x + (w - 1 - px);
+                if (xa < 0 || xa >= stride || xb < 0 || xb >= stride)
+                    continue;
+                swapPixels(data, (y * stride + xa) * 4, (y * stride + xb) * 4);
+            }
+        }
+        return;
+    }
+    copyMirrored(dest, source, w, h, true, false);
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Mirrors the `source` region top-to-bottom into the `dest` region. The mirror
+ * size is the overlap of the two regions. Safe to pass the same surface and
+ * region in `dest` and `source` for an in-place flip — when aliased, rows are
+ * swapped in pairs; otherwise `dest` and `source` must not overlap.
+ */
+export function flipSurfaceVertical(dest, source) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    const data = dest.surface.data;
+    const stride = dest.surface.width;
+    if (isSameRegion(dest, source)) {
+        const half = h >> 1;
+        for (let py = 0; py < half; py++) {
+            const yTop = dest.y + py;
+            const yBottom = dest.y + (h - 1 - py);
+            if (yTop < 0 || yTop >= dest.surface.height || yBottom < 0 || yBottom >= dest.surface.height)
+                continue;
+            for (let px = 0; px < w; px++) {
+                const x = dest.x + px;
+                if (x < 0 || x >= stride)
+                    continue;
+                swapPixels(data, (yTop * stride + x) * 4, (yBottom * stride + x) * 4);
+            }
+        }
+        return;
+    }
+    copyMirrored(dest, source, w, h, false, true);
+    invalidateImageResource(dest.surface);
+}
+// Copies source -> dest with optional per-axis mirroring. Used for the
+// non-aliased flip path (distinct surfaces or non-overlapping regions).
+function copyMirrored(dest, source, w, h, mirrorX, mirrorY) {
+    const sd = source.surface.data;
+    const dd = dest.surface.data;
+    const sStride = source.surface.width;
+    const dStride = dest.surface.width;
+    for (let py = 0; py < h; py++) {
+        const sy = source.y + (mirrorY ? h - 1 - py : 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 + (mirrorX ? w - 1 - px : px);
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= sStride || dx < 0 || dx >= dStride)
+                continue;
+            const si = (sy * sStride + sx) * 4;
+            const di = (dy * dStride + dx) * 4;
+            dd[di] = sd[si];
+            dd[di + 1] = sd[si + 1];
+            dd[di + 2] = sd[si + 2];
+            dd[di + 3] = sd[si + 3];
+        }
+    }
+}
+function isSameRegion(a, b) {
+    return a.surface === b.surface && a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+}
+function swapPixels(data, a, b) {
+    for (let c = 0; c < 4; c++) {
+        const t = data[a + c];
+        data[a + c] = data[b + c];
+        data[b + c] = t;
+    }
+}
+//# sourceMappingURL=surfaceFlip.js.map

package/dist/surfaceFlip.js.map

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

package/dist/surfaceFormat.d.ts

@@ -0,0 +1,26 @@
+import type { PixelOrder } from '@flighthq/types';
+/**
+ * Converts a packed pixel buffer from one channel order to another.
+ * Safe to pass the same buffer as both `out` and `source` — all four
+ * channels are read into locals before any write.
+ */
+export declare function convertSurfacePixelOrder(out: Uint8ClampedArray, source: Readonly<Uint8ClampedArray>, length: number, from: PixelOrder, to: PixelOrder): void;
+/**
+ * Converts straight-alpha pixels to premultiplied alpha in place or into
+ * a separate buffer. RGB channels are multiplied by alpha/255.
+ * Safe to pass the same buffer as both `out` and `source`.
+ *
+ * Operates on a raw buffer, not a Surface — if the buffer belongs to an
+ * ImageResource, set its `alphaType` to `premultiplied` to keep it truthful.
+ */
+export declare function premultiplySurfacePixels(out: Uint8ClampedArray, source: Readonly<Uint8ClampedArray>, length: number): void;
+/**
+ * Converts premultiplied-alpha pixels back to straight alpha in place or
+ * into a separate buffer. Pixels with alpha=0 are written as (0,0,0,0).
+ * Safe to pass the same buffer as both `out` and `source`.
+ *
+ * Operates on a raw buffer, not a Surface — if the buffer belongs to an
+ * ImageResource, set its `alphaType` to `straight` to keep it truthful.
+ */
+export declare function unpremultiplySurfacePixels(out: Uint8ClampedArray, source: Readonly<Uint8ClampedArray>, length: number): void;
+//# sourceMappingURL=surfaceFormat.d.ts.map

package/dist/surfaceFormat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFormat.d.ts","sourceRoot":"","sources":["../src/surfaceFormat.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,EAAE,EAAE,UAAU,GACb,IAAI,CAiBN;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAQN;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,IAAI,CAgBN"}

package/dist/surfaceFormat.js

@@ -0,0 +1,80 @@
+/**
+ * Converts a packed pixel buffer from one channel order to another.
+ * Safe to pass the same buffer as both `out` and `source` — all four
+ * channels are read into locals before any write.
+ */
+export function convertSurfacePixelOrder(out, source, length, from, to) {
+    if (from === to) {
+        if (out !== source)
+            out.set(source.subarray(0, length));
+        return;
+    }
+    const [srcR, srcG, srcB, srcA] = channelOffsets(from);
+    const [dstR, dstG, dstB, dstA] = channelOffsets(to);
+    for (let i = 0; i < length; i += 4) {
+        const r = source[i + srcR];
+        const g = source[i + srcG];
+        const b = source[i + srcB];
+        const a = source[i + srcA];
+        out[i + dstR] = r;
+        out[i + dstG] = g;
+        out[i + dstB] = b;
+        out[i + dstA] = a;
+    }
+}
+/**
+ * Converts straight-alpha pixels to premultiplied alpha in place or into
+ * a separate buffer. RGB channels are multiplied by alpha/255.
+ * Safe to pass the same buffer as both `out` and `source`.
+ *
+ * Operates on a raw buffer, not a Surface — if the buffer belongs to an
+ * ImageResource, set its `alphaType` to `premultiplied` to keep it truthful.
+ */
+export function premultiplySurfacePixels(out, source, length) {
+    for (let i = 0; i < length; i += 4) {
+        const a = source[i + 3] / 255;
+        out[i] = Math.round(source[i] * a);
+        out[i + 1] = Math.round(source[i + 1] * a);
+        out[i + 2] = Math.round(source[i + 2] * a);
+        out[i + 3] = source[i + 3];
+    }
+}
+/**
+ * Converts premultiplied-alpha pixels back to straight alpha in place or
+ * into a separate buffer. Pixels with alpha=0 are written as (0,0,0,0).
+ * Safe to pass the same buffer as both `out` and `source`.
+ *
+ * Operates on a raw buffer, not a Surface — if the buffer belongs to an
+ * ImageResource, set its `alphaType` to `straight` to keep it truthful.
+ */
+export function unpremultiplySurfacePixels(out, source, length) {
+    for (let i = 0; i < length; i += 4) {
+        const a = source[i + 3];
+        if (a === 0) {
+            out[i] = 0;
+            out[i + 1] = 0;
+            out[i + 2] = 0;
+            out[i + 3] = 0;
+        }
+        else {
+            const inv = 255 / a;
+            out[i] = Math.min(255, Math.round(source[i] * inv));
+            out[i + 1] = Math.min(255, Math.round(source[i + 1] * inv));
+            out[i + 2] = Math.min(255, Math.round(source[i + 2] * inv));
+            out[i + 3] = a;
+        }
+    }
+}
+function channelOffsets(order) {
+    switch (order) {
+        case 'RGBA':
+            return [0, 1, 2, 3];
+        case 'BGRA':
+            return [2, 1, 0, 3];
+        case 'ARGB':
+            return [1, 2, 3, 0];
+        case 'ABGR':
+            return [3, 2, 1, 0];
+    }
+}
+//# sourceMappingURL=surfaceFormat.js.map

package/dist/surfaceFormat.js.map

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

package/dist/surfaceFrom.d.ts

@@ -0,0 +1,14 @@
+import type { ImageResource, Surface } from '@flighthq/types';
+export declare function createImageResourceFromSurface(surface: Readonly<Surface>): ImageResource;
+export declare function createSurfaceFromCanvas(canvas: HTMLCanvasElement, x?: number, y?: number, width?: number, height?: number): Surface;
+export declare function createSurfaceFromImageResource(resource: Readonly<ImageResource>): Surface;
+/**
+ * Reads a surface out of any `CanvasImageSource` by drawing it into a scratch 2D canvas. Unlike
+ * createSurfaceFromCanvas — 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).
+ */
+export declare function createSurfaceFromImageSource(source: CanvasImageSource, width: number, height: number): Surface;
+//# sourceMappingURL=surfaceFrom.d.ts.map

package/dist/surfaceFrom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceFrom.d.ts","sourceRoot":"","sources":["../src/surfaceFrom.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE9D,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,aAAa,CAQxF;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,EACzB,CAAC,GAAE,MAAU,EACb,CAAC,GAAE,MAAU,EACb,KAAK,CAAC,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAeT;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,OAAO,CAiCzF;AAED;;;;;;;GAOG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAiB9G"}

package/dist/surfaceFrom.js

@@ -0,0 +1,87 @@
+import { createEntity } from '@flighthq/entity';
+import { createImageResourceFromCanvas } from '@flighthq/image';
+export function createImageResourceFromSurface(surface) {
+    const canvas = document.createElement('canvas');
+    canvas.width = surface.width;
+    canvas.height = surface.height;
+    const domImageData = new globalThis.ImageData(surface.width, surface.height);
+    domImageData.data.set(surface.data);
+    canvas.getContext('2d').putImageData(domImageData, 0, 0);
+    return createImageResourceFromCanvas(canvas);
+}
+export function createSurfaceFromCanvas(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,
+        source: null,
+        version: 0,
+        width: raw.width,
+    });
+}
+export function createSurfaceFromImageResource(resource) {
+    const canvas = document.createElement('canvas');
+    canvas.width = resource.width;
+    canvas.height = resource.height;
+    if (resource.source === null) {
+        // Data-only resource: copy its existing pixels when present, otherwise allocate a transparent buffer.
+        return createEntity({
+            alphaType: resource.alphaType,
+            colorSpace: 'srgb',
+            data: resource.data !== null
+                ? new Uint8ClampedArray(resource.data)
+                : new Uint8ClampedArray(resource.width * resource.height * 4),
+            format: resource.format,
+            height: resource.height,
+            source: null,
+            version: 0,
+            width: resource.width,
+        });
+    }
+    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,
+        source: null,
+        version: 0,
+        width: resource.width,
+    });
+}
+/**
+ * Reads a surface out of any `CanvasImageSource` by drawing it into a scratch 2D canvas. Unlike
+ * createSurfaceFromCanvas — 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).
+ */
+export function createSurfaceFromImageSource(source, width, height) {
+    const canvas = document.createElement('canvas');
+    canvas.width = width;
+    canvas.height = height;
+    const ctx = canvas.getContext('2d');
+    ctx.drawImage(source, 0, 0);
+    const raw = ctx.getImageData(0, 0, width, height);
+    return createEntity({
+        alphaType: 'straight',
+        colorSpace: raw.colorSpace,
+        data: raw.data,
+        format: 'rgba8unorm',
+        height,
+        source: null,
+        version: 0,
+        width,
+    });
+}
+//# sourceMappingURL=surfaceFrom.js.map

package/dist/surfaceFrom.js.map

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

package/dist/surfaceGradient.d.ts

@@ -0,0 +1,57 @@
+import type { SurfaceRegion } from '@flighthq/types';
+import type { SurfaceBevelType } from './surfaceBevel';
+export interface SurfaceGradientBevelOptions {
+    /** 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;
+    /** Overall opacity multiplier. Default 1. */
+    intensity?: number;
+    /** Where the bevel is drawn relative to the shape. Default 'inner'. */
+    type?: SurfaceBevelType;
+}
+export interface SurfaceGradientGlowOptions {
+    radiusX?: number;
+    radiusY?: number;
+    passes?: number;
+    /** Overall opacity multiplier. Default 1. */
+    intensity?: number;
+}
+/**
+ * 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 buildSurfaceGradientRamp(out: Uint8ClampedArray, colors: ReadonlyArray<number>, alphas: ReadonlyArray<number>, ratios: ReadonlyArray<number>): void;
+/**
+ * Produces a gradient bevel mask in `out`. Like `bevelSurface`, 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
+ * `buildSurfaceGradientRamp`. `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.surface.data`: `out` is used as the blur scratch,
+ * and the source alpha is read again afterward for `inner`/`outer` clipping.
+ */
+export declare function gradientBevelSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, ramp: Readonly<Uint8ClampedArray>, options?: Readonly<SurfaceGradientBevelOptions>): void;
+/**
+ * Produces a gradient glow mask in `out`. Like `glowSurface`, 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
+ * `buildSurfaceGradientRamp`. `scratch` must be at least
+ * `source.width * source.height * 4` bytes; its contents are undefined after the
+ * call. Safe to pass `source.surface.data` as `out` for a full-surface region.
+ */
+export declare function gradientGlowSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, ramp: Readonly<Uint8ClampedArray>, options?: Readonly<SurfaceGradientGlowOptions>): void;
+//# sourceMappingURL=surfaceGradient.d.ts.map

package/dist/surfaceGradient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceGradient.d.ts","sourceRoot":"","sources":["../src/surfaceGradient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGvD,MAAM,WAAW,2BAA2B;IAC1C,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,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,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,oBAAoB,CAClC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,OAAO,GAAE,QAAQ,CAAC,2BAA2B,CAAM,GAClD,IAAI,CAyCN;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,IAAI,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACjC,OAAO,GAAE,QAAQ,CAAC,0BAA0B,CAAM,GACjD,IAAI,CA0BN"}

package/dist/surfaceGradient.js

@@ -0,0 +1,176 @@
+import { blurSurfacePixelsHorizontal, blurSurfacePixelsVertical } from './surfaceBlur';
+/**
+ * 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 buildSurfaceGradientRamp(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 `bevelSurface`, 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
+ * `buildSurfaceGradientRamp`. `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.surface.data`: `out` is used as the blur scratch,
+ * and the source alpha is read again afterward for `inner`/`outer` clipping.
+ */
+export function gradientBevelSurface(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 `glowSurface`, 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
+ * `buildSurfaceGradientRamp`. `scratch` must be at least
+ * `source.width * source.height * 4` bytes; its contents are undefined after the
+ * call. Safe to pass `source.surface.data` as `out` for a full-surface region.
+ */
+export function gradientGlowSurface(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) {
+            blurSurfacePixelsHorizontal(b, a, w, h, rx);
+            const t = a;
+            a = b;
+            b = t;
+        }
+        if (ry > 0) {
+            blurSurfacePixelsVertical(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.surface.width || sy < 0 || sy >= source.surface.height)
+        return 0;
+    return source.surface.data[(sy * source.surface.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=surfaceGradient.js.map

package/dist/surfaceGradient.js.map

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

package/dist/surfaceGradientFill.d.ts

@@ -0,0 +1,32 @@
+import type { GradientSpread, SurfaceRegion } from '@flighthq/types';
+/**
+ * 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 `buildSurfaceGradientRamp`.
+ *
+ * `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 surface bounds are skipped.
+ */
+export declare function fillSurfaceLinearGradient(dest: Readonly<SurfaceRegion>, 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
+ * `buildSurfaceGradientRamp`.
+ *
+ * `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 surface bounds are skipped.
+ */
+export declare function fillSurfaceRadialGradient(dest: Readonly<SurfaceRegion>, ramp: Readonly<Uint8ClampedArray>, cx: number, cy: number, radius: number, focalX?: number, focalY?: number, spread?: GradientSpread): void;
+//# sourceMappingURL=surfaceGradientFill.d.ts.map

package/dist/surfaceGradientFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceGradientFill.d.ts","sourceRoot":"","sources":["../src/surfaceGradientFill.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,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,yBAAyB,CACvC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,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"}