@flighthq/surface 0.1.0

package/dist/surfaceResize.d.ts

@@ -0,0 +1,27 @@
+import type { SurfaceEdgeMode, SurfaceRegion, SurfaceResizeMode } from '@flighthq/types';
+export interface SurfaceResizeOptions {
+    mode?: SurfaceResizeMode;
+    edgeMode?: SurfaceEdgeMode;
+    /**
+     * When true, pre-multiplies alpha before interpolation and unpremultiplies
+     * after. This prevents the dark-halo bleed that bilinear and bicubic sampling
+     * produce at semi-transparent edges when blending in straight-alpha space.
+     */
+    premultiplied?: boolean;
+}
+/**
+ * Resamples the `source` region into the `dest` region; `dest`'s dimensions
+ * define the target size. Modes:
+ *   - `'nearest'`: fast, preserves hard edges (pixel art)
+ *   - `'bilinear'` (default): smooth, interpolates four surrounding pixels
+ *   - `'bicubic'`: high quality, Catmull-Rom interpolation over 4×4 neighbourhood
+ *
+ * `edgeMode` controls how boundary interpolation handles out-of-bounds
+ * coordinates (default `'clamp'`).
+ *
+ * Set `premultiplied: true` to avoid dark-halo bleed at transparent edges.
+ *
+ * `dest` must not alias `source` — output pixels read arbitrary source positions.
+ */
+export declare function resizeSurface(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, options?: SurfaceResizeMode | Readonly<SurfaceResizeOptions>): void;
+//# sourceMappingURL=surfaceResize.d.ts.map

package/dist/surfaceResize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceResize.d.ts","sourceRoot":"","sources":["../src/surfaceResize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzF,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,iBAAiB,GAAG,QAAQ,CAAC,oBAAoB,CAAc,GACvE,IAAI,CA8IN"}

package/dist/surfaceResize.js

