@aura3d/rendering 2.0.4 → 3.0.1

package/dist/effects/SizeModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SizeModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/SizeModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBxF;AAED,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;gBAE5B,KAAK,EAAE,SAAS,YAAY,EAAE;IAK1C,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;CAGjE"}
+{"version":3,"file":"SizeModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/SizeModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAmBD,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAgBxF;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,EAAE,KAAK,SAAK,GAAG,YAAY,CAU/F;AAED,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;gBAE5B,KAAK,EAAE,SAAS,YAAY,EAAE;IAK1C,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAIhE,cAAc,CAAC,KAAK,SAAK,GAAG,YAAY;CAGzC"}

package/dist/effects/SizeModule.js

@@ -28,8 +28,21 @@ export function sampleSizeCurve(keyframes, time) {
     }
     return keyframes[keyframes.length - 1].size;
 }
+/** Pack a size-over-life curve into a fixed-stop LUT for the compute kernel. */
+export function encodeSizeCurveLUT(keyframes, stops = 16) {
+    validateCurve(keyframes);
+    if (!Number.isInteger(stops) || stops < 2 || stops > 64) {
+        throw new RangeError("Size curve LUT stops must be an integer in [2, 64].");
+    }
+    const lut = new Float32Array(stops);
+    for (let index = 0; index < stops; index += 1) {
+        lut[index] = sampleSizeCurve(keyframes, stops === 1 ? 0 : index / (stops - 1));
+    }
+    return lut;
+}
 export class SizeModule {
     name = "SizeModule";
+    supportsGPU = true;
     curve;
     constructor(curve) {
         this.curve = curve;
@@ -38,5 +51,8 @@ export class SizeModule {
     update(particle, context) {
         particle.size = sampleSizeCurve(this.curve, context.normalizedAge);
     }
+    toGPUSizeCurve(stops = 16) {
+        return encodeSizeCurveLUT(this.curve, stops);
+    }
 }
 //# sourceMappingURL=SizeModule.js.map

package/dist/effects/SizeModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"SizeModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/SizeModule.ts"],"names":[],"mappings":"AAQA,SAAS,aAAa,CAAC,SAAkC;IACvD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC,iDAAiD,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,UAAU,CAAC,0EAA0E,CAAC,CAAC;QACnG,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,UAAU,CAAC,gEAAgE,CAAC,CAAC;QACzF,CAAC;QACD,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAAkC,EAAE,IAAY;IAC9E,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAC5C,OAAO,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,MAAM,OAAO,UAAU;IACZ,IAAI,GAAG,YAAY,CAAC;IACpB,KAAK,CAA0B;IAExC,YAAY,KAA8B;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,aAAa,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,QAAkB,EAAE,OAA8B;QACvD,QAAQ,CAAC,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACrE,CAAC;CACF"}
+{"version":3,"file":"SizeModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/SizeModule.ts"],"names":[],"mappings":"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"}

package/dist/effects/SubEmitterModule.d.ts

