@flighthq/surface 0.1.0

package/dist/surfaceGradientFill.js

@@ -0,0 +1,120 @@
+import { invalidateImageResource } from '@flighthq/image';
+/**
+ * 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 function fillSurfaceLinearGradient(dest, ramp, x0, y0, x1, y1, spread = 'pad') {
+    const dw = dest.width;
+    const dh = dest.height;
+    const data = dest.surface.data;
+    const surfaceWidth = dest.surface.width;
+    const surfaceHeight = dest.surface.height;
+    const axisX = x1 - x0;
+    const axisY = y1 - y0;
+    const lenSq = axisX * axisX + axisY * axisY;
+    const invLen = lenSq > 0 ? 1 / lenSq : 0;
+    for (let py = 0; py < dh; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= surfaceHeight)
+            continue;
+        for (let px = 0; px < dw; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            // Project pixel onto gradient axis → t in [0, 1] maps x0→x1.
+            const t = ((px - x0) * axisX + (py - y0) * axisY) * invLen;
+            const idx = spreadIndex(t, spread);
+            const ri = idx * 4;
+            const i = (y * surfaceWidth + x) * 4;
+            data[i] = ramp[ri];
+            data[i + 1] = ramp[ri + 1];
+            data[i + 2] = ramp[ri + 2];
+            data[i + 3] = ramp[ri + 3];
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * 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 function fillSurfaceRadialGradient(dest, ramp, cx, cy, radius, focalX = cx, focalY = cy, spread = 'pad') {
+    const dw = dest.width;
+    const dh = dest.height;
+    const data = dest.surface.data;
+    const surfaceWidth = dest.surface.width;
+    const surfaceHeight = dest.surface.height;
+    const invRadius = radius > 0 ? 1 / radius : 0;
+    // Focal-point offset from center.
+    const fdx = focalX - cx;
+    const fdy = focalY - cy;
+    for (let py = 0; py < dh; py++) {
+        const y = dest.y + py;
+        if (y < 0 || y >= surfaceHeight)
+            continue;
+        for (let px = 0; px < dw; px++) {
+            const x = dest.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            // Distance from focal point, normalized by radius → t in [0, 1].
+            const dx = px - focalX;
+            const dy = py - focalY;
+            // Use the cone-ray formula for two-point focal gradient (standard SVG model).
+            // When focal === center this simplifies to Euclidean distance / radius.
+            const t = Math.sqrt(dx * dx + dy * dy) * invRadius - (dx * fdx + dy * fdy) * invRadius * invRadius;
+            const idx = spreadIndex(t, spread);
+            const ri = idx * 4;
+            const i = (y * surfaceWidth + x) * 4;
+            data[i] = ramp[ri];
+            data[i + 1] = ramp[ri + 1];
+            data[i + 2] = ramp[ri + 2];
+            data[i + 3] = ramp[ri + 3];
+        }
+    }
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Converts a normalized gradient parameter `t` (range [0, 1]) into a ramp
+ * index (0–255), applying the requested `spread` mode for values outside [0, 1].
+ */
+function spreadIndex(t, spread) {
+    let s;
+    switch (spread) {
+        case 'repeat': {
+            s = t - Math.floor(t);
+            break;
+        }
+        case 'reflect': {
+            const wrapped = t - Math.floor(t / 2) * 2;
+            s = wrapped <= 1 ? wrapped : 2 - wrapped;
+            break;
+        }
+        default: {
+            // 'pad'
+            s = Math.max(0, Math.min(1, t));
+            break;
+        }
+    }
+    return Math.min(255, Math.round(s * 255));
+}
+//# sourceMappingURL=surfaceGradientFill.js.map

package/dist/surfaceGradientFill.js.map

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

package/dist/surfaceHistogram.d.ts

