@aura3d/rendering 1.0.6

package/dist/effects/ParticleSystem.js

@@ -0,0 +1,261 @@
+import { addScaledVector3, normalizedParticleAge, setVector3, } from "./Particle.js";
+import { ParticleEmitter } from "./ParticleEmitter.js";
+import { applyParticleModules } from "./ParticleModule.js";
+export class ParticleSystem {
+    particles = [];
+    emitters = [];
+    modules = [];
+    maxParticles;
+    elapsedTime = 0;
+    paused = false;
+    stats;
+    gpuBackend;
+    preferGPU;
+    constructor(options = {}) {
+        this.maxParticles = options.maxParticles ?? 1000;
+        if (!Number.isInteger(this.maxParticles) || this.maxParticles <= 0) {
+            throw new RangeError("ParticleSystem maxParticles must be a positive integer.");
+        }
+        this.emitters.push(...(options.emitters ?? []));
+        this.modules.push(...(options.modules ?? []));
+        this.gpuBackend = options.gpuBackend;
+        this.preferGPU = options.preferGPU ?? options.gpuBackend !== undefined;
+        this.stats = {
+            liveCount: 0,
+            capacity: this.maxParticles,
+            spawnedCount: 0,
+            killedCount: 0,
+            droppedCount: 0,
+            bufferUploads: 0,
+            uploadedBytes: 0,
+            gpuSpawns: 0,
+            gpuUpdates: 0,
+        };
+    }
+    addEmitter(emitter) {
+        this.emitters.push(emitter);
+        return this;
+    }
+    addModule(module) {
+        this.modules.push(module);
+        return this;
+    }
+    setGPUBackend(backend, preferGPU = backend !== undefined) {
+        this.gpuBackend = backend;
+        this.preferGPU = preferGPU;
+        return this;
+    }
+    clear() {
+        this.stats.killedCount += this.particles.length;
+        this.particles.length = 0;
+        this.stats.liveCount = 0;
+    }
+    dispose() {
+        this.clear();
+        this.emitters.length = 0;
+        this.modules.length = 0;
+        this.paused = true;
+    }
+    update(deltaTime) {
+        if (!Number.isFinite(deltaTime) || deltaTime < 0) {
+            throw new RangeError("ParticleSystem.update deltaTime must be a finite non-negative number.");
+        }
+        if (this.paused || deltaTime === 0) {
+            return;
+        }
+        this.spawn(deltaTime);
+        this.integrate(deltaTime);
+        this.compactDeadParticles();
+        this.elapsedTime += deltaTime;
+        this.stats.liveCount = this.particles.length;
+    }
+    async updateOnGPU(deltaTime, backend) {
+        if (!Number.isFinite(deltaTime) || deltaTime < 0) {
+            throw new RangeError("ParticleSystem.updateOnGPU deltaTime must be a finite non-negative number.");
+        }
+        if (this.paused || deltaTime === 0) {
+            return;
+        }
+        const spawnedParticles = this.spawn(deltaTime);
+        await this.initializeSpawnedOnGPU(spawnedParticles, backend);
+        await this.integrateOnGPU(deltaTime, backend);
+        this.compactDeadParticles();
+        this.elapsedTime += deltaTime;
+        this.stats.liveCount = this.particles.length;
+    }
+    async updateBest(deltaTime) {
+        if (this.preferGPU && this.gpuBackend?.capabilities.supported) {
+            await this.updateOnGPU(deltaTime, this.gpuBackend);
+            return "gpu";
+        }
+        this.update(deltaTime);
+        return "cpu";
+    }
+    getStats() {
+        return { ...this.stats, liveCount: this.particles.length };
+    }
+    recordBufferUpload(bytes) {
+        if (!Number.isFinite(bytes) || bytes < 0) {
+            throw new RangeError("ParticleSystem buffer upload bytes must be a finite non-negative number.");
+        }
+        this.stats.bufferUploads += 1;
+        this.stats.uploadedBytes += bytes;
+    }
+    spawn(deltaTime) {
+        const spawnedParticles = [];
+        for (const emitter of this.emitters) {
+            const capacity = this.maxParticles - this.particles.length;
+            const result = emitter.emit(deltaTime, capacity);
+            this.stats.droppedCount += Math.max(0, result.requested - result.emitted);
+            this.stats.spawnedCount += result.emitted;
+            for (const particle of result.particles) {
+                const context = this.createContext(deltaTime, particle);
+                applyParticleModules(this.modules, "onSpawn", particle, context);
+                this.particles.push(particle);
+                spawnedParticles.push(particle);
+            }
+        }
+        return spawnedParticles;
+    }
+    async initializeSpawnedOnGPU(spawnedParticles, backend) {
+        if (!backend.spawn || spawnedParticles.length === 0) {
+            return;
+        }
+        const positions = new Float32Array(spawnedParticles.length * 4);
+        const velocities = new Float32Array(spawnedParticles.length * 4);
+        const accelerations = new Float32Array(spawnedParticles.length * 4);
+        for (let index = 0; index < spawnedParticles.length; index += 1) {
+            const particle = spawnedParticles[index];
+            const offset = index * 4;
+            positions[offset] = particle.position.x;
+            positions[offset + 1] = particle.position.y;
+            positions[offset + 2] = particle.position.z;
+            positions[offset + 3] = particle.age;
+            velocities[offset] = particle.velocity.x;
+            velocities[offset + 1] = particle.velocity.y;
+            velocities[offset + 2] = particle.velocity.z;
+            accelerations[offset] = particle.acceleration.x;
+            accelerations[offset + 1] = particle.acceleration.y;
+            accelerations[offset + 2] = particle.acceleration.z;
+        }
+        const result = await backend.spawn({
+            positions,
+            velocities,
+            accelerations,
+            count: spawnedParticles.length,
+        });
+        for (let index = 0; index < spawnedParticles.length; index += 1) {
+            const particle = spawnedParticles[index];
+            const offset = index * 4;
+            particle.position.x = result.positions[offset];
+            particle.position.y = result.positions[offset + 1];
+            particle.position.z = result.positions[offset + 2];
+            particle.age = result.positions[offset + 3];
+            setVector3(particle.previousPosition, particle.position);
+            particle.velocity.x = result.velocities[offset];
+            particle.velocity.y = result.velocities[offset + 1];
+            particle.velocity.z = result.velocities[offset + 2];
+            particle.acceleration.x = result.accelerations[offset];
+            particle.acceleration.y = result.accelerations[offset + 1];
+            particle.acceleration.z = result.accelerations[offset + 2];
+        }
+        this.stats.gpuSpawns += 1;
+        this.recordBufferUpload(positions.byteLength + velocities.byteLength + accelerations.byteLength + 16);
+    }
+    integrate(deltaTime) {
+        for (const particle of this.particles) {
+            if (!particle.alive) {
+                continue;
+            }
+            const context = this.createContext(deltaTime, particle);
+            applyParticleModules(this.modules, "update", particle, context);
+            setVector3(particle.previousPosition, particle.position);
+            addScaledVector3(particle.velocity, particle.acceleration, deltaTime);
+            addScaledVector3(particle.position, particle.velocity, deltaTime);
+            particle.rotation += particle.angularVelocity * deltaTime;
+            particle.age += deltaTime;
+            applyParticleModules(this.modules, "afterIntegrate", particle, this.createContext(deltaTime, particle));
+            if (particle.age >= particle.lifetime) {
+                particle.alive = false;
+            }
+        }
+    }
+    async integrateOnGPU(deltaTime, backend) {
+        const liveParticles = this.particles.filter((particle) => particle.alive);
+        if (liveParticles.length === 0) {
+            return;
+        }
+        for (const particle of liveParticles) {
+            const context = this.createContext(deltaTime, particle);
+            applyParticleModules(this.modules, "update", particle, context);
+            setVector3(particle.previousPosition, particle.position);
+        }
+        const positions = new Float32Array(liveParticles.length * 4);
+        const velocities = new Float32Array(liveParticles.length * 4);
+        const accelerations = new Float32Array(liveParticles.length * 4);
+        for (let index = 0; index < liveParticles.length; index += 1) {
+            const particle = liveParticles[index];
+            const offset = index * 4;
+            positions[offset] = particle.position.x;
+            positions[offset + 1] = particle.position.y;
+            positions[offset + 2] = particle.position.z;
+            positions[offset + 3] = particle.age;
+            velocities[offset] = particle.velocity.x;
+            velocities[offset + 1] = particle.velocity.y;
+            velocities[offset + 2] = particle.velocity.z;
+            accelerations[offset] = particle.acceleration.x;
+            accelerations[offset + 1] = particle.acceleration.y;
+            accelerations[offset + 2] = particle.acceleration.z;
+        }
+        const result = await backend.update({
+            positions,
+            velocities,
+            accelerations,
+            deltaTime,
+            count: liveParticles.length,
+        });
+        for (let index = 0; index < liveParticles.length; index += 1) {
+            const particle = liveParticles[index];
+            const offset = index * 4;
+            particle.position.x = result.positions[offset];
+            particle.position.y = result.positions[offset + 1];
+            particle.position.z = result.positions[offset + 2];
+            particle.age = result.positions[offset + 3];
+            particle.velocity.x = result.velocities[offset];
+            particle.velocity.y = result.velocities[offset + 1];
+            particle.velocity.z = result.velocities[offset + 2];
+            particle.rotation += particle.angularVelocity * deltaTime;
+            applyParticleModules(this.modules, "afterIntegrate", particle, this.createContext(deltaTime, particle));
+            if (particle.age >= particle.lifetime) {
+                particle.alive = false;
+            }
+        }
+        this.stats.gpuUpdates += 1;
+        this.recordBufferUpload(positions.byteLength + velocities.byteLength + accelerations.byteLength + 16);
+    }
+    compactDeadParticles() {
+        let write = 0;
+        let killed = 0;
+        for (let read = 0; read < this.particles.length; read += 1) {
+            const particle = this.particles[read];
+            if (particle.alive) {
+                this.particles[write] = particle;
+                write += 1;
+            }
+            else {
+                killed += 1;
+            }
+        }
+        this.particles.length = write;
+        this.stats.killedCount += killed;
+    }
+    createContext(deltaTime, particle) {
+        return {
+            deltaTime,
+            elapsedTime: this.elapsedTime,
+            normalizedAge: normalizedParticleAge(particle),
+            random: this.emitters[0]?.random ?? Math.random,
+        };
+    }
+}
+//# sourceMappingURL=ParticleSystem.js.map