@@ -0,0 +1,61 @@
+import { type Particle, type Vector3Like } from "./Particle.js";
+import { ParticleEmitter } from "./ParticleEmitter.js";
+import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
+export type SubEmitterTrigger = "death" | "midlife";
+export interface SubEmitterModuleOptions {
+    readonly trigger: SubEmitterTrigger;
+    /** Probability per trigger event in [0, 1]. Defaults to 1. */
+    readonly chance?: number;
+    /** Emitter that spawns child particles. */
+    readonly childEmitter: ParticleEmitter;
+    /** Fraction of the parent velocity inherited by children. Defaults to 0.3. */
+    readonly velocityInherit?: number;
+    /** Children spawned per trigger event. Defaults to 1. */
+    readonly childrenPerEvent?: number;
+}
+export interface SubEmitterSpawnRequest {
+    readonly position: Vector3Like;
+    readonly velocity: Vector3Like;
+    readonly count: number;
+}
+export interface GPUSubEmitterParams {
+    /** Normalized age that fires the emitter: 0.5 for midlife, 1 for death. */
+    readonly triggerAge: number;
+    readonly chance: number;
+    readonly childCount: number;
+}
+/**
+ * Sub-emitters: particles spawn child particles at midlife or death
+ * (explosion sparks, splash droplets, ember bursts).
+ *
+ * CPU path: afterIntegrate queues spawn requests; the ParticleSystem drains
+ * them after integration. GPU path: the compute kernel evaluates the same
+ * trigger (normalized-age crossing + hash(chance)) and writes per-particle
+ * spawn requests that the system drains through the GPU spawn pipeline.
+ */
+export declare class SubEmitterModule implements ParticleModule {
+    readonly name = "SubEmitterModule";
+    readonly supportsGPU = true;
+    readonly trigger: SubEmitterTrigger;
+    readonly chance: number;
+    readonly childEmitter: ParticleEmitter;
+    readonly velocityInherit: number;
+    readonly childrenPerEvent: number;
+    readonly pendingSpawns: SubEmitterSpawnRequest[];
+    constructor(options: SubEmitterModuleOptions);
+    afterIntegrate(particle: Particle, context: ParticleUpdateContext): void;
+    /** Create child particles for queued requests, bounded by capacity. Returns { children, dropped }. */
+    drainPendingSpawns(capacity: number): {
+        children: Particle[];
+        dropped: number;
+    };
+    /** Create child particles for GPU spawn-request flags (parallel to drainPendingSpawns). */
+    createChildren(requests: readonly SubEmitterSpawnRequest[], capacity: number): {
+        children: Particle[];
+        dropped: number;
+    };
+    clearPendingSpawns(): void;
+    toGPUSubEmitter(): GPUSubEmitterParams;
+    private createChild;
+}
+//# sourceMappingURL=SubEmitterModule.d.ts.map

package/dist/effects/SubEmitterModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubEmitterModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/SubEmitterModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,8EAA8E;IAC9E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,yDAAyD;IACzD,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IACvC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,sBAAsB,EAAE,CAAM;gBAE1C,OAAO,EAAE,uBAAuB;IAiB5C,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IA4BxE,sGAAsG;IACtG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAgB/E,2FAA2F;IAC3F,cAAc,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAexH,kBAAkB,IAAI,IAAI;IAI1B,eAAe,IAAI,mBAAmB;IAQtC,OAAO,CAAC,WAAW;CAapB"}

package/dist/effects/SubEmitterModule.js

