@codexo/exojs 0.11.0 → 0.13.0

package/dist/esm/particles/distributions/CircleArea.d.ts

@@ -1,19 +0,0 @@
-import { Vector } from '@/math/Vector';
-import type { Distribution } from './Distribution';
-/**
- * Random point on or inside a circle of radius `radius`, centred at
- * `(centerX, centerY)`. With `mode: 'edge'` the result lies exactly on the
- * circumference; with `mode: 'volume'` (default) it lies anywhere in the
- * disk, with uniform area density (sqrt-of-random-radius distribution).
- *
- * Use as a spawn-position distribution for circular emitters.
- */
-export declare class CircleArea implements Distribution<Vector> {
-    centerX: number;
-    centerY: number;
-    radius: number;
-    mode: 'volume' | 'edge';
-    private readonly _scratch;
-    constructor(centerX: number, centerY: number, radius: number, mode?: 'volume' | 'edge');
-    sample(out?: Vector): Vector;
-}

package/dist/esm/particles/distributions/CircleArea.js

@@ -1,33 +0,0 @@
-import { Vector } from '../../math/Vector.js';
-
-const tau = Math.PI * 2;
-/**
- * Random point on or inside a circle of radius `radius`, centred at
- * `(centerX, centerY)`. With `mode: 'edge'` the result lies exactly on the
- * circumference; with `mode: 'volume'` (default) it lies anywhere in the
- * disk, with uniform area density (sqrt-of-random-radius distribution).
- *
- * Use as a spawn-position distribution for circular emitters.
- */
-class CircleArea {
-    centerX;
-    centerY;
-    radius;
-    mode;
-    _scratch = new Vector();
-    constructor(centerX, centerY, radius, mode = 'volume') {
-        this.centerX = centerX;
-        this.centerY = centerY;
-        this.radius = radius;
-        this.mode = mode;
-    }
-    sample(out = this._scratch) {
-        const angle = Math.random() * tau;
-        const r = this.mode === 'edge' ? this.radius : this.radius * Math.sqrt(Math.random());
-        out.set(this.centerX + Math.cos(angle) * r, this.centerY + Math.sin(angle) * r);
-        return out;
-    }
-}
-
-export { CircleArea };
-//# sourceMappingURL=CircleArea.js.map

package/dist/esm/particles/distributions/CircleArea.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"CircleArea.js","sources":["../../../../../src/particles/distributions/CircleArea.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC;AAEvB;;;;;;;AAOG;MACU,UAAU,CAAA;AAIZ,IAAA,OAAA;AACA,IAAA,OAAA;AACA,IAAA,MAAA;AACA,IAAA,IAAA;AANQ,IAAA,QAAQ,GAAG,IAAI,MAAM,EAAE;AAExC,IAAA,WAAA,CACS,OAAe,EACf,OAAe,EACf,MAAc,EACd,OAA0B,QAAQ,EAAA;QAHlC,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,OAAO,GAAP,OAAO;QACP,IAAA,CAAA,MAAM,GAAN,MAAM;QACN,IAAA,CAAA,IAAI,GAAJ,IAAI;IACV;AAEI,IAAA,MAAM,CAAC,GAAA,GAAc,IAAI,CAAC,QAAQ,EAAA;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG;AACjC,QAAA,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;AAErF,QAAA,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AAE/E,QAAA,OAAO,GAAG;IACZ;AACD;;;;"}

package/dist/esm/particles/distributions/ColorGradient.d.ts