@@ -0,0 +1,20 @@
+import type { SurfaceHistogram, SurfaceRegion } from '@flighthq/types';
+/**
+ * Applies histogram equalization to `source`, writing into `dest`. Each RGB
+ * channel is equalized independently using its cumulative distribution function,
+ * spreading the tonal range across the full 0..255 output. The alpha channel is
+ * copied unchanged.
+ *
+ * Safe to pass the same surface and region in `dest` and `source` for in-place
+ * equalization (the palette map reads each pixel before writing it).
+ */
+export declare function equalizeSurfaceHistogram(dest: Readonly<SurfaceRegion>, source: Readonly<SurfaceRegion>): void;
+/**
+ * Counts how many pixels in the `source` region fall into each 0..255 value,
+ * per channel, and returns four 256-entry arrays. Region pixels outside the
+ * surface are skipped; an empty region yields all-zero bins.
+ *
+ * Allocates the result arrays; this is an analysis query, not a hot-path pass.
+ */
+export declare function getSurfaceHistogram(source: Readonly<SurfaceRegion>): SurfaceHistogram;
+//# sourceMappingURL=surfaceHistogram.d.ts.map

package/dist/surfaceHistogram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceHistogram.d.ts","sourceRoot":"","sources":["../src/surfaceHistogram.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAIvE;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAa7G;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,gBAAgB,CAqBrF"}

package/dist/surfaceHistogram.js

@@ -0,0 +1,61 @@
+import { invalidateImageResource } from '@flighthq/image';
+import { applySurfacePaletteMap } from './surfacePaletteMap';
+/**
+ * Applies histogram equalization to `source`, writing into `dest`. Each RGB
+ * channel is equalized independently using its cumulative distribution function,
+ * spreading the tonal range across the full 0..255 output. The alpha channel is
+ * copied unchanged.
+ *
+ * Safe to pass the same surface and region in `dest` and `source` for in-place
+ * equalization (the palette map reads each pixel before writing it).
+ */
+export function equalizeSurfaceHistogram(dest, source) {
+    const histogram = getSurfaceHistogram(source);
+    const total = source.width * source.height;
+    applySurfacePaletteMap(dest, source, buildEqualizeMap(histogram.red, total), buildEqualizeMap(histogram.green, total), buildEqualizeMap(histogram.blue, total), null);
+    invalidateImageResource(dest.surface);
+}
+/**
+ * Counts how many pixels in the `source` region fall into each 0..255 value,
+ * per channel, and returns four 256-entry arrays. Region pixels outside the
+ * surface are skipped; an empty region yields all-zero bins.
+ *
+ * Allocates the result arrays; this is an analysis query, not a hot-path pass.
+ */
+export function getSurfaceHistogram(source) {
+    const red = new Array(256).fill(0);
+    const green = new Array(256).fill(0);
+    const blue = new Array(256).fill(0);
+    const alpha = new Array(256).fill(0);
+    const data = source.surface.data;
+    const surfaceWidth = source.surface.width;
+    for (let py = 0; py < source.height; py++) {
+        const y = source.y + py;
+        if (y < 0 || y >= source.surface.height)
+            continue;
+        for (let px = 0; px < source.width; px++) {
+            const x = source.x + px;
+            if (x < 0 || x >= surfaceWidth)
+                continue;
+            const i = (y * surfaceWidth + x) * 4;
+            red[data[i]]++;
+            green[data[i + 1]]++;
+            blue[data[i + 2]]++;
+            alpha[data[i + 3]]++;
+        }
+    }
+    return { alpha, blue, green, red };
+}
+function buildEqualizeMap(bins, total) {
+    const map = new Array(256);
+    let cdf = 0;
+    let cdfMin = -1;
+    for (let i = 0; i < 256; i++) {
+        cdf += bins[i];
+        if (bins[i] > 0 && cdfMin === -1)
+            cdfMin = cdf;
+        map[i] = total === cdfMin ? i : Math.round(((cdf - cdfMin) / (total - cdfMin)) * 255);
+    }
+    return map;
+}
+//# sourceMappingURL=surfaceHistogram.js.map

package/dist/surfaceHistogram.js.map

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

package/dist/surfaceImageChannel.d.ts

@@ -0,0 +1,2 @@
+export { ImageChannel } from '@flighthq/types';
+//# sourceMappingURL=surfaceImageChannel.d.ts.map

package/dist/surfaceImageChannel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceImageChannel.d.ts","sourceRoot":"","sources":["../src/surfaceImageChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/surfaceImageChannel.js

@@ -0,0 +1,2 @@
+export { ImageChannel } from '@flighthq/types';
+//# sourceMappingURL=surfaceImageChannel.js.map