package/dist/effects/ParticleSystem.js.map

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

package/dist/effects/SizeModule.d.ts

@@ -0,0 +1,14 @@
+import type { Particle } from "./Particle.js";
+import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
+export interface SizeKeyframe {
+    time: number;
+    size: number;
+}
+export declare function sampleSizeCurve(keyframes: readonly SizeKeyframe[], time: number): number;
+export declare class SizeModule implements ParticleModule {
+    readonly name = "SizeModule";
+    readonly curve: readonly SizeKeyframe[];
+    constructor(curve: readonly SizeKeyframe[]);
+    update(particle: Particle, context: ParticleUpdateContext): void;
+}
+//# sourceMappingURL=SizeModule.d.ts.map

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

@@ -0,0 +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"}

package/dist/effects/SizeModule.js

@@ -0,0 +1,42 @@
+function validateCurve(keyframes) {
+    if (keyframes.length === 0) {
+        throw new RangeError("SizeModule requires at least one size keyframe.");
+    }
+    let previous = -Number.POSITIVE_INFINITY;
+    for (const keyframe of keyframes) {
+        if (keyframe.time < 0 || keyframe.time > 1 || keyframe.time < previous) {
+            throw new RangeError("SizeModule keyframe times must be sorted in the normalized range [0, 1].");
+        }
+        if (!Number.isFinite(keyframe.size) || keyframe.size < 0) {
+            throw new RangeError("SizeModule keyframe sizes must be finite non-negative numbers.");
+        }
+        previous = keyframe.time;
+    }
+}
+export function sampleSizeCurve(keyframes, time) {
+    if (time <= keyframes[0].time) {
+        return keyframes[0].size;
+    }
+    for (let index = 1; index < keyframes.length; index += 1) {
+        const next = keyframes[index];
+        if (time <= next.time) {
+            const previous = keyframes[index - 1];
+            const span = next.time - previous.time || 1;
+            const alpha = (time - previous.time) / span;
+            return previous.size + (next.size - previous.size) * alpha;
+        }
+    }
+    return keyframes[keyframes.length - 1].size;
+}
+export class SizeModule {
+    name = "SizeModule";
+    curve;
+    constructor(curve) {
+        this.curve = curve;
+        validateCurve(curve);
+    }
+    update(particle, context) {
+        particle.size = sampleSizeCurve(this.curve, context.normalizedAge);
+    }
+}
+//# sourceMappingURL=SizeModule.js.map