@@ -1,40 +0,0 @@
-import { Color } from '@/core/Color';
-import type { LifetimeFunction } from './Distribution';
-/** A keyframe in a {@link ColorGradient}: color at lifetime ratio `t` in `[0, 1]`. */
-export interface ColorGradientKey {
-    t: number;
-    color: Color;
-}
-/**
- * Piecewise-linear color gradient sampled by lifetime ratio `t` in `[0, 1]`.
- * Keyframes are stored sorted by `t`; sampling outside the range returns
- * the nearest endpoint color. Like {@link Curve}, the last accessed segment
- * is cached so monotonically advancing `t` is O(1) amortised.
- *
- * Two output paths:
- * - {@link evaluate} — writes into a `Color` instance (own scratch by default).
- * - {@link evaluateRgba} — returns the packed `0xAABBGGRR` u32 directly,
- *   skipping the Color object. Use this in tight per-particle inner loops
- *   that write into a `Uint32Array` instance buffer.
- *
- * @example
- * const fire = new ColorGradient([
- *     { t: 0,   color: new Color(1, 1, 1, 1) },     // white
- *     { t: 0.3, color: new Color(1, 0.7, 0.1, 1) }, // orange
- *     { t: 0.7, color: new Color(0.4, 0.1, 0, 0.6) },
- *     { t: 1,   color: new Color(0, 0, 0, 0) },     // transparent black
- * ]);
- */
-export declare class ColorGradient implements LifetimeFunction<Color> {
-    private readonly _keys;
-    private readonly _scratch;
-    private _lastSegment;
-    constructor(keys: readonly ColorGradientKey[]);
-    evaluate(t: number, out?: Color): Color;
-    /**
-     * Returns the gradient sample at `t` packed into a single 32-bit RGBA
-     * integer (`0xAABBGGRR`). Avoids the {@link Color} object on the hot
-     * path; suitable for direct write into a `Uint32Array` instance buffer.
-     */
-    evaluateRgba(t: number): number;
-}

package/dist/esm/particles/distributions/ColorGradient.js

@@ -1,72 +0,0 @@
-import { Color } from '../../core/Color.js';
-
-const compareT = (a, b) => a.t - b.t;
-/**
- * Piecewise-linear color gradient sampled by lifetime ratio `t` in `[0, 1]`.
- * Keyframes are stored sorted by `t`; sampling outside the range returns
- * the nearest endpoint color. Like {@link Curve}, the last accessed segment
- * is cached so monotonically advancing `t` is O(1) amortised.
- *
- * Two output paths:
- * - {@link evaluate} — writes into a `Color` instance (own scratch by default).
- * - {@link evaluateRgba} — returns the packed `0xAABBGGRR` u32 directly,
- *   skipping the Color object. Use this in tight per-particle inner loops
- *   that write into a `Uint32Array` instance buffer.
- *
- * @example
- * const fire = new ColorGradient([
- *     { t: 0,   color: new Color(1, 1, 1, 1) },     // white
- *     { t: 0.3, color: new Color(1, 0.7, 0.1, 1) }, // orange
- *     { t: 0.7, color: new Color(0.4, 0.1, 0, 0.6) },
- *     { t: 1,   color: new Color(0, 0, 0, 0) },     // transparent black
- * ]);
- */
-class ColorGradient {
-    _keys;
-    _scratch = new Color();
-    _lastSegment = 0;
-    constructor(keys) {
-        if (keys.length === 0) {
-            throw new Error('ColorGradient requires at least one keyframe.');
-        }
-        this._keys = [...keys].map(k => ({ t: k.t, color: k.color.clone() })).sort(compareT);
-    }
-    evaluate(t, out = this._scratch) {
-        const keys = this._keys;
-        const last = keys.length - 1;
-        if (t <= keys[0].t) {
-            out.copy(keys[0].color);
-            return out;
-        }
-        if (t >= keys[last].t) {
-            out.copy(keys[last].color);
-            return out;
-        }
-        let segment = this._lastSegment;
-        if (t < keys[segment].t) {
-            segment = 0;
-        }
-        while (segment < last && t > keys[segment + 1].t) {
-            segment++;
-        }
-        this._lastSegment = segment;
-        const a = keys[segment].color;
-        const b = keys[segment + 1].color;
-        const ka = keys[segment].t;
-        const kb = keys[segment + 1].t;
-        const ratio = (t - ka) / (kb - ka);
-        out.set(a.r + (b.r - a.r) * ratio, a.g + (b.g - a.g) * ratio, a.b + (b.b - a.b) * ratio, a.a + (b.a - a.a) * ratio);
-        return out;
-    }
-    /**
-     * Returns the gradient sample at `t` packed into a single 32-bit RGBA
-     * integer (`0xAABBGGRR`). Avoids the {@link Color} object on the hot
-     * path; suitable for direct write into a `Uint32Array` instance buffer.
-     */
-    evaluateRgba(t) {
-        return this.evaluate(t, this._scratch).toRgba();
-    }
-}
-
-export { ColorGradient };
-//# sourceMappingURL=ColorGradient.js.map