package/dist/surfaceImageChannel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceImageChannel.js","sourceRoot":"","sources":["../src/surfaceImageChannel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/surfaceMedian.d.ts

@@ -0,0 +1,14 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Applies a median filter to `source`, writing into `out`. Each output channel
+ * is the median of that channel over the `(2 * radius + 1)²` neighborhood,
+ * clamped at the surface edges. Median filtering removes salt-and-pepper noise
+ * and despeckles while preserving edges — something a linear convolution blur
+ * cannot do.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — each output pixel reads a neighborhood of
+ * source pixels.
+ */
+export declare function medianSurface(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>, radius: number): void;
+//# sourceMappingURL=surfaceMedian.d.ts.map

package/dist/surfaceMedian.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceMedian.d.ts","sourceRoot":"","sources":["../src/surfaceMedian.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA4C3G"}

package/dist/surfaceMedian.js

@@ -0,0 +1,77 @@
+/**
+ * Applies a median filter to `source`, writing into `out`. Each output channel
+ * is the median of that channel over the `(2 * radius + 1)²` neighborhood,
+ * clamped at the surface edges. Median filtering removes salt-and-pepper noise
+ * and despeckles while preserving edges — something a linear convolution blur
+ * cannot do.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — each output pixel reads a neighborhood of
+ * source pixels.
+ */
+export function medianSurface(out, source, radius) {
+    const r = Math.max(0, Math.round(radius));
+    const w = source.width;
+    const h = source.height;
+    const surfaceWidth = source.surface.width;
+    const surfaceHeight = source.surface.height;
+    const data = source.surface.data;
+    const area = (2 * r + 1) * (2 * r + 1);
+    // Window scratch is reused across calls and grown as needed — a median pass
+    // is allocation-free after its first use at a given radius.
+    if (_windowRed === null || _windowRed.length < area) {
+        _windowRed = new Uint8Array(area);
+        _windowGreen = new Uint8Array(area);
+        _windowBlue = new Uint8Array(area);
+        _windowAlpha = new Uint8Array(area);
+    }
+    const rs = _windowRed;
+    const gs = _windowGreen;
+    const bs = _windowBlue;
+    const as = _windowAlpha;
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            let n = 0;
+            for (let ky = -r; ky <= r; ky++) {
+                const sy = Math.max(0, Math.min(surfaceHeight - 1, source.y + py + ky));
+                for (let kx = -r; kx <= r; kx++) {
+                    const sx = Math.max(0, Math.min(surfaceWidth - 1, source.x + px + kx));
+                    const si = (sy * surfaceWidth + sx) * 4;
+                    rs[n] = data[si];
+                    gs[n] = data[si + 1];
+                    bs[n] = data[si + 2];
+                    as[n] = data[si + 3];
+                    n++;
+                }
+            }
+            const mid = n >> 1;
+            const di = (py * w + px) * 4;
+            out[di] = medianOf(rs, n, mid);
+            out[di + 1] = medianOf(gs, n, mid);
+            out[di + 2] = medianOf(bs, n, mid);
+            out[di + 3] = medianOf(as, n, mid);
+        }
+    }
+}
+// Insertion sort of the first `n` entries, then return the element at `mid`.
+// `n` is small (an odd square), so insertion sort beats Array.sort's overhead
+// and avoids per-pixel allocation.
+function medianOf(values, n, mid) {
+    for (let i = 1; i < n; i++) {
+        const v = values[i];
+        let j = i - 1;
+        while (j >= 0 && values[j] > v) {
+            values[j + 1] = values[j];
+            j--;
+        }
+        values[j + 1] = v;
+    }
+    return values[mid];
+}
+// Per-window channel scratch, reused across calls and grown to the largest
+// neighborhood seen so far.
+let _windowRed = null;
+let _windowGreen = null;
+let _windowBlue = null;
+let _windowAlpha = null;
+//# sourceMappingURL=surfaceMedian.js.map

package/dist/surfaceMedian.js.map

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

package/dist/surfaceMorphological.d.ts