@@ -0,0 +1,119 @@
+import { cloneVector3 } from "./Particle.js";
+import { ParticleEmitter } from "./ParticleEmitter.js";
+/**
+ * Sub-emitters: particles spawn child particles at midlife or death
+ * (explosion sparks, splash droplets, ember bursts).
+ *
+ * CPU path: afterIntegrate queues spawn requests; the ParticleSystem drains
+ * them after integration. GPU path: the compute kernel evaluates the same
+ * trigger (normalized-age crossing + hash(chance)) and writes per-particle
+ * spawn requests that the system drains through the GPU spawn pipeline.
+ */
+export class SubEmitterModule {
+    name = "SubEmitterModule";
+    supportsGPU = true;
+    trigger;
+    chance;
+    childEmitter;
+    velocityInherit;
+    childrenPerEvent;
+    pendingSpawns = [];
+    constructor(options) {
+        this.trigger = options.trigger;
+        this.chance = options.chance ?? 1;
+        this.childEmitter = options.childEmitter;
+        this.velocityInherit = options.velocityInherit ?? 0.3;
+        this.childrenPerEvent = options.childrenPerEvent ?? 1;
+        if (!Number.isFinite(this.chance) || this.chance < 0 || this.chance > 1) {
+            throw new RangeError("SubEmitterModule chance must be a number in [0, 1].");
+        }
+        if (!Number.isFinite(this.velocityInherit)) {
+            throw new RangeError("SubEmitterModule velocityInherit must be finite.");
+        }
+        if (!Number.isInteger(this.childrenPerEvent) || this.childrenPerEvent <= 0) {
+            throw new RangeError("SubEmitterModule childrenPerEvent must be a positive integer.");
+        }
+    }
+    afterIntegrate(particle, context) {
+        if (this.trigger === "midlife") {
+            if (particle.userData.subEmitted === true) {
+                return;
+            }
+            if (context.normalizedAge < 0.5) {
+                return;
+            }
+            particle.userData.subEmitted = true;
+        }
+        else {
+            if (particle.userData.subDeathEmitted === true) {
+                return;
+            }
+            if (context.normalizedAge < 1 && particle.alive) {
+                return;
+            }
+            particle.userData.subDeathEmitted = true;
+        }
+        if (context.random() < this.chance) {
+            this.pendingSpawns.push({
+                position: cloneVector3(particle.position),
+                velocity: cloneVector3(particle.velocity),
+                count: this.childrenPerEvent,
+            });
+        }
+    }
+    /** Create child particles for queued requests, bounded by capacity. Returns { children, dropped }. */
+    drainPendingSpawns(capacity) {
+        const children = [];
+        let dropped = 0;
+        while (this.pendingSpawns.length > 0) {
+            const request = this.pendingSpawns.shift();
+            for (let index = 0; index < request.count; index += 1) {
+                if (children.length >= capacity) {
+                    dropped += 1;
+                    continue;
+                }
+                children.push(this.createChild(request));
+            }
+        }
+        return { children, dropped };
+    }
+    /** Create child particles for GPU spawn-request flags (parallel to drainPendingSpawns). */
+    createChildren(requests, capacity) {
+        const children = [];
+        let dropped = 0;
+        for (const request of requests) {
+            for (let index = 0; index < request.count; index += 1) {
+                if (children.length >= capacity) {
+                    dropped += 1;
+                    continue;
+                }
+                children.push(this.createChild(request));
+            }
+        }
+        return { children, dropped };
+    }
+    clearPendingSpawns() {
+        this.pendingSpawns.length = 0;
+    }
+    toGPUSubEmitter() {
+        return {
+            triggerAge: this.trigger === "midlife" ? 0.5 : 1,
+            chance: this.chance,
+            childCount: this.childrenPerEvent,
+        };
+    }
+    createChild(request) {
+        const child = this.childEmitter.createParticle();
+        child.position.x = request.position.x;
+        child.position.y = request.position.y;
+        child.position.z = request.position.z;
+        child.previousPosition.x = request.position.x;
+        child.previousPosition.y = request.position.y;
+        child.previousPosition.z = request.position.z;
+        child.velocity.x += request.velocity.x * this.velocityInherit;
+        child.velocity.y += request.velocity.y * this.velocityInherit;
+        child.velocity.z += request.velocity.z * this.velocityInherit;
+        return child;
+    }
+}
+//# sourceMappingURL=SubEmitterModule.js.map

package/dist/effects/SubEmitterModule.js.map

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

package/dist/effects/TrailModule.d.ts

@@ -9,8 +9,46 @@ export interface TrailModuleOptions {
     minDistance?: number;
     lifetime?: number;
 }
