@triforge/particle-core 0.1.0

package/dist/core/ParticleSystem.js

@@ -0,0 +1,484 @@
+import { Vector3 } from 'three';
+import { Particle } from './Particle.js';
+import { SeededRandom } from './SeededRandom.js';
+import { ParticleCache } from './ParticleCache.js';
+/**
+ * ParticleSystem — central simulation loop.
+ *
+ * Owns the particle pool, runs emission scheduling, steps Newtonian physics,
+ * applies forces, and calls the renderer each frame.
+ *
+ * Blender parallel: the Particle System object on a mesh.
+ */
+export class ParticleSystem {
+    constructor(opts = {}) {
+        this._tmpVec = new Vector3();
+        this._prevPos = new Vector3(); // saved before integration for collision
+        this._hitNorm = new Vector3();
+        this._hitPt = new Vector3();
+        this._keyedPhysics = null;
+        this.parameters = {
+            count: opts.count ?? 1000,
+            start: opts.start ?? 0,
+            end: opts.end ?? 10,
+            lifetime: opts.lifetime ?? 2,
+            lifetimeRandom: opts.lifetimeRandom ?? 0,
+            size: opts.size ?? 0.1,
+            sizeRandom: opts.sizeRandom ?? 0,
+            seed: opts.seed ?? 0,
+            randomOrder: opts.randomOrder ? 1 : 0,
+            // physics: 0 = none, 1 = newtonian
+            physics: opts.physics === 'none' ? 0 : 1,
+            mass: opts.mass ?? 1,
+            drag: opts.drag ?? 0,
+            brownian: opts.brownian ?? 0,
+            damp: opts.damp ?? 0,
+            gravity: opts.gravity ?? 1,
+            dieOnHit: opts.dieOnHit ? 1 : 0,
+            selfEffect: 0,
+            displayAmount: opts.displayAmount ?? 1,
+            // Rotation panel
+            rotationAxis: opts.rotationAxis ?? 0,
+            rotationRandom: opts.rotationRandom ?? 0,
+            rotationPhase: opts.rotationPhase ?? 0,
+            rotationPhaseRandom: opts.rotationPhaseRandom ?? 0,
+            angularVelocityMode: opts.angularVelocityMode ?? 0,
+            angularVelocityAmount: opts.angularVelocityAmount ?? 0,
+            // Children panel
+            childCount: opts.childCount ?? 0,
+            childSpread: opts.childSpread ?? 0.5,
+            childType: opts.childType ?? 0,
+            // Scale Time (Blender: Physics → Newtonian → Scale Time)
+            scaleTime: 1,
+            // Speed Limit (Blender: Physics → Newtonian → Limit Velocity)
+            limitVelocity: opts.limitVelocity ?? 0,
+            velocityLimit: opts.velocityLimit ?? 10,
+        };
+        this._pool = Array.from({ length: Math.round(this.parameters.count) }, () => new Particle());
+        this._emitters = [];
+        this._forces = [];
+        this._deflectors = [];
+        this._renderer = null;
+        this._rng = new SeededRandom(Math.round(this.parameters.seed));
+        this._childRng = new SeededRandom(Math.round(this.parameters.seed));
+        this._time = 0;
+        this._emitCursor = 0;
+        this._emitAccum = 0;
+        this._geometry = opts.geometry ?? null;
+        this._geometryProvider = opts.geometryProvider ?? null;
+        this._cache = new ParticleCache();
+        this._baked = false;
+    }
+    // ── Public API ─────────────────────────────────────────────────────────────
+    /** Package-internal pool accessor — used by ParticleCache and BoidForce. */
+    get pool() { return this._pool; }
+    /** Current number of alive particles this frame. */
+    get liveCount() {
+        let n = 0;
+        for (const p of this._pool)
+            if (p.alive)
+                n++;
+        return n;
+    }
+    /** The bake/cache object for this system. */
+    get cache() { return this._cache; }
+    /**
+     * Bake the simulation to a replayable cache.
+     * After this returns update() replays the cache instead of simulating.
+     */
+    bake(startSec, endSec, fps) {
+        this._cache.bake(this, startSec, endSec, fps);
+        this._baked = true;
+        this._time = 0;
+    }
+    /**
+     * Return to live simulation.  Clears the cache, resets internal time and pool state.
+     */
+    unbake() {
+        this._baked = false;
+        this._cache.clear();
+        this.reset();
+    }
+    addEmitter(emitter) {
+        this._emitters.push(emitter);
+        return this;
+    }
+    addForce(force) {
+        this._forces.push(force);
+        return this;
+    }
+    addDeflector(deflector) {
+        this._deflectors.push(deflector);
+        return this;
+    }
+    setRenderer(renderer) {
+        this._renderer = renderer;
+        return this;
+    }
+    setGeometry(geo) {
+        this._geometry = geo;
+        return this;
+    }
+    /**
+     * Set a live geometry provider callback.
+     * Called once per update() — use to wire a modifier stack without any
+     * cross-package import. Overrides any geometry set via setGeometry().
+     *
+     * @example
+     * const stack = new ModifierStack(baseGeo)
+     * stack.add(new SubdivisionModifier({ levels: 2 }))
+     * system.setGeometryProvider(() => stack.apply())
+     */
+    setGeometryProvider(fn) {
+        this._geometryProvider = fn;
+        return this;
+    }
+    /**
+     * Show or hide the emitter mesh in the viewport.
+     * Blender: Render → Show Emitter toggle.
+     *
+     * Pass the same Object3D you added to the scene.
+     *   sys.showEmitter(sphereMesh, false) // hide while particles are visible
+     */
+    showEmitter(mesh, visible) {
+        mesh.visible = visible;
+        return this;
+    }
+    /**
+     * Attach a KeyedPhysics blender.
+     * When set, keyed blending is applied after each step.
+     * Drive `kp.parameters.blend` via GSAP or AnimationMixer from st-keyframe.
+     */
+    setKeyedPhysics(kp) {
+        this._keyedPhysics = kp;
+        return this;
+    }
+    /**
+     * Advance the simulation by dt seconds.
+     * Call this once per frame from your render loop.
+     * In baked mode, seeks the cache instead of simulating.
+     */
+    update(dt) {
+        if (this._baked) {
+            this._time += dt;
+            this._cache.seek(this, this._time);
+            if (this._renderer) {
+                this._childRng.reset(Math.round(this.parameters.seed));
+                let alive = 0;
+                for (const p of this._pool) {
+                    if (p.alive)
+                        alive++;
+                }
+                this._renderer.update(this._pool, alive, this.parameters, this._childRng);
+            }
+            return;
+        }
+        const effectiveDt = dt * this.parameters.scaleTime;
+        this._time += effectiveDt;
+        // Resolve geometry once per frame — provider takes priority over static geo
+        if (this._geometryProvider) {
+            this._geometry = this._geometryProvider();
+        }
+        const p = this.parameters;
+        const inEmissionWindow = this._time >= p.start && this._time <= p.end;
+        // ── Emit new particles ──────────────────────────────────────────────────
+        // Rate = count / lifetime so the pool stays full at steady state.
+        if (inEmissionWindow && this._emitters.length > 0 && effectiveDt > 0) {
+            const rate = p.count / Math.max(p.lifetime * (1 - p.lifetimeRandom * 0.5), 0.001);
+            this._emitAccum = Math.max(0, (this._emitAccum ?? 0) + rate * effectiveDt);
+            const toEmit = Math.floor(this._emitAccum);
+            this._emitAccum -= toEmit;
+            for (let i = 0; i < toEmit; i++) {
+                this._emit();
+            }
+        }
+        // ── Step alive particles ────────────────────────────────────────────────
+        let alive = 0;
+        for (const particle of this._pool) {
+            if (!particle.alive)
+                continue;
+            particle.age += effectiveDt;
+            if (particle.age >= particle.lifetime || particle.age < 0) {
+                particle.alive = false;
+                continue;
+            }
+            particle.normalised = particle.age / particle.lifetime;
+            if (p.physics === 1) {
+                this._stepNewtonian(particle, effectiveDt);
+            }
+            alive++;
+        }
+        // ── Self-collision pass ──────────────────────────────────────────────────
+        if (p.selfEffect >= 0.5 && alive > 1) {
+            this._stepSelfCollision();
+        }
+        // ── Keyed physics blend ──────────────────────────────────────────────────
+        if (this._keyedPhysics) {
+            this._keyedPhysics.apply(this._pool, effectiveDt);
+        }
+        // ── Renderer update ─────────────────────────────────────────────────────
+        if (this._renderer) {
+            // Reset child RNG to the base seed each frame → stable child positions.
+            this._childRng.reset(Math.round(this.parameters.seed));
+            this._renderer.update(this._pool, alive, this.parameters, this._childRng);
+        }
+    }
+    /** Reset the simulation to t=0 */
+    reset() {
+        this._time = 0;
+        this._emitCursor = 0;
+        this._emitAccum = 0;
+        this._rng.reset(Math.round(this.parameters.seed));
+        this._childRng.reset(Math.round(this.parameters.seed));
+        for (const p of this._pool)
+            p.reset();
+    }
+    dispose() {
+        this._renderer?.dispose();
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    _emit() {
+        const count = this._pool.length;
+        const useRandom = this.parameters.randomOrder > 0;
+        let slot = null;
+        if (useRandom) {
+            // Randomised order: search from a random starting position
+            const startIdx = Math.floor(this._rng.next() * count);
+            for (let i = 0; i < count; i++) {
+                const idx = (startIdx + i) % count;
+                if (!this._pool[idx].alive) {
+                    slot = this._pool[idx];
+                    break;
+                }
+            }
+            // All slots alive — overwrite a random slot
+            if (!slot) {
+                slot = this._pool[Math.floor(this._rng.next() * count)];
+            }
+        }
+        else {
+            // Sequential order — wrap around with cursor
+            for (let i = 0; i < count; i++) {
+                const idx = (this._emitCursor + i) % count;
+                if (!this._pool[idx].alive) {
+                    slot = this._pool[idx];
+                    this._emitCursor = (idx + 1) % count;
+                    break;
+                }
+            }
+            // All slots alive — overwrite the cursor slot (oldest)
+            if (!slot) {
+                slot = this._pool[this._emitCursor];
+                this._emitCursor = (this._emitCursor + 1) % count;
+            }
+        }
+        slot.reset();
+        slot.alive = true;
+        slot.age = 0;
+        // Lifetime: base ± lifetimeRandom × rand  (Blender: Lifetime Randomness)
+        const lr = this.parameters.lifetimeRandom;
+        slot.lifetime = Math.max(0.001, this.parameters.lifetime * (1 + lr * this._rng.signed()));
+        // Size
+        const sr = this.parameters.sizeRandom;
+        slot.size = this.parameters.size * (1 - sr * this._rng.next());
+        // Pick emitter uniformly at random
+        if (this._emitters.length > 0) {
+            const eIdx = Math.floor(this._rng.next() * this._emitters.length);
+            const emitter = this._emitters[Math.min(eIdx, this._emitters.length - 1)];
+            emitter.spawn(slot, this._geometry, this._rng);
+        }
+        this._initRotation(slot);
+    }
+    _initRotation(slot) {
+        const p = this.parameters;
+        // ── Initial rotation ────────────────────────────────────────────────────
+        // phase + per-particle scatter (Blender: Phase + Phase Random)
+        const phase = p.rotationPhase + p.rotationPhaseRandom * Math.PI * this._rng.signed();
+        // rotationRandom adds additional scatter (Blender: Random)
+        const scatter = p.rotationRandom * Math.PI * this._rng.signed();
+        const angle = phase + scatter;
+        switch (Math.round(p.rotationAxis)) {
+            case 0: // none — leave rotation at zero
+                break;
+            case 1: { // velocity — rotate around velocity direction using that axis as Y
+                const len = slot.velocity.length();
+                if (len > 1e-6) {
+                    this._tmpVec.copy(slot.velocity).divideScalar(len);
+                    slot.rotation.set(this._tmpVec.x * angle, this._tmpVec.y * angle, this._tmpVec.z * angle);
+                }
+                break;
+            }
+            case 2: // angular — spin around particle local Z
+            case 3: // global  — spin around world Z
+            case 4: // local   — spin around local Z
+                slot.rotation.z = angle;
+                break;
+            default:
+                break;
+        }
+        // ── Angular velocity ────────────────────────────────────────────────────
+        const amount = p.angularVelocityAmount;
+        if (amount === 0)
+            return;
+        switch (Math.round(p.angularVelocityMode)) {
+            case 0: // none
+                break;
+            case 1: { // velocity — spin axis aligned with velocity direction
+                const len = slot.velocity.length();
+                if (len > 1e-6) {
+                    slot.angularVel.copy(slot.velocity).multiplyScalar(amount / len);
+                }
+                break;
+            }
+            case 2: // horizontal — spin around world Y (up axis)
+                slot.angularVel.set(0, amount, 0);
+                break;
+            case 3: // vertical — spin around world X
+                slot.angularVel.set(amount, 0, 0);
+                break;
+            case 4: // global — spin around world Z
+                slot.angularVel.set(0, 0, amount);
+                break;
+            case 5: { // random — spin around a random unit axis
+                const rx = this._rng.signed();
+                const ry = this._rng.signed();
+                const rz = this._rng.signed();
+                const len = Math.sqrt(rx * rx + ry * ry + rz * rz);
+                if (len > 1e-6) {
+                    slot.angularVel.set(rx / len * amount, ry / len * amount, rz / len * amount);
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    }
+    _stepNewtonian(particle, dt) {
+        const p = this.parameters;
+        // Apply all forces: F = ma → a = F/m → dv = a·dt
+        for (const force of this._forces) {
+            if (force.enabled)
+                force.apply(particle, dt);
+        }
+        // Gravity (world -Y)
+        particle.velocity.y -= 9.81 * p.gravity * dt / Math.max(p.mass, 0.0001);
+        // Air drag: dv = -drag · v · dt
+        if (p.drag > 0) {
+            particle.velocity.multiplyScalar(1 - Math.min(p.drag * dt, 1));
+        }
+        // Velocity damping
+        if (p.damp > 0) {
+            particle.velocity.multiplyScalar(1 - Math.min(p.damp * dt, 1));
+        }
+        // Brownian motion (thermal noise)
+        if (p.brownian > 0) {
+            const b = p.brownian * dt;
+            particle.velocity.x += (Math.random() * 2 - 1) * b;
+            particle.velocity.y += (Math.random() * 2 - 1) * b;
+            particle.velocity.z += (Math.random() * 2 - 1) * b;
+        }
+        // Guard against NaN/Infinity in velocity before integration
+        if (!isFinite(particle.velocity.x))
+            particle.velocity.x = 0;
+        if (!isFinite(particle.velocity.y))
+            particle.velocity.y = 0;
+        if (!isFinite(particle.velocity.z))
+            particle.velocity.z = 0;
+        // Save position before integration for collision crossing detection
+        this._prevPos.copy(particle.position);
+        // Integrate position
+        particle.position.addScaledVector(particle.velocity, dt);
+        // Guard against NaN/Infinity in position after integration
+        if (!isFinite(particle.position.x))
+            particle.position.x = 0;
+        if (!isFinite(particle.position.y))
+            particle.position.y = 0;
+        if (!isFinite(particle.position.z))
+            particle.position.z = 0;
+        // ── Deflector collisions ─────────────────────────────────────────────────
+        if (this._deflectors.length > 0) {
+            for (const deflector of this._deflectors) {
+                if (deflector.checkCrossing(this._prevPos.x, this._prevPos.y, this._prevPos.z, particle.position.x, particle.position.y, particle.position.z, this._hitNorm, this._hitPt, particle.size * 0.5)) {
+                    if (p.dieOnHit >= 0.5) {
+                        particle.alive = false;
+                        break;
+                    }
+                    const damping = deflector.parameters.damping;
+                    const friction = deflector.parameters.friction;
+                    const nx = this._hitNorm.x, ny = this._hitNorm.y, nz = this._hitNorm.z;
+                    // Reflect: v_new = v - (2 - damping) * dot(v,n) * n
+                    // damping=0 → elastic (speed conserved), damping=1 → inelastic (normal=0)
+                    const vDotN = particle.velocity.x * nx + particle.velocity.y * ny + particle.velocity.z * nz;
+                    const k = (2 - damping) * vDotN;
+                    particle.velocity.x -= k * nx;
+                    particle.velocity.y -= k * ny;
+                    particle.velocity.z -= k * nz;
+                    // Friction: reduce tangential component
+                    // v_final = (1-friction)*v_reflected + friction*dot(v_reflected,n)*n
+                    if (friction > 0) {
+                        const vNewDotN = particle.velocity.x * nx + particle.velocity.y * ny + particle.velocity.z * nz;
+                        particle.velocity.x = (1 - friction) * particle.velocity.x + friction * vNewDotN * nx;
+                        particle.velocity.y = (1 - friction) * particle.velocity.y + friction * vNewDotN * ny;
+                        particle.velocity.z = (1 - friction) * particle.velocity.z + friction * vNewDotN * nz;
+                    }
+                    // Reposition to contact plane to prevent clipping
+                    particle.position.copy(this._hitPt);
+                    break;
+                }
+            }
+        }
+        // Speed limit (Blender: Physics → Newtonian → Limit Velocity)
+        if (p.limitVelocity >= 0.5) {
+            const limit = Math.max(0, p.velocityLimit);
+            const speed = particle.velocity.length();
+            if (speed > limit)
+                particle.velocity.multiplyScalar(limit / speed);
+        }
+        // Integrate rotation from angular velocity
+        particle.rotation.addScaledVector(particle.angularVel, dt);
+    }
+    /**
+     * O(n²) inter-particle collision — elastic bounce when two particles overlap.
+     * Only runs when parameters.selfEffect >= 0.5 (Blender: Physics → Self Effect).
+     */
+    _stepSelfCollision() {
+        const pool = this._pool;
+        const n = pool.length;
+        for (let i = 0; i < n - 1; i++) {
+            const a = pool[i];
+            if (!a.alive)
+                continue;
+            for (let j = i + 1; j < n; j++) {
+                const b = pool[j];
+                if (!b.alive)
+                    continue;
+                const dx = a.position.x - b.position.x;
+                const dy = a.position.y - b.position.y;
+                const dz = a.position.z - b.position.z;
+                const dist2 = dx * dx + dy * dy + dz * dz;
+                const minDist = (a.size + b.size) * 0.5;
+                if (dist2 < minDist * minDist && dist2 > 1e-12) {
+                    const dist = Math.sqrt(dist2);
+                    const nx = dx / dist;
+                    const ny = dy / dist;
+                    const nz = dz / dist;
+                    // Relative velocity along collision normal
+                    const dvn = (a.velocity.x - b.velocity.x) * nx
+                        + (a.velocity.y - b.velocity.y) * ny
+                        + (a.velocity.z - b.velocity.z) * nz;
+                    // Only respond if particles are approaching
+                    if (dvn < 0) {
+                        // Equal-mass elastic: exchange normal-component impulse
+                        a.velocity.x -= dvn * nx;
+                        a.velocity.y -= dvn * ny;
+                        a.velocity.z -= dvn * nz;
+                        b.velocity.x += dvn * nx;
+                        b.velocity.y += dvn * ny;
+                        b.velocity.z += dvn * nz;
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=ParticleSystem.js.map

package/dist/core/ParticleSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleSystem.js","sourceRoot":"","sources":["../../src/core/ParticleSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,OAAO,EAAE,MAAM,OAAO,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAe,eAAe,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAW,mBAAmB,CAAA;AACrD,OAAO,EAAE,aAAa,EAAE,MAAU,oBAAoB,CAAA;AAqGtD;;;;;;;GAOG;AACH,MAAM,OAAO,cAAc;IAwBzB,YAAY,OAA8B,EAAE;QAR3B,YAAO,GAAa,IAAI,OAAO,EAAE,CAAA;QACjC,aAAQ,GAAY,IAAI,OAAO,EAAE,CAAA,CAAE,yCAAyC;QAC5E,aAAQ,GAAY,IAAI,OAAO,EAAE,CAAA;QACjC,WAAM,GAAc,IAAI,OAAO,EAAE,CAAA;QAG1C,kBAAa,GAAyB,IAAI,CAAA;QAGhD,IAAI,CAAC,UAAU,GAAG;YAChB,KAAK,EAAW,IAAI,CAAC,KAAK,IAAa,IAAI;YAC3C,KAAK,EAAW,IAAI,CAAC,KAAK,IAAa,CAAC;YACxC,GAAG,EAAa,IAAI,CAAC,GAAG,IAAe,EAAE;YACzC,QAAQ,EAAQ,IAAI,CAAC,QAAQ,IAAU,CAAC;YACxC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,CAAC;YACxC,IAAI,EAAY,IAAI,CAAC,IAAI,IAAc,GAAG;YAC1C,UAAU,EAAM,IAAI,CAAC,UAAU,IAAQ,CAAC;YACxC,IAAI,EAAY,IAAI,CAAC,IAAI,IAAc,CAAC;YACxC,WAAW,EAAK,IAAI,CAAC,WAAW,CAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,mCAAmC;YACnC,OAAO,EAAS,IAAI,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,IAAI,EAAY,IAAI,CAAC,IAAI,IAAc,CAAC;YACxC,IAAI,EAAY,IAAI,CAAC,IAAI,IAAc,CAAC;YACxC,QAAQ,EAAQ,IAAI,CAAC,QAAQ,IAAU,CAAC;YACxC,IAAI,EAAY,IAAI,CAAC,IAAI,IAAc,CAAC;YACxC,OAAO,EAAS,IAAI,CAAC,OAAO,IAAW,CAAC;YACxC,QAAQ,EAAQ,IAAI,CAAC,QAAQ,CAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,UAAU,EAAM,CAAC;YACjB,aAAa,EAAG,IAAI,CAAC,aAAa,IAAK,CAAC;YACxC,iBAAiB;YACjB,YAAY,EAAU,IAAI,CAAC,YAAY,IAAY,CAAC;YACpD,cAAc,EAAQ,IAAI,CAAC,cAAc,IAAU,CAAC;YACpD,aAAa,EAAS,IAAI,CAAC,aAAa,IAAW,CAAC;YACpD,mBAAmB,EAAG,IAAI,CAAC,mBAAmB,IAAK,CAAC;YACpD,mBAAmB,EAAG,IAAI,CAAC,mBAAmB,IAAK,CAAC;YACpD,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,IAAI,CAAC;YACtD,iBAAiB;YACjB,UAAU,EAAG,IAAI,CAAC,UAAU,IAAK,CAAC;YAClC,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,GAAG;YACpC,SAAS,EAAI,IAAI,CAAC,SAAS,IAAM,CAAC;YAClC,yDAAyD;YACzD,SAAS,EAAI,CAAC;YACd,8DAA8D;YAC9D,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;YACtC,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,EAAE;SACxC,CAAA;QAED,IAAI,CAAC,KAAK,GAAS,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAA;QAClG,IAAI,CAAC,SAAS,GAAK,EAAE,CAAA;QACrB,IAAI,CAAC,OAAO,GAAO,EAAE,CAAA;QACrB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAA;QACrB,IAAI,CAAC,SAAS,GAAK,IAAI,CAAA;QACvB,IAAI,CAAC,IAAI,GAAU,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACrE,IAAI,CAAC,SAAS,GAAK,IAAI,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACrE,IAAI,CAAC,KAAK,GAAS,CAAC,CAAA;QACpB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,UAAU,GAAI,CAAC,CAAA;QACpB,IAAI,CAAC,SAAS,GAAW,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAA;QAC9C,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAA;QACtD,IAAI,CAAC,MAAM,GAAQ,IAAI,aAAa,EAAE,CAAA;QACtC,IAAI,CAAC,MAAM,GAAQ,KAAK,CAAA;IAC1B,CAAC;IAED,8EAA8E;IAE9E,4EAA4E;IAC5E,IAAI,IAAI,KAAiB,OAAO,IAAI,CAAC,KAAK,CAAA,CAAC,CAAC;IAE5C,oDAAoD;IACpD,IAAI,SAAS;QACX,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,CAAC,KAAK;gBAAE,CAAC,EAAE,CAAA;QAC5C,OAAO,CAAC,CAAA;IACV,CAAC;IAED,6CAA6C;IAC7C,IAAI,KAAK,KAAoB,OAAO,IAAI,CAAC,MAAM,CAAA,CAAC,CAAC;IAEjD;;;OAGG;IACH,IAAI,CAAC,QAAgB,EAAE,MAAc,EAAE,GAAW;QAChD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,CAAA;QAC7C,IAAI,CAAC,MAAM,GAAG,IAAI,CAAA;QAClB,IAAI,CAAC,KAAK,GAAI,CAAC,CAAA;IACjB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAA;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAA;QACnB,IAAI,CAAC,KAAK,EAAE,CAAA;IACd,CAAC;IAED,UAAU,CAAC,OAAoB;QAC7B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC5B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,QAAQ,CAAC,KAAgB;QACvB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACxB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,YAAY,CAAC,SAA4B;QACvC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QAChC,OAAO,IAAI,CAAA;IACb,CAAC;IAED,WAAW,CAAC,QAAsB;QAChC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAA;QACzB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,WAAW,CAAC,GAAmB;QAC7B,IAAI,CAAC,SAAS,GAAG,GAAG,CAAA;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;;;;OASG;IACH,mBAAmB,CAAC,EAAiC;QACnD,IAAI,CAAC,iBAAiB,GAAG,EAAE,CAAA;QAC3B,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;;;OAMG;IACH,WAAW,CAAC,IAA0B,EAAE,OAAgB;QACtD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,EAAgB;QAC9B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAA;QACvB,OAAO,IAAI,CAAA;IACb,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,EAAU;QACf,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAA;YAChB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACnB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;gBACtD,IAAI,KAAK,GAAG,CAAC,CAAA;gBACb,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAAC,IAAI,CAAC,CAAC,KAAK;wBAAE,KAAK,EAAE,CAAA;gBAAC,CAAC;gBACpD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;YAC3E,CAAC;YACD,OAAM;QACR,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAA;QAClD,IAAI,CAAC,KAAK,IAAI,WAAW,CAAA;QAEzB,4EAA4E;QAC5E,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;QAC3C,CAAC;QAED,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAA;QACzB,MAAM,gBAAgB,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAA;QAErE,2EAA2E;QAC3E,kEAAkE;QAClE,IAAI,gBAAgB,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACrE,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,GAAG,GAAG,CAAC,EAAE,KAAK,CAAC,CAAA;YACjF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,WAAW,CAAC,CAAA;YAC1E,MAAM,MAAM,GAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YAC7C,IAAI,CAAC,UAAU,IAAI,MAAM,CAAA;YAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAChC,IAAI,CAAC,KAAK,EAAE,CAAA;YACd,CAAC;QACH,CAAC;QAED,2EAA2E;QAC3E,IAAI,KAAK,GAAG,CAAC,CAAA;QACb,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAClC,IAAI,CAAC,QAAQ,CAAC,KAAK;gBAAE,SAAQ;YAE7B,QAAQ,CAAC,GAAG,IAAI,WAAW,CAAA;YAC3B,IAAI,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC1D,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAA;gBACtB,SAAQ;YACV,CAAC;YAED,QAAQ,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAA;YAEtD,IAAI,CAAC,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAA;YAC5C,CAAC;YAED,KAAK,EAAE,CAAA;QACT,CAAC;QAED,4EAA4E;QAC5E,IAAI,CAAC,CAAC,UAAU,IAAI,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAA;QAC3B,CAAC;QAED,4EAA4E;QAC5E,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QACnD,CAAC;QAED,2EAA2E;QAC3E,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,wEAAwE;YACxE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;YACtD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,CAAA;QAC3E,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,KAAK;QACH,IAAI,CAAC,KAAK,GAAS,CAAC,CAAA;QACpB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAA;QACpB,IAAI,CAAC,UAAU,GAAI,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACjD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAA;QACtD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK;YAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IACvC,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,CAAA;IAC3B,CAAC;IAED,8EAA8E;IAEtE,KAAK;QACX,MAAM,KAAK,GAAQ,IAAI,CAAC,KAAK,CAAC,MAAM,CAAA;QACpC,MAAM,SAAS,GAAI,IAAI,CAAC,UAAU,CAAC,WAAW,GAAG,CAAC,CAAA;QAClD,IAAI,IAAI,GAAoB,IAAI,CAAA;QAEhC,IAAI,SAAS,EAAE,CAAC;YACd,2DAA2D;YAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAA;YACrD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;gBAClC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;oBAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;oBACtB,MAAK;gBACP,CAAC;YACH,CAAC;YACD,4CAA4C;YAC5C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC,CAAA;YACzD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,6CAA6C;YAC7C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;gBAC1C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC;oBAC3B,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;oBACtB,IAAI,CAAC,WAAW,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;oBACpC,MAAK;gBACP,CAAC;YACH,CAAC;YACD,uDAAuD;YACvD,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;gBACnC,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,GAAG,KAAK,CAAA;YACnD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;QACjB,IAAI,CAAC,GAAG,GAAK,CAAC,CAAA;QAEd,yEAAyE;QACzE,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAA;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;QAEzF,OAAO;QACP,MAAM,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAA;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAE9D,mCAAmC;QACnC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;YACpE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAA;YACzE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,CAAC;QAED,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IAEO,aAAa,CAAC,IAAc;QAClC,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAA;QAEzB,2EAA2E;QAC3E,+DAA+D;QAC/D,MAAM,KAAK,GAAK,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;QACtF,2DAA2D;QAC3D,MAAM,OAAO,GAAG,CAAC,CAAC,cAAc,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;QAC/D,MAAM,KAAK,GAAK,KAAK,GAAG,OAAO,CAAA;QAE/B,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC;YACnC,KAAK,CAAC,EAAE,gCAAgC;gBACtC,MAAK;YACP,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,mEAAmE;gBAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;gBAClC,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;oBACf,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;oBAClD,IAAI,CAAC,QAAQ,CAAC,GAAG,CACf,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,EACtB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,EACtB,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,KAAK,CACvB,CAAA;gBACH,CAAC;gBACD,MAAK;YACP,CAAC;YACD,KAAK,CAAC,CAAC,CAAC,yCAAyC;YACjD,KAAK,CAAC,CAAC,CAAC,gCAAgC;YACxC,KAAK,CAAC,EAAE,gCAAgC;gBACtC,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAA;gBACvB,MAAK;YACP;gBACE,MAAK;QACT,CAAC;QAED,2EAA2E;QAC3E,MAAM,MAAM,GAAG,CAAC,CAAC,qBAAqB,CAAA;QACtC,IAAI,MAAM,KAAK,CAAC;YAAE,OAAM;QAExB,QAAQ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC;YAC1C,KAAK,CAAC,EAAE,OAAO;gBACb,MAAK;YACP,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,uDAAuD;gBAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;gBAClC,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;oBACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,cAAc,CAAC,MAAM,GAAG,GAAG,CAAC,CAAA;gBAClE,CAAC;gBACD,MAAK;YACP,CAAC;YACD,KAAK,CAAC,EAAE,6CAA6C;gBACnD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;gBACjC,MAAK;YACP,KAAK,CAAC,EAAE,iCAAiC;gBACvC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;gBACjC,MAAK;YACP,KAAK,CAAC,EAAE,+BAA+B;gBACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;gBACjC,MAAK;YACP,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,0CAA0C;gBAClD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;gBAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;gBAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAA;gBAClD,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;oBACf,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,GAAG,MAAM,EAAE,EAAE,GAAG,GAAG,GAAG,MAAM,EAAE,EAAE,GAAG,GAAG,GAAG,MAAM,CAAC,CAAA;gBAC9E,CAAC;gBACD,MAAK;YACP,CAAC;YACD;gBACE,MAAK;QACT,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,QAAkB,EAAE,EAAU;QACnD,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAA;QAEzB,iDAAiD;QACjD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjC,IAAI,KAAK,CAAC,OAAO;gBAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAC9C,CAAC;QAED,qBAAqB;QACrB,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAEvE,gCAAgC;QAChC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QAChE,CAAC;QAED,mBAAmB;QACnB,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACf,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAA;QAChE,CAAC;QAED,kCAAkC;QAClC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAA;YACzB,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YAClD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YAClD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;QACpD,CAAC;QAED,4DAA4D;QAC5D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;QAE3D,oEAAoE;QACpE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAErC,qBAAqB;QACrB,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QAExD,2DAA2D;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;QAC3D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAA;QAE3D,4EAA4E;QAC5E,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;gBACzC,IAAI,SAAS,CAAC,aAAa,CACzB,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EACjD,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAC7D,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAC1B,QAAQ,CAAC,IAAI,GAAG,GAAG,CACpB,EAAE,CAAC;oBACF,IAAI,CAAC,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;wBACtB,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAA;wBACtB,MAAK;oBACP,CAAC;oBAED,MAAM,OAAO,GAAI,SAAS,CAAC,UAAU,CAAC,OAAO,CAAA;oBAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,QAAQ,CAAA;oBAC9C,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;oBAEtE,oDAAoD;oBACpD,0EAA0E;oBAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAA;oBAC5F,MAAM,CAAC,GAAO,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,KAAK,CAAA;oBACnC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;oBAC7B,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;oBAC7B,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;oBAE7B,wCAAwC;oBACxC,qEAAqE;oBACrE,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;wBACjB,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAA;wBAC/F,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,EAAE,CAAA;wBACrF,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,EAAE,CAAA;wBACrF,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,GAAG,QAAQ,GAAG,EAAE,CAAA;oBACvF,CAAC;oBAED,kDAAkD;oBAClD,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;oBACnC,MAAK;gBACP,CAAC;YACH,CAAC;QACH,CAAC;QAED,8DAA8D;QAC9D,IAAI,CAAC,CAAC,aAAa,IAAI,GAAG,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,aAAa,CAAC,CAAA;YAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;YACxC,IAAI,KAAK,GAAG,KAAK;gBAAE,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC,CAAA;QACpE,CAAC;QAED,2CAA2C;QAC3C,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAC5D,CAAC;IAED;;;OAGG;IACK,kBAAkB;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAA;QACvB,MAAM,CAAC,GAAM,IAAI,CAAC,MAAM,CAAA;QACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,IAAI,CAAC,CAAC,CAAC,KAAK;gBAAE,SAAQ;YACtB,KAAK,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;gBACjB,IAAI,CAAC,CAAC,CAAC,KAAK;oBAAE,SAAQ;gBAEtB,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;gBACtC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;gBACtC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;gBACtC,MAAM,KAAK,GAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;gBAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAA;gBAEvC,IAAI,KAAK,GAAG,OAAO,GAAG,OAAO,IAAI,KAAK,GAAG,KAAK,EAAE,CAAC;oBAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;oBAC7B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;oBACpB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;oBACpB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;oBAEpB,2CAA2C;oBAC3C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE;0BAClC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE;0BAClC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;oBAE9C,4CAA4C;oBAC5C,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;wBACZ,wDAAwD;wBACxD,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAA;wBACxB,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAA;wBACxB,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAA;wBACxB,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAA;wBACxB,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAA;wBACxB,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,GAAG,EAAE,CAAA;oBAC1B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/core/SeededRandom.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Seeded LCG random — same seed always produces the same sequence.
+ * Matches Blender's particle seed behaviour.
+ */
+export declare class SeededRandom {
+    private s;
+    constructor(seed: number);
+    /** Returns a float in [0, 1) */
+    next(): number;
+    /** Returns a float in [-1, 1) */
+    signed(): number;
+    /** Returns a float in [min, max) */
+    range(min: number, max: number): number;
+    /** Reset the generator to a new seed — reuse the instance instead of allocating. */
+    reset(seed: number): void;
+}
+//# sourceMappingURL=SeededRandom.d.ts.map

package/dist/core/SeededRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeededRandom.d.ts","sourceRoot":"","sources":["../../src/core/SeededRandom.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,CAAC,CAAQ;gBAEL,IAAI,EAAE,MAAM;IAIxB,gCAAgC;IAChC,IAAI,IAAI,MAAM;IAKd,iCAAiC;IACjC,MAAM,IAAI,MAAM;IAIhB,oCAAoC;IACpC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIvC,oFAAoF;IACpF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAG1B"}

package/dist/core/SeededRandom.js

@@ -0,0 +1,27 @@
+/**
+ * Seeded LCG random — same seed always produces the same sequence.
+ * Matches Blender's particle seed behaviour.
+ */
+export class SeededRandom {
+    constructor(seed) {
+        this.s = seed >>> 0;
+    }
+    /** Returns a float in [0, 1) */
+    next() {
+        this.s = (Math.imul(1664525, this.s) + 1013904223) >>> 0;
+        return this.s / 4294967296;
+    }
+    /** Returns a float in [-1, 1) */
+    signed() {
+        return this.next() * 2 - 1;
+    }
+    /** Returns a float in [min, max) */
+    range(min, max) {
+        return min + this.next() * (max - min);
+    }
+    /** Reset the generator to a new seed — reuse the instance instead of allocating. */
+    reset(seed) {
+        this.s = seed >>> 0;
+    }
+}
+//# sourceMappingURL=SeededRandom.js.map

package/dist/core/SeededRandom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SeededRandom.js","sourceRoot":"","sources":["../../src/core/SeededRandom.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,YAAY;IAGvB,YAAY,IAAY;QACtB,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAA;IACrB,CAAC;IAED,gCAAgC;IAChC,IAAI;QACF,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,KAAK,CAAC,CAAA;QACxD,OAAO,IAAI,CAAC,CAAC,GAAG,UAAU,CAAA;IAC5B,CAAC;IAED,iCAAiC;IACjC,MAAM;QACJ,OAAO,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;IAC5B,CAAC;IAED,oCAAoC;IACpC,KAAK,CAAC,GAAW,EAAE,GAAW;QAC5B,OAAO,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,CAAA;IACxC,CAAC;IAED,oFAAoF;IACpF,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAA;IACrB,CAAC;CACF"}

package/dist/emitters/EdgeEmitter.d.ts

@@ -0,0 +1,43 @@
+import { BufferGeometry } from 'three';
+import { BaseEmitter, BaseEmitterOptions } from '../core/BaseEmitter.js';
+import type { Particle } from '../core/Particle.js';
+import type { SeededRandom } from '../core/SeededRandom.js';
+export interface EdgeEmitterOptions extends BaseEmitterOptions {
+    /**
+     * Y threshold — only emit from edges whose midpoint Y is within
+     * this distance of targetY. Used for waterline foam (y ≈ 0).
+     * Default: Infinity (all edges).
+     */
+    yThreshold?: number;
+    /**
+     * Target Y value to test against yThreshold. Default: 0.
+     */
+    targetY?: number;
+    /**
+     * Only emit from edges whose midpoint Z is >= zMin (local space).
+     * Use this to restrict emission to the shore-edge of an ocean mesh.
+     * Default: -Infinity (all edges).
+     */
+    zMin?: number;
+    /**
+     * Only emit from edges whose midpoint Z is <= zMax (local space).
+     * Default: +Infinity (all edges).
+     */
+    zMax?: number;
+}
+/**
+ * EdgeEmitter — emits particles from mesh edges.
+ *
+ * Primary use case: waterline foam — edges where the ocean surface
+ * crosses y ≈ 0 (the shore) are the emission source.
+ *
+ * yThreshold filters to only edges near the water surface.
+ */
+export declare class EdgeEmitter extends BaseEmitter {
+    /** Cached candidate edges — rebuilt when geometry reference changes */
+    private _edgeCache;
+    private _lastGeo;
+    constructor(opts?: EdgeEmitterOptions);
+    spawn(particle: Particle, geometry: BufferGeometry | null, rng: SeededRandom): void;
+}
+//# sourceMappingURL=EdgeEmitter.d.ts.map

package/dist/emitters/EdgeEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EdgeEmitter.d.ts","sourceRoot":"","sources":["../../src/emitters/EdgeEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,cAAc,EAAE,MAAM,OAAO,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAU,qBAAqB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,WAAW;IAC1C,uEAAuE;IACvE,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,QAAQ,CAAgC;gBAEpC,IAAI,GAAE,kBAAuB;IAQzC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI;CAoEpF"}