package/dist/esm/particles/distributions/ColorGradient.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ColorGradient.js","sources":["../../../../../src/particles/distributions/ColorGradient.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/particles/distributions/ConeDirection.d.ts

@@ -1,28 +0,0 @@
-import { Vector } from '@/math/Vector';
-import type { Distribution } from './Distribution';
-/**
- * Random unit vector inside a cone, scaled by a speed magnitude.
- *
- * The cone is centred on `directionAngle` (in radians, 0 = +X, π/2 = +Y for
- * screen-down coordinates) and spans `±halfAngle` radians around it. Speed
- * is sampled uniformly in `[minSpeed, maxSpeed]`.
- *
- * Use for emission cones, explosions, fountain spread — anywhere the
- * direction has a preferred axis with bounded variance.
- *
- * @example
- * // Upward fountain with ±15° spread, 200-300 px/s:
- * const up = new ConeDirection(-Math.PI / 2, Math.PI / 12, 200, 300);
- * up.sample(particle.velocity);
- */
-export declare class ConeDirection implements Distribution<Vector> {
-    directionAngle: number;
-    halfAngle: number;
-    minSpeed: number;
-    maxSpeed: number;
-    private readonly _scratch;
-    constructor(directionAngle: number, halfAngle: number, minSpeed: number, maxSpeed: number);
-    sample(out?: Vector): Vector;
-    /** Convenience: omnidirectional emission (full circle, 0..2π). */
-    static omni(minSpeed: number, maxSpeed: number): ConeDirection;
-}

package/dist/esm/particles/distributions/ConeDirection.js

@@ -1,44 +0,0 @@
-import { Vector } from '../../math/Vector.js';
-
-const tau = Math.PI * 2;
-/**
- * Random unit vector inside a cone, scaled by a speed magnitude.
- *
- * The cone is centred on `directionAngle` (in radians, 0 = +X, π/2 = +Y for
- * screen-down coordinates) and spans `±halfAngle` radians around it. Speed
- * is sampled uniformly in `[minSpeed, maxSpeed]`.
- *
- * Use for emission cones, explosions, fountain spread — anywhere the
- * direction has a preferred axis with bounded variance.
- *
- * @example
- * // Upward fountain with ±15° spread, 200-300 px/s:
- * const up = new ConeDirection(-Math.PI / 2, Math.PI / 12, 200, 300);
- * up.sample(particle.velocity);
- */
-class ConeDirection {
-    directionAngle;
-    halfAngle;
-    minSpeed;
-    maxSpeed;
-    _scratch = new Vector();
-    constructor(directionAngle, halfAngle, minSpeed, maxSpeed) {
-        this.directionAngle = directionAngle;
-        this.halfAngle = halfAngle;
-        this.minSpeed = minSpeed;
-        this.maxSpeed = maxSpeed;
-    }
-    sample(out = this._scratch) {
-        const angle = this.directionAngle + (Math.random() * 2 - 1) * this.halfAngle;
-        const speed = this.minSpeed + Math.random() * (this.maxSpeed - this.minSpeed);
-        out.set(Math.cos(angle) * speed, Math.sin(angle) * speed);
-        return out;
-    }
-    /** Convenience: omnidirectional emission (full circle, 0..2π). */
-    static omni(minSpeed, maxSpeed) {
-        return new ConeDirection(0, tau / 2, minSpeed, maxSpeed);
-    }
-}
-
-export { ConeDirection };
-//# sourceMappingURL=ConeDirection.js.map

