@codexo/exojs 0.7.12 → 0.8.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@codexo/exojs",
   "description": "A TypeScript-first browser 2D runtime for games and interactive apps.",
-  "version": "0.7.12",
+  "version": "0.8.0",
   "type": "module",
   "files": [
     "dist/esm/",
@@ -47,6 +47,7 @@
     "verify:exports": "tsx ./scripts/verify-exports.ts",
     "verify:package": "npm run build && npm run verify:exports && npm pack --dry-run --ignore-scripts",
     "verify:release": "npm run typecheck && npm run lint && npm test && npm run verify:package",
+    "release": "node ./scripts/release.mjs",
     "prepack": "npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",

package/dist/esm/input/GamepadChannels.d.ts

@@ -1,47 +0,0 @@
-/**
- * Canonical channel identifiers for every control a standard gamepad can expose.
- *
- * Values are absolute offsets into the engine's shared {@link Float32Array} input
- * channel buffer — each member equals `ChannelOffset.Gamepads + localIndex`.
- * Use {@link Gamepad.resolveChannelOffset} to account for per-slot skew when
- * reading a specific gamepad's data.
- */
-export declare enum GamepadChannel {
-    ButtonSouth = 512,
-    ButtonWest = 513,
-    ButtonEast = 514,
-    ButtonNorth = 515,
-    LeftShoulder = 516,
-    RightShoulder = 517,
-    LeftTrigger = 518,
-    RightTrigger = 519,
-    Select = 520,
-    Start = 521,
-    LeftStick = 522,
-    RightStick = 523,
-    DPadUp = 524,
-    DPadDown = 525,
-    DPadLeft = 526,
-    DPadRight = 527,
-    Guide = 528,
-    Share = 529,
-    Capture = 530,
-    Touchpad = 531,
-    Paddle1 = 532,
-    LeftStickLeft = 533,
-    LeftStickRight = 534,
-    LeftStickUp = 535,
-    LeftStickDown = 536,
-    RightStickLeft = 537,
-    RightStickRight = 538,
-    RightStickUp = 539,
-    RightStickDown = 540,
-    AuxiliaryAxis0Negative = 541,
-    AuxiliaryAxis0Positive = 542,
-    AuxiliaryAxis1Negative = 543,
-    AuxiliaryAxis1Positive = 544,
-    AuxiliaryAxis2Negative = 545,
-    AuxiliaryAxis2Positive = 546,
-    AuxiliaryAxis3Negative = 547,
-    AuxiliaryAxis3Positive = 548
-}

package/dist/esm/input/GamepadChannels.js

@@ -1,53 +0,0 @@
-import './types.js';
-
-/**
- * Canonical channel identifiers for every control a standard gamepad can expose.
- *
- * Values are absolute offsets into the engine's shared {@link Float32Array} input
- * channel buffer — each member equals `ChannelOffset.Gamepads + localIndex`.
- * Use {@link Gamepad.resolveChannelOffset} to account for per-slot skew when
- * reading a specific gamepad's data.
- */
-var GamepadChannel;
-(function (GamepadChannel) {
-    GamepadChannel[GamepadChannel["ButtonSouth"] = 512] = "ButtonSouth";
-    GamepadChannel[GamepadChannel["ButtonWest"] = 513] = "ButtonWest";
-    GamepadChannel[GamepadChannel["ButtonEast"] = 514] = "ButtonEast";
-    GamepadChannel[GamepadChannel["ButtonNorth"] = 515] = "ButtonNorth";
-    GamepadChannel[GamepadChannel["LeftShoulder"] = 516] = "LeftShoulder";
-    GamepadChannel[GamepadChannel["RightShoulder"] = 517] = "RightShoulder";
-    GamepadChannel[GamepadChannel["LeftTrigger"] = 518] = "LeftTrigger";
-    GamepadChannel[GamepadChannel["RightTrigger"] = 519] = "RightTrigger";
-    GamepadChannel[GamepadChannel["Select"] = 520] = "Select";
-    GamepadChannel[GamepadChannel["Start"] = 521] = "Start";
-    GamepadChannel[GamepadChannel["LeftStick"] = 522] = "LeftStick";
-    GamepadChannel[GamepadChannel["RightStick"] = 523] = "RightStick";
-    GamepadChannel[GamepadChannel["DPadUp"] = 524] = "DPadUp";
-    GamepadChannel[GamepadChannel["DPadDown"] = 525] = "DPadDown";
-    GamepadChannel[GamepadChannel["DPadLeft"] = 526] = "DPadLeft";
-    GamepadChannel[GamepadChannel["DPadRight"] = 527] = "DPadRight";
-    GamepadChannel[GamepadChannel["Guide"] = 528] = "Guide";
-    GamepadChannel[GamepadChannel["Share"] = 529] = "Share";
-    GamepadChannel[GamepadChannel["Capture"] = 530] = "Capture";
-    GamepadChannel[GamepadChannel["Touchpad"] = 531] = "Touchpad";
-    GamepadChannel[GamepadChannel["Paddle1"] = 532] = "Paddle1";
-    GamepadChannel[GamepadChannel["LeftStickLeft"] = 533] = "LeftStickLeft";
-    GamepadChannel[GamepadChannel["LeftStickRight"] = 534] = "LeftStickRight";
-    GamepadChannel[GamepadChannel["LeftStickUp"] = 535] = "LeftStickUp";
-    GamepadChannel[GamepadChannel["LeftStickDown"] = 536] = "LeftStickDown";
-    GamepadChannel[GamepadChannel["RightStickLeft"] = 537] = "RightStickLeft";
-    GamepadChannel[GamepadChannel["RightStickRight"] = 538] = "RightStickRight";
-    GamepadChannel[GamepadChannel["RightStickUp"] = 539] = "RightStickUp";
-    GamepadChannel[GamepadChannel["RightStickDown"] = 540] = "RightStickDown";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis0Negative"] = 541] = "AuxiliaryAxis0Negative";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis0Positive"] = 542] = "AuxiliaryAxis0Positive";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis1Negative"] = 543] = "AuxiliaryAxis1Negative";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis1Positive"] = 544] = "AuxiliaryAxis1Positive";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis2Negative"] = 545] = "AuxiliaryAxis2Negative";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis2Positive"] = 546] = "AuxiliaryAxis2Positive";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis3Negative"] = 547] = "AuxiliaryAxis3Negative";
-    GamepadChannel[GamepadChannel["AuxiliaryAxis3Positive"] = 548] = "AuxiliaryAxis3Positive";
-})(GamepadChannel || (GamepadChannel = {}));
-
-export { GamepadChannel };
-//# sourceMappingURL=GamepadChannels.js.map