package/dist/effects/SizeModule.js.map

@@ -0,0 +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"}

package/dist/effects/TrailModule.d.ts

@@ -0,0 +1,22 @@
+import { type Particle, type Vector3Like } from "./Particle.js";
+import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
+export interface TrailPoint {
+    position: Vector3Like;
+    age: number;
+}
+export interface TrailModuleOptions {
+    maxPoints?: number;
+    minDistance?: number;
+    lifetime?: number;
+}
+export declare class TrailModule implements ParticleModule {
+    readonly name = "TrailModule";
+    readonly maxPoints: number;
+    readonly minDistance: number;
+    readonly lifetime: number;
+    constructor(options?: TrailModuleOptions);
+    onSpawn(particle: Particle, _context: ParticleUpdateContext): void;
+    afterIntegrate(particle: Particle, context: ParticleUpdateContext): void;
+    getTrail(particle: Particle): TrailPoint[];
+}
+//# sourceMappingURL=TrailModule.d.ts.map

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

@@ -0,0 +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"}

package/dist/effects/TrailModule.js

@@ -0,0 +1,50 @@
+import { cloneVector3 } from "./Particle.js";
+function distanceSquared(left, right) {
+    const x = left.x - right.x;
+    const y = left.y - right.y;
+    const z = left.z - right.z;
+    return x * x + y * y + z * z;
+}
+export class TrailModule {
+    name = "TrailModule";
+    maxPoints;
+    minDistance;
+    lifetime;
+    constructor(options = {}) {
+        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.");
+        }
+    }
+    onSpawn(particle, _context) {
+        particle.userData.trail = [{ position: cloneVector3(particle.position), age: 0 }];
+    }
+    afterIntegrate(particle, context) {
+        const trail = this.getTrail(particle);
+        for (const point of trail) {
+            point.age += context.deltaTime;
+        }
+        while (trail.length > 0 && trail[0].age > this.lifetime) {
+            trail.shift();
+        }
+        const last = trail[trail.length - 1];
+        if (!last || distanceSquared(last.position, particle.position) >= this.minDistance * this.minDistance) {
+            trail.push({ position: cloneVector3(particle.position), age: 0 });
+        }
+        while (trail.length > this.maxPoints) {
+            trail.shift();
+        }
+    }
+    getTrail(particle) {
+        const trail = particle.userData.trail;
+        if (!Array.isArray(trail)) {
+            const next = [];
+            particle.userData.trail = next;
+            return next;
+        }
+        return trail;
+    }
+}
+//# sourceMappingURL=TrailModule.js.map

