@codexo/exojs 0.7.13 → 0.8.2

package/dist/esm/particles/emitters/ParticleOptions.d.ts

@@ -1,62 +0,0 @@
-import { Vector } from '@/math/Vector';
-import { Color } from '@/core/Color';
-import { Time } from '@/core/Time';
-import type { ParticleProperties } from '@/particles/ParticleProperties';
-/**
- * Spawn-time configuration snapshot passed to {@link ParticleEmitter.apply}
- * implementations. Implements {@link ParticleProperties} so the same affector
- * interface can read default values when needed. All fields have sensible
- * defaults (1 s lifetime, zero position/velocity, unit scale, white tint)
- * and every object-valued field is deep-cloned on construction, making it
- * safe to share one `ParticleOptions` instance across multiple emitters.
- */
-export declare class ParticleOptions implements ParticleProperties {
-    private readonly _totalLifetime;
-    private readonly _elapsedLifetime;
-    private readonly _position;
-    private readonly _velocity;
-    private readonly _scale;
-    private readonly _tint;
-    private _rotation;
-    private _rotationSpeed;
-    private _textureIndex;
-    /**
-     * Creates a new options snapshot. Any omitted field falls back to its
-     * default value (1 s lifetime, zero position/velocity, unit scale,
-     * zero rotation, white tint, texture index 0). All object values are
-     * cloned so later mutations to the source objects do not affect this
-     * instance.
-     */
-    constructor(options?: Partial<ParticleProperties>);
-    get totalLifetime(): Time;
-    set totalLifetime(totalLifetime: Time);
-    get elapsedLifetime(): Time;
-    set elapsedLifetime(elapsedLifetime: Time);
-    /**
-     * Spawn position for particles emitted with these options, expressed in
-     * the owning ParticleSystem's LOCAL coordinate space — the system's own
-     * `getGlobalTransform()` is applied on top during rendering (both the
-     * WebGL2 and WebGPU shaders do `projection * translation * rotated`).
-     *
-     * Setting a world-space value here (e.g. `system.x + offset`) will
-     * double-translate the emitter because the shader will translate again.
-     * For an emitter anchored at the system origin, use small offsets around
-     * `(0, 0)` and position the system itself via `system.setPosition(...)`.
-     */
-    get position(): Vector;
-    set position(position: Vector);
-    get velocity(): Vector;
-    set velocity(velocity: Vector);
-    get scale(): Vector;
-    set scale(scale: Vector);
-    get rotation(): number;
-    set rotation(degrees: number);
-    get rotationSpeed(): number;
-    set rotationSpeed(rotationSpeed: number);
-    get textureIndex(): number;
-    set textureIndex(textureIndex: number);
-    get tint(): Color;
-    set tint(color: Color);
-    /** Destroys all owned value objects. Called by the owning emitter's `destroy()`. */
-    destroy(): void;
-}

package/dist/esm/particles/emitters/ParticleOptions.js