package/dist/esm/particles/distributions/ConeDirection.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ConeDirection.js","sources":["../../../../../src/particles/distributions/ConeDirection.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC;AAEvB;;;;;;;;;;;;;;AAcG;MACU,aAAa,CAAA;AAIf,IAAA,cAAA;AACA,IAAA,SAAA;AACA,IAAA,QAAA;AACA,IAAA,QAAA;AANQ,IAAA,QAAQ,GAAG,IAAI,MAAM,EAAE;AAExC,IAAA,WAAA,CACS,cAAsB,EACtB,SAAiB,EACjB,QAAgB,EAChB,QAAgB,EAAA;QAHhB,IAAA,CAAA,cAAc,GAAd,cAAc;QACd,IAAA,CAAA,SAAS,GAAT,SAAS;QACT,IAAA,CAAA,QAAQ,GAAR,QAAQ;QACR,IAAA,CAAA,QAAQ,GAAR,QAAQ;IACd;AAEI,IAAA,MAAM,CAAC,GAAA,GAAc,IAAI,CAAC,QAAQ,EAAA;QACvC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS;QAC5E,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE7E,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AAEzD,QAAA,OAAO,GAAG;IACZ;;AAGO,IAAA,OAAO,IAAI,CAAC,QAAgB,EAAE,QAAgB,EAAA;AACnD,QAAA,OAAO,IAAI,aAAa,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC;IAC1D;AACD;;;;"}

package/dist/esm/particles/distributions/Constant.d.ts

@@ -1,17 +0,0 @@
-import type { Distribution, LifetimeFunction } from './Distribution';
-/**
- * Distribution that always returns the same value. Implements both
- * {@link Distribution} and {@link LifetimeFunction} so it can stand in
- * wherever a randomized or time-parameterised value is expected.
- *
- * For mutable types (Vector, Color, ...) the constant value is copied into
- * `out` if provided, otherwise the constructor's value is returned directly.
- * Mutating that returned reference mutates the distribution's source.
- */
-export declare class Constant<T> implements Distribution<T>, LifetimeFunction<T> {
-    value: T;
-    constructor(value: T);
-    sample(out?: T): T;
-    evaluate(_t: number, out?: T): T;
-    private _copyOrReturn;
-}

package/dist/esm/particles/distributions/Constant.js

@@ -1,35 +0,0 @@
-/**
- * Distribution that always returns the same value. Implements both
- * {@link Distribution} and {@link LifetimeFunction} so it can stand in
- * wherever a randomized or time-parameterised value is expected.
- *
- * For mutable types (Vector, Color, ...) the constant value is copied into
- * `out` if provided, otherwise the constructor's value is returned directly.
- * Mutating that returned reference mutates the distribution's source.
- */
-class Constant {
-    value;
-    constructor(value) {
-        this.value = value;
-    }
-    sample(out) {
-        return this._copyOrReturn(out);
-    }
-    evaluate(_t, out) {
-        return this._copyOrReturn(out);
-    }
-    _copyOrReturn(out) {
-        if (out === undefined || out === null) {
-            return this.value;
-        }
-        const target = out;
-        if (typeof target.copy === 'function') {
-            target.copy(this.value);
-            return out;
-        }
-        return this.value;
-    }
-}
-
-export { Constant };
-//# sourceMappingURL=Constant.js.map