package/dist/esm/input/GamepadChannels.js.map

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

package/dist/esm/input/GamepadControl.d.ts

@@ -1,33 +0,0 @@
-import type { GamepadChannel } from './GamepadChannels';
-/**
- * Construction options for a single {@link GamepadControl}.
- * All fields are optional; defaults produce a plain pass-through control
- * with a 0.2 dead-zone.
- */
-export interface GamepadControlOptions {
-    invert?: boolean;
-    normalize?: boolean;
-    threshold?: number;
-}
-/**
- * Represents a single mappable control — one button or one axis — on a physical gamepad.
- *
- * Stores the raw Gamepad API `index`, the target {@link GamepadChannel}, and the
- * transform parameters (`invert`, `normalize`, `threshold`) applied each frame
- * by {@link transformValue} before the value is written to the channel buffer.
- */
-export declare class GamepadControl {
-    readonly index: number;
-    readonly channel: GamepadChannel;
-    readonly invert: boolean;
-    readonly normalize: boolean;
-    readonly threshold: number;
-    constructor(index: number, channel: GamepadChannel, options?: GamepadControlOptions);
-    /**
-     * Applies the control's transform pipeline to a raw browser value.
-     *
-     * Pipeline: clamp to [-1, 1] → optional invert → optional normalize to [0, 1]
-     * → dead-zone (returns 0 when the absolute result is at or below `threshold`).
-     */
-    transformValue(value: number): number;
-}