@@ -1,120 +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';
-
-/**
- * Spawn-time configuration snapshot passed to {@link ParticleEmitter.apply}
- * implementations. Implements {@link ParticleProperties} so the same affector
- * interface can read default values when needed. All fields have sensible
- * defaults (1 s lifetime, zero position/velocity, unit scale, white tint)
- * and every object-valued field is deep-cloned on construction, making it
- * safe to share one `ParticleOptions` instance across multiple emitters.
- */
-class ParticleOptions {
-    _totalLifetime;
-    _elapsedLifetime;
-    _position;
-    _velocity;
-    _scale;
-    _tint;
-    _rotation;
-    _rotationSpeed;
-    _textureIndex;
-    /**
-     * Creates a new options snapshot. Any omitted field falls back to its
-     * default value (1 s lifetime, zero position/velocity, unit scale,
-     * zero rotation, white tint, texture index 0). All object values are
-     * cloned so later mutations to the source objects do not affect this
-     * instance.
-     */
-    constructor(options = {}) {
-        const { totalLifetime, elapsedLifetime, position, velocity, scale, rotation, rotationSpeed, textureIndex, tint, } = options;
-        this._totalLifetime = (totalLifetime ?? Time.oneSecond).clone();
-        this._elapsedLifetime = (elapsedLifetime ?? Time.zero).clone();
-        this._position = (position ?? Vector.zero).clone();
-        this._velocity = (velocity ?? Vector.zero).clone();
-        this._scale = (scale ?? Vector.one).clone();
-        this._tint = (tint ?? Color.white).clone();
-        this._rotation = rotation ?? 0;
-        this._rotationSpeed = rotationSpeed ?? 0;
-        this._textureIndex = textureIndex ?? 0;
-    }
-    get totalLifetime() {
-        return this._totalLifetime;
-    }
-    set totalLifetime(totalLifetime) {
-        this._totalLifetime.copy(totalLifetime);
-    }
-    get elapsedLifetime() {
-        return this._elapsedLifetime;
-    }
-    set elapsedLifetime(elapsedLifetime) {
-        this._elapsedLifetime.copy(elapsedLifetime);
-    }
-    /**
-     * Spawn position for particles emitted with these options, expressed in
-     * the owning ParticleSystem's LOCAL coordinate space — the system's own
-     * `getGlobalTransform()` is applied on top during rendering (both the
-     * WebGL2 and WebGPU shaders do `projection * translation * rotated`).
-     *
-     * Setting a world-space value here (e.g. `system.x + offset`) will
-     * double-translate the emitter because the shader will translate again.
-     * For an emitter anchored at the system origin, use small offsets around
-     * `(0, 0)` and position the system itself via `system.setPosition(...)`.
-     */
-    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 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;
-    }
-    get tint() {
-        return this._tint;
-    }
-    set tint(color) {
-        this._tint.copy(color);
-    }
-    /** Destroys all owned value objects. Called by the owning emitter's `destroy()`. */
-    destroy() {
-        this._totalLifetime.destroy();
-        this._elapsedLifetime.destroy();
-        this._position.destroy();
-        this._velocity.destroy();
-        this._scale.destroy();
-        this._tint.destroy();
-    }
-}
-
-export { ParticleOptions };
-//# sourceMappingURL=ParticleOptions.js.map

package/dist/esm/particles/emitters/ParticleOptions.js.map

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

package/dist/esm/particles/emitters/UniversalEmitter.d.ts

@@ -1,40 +0,0 @@
-import type { Time } from '@/core/Time';
-import { ParticleOptions } from '@/particles/emitters/ParticleOptions';
-import type { ParticleEmitter } from '@/particles/emitters/ParticleEmitter';
-import type { ParticleSystem } from '@/particles/ParticleSystem';
-/**
- * Rate-based concrete {@link ParticleEmitter} that spawns a fixed number of
- * particles per second, configured via {@link UniversalEmitter.emissionRate}
- * and {@link UniversalEmitter.particleOptions}. Sub-frame fractions are
- * accumulated in an internal delta so that low emission rates (e.g. 0.5
- * particles/s) remain accurate over time without integer truncation error.
- *
- * @example
- * const emitter = new UniversalEmitter(60, new ParticleOptions({ velocity: new Vector(0, -200) }));
- * particleSystem.addEmitter(emitter);
- */
-export declare class UniversalEmitter implements ParticleEmitter {
-    private _emissionRate;
-    private _particleOptions;
-    private _emissionDelta;
-    constructor(emissionRate: number, particleOptions?: ParticleOptions);
-    get emissionRate(): number;
-    set emissionRate(particlesPerSecond: number);
-    get particleOptions(): ParticleOptions;
-    set particleOptions(particleOptions: ParticleOptions);
-    /**
-     * Computes how many whole particles to spawn for the given `time` slice,
-     * carrying any fractional remainder into the next call. This accumulator
-     * prevents emission-rate drift when `emissionRate * delta` is not an
-     * integer (e.g. 30 fps × 0.5 particles/s = 0.5 per frame → every other
-     * frame emits one).
-     */
-    computeParticleCount(time: Time): number;
-    /**
-     * Requests the correct number of particles from `system` for this frame,
-     * configures each one with {@link particleOptions} via
-     * {@link Particle.applyOptions}, and emits them into the live pool.
-     */
-    apply(system: ParticleSystem, delta: Time): this;
-    destroy(): void;
-}

package/dist/esm/particles/emitters/UniversalEmitter.js