package/dist/esm/particles/distributions/Constant.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Constant.js","sources":["../../../../../src/particles/distributions/Constant.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;AAQG;MACU,QAAQ,CAAA;AACO,IAAA,KAAA;AAA1B,IAAA,WAAA,CAA0B,KAAQ,EAAA;QAAR,IAAA,CAAA,KAAK,GAAL,KAAK;IAAM;AAE9B,IAAA,MAAM,CAAC,GAAO,EAAA;AACnB,QAAA,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;IAChC;IAEO,QAAQ,CAAC,EAAU,EAAE,GAAO,EAAA;AACjC,QAAA,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;IAChC;AAEQ,IAAA,aAAa,CAAC,GAAO,EAAA;QAC3B,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,EAAE;YACrC,OAAO,IAAI,CAAC,KAAK;QACnB;QAEA,MAAM,MAAM,GAAG,GAAqC;AAEpD,QAAA,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,EAAE;AACrC,YAAA,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;AAEvB,YAAA,OAAO,GAAG;QACZ;QAEA,OAAO,IAAI,CAAC,KAAK;IACnB;AACD;;;;"}

package/dist/esm/particles/distributions/Curve.d.ts

@@ -1,30 +0,0 @@
-import type { LifetimeFunction } from './Distribution';
-/** A keyframe in a {@link Curve}: value `v` at lifetime ratio `t` in `[0, 1]`. */
-export interface CurveKey {
-    t: number;
-    v: number;
-}
-/**
- * Piecewise-linear keyframe curve sampled by lifetime ratio `t` in `[0, 1]`.
- *
- * Keyframes are stored sorted by `t` and clamped at the endpoints — sampling
- * outside the keyframe range returns the nearest endpoint value. The
- * implementation tracks the last accessed segment so monotonically advancing
- * `t` (the typical case for per-particle lifetime sampling) costs O(1)
- * amortized per call instead of O(log n).
- *
- * @example
- * // Scale pulses up then down over lifetime:
- * const sizeCurve = new Curve([
- *     { t: 0,    v: 0.2 },
- *     { t: 0.4,  v: 1.5 },
- *     { t: 1,    v: 0.0 },
- * ]);
- * scale.x = scale.y = sizeCurve.evaluate(particle.elapsedRatio);
- */
-export declare class Curve implements LifetimeFunction<number> {
-    private readonly _keys;
-    private _lastSegment;
-    constructor(keys: readonly CurveKey[]);
-    evaluate(t: number): number;
-}

package/dist/esm/particles/distributions/Curve.js

@@ -1,53 +0,0 @@
-const compareT = (a, b) => a.t - b.t;
-/**
- * Piecewise-linear keyframe curve sampled by lifetime ratio `t` in `[0, 1]`.
- *
- * Keyframes are stored sorted by `t` and clamped at the endpoints — sampling
- * outside the keyframe range returns the nearest endpoint value. The
- * implementation tracks the last accessed segment so monotonically advancing
- * `t` (the typical case for per-particle lifetime sampling) costs O(1)
- * amortized per call instead of O(log n).
- *
- * @example
- * // Scale pulses up then down over lifetime:
- * const sizeCurve = new Curve([
- *     { t: 0,    v: 0.2 },
- *     { t: 0.4,  v: 1.5 },
- *     { t: 1,    v: 0.0 },
- * ]);
- * scale.x = scale.y = sizeCurve.evaluate(particle.elapsedRatio);
- */
-class Curve {
-    _keys;
-    _lastSegment = 0;
-    constructor(keys) {
-        if (keys.length === 0) {
-            throw new Error('Curve requires at least one keyframe.');
-        }
-        this._keys = [...keys].sort(compareT);
-    }
-    evaluate(t) {
-        const keys = this._keys;
-        const last = keys.length - 1;
-        if (t <= keys[0].t)
-            return keys[0].v;
-        if (t >= keys[last].t)
-            return keys[last].v;
-        // Cache-friendly forward search: most callers sweep t monotonically.
-        let segment = this._lastSegment;
-        if (t < keys[segment].t) {
-            segment = 0;
-        }
-        while (segment < last && t > keys[segment + 1].t) {
-            segment++;
-        }
-        this._lastSegment = segment;
-        const a = keys[segment];
-        const b = keys[segment + 1];
-        const ratio = (t - a.t) / (b.t - a.t);
-        return a.v + (b.v - a.v) * ratio;
-    }
-}
-
-export { Curve };
-//# sourceMappingURL=Curve.js.map