package/dist/esm/input/GamepadControl.js

@@ -1,42 +0,0 @@
-import { clamp } from '../math/utils.js';
-
-/**
- * Represents a single mappable control — one button or one axis — on a physical gamepad.
- *
- * Stores the raw Gamepad API `index`, the target {@link GamepadChannel}, and the
- * transform parameters (`invert`, `normalize`, `threshold`) applied each frame
- * by {@link transformValue} before the value is written to the channel buffer.
- */
-class GamepadControl {
-    index;
-    channel;
-    invert;
-    normalize;
-    threshold;
-    constructor(index, channel, options = {}) {
-        this.index = index;
-        this.channel = channel;
-        this.invert = options.invert ?? false;
-        this.normalize = options.normalize ?? false;
-        this.threshold = clamp(options.threshold ?? 0.2, 0, 1);
-    }
-    /**
-     * Applies the control's transform pipeline to a raw browser value.
-     *
-     * Pipeline: clamp to [-1, 1] → optional invert → optional normalize to [0, 1]
-     * → dead-zone (returns 0 when the absolute result is at or below `threshold`).
-     */
-    transformValue(value) {
-        let result = clamp(value, -1, 1);
-        if (this.invert) {
-            result *= -1;
-        }
-        if (this.normalize) {
-            result = (result + 1) / 2;
-        }
-        return result > this.threshold ? result : 0;
-    }
-}
-
-export { GamepadControl };
-//# sourceMappingURL=GamepadControl.js.map

package/dist/esm/input/GamepadControl.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"GamepadControl.js","sources":["../../../../src/input/GamepadControl.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAeA;;;;;;AAMG;MACU,cAAc,CAAA;AACP,IAAA,KAAK;AACL,IAAA,OAAO;AACP,IAAA,MAAM;AACN,IAAA,SAAS;AACT,IAAA,SAAS;AAEzB,IAAA,WAAA,CAAmB,KAAa,EAAE,OAAuB,EAAE,UAAiC,EAAE,EAAA;AAC1F,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;AAClB,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO;QACtB,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK;AAC3C,QAAA,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAC1D;AAEA;;;;;AAKG;AACI,IAAA,cAAc,CAAC,KAAa,EAAA;QAC/B,IAAI,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AAEhC,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;YACb,MAAM,IAAI,EAAE;QAChB;AAEA,QAAA,IAAI,IAAI,CAAC,SAAS,EAAE;YAChB,MAAM,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC;QAC7B;AAEA,QAAA,OAAO,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,MAAM,GAAG,CAAC;IAC/C;AACH;;;;"}

package/dist/esm/input/Input.d.ts