@@ -1,68 +0,0 @@
-import { ParticleOptions } from './ParticleOptions.js';
-
-/**
- * Rate-based concrete {@link ParticleEmitter} that spawns a fixed number of
- * particles per second, configured via {@link UniversalEmitter.emissionRate}
- * and {@link UniversalEmitter.particleOptions}. Sub-frame fractions are
- * accumulated in an internal delta so that low emission rates (e.g. 0.5
- * particles/s) remain accurate over time without integer truncation error.
- *
- * @example
- * const emitter = new UniversalEmitter(60, new ParticleOptions({ velocity: new Vector(0, -200) }));
- * particleSystem.addEmitter(emitter);
- */
-class UniversalEmitter {
-    _emissionRate;
-    _particleOptions;
-    _emissionDelta = 0;
-    constructor(emissionRate, particleOptions) {
-        this._emissionRate = emissionRate;
-        this._particleOptions = particleOptions ?? new ParticleOptions();
-    }
-    get emissionRate() {
-        return this._emissionRate;
-    }
-    set emissionRate(particlesPerSecond) {
-        this._emissionRate = particlesPerSecond;
-    }
-    get particleOptions() {
-        return this._particleOptions;
-    }
-    set particleOptions(particleOptions) {
-        this._particleOptions = particleOptions;
-    }
-    /**
-     * Computes how many whole particles to spawn for the given `time` slice,
-     * carrying any fractional remainder into the next call. This accumulator
-     * prevents emission-rate drift when `emissionRate * delta` is not an
-     * integer (e.g. 30 fps × 0.5 particles/s = 0.5 per frame → every other
-     * frame emits one).
-     */
-    computeParticleCount(time) {
-        const particleAmount = (this._emissionRate * time.seconds) + this._emissionDelta;
-        const particles = particleAmount | 0;
-        this._emissionDelta = (particleAmount - particles);
-        return particles;
-    }
-    /**
-     * Requests the correct number of particles from `system` for this frame,
-     * configures each one with {@link particleOptions} via
-     * {@link Particle.applyOptions}, and emits them into the live pool.
-     */
-    apply(system, delta) {
-        const count = this.computeParticleCount(delta);
-        const options = this._particleOptions;
-        for (let i = 0; i < count; i++) {
-            const particle = system.requestParticle();
-            particle.applyOptions(options);
-            system.emitParticle(particle);
-        }
-        return this;
-    }
-    destroy() {
-        this._particleOptions.destroy();
-    }
-}
-
-export { UniversalEmitter };
-//# sourceMappingURL=UniversalEmitter.js.map

package/dist/esm/particles/emitters/UniversalEmitter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"UniversalEmitter.js","sources":["../../../../../src/particles/emitters/UniversalEmitter.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;;;;;;;;;;AAUG;MACU,gBAAgB,CAAA;AACjB,IAAA,aAAa;AACb,IAAA,gBAAgB;IAChB,cAAc,GAAG,CAAC;IAE1B,WAAA,CAAmB,YAAoB,EAAE,eAAiC,EAAA;AACtE,QAAA,IAAI,CAAC,aAAa,GAAG,YAAY;QACjC,IAAI,CAAC,gBAAgB,GAAG,eAAe,IAAI,IAAI,eAAe,EAAE;IACpE;AAEA,IAAA,IAAW,YAAY,GAAA;QACnB,OAAO,IAAI,CAAC,aAAa;IAC7B;IAEA,IAAW,YAAY,CAAC,kBAA0B,EAAA;AAC9C,QAAA,IAAI,CAAC,aAAa,GAAG,kBAAkB;IAC3C;AAEA,IAAA,IAAW,eAAe,GAAA;QACtB,OAAO,IAAI,CAAC,gBAAgB;IAChC;IAEA,IAAW,eAAe,CAAC,eAAgC,EAAA;AACvD,QAAA,IAAI,CAAC,gBAAgB,GAAG,eAAe;IAC3C;AAEA;;;;;;AAMG;AACI,IAAA,oBAAoB,CAAC,IAAU,EAAA;AAClC,QAAA,MAAM,cAAc,GAAG,CAAC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc;AAChF,QAAA,MAAM,SAAS,GAAG,cAAc,GAAG,CAAC;QAEpC,IAAI,CAAC,cAAc,IAAI,cAAc,GAAG,SAAS,CAAC;AAElD,QAAA,OAAO,SAAS;IACpB;AAEA;;;;AAIG;IACI,KAAK,CAAC,MAAsB,EAAE,KAAW,EAAA;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC;AAC9C,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB;AAErC,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE;AAC5B,YAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,eAAe,EAAE;AAEzC,YAAA,QAAQ,CAAC,YAAY,CAAC,OAAO,CAAC;AAC9B,YAAA,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC;QACjC;AAEA,QAAA,OAAO,IAAI;IACf;IAEO,OAAO,GAAA;AACV,QAAA,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE;IACnC;AACH;;;;"}