package/dist/esm/particles/distributions/Curve.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Curve.js","sources":["../../../../../src/particles/distributions/Curve.ts"],"sourcesContent":[null],"names":[],"mappings":"AAQA,MAAM,QAAQ,GAAG,CAAC,CAAW,EAAE,CAAW,KAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAEhE;;;;;;;;;;;;;;;;;AAiBG;MACU,KAAK,CAAA;AACC,IAAA,KAAK;IACd,YAAY,GAAG,CAAC;AAExB,IAAA,WAAA,CAAmB,IAAyB,EAAA;AAC1C,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACrB,YAAA,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC;QAC1D;AAEA,QAAA,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;IACvC;AAEO,IAAA,QAAQ,CAAC,CAAS,EAAA;AACvB,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK;AACvB,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC;AAE5B,QAAA,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAAE,YAAA,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,QAAA,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAAE,YAAA,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;;AAG1C,QAAA,IAAI,OAAO,GAAG,IAAI,CAAC,YAAY;QAE/B,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;YACvB,OAAO,GAAG,CAAC;QACb;AAEA,QAAA,OAAO,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;AAChD,YAAA,OAAO,EAAE;QACX;AAEA,QAAA,IAAI,CAAC,YAAY,GAAG,OAAO;AAE3B,QAAA,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;AAC3B,QAAA,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAErC,QAAA,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK;IAClC;AACD;;;;"}

package/dist/esm/particles/distributions/Distribution.d.ts

@@ -1,45 +0,0 @@
-/**
- * Value distribution sampled at particle spawn time. Each `sample()` call
- * may return a different value — used to randomize spawn properties
- * (lifetime, position, velocity, scale, tint, ...) without per-particle
- * subclassing.
- *
- * Implementations come in two flavours:
- *
- * - **Stateless / scalar** (e.g. {@link Constant}, {@link Range}) just
- *   return a `T` directly.
- * - **Mutable-target** (Vector / Color distributions) accept an optional
- *   `out` parameter and write into it in place. Pass your own scratch
- *   instance to avoid per-spawn heap allocations; omit it to use the
- *   distribution's internal scratch (only valid until the next call).
- *
- * @example
- * const lifetime = new Range(0.5, 1.5);          // seconds, uniform
- * const velocity = new VectorRange(-50, 50, -200, -100);
- * const tint     = new ColorGradient([
- *     { t: 0,   color: Color.white },
- *     { t: 0.7, color: Color.yellow },
- *     { t: 1,   color: Color.transparent },
- * ]);
- *
- * for (let i = 0; i < count; i++) {
- *     particle.totalLifetime = lifetime.sample();
- *     velocity.sample(particle.velocity);
- *     // tint is applied per-frame by ColorOverLifetime, not at spawn.
- * }
- */
-export interface Distribution<T> {
-    sample(out?: T): T;
-}
-/**
- * Lifetime-parameterised function that produces a deterministic `T` for a
- * given lifetime ratio `t` in `[0, 1]`. Used by per-frame update modules
- * that interpolate over particle lifetime — `ColorOverLifetime` (ColorGradient),
- * `ScaleOverLifetime` (Curve), etc.
- *
- * Mutable-target rule: same as {@link Distribution} — pass your own scratch
- * via `out` for hot loops, omit for one-off calls.
- */
-export interface LifetimeFunction<T> {
-    evaluate(t: number, out?: T): T;
-}

package/dist/esm/particles/distributions/LineSegment.d.ts