@@ -0,0 +1,191 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * Resamples the `source` region into the `dest` region; `dest`'s dimensions
+ * define the target size. Modes:
+ *   - `'nearest'`: fast, preserves hard edges (pixel art)
+ *   - `'bilinear'` (default): smooth, interpolates four surrounding pixels
+ *   - `'bicubic'`: high quality, Catmull-Rom interpolation over 4×4 neighbourhood
+ *
+ * `edgeMode` controls how boundary interpolation handles out-of-bounds
+ * coordinates (default `'clamp'`).
+ *
+ * Set `premultiplied: true` to avoid dark-halo bleed at transparent edges.
+ *
+ * `dest` must not alias `source` — output pixels read arbitrary source positions.
+ */
+export function resizeSurface(dest, source, options = 'bilinear') {
+    const opts = typeof options === 'string' ? { mode: options } : options;
+    const mode = opts.mode ?? 'bilinear';
+    const edgeMode = opts.edgeMode ?? 'clamp';
+    const premultiplied = opts.premultiplied ?? false;
+    const sw = source.width;
+    const sh = source.height;
+    const dw = dest.width;
+    const dh = dest.height;
+    if (sw === 0 || sh === 0 || dw === 0 || dh === 0)
+        return;
+    const sd = source.surface.data;
+    const dd = dest.surface.data;
+    const sStride = source.surface.width;
+    const dStride = dest.surface.width;
+    if (mode === 'nearest') {
+        for (let dy = 0; dy < dh; dy++) {
+            const oy = dest.y + dy;
+            if (oy < 0 || oy >= dest.surface.height)
+                continue;
+            const sy = source.y + Math.min(sh - 1, Math.floor((dy * sh) / dh));
+            if (sy < 0 || sy >= source.surface.height)
+                continue;
+            for (let dx = 0; dx < dw; dx++) {
+                const ox = dest.x + dx;
+                if (ox < 0 || ox >= dStride)
+                    continue;
+                const sx = source.x + Math.min(sw - 1, Math.floor((dx * sw) / dw));
+                if (sx < 0 || sx >= sStride)
+                    continue;
+                const si = (sy * sStride + sx) * 4;
+                const di = (oy * dStride + ox) * 4;
+                dd[di] = sd[si];
+                dd[di + 1] = sd[si + 1];
+                dd[di + 2] = sd[si + 2];
+                dd[di + 3] = sd[si + 3];
+            }
+        }
+        return;
+    }
+    const scaleX = sw / dw;
+    const scaleY = sh / dh;
+    if (mode === 'bicubic') {
+        for (let dy = 0; dy < dh; dy++) {
+            const oy = dest.y + dy;
+            if (oy < 0 || oy >= dest.surface.height)
+                continue;
+            const fy = (dy + 0.5) * scaleY - 0.5;
+            const y1 = Math.floor(fy);
+            const ty = fy - y1;
+            for (let dx = 0; dx < dw; dx++) {
+                const ox = dest.x + dx;
+                if (ox < 0 || ox >= dStride)
+                    continue;
+                const fx = (dx + 0.5) * scaleX - 0.5;
+                const x1 = Math.floor(fx);
+                const tx = fx - x1;
+                const di = (oy * dStride + ox) * 4;
+                for (let c = 0; c < 4; c++) {
+                    let sum = 0;
+                    for (let m = -1; m <= 2; m++) {
+                        const wy = catmullRomWeight(ty - m);
+                        const ry = resolveResizeEdge(y1 + m, sh, edgeMode);
+                        for (let n = -1; n <= 2; n++) {
+                            const wx = catmullRomWeight(tx - n);
+                            const rx = resolveResizeEdge(x1 + n, sw, edgeMode);
+                            if (rx === null || ry === null)
+                                continue;
+                            const sy = source.y + ry;
+                            const sx = source.x + rx;
+                            const si = (sy * sStride + sx) * 4;
+                            const v = premultiplied && c < 3 ? (sd[si + c] * sd[si + 3]) / 255 : sd[si + c];
+                            sum += v * wy * wx;
+                        }
+                    }
+                    dd[di + c] = Math.max(0, Math.min(255, Math.round(sum)));
+                }
+                if (premultiplied) {
+                    const a = dd[di + 3];
+                    if (a > 0) {
+                        dd[di] = Math.min(255, Math.round((dd[di] * 255) / a));
+                        dd[di + 1] = Math.min(255, Math.round((dd[di + 1] * 255) / a));
+                        dd[di + 2] = Math.min(255, Math.round((dd[di + 2] * 255) / a));
+                    }
+                    else {
+                        dd[di] = 0;
+                        dd[di + 1] = 0;
+                        dd[di + 2] = 0;
+                    }
+                }
+            }
+        }
+        return;
+    }
+    // bilinear
+    for (let dy = 0; dy < dh; dy++) {
+        const oy = dest.y + dy;
+        if (oy < 0 || oy >= dest.surface.height)
+            continue;
+        const fy = (dy + 0.5) * scaleY - 0.5;
+        const y0 = Math.floor(fy);
+        const ty = fy - y0;
+        const ry0 = resolveResizeEdge(y0, sh, edgeMode);
+        const ry1 = resolveResizeEdge(y0 + 1, sh, edgeMode);
+        for (let dx = 0; dx < dw; dx++) {
+            const ox = dest.x + dx;
+            if (ox < 0 || ox >= dStride)
+                continue;
+            const fx = (dx + 0.5) * scaleX - 0.5;
+            const x0 = Math.floor(fx);
+            const tx = fx - x0;
+            const rx0 = resolveResizeEdge(x0, sw, edgeMode);
+            const rx1 = resolveResizeEdge(x0 + 1, sw, edgeMode);
+            const di = (oy * dStride + ox) * 4;
+            const i00 = rx0 !== null && ry0 !== null ? ((source.y + ry0) * sStride + source.x + rx0) * 4 : -1;
+            const i10 = rx1 !== null && ry0 !== null ? ((source.y + ry0) * sStride + source.x + rx1) * 4 : -1;
+            const i01 = rx0 !== null && ry1 !== null ? ((source.y + ry1) * sStride + source.x + rx0) * 4 : -1;
+            const i11 = rx1 !== null && ry1 !== null ? ((source.y + ry1) * sStride + source.x + rx1) * 4 : -1;
+            for (let c = 0; c < 4; c++) {
+                let v00 = i00 >= 0 ? sd[i00 + c] : 0;
+                let v10 = i10 >= 0 ? sd[i10 + c] : 0;
+                let v01 = i01 >= 0 ? sd[i01 + c] : 0;
+                let v11 = i11 >= 0 ? sd[i11 + c] : 0;
+                if (premultiplied && c < 3) {
+                    v00 = i00 >= 0 ? (v00 * sd[i00 + 3]) / 255 : 0;
+                    v10 = i10 >= 0 ? (v10 * sd[i10 + 3]) / 255 : 0;
+                    v01 = i01 >= 0 ? (v01 * sd[i01 + 3]) / 255 : 0;
+                    v11 = i11 >= 0 ? (v11 * sd[i11 + 3]) / 255 : 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);
+            }
+            if (premultiplied) {
+                const a = dd[di + 3];
+                if (a > 0) {
+                    dd[di] = Math.min(255, Math.round((dd[di] * 255) / a));
+                    dd[di + 1] = Math.min(255, Math.round((dd[di + 1] * 255) / a));
+                    dd[di + 2] = Math.min(255, Math.round((dd[di + 2] * 255) / a));
+                }
+                else {
+                    dd[di] = 0;
+                    dd[di + 1] = 0;
+                    dd[di + 2] = 0;
+                }
+            }
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+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 resolveResizeEdge(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;
+    }
+}
+//# sourceMappingURL=surfaceResize.js.map

package/dist/surfaceResize.js.map

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

package/dist/surfaceRotate.d.ts

@@ -0,0 +1,32 @@
+import type { SurfaceEdgeMode, SurfaceRegion, SurfaceResizeMode } from '@flighthq/types';
+/**
+ * Rotates the `source` region by `angle` radians into the `dest` region, around
+ * a pivot point in source coordinates. `pivotX` and `pivotY` default to the
+ * source region centre. `edgeMode` controls out-of-bounds source positions
+ * (default `'clamp'`). `sampleMode` controls interpolation quality (default
+ * `'bilinear'`).
+ *
+ * `dest` must not alias `source`.
+ */
+export declare function rotateSurface(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>, angle: number, pivotX?: number, pivotY?: number, edgeMode?: SurfaceEdgeMode, sampleMode?: SurfaceResizeMode): void;
+/**
+ * Rotates the `source` region 180° into the `dest` region. `dest` and `source`
+ * must have the same dimensions. Safe to pass the same surface and region in
+ * `dest` and `source` for an in-place rotation — when aliased, opposite pixels
+ * are swapped in pairs; otherwise the regions must not overlap.
+ */
+export declare function rotateSurface180(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+/**
+ * Rotates the `source` region 90° clockwise into the `dest` region. `dest`'s
+ * dimensions must be swapped relative to `source` (`dest.width === source.height`,
+ * `dest.height === source.width`). `dest` must not alias `source`.
+ */
+export declare function rotateSurfaceClockwise(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+/**
+ * Rotates the `source` region 90° counter-clockwise into the `dest` region.
+ * `dest`'s dimensions must be swapped relative to `source`
+ * (`dest.width === source.height`, `dest.height === source.width`). `dest` must
+ * not alias `source`.
+ */
+export declare function rotateSurfaceCounterClockwise(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+//# sourceMappingURL=surfaceRotate.d.ts.map

package/dist/surfaceRotate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceRotate.d.ts","sourceRoot":"","sources":["../src/surfaceRotate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAIzF;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAA+B,EACvC,MAAM,GAAE,MAAgC,EACxC,QAAQ,GAAE,eAAyB,EACnC,UAAU,GAAE,iBAA8B,GACzC,IAAI,CAQN;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAkCrG;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAoB3G;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAoBlH"}

package/dist/surfaceRotate.js

@@ -0,0 +1,143 @@
+import { invalidateImageResource } from '@flighthq/image';
+import { transformSurface } from './surfaceAffine';
+/**
+ * Rotates the `source` region by `angle` radians into the `dest` region, around
+ * a pivot point in source coordinates. `pivotX` and `pivotY` default to the
+ * source region centre. `edgeMode` controls out-of-bounds source positions
+ * (default `'clamp'`). `sampleMode` controls interpolation quality (default
+ * `'bilinear'`).
+ *
+ * `dest` must not alias `source`.
+ */
+export function rotateSurface(dest, source, angle, pivotX = (source.width - 1) / 2, pivotY = (source.height - 1) / 2, edgeMode = 'clamp', sampleMode = 'bilinear') {
+    const cosA = Math.cos(-angle);
+    const sinA = Math.sin(-angle);
+    const destPivotX = (dest.width - 1) / 2;
+    const destPivotY = (dest.height - 1) / 2;
+    const e = pivotX - cosA * destPivotX + sinA * destPivotY;
+    const f = pivotY - sinA * destPivotX - cosA * destPivotY;
+    transformSurface(dest, source, [cosA, sinA, -sinA, cosA, e, f], edgeMode, sampleMode);
+}
+/**
+ * Rotates the `source` region 180° into the `dest` region. `dest` and `source`
+ * must have the same dimensions. Safe to pass the same surface and region in
+ * `dest` and `source` for an in-place rotation — when aliased, opposite pixels
+ * are swapped in pairs; otherwise the regions must not overlap.
+ */
+export function rotateSurface180(dest, source) {
+    const w = Math.min(dest.width, source.width);
+    const h = Math.min(dest.height, source.height);
+    if (isSameRegion(dest, source)) {
+        const data = dest.surface.data;
+        const stride = dest.surface.width;
+        const total = w * h;
+        const half = total >> 1;
+        for (let k = 0; k < half; k++) {
+            const ax = dest.x + (k % w);
+            const ay = dest.y + Math.floor(k / w);
+            const bx = dest.x + (w - 1 - (k % w));
+            const by = dest.y + (h - 1 - Math.floor(k / w));
+            if (!inBounds(ax, ay, stride, dest.surface.height) || !inBounds(bx, by, stride, dest.surface.height))
+                continue;
+            swapPixels(data, (ay * stride + ax) * 4, (by * stride + bx) * 4);
+        }
+        return;
+    }
+    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 + (h - 1 - py);
+        const dy = dest.y + py;
+        if (!inBounds(0, sy, sStride, source.surface.height) || !inBounds(0, dy, dStride, dest.surface.height))
+            continue;
+        for (let px = 0; px < w; px++) {
+            const sx = source.x + (w - 1 - px);
+            const dx = dest.x + px;
+            if (sx < 0 || sx >= sStride || dx < 0 || dx >= dStride)
+                continue;
+            copyPixel(dd, (dy * dStride + dx) * 4, sd, (sy * sStride + sx) * 4);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Rotates the `source` region 90° clockwise into the `dest` region. `dest`'s
+ * dimensions must be swapped relative to `source` (`dest.width === source.height`,
+ * `dest.height === source.width`). `dest` must not alias `source`.
+ */
+export function rotateSurfaceClockwise(dest, source) {
+    const sw = source.width;
+    const sh = source.height;
+    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 < sh; py++) {
+        const sy = source.y + py;
+        if (sy < 0 || sy >= source.surface.height)
+            continue;
+        for (let px = 0; px < sw; px++) {
+            const sx = source.x + px;
+            if (sx < 0 || sx >= sStride)
+                continue;
+            const dx = dest.x + (sh - 1 - py);
+            const dy = dest.y + px;
+            if (dx < 0 || dx >= dStride || dy < 0 || dy >= dest.surface.height)
+                continue;
+            copyPixel(dd, (dy * dStride + dx) * 4, sd, (sy * sStride + sx) * 4);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Rotates the `source` region 90° counter-clockwise into the `dest` region.
+ * `dest`'s dimensions must be swapped relative to `source`
+ * (`dest.width === source.height`, `dest.height === source.width`). `dest` must
+ * not alias `source`.
+ */
+export function rotateSurfaceCounterClockwise(dest, source) {
+    const sw = source.width;
+    const sh = source.height;
+    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 < sh; py++) {
+        const sy = source.y + py;
+        if (sy < 0 || sy >= source.surface.height)
+            continue;
+        for (let px = 0; px < sw; px++) {
+            const sx = source.x + px;
+            if (sx < 0 || sx >= sStride)
+                continue;
+            const dx = dest.x + py;
+            const dy = dest.y + (sw - 1 - px);
+            if (dx < 0 || dx >= dStride || dy < 0 || dy >= dest.surface.height)
+                continue;
+            copyPixel(dd, (dy * dStride + dx) * 4, sd, (sy * sStride + sx) * 4);
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+function copyPixel(dest, di, source, si) {
+    dest[di] = source[si];
+    dest[di + 1] = source[si + 1];
+    dest[di + 2] = source[si + 2];
+    dest[di + 3] = source[si + 3];
+}
+function inBounds(x, y, width, height) {
+    return x >= 0 && x < width && y >= 0 && y < height;
+}
+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=surfaceRotate.js.map

package/dist/surfaceRotate.js.map

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

package/dist/surfaceShadow.d.ts

@@ -0,0 +1,107 @@
+import type { SurfaceRegion } from '@flighthq/types';
+export interface SurfaceShadowBlurOptions {
+    radiusX?: number;
+    radiusY?: number;
+    passes?: number;
+}
+export interface SurfaceDropShadowOptions extends SurfaceShadowBlurOptions {
+    /** Packed 0xRRGGBBAA shadow color. Default 0x000000ff (opaque black). */
+    color?: number;
+    /** Overall intensity multiplier applied to the shadow alpha. Default 1. */
+    intensity?: number;
+}
+export interface SurfaceGlowOptions extends SurfaceShadowBlurOptions {
+    /** Packed 0xRRGGBBAA glow color. Default 0xff0000ff (opaque red). */
+    color?: number;
+    /** Overall intensity multiplier applied to the glow alpha. Default 1. */
+    intensity?: number;
+}
+export interface SurfaceInnerGlowOptions extends SurfaceShadowBlurOptions {
+    /** Packed 0xRRGGBBAA inner glow color. Default 0xff0000ff (opaque red). */
+    color?: number;
+    /** Overall intensity multiplier applied to the glow alpha. Default 1. */
+    intensity?: number;
+}
+export interface SurfaceInnerShadowOptions extends SurfaceShadowBlurOptions {
+    /** Packed 0xRRGGBBAA inner shadow color. Default 0x000000ff (opaque black). */
+    color?: number;
+    /** Overall intensity multiplier applied to the shadow alpha. Default 1. */
+    intensity?: number;
+    /**
+     * Pixel offset of the shadow inside the shape, from the filter's angle+distance (dx = cos(angle) *
+     * distance, dy = sin(angle) * distance; see getShadowFilterOffset). The inverted-alpha field is
+     * sampled shifted by (offsetX, offsetY) before the blur, so the shadow lands off-center against the
+     * boundary — the Photoshop/OpenFL inner-shadow construction. Default 0 (shadow centered on the edge).
+     */
+    offsetX?: number;
+    offsetY?: number;
+}
+/**
+ * Produces the blurred shadow mask for a drop shadow effect, writing into
+ * `out`. The result is a tinted, blurred alpha mask derived from `source`.
+ *
+ * To complete the effect, composite `out` onto the destination at the shadow
+ * offset, then optionally composite the original source on top:
+ *
+ *   compositeSurfacePixels(destRegion, out);   // shadow at (dx+offsetX, dy+offsetY)
+ *   compositeSurfaceRegion(destRegion, source); // omit if hideObject
+ *
+ * `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` when the region covers the
+ * full surface.
+ */
+export declare function dropShadowSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, options?: Readonly<SurfaceDropShadowOptions>): void;
+/**
+ * Produces the blurred glow mask for a glow effect, writing into `out`.
+ * The result is a tinted, blurred alpha mask derived from `source`.
+ *
+ * To complete the effect, composite `out` onto the destination, then
+ * optionally composite the original source on top:
+ *
+ *   compositeSurfacePixels(destRegion, out);   // glow
+ *   compositeSurfaceRegion(destRegion, source); // omit if knockout
+ *
+ * `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` when the region covers the
+ * full surface.
+ */
+export declare function glowSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, options?: Readonly<SurfaceGlowOptions>): void;
+/**
+ * Produces the inner glow mask for a glow that hugs the inside of the source's
+ * alpha boundary, writing into `out`. The inverted source alpha is blurred so
+ * that the "outside" bleeds inward, then clipped by the original source alpha so
+ * the effect stays within the shape, then tinted.
+ *
+ * To complete the effect, composite `out` over the original source:
+ *
+ *   compositeSurfaceRegion(destRegion, source);
+ *   compositeSurfacePixels(destRegion, out);   // glow on top, inside the shape
+ *
+ * `scratch` must be at least `source.width * source.height * 4` bytes; its
+ * contents are undefined after the call.
+ *
+ * `out` must NOT alias `source.surface.data`: the original source alpha is read
+ * again after blurring, so overwriting the source destroys the clip mask.
+ */
+export declare function innerGlowSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, options?: Readonly<SurfaceInnerGlowOptions>): void;
+/**
+ * Produces the inner shadow mask for a shadow that hugs the inside of the
+ * source's alpha boundary, writing into `out`. Like `innerGlowSurface` but with
+ * an opaque-black default color and a directional `offsetX`/`offsetY`: the
+ * inverted-alpha field is sampled shifted by the offset before blurring, so the
+ * shadow gathers toward one edge instead of ringing the boundary evenly.
+ *
+ * To complete the effect, composite `out` over the original source.
+ *
+ * `scratch` must be at least `source.width * source.height * 4` bytes; its
+ * contents are undefined after the call.
+ *
+ * `out` must NOT alias `source.surface.data` — the original source alpha is read
+ * again after blurring to clip the result.
+ */
+export declare function innerShadowSurface(out: Uint8ClampedArray, scratch: Uint8ClampedArray, source: Readonly<SurfaceRegion>, options?: Readonly<SurfaceInnerShadowOptions>): void;
+//# sourceMappingURL=surfaceShadow.d.ts.map

package/dist/surfaceShadow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceShadow.d.ts","sourceRoot":"","sources":["../src/surfaceShadow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIrD,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAyB,SAAQ,wBAAwB;IACxE,yEAAyE;IACzE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAmB,SAAQ,wBAAwB;IAClE,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAwB,SAAQ,wBAAwB;IACvE,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAA0B,SAAQ,wBAAwB;IACzE,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,wBAAwB,CAAM,GAC/C,IAAI,CAGN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,kBAAkB,CAAM,GACzC,IAAI,CAGN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,uBAAuB,CAAM,GAC9C,IAAI,CAGN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,iBAAiB,EACtB,OAAO,EAAE,iBAAiB,EAC1B,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC/B,OAAO,GAAE,QAAQ,CAAC,yBAAyB,CAAM,GAChD,IAAI,CAUN"}