@@ -1,52 +0,0 @@
-import { Signal } from '@/core/Signal';
-import type { Keyboard } from '@/input/types';
-import type { GamepadChannel } from './GamepadChannels';
-/** Convenience options accepted by the {@link Input} constructor. */
-interface InputOptions {
-    onStart?: () => void;
-    onStop?: () => void;
-    onActive?: () => void;
-    onTrigger?: () => void;
-    context?: object;
-    threshold?: number;
-}
-/** Union of channel identifiers an {@link Input} can subscribe to. */
-export type InputChannel = GamepadChannel | Keyboard;
-/**
- * Bind one or more input channels (keyboard keys, gamepad buttons, gamepad
- * axes) to a set of high-level events: `onStart` (became active),
- * `onStop` (became inactive), `onActive` (per-frame while active), and
- * `onTrigger` (released within the threshold window — a "tap"). The current
- * raw value is the max across all subscribed channels.
- *
- * Construct ad-hoc, or via {@link InputManager.add}. Driven by the
- * {@link InputManager} update loop which feeds the unified channel buffer.
- *
- * @example
- * ```ts
- * const jump = new Input([Keyboard.Space, GamepadChannel.FaceA], {
- *     onTrigger: () => player.jump(),
- * });
- * ```
- */
-export declare class Input {
-    static triggerThreshold: number;
-    private readonly channels;
-    private readonly triggerTimer;
-    private valueState;
-    readonly onStart: Signal<[number]>;
-    readonly onStop: Signal<[number]>;
-    readonly onActive: Signal<[number]>;
-    readonly onTrigger: Signal<[number]>;
-    constructor(channels: Array<InputChannel> | InputChannel, { onStart, onStop, onActive, onTrigger, context, threshold }?: InputOptions);
-    get activeChannels(): Set<number>;
-    get value(): number;
-    /**
-     * Read the latest values from the unified channel buffer and dispatch
-     * the appropriate Signals. Called once per frame by {@link InputManager}.
-     * No-op for inputs not bound to any channel.
-     */
-    update(channels: Float32Array): this;
-    destroy(): void;
-}
-export {};

package/dist/esm/input/Input.js

@@ -1,90 +0,0 @@
-import { Signal } from '../core/Signal.js';
-import { Timer } from '../core/Timer.js';
-import { milliseconds } from '../core/utils.js';
-
-/**
- * Bind one or more input channels (keyboard keys, gamepad buttons, gamepad
- * axes) to a set of high-level events: `onStart` (became active),
- * `onStop` (became inactive), `onActive` (per-frame while active), and
- * `onTrigger` (released within the threshold window — a "tap"). The current
- * raw value is the max across all subscribed channels.
- *
- * Construct ad-hoc, or via {@link InputManager.add}. Driven by the
- * {@link InputManager} update loop which feeds the unified channel buffer.
- *
- * @example
- * ```ts
- * const jump = new Input([Keyboard.Space, GamepadChannel.FaceA], {
- *     onTrigger: () => player.jump(),
- * });
- * ```
- */
-class Input {
-    static triggerThreshold = 300;
-    channels = new Set();
-    triggerTimer;
-    valueState = 0;
-    onStart = new Signal();
-    onStop = new Signal();
-    onActive = new Signal();
-    onTrigger = new Signal();
-    constructor(channels, { onStart, onStop, onActive, onTrigger, context, threshold } = {}) {
-        this.channels = new Set(Array.isArray(channels) ? channels : [channels]);
-        this.triggerTimer = new Timer(milliseconds(threshold ?? Input.triggerThreshold));
-        if (onStart) {
-            this.onStart.add(onStart, context);
-        }
-        if (onStop) {
-            this.onStop.add(onStop, context);
-        }
-        if (onActive) {
-            this.onActive.add(onActive, context);
-        }
-        if (onTrigger) {
-            this.onTrigger.add(onTrigger, context);
-        }
-    }
-    get activeChannels() {
-        return this.channels;
-    }
-    get value() {
-        return this.valueState;
-    }
-    /**
-     * Read the latest values from the unified channel buffer and dispatch
-     * the appropriate Signals. Called once per frame by {@link InputManager}.
-     * No-op for inputs not bound to any channel.
-     */
-    update(channels) {
-        this.valueState = 0;
-        for (const channel of this.channels) {
-            this.valueState = Math.max(channels[channel], this.valueState);
-        }
-        if (this.valueState) {
-            if (!this.triggerTimer.running) {
-                this.triggerTimer.restart();
-                this.onStart.dispatch(this.valueState);
-            }
-            this.onActive.dispatch(this.valueState);
-        }
-        else if (this.triggerTimer.running) {
-            this.onStop.dispatch(this.valueState);
-            if (!this.triggerTimer.expired) {
-                this.onTrigger.dispatch(this.valueState);
-            }
-            this.triggerTimer.stop();
-        }
-        return this;
-    }
-    destroy() {
-        this.channels.clear();
-        this.triggerTimer.destroy();
-        this.onStart.destroy();
-        this.onStop.destroy();
-        this.onActive.destroy();
-        this.onTrigger.destroy();
-    }
-}
-
-export { Input };
-//# sourceMappingURL=Input.js.map