@@ -1,15 +0,0 @@
-import { Vector } from '@/math/Vector';
-import type { Distribution } from './Distribution';
-/**
- * Random point on a line segment between `(x0, y0)` and `(x1, y1)`. Uniform
- * parameter distribution: `t = Math.random()` then `lerp(start, end, t)`.
- */
-export declare class LineSegment implements Distribution<Vector> {
-    x0: number;
-    y0: number;
-    x1: number;
-    y1: number;
-    private readonly _scratch;
-    constructor(x0: number, y0: number, x1: number, y1: number);
-    sample(out?: Vector): Vector;
-}

package/dist/esm/particles/distributions/LineSegment.js

@@ -1,27 +0,0 @@
-import { Vector } from '../../math/Vector.js';
-
-/**
- * Random point on a line segment between `(x0, y0)` and `(x1, y1)`. Uniform
- * parameter distribution: `t = Math.random()` then `lerp(start, end, t)`.
- */
-class LineSegment {
-    x0;
-    y0;
-    x1;
-    y1;
-    _scratch = new Vector();
-    constructor(x0, y0, x1, y1) {
-        this.x0 = x0;
-        this.y0 = y0;
-        this.x1 = x1;
-        this.y1 = y1;
-    }
-    sample(out = this._scratch) {
-        const t = Math.random();
-        out.set(this.x0 + (this.x1 - this.x0) * t, this.y0 + (this.y1 - this.y0) * t);
-        return out;
-    }
-}
-
-export { LineSegment };
-//# sourceMappingURL=LineSegment.js.map

package/dist/esm/particles/distributions/LineSegment.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LineSegment.js","sources":["../../../../../src/particles/distributions/LineSegment.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;AAGG;MACU,WAAW,CAAA;AAIb,IAAA,EAAA;AACA,IAAA,EAAA;AACA,IAAA,EAAA;AACA,IAAA,EAAA;AANQ,IAAA,QAAQ,GAAG,IAAI,MAAM,EAAE;AAExC,IAAA,WAAA,CACS,EAAU,EACV,EAAU,EACV,EAAU,EACV,EAAU,EAAA;QAHV,IAAA,CAAA,EAAE,GAAF,EAAE;QACF,IAAA,CAAA,EAAE,GAAF,EAAE;QACF,IAAA,CAAA,EAAE,GAAF,EAAE;QACF,IAAA,CAAA,EAAE,GAAF,EAAE;IACR;AAEI,IAAA,MAAM,CAAC,GAAA,GAAc,IAAI,CAAC,QAAQ,EAAA;AACvC,QAAA,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE;AAEvB,QAAA,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AAE7E,QAAA,OAAO,GAAG;IACZ;AACD;;;;"}

package/dist/esm/particles/distributions/Range.d.ts

@@ -1,12 +0,0 @@
-import type { Distribution } from './Distribution';
-/**
- * Uniform random number in `[min, max]`. Each `sample()` returns a fresh
- * roll; the bounds are inclusive on both ends (modulo the rounding bias
- * inherent to `Math.random()`).
- */
-export declare class Range implements Distribution<number> {
-    min: number;
-    max: number;
-    constructor(min: number, max: number);
-    sample(): number;
-}

package/dist/esm/particles/distributions/Range.js

@@ -1,19 +0,0 @@
-/**
- * Uniform random number in `[min, max]`. Each `sample()` returns a fresh
- * roll; the bounds are inclusive on both ends (modulo the rounding bias
- * inherent to `Math.random()`).
- */
-class Range {
-    min;
-    max;
-    constructor(min, max) {
-        this.min = min;
-        this.max = max;
-    }
-    sample() {
-        return this.min + Math.random() * (this.max - this.min);
-    }
-}
-
-export { Range };
-//# sourceMappingURL=Range.js.map

package/dist/esm/particles/distributions/Range.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"Range.js","sources":["../../../../../src/particles/distributions/Range.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;AAIG;MACU,KAAK,CAAA;AAEP,IAAA,GAAA;AACA,IAAA,GAAA;IAFT,WAAA,CACS,GAAW,EACX,GAAW,EAAA;QADX,IAAA,CAAA,GAAG,GAAH,GAAG;QACH,IAAA,CAAA,GAAG,GAAH,GAAG;IACT;IAEI,MAAM,GAAA;AACX,QAAA,OAAO,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACzD;AACD;;;;"}

