@triforge/modifier-core 0.1.0

package/dist/modifiers/generate/BooleanModifier.d.ts

@@ -0,0 +1,37 @@
+import { BufferGeometry } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+export type BooleanOperation = 'union' | 'difference' | 'intersection';
+export interface BooleanModifierOptions {
+    operand: BufferGeometry;
+    operation?: BooleanOperation;
+    operandMatrix?: number[];
+}
+/**
+ * BooleanModifier — Blender "Boolean" modifier equivalent.
+ *
+ * three-bvh-csg is loaded lazily (dynamic import) when a BooleanModifier is first
+ * instantiated. This means @st-modifier-core can be imported without three-bvh-csg
+ * in the importmap — the dependency is only required when you actually use this modifier.
+ *
+ * Await `modifier.ready()` before calling `stack.apply()` to ensure the library is loaded.
+ *
+ * ```typescript
+ * const mod = new BooleanModifier({ operand: sphere, operation: 'difference' })
+ * await mod.ready()
+ * mesh.geometry = stack.apply()
+ * ```
+ */
+export declare class BooleanModifier extends BaseModifier {
+    get name(): string;
+    parameters: Record<string, number>;
+    private readonly _operand;
+    private readonly _operandMatrix;
+    private _evaluator;
+    private _csg;
+    private readonly _ready;
+    constructor(opts: BooleanModifierOptions);
+    /** Resolves when three-bvh-csg has loaded. Await before calling stack.apply(). */
+    ready(): Promise<void>;
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=BooleanModifier.d.ts.map

package/dist/modifiers/generate/BooleanModifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BooleanModifier.d.ts","sourceRoot":"","sources":["../../../src/modifiers/generate/BooleanModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,OAAO,CAAA;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,YAAY,GAAG,cAAc,CAAA;AAEtE,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,cAAc,CAAA;IACvB,SAAS,CAAC,EAAE,gBAAgB,CAAA;IAC5B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,IAAI,IAAI,WAAuB;IAE/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAU,UAAU,CAAoB;IAC/C,OAAO,CAAU,IAAI,CAAiD;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;gBAElC,IAAI,EAAE,sBAAsB;IAqBxC,kFAAkF;IAClF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAEtB,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CAsChD"}

package/dist/modifiers/generate/BooleanModifier.js

@@ -0,0 +1,71 @@
+import { MeshBasicMaterial } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+/**
+ * BooleanModifier — Blender "Boolean" modifier equivalent.
+ *
+ * three-bvh-csg is loaded lazily (dynamic import) when a BooleanModifier is first
+ * instantiated. This means @st-modifier-core can be imported without three-bvh-csg
+ * in the importmap — the dependency is only required when you actually use this modifier.
+ *
+ * Await `modifier.ready()` before calling `stack.apply()` to ensure the library is loaded.
+ *
+ * ```typescript
+ * const mod = new BooleanModifier({ operand: sphere, operation: 'difference' })
+ * await mod.ready()
+ * mesh.geometry = stack.apply()
+ * ```
+ */
+export class BooleanModifier extends BaseModifier {
+    get name() { return 'Boolean'; }
+    constructor(opts) {
+        super();
+        this._evaluator = null;
+        this._csg = null;
+        this._operand = opts.operand;
+        this._operandMatrix = opts.operandMatrix ?? null;
+        const opIndex = opts.operation === 'union' ? 0
+            : opts.operation === 'intersection' ? 2
+                : 1;
+        this.parameters = { operation: opIndex };
+        // Lazy-load three-bvh-csg — only fetched when this modifier is instantiated,
+        // not when @st-modifier-core is imported. Keeps the package importable without
+        // three-bvh-csg in the importmap.
+        this._ready = import('three-bvh-csg').then(m => {
+            this._csg = m;
+            const Evaluator = m['Evaluator'];
+            this._evaluator = new Evaluator();
+        });
+    }
+    /** Resolves when three-bvh-csg has loaded. Await before calling stack.apply(). */
+    ready() { return this._ready; }
+    apply(geometry) {
+        if (!this._csg || !this._evaluator) {
+            throw new Error('@st-modifier-core BooleanModifier: three-bvh-csg is still loading.\n' +
+                'Await `await modifier.ready()` before calling stack.apply().\n' +
+                'Also add "three-bvh-csg" to your importmap:\n' +
+                '  "three-bvh-csg": "https://unpkg.com/three-bvh-csg@0.0.18/build/index.module.js"');
+        }
+        const { Brush, ADDITION, SUBTRACTION, INTERSECTION } = this._csg;
+        const opMap = { union: ADDITION, difference: SUBTRACTION, intersection: INTERSECTION };
+        const opIndex = Math.round(this.parameters.operation);
+        const opKey = opIndex === 0 ? 'union' : opIndex === 2 ? 'intersection' : 'difference';
+        const csgOp = opMap[opKey];
+        const BrushCls = Brush;
+        const EvalCls = this._evaluator;
+        const mat = new MeshBasicMaterial();
+        const brushA = new BrushCls(geometry, mat);
+        const brushB = new BrushCls(this._operand, mat);
+        if (this._operandMatrix) {
+            brushB.matrix.fromArray(this._operandMatrix);
+            brushB.matrixAutoUpdate = false;
+            brushB.updateMatrixWorld(true);
+        }
+        brushA.updateMatrixWorld(true);
+        brushB.updateMatrixWorld(true);
+        const result = EvalCls.evaluate(brushA, brushB, csgOp);
+        const out = result.geometry.clone();
+        mat.dispose();
+        return out;
+    }
+}
+//# sourceMappingURL=BooleanModifier.js.map

package/dist/modifiers/generate/BooleanModifier.js.map

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

package/dist/modifiers/generate/ExtrudeModifier.d.ts

@@ -0,0 +1,25 @@
+import { BufferGeometry } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+export interface ExtrudeModifierOptions {
+    amount?: number;
+}
+/**
+ * Face Extrude Modifier — procedurally extrudes every face along its normal.
+ * Produces a mesh where each triangle becomes a raised column with side walls.
+ *
+ * NOTE: This is NOT Blender's Extrude modifier. Blender does not have a
+ * non-destructive extrude modifier — extrusion is an edit mode operation on
+ * selected faces. This modifier is a procedural equivalent useful for
+ * stylized effects (crystalline surfaces, low-poly spiky geometry).
+ *
+ * For Blender-equivalent face extrusion, use edit mode or geometry nodes.
+ *
+ * parameters.amount: extrusion distance along face normal
+ */
+export declare class ExtrudeModifier extends BaseModifier {
+    get name(): string;
+    parameters: Record<string, number>;
+    constructor(options?: ExtrudeModifierOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+}
+//# sourceMappingURL=ExtrudeModifier.d.ts.map

package/dist/modifiers/generate/ExtrudeModifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtrudeModifier.d.ts","sourceRoot":"","sources":["../../../src/modifiers/generate/ExtrudeModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,IAAI,IAAI,WAA2B;IAEnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAEtB,OAAO,GAAE,sBAA2B;IAKhD,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;CAmEhD"}

package/dist/modifiers/generate/ExtrudeModifier.js

@@ -0,0 +1,96 @@
+import { BufferGeometry, BufferAttribute } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+/**
+ * Face Extrude Modifier — procedurally extrudes every face along its normal.
+ * Produces a mesh where each triangle becomes a raised column with side walls.
+ *
+ * NOTE: This is NOT Blender's Extrude modifier. Blender does not have a
+ * non-destructive extrude modifier — extrusion is an edit mode operation on
+ * selected faces. This modifier is a procedural equivalent useful for
+ * stylized effects (crystalline surfaces, low-poly spiky geometry).
+ *
+ * For Blender-equivalent face extrusion, use edit mode or geometry nodes.
+ *
+ * parameters.amount: extrusion distance along face normal
+ */
+export class ExtrudeModifier extends BaseModifier {
+    get name() { return 'FaceExtrude'; }
+    constructor(options = {}) {
+        super();
+        this.parameters = { amount: options.amount ?? 0.1 };
+    }
+    apply(geometry) {
+        const amount = this.parameters.amount;
+        const srcPos = geometry.getAttribute('position');
+        const srcUv = geometry.getAttribute('uv');
+        const srcIdx = geometry.getIndex();
+        const vCount = srcPos.count;
+        const outPos = [];
+        const outNorm = [];
+        const outUv = [];
+        const outIdx = [];
+        const tris = buildTriList(srcIdx, vCount);
+        for (const [a, b, c] of tris) {
+            // Face normal
+            const ax = srcPos.getX(a), ay = srcPos.getY(a), az = srcPos.getZ(a);
+            const bx = srcPos.getX(b), by = srcPos.getY(b), bz = srcPos.getZ(b);
+            const cx = srcPos.getX(c), cy = srcPos.getY(c), cz = srcPos.getZ(c);
+            const ux = bx - ax, uy = by - ay, uz = bz - az;
+            const vx = cx - ax, vy = cy - ay, vz = cz - az;
+            let nx = uy * vz - uz * vy, ny = uz * vx - ux * vz, nz = ux * vy - uy * vx;
+            const len = Math.sqrt(nx * nx + ny * ny + nz * nz) || 1;
+            nx /= len;
+            ny /= len;
+            nz /= len;
+            const base = outPos.length / 3;
+            // Bottom (original) face
+            const positions = [[ax, ay, az], [bx, by, bz], [cx, cy, cz]];
+            const uvs = srcUv ? [
+                [srcUv.getX(a), srcUv.getY(a)],
+                [srcUv.getX(b), srcUv.getY(b)],
+                [srcUv.getX(c), srcUv.getY(c)],
+            ] : [[0, 0], [1, 0], [0, 1]];
+            for (let i = 0; i < 3; i++) {
+                outPos.push(...positions[i]);
+                outNorm.push(-nx, -ny, -nz);
+                outUv.push(...uvs[i]);
+            }
+            // Top (extruded) face
+            for (let i = 0; i < 3; i++) {
+                outPos.push(positions[i][0] + nx * amount, positions[i][1] + ny * amount, positions[i][2] + nz * amount);
+                outNorm.push(nx, ny, nz);
+                outUv.push(...uvs[i]);
+            }
+            // Bottom winding reversed
+            outIdx.push(base, base + 2, base + 1);
+            // Top winding
+            outIdx.push(base + 3, base + 4, base + 5);
+            // Side walls
+            const pairs = [[0, 1, 4, 3], [1, 2, 5, 4], [2, 0, 3, 5]];
+            for (const [p0, p1, p2, p3] of pairs) {
+                outIdx.push(base + p0, base + p1, base + p2);
+                outIdx.push(base + p0, base + p2, base + p3);
+            }
+        }
+        const result = new BufferGeometry();
+        result.setAttribute('position', new BufferAttribute(new Float32Array(outPos), 3));
+        result.setAttribute('normal', new BufferAttribute(new Float32Array(outNorm), 3));
+        result.setAttribute('uv', new BufferAttribute(new Float32Array(outUv), 2));
+        result.setIndex(new BufferAttribute(new Uint32Array(outIdx), 1));
+        return result;
+    }
+}
+function buildTriList(idx, vCount) {
+    const tris = [];
+    if (idx) {
+        const ia = idx.array;
+        for (let i = 0; i < ia.length; i += 3)
+            tris.push([ia[i], ia[i + 1], ia[i + 2]]);
+    }
+    else {
+        for (let i = 0; i < vCount; i += 3)
+            tris.push([i, i + 1, i + 2]);
+    }
+    return tris;
+}
+//# sourceMappingURL=ExtrudeModifier.js.map

package/dist/modifiers/generate/ExtrudeModifier.js.map

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

package/dist/modifiers/generate/MirrorModifier.d.ts

@@ -0,0 +1,35 @@
+import { BufferGeometry } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+export interface MirrorModifierOptions {
+    x?: boolean;
+    y?: boolean;
+    z?: boolean;
+    /** Vertices within this distance of the mirror plane are welded (merged). Default 0.001 */
+    mergeThreshold?: number;
+}
+/**
+ * Mirror Modifier — Blender "Mirror" modifier equivalent.
+ *
+ * Mirrors geometry across one or more world axes, one axis at a time.
+ * Vertices within mergeThreshold of the mirror plane are welded — exactly
+ * as Blender does to prevent seams at the mirror boundary.
+ *
+ * Each active axis is applied sequentially (same as Blender's axis checkboxes):
+ *   X active → mirrors across the YZ plane (negates X)
+ *   Y active → mirrors across the XZ plane (negates Y)
+ *   Z active → mirrors across the XY plane (negates Z)
+ *
+ * parameters.x/y/z: 1 = mirror across that axis, 0 = skip
+ * parameters.mergeThreshold: weld distance at mirror plane
+ */
+export declare class MirrorModifier extends BaseModifier {
+    get name(): string;
+    parameters: Record<string, number>;
+    constructor(options?: MirrorModifierOptions);
+    apply(geometry: BufferGeometry): BufferGeometry;
+    /**
+     * Mirror across one axis (0=X, 1=Y, 2=Z) and weld vertices at the mirror plane.
+     */
+    private _mirrorAxis;
+}
+//# sourceMappingURL=MirrorModifier.d.ts.map

package/dist/modifiers/generate/MirrorModifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MirrorModifier.d.ts","sourceRoot":"","sources":["../../../src/modifiers/generate/MirrorModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAEzD,MAAM,WAAW,qBAAqB;IACpC,CAAC,CAAC,EAAU,OAAO,CAAA;IACnB,CAAC,CAAC,EAAU,OAAO,CAAA;IACnB,CAAC,CAAC,EAAU,OAAO,CAAA;IACnB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,IAAI,IAAI,WAAsB;IAE9B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAEtB,OAAO,GAAE,qBAA0B;IAU/C,KAAK,CAAC,QAAQ,EAAE,cAAc,GAAG,cAAc;IAW/C;;OAEG;IACH,OAAO,CAAC,WAAW;CAyEpB"}

package/dist/modifiers/generate/MirrorModifier.js

@@ -0,0 +1,122 @@
+import { BufferGeometry, BufferAttribute } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+/**
+ * Mirror Modifier — Blender "Mirror" modifier equivalent.
+ *
+ * Mirrors geometry across one or more world axes, one axis at a time.
+ * Vertices within mergeThreshold of the mirror plane are welded — exactly
+ * as Blender does to prevent seams at the mirror boundary.
+ *
+ * Each active axis is applied sequentially (same as Blender's axis checkboxes):
+ *   X active → mirrors across the YZ plane (negates X)
+ *   Y active → mirrors across the XZ plane (negates Y)
+ *   Z active → mirrors across the XY plane (negates Z)
+ *
+ * parameters.x/y/z: 1 = mirror across that axis, 0 = skip
+ * parameters.mergeThreshold: weld distance at mirror plane
+ */
+export class MirrorModifier extends BaseModifier {
+    get name() { return 'Mirror'; }
+    constructor(options = {}) {
+        super();
+        this.parameters = {
+            x: options.x !== false ? 1 : 0,
+            y: options.y ? 1 : 0,
+            z: options.z ? 1 : 0,
+            mergeThreshold: options.mergeThreshold ?? 0.001,
+        };
+    }
+    apply(geometry) {
+        let geo = geometry;
+        // Apply each active axis sequentially — same as Blender
+        if (this.parameters.x > 0.5)
+            geo = this._mirrorAxis(geo, 0);
+        if (this.parameters.y > 0.5)
+            geo = this._mirrorAxis(geo, 1);
+        if (this.parameters.z > 0.5)
+            geo = this._mirrorAxis(geo, 2);
+        return geo;
+    }
+    /**
+     * Mirror across one axis (0=X, 1=Y, 2=Z) and weld vertices at the mirror plane.
+     */
+    _mirrorAxis(geometry, axis) {
+        const srcPos = geometry.getAttribute('position');
+        const srcNorm = geometry.getAttribute('normal');
+        const srcUv = geometry.getAttribute('uv');
+        const srcIdx = geometry.getIndex();
+        const vCount = srcPos.count;
+        const thresh = this.parameters.mergeThreshold;
+        const tris = buildTriList(srcIdx, vCount);
+        const outPos = [];
+        const outNorm = [];
+        const outUv = [];
+        const outIdx = [];
+        // Copy original vertices
+        for (let v = 0; v < vCount; v++) {
+            outPos.push(srcPos.getX(v), srcPos.getY(v), srcPos.getZ(v));
+            if (srcNorm)
+                outNorm.push(srcNorm.getX(v), srcNorm.getY(v), srcNorm.getZ(v));
+            if (srcUv)
+                outUv.push(srcUv.getX(v), srcUv.getY(v));
+        }
+        // Map from original vertex index → mirrored vertex index
+        // Vertices ON the mirror plane (within threshold) reuse the original vertex (welded)
+        const mirrorMap = new Array(vCount);
+        for (let v = 0; v < vCount; v++) {
+            const coords = [srcPos.getX(v), srcPos.getY(v), srcPos.getZ(v)];
+            const axVal = coords[axis];
+            if (Math.abs(axVal) <= thresh) {
+                // On the mirror plane — weld: mirrored copy reuses original vertex
+                // Clamp the original to exactly 0 on the mirror axis
+                outPos[v * 3 + axis] = 0;
+                mirrorMap[v] = v;
+            }
+            else {
+                // Off-plane — create a new mirrored vertex
+                const mi = outPos.length / 3;
+                const mx = axis === 0 ? -coords[0] : coords[0];
+                const my = axis === 1 ? -coords[1] : coords[1];
+                const mz = axis === 2 ? -coords[2] : coords[2];
+                outPos.push(mx, my, mz);
+                if (srcNorm) {
+                    const nx = srcNorm.getX(v), ny = srcNorm.getY(v), nz = srcNorm.getZ(v);
+                    outNorm.push(axis === 0 ? -nx : nx, axis === 1 ? -ny : ny, axis === 2 ? -nz : nz);
+                }
+                if (srcUv)
+                    outUv.push(srcUv.getX(v), srcUv.getY(v));
+                mirrorMap[v] = mi;
+            }
+        }
+        // Original triangles
+        for (const [a, b, c] of tris)
+            outIdx.push(a, b, c);
+        // Mirrored triangles — reverse winding to preserve front-face direction
+        for (const [a, b, c] of tris) {
+            outIdx.push(mirrorMap[a], mirrorMap[c], mirrorMap[b]);
+        }
+        const result = new BufferGeometry();
+        result.setAttribute('position', new BufferAttribute(new Float32Array(outPos), 3));
+        if (outNorm.length)
+            result.setAttribute('normal', new BufferAttribute(new Float32Array(outNorm), 3));
+        if (outUv.length)
+            result.setAttribute('uv', new BufferAttribute(new Float32Array(outUv), 2));
+        result.setIndex(new BufferAttribute(new Uint32Array(outIdx), 1));
+        result.computeVertexNormals();
+        return result;
+    }
+}
+function buildTriList(idx, vCount) {
+    const tris = [];
+    if (idx) {
+        const ia = idx.array;
+        for (let i = 0; i < ia.length; i += 3)
+            tris.push([ia[i], ia[i + 1], ia[i + 2]]);
+    }
+    else {
+        for (let i = 0; i < vCount; i += 3)
+            tris.push([i, i + 1, i + 2]);
+    }
+    return tris;
+}
+//# sourceMappingURL=MirrorModifier.js.map

package/dist/modifiers/generate/MirrorModifier.js.map

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

package/dist/modifiers/generate/OceanModifier.d.ts

@@ -0,0 +1,64 @@
+import { BufferGeometry } from 'three';
+import { BaseModifier } from '../../core/BaseModifier.js';
+export interface OceanModifierOptions {
+    /** Animation time in seconds. Increment each frame for animated ocean. */
+    time?: number;
+    /** Dominant wave wavelength in Three.js units. Scale=3 → waves 3 units long. */
+    scale?: number;
+    /** Gerstner horizontal displacement. 0 = pure sine, 1 = choppy, >1.5 = folding. */
+    choppiness?: number;
+    /** Wind speed — scales wave amplitude. Higher = bigger waves. */
+    windSpeed?: number;
+    /** Wind direction in degrees. 0 = along +X axis. */
+    windAngle?: number;
+    /** Grid vertices per side. Default: 32. Higher = more detail but slower. */
+    resolution?: number;
+    /** World-space grid size in Three.js units. */
+    size?: number;
+    /** Water depth — shallower values slow short waves (tanh dispersion). Default: 200. */
+    depth?: number;
+    /** Foam coverage — how aggressively crests produce foam [0-1]. Default: 0.2. */
+    foamCoverage?: number;
+    /** Random seed — same seed always produces the same wave pattern. */
+    seed?: number;
+    /** Wave direction spreading [0-1]. 0 = all waves aligned with wind. */
+    damping?: number;
+    /** Number of Gerstner wave components. More = richer surface. Default: 24. */
+    waveCount?: number;
+    /**
+     * Turbulence — adds value-noise perturbation on top of Gerstner waves.
+     * Breaks up the repeating sine pattern, especially visible when scale changes.
+     * 0 = disabled (pure Gerstner), 0.3 = moderate, 1.0 = heavy chaos.
+     */
+    turbulence?: number;
+}
+/**
+ * Ocean Modifier — Blender "Ocean" modifier equivalent.
+ *
+ * Generates a flat grid displaced by physically-based Gerstner wave simulation
+ * with a Phillips-inspired spectral distribution.
+ * Ignores the input geometry — always generates its own grid.
+ *
+ * Two-pass foam computation:
+ *   Pass 1: evaluate all Gerstner displacements, record height range
+ *   Pass 2: foam = crest fraction × steepness — produces thin streaks at
+ *           wave tips rather than broad blobs from the Jacobian alone.
+ *
+ * Turbulence parameter adds seeded value-noise on top of Gerstner waves,
+ * breaking up the regular periodic pattern at any scale setting.
+ *
+ * Writes a `foam` Float32BufferAttribute. Use OceanAttribute node to read it.
+ */
+export declare class OceanModifier extends BaseModifier {
+    get name(): string;
+    parameters: Record<string, number>;
+    private _waves;
+    private _waveHash;
+    constructor(options?: OceanModifierOptions);
+    apply(_geometry: BufferGeometry): BufferGeometry;
+    private _ensureWaves;
+    private _buildWaves;
+    private _tiledNoise;
+    private _evaluate;
+}
+//# sourceMappingURL=OceanModifier.d.ts.map

package/dist/modifiers/generate/OceanModifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OceanModifier.d.ts","sourceRoot":"","sources":["../../../src/modifiers/generate/OceanModifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,OAAO,CAAA;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAoBzD,MAAM,WAAW,oBAAoB;IACnC,0EAA0E;IAC1E,IAAI,CAAC,EAAU,MAAM,CAAA;IACrB,gFAAgF;IAChF,KAAK,CAAC,EAAS,MAAM,CAAA;IACrB,mFAAmF;IACnF,UAAU,CAAC,EAAI,MAAM,CAAA;IACrB,iEAAiE;IACjE,SAAS,CAAC,EAAK,MAAM,CAAA;IACrB,oDAAoD;IACpD,SAAS,CAAC,EAAK,MAAM,CAAA;IACrB,4EAA4E;IAC5E,UAAU,CAAC,EAAI,MAAM,CAAA;IACrB,+CAA+C;IAC/C,IAAI,CAAC,EAAU,MAAM,CAAA;IACrB,uFAAuF;IACvF,KAAK,CAAC,EAAS,MAAM,CAAA;IACrB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,qEAAqE;IACrE,IAAI,CAAC,EAAU,MAAM,CAAA;IACrB,uEAAuE;IACvE,OAAO,CAAC,EAAO,MAAM,CAAA;IACrB,8EAA8E;IAC9E,SAAS,CAAC,EAAK,MAAM,CAAA;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAI,MAAM,CAAA;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,IAAI,IAAI,WAAqB;IAE7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAElC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,SAAS,CAAuB;gBAE5B,OAAO,GAAE,oBAAyB;IAmB9C,KAAK,CAAC,SAAS,EAAE,cAAc,GAAG,cAAc;IAkFhD,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,WAAW;IAkFnB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,SAAS;CA0DlB"}