package/dist/esm/input/Input.js.map

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

package/dist/esm/particles/Particle.d.ts

@@ -1,77 +0,0 @@
-import { Vector } from '@/math/Vector';
-import { Color } from '@/core/Color';
-import { Time } from '@/core/Time';
-import type { ParticleOptions } from './emitters/ParticleOptions';
-import type { ParticleProperties } from '@/particles/ParticleProperties';
-/**
- * Mutable per-instance state for a single live particle. Implements
- * {@link ParticleProperties} so affectors can mutate it through the shared
- * interface. Particles are pooled by {@link ParticleSystem}: expired instances
- * are moved to the graveyard and reused via {@link ParticleSystem.requestParticle}
- * rather than garbage-collected.
- *
- * Do not construct directly — use {@link ParticleSystem.requestParticle} to
- * obtain a recycled or fresh instance, then configure it through
- * {@link Particle.applyOptions}.
- */
-export declare class Particle implements ParticleProperties {
-    private _totalLifetime;
-    private _elapsedLifetime;
-    private _position;
-    private _velocity;
-    private _scale;
-    private _rotation;
-    private _rotationSpeed;
-    private _textureIndex;
-    private _tint;
-    get totalLifetime(): Time;
-    set totalLifetime(totalLifetime: Time);
-    get elapsedLifetime(): Time;
-    set elapsedLifetime(elapsedLifetime: Time);
-    get position(): Vector;
-    set position(position: Vector);
-    get velocity(): Vector;
-    set velocity(velocity: Vector);
-    get scale(): Vector;
-    set scale(scale: Vector);
-    get tint(): Color;
-    set tint(tint: Color);
-    get rotation(): number;
-    set rotation(degrees: number);
-    get rotationSpeed(): number;
-    set rotationSpeed(rotationSpeed: number);
-    get textureIndex(): number;
-    set textureIndex(textureIndex: number);
-    /**
-     * Time remaining before this particle expires, returned via the shared
-     * `Time.temp` scratch value — copy before storing if you need it beyond
-     * the current frame.
-     */
-    get remainingLifetime(): Time;
-    /**
-     * Fraction of total lifetime already elapsed, in [0, 1]. Used by
-     * {@link ColorAffector} as the interpolation factor for tint blending.
-     */
-    get elapsedRatio(): number;
-    /** Fraction of total lifetime still remaining, in [0, 1]. */
-    get remainingRatio(): number;
-    /**
-     * Returns `true` once `elapsedLifetime` exceeds `totalLifetime`. Expired
-     * particles are moved to the graveyard by {@link ParticleSystem.update}
-     * before affectors run.
-     */
-    get expired(): boolean;
-    /**
-     * Bulk-copies every field from `options` into this particle, replacing all
-     * previous state. Called immediately after {@link ParticleSystem.requestParticle}
-     * to configure a recycled particle for reuse.
-     */
-    applyOptions(options: ParticleOptions): this;
-    /**
-     * Destroys all owned value objects. Called by
-     * {@link ParticleSystem.clearParticles} when the pool is flushed entirely.
-     * Do not call on individual particles mid-simulation; let the system
-     * recycle them via the graveyard instead.
-     */
-    destroy(): void;
-}

package/dist/esm/particles/Particle.js

