@codexo/exojs-particles 0.15.3 → 0.16.0

package/dist/esm/modules/AttractToPoint.d.ts

@@ -1,11 +1,11 @@
-import type { ParticleSystem } from "#ParticleSystem";
+import type { ParticleBatch } from '#ParticleStorage';
 import { UpdateModule } from './UpdateModule';
 import type { WgslContribution } from './WgslContribution';
 /**
  * Pulls every live particle toward a fixed point in the system's local
  * coordinate space. Acceleration magnitude is `strength` (units / s²),
  * applied along the direction `(point − particle)`. The optional `falloff`
- * radius softens the pull near the center — particles within `falloff`
+ * radius softens the pull near the center - particles within `falloff`
  * units lerp the strength linearly to zero, preventing the singularity at
  * `r = 0` from yielding infinite acceleration.
  *
@@ -21,7 +21,8 @@ export declare class AttractToPoint extends UpdateModule {
     strength: number;
     falloff: number;
     constructor(x: number, y: number, strength: number, falloff?: number);
-    apply(system: ParticleSystem, dt: number): void;
+    apply(particles: ParticleBatch, dt: number): void;
     wgsl(): WgslContribution;
     writeUniforms(view: DataView, offset: number): void;
 }
+//# sourceMappingURL=AttractToPoint.d.ts.map

package/dist/esm/modules/AttractToPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttractToPoint.d.ts","sourceRoot":"","sources":["../../../src/modules/AttractToPoint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,SAAQ,YAAY;IACvC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;gBAEJ,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAI;IAQtD,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAsBjD,IAAI,IAAI,gBAAgB;IAoBxB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAMpE"}

package/dist/esm/modules/AttractToPoint.js

@@ -1,56 +1,66 @@
-import { UpdateModule } from './UpdateModule.js';
+import { UpdateModule } from "./UpdateModule.js";
 
+//#region src/modules/AttractToPoint.ts
 /**
- * Pulls every live particle toward a fixed point in the system's local
- * coordinate space. Acceleration magnitude is `strength` (units / s²),
- * applied along the direction `(point − particle)`. The optional `falloff`
- * radius softens the pull near the center — particles within `falloff`
- * units lerp the strength linearly to zero, preventing the singularity at
- * `r = 0` from yielding infinite acceleration.
- *
- * Use cases: orbit anchors, pin emitters to a moving target, simulate a
- * "black hole" pickup. For repulsion, use {@link RepelFromPoint}; for
- * tangential motion, layer with {@link OrbitalForce}.
- *
- * GPU-eligible.
- */
-class AttractToPoint extends UpdateModule {
-    x;
-    y;
-    strength;
-    falloff;
-    constructor(x, y, strength, falloff = 0) {
-        super();
-        this.x = x;
-        this.y = y;
-        this.strength = strength;
-        this.falloff = falloff;
-    }
-    apply(system, dt) {
-        const { posX, posY, velX, velY, liveCount } = system;
-        const { x, y, strength, falloff } = this;
-        for (let i = 0; i < liveCount; i++) {
-            const dx = x - (posX[i] ?? 0);
-            const dy = y - (posY[i] ?? 0);
-            const distSq = dx * dx + dy * dy;
-            const dist = Math.sqrt(distSq);
-            if (dist < 1e-5)
-                continue;
-            const k = falloff > 0 ? Math.min(1, dist / falloff) : 1;
-            const a = (strength * k * dt) / dist;
-            velX[i] = (velX[i] ?? 0) + dx * a;
-            velY[i] = (velY[i] ?? 0) + dy * a;
-        }
-    }
-    wgsl() {
-        return {
-            key: 'AttractToPoint',
-            uniforms: [
-                { name: 'point', type: 'vec2<f32>' },
-                { name: 'strength', type: 'f32' },
-                { name: 'falloff', type: 'f32' },
-            ],
-            body: `
+* Pulls every live particle toward a fixed point in the system's local
+* coordinate space. Acceleration magnitude is `strength` (units / s²),
+* applied along the direction `(point − particle)`. The optional `falloff`
+* radius softens the pull near the center - particles within `falloff`
+* units lerp the strength linearly to zero, preventing the singularity at
+* `r = 0` from yielding infinite acceleration.
+*
+* Use cases: orbit anchors, pin emitters to a moving target, simulate a
+* "black hole" pickup. For repulsion, use {@link RepelFromPoint}; for
+* tangential motion, layer with {@link OrbitalForce}.
+*
+* GPU-eligible.
+*/
+var AttractToPoint = class extends UpdateModule {
+	x;
+	y;
+	strength;
+	falloff;
+	constructor(x, y, strength, falloff = 0) {
+		super();
+		this.x = x;
+		this.y = y;
+		this.strength = strength;
+		this.falloff = falloff;
+	}
+	apply(particles, dt) {
+		const { x: posX, y: posY } = particles.position;
+		const { x: velX, y: velY } = particles.velocity;
+		const liveCount = particles.count;
+		const { x, y, strength, falloff } = this;
+		for (let i = 0; i < liveCount; i++) {
+			const dx = x - (posX[i] ?? 0);
+			const dy = y - (posY[i] ?? 0);
+			const distSq = dx * dx + dy * dy;
+			const dist = Math.sqrt(distSq);
+			if (dist < 1e-5) continue;
+			const a = strength * (falloff > 0 ? Math.min(1, dist / falloff) : 1) * dt / dist;
+			velX[i] = (velX[i] ?? 0) + dx * a;
+			velY[i] = (velY[i] ?? 0) + dy * a;
+		}
+	}
+	wgsl() {
+		return {
+			key: "AttractToPoint",
+			uniforms: [
+				{
+					name: "point",
+					type: "vec2<f32>"
+				},
+				{
+					name: "strength",
+					type: "f32"
+				},
+				{
+					name: "falloff",
+					type: "f32"
+				}
+			],
+			body: `
                 let attractDelta = modules.u_AttractToPoint.point - positions[idx];
                 let attractDist = length(attractDelta);
                 if (attractDist > 0.00001) {
@@ -58,16 +68,17 @@ class AttractToPoint extends UpdateModule {
                     let attractAccel = (modules.u_AttractToPoint.strength * attractK * dt) / attractDist;
                     velocities[idx] = velocities[idx] + attractDelta * attractAccel;
                 }
-            `,
-        };
-    }
-    writeUniforms(view, offset) {
-        view.setFloat32(offset + 0, this.x, true);
-        view.setFloat32(offset + 4, this.y, true);
-        view.setFloat32(offset + 8, this.strength, true);
-        view.setFloat32(offset + 12, this.falloff, true);
-    }
-}
+            `
+		};
+	}
+	writeUniforms(view, offset) {
+		view.setFloat32(offset + 0, this.x, true);
+		view.setFloat32(offset + 4, this.y, true);
+		view.setFloat32(offset + 8, this.strength, true);
+		view.setFloat32(offset + 12, this.falloff, true);
+	}
+};
 
+//#endregion
 export { AttractToPoint };
-//# sourceMappingURL=AttractToPoint.js.map
+//# sourceMappingURL=AttractToPoint.js.map

package/dist/esm/modules/AttractToPoint.js.map

@@ -1 +1 @@
-{"version":3,"file":"AttractToPoint.js","sources":["../../../../src/modules/AttractToPoint.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;;;;AAaG;AACG,MAAO,cAAe,SAAQ,YAAY,CAAA;AACvC,IAAA,CAAC;AACD,IAAA,CAAC;AACD,IAAA,QAAQ;AACR,IAAA,OAAO;IAEd,WAAA,CAAmB,CAAS,EAAE,CAAS,EAAE,QAAgB,EAAE,OAAO,GAAG,CAAC,EAAA;AACpE,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,CAAC,GAAG,CAAC;AACV,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO;IACxB;IAEgB,KAAK,CAAC,MAAsB,EAAE,EAAU,EAAA;AACtD,QAAA,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM;QACpD,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI;AAExC,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;AAClC,YAAA,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC7B,YAAA,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7B,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAE9B,IAAI,IAAI,GAAG,IAAI;gBAAE;YAEjB,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;YACvD,MAAM,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI;AAEpC,YAAA,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;AACjC,YAAA,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC;QACnC;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,gBAAgB;AACrB,YAAA,QAAQ,EAAE;AACR,gBAAA,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE;AACpC,gBAAA,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE;AACjC,gBAAA,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE;AACjC,aAAA;AACD,YAAA,IAAI,EAAE;;;;;;;;AAQC,YAAA,CAAA;SACR;IACH;IAEgB,aAAa,CAAC,IAAc,EAAE,MAAc,EAAA;AAC1D,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AACzC,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC;AACzC,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;AAChD,QAAA,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC;IAClD;AACD;;;;"}
+{"version":3,"file":"AttractToPoint.js","names":[],"sources":["../../../src/modules/AttractToPoint.ts"],"sourcesContent":["import type { ParticleBatch } from '#ParticleStorage';\n\nimport { UpdateModule } from './UpdateModule';\nimport type { WgslContribution } from './WgslContribution';\n\n/**\n * Pulls every live particle toward a fixed point in the system's local\n * coordinate space. Acceleration magnitude is `strength` (units / s²),\n * applied along the direction `(point − particle)`. The optional `falloff`\n * radius softens the pull near the center - particles within `falloff`\n * units lerp the strength linearly to zero, preventing the singularity at\n * `r = 0` from yielding infinite acceleration.\n *\n * Use cases: orbit anchors, pin emitters to a moving target, simulate a\n * \"black hole\" pickup. For repulsion, use {@link RepelFromPoint}; for\n * tangential motion, layer with {@link OrbitalForce}.\n *\n * GPU-eligible.\n */\nexport class AttractToPoint extends UpdateModule {\n  public x: number;\n  public y: number;\n  public strength: number;\n  public falloff: number;\n\n  public constructor(x: number, y: number, strength: number, falloff = 0) {\n    super();\n    this.x = x;\n    this.y = y;\n    this.strength = strength;\n    this.falloff = falloff;\n  }\n\n  public override apply(particles: ParticleBatch, dt: number): void {\n    const { x: posX, y: posY } = particles.position;\n    const { x: velX, y: velY } = particles.velocity;\n    const liveCount = particles.count;\n    const { x, y, strength, falloff } = this;\n\n    for (let i = 0; i < liveCount; i++) {\n      const dx = x - (posX[i] ?? 0);\n      const dy = y - (posY[i] ?? 0);\n      const distSq = dx * dx + dy * dy;\n      const dist = Math.sqrt(distSq);\n\n      if (dist < 1e-5) continue;\n\n      const k = falloff > 0 ? Math.min(1, dist / falloff) : 1;\n      const a = (strength * k * dt) / dist;\n\n      velX[i] = (velX[i] ?? 0) + dx * a;\n      velY[i] = (velY[i] ?? 0) + dy * a;\n    }\n  }\n\n  public override wgsl(): WgslContribution {\n    return {\n      key: 'AttractToPoint',\n      uniforms: [\n        { name: 'point', type: 'vec2<f32>' },\n        { name: 'strength', type: 'f32' },\n        { name: 'falloff', type: 'f32' },\n      ],\n      body: `\n                let attractDelta = modules.u_AttractToPoint.point - positions[idx];\n                let attractDist = length(attractDelta);\n                if (attractDist > 0.00001) {\n                    let attractK = select(1.0, min(1.0, attractDist / max(modules.u_AttractToPoint.falloff, 0.000001)), modules.u_AttractToPoint.falloff > 0.0);\n                    let attractAccel = (modules.u_AttractToPoint.strength * attractK * dt) / attractDist;\n                    velocities[idx] = velocities[idx] + attractDelta * attractAccel;\n                }\n            `,\n    };\n  }\n\n  public override writeUniforms(view: DataView, offset: number): void {\n    view.setFloat32(offset + 0, this.x, true);\n    view.setFloat32(offset + 4, this.y, true);\n    view.setFloat32(offset + 8, this.strength, true);\n    view.setFloat32(offset + 12, this.falloff, true);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,IAAa,iBAAb,cAAoC,aAAa;CAC/C,AAAO;CACP,AAAO;CACP,AAAO;CACP,AAAO;CAEP,AAAO,YAAY,GAAW,GAAW,UAAkB,UAAU,GAAG;EACtE,MAAM;EACN,KAAK,IAAI;EACT,KAAK,IAAI;EACT,KAAK,WAAW;EAChB,KAAK,UAAU;CACjB;CAEA,AAAgB,MAAM,WAA0B,IAAkB;EAChE,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,UAAU;EACvC,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,UAAU;EACvC,MAAM,YAAY,UAAU;EAC5B,MAAM,EAAE,GAAG,GAAG,UAAU,YAAY;EAEpC,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;GAClC,MAAM,KAAK,KAAK,KAAK,MAAM;GAC3B,MAAM,KAAK,KAAK,KAAK,MAAM;GAC3B,MAAM,SAAS,KAAK,KAAK,KAAK;GAC9B,MAAM,OAAO,KAAK,KAAK,MAAM;GAE7B,IAAI,OAAO,MAAM;GAGjB,MAAM,IAAK,YADD,UAAU,IAAI,KAAK,IAAI,GAAG,OAAO,OAAO,IAAI,KAC5B,KAAM;GAEhC,KAAK,MAAM,KAAK,MAAM,KAAK,KAAK;GAChC,KAAK,MAAM,KAAK,MAAM,KAAK,KAAK;EAClC;CACF;CAEA,AAAgB,OAAyB;EACvC,OAAO;GACL,KAAK;GACL,UAAU;IACR;KAAE,MAAM;KAAS,MAAM;IAAY;IACnC;KAAE,MAAM;KAAY,MAAM;IAAM;IAChC;KAAE,MAAM;KAAW,MAAM;IAAM;GACjC;GACA,MAAM;;;;;;;;;EASR;CACF;CAEA,AAAgB,cAAc,MAAgB,QAAsB;EAClE,KAAK,WAAW,SAAS,GAAG,KAAK,GAAG,IAAI;EACxC,KAAK,WAAW,SAAS,GAAG,KAAK,GAAG,IAAI;EACxC,KAAK,WAAW,SAAS,GAAG,KAAK,UAAU,IAAI;EAC/C,KAAK,WAAW,SAAS,IAAI,KAAK,SAAS,IAAI;CACjD;AACF"}

package/dist/esm/modules/BurstSpawn.d.ts

@@ -1,7 +1,5 @@
-import { Color } from '@codexo/exojs';
-import { Vector } from '@codexo/exojs';
-import type { Distribution } from "#distributions/Distribution";
-import type { ParticleSystem } from "#ParticleSystem";
+import type { ParticleEmitter } from '#ParticleStorage';
+import { type ParticleSpawnFields } from './spawnFields';
 import { SpawnModule } from './SpawnModule';
 /**
  * Burst trigger schedule. The module fires at `time` seconds (since
@@ -11,22 +9,11 @@ export interface BurstSchedule {
     time: number;
     count: number;
 }
-/**
- * Per-property spawn configuration for {@link BurstSpawn}. Same fields as
- * {@link RateSpawnConfig} except no rate — the schedule drives counts.
- */
-export interface BurstSpawnConfig {
+/** Spawn configuration for {@link BurstSpawn}: the burst schedule plus the shared per-property fields. */
+export interface BurstSpawnConfig extends ParticleSpawnFields {
     schedule: readonly BurstSchedule[];
     /** Whether to repeat the schedule from t=0 once exhausted. Default `false`. */
     loop?: boolean;
-    lifetime?: Distribution<number>;
-    position?: Distribution<Vector>;
-    velocity?: Distribution<Vector>;
-    scale?: Distribution<Vector>;
-    rotation?: Distribution<number>;
-    rotationSpeed?: Distribution<number>;
-    tint?: Distribution<Color>;
-    textureIndex?: Distribution<number>;
 }
 /**
  * Discrete-burst spawner. Fires at scheduled times with a fixed count per
@@ -46,8 +33,9 @@ export declare class BurstSpawn extends SpawnModule {
     private readonly _vec;
     private readonly _color;
     constructor(config: BurstSpawnConfig);
-    apply(system: ParticleSystem, dt: number): void;
+    apply(emitter: ParticleEmitter, dt: number): void;
     /** Restart the schedule from t=0. */
     reset(): this;
     private _spawnBurst;
 }
+//# sourceMappingURL=BurstSpawn.d.ts.map

package/dist/esm/modules/BurstSpawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BurstSpawn.d.ts","sourceRoot":"","sources":["../../../src/modules/BurstSpawn.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,0GAA0G;AAC1G,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB;IAC3D,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IACnC,+EAA+E;IAC/E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,UAAW,SAAQ,WAAW;IAClC,MAAM,EAAE,gBAAgB,CAAC;IAEhC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;gBAEnB,MAAM,EAAE,gBAAgB;IAK3B,KAAK,CAAC,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAwBjE,qCAAqC;IAC9B,KAAK,IAAI,IAAI;IAOpB,OAAO,CAAC,WAAW;CAWpB"}

package/dist/esm/modules/BurstSpawn.js

@@ -1,95 +1,60 @@
-import { Vector, Color } from '@codexo/exojs';
-import { SpawnModule } from './SpawnModule.js';
+import { fillParticle } from "./spawnFields.js";
+import { SpawnModule } from "./SpawnModule.js";
+import { Color, Vector } from "@codexo/exojs";
 
+//#region src/modules/BurstSpawn.ts
 /**
- * Discrete-burst spawner. Fires at scheduled times with a fixed count per
- * burst. Useful for explosions, hit-impacts, level-up effects.
- *
- * @example
- * new BurstSpawn({
- *     schedule: [{ time: 0, count: 50 }, { time: 0.2, count: 25 }],
- *     velocity: ConeDirection.omni(150, 350),
- *     lifetime: new Range(0.4, 0.9),
- * });
- */
-class BurstSpawn extends SpawnModule {
-    config;
-    _elapsed = 0;
-    _nextIndex = 0;
-    _vec = new Vector();
-    _color = new Color();
-    constructor(config) {
-        super();
-        this.config = config;
-    }
-    apply(system, dt) {
-        const cfg = this.config;
-        const schedule = cfg.schedule;
-        if (schedule.length === 0) {
-            return;
-        }
-        this._elapsed += dt;
-        let next = schedule[this._nextIndex];
-        while (next !== undefined && this._elapsed >= next.time) {
-            this._spawnBurst(system, next.count);
-            this._nextIndex++;
-            next = schedule[this._nextIndex];
-        }
-        if (cfg.loop && this._nextIndex >= schedule.length) {
-            this._elapsed = 0;
-            this._nextIndex = 0;
-        }
-    }
-    /** Restart the schedule from t=0. */
-    reset() {
-        this._elapsed = 0;
-        this._nextIndex = 0;
-        return this;
-    }
-    _spawnBurst(system, count) {
-        const cfg = this.config;
-        const v = this._vec;
-        const c = this._color;
-        for (let i = 0; i < count; i++) {
-            const slot = system.spawn();
-            if (slot < 0) {
-                return;
-            }
-            system.lifetime[slot] = cfg.lifetime ? cfg.lifetime.sample() : 1;
-            if (cfg.position) {
-                cfg.position.sample(v);
-                system.posX[slot] = v.x;
-                system.posY[slot] = v.y;
-            }
-            else {
-                system.posX[slot] = 0;
-                system.posY[slot] = 0;
-            }
-            if (cfg.velocity) {
-                cfg.velocity.sample(v);
-                system.velX[slot] = v.x;
-                system.velY[slot] = v.y;
-            }
-            else {
-                system.velX[slot] = 0;
-                system.velY[slot] = 0;
-            }
-            if (cfg.scale) {
-                cfg.scale.sample(v);
-                system.scaleX[slot] = v.x;
-                system.scaleY[slot] = v.y;
-            }
-            else {
-                system.scaleX[slot] = 1;
-                system.scaleY[slot] = 1;
-            }
-            system.rotations[slot] = cfg.rotation ? cfg.rotation.sample() : 0;
-            system.rotationSpeeds[slot] = cfg.rotationSpeed ? cfg.rotationSpeed.sample() : 0;
-            system.color[slot] = cfg.tint ? cfg.tint.sample(c).toRgba() : 0xffffffff;
-            system.textureIndex[slot] = cfg.textureIndex ? cfg.textureIndex.sample() | 0 : 0;
-        }
-    }
-}
+* Discrete-burst spawner. Fires at scheduled times with a fixed count per
+* burst. Useful for explosions, hit-impacts, level-up effects.
+*
+* @example
+* new BurstSpawn({
+*     schedule: [{ time: 0, count: 50 }, { time: 0.2, count: 25 }],
+*     velocity: ConeDirection.omni(150, 350),
+*     lifetime: new Range(0.4, 0.9),
+* });
+*/
+var BurstSpawn = class extends SpawnModule {
+	config;
+	_elapsed = 0;
+	_nextIndex = 0;
+	_vec = new Vector();
+	_color = new Color();
+	constructor(config) {
+		super();
+		this.config = config;
+	}
+	apply(emitter, dt) {
+		const cfg = this.config;
+		const schedule = cfg.schedule;
+		if (schedule.length === 0) return;
+		this._elapsed += dt;
+		let next = schedule[this._nextIndex];
+		while (next !== void 0 && this._elapsed >= next.time) {
+			this._spawnBurst(emitter, next.count);
+			this._nextIndex++;
+			next = schedule[this._nextIndex];
+		}
+		if (cfg.loop && this._nextIndex >= schedule.length) {
+			this._elapsed = 0;
+			this._nextIndex = 0;
+		}
+	}
+	/** Restart the schedule from t=0. */
+	reset() {
+		this._elapsed = 0;
+		this._nextIndex = 0;
+		return this;
+	}
+	_spawnBurst(emitter, count) {
+		for (let i = 0; i < count; i++) {
+			const particle = emitter.emit();
+			if (particle === null) return;
+			fillParticle(particle, this.config, this._vec, this._color);
+		}
+	}
+};
 
+//#endregion
 export { BurstSpawn };
-//# sourceMappingURL=BurstSpawn.js.map
+//# sourceMappingURL=BurstSpawn.js.map

package/dist/esm/modules/BurstSpawn.js.map

@@ -1 +1 @@
-{"version":3,"file":"BurstSpawn.js","sources":["../../../../src/modules/BurstSpawn.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"BurstSpawn.js","names":[],"sources":["../../../src/modules/BurstSpawn.ts"],"sourcesContent":["import { Color } from '@codexo/exojs';\nimport { Vector } from '@codexo/exojs';\n\nimport type { ParticleEmitter } from '#ParticleStorage';\n\nimport { fillParticle, type ParticleSpawnFields } from './spawnFields';\nimport { SpawnModule } from './SpawnModule';\n\n/**\n * Burst trigger schedule. The module fires at `time` seconds (since\n * registration), spawning `count` particles in one frame.\n */\nexport interface BurstSchedule {\n  time: number;\n  count: number;\n}\n\n/** Spawn configuration for {@link BurstSpawn}: the burst schedule plus the shared per-property fields. */\nexport interface BurstSpawnConfig extends ParticleSpawnFields {\n  schedule: readonly BurstSchedule[];\n  /** Whether to repeat the schedule from t=0 once exhausted. Default `false`. */\n  loop?: boolean;\n}\n\n/**\n * Discrete-burst spawner. Fires at scheduled times with a fixed count per\n * burst. Useful for explosions, hit-impacts, level-up effects.\n *\n * @example\n * new BurstSpawn({\n *     schedule: [{ time: 0, count: 50 }, { time: 0.2, count: 25 }],\n *     velocity: ConeDirection.omni(150, 350),\n *     lifetime: new Range(0.4, 0.9),\n * });\n */\nexport class BurstSpawn extends SpawnModule {\n  public config: BurstSpawnConfig;\n\n  private _elapsed = 0;\n  private _nextIndex = 0;\n  private readonly _vec = new Vector();\n  private readonly _color = new Color();\n\n  public constructor(config: BurstSpawnConfig) {\n    super();\n    this.config = config;\n  }\n\n  public override apply(emitter: ParticleEmitter, dt: number): void {\n    const cfg = this.config;\n    const schedule = cfg.schedule;\n\n    if (schedule.length === 0) {\n      return;\n    }\n\n    this._elapsed += dt;\n\n    let next = schedule[this._nextIndex];\n\n    while (next !== undefined && this._elapsed >= next.time) {\n      this._spawnBurst(emitter, next.count);\n      this._nextIndex++;\n      next = schedule[this._nextIndex];\n    }\n\n    if (cfg.loop && this._nextIndex >= schedule.length) {\n      this._elapsed = 0;\n      this._nextIndex = 0;\n    }\n  }\n\n  /** Restart the schedule from t=0. */\n  public reset(): this {\n    this._elapsed = 0;\n    this._nextIndex = 0;\n\n    return this;\n  }\n\n  private _spawnBurst(emitter: ParticleEmitter, count: number): void {\n    for (let i = 0; i < count; i++) {\n      const particle = emitter.emit();\n\n      if (particle === null) {\n        return;\n      }\n\n      fillParticle(particle, this.config, this._vec, this._color);\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAmCA,IAAa,aAAb,cAAgC,YAAY;CAC1C,AAAO;CAEP,AAAQ,WAAW;CACnB,AAAQ,aAAa;CACrB,AAAiB,OAAO,IAAI,OAAO;CACnC,AAAiB,SAAS,IAAI,MAAM;CAEpC,AAAO,YAAY,QAA0B;EAC3C,MAAM;EACN,KAAK,SAAS;CAChB;CAEA,AAAgB,MAAM,SAA0B,IAAkB;EAChE,MAAM,MAAM,KAAK;EACjB,MAAM,WAAW,IAAI;EAErB,IAAI,SAAS,WAAW,GACtB;EAGF,KAAK,YAAY;EAEjB,IAAI,OAAO,SAAS,KAAK;EAEzB,OAAO,SAAS,UAAa,KAAK,YAAY,KAAK,MAAM;GACvD,KAAK,YAAY,SAAS,KAAK,KAAK;GACpC,KAAK;GACL,OAAO,SAAS,KAAK;EACvB;EAEA,IAAI,IAAI,QAAQ,KAAK,cAAc,SAAS,QAAQ;GAClD,KAAK,WAAW;GAChB,KAAK,aAAa;EACpB;CACF;;CAGA,AAAO,QAAc;EACnB,KAAK,WAAW;EAChB,KAAK,aAAa;EAElB,OAAO;CACT;CAEA,AAAQ,YAAY,SAA0B,OAAqB;EACjE,KAAK,IAAI,IAAI,GAAG,IAAI,OAAO,KAAK;GAC9B,MAAM,WAAW,QAAQ,KAAK;GAE9B,IAAI,aAAa,MACf;GAGF,aAAa,UAAU,KAAK,QAAQ,KAAK,MAAM,KAAK,MAAM;EAC5D;CACF;AACF"}

package/dist/esm/modules/ColorOverLifetime.d.ts

@@ -1,5 +1,5 @@
-import type { ColorGradient } from "#distributions/ColorGradient";
-import type { ParticleSystem } from "#ParticleSystem";
+import type { ColorGradient } from '#distributions/ColorGradient';
+import type { ParticleBatch } from '#ParticleStorage';
 import { UpdateModule } from './UpdateModule';
 import type { WgslContribution } from './WgslContribution';
 /**
@@ -14,9 +14,10 @@ import type { WgslContribution } from './WgslContribution';
 export declare class ColorOverLifetime extends UpdateModule {
     gradient: ColorGradient;
     constructor(gradient: ColorGradient);
-    apply(system: ParticleSystem, _dt: number): void;
+    apply(particles: ParticleBatch, _dt: number): void;
     wgsl(): WgslContribution;
     uploadTextures(device: GPUDevice, textures: ReadonlyMap<string, GPUTexture>): void;
 }
 /** Texture width for the gradient lookup table. Exposed for ParticleGpuState. */
 export declare const colorLookupSize = 256;
+//# sourceMappingURL=ColorOverLifetime.d.ts.map

package/dist/esm/modules/ColorOverLifetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorOverLifetime.d.ts","sourceRoot":"","sources":["../../../src/modules/ColorOverLifetime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAI3D;;;;;;;;GAQG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC1C,QAAQ,EAAE,aAAa,CAAC;gBAEZ,QAAQ,EAAE,aAAa;IAK1B,KAAK,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAalD,IAAI,IAAI,gBAAgB;IAgBxB,cAAc,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;CA8BnG;AAED,iFAAiF;AACjF,eAAO,MAAM,eAAe,MAAa,CAAC"}

package/dist/esm/modules/ColorOverLifetime.js

@@ -1,36 +1,41 @@
-import { Color } from '@codexo/exojs';
-import { UpdateModule } from './UpdateModule.js';
+import { UpdateModule } from "./UpdateModule.js";
+import { Color } from "@codexo/exojs";
 
-/// <reference types="@webgpu/types" />
+//#region src/modules/ColorOverLifetime.ts
 const lookupSize = 256;
 /**
- * Per-frame, per-particle color sampler. Each live particle's tint is set
- * to the gradient evaluated at the particle's current `elapsed / lifetime`
- * ratio, packed RGBA. Replaces the per-particle blend of `ColorAffector`
- * (legacy) with a multi-keyframe gradient.
- *
- * GPU-eligible: the gradient is uploaded once as a 256-tap 1D RGBA8 texture
- * and sampled with linear filtering on the GPU.
- */
-class ColorOverLifetime extends UpdateModule {
-    gradient;
-    constructor(gradient) {
-        super();
-        this.gradient = gradient;
-    }
-    apply(system, _dt) {
-        const { color, elapsed, lifetime, liveCount } = system;
-        const gradient = this.gradient;
-        for (let i = 0; i < liveCount; i++) {
-            const t = (elapsed[i] ?? 0) / (lifetime[i] ?? 1);
-            color[i] = gradient.evaluateRgba(t);
-        }
-    }
-    wgsl() {
-        return {
-            key: 'ColorOverLifetime',
-            textures: [{ name: 'gradient', format: 'rgba8unorm' }],
-            body: `
+* Per-frame, per-particle color sampler. Each live particle's tint is set
+* to the gradient evaluated at the particle's current `elapsed / lifetime`
+* ratio, packed RGBA. Replaces the per-particle blend of `ColorAffector`
+* (legacy) with a multi-keyframe gradient.
+*
+* GPU-eligible: the gradient is uploaded once as a 256-tap 1D RGBA8 texture
+* and sampled with linear filtering on the GPU.
+*/
+var ColorOverLifetime = class extends UpdateModule {
+	gradient;
+	constructor(gradient) {
+		super();
+		this.gradient = gradient;
+	}
+	apply(particles, _dt) {
+		const { elapsed, lifetime } = particles.timing;
+		const color = particles.color;
+		const liveCount = particles.count;
+		const gradient = this.gradient;
+		for (let i = 0; i < liveCount; i++) {
+			const t = (elapsed[i] ?? 0) / (lifetime[i] ?? 1);
+			color[i] = gradient.evaluateRgba(t);
+		}
+	}
+	wgsl() {
+		return {
+			key: "ColorOverLifetime",
+			textures: [{
+				name: "gradient",
+				format: "rgba8unorm"
+			}],
+			body: `
                 let colorT = clamp(timing[idx].x / max(timing[idx].y, 0.000001), 0.0, 1.0);
                 let colorSample = textureSampleLevel(u_ColorOverLifetime_gradient, u_ColorOverLifetime_gradient_sampler, colorT, 0.0);
                 let r = u32(colorSample.r * 255.0) & 255u;
@@ -38,28 +43,35 @@ class ColorOverLifetime extends UpdateModule {
                 let b = u32(colorSample.b * 255.0) & 255u;
                 let a = u32(colorSample.a * 255.0) & 255u;
                 color[idx] = (a << 24u) | (b << 16u) | (g << 8u) | r;
-            `,
-        };
-    }
-    uploadTextures(device, textures) {
-        const texture = textures.get('gradient');
-        if (texture === undefined) {
-            return;
-        }
-        const data = new Uint8Array(lookupSize * 4);
-        const scratch = new Color();
-        for (let i = 0; i < lookupSize; i++) {
-            const t = i / (lookupSize - 1);
-            this.gradient.evaluate(t, scratch);
-            const o = i * 4;
-            data[o + 0] = scratch.r & 255;
-            data[o + 1] = scratch.g & 255;
-            data[o + 2] = scratch.b & 255;
-            data[o + 3] = ((scratch.a * 255) | 0) & 255;
-        }
-        device.queue.writeTexture({ texture }, data.buffer, { offset: 0, bytesPerRow: lookupSize * 4, rowsPerImage: 1 }, { width: lookupSize, height: 1, depthOrArrayLayers: 1 });
-    }
-}
+            `
+		};
+	}
+	uploadTextures(device, textures) {
+		const texture = textures.get("gradient");
+		if (texture === void 0) return;
+		const data = new Uint8Array(lookupSize * 4);
+		const scratch = new Color();
+		for (let i = 0; i < lookupSize; i++) {
+			const t = i / 255;
+			this.gradient.evaluate(t, scratch);
+			const o = i * 4;
+			data[o + 0] = scratch.r & 255;
+			data[o + 1] = scratch.g & 255;
+			data[o + 2] = scratch.b & 255;
+			data[o + 3] = (scratch.a * 255 | 0) & 255;
+		}
+		device.queue.writeTexture({ texture }, data.buffer, {
+			offset: 0,
+			bytesPerRow: lookupSize * 4,
+			rowsPerImage: 1
+		}, {
+			width: lookupSize,
+			height: 1,
+			depthOrArrayLayers: 1
+		});
+	}
+};
 
+//#endregion
 export { ColorOverLifetime };
-//# sourceMappingURL=ColorOverLifetime.js.map
+//# sourceMappingURL=ColorOverLifetime.js.map

package/dist/esm/modules/ColorOverLifetime.js.map

@@ -1 +1 @@
-{"version":3,"file":"ColorOverLifetime.js","sources":["../../../../src/modules/ColorOverLifetime.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;AAUA,MAAM,UAAU,GAAG,GAAG;AAEtB;;;;;;;;AAQG;AACG,MAAO,iBAAkB,SAAQ,YAAY,CAAA;AAC1C,IAAA,QAAQ;AAEf,IAAA,WAAA,CAAmB,QAAuB,EAAA;AACxC,QAAA,KAAK,EAAE;AACP,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;IAC1B;IAEgB,KAAK,CAAC,MAAsB,EAAE,GAAW,EAAA;QACvD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM;AACtD,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;AAE9B,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,EAAE,CAAC,EAAE,EAAE;AAClC,YAAA,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAEhD,KAAK,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC;QACrC;IACF;IAEgB,IAAI,GAAA;QAClB,OAAO;AACL,YAAA,GAAG,EAAE,mBAAmB;YACxB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AACtD,YAAA,IAAI,EAAE;;;;;;;;AAQC,YAAA,CAAA;SACR;IACH;IAEgB,cAAc,CAAC,MAAiB,EAAE,QAAyC,EAAA;QACzF,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC;AAExC,QAAA,IAAI,OAAO,KAAK,SAAS,EAAE;YACzB;QACF;QAEA,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,UAAU,GAAG,CAAC,CAAC;AAC3C,QAAA,MAAM,OAAO,GAAG,IAAI,KAAK,EAAE;AAE3B,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE;YACnC,MAAM,CAAC,GAAG,CAAC,IAAI,UAAU,GAAG,CAAC,CAAC;YAE9B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;AAElC,YAAA,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;YAEf,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG;YAC7B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG;YAC7B,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG;AAC7B,YAAA,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG;QAC7C;AAEA,QAAA,MAAM,CAAC,KAAK,CAAC,YAAY,CACvB,EAAE,OAAO,EAAE,EACX,IAAI,CAAC,MAAM,EACX,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,UAAU,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,EAC3D,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE,CACxD;IACH;AACD;;;;"}
+{"version":3,"file":"ColorOverLifetime.js","names":[],"sources":["../../../src/modules/ColorOverLifetime.ts"],"sourcesContent":["/// <reference types=\"@webgpu/types\" />\n\nimport { Color } from '@codexo/exojs';\n\nimport type { ColorGradient } from '#distributions/ColorGradient';\nimport type { ParticleBatch } from '#ParticleStorage';\n\nimport { UpdateModule } from './UpdateModule';\nimport type { WgslContribution } from './WgslContribution';\n\nconst lookupSize = 256;\n\n/**\n * Per-frame, per-particle color sampler. Each live particle's tint is set\n * to the gradient evaluated at the particle's current `elapsed / lifetime`\n * ratio, packed RGBA. Replaces the per-particle blend of `ColorAffector`\n * (legacy) with a multi-keyframe gradient.\n *\n * GPU-eligible: the gradient is uploaded once as a 256-tap 1D RGBA8 texture\n * and sampled with linear filtering on the GPU.\n */\nexport class ColorOverLifetime extends UpdateModule {\n  public gradient: ColorGradient;\n\n  public constructor(gradient: ColorGradient) {\n    super();\n    this.gradient = gradient;\n  }\n\n  public override apply(particles: ParticleBatch, _dt: number): void {\n    const { elapsed, lifetime } = particles.timing;\n    const color = particles.color;\n    const liveCount = particles.count;\n    const gradient = this.gradient;\n\n    for (let i = 0; i < liveCount; i++) {\n      const t = (elapsed[i] ?? 0) / (lifetime[i] ?? 1);\n\n      color[i] = gradient.evaluateRgba(t);\n    }\n  }\n\n  public override wgsl(): WgslContribution {\n    return {\n      key: 'ColorOverLifetime',\n      textures: [{ name: 'gradient', format: 'rgba8unorm' }],\n      body: `\n                let colorT = clamp(timing[idx].x / max(timing[idx].y, 0.000001), 0.0, 1.0);\n                let colorSample = textureSampleLevel(u_ColorOverLifetime_gradient, u_ColorOverLifetime_gradient_sampler, colorT, 0.0);\n                let r = u32(colorSample.r * 255.0) & 255u;\n                let g = u32(colorSample.g * 255.0) & 255u;\n                let b = u32(colorSample.b * 255.0) & 255u;\n                let a = u32(colorSample.a * 255.0) & 255u;\n                color[idx] = (a << 24u) | (b << 16u) | (g << 8u) | r;\n            `,\n    };\n  }\n\n  public override uploadTextures(device: GPUDevice, textures: ReadonlyMap<string, GPUTexture>): void {\n    const texture = textures.get('gradient');\n\n    if (texture === undefined) {\n      return;\n    }\n\n    const data = new Uint8Array(lookupSize * 4);\n    const scratch = new Color();\n\n    for (let i = 0; i < lookupSize; i++) {\n      const t = i / (lookupSize - 1);\n\n      this.gradient.evaluate(t, scratch);\n\n      const o = i * 4;\n\n      data[o + 0] = scratch.r & 255;\n      data[o + 1] = scratch.g & 255;\n      data[o + 2] = scratch.b & 255;\n      data[o + 3] = ((scratch.a * 255) | 0) & 255;\n    }\n\n    device.queue.writeTexture(\n      { texture },\n      data.buffer,\n      { offset: 0, bytesPerRow: lookupSize * 4, rowsPerImage: 1 },\n      { width: lookupSize, height: 1, depthOrArrayLayers: 1 },\n    );\n  }\n}\n\n/** Texture width for the gradient lookup table. Exposed for ParticleGpuState. */\nexport const colorLookupSize = lookupSize;\n"],"mappings":";;;;AAUA,MAAM,aAAa;;;;;;;;;;AAWnB,IAAa,oBAAb,cAAuC,aAAa;CAClD,AAAO;CAEP,AAAO,YAAY,UAAyB;EAC1C,MAAM;EACN,KAAK,WAAW;CAClB;CAEA,AAAgB,MAAM,WAA0B,KAAmB;EACjE,MAAM,EAAE,SAAS,aAAa,UAAU;EACxC,MAAM,QAAQ,UAAU;EACxB,MAAM,YAAY,UAAU;EAC5B,MAAM,WAAW,KAAK;EAEtB,KAAK,IAAI,IAAI,GAAG,IAAI,WAAW,KAAK;GAClC,MAAM,KAAK,QAAQ,MAAM,MAAM,SAAS,MAAM;GAE9C,MAAM,KAAK,SAAS,aAAa,CAAC;EACpC;CACF;CAEA,AAAgB,OAAyB;EACvC,OAAO;GACL,KAAK;GACL,UAAU,CAAC;IAAE,MAAM;IAAY,QAAQ;GAAa,CAAC;GACrD,MAAM;;;;;;;;;EASR;CACF;CAEA,AAAgB,eAAe,QAAmB,UAAiD;EACjG,MAAM,UAAU,SAAS,IAAI,UAAU;EAEvC,IAAI,YAAY,QACd;EAGF,MAAM,OAAO,IAAI,WAAW,aAAa,CAAC;EAC1C,MAAM,UAAU,IAAI,MAAM;EAE1B,KAAK,IAAI,IAAI,GAAG,IAAI,YAAY,KAAK;GACnC,MAAM,IAAI,IAAK;GAEf,KAAK,SAAS,SAAS,GAAG,OAAO;GAEjC,MAAM,IAAI,IAAI;GAEd,KAAK,IAAI,KAAK,QAAQ,IAAI;GAC1B,KAAK,IAAI,KAAK,QAAQ,IAAI;GAC1B,KAAK,IAAI,KAAK,QAAQ,IAAI;GAC1B,KAAK,IAAI,MAAO,QAAQ,IAAI,MAAO,KAAK;EAC1C;EAEA,OAAO,MAAM,aACX,EAAE,QAAQ,GACV,KAAK,QACL;GAAE,QAAQ;GAAG,aAAa,aAAa;GAAG,cAAc;EAAE,GAC1D;GAAE,OAAO;GAAY,QAAQ;GAAG,oBAAoB;EAAE,CACxD;CACF;AACF"}