package/dist/effects/TrailModule.js.map

@@ -0,0 +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"}

package/dist/effects/VelocityModule.d.ts

@@ -0,0 +1,15 @@
+import type { ParticleModule, ParticleUpdateContext } from "./ParticleModule.js";
+import type { Particle, Vector3Like } from "./Particle.js";
+export interface VectorKeyframe {
+    time: number;
+    value: Vector3Like;
+}
+export declare class VelocityModule implements ParticleModule {
+    readonly name = "VelocityModule";
+    readonly keyframes: readonly VectorKeyframe[];
+    readonly mode: "replace" | "add";
+    constructor(keyframes: readonly VectorKeyframe[], mode?: "replace" | "add");
+    update(particle: Particle, context: ParticleUpdateContext): void;
+}
+export declare function constantVelocity(value: Vector3Like, mode?: "replace" | "add"): VelocityModule;
+//# sourceMappingURL=VelocityModule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VelocityModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/VelocityModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB;AAuCD,qBAAa,cAAe,YAAW,cAAc;IACnD,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC;gBAErB,SAAS,EAAE,SAAS,cAAc,EAAE,EAAE,IAAI,GAAE,SAAS,GAAG,KAAiB;IAMrF,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;CAcjE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,SAAS,GAAG,KAAiB,GAAG,cAAc,CAExG"}