+export interface TrailRibbonOptions {
+    /** Half-width of the ribbon at the head. Defaults to 0.02. */
+    readonly width?: number;
+    /** Head stretch along velocity per unit speed. Defaults to 0.06. */
+    readonly stretchFactor?: number;
+    /** Alpha falloff exponent over normalized trail age. Defaults to 1.5. */
+    readonly fadePower?: number;
+}
+export interface TrailRibbonVertex {
+    readonly position: Vector3Like;
+    /** 1 at the head, fading to 0 at the tail. */
+    readonly alpha: number;
+    /** Arc distance from the head. */
+    readonly distance: number;
+    /** Ribbon half-width, tapered head-to-tail for GPU strip builders. */
+    readonly width: number;
+}
+export interface TrailRibbon {
+    readonly vertices: readonly TrailRibbonVertex[];
+    readonly headStretch: number;
+}
+export declare const GPU_TRAIL_RING_MIN_POINTS = 1;
+export declare const GPU_TRAIL_RING_MAX_POINTS = 8;
+/**
+ * Build a velocity-stretched ribbon strip from a CPU trail history. The head
+ * vertex extends along the velocity direction proportionally to speed
+ * (stretch-by-velocity); alpha fades head-to-tail so the ribbon dissolves.
+ */
+export declare function buildTrailRibbon(trail: readonly TrailPoint[], head: Vector3Like, velocity: Vector3Like, lifetime: number, options?: TrailRibbonOptions): TrailRibbon;
+/** Validate the per-particle GPU trail ring depth (1..8 history points). */
+export declare function encodeTrailCaptureDepth(pointsPerParticle: number): number;
+/**
+ * Decode a GPU trail ring buffer (count * depth vec4 entries: xyz position,
+ * w age; newest first) back into CPU trail histories, dropping expired
+ * (age > lifetime) entries the kernel initializes with a large age.
+ */
+export declare function decodeTrailRingBuffer(data: Float32Array, count: number, pointsPerParticle: number, lifetime: number): TrailPoint[][];
 export declare class TrailModule implements ParticleModule {
     readonly name = "TrailModule";
+    readonly supportsGPU = true;
     readonly maxPoints: number;
     readonly minDistance: number;
     readonly lifetime: number;

package/dist/effects/TrailModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TrailModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/TrailModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,kBAAuB;IAU5C,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAIlE,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAoBxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,EAAE;CAU3C"}
+{"version":3,"file":"TrailModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/TrailModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,WAAW,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AASD,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oEAAoE;IACpE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,yEAAyE;IACzE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,SAAS,UAAU,EAAE,EAC5B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CA6Cb;AAED,4EAA4E;AAC5E,wBAAgB,uBAAuB,CAAC,iBAAiB,EAAE,MAAM,GAAG,MAAM,CASzE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,iBAAiB,EAAE,MAAM,EACzB,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,EAAE,CA0BhB;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEd,OAAO,GAAE,kBAAuB;IAU5C,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAIlE,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAoBxE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,EAAE;CAU3C"}

package/dist/effects/TrailModule.js

@@ -5,8 +5,101 @@ function distanceSquared(left, right) {
     const z = left.z - right.z;
     return x * x + y * y + z * z;
 }
+export const GPU_TRAIL_RING_MIN_POINTS = 1;
+export const GPU_TRAIL_RING_MAX_POINTS = 8;
+/**
+ * Build a velocity-stretched ribbon strip from a CPU trail history. The head
+ * vertex extends along the velocity direction proportionally to speed
+ * (stretch-by-velocity); alpha fades head-to-tail so the ribbon dissolves.
+ */
+export function buildTrailRibbon(trail, head, velocity, lifetime, options = {}) {
+    const width = options.width ?? 0.02;
+    const stretchFactor = options.stretchFactor ?? 0.06;
+    const fadePower = options.fadePower ?? 1.5;
+    if (!Number.isFinite(width) || width < 0 || !Number.isFinite(stretchFactor) || stretchFactor < 0) {
+        throw new RangeError("Trail ribbon width and stretchFactor must be finite non-negative numbers.");
+    }
+    if (!Number.isFinite(fadePower) || fadePower <= 0) {
+        throw new RangeError("Trail ribbon fadePower must be a finite positive number.");
+    }
+    if (!Number.isFinite(lifetime) || lifetime <= 0) {
+        throw new RangeError("Trail ribbon lifetime must be a finite positive number.");
+    }
+    const speed = Math.hypot(velocity.x, velocity.y, velocity.z);
+    const headStretch = speed * stretchFactor;
+    const direction = speed > 1e-6
+        ? { x: velocity.x / speed, y: velocity.y / speed, z: velocity.z / speed }
+        : { x: 0, y: 0, z: 0 };
+    const stretchedHead = {
+        x: head.x + direction.x * headStretch,
+        y: head.y + direction.y * headStretch,
+        z: head.z + direction.z * headStretch,
+    };
+    const points = [stretchedHead, ...trail.map((point) => point.position)];
+    const vertices = [];
+    let distance = 0;
+    let previous = stretchedHead;
+    for (let index = 0; index < points.length; index += 1) {
+        const current = points[index];
+        if (index > 0) {
+            distance += Math.hypot(current.x - previous.x, current.y - previous.y, current.z - previous.z);
+            previous = current;
+        }
+        const trailAge = index === 0 ? 0 : Math.min((trail[index - 1]?.age ?? lifetime) / lifetime, 1);
+        const alpha = Math.pow(1 - trailAge, fadePower);
+        vertices.push({
+            position: { ...current },
+            alpha,
+            distance,
+            width: width * (0.25 + 0.75 * alpha),
+        });
+    }
+    return { vertices, headStretch };
+}
+/** Validate the per-particle GPU trail ring depth (1..8 history points). */
+export function encodeTrailCaptureDepth(pointsPerParticle) {
+    if (!Number.isInteger(pointsPerParticle) ||
+        pointsPerParticle < GPU_TRAIL_RING_MIN_POINTS ||
+        pointsPerParticle > GPU_TRAIL_RING_MAX_POINTS) {
+        throw new RangeError(`GPU trail ring depth must be an integer in [${GPU_TRAIL_RING_MIN_POINTS}, ${GPU_TRAIL_RING_MAX_POINTS}].`);
+    }
+    return pointsPerParticle;
+}
+/**
+ * Decode a GPU trail ring buffer (count * depth vec4 entries: xyz position,
+ * w age; newest first) back into CPU trail histories, dropping expired
+ * (age > lifetime) entries the kernel initializes with a large age.
+ */
+export function decodeTrailRingBuffer(data, count, pointsPerParticle, lifetime) {
+    encodeTrailCaptureDepth(pointsPerParticle);
+    if (data.length < count * pointsPerParticle * 4) {
+        throw new RangeError("Trail ring buffer is smaller than count * depth vec4 entries.");
+    }
+    const trails = [];
+    for (let particle = 0; particle < count; particle += 1) {
+        const trail = [];
+        for (let slot = pointsPerParticle - 1; slot >= 0; slot -= 1) {
+            const offset = (particle * pointsPerParticle + slot) * 4;
+            const age = data[offset + 3] ?? Number.POSITIVE_INFINITY;
+            if (!Number.isFinite(age) || age < 0 || age > lifetime) {
+                continue;
+            }
+            trail.push({
+                position: {
+                    x: data[offset] ?? 0,
+                    y: data[offset + 1] ?? 0,
+                    z: data[offset + 2] ?? 0,
+                },
+                age,
+            });
+        }
+        trails.push(trail);
+    }
+    return trails;
+}
 export class TrailModule {
     name = "TrailModule";
+    supportsGPU = true;
     maxPoints;
     minDistance;
     lifetime;
@@ -14,8 +107,8 @@ export class TrailModule {
         this.maxPoints = options.maxPoints ?? 16;
         this.minDistance = options.minDistance ?? 0.05;
         this.lifetime = options.lifetime ?? 0.5;
-        if (this.maxPoints <= 0 || this.minDistance < 0 || this.lifetime <= 0) {
-            throw new RangeError("TrailModule maxPoints and lifetime must be positive, and minDistance must be non-negative.");
+        if (!Number.isInteger(this.maxPoints) || this.maxPoints <= 0 || !Number.isFinite(this.minDistance) || this.minDistance < 0 || !Number.isFinite(this.lifetime) || this.lifetime <= 0) {
+            throw new RangeError("TrailModule maxPoints must be a positive integer, lifetime positive, and minDistance non-negative.");
         }
     }
     onSpawn(particle, _context) {

package/dist/effects/TrailModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"TrailModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/TrailModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAmC,MAAM,eAAe,CAAC;AAc9E,SAAS,eAAe,CAAC,IAAiB,EAAE,KAAkB;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,aAAa,CAAC;IACrB,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,QAAQ,CAAS;IAE1B,YAAY,UAA8B,EAAE;QAC1C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;QAC/C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC;QAExC,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACtE,MAAM,IAAI,UAAU,CAAC,4FAA4F,CAAC,CAAC;QACrH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,QAAkB,EAAE,QAA+B;QACzD,QAAQ,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAwB,CAAC;IAC3G,CAAC;IAED,cAAc,CAAC,QAAkB,EAAE,OAA8B;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,KAAK,CAAC,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;QACjC,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxD,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,IAAI,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACtG,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QAED,OAAO,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACrC,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,QAAkB;QACzB,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAiB,EAAE,CAAC;YAC9B,QAAQ,CAAC,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAqB,CAAC;IAC/B,CAAC;CACF"}
+{"version":3,"file":"TrailModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/TrailModule.ts"],"names":[],"mappings":"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"}

package/dist/effects/TurbulenceModule.d.ts

@@ -0,0 +1,43 @@
+import type { Vector3Like } from "./Particle.js";
+import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
+import type { Particle } from "./Particle.js";
+/**
+ * Curl-noise turbulence for GPU particles (PART A4).
+ *
+ * The field is the analytic curl of a vector potential built from a fixed
+ * sinusoidal scalar potential, sampled through a deterministic 3D lattice
+ * (the "curl-noise LUT"). The CPU fallback trilinear-samples the same LUT
+ * the WGSL compute path uploads, so both paths share one field definition.
+ */
+export declare const TURBULENCE_LUT_RESOLUTION = 8;
+export declare const TURBULENCE_LUT_ENTRIES: number;
+/** Build the deterministic curl-noise LUT: resolution^3 vec4 entries (xyz = curl, w = 0). */
+export declare function createCurlNoiseLUT(resolution?: number): Float32Array;
+/** Trilinear, wrapping sample of a curl-noise LUT at unit-space coordinates. */
+export declare function sampleCurlNoiseLUT(lut: Float32Array, resolution: number, x: number, y: number, z: number, out?: Vector3Like): Vector3Like;
+export interface TurbulenceModuleOptions {
+    readonly strength?: number;
+    readonly scale?: number;
+    readonly flowSpeed?: number;
+    readonly lutResolution?: number;
+}
+export interface GPUTurbulenceParams {
+    readonly strength: number;
+    readonly scale: number;
+    readonly flowSpeed: number;
+    readonly lutResolution: number;
+}
+export declare class TurbulenceModule implements ParticleModule {
+    readonly name = "TurbulenceModule";
+    readonly supportsGPU = true;
+    readonly strength: number;
+    readonly scale: number;
+    readonly flowSpeed: number;
+    readonly lutResolution: number;
+    private cachedLUT;
+    constructor(options?: TurbulenceModuleOptions);
+    getLUT(): Float32Array;
+    update(particle: Particle, context: ParticleUpdateContext): void;
+    toGPUTurbulence(): GPUTurbulenceParams;
+}
+//# sourceMappingURL=TurbulenceModule.d.ts.map

package/dist/effects/TurbulenceModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TurbulenceModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/TurbulenceModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;GAOG;AAEH,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,sBAAsB,QAAiC,CAAC;AA0BrE,6FAA6F;AAC7F,wBAAgB,kBAAkB,CAAC,UAAU,GAAE,MAAkC,GAAG,YAAY,CAkB/F;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,YAAY,EACjB,UAAU,EAAE,MAAM,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,GAAG,GAAE,WAAkC,GACtC,WAAW,CAoCb;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,SAAS,CAA6B;gBAElC,OAAO,GAAE,uBAA4B;IAajD,MAAM,IAAI,YAAY;IAOtB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAchE,eAAe,IAAI,mBAAmB;CAQvC"}

package/dist/effects/TurbulenceModule.js

@@ -0,0 +1,130 @@
+/**
+ * Curl-noise turbulence for GPU particles (PART A4).
+ *
+ * The field is the analytic curl of a vector potential built from a fixed
+ * sinusoidal scalar potential, sampled through a deterministic 3D lattice
+ * (the "curl-noise LUT"). The CPU fallback trilinear-samples the same LUT
+ * the WGSL compute path uploads, so both paths share one field definition.
+ */
+export const TURBULENCE_LUT_RESOLUTION = 8;
+export const TURBULENCE_LUT_ENTRIES = TURBULENCE_LUT_RESOLUTION ** 3;
+function scalarPotentialU(u, v) {
+    const a1u = 1.6 * u;
+    const b1v = 1.3 * v;
+    const a2u = 3.1 * u + 1.7;
+    const b2v = 2.7 * v + 0.6;
+    return {
+        value: Math.sin(a1u) * Math.cos(b1v) + 0.35 * Math.sin(a2u) * Math.cos(b2v),
+        du: 1.6 * Math.cos(a1u) * Math.cos(b1v) + 0.35 * 3.1 * Math.cos(a2u) * Math.cos(b2v),
+        dv: -1.3 * Math.sin(a1u) * Math.sin(b1v) - 0.35 * 2.7 * Math.sin(a2u) * Math.sin(b2v),
+    };
+}
+function curlAt(x, y, z) {
+    // A(p) = (f(y,z), f(z,x), f(x,y)); V = curl(A).
+    const fyz = scalarPotentialU(y, z);
+    const fzx = scalarPotentialU(z, x);
+    const fxy = scalarPotentialU(x, y);
+    return {
+        x: fzx.du - fxy.dv,
+        y: fxy.du - fyz.dv,
+        z: fyz.du - fzx.dv,
+    };
+}
+/** Build the deterministic curl-noise LUT: resolution^3 vec4 entries (xyz = curl, w = 0). */
+export function createCurlNoiseLUT(resolution = TURBULENCE_LUT_RESOLUTION) {
+    if (!Number.isInteger(resolution) || resolution < 2 || resolution > 32) {
+        throw new RangeError("Curl-noise LUT resolution must be an integer in [2, 32].");
+    }
+    const lut = new Float32Array(resolution ** 3 * 4);
+    for (let z = 0; z < resolution; z += 1) {
+        for (let y = 0; y < resolution; y += 1) {
+            for (let x = 0; x < resolution; x += 1) {
+                const curl = curlAt((x + 0.5) / resolution, (y + 0.5) / resolution, (z + 0.5) / resolution);
+                const offset = (x + y * resolution + z * resolution * resolution) * 4;
+                lut[offset] = curl.x;
+                lut[offset + 1] = curl.y;
+                lut[offset + 2] = curl.z;
+                lut[offset + 3] = 0;
+            }
+        }
+    }
+    return lut;
+}
+/** Trilinear, wrapping sample of a curl-noise LUT at unit-space coordinates. */
+export function sampleCurlNoiseLUT(lut, resolution, x, y, z, out = { x: 0, y: 0, z: 0 }) {
+    if (lut.length < resolution ** 3 * 4) {
+        throw new RangeError("Curl-noise LUT buffer is smaller than resolution^3 vec4 entries.");
+    }
+    const gx = (x - Math.floor(x)) * resolution - 0.5;
+    const gy = (y - Math.floor(y)) * resolution - 0.5;
+    const gz = (z - Math.floor(z)) * resolution - 0.5;
+    const x0 = Math.floor(gx);
+    const y0 = Math.floor(gy);
+    const z0 = Math.floor(gz);
+    const fx = gx - x0;
+    const fy = gy - y0;
+    const fz = gz - z0;
+    let rx = 0;
+    let ry = 0;
+    let rz = 0;
+    for (let dz = 0; dz <= 1; dz += 1) {
+        for (let dy = 0; dy <= 1; dy += 1) {
+            for (let dx = 0; dx <= 1; dx += 1) {
+                const weight = (dx === 0 ? 1 - fx : fx) * (dy === 0 ? 1 - fy : fy) * (dz === 0 ? 1 - fz : fz);
+                const ix = (((x0 + dx) % resolution) + resolution) % resolution;
+                const iy = (((y0 + dy) % resolution) + resolution) % resolution;
+                const iz = (((z0 + dz) % resolution) + resolution) % resolution;
+                const offset = (ix + iy * resolution + iz * resolution * resolution) * 4;
+                rx += (lut[offset] ?? 0) * weight;
+                ry += (lut[offset + 1] ?? 0) * weight;
+                rz += (lut[offset + 2] ?? 0) * weight;
+            }
+        }
+    }
+    out.x = rx;
+    out.y = ry;
+    out.z = rz;
+    return out;
+}
+export class TurbulenceModule {
+    name = "TurbulenceModule";
+    supportsGPU = true;
+    strength;
+    scale;
+    flowSpeed;
+    lutResolution;
+    cachedLUT = null;
+    constructor(options = {}) {
+        this.strength = options.strength ?? 0.6;
+        this.scale = options.scale ?? 0.8;
+        this.flowSpeed = options.flowSpeed ?? 0.15;
+        this.lutResolution = options.lutResolution ?? TURBULENCE_LUT_RESOLUTION;
+        if (!Number.isFinite(this.strength) || !Number.isFinite(this.scale) || !Number.isFinite(this.flowSpeed)) {
+            throw new RangeError("TurbulenceModule strength, scale, and flowSpeed must be finite numbers.");
+        }
+        if (!Number.isInteger(this.lutResolution) || this.lutResolution < 2 || this.lutResolution > 32) {
+            throw new RangeError("TurbulenceModule lutResolution must be an integer in [2, 32].");
+        }
+    }
+    getLUT() {
+        if (!this.cachedLUT) {
+            this.cachedLUT = createCurlNoiseLUT(this.lutResolution);
+        }
+        return this.cachedLUT;
+    }
+    update(particle, context) {
+        const scratch = sampleCurlNoiseLUT(this.getLUT(), this.lutResolution, particle.position.x * this.scale + context.elapsedTime * this.flowSpeed, particle.position.y * this.scale, particle.position.z * this.scale, { x: 0, y: 0, z: 0 });
+        particle.velocity.x += scratch.x * this.strength * context.deltaTime;
+        particle.velocity.y += scratch.y * this.strength * context.deltaTime;
+        particle.velocity.z += scratch.z * this.strength * context.deltaTime;
+    }
+    toGPUTurbulence() {
+        return {
+            strength: this.strength,
+            scale: this.scale,
+            flowSpeed: this.flowSpeed,
+            lutResolution: this.lutResolution,
+        };
+    }
+}
+//# sourceMappingURL=TurbulenceModule.js.map

package/dist/effects/TurbulenceModule.js.map

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

package/dist/effects/index.d.ts

@@ -7,6 +7,10 @@ export * from "./SizeModule.js";
 export * from "./ForceModule.js";
 export * from "./CollisionModule.js";
 export * from "./TrailModule.js";
+export * from "./TurbulenceModule.js";
+export * from "./HeightfieldModule.js";
+export * from "./LightingModule.js";
+export * from "./SubEmitterModule.js";
 export * from "./ParticleRenderer.js";
 export * from "./ParticleRenderPass.js";
 export * from "./GPUParticleBackend.js";