package/dist/esm/particles/distributions/VectorRange.d.ts

@@ -1,20 +0,0 @@
-import { Vector } from '@/math/Vector';
-import type { Distribution } from './Distribution';
-/**
- * Uniform random vector with each axis sampled independently in its own
- * `[min, max]` range. Each `sample()` writes into the provided `out` Vector
- * (or an internal scratch instance when `out` is omitted).
- *
- * @example
- * const knockback = new VectorRange(-300, 300, -800, -200);  // any X, upward Y
- * knockback.sample(particle.velocity);  // writes into existing instance, no alloc
- */
-export declare class VectorRange implements Distribution<Vector> {
-    minX: number;
-    maxX: number;
-    minY: number;
-    maxY: number;
-    private readonly _scratch;
-    constructor(minX: number, maxX: number, minY: number, maxY: number);
-    sample(out?: Vector): Vector;
-}

package/dist/esm/particles/distributions/VectorRange.js

@@ -1,31 +0,0 @@
-import { Vector } from '../../math/Vector.js';
-
-/**
- * Uniform random vector with each axis sampled independently in its own
- * `[min, max]` range. Each `sample()` writes into the provided `out` Vector
- * (or an internal scratch instance when `out` is omitted).
- *
- * @example
- * const knockback = new VectorRange(-300, 300, -800, -200);  // any X, upward Y
- * knockback.sample(particle.velocity);  // writes into existing instance, no alloc
- */
-class VectorRange {
-    minX;
-    maxX;
-    minY;
-    maxY;
-    _scratch = new Vector();
-    constructor(minX, maxX, minY, maxY) {
-        this.minX = minX;
-        this.maxX = maxX;
-        this.minY = minY;
-        this.maxY = maxY;
-    }
-    sample(out = this._scratch) {
-        out.set(this.minX + Math.random() * (this.maxX - this.minX), this.minY + Math.random() * (this.maxY - this.minY));
-        return out;
-    }
-}
-
-export { VectorRange };
-//# sourceMappingURL=VectorRange.js.map

package/dist/esm/particles/distributions/VectorRange.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"VectorRange.js","sources":["../../../../../src/particles/distributions/VectorRange.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAIA;;;;;;;;AAQG;MACU,WAAW,CAAA;AAIb,IAAA,IAAA;AACA,IAAA,IAAA;AACA,IAAA,IAAA;AACA,IAAA,IAAA;AANQ,IAAA,QAAQ,GAAG,IAAI,MAAM,EAAE;AAExC,IAAA,WAAA,CACS,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,IAAY,EAAA;QAHZ,IAAA,CAAA,IAAI,GAAJ,IAAI;QACJ,IAAA,CAAA,IAAI,GAAJ,IAAI;QACJ,IAAA,CAAA,IAAI,GAAJ,IAAI;QACJ,IAAA,CAAA,IAAI,GAAJ,IAAI;IACV;AAEI,IAAA,MAAM,CAAC,GAAA,GAAc,IAAI,CAAC,QAAQ,EAAA;AACvC,QAAA,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AAEjH,QAAA,OAAO,GAAG;IACZ;AACD;;;;"}

package/dist/esm/particles/distributions/index.d.ts

@@ -1,12 +0,0 @@
-export { BoxArea } from './BoxArea';
-export { CircleArea } from './CircleArea';
-export type { ColorGradientKey } from './ColorGradient';
-export { ColorGradient } from './ColorGradient';
-export { ConeDirection } from './ConeDirection';
-export { Constant } from './Constant';
-export type { CurveKey } from './Curve';
-export { Curve } from './Curve';
-export type { Distribution, LifetimeFunction } from './Distribution';
-export { LineSegment } from './LineSegment';
-export { Range } from './Range';
-export { VectorRange } from './VectorRange';