@@ -1,143 +0,0 @@
-import { Vector } from '../math/Vector.js';
-import { Color } from '../core/Color.js';
-import { Time } from '../core/Time.js';
-import { trimRotation } from '../math/utils.js';
-
-/**
- * Mutable per-instance state for a single live particle. Implements
- * {@link ParticleProperties} so affectors can mutate it through the shared
- * interface. Particles are pooled by {@link ParticleSystem}: expired instances
- * are moved to the graveyard and reused via {@link ParticleSystem.requestParticle}
- * rather than garbage-collected.
- *
- * Do not construct directly — use {@link ParticleSystem.requestParticle} to
- * obtain a recycled or fresh instance, then configure it through
- * {@link Particle.applyOptions}.
- */
-class Particle {
-    _totalLifetime = Time.oneSecond.clone();
-    _elapsedLifetime = Time.zero.clone();
-    _position = Vector.zero.clone();
-    _velocity = Vector.zero.clone();
-    _scale = Vector.one.clone();
-    _rotation = 0;
-    _rotationSpeed = 0;
-    _textureIndex = 0;
-    _tint = Color.white.clone();
-    get totalLifetime() {
-        return this._totalLifetime;
-    }
-    set totalLifetime(totalLifetime) {
-        this._totalLifetime.copy(totalLifetime);
-    }
-    get elapsedLifetime() {
-        return this._elapsedLifetime;
-    }
-    set elapsedLifetime(elapsedLifetime) {
-        this._elapsedLifetime.copy(elapsedLifetime);
-    }
-    get position() {
-        return this._position;
-    }
-    set position(position) {
-        this._position.copy(position);
-    }
-    get velocity() {
-        return this._velocity;
-    }
-    set velocity(velocity) {
-        this._velocity.copy(velocity);
-    }
-    get scale() {
-        return this._scale;
-    }
-    set scale(scale) {
-        this._scale.copy(scale);
-    }
-    get tint() {
-        return this._tint;
-    }
-    set tint(tint) {
-        this._tint.copy(tint);
-    }
-    get rotation() {
-        return this._rotation;
-    }
-    set rotation(degrees) {
-        this._rotation = trimRotation(degrees);
-    }
-    get rotationSpeed() {
-        return this._rotationSpeed;
-    }
-    set rotationSpeed(rotationSpeed) {
-        this._rotationSpeed = rotationSpeed;
-    }
-    get textureIndex() {
-        return this._textureIndex;
-    }
-    set textureIndex(textureIndex) {
-        this._textureIndex = textureIndex;
-    }
-    /**
-     * Time remaining before this particle expires, returned via the shared
-     * `Time.temp` scratch value — copy before storing if you need it beyond
-     * the current frame.
-     */
-    get remainingLifetime() {
-        return Time.temp.set(this._totalLifetime.milliseconds - this._elapsedLifetime.milliseconds);
-    }
-    /**
-     * Fraction of total lifetime already elapsed, in [0, 1]. Used by
-     * {@link ColorAffector} as the interpolation factor for tint blending.
-     */
-    get elapsedRatio() {
-        return this._elapsedLifetime.milliseconds / this._totalLifetime.milliseconds;
-    }
-    /** Fraction of total lifetime still remaining, in [0, 1]. */
-    get remainingRatio() {
-        return this.remainingLifetime.milliseconds / this._totalLifetime.milliseconds;
-    }
-    /**
-     * Returns `true` once `elapsedLifetime` exceeds `totalLifetime`. Expired
-     * particles are moved to the graveyard by {@link ParticleSystem.update}
-     * before affectors run.
-     */
-    get expired() {
-        return this._elapsedLifetime.greaterThan(this._totalLifetime);
-    }
-    /**
-     * Bulk-copies every field from `options` into this particle, replacing all
-     * previous state. Called immediately after {@link ParticleSystem.requestParticle}
-     * to configure a recycled particle for reuse.
-     */
-    applyOptions(options) {
-        const { totalLifetime, elapsedLifetime, position, velocity, scale, tint, rotation, rotationSpeed, textureIndex, } = options;
-        this._totalLifetime.copy(totalLifetime);
-        this._elapsedLifetime.copy(elapsedLifetime);
-        this._position.copy(position);
-        this._velocity.copy(velocity);
-        this._scale.copy(scale);
-        this._tint.copy(tint);
-        this._rotation = rotation;
-        this._rotationSpeed = rotationSpeed;
-        this._textureIndex = textureIndex;
-        return this;
-    }
-    /**
-     * Destroys all owned value objects. Called by
-     * {@link ParticleSystem.clearParticles} when the pool is flushed entirely.
-     * Do not call on individual particles mid-simulation; let the system
-     * recycle them via the graveyard instead.
-     */
-    destroy() {
-        this._totalLifetime.destroy();
-        this._elapsedLifetime.destroy();
-        this._position.destroy();
-        this._velocity.destroy();
-        this._scale.destroy();
-        this._tint.destroy();
-    }
-}
-
-export { Particle };
-//# sourceMappingURL=Particle.js.map

