@aura3d/engine 1.0.0

package/dist/rendering/effects/ParticleEmitter.js

@@ -0,0 +1,254 @@
+import { createParticle } from "./Particle.js";
+function seededRandom(seed) {
+    let state = seed >>> 0;
+    return () => {
+        state += 0x6d2b79f5;
+        let mixed = state;
+        mixed = Math.imul(mixed ^ (mixed >>> 15), mixed | 1);
+        mixed ^= mixed + Math.imul(mixed ^ (mixed >>> 7), mixed | 61);
+        return ((mixed ^ (mixed >>> 14)) >>> 0) / 4294967296;
+    };
+}
+function validateRange(name, value) {
+    if (typeof value === "number") {
+        if (!Number.isFinite(value) || value < 0) {
+            throw new RangeError(`${name} must be a finite non-negative number.`);
+        }
+        return;
+    }
+    if (!Number.isFinite(value.min) || !Number.isFinite(value.max) || value.min < 0 || value.max < value.min) {
+        throw new RangeError(`${name} range must be finite and ordered.`);
+    }
+}
+function sampleRange(value, random) {
+    return typeof value === "number" ? value : value.min + (value.max - value.min) * random();
+}
+function vector(value = {}) {
+    return { x: value.x ?? 0, y: value.y ?? 0, z: value.z ?? 0 };
+}
+function randomUnitVector(random) {
+    const z = random() * 2 - 1;
+    const angle = random() * Math.PI * 2;
+    const radius = Math.sqrt(Math.max(0, 1 - z * z));
+    return {
+        x: Math.cos(angle) * radius,
+        y: Math.sin(angle) * radius,
+        z,
+    };
+}
+function sampleShape(shape, random) {
+    if (shape.type === "point") {
+        return { position: vector(shape.position) };
+    }
+    if (shape.type === "box") {
+        const center = vector(shape.center);
+        return {
+            position: {
+                x: center.x + (random() - 0.5) * (shape.size.x ?? 0),
+                y: center.y + (random() - 0.5) * (shape.size.y ?? 0),
+                z: center.z + (random() - 0.5) * (shape.size.z ?? 0),
+            }
+        };
+    }
+    if (shape.type === "circle") {
+        const center = vector(shape.center);
+        const arc = shape.arc ?? Math.PI * 2;
+        const angle = random() * arc;
+        const radius = shape.radius * (shape.filled ? Math.sqrt(random()) : 1);
+        return {
+            position: {
+                x: center.x + Math.cos(angle) * radius,
+                y: center.y,
+                z: center.z + Math.sin(angle) * radius,
+            },
+            direction: { x: Math.cos(angle), y: 0, z: Math.sin(angle) }
+        };
+    }
+    if (shape.type === "cone") {
+        const origin = vector(shape.origin);
+        const axial = shape.length * (shape.emitFromVolume ? random() : 1);
+        const radiusAtAxial = shape.radius * (shape.emitFromVolume ? axial / shape.length : 1);
+        const angle = random() * Math.PI * 2;
+        const radial = radiusAtAxial * (shape.emitFromVolume ? Math.sqrt(random()) : 1);
+        const direction = sampleConeDirection(shape, random);
+        return {
+            position: {
+                x: origin.x + Math.cos(angle) * radial,
+                y: origin.y + axial,
+                z: origin.z + Math.sin(angle) * radial,
+            },
+            direction
+        };
+    }
+    const center = vector(shape.center);
+    const direction = randomUnitVector(random);
+    const radius = shape.radius * (shape.shell ? 1 : Math.cbrt(random()));
+    return {
+        position: {
+            x: center.x + direction.x * radius,
+            y: center.y + direction.y * radius,
+            z: center.z + direction.z * radius,
+        },
+        direction
+    };
+}
+function sampleConeDirection(shape, random) {
+    const maxAngle = shape.angle ?? Math.atan2(shape.radius, shape.length);
+    const theta = random() * Math.PI * 2;
+    const spread = Math.tan(maxAngle) * Math.sqrt(random());
+    return normalize({
+        x: Math.cos(theta) * spread,
+        y: 1,
+        z: Math.sin(theta) * spread
+    });
+}
+function normalize(value) {
+    const length = Math.hypot(value.x, value.y, value.z) || 1;
+    return { x: value.x / length, y: value.y / length, z: value.z / length };
+}
+function validateShape(shape) {
+    if (shape.type === "sphere" && (!Number.isFinite(shape.radius) || shape.radius < 0)) {
+        throw new RangeError("Particle sphere radius must be a finite non-negative number.");
+    }
+    if (shape.type === "circle") {
+        if (!Number.isFinite(shape.radius) || shape.radius < 0)
+            throw new RangeError("Particle circle radius must be a finite non-negative number.");
+        if (shape.arc !== undefined && (!Number.isFinite(shape.arc) || shape.arc <= 0 || shape.arc > Math.PI * 2)) {
+            throw new RangeError("Particle circle arc must be in the range (0, 2pi].");
+        }
+    }
+    if (shape.type === "cone") {
+        if (!Number.isFinite(shape.radius) || shape.radius < 0)
+            throw new RangeError("Particle cone radius must be a finite non-negative number.");
+        if (!Number.isFinite(shape.length) || shape.length <= 0)
+            throw new RangeError("Particle cone length must be a finite positive number.");
+        if (shape.angle !== undefined && (!Number.isFinite(shape.angle) || shape.angle <= 0 || shape.angle >= Math.PI / 2)) {
+            throw new RangeError("Particle cone angle must be in the range (0, pi/2).");
+        }
+    }
+}
+export class ParticleEmitter {
+    random;
+    maxParticles;
+    bursts;
+    emissionRate;
+    duration;
+    looping;
+    lifetime;
+    speed;
+    shape;
+    initial;
+    elapsedTime = 0;
+    paused = false;
+    emissionCarry = 0;
+    nextParticleId = 1;
+    burstExecutions;
+    constructor(options = {}) {
+        this.random = seededRandom(options.seed ?? 1);
+        this.emissionRate = options.emissionRate ?? 10;
+        this.maxParticles = options.maxParticles ?? Number.POSITIVE_INFINITY;
+        this.duration = options.duration ?? Number.POSITIVE_INFINITY;
+        this.looping = options.looping ?? false;
+        this.lifetime = options.lifetime ?? 1;
+        this.speed = options.speed ?? 0;
+        this.shape = options.shape ?? { type: "point" };
+        this.bursts = options.bursts ?? [];
+        this.initial = options.initial ?? {};
+        this.burstExecutions = this.bursts.map(() => 0);
+        validateShape(this.shape);
+        if (!Number.isFinite(this.emissionRate) || this.emissionRate < 0) {
+            throw new RangeError("Particle emissionRate must be a finite non-negative number.");
+        }
+        if (!Number.isFinite(this.duration) && this.duration !== Number.POSITIVE_INFINITY) {
+            throw new RangeError("Particle duration must be finite or positive infinity.");
+        }
+        if (this.duration <= 0) {
+            throw new RangeError("Particle duration must be greater than zero.");
+        }
+        validateRange("Particle lifetime", this.lifetime);
+        validateRange("Particle speed", this.speed);
+    }
+    reset() {
+        this.elapsedTime = 0;
+        this.emissionCarry = 0;
+        this.nextParticleId = 1;
+        this.burstExecutions = this.bursts.map(() => 0);
+        this.paused = false;
+    }
+    emit(deltaTime, capacity = Number.POSITIVE_INFINITY) {
+        if (!Number.isFinite(deltaTime) || deltaTime < 0) {
+            throw new RangeError("ParticleEmitter.emit deltaTime must be a finite non-negative number.");
+        }
+        if (this.paused || capacity <= 0) {
+            return { particles: [], requested: 0, emitted: 0 };
+        }
+        const previousTime = this.elapsedTime;
+        this.elapsedTime = this.advanceTime(deltaTime);
+        const requested = this.countContinuous(deltaTime, previousTime) + this.countBursts(previousTime, this.elapsedTime);
+        const capped = Math.max(0, Math.min(requested, capacity, this.maxParticles));
+        const particles = [];
+        for (let index = 0; index < capped; index += 1) {
+            particles.push(this.createParticle());
+        }
+        return { particles, requested, emitted: particles.length };
+    }
+    createParticle() {
+        const emitted = sampleShape(this.shape, this.random);
+        const position = emitted.position;
+        const direction = emitted.direction ?? randomUnitVector(this.random);
+        const speed = sampleRange(this.speed, this.random);
+        return createParticle({
+            ...this.initial,
+            id: this.nextParticleId++,
+            age: 0,
+            lifetime: sampleRange(this.lifetime, this.random),
+            position,
+            velocity: {
+                x: direction.x * speed,
+                y: direction.y * speed,
+                z: direction.z * speed,
+            },
+        });
+    }
+    advanceTime(deltaTime) {
+        if (!Number.isFinite(this.duration)) {
+            return this.elapsedTime + deltaTime;
+        }
+        const next = this.elapsedTime + deltaTime;
+        return this.looping ? next % this.duration : Math.min(next, this.duration);
+    }
+    countContinuous(deltaTime, previousTime) {
+        if (previousTime >= this.duration && !this.looping) {
+            return 0;
+        }
+        const activeDelta = Number.isFinite(this.duration) && !this.looping ? Math.min(deltaTime, this.duration - previousTime) : deltaTime;
+        this.emissionCarry += this.emissionRate * Math.max(0, activeDelta);
+        const count = Math.floor(this.emissionCarry);
+        this.emissionCarry -= count;
+        return count;
+    }
+    countBursts(previousTime, currentTime) {
+        let count = 0;
+        for (let index = 0; index < this.bursts.length; index += 1) {
+            const burst = this.bursts[index];
+            if (burst.count < 0 || burst.time < 0) {
+                throw new RangeError("Particle burst time and count must be non-negative.");
+            }
+            const cycles = burst.cycles ?? 1;
+            const interval = burst.interval ?? 0;
+            let executions = this.burstExecutions[index] ?? 0;
+            while (executions < cycles) {
+                const triggerTime = burst.time + interval * executions;
+                const crossed = (triggerTime === 0 && previousTime === 0) || (triggerTime > previousTime && triggerTime <= currentTime);
+                if (!crossed) {
+                    break;
+                }
+                count += burst.count;
+                executions += 1;
+            }
+            this.burstExecutions[index] = executions;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=ParticleEmitter.js.map

package/dist/rendering/effects/ParticleEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleEmitter.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA8D,MAAM,eAAe,CAAC;AAmC3G,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC;IAEvB,OAAO,GAAG,EAAE;QACV,KAAK,IAAI,UAAU,CAAC;QACpB,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrD,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,UAAU,CAAC;IACvD,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,KAA4C;IAC/E,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACzC,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,wCAAwC,CAAC,CAAC;QACxE,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACzG,MAAM,IAAI,UAAU,CAAC,GAAG,IAAI,oCAAoC,CAAC,CAAC;IACpE,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAA4C,EAAE,MAAoB;IACrF,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,CAAC;AAC5F,CAAC;AAED,SAAS,MAAM,CAAC,QAA8B,EAAE;IAC9C,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,SAAS,gBAAgB,CAAC,MAAoB;IAC5C,MAAM,CAAC,GAAG,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEjD,OAAO;QACL,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;QAC3B,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAA2B,EAAE,MAAoB;IACpE,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO;YACL,QAAQ,EAAE;gBACR,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpD,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpD,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;aACrD;SACF,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,GAAG,CAAC;QAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvE,OAAO;YACL,QAAQ,EAAE;gBACR,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;gBACtC,CAAC,EAAE,MAAM,CAAC,CAAC;gBACX,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;aACvC;YACD,SAAS,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;SAC5D,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,aAAa,GAAG,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrD,OAAO;YACL,QAAQ,EAAE;gBACR,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;gBACtC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK;gBACnB,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;aACvC;YACD,SAAS;SACV,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAEtE,OAAO;QACL,QAAQ,EAAE;YACR,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM;YAClC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM;YAClC,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,MAAM;SACnC;QACD,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAsD,EAAE,MAAoB;IACvG,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACxD,OAAO,SAAS,CAAC;QACf,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;QAC3B,CAAC,EAAE,CAAC;QACJ,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,KAAkB;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;AAC3E,CAAC;AAED,SAAS,aAAa,CAAC,KAA2B;IAChD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC;QACpF,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;IACvF,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,8DAA8D,CAAC,CAAC;QAC7I,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YAC1G,MAAM,IAAI,UAAU,CAAC,oDAAoD,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,4DAA4D,CAAC,CAAC;QAC3I,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAC;QACxI,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,IAAI,CAAC,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC;YACnH,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,OAAO,eAAe;IACjB,MAAM,CAAe;IACrB,YAAY,CAAS;IACrB,MAAM,CAA2B;IAE1C,YAAY,CAAS;IACrB,QAAQ,CAAS;IACjB,OAAO,CAAU;IACjB,QAAQ,CAAwC;IAChD,KAAK,CAAwC;IAC7C,KAAK,CAAuB;IAC5B,OAAO,CAAkF;IACzF,WAAW,GAAG,CAAC,CAAC;IAChB,MAAM,GAAG,KAAK,CAAC;IAEP,aAAa,GAAG,CAAC,CAAC;IAClB,cAAc,GAAG,CAAC,CAAC;IACnB,eAAe,CAAW;IAElC,YAAY,UAAkC,EAAE;QAC9C,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,MAAM,CAAC,iBAAiB,CAAC;QACrE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAC7D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YACjE,MAAM,IAAI,UAAU,CAAC,6DAA6D,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,MAAM,CAAC,iBAAiB,EAAE,CAAC;YAClF,MAAM,IAAI,UAAU,CAAC,wDAAwD,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,UAAU,CAAC,8CAA8C,CAAC,CAAC;QACvE,CAAC;QAED,aAAa,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAClD,aAAa,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK;QACH,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,cAAc,GAAG,CAAC,CAAC;QACxB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,SAAiB,EAAE,QAAQ,GAAG,MAAM,CAAC,iBAAiB;QACzD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YACjD,MAAM,IAAI,UAAU,CAAC,sEAAsE,CAAC,CAAC;QAC/F,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;QACrD,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QACnH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC7E,MAAM,SAAS,GAAe,EAAE,CAAC;QAEjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/C,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IAC7D,CAAC;IAED,cAAc;QACZ,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QAClC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAEnD,OAAO,cAAc,CAAC;YACpB,GAAG,IAAI,CAAC,OAAO;YACf,EAAE,EAAE,IAAI,CAAC,cAAc,EAAE;YACzB,GAAG,EAAE,CAAC;YACN,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC;YACjD,QAAQ;YACR,QAAQ,EAAE;gBACR,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,KAAK;gBACtB,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,KAAK;gBACtB,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,KAAK;aACvB;SACF,CAAC,CAAC;IACL,CAAC;IAEO,WAAW,CAAC,SAAiB;QACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QACtC,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,GAAG,SAAS,CAAC;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7E,CAAC;IAEO,eAAe,CAAC,SAAiB,EAAE,YAAoB;QAC7D,IAAI,YAAY,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACnD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACpI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC7C,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;QAC5B,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,WAAW,CAAC,YAAoB,EAAE,WAAmB;QAC3D,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,KAAK,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;YACrC,IAAI,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAElD,OAAO,UAAU,GAAG,MAAM,EAAE,CAAC;gBAC3B,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,GAAG,QAAQ,GAAG,UAAU,CAAC;gBACvD,MAAM,OAAO,GAAG,CAAC,WAAW,KAAK,CAAC,IAAI,YAAY,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,YAAY,IAAI,WAAW,IAAI,WAAW,CAAC,CAAC;gBAExH,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM;gBACR,CAAC;gBAED,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;gBACrB,UAAU,IAAI,CAAC,CAAC;YAClB,CAAC;YAED,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;QAC3C,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/rendering/effects/ParticleModule.d.ts

@@ -0,0 +1,15 @@
+import type { Particle } from "./Particle.js";
+export interface ParticleUpdateContext {
+    deltaTime: number;
+    elapsedTime: number;
+    normalizedAge: number;
+    random: () => number;
+}
+export interface ParticleModule {
+    readonly name: string;
+    onSpawn?(particle: Particle, context: ParticleUpdateContext): void;
+    update?(particle: Particle, context: ParticleUpdateContext): void;
+    afterIntegrate?(particle: Particle, context: ParticleUpdateContext): void;
+}
+export declare function applyParticleModules(modules: readonly ParticleModule[], hook: "onSpawn" | "update" | "afterIntegrate", particle: Particle, context: ParticleUpdateContext): void;
+//# sourceMappingURL=ParticleModule.d.ts.map

package/dist/rendering/effects/ParticleModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACnE,MAAM,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAClE,cAAc,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC3E;AAED,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,cAAc,EAAE,EAClC,IAAI,EAAE,SAAS,GAAG,QAAQ,GAAG,gBAAgB,EAC7C,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,qBAAqB,GAC7B,IAAI,CAIN"}

package/dist/rendering/effects/ParticleModule.js

@@ -0,0 +1,6 @@
+export function applyParticleModules(modules, hook, particle, context) {
+    for (const module of modules) {
+        module[hook]?.(particle, context);
+    }
+}
+//# sourceMappingURL=ParticleModule.js.map

package/dist/rendering/effects/ParticleModule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleModule.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,oBAAoB,CAClC,OAAkC,EAClC,IAA6C,EAC7C,QAAkB,EAClB,OAA8B;IAE9B,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpC,CAAC;AACH,CAAC"}

package/dist/rendering/effects/ParticleRenderPass.d.ts

@@ -0,0 +1,35 @@
+import { BaseRenderPass, type RenderPassContext } from "../RenderPass.js";
+import { type GPUParticleBackend } from "./GPUParticleBackend.js";
+import { ParticleRenderer, type ParticleDrawTarget, type ParticleRenderBatch, type ParticleRenderOptions } from "./ParticleRenderer.js";
+import { type ParticleSystem } from "./ParticleSystem.js";
+export type ParticleRenderPassUpdateMode = "none" | "cpu" | "gpu";
+export interface ParticleRenderPassUpdateOptions {
+    readonly deltaTime: number;
+    readonly gpuBackend?: GPUParticleBackend;
+    readonly preferGPU?: boolean;
+    readonly allowCPUFallback?: boolean;
+}
+export interface ParticleRenderPassOptions {
+    readonly system: ParticleSystem;
+    readonly target: ParticleDrawTarget;
+    readonly renderer?: ParticleRenderer;
+    readonly renderOptions?: ParticleRenderOptions;
+    readonly update?: ParticleRenderPassUpdateOptions;
+    readonly reads?: readonly string[];
+    readonly writes?: readonly string[];
+}
+export declare class ParticleRenderPass extends BaseRenderPass {
+    private readonly options;
+    readonly renderer: ParticleRenderer;
+    private lastBatch;
+    private lastUpdateMode;
+    constructor(options: ParticleRenderPassOptions);
+    execute(_context: RenderPassContext): void;
+    executeAsync(_context: RenderPassContext): Promise<void>;
+    getLastBatch(): ParticleRenderBatch | null;
+    getLastUpdateMode(): ParticleRenderPassUpdateMode;
+    private requiresAsyncUpdate;
+    private updateSync;
+    private updateAsync;
+}
+//# sourceMappingURL=ParticleRenderPass.d.ts.map

package/dist/rendering/effects/ParticleRenderPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleRenderPass.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleRenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACxI,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,qBAAqB,CAAC;IAC/C,QAAQ,CAAC,MAAM,CAAC,EAAE,+BAA+B,CAAC;IAClD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,qBAAa,kBAAmB,SAAQ,cAAc;IAKxC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,cAAc,CAAwC;gBAEjC,OAAO,EAAE,yBAAyB;IAK/D,OAAO,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAQpC,YAAY,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9D,YAAY,IAAI,mBAAmB,GAAG,IAAI;IAmB1C,iBAAiB,IAAI,4BAA4B;IAIjD,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,UAAU;YAcJ,WAAW;CAqB1B"}

package/dist/rendering/effects/ParticleRenderPass.js

@@ -0,0 +1,91 @@
+import { BaseRenderPass } from "../RenderPass.js";
+import {} from "./GPUParticleBackend.js";
+import { ParticleRenderer } from "./ParticleRenderer.js";
+import {} from "./ParticleSystem.js";
+export class ParticleRenderPass extends BaseRenderPass {
+    options;
+    renderer;
+    lastBatch = null;
+    lastUpdateMode = "none";
+    constructor(options) {
+        super("particles", options.reads ?? ["color"], options.writes ?? ["color"], ["color"]);
+        this.options = options;
+        this.renderer = options.renderer ?? new ParticleRenderer();
+    }
+    execute(_context) {
+        if (this.requiresAsyncUpdate()) {
+            throw new Error("ParticleRenderPass with a supported GPU update backend must run through RenderGraph.executeAsync().");
+        }
+        this.updateSync();
+        this.lastBatch = this.renderer.render(this.options.system, this.options.target, this.options.renderOptions);
+    }
+    async executeAsync(_context) {
+        await this.updateAsync();
+        this.lastBatch = this.renderer.render(this.options.system, this.options.target, this.options.renderOptions);
+    }
+    getLastBatch() {
+        if (!this.lastBatch) {
+            return null;
+        }
+        return {
+            sprites: this.lastBatch.sprites.map((sprite) => ({
+                ...sprite,
+                position: { ...sprite.position },
+                color: { ...sprite.color }
+            })),
+            liveCount: this.lastBatch.liveCount,
+            uploadedBytes: this.lastBatch.uploadedBytes,
+            bounds: this.lastBatch.bounds ? {
+                min: { ...this.lastBatch.bounds.min },
+                max: { ...this.lastBatch.bounds.max }
+            } : null
+        };
+    }
+    getLastUpdateMode() {
+        return this.lastUpdateMode;
+    }
+    requiresAsyncUpdate() {
+        const update = this.options.update;
+        return Boolean(update?.gpuBackend?.capabilities.supported && (update.preferGPU ?? true));
+    }
+    updateSync() {
+        const update = this.options.update;
+        if (!update) {
+            this.lastUpdateMode = "none";
+            return;
+        }
+        validateDeltaTime(update.deltaTime);
+        if (update.gpuBackend && update.preferGPU !== false && !update.gpuBackend.capabilities.supported && update.allowCPUFallback === false) {
+            throw new Error(update.gpuBackend.capabilities.reason ?? "GPU particle backend is unsupported.");
+        }
+        this.options.system.update(update.deltaTime);
+        this.lastUpdateMode = "cpu";
+    }
+    async updateAsync() {
+        const update = this.options.update;
+        if (!update) {
+            this.lastUpdateMode = "none";
+            return;
+        }
+        validateDeltaTime(update.deltaTime);
+        const backend = update.gpuBackend;
+        if (backend && (update.preferGPU ?? true)) {
+            if (backend.capabilities.supported) {
+                await this.options.system.updateOnGPU(update.deltaTime, backend);
+                this.lastUpdateMode = "gpu";
+                return;
+            }
+            if (update.allowCPUFallback === false) {
+                throw new Error(backend.capabilities.reason ?? "GPU particle backend is unsupported.");
+            }
+        }
+        this.options.system.update(update.deltaTime);
+        this.lastUpdateMode = "cpu";
+    }
+}
+function validateDeltaTime(deltaTime) {
+    if (!Number.isFinite(deltaTime) || deltaTime < 0) {
+        throw new RangeError("ParticleRenderPass update deltaTime must be a finite non-negative number.");
+    }
+}
+//# sourceMappingURL=ParticleRenderPass.js.map

package/dist/rendering/effects/ParticleRenderPass.js.map

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

package/dist/rendering/effects/ParticleRenderer.d.ts

@@ -0,0 +1,34 @@
+import type { ColorLike, Particle, Vector3Like } from "./Particle.js";
+import type { ParticleSystem } from "./ParticleSystem.js";
+export interface ParticleSprite {
+    id: number;
+    position: Vector3Like;
+    color: ColorLike;
+    size: number;
+    rotation: number;
+}
+export interface ParticleBatchBounds {
+    min: Vector3Like;
+    max: Vector3Like;
+}
+export interface ParticleRenderBatch {
+    sprites: ParticleSprite[];
+    liveCount: number;
+    uploadedBytes: number;
+    bounds: ParticleBatchBounds | null;
+}
+export interface ParticleDrawTarget {
+    drawParticles(batch: ParticleRenderBatch): void;
+}
+export type ParticleSortMode = "none" | "front-to-back" | "back-to-front";
+export interface ParticleRenderOptions {
+    readonly sort?: ParticleSortMode;
+    readonly cameraPosition?: Vector3Like;
+}
+export declare class ParticleRenderer {
+    private lastBatch;
+    buildBatch(particles: readonly Particle[], options?: ParticleRenderOptions): ParticleRenderBatch;
+    render(system: ParticleSystem, target: ParticleDrawTarget, options?: ParticleRenderOptions): ParticleRenderBatch;
+    getLastBatch(): ParticleRenderBatch;
+}
+//# sourceMappingURL=ParticleRenderer.d.ts.map

package/dist/rendering/effects/ParticleRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleRenderer.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleRenderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,kBAAkB;IACjC,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,eAAe,GAAG,eAAe,CAAC;AAE1E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,WAAW,CAAC;CACvC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAKf;IAEF,UAAU,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,GAAE,qBAA0B,GAAG,mBAAmB;IAsBpG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,qBAA0B,GAAG,mBAAmB;IAOpH,YAAY,IAAI,mBAAmB;CAepC"}

package/dist/rendering/effects/ParticleRenderer.js

@@ -0,0 +1,93 @@
+export class ParticleRenderer {
+    lastBatch = {
+        sprites: [],
+        liveCount: 0,
+        uploadedBytes: 0,
+        bounds: null,
+    };
+    buildBatch(particles, options = {}) {
+        const sprites = particles
+            .filter((particle) => particle.alive)
+            .map((particle) => ({
+            id: particle.id,
+            position: { ...particle.position },
+            color: { ...particle.color },
+            size: particle.size,
+            rotation: particle.rotation,
+        }));
+        sortSprites(sprites, options);
+        this.lastBatch = {
+            sprites,
+            liveCount: sprites.length,
+            uploadedBytes: sprites.length * (3 + 4 + 1 + 1) * Float32Array.BYTES_PER_ELEMENT,
+            bounds: computeBounds(sprites),
+        };
+        return this.lastBatch;
+    }
+    render(system, target, options = {}) {
+        const batch = this.buildBatch(system.particles, options);
+        target.drawParticles(batch);
+        system.recordBufferUpload(batch.uploadedBytes);
+        return batch;
+    }
+    getLastBatch() {
+        return {
+            sprites: this.lastBatch.sprites.map((sprite) => ({
+                ...sprite,
+                position: { ...sprite.position },
+                color: { ...sprite.color },
+            })),
+            liveCount: this.lastBatch.liveCount,
+            uploadedBytes: this.lastBatch.uploadedBytes,
+            bounds: this.lastBatch.bounds ? {
+                min: { ...this.lastBatch.bounds.min },
+                max: { ...this.lastBatch.bounds.max },
+            } : null,
+        };
+    }
+}
+function sortSprites(sprites, options) {
+    const mode = options.sort ?? "none";
+    if (mode === "none")
+        return;
+    const camera = options.cameraPosition;
+    if (!camera || !isFiniteVector(camera)) {
+        throw new RangeError("ParticleRenderer cameraPosition must be finite when depth sorting is enabled.");
+    }
+    const direction = mode === "back-to-front" ? -1 : 1;
+    sprites.sort((a, b) => {
+        const distanceDelta = distanceSquared(a.position, camera) - distanceSquared(b.position, camera);
+        if (Math.abs(distanceDelta) > 1e-9)
+            return distanceDelta * direction;
+        return a.id - b.id;
+    });
+}
+function computeBounds(sprites) {
+    if (sprites.length === 0)
+        return null;
+    const min = { x: Number.POSITIVE_INFINITY, y: Number.POSITIVE_INFINITY, z: Number.POSITIVE_INFINITY };
+    const max = { x: Number.NEGATIVE_INFINITY, y: Number.NEGATIVE_INFINITY, z: Number.NEGATIVE_INFINITY };
+    for (const sprite of sprites) {
+        if (!isFiniteVector(sprite.position) || !Number.isFinite(sprite.size) || sprite.size < 0) {
+            throw new RangeError("ParticleRenderer sprites require finite positions and non-negative finite sizes.");
+        }
+        const radius = sprite.size * 0.5;
+        min.x = Math.min(min.x, sprite.position.x - radius);
+        min.y = Math.min(min.y, sprite.position.y - radius);
+        min.z = Math.min(min.z, sprite.position.z - radius);
+        max.x = Math.max(max.x, sprite.position.x + radius);
+        max.y = Math.max(max.y, sprite.position.y + radius);
+        max.z = Math.max(max.z, sprite.position.z + radius);
+    }
+    return { min, max };
+}
+function distanceSquared(a, b) {
+    const x = a.x - b.x;
+    const y = a.y - b.y;
+    const z = a.z - b.z;
+    return x * x + y * y + z * z;
+}
+function isFiniteVector(value) {
+    return Number.isFinite(value.x) && Number.isFinite(value.y) && Number.isFinite(value.z);
+}
+//# sourceMappingURL=ParticleRenderer.js.map

package/dist/rendering/effects/ParticleRenderer.js.map

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

package/dist/rendering/effects/ParticleSystem.d.ts

@@ -0,0 +1,51 @@
+import { type Particle } from "./Particle.js";
+import { ParticleEmitter } from "./ParticleEmitter.js";
+import type { GPUParticleBackend } from "./GPUParticleBackend.js";
+import { type ParticleModule } from "./ParticleModule.js";
+export interface ParticleSystemStats {
+    liveCount: number;
+    capacity: number;
+    spawnedCount: number;
+    killedCount: number;
+    droppedCount: number;
+    bufferUploads: number;
+    uploadedBytes: number;
+    gpuSpawns: number;
+    gpuUpdates: number;
+}
+export interface ParticleSystemOptions {
+    maxParticles?: number;
+    emitters?: readonly ParticleEmitter[];
+    modules?: readonly ParticleModule[];
+    gpuBackend?: GPUParticleBackend;
+    preferGPU?: boolean;
+}
+export declare class ParticleSystem {
+    readonly particles: Particle[];
+    readonly emitters: ParticleEmitter[];
+    readonly modules: ParticleModule[];
+    readonly maxParticles: number;
+    elapsedTime: number;
+    paused: boolean;
+    private stats;
+    private gpuBackend?;
+    private preferGPU;
+    constructor(options?: ParticleSystemOptions);
+    addEmitter(emitter: ParticleEmitter): this;
+    addModule(module: ParticleModule): this;
+    setGPUBackend(backend: GPUParticleBackend | undefined, preferGPU?: boolean): this;
+    clear(): void;
+    dispose(): void;
+    update(deltaTime: number): void;
+    updateOnGPU(deltaTime: number, backend: GPUParticleBackend): Promise<void>;
+    updateBest(deltaTime: number): Promise<"gpu" | "cpu">;
+    getStats(): ParticleSystemStats;
+    recordBufferUpload(bytes: number): void;
+    private spawn;
+    private initializeSpawnedOnGPU;
+    private integrate;
+    private integrateOnGPU;
+    private compactDeadParticles;
+    private createContext;
+}
+//# sourceMappingURL=ParticleSystem.d.ts.map

package/dist/rendering/effects/ParticleSystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleSystem.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ParticleSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,EACd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAwB,KAAK,cAAc,EAA8B,MAAM,qBAAqB,CAAC;AAE5G,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACtC,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;IACpC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,SAAS,EAAE,QAAQ,EAAE,CAAM;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAM;IAC1C,QAAQ,CAAC,OAAO,EAAE,cAAc,EAAE,CAAM;IACxC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,WAAW,SAAK;IAChB,MAAM,UAAS;IAEf,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,SAAS,CAAU;gBAEf,OAAO,GAAE,qBAA0B;IAuB/C,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAK1C,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAKvC,aAAa,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,EAAE,SAAS,UAAwB,GAAG,IAAI;IAM/F,KAAK,IAAI,IAAI;IAMb,OAAO,IAAI,IAAI;IAOf,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAgBzB,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC;IAU3D,QAAQ,IAAI,mBAAmB;IAI/B,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASvC,OAAO,CAAC,KAAK;YAmBC,sBAAsB;IAmDpC,OAAO,CAAC,SAAS;YAuBH,cAAc;IA8D5B,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,aAAa;CAQtB"}