@@ -0,0 +1,29 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Applies morphological dilation to `source`, writing into `out`. Each output
+ * channel is the maximum of that channel over the `(2 * radius + 1)²`
+ * neighbourhood; all four channels (RGBA) are dilated independently.
+ *
+ * Dilation expands bright regions and thickens shapes. It is the dual of
+ * `erodeSurface` — applying erosion then dilation gives a morphological opening,
+ * the reverse gives a closing.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — each output pixel reads a neighbourhood of
+ * source pixels.
+ */
+export declare function dilateSurface(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>, radius: number): void;
+/**
+ * Applies morphological erosion to `source`, writing into `out`. Each output
+ * channel is the minimum of that channel over the `(2 * radius + 1)²`
+ * neighbourhood; all four channels (RGBA) are eroded independently.
+ *
+ * Erosion shrinks bright regions and thins shapes. It is the dual of
+ * `dilateSurface`.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — each output pixel reads a neighbourhood of
+ * source pixels.
+ */
+export declare function erodeSurface(out: Uint8ClampedArray, source: Readonly<SurfaceRegion>, radius: number): void;
+//# sourceMappingURL=surfaceMorphological.d.ts.map

package/dist/surfaceMorphological.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceMorphological.d.ts","sourceRoot":"","sources":["../src/surfaceMorphological.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE3G;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1G"}

package/dist/surfaceMorphological.js

@@ -0,0 +1,81 @@
+/**
+ * Applies morphological dilation to `source`, writing into `out`. Each output
+ * channel is the maximum of that channel over the `(2 * radius + 1)²`
+ * neighbourhood; all four channels (RGBA) are dilated independently.
+ *
+ * Dilation expands bright regions and thickens shapes. It is the dual of
+ * `erodeSurface` — applying erosion then dilation gives a morphological opening,
+ * the reverse gives a closing.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — each output pixel reads a neighbourhood of
+ * source pixels.
+ */
+export function dilateSurface(out, source, radius) {
+    applyMorphological(out, source, radius, true);
+}
+/**
+ * Applies morphological erosion to `source`, writing into `out`. Each output
+ * channel is the minimum of that channel over the `(2 * radius + 1)²`
+ * neighbourhood; all four channels (RGBA) are eroded independently.
+ *
+ * Erosion shrinks bright regions and thins shapes. It is the dual of
+ * `dilateSurface`.
+ *
+ * `out` must be at least `source.width * source.height * 4` bytes and must NOT
+ * alias `source.surface.data` — each output pixel reads a neighbourhood of
+ * source pixels.
+ */
+export function erodeSurface(out, source, radius) {
+    applyMorphological(out, source, radius, false);
+}
+function applyMorphological(out, source, radius, dilate) {
+    const r = Math.max(0, Math.round(radius));
+    const w = source.width;
+    const h = source.height;
+    const surfaceWidth = source.surface.width;
+    const surfaceHeight = source.surface.height;
+    const data = source.surface.data;
+    const identity = dilate ? 0 : 255;
+    for (let py = 0; py < h; py++) {
+        for (let px = 0; px < w; px++) {
+            let vR = identity;
+            let vG = identity;
+            let vB = identity;
+            let vA = identity;
+            for (let ky = -r; ky <= r; ky++) {
+                const sy = Math.max(0, Math.min(surfaceHeight - 1, source.y + py + ky));
+                for (let kx = -r; kx <= r; kx++) {
+                    const sx = Math.max(0, Math.min(surfaceWidth - 1, source.x + px + kx));
+                    const si = (sy * surfaceWidth + sx) * 4;
+                    if (dilate) {
+                        if (data[si] > vR)
+                            vR = data[si];
+                        if (data[si + 1] > vG)
+                            vG = data[si + 1];
+                        if (data[si + 2] > vB)
+                            vB = data[si + 2];
+                        if (data[si + 3] > vA)
+                            vA = data[si + 3];
+                    }
+                    else {
+                        if (data[si] < vR)
+                            vR = data[si];
+                        if (data[si + 1] < vG)
+                            vG = data[si + 1];
+                        if (data[si + 2] < vB)
+                            vB = data[si + 2];
+                        if (data[si + 3] < vA)
+                            vA = data[si + 3];
+                    }
+                }
+            }
+            const di = (py * w + px) * 4;
+            out[di] = vR;
+            out[di + 1] = vG;
+            out[di + 2] = vB;
+            out[di + 3] = vA;
+        }
+    }
+}
+//# sourceMappingURL=surfaceMorphological.js.map

package/dist/surfaceMorphological.js.map

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