package/dist/esm/particles/Particle.js.map

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

package/dist/esm/particles/ParticleProperties.d.ts

@@ -1,29 +0,0 @@
-import type { Time } from '@/core/Time';
-import type { Vector } from '@/math/Vector';
-import type { Color } from '@/core/Color';
-/**
- * Shared property contract for both {@link Particle} (live instance) and
- * {@link ParticleOptions} (spawn configuration). Every field represents a
- * mutable, per-particle attribute that affectors and the system update each
- * tick.
- */
-export interface ParticleProperties {
-    /** Total time the particle lives before expiring. */
-    totalLifetime: Time;
-    /** Time that has passed since the particle was spawned. */
-    elapsedLifetime: Time;
-    /** Position in the owning {@link ParticleSystem}'s local coordinate space. */
-    position: Vector;
-    /** Pixels-per-second movement vector applied by the system each tick. */
-    velocity: Vector;
-    /** Multiplicative scale applied to the particle sprite on both axes. */
-    scale: Vector;
-    /** Rotation in degrees, normalised to [0, 360) by {@link trimRotation}. */
-    rotation: number;
-    /** Degrees-per-second angular velocity accumulated by {@link TorqueAffector}. */
-    rotationSpeed: number;
-    /** Index into the atlas frame list used to choose the particle sprite. */
-    textureIndex: number;
-    /** RGBA tint blended onto the particle sprite, interpolated by {@link ColorAffector}. */
-    tint: Color;
-}

package/dist/esm/particles/affectors/ColorAffector.d.ts

@@ -1,30 +0,0 @@
-import type { ParticleAffector } from '@/particles/affectors/ParticleAffector';
-import type { Color } from '@/core/Color';
-import type { Particle } from '@/particles/Particle';
-import type { Time } from '@/core/Time';
-/**
- * Linearly interpolates a particle's {@link Particle.tint} from `fromColor`
- * to `toColor` over the particle's full lifetime. The blend factor is
- * {@link Particle.elapsedRatio} — 0 at birth, 1 at expiry — so the
- * transition is always proportional to how long the particle has lived
- * regardless of delta size.
- */
-export declare class ColorAffector implements ParticleAffector {
-    private readonly _fromColor;
-    private readonly _toColor;
-    constructor(fromColor: Color, toColor: Color);
-    get fromColor(): Color;
-    set fromColor(color: Color);
-    get toColor(): Color;
-    set toColor(color: Color);
-    setFromColor(color: Color): this;
-    setToColor(color: Color): this;
-    /**
-     * Sets `particle.tint` to the RGBA value interpolated between
-     * {@link fromColor} and {@link toColor} at the particle's current
-     * {@link Particle.elapsedRatio}. `delta` is unused but required by the
-     * {@link ParticleAffector} contract.
-     */
-    apply(particle: Particle, delta: Time): this;
-    destroy(): void;
-}