package/dist/effects/VelocityModule.js

@@ -0,0 +1,57 @@
+function validateKeyframes(keyframes) {
+    if (keyframes.length === 0) {
+        throw new RangeError("VelocityModule requires at least one keyframe.");
+    }
+    let previous = -Number.POSITIVE_INFINITY;
+    for (const keyframe of keyframes) {
+        if (keyframe.time < 0 || keyframe.time > 1 || keyframe.time < previous) {
+            throw new RangeError("VelocityModule keyframe times must be sorted in the normalized range [0, 1].");
+        }
+        previous = keyframe.time;
+    }
+}
+function sampleVectorKeyframes(keyframes, time) {
+    if (time <= keyframes[0].time) {
+        return { ...keyframes[0].value };
+    }
+    for (let index = 1; index < keyframes.length; index += 1) {
+        const next = keyframes[index];
+        if (time <= next.time) {
+            const previous = keyframes[index - 1];
+            const span = next.time - previous.time || 1;
+            const alpha = (time - previous.time) / span;
+            return {
+                x: previous.value.x + (next.value.x - previous.value.x) * alpha,
+                y: previous.value.y + (next.value.y - previous.value.y) * alpha,
+                z: previous.value.z + (next.value.z - previous.value.z) * alpha,
+            };
+        }
+    }
+    return { ...keyframes[keyframes.length - 1].value };
+}
+export class VelocityModule {
+    name = "VelocityModule";
+    keyframes;
+    mode;
+    constructor(keyframes, mode = "replace") {
+        this.keyframes = keyframes;
+        this.mode = mode;
+        validateKeyframes(keyframes);
+    }
+    update(particle, context) {
+        const velocity = sampleVectorKeyframes(this.keyframes, context.normalizedAge);
+        if (this.mode === "add") {
+            particle.velocity.x += velocity.x;
+            particle.velocity.y += velocity.y;
+            particle.velocity.z += velocity.z;
+            return;
+        }
+        particle.velocity.x = velocity.x;
+        particle.velocity.y = velocity.y;
+        particle.velocity.z = velocity.z;
+    }
+}
+export function constantVelocity(value, mode = "replace") {
+    return new VelocityModule([{ time: 0, value }], mode);
+}
+//# sourceMappingURL=VelocityModule.js.map

package/dist/effects/VelocityModule.js.map

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

package/dist/effects/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./Particle.js";
+export * from "./ParticleEmitter.js";
+export * from "./ParticleModule.js";
+export * from "./VelocityModule.js";
+export * from "./ColorModule.js";
+export * from "./SizeModule.js";
+export * from "./ForceModule.js";
+export * from "./CollisionModule.js";
+export * from "./TrailModule.js";
+export * from "./ParticleRenderer.js";
+export * from "./ParticleRenderPass.js";
+export * from "./GPUParticleBackend.js";
+export * from "./ParticleSystem.js";
+export * from "./ParticleEffectPresets.js";
+export * from "./ParticleDiagnostics.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC"}

package/dist/effects/index.js

@@ -0,0 +1,16 @@
+export * from "./Particle.js";
+export * from "./ParticleEmitter.js";
+export * from "./ParticleModule.js";
+export * from "./VelocityModule.js";
+export * from "./ColorModule.js";
+export * from "./SizeModule.js";
+export * from "./ForceModule.js";
+export * from "./CollisionModule.js";
+export * from "./TrailModule.js";
+export * from "./ParticleRenderer.js";
+export * from "./ParticleRenderPass.js";
+export * from "./GPUParticleBackend.js";
+export * from "./ParticleSystem.js";
+export * from "./ParticleEffectPresets.js";
+export * from "./ParticleDiagnostics.js";
+//# sourceMappingURL=index.js.map

package/dist/effects/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC"}