package/dist/surfaceNoise.d.ts

@@ -0,0 +1,48 @@
+import type { SurfaceRegion } from '@flighthq/types';
+/**
+ * Fills the `dest` region with uniform random noise in `[low, high]`, derived
+ * deterministically from `seed` (the same seed always produces the same image,
+ * which a `Math.random()` fill could not guarantee — important for reproducible
+ * tests and a future C port). Region pixels outside the surface are skipped.
+ *
+ * When `grayScale` is true, R, G, and B share one value per pixel; otherwise
+ * each channel is independent. Alpha is set fully opaque (255).
+ */
+export declare function fillSurfaceNoise(dest: Readonly<SurfaceRegion>, seed: number, low?: number, high?: number, grayScale?: boolean): void;
+/**
+ * Fills `out` with fractal value noise summed over `octaves`. `baseX` and
+ * `baseY` are the wavelengths (in pixels) of the first octave: larger values
+ * produce smoother, lower-frequency noise. Each successive octave doubles the
+ * frequency and halves the amplitude. Output is normalized to 0..255.
+ *
+ * - `baseX`, `baseY`: wavelengths in pixels of the first octave (larger = smoother).
+ * - `octaves`: number of frequency doublings (1 = smooth; higher = more detail).
+ * - `seed`: deterministic integer seed.
+ * - `stitch`: when `true`, the noise field tiles seamlessly at the region borders.
+ * - `grayScale`: when `true`, R=G=B share one noise channel. Overrides
+ *   `channelOptions` for the RGB channels.
+ * - `channelOptions`: bitmask of channels to fill (default `0x7` = RGB, matching
+ *   OpenFL's `perlinNoise` default). Channels not selected are left unchanged in
+ *   `dest`, except alpha: when the A bit is not selected, alpha is set opaque
+ *   (255) rather than left as-is. Use `SURFACE_NOISE_CHANNEL_*` constants. When
+ *   `grayScale` is true the same field drives all selected RGB channels.
+ *
+ * Output range is normalized to 0..255. Alpha defaults to 255 unless the A
+ * bit is explicitly included in `channelOptions`.
+ */
+export declare function fillSurfacePerlinNoise(dest: Readonly<SurfaceRegion>, baseX: number, baseY: number, octaves: number, seed: number, grayScale?: boolean, stitch?: boolean, channelOptions?: number): void;
+/**
+ * Fills `dest` with fractal **turbulence** (absolute-value fBm) value noise,
+ * matching OpenFL's `BitmapData.perlinNoise` with `fractalNoise: false`.
+ * Turbulence sums `abs(octave)` values, producing a more vigorous, ridge-like
+ * texture than the smooth fractal sum.
+ *
+ * Parameters are identical to `fillSurfacePerlinNoise` except there is no
+ * `fractalNoise` flag (this function _is_ the turbulence variant).
+ */
+export declare function fillSurfaceTurbulence(dest: Readonly<SurfaceRegion>, baseX: number, baseY: number, octaves: number, seed: number, grayScale?: boolean, stitch?: boolean, channelOptions?: number): void;
+export declare const SURFACE_NOISE_CHANNEL_A = 8;
+export declare const SURFACE_NOISE_CHANNEL_B = 4;
+export declare const SURFACE_NOISE_CHANNEL_G = 2;
+export declare const SURFACE_NOISE_CHANNEL_R = 1;
+//# sourceMappingURL=surfaceNoise.d.ts.map

package/dist/surfaceNoise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfaceNoise.d.ts","sourceRoot":"","sources":["../src/surfaceNoise.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAU,EACf,IAAI,GAAE,MAAY,EAClB,SAAS,GAAE,OAAe,GACzB,IAAI,CA+BN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAe,EAC1B,MAAM,GAAE,OAAe,EACvB,cAAc,GAAE,MAAY,GAC3B,IAAI,CA4CN;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,QAAQ,CAAC,aAAa,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,OAAe,EAC1B,MAAM,GAAE,OAAe,EACvB,cAAc,GAAE,MAAY,GAC3B,IAAI,CA6CN;AAED,eAAO,MAAM,uBAAuB,IAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,IAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,IAAM,CAAC;AAC3C,eAAO,MAAM,uBAAuB,IAAM,CAAC"}