@truelab/truengine 3.0.0 → 4.0.0-rc.1

package/dist/types/src/libs/particles/ContainerParticle.d.ts

@@ -0,0 +1,123 @@
+import { Particle as PixiParticle, BLEND_MODES } from 'pixi.js';
+import { Emitter } from './Emitter';
+/**
+ * Прокси position над полями x/y лёгкой v8-частицы (behaviors эмиттера работают с particle.position.x/y)
+ */
+declare class PositionProxy {
+    private readonly particle;
+    constructor(particle: PixiParticle);
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    set(x?: number, y?: number): void;
+}
+/**
+ * Прокси scale над полями scaleX/scaleY
+ */
+declare class ScaleProxy {
+    private readonly particle;
+    constructor(particle: PixiParticle);
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    set(x?: number, y?: number): void;
+}
+/**
+ * Прокси anchor над полями anchorX/anchorY
+ */
+declare class AnchorProxy {
+    private readonly particle;
+    constructor(particle: PixiParticle);
+    get x(): number;
+    set x(value: number);
+    get y(): number;
+    set y(value: number);
+    set(x?: number, y?: number): void;
+}
+/**
+ * Лёгкая частица для рендера через PIXI.ParticleContainer.
+ *
+ * Используется автоматически, когда эмиттеру передан PIXI.ParticleContainer.
+ * Выбирай этот режим для массовых однородных эффектов (снег, конфетти, монетопад):
+ * весь эффект рисуется одним дроуколлом, тысячи частиц почти не нагружают CPU/GPU.
+ * Не забудь про dynamicProperties контейнера: динамическими должны быть только те
+ * свойства, которые анимирует конфиг (vertex — scale, color — alpha/цвет, uvs — смена текстур).
+ *
+ * Публичная поверхность совместима с обычной Particle (extends Sprite): behaviors эмиттера
+ * работают с position/scale/anchor/rotation/alpha/tint/texture без изменений.
+ *
+ * Ограничения ParticleContainer (если что-то из этого нужно — используй спрайтовый
+ * режим с обычным Container, см. Particle.ts):
+ * - текстуры всех частиц должны быть из одного атласа (один источник на дроуколл)
+ * - per-particle blendMode не поддерживается (поле принимается и игнорируется)
+ * - у частиц нет фильтров, масок и вложенных объектов
+ */
+export declare class ContainerParticle extends PixiParticle {
+    /**
+     * The emitter that controls this particle.
+     */
+    emitter: Emitter;
+    /**
+     * The maximum lifetime of this particle, in seconds.
+     */
+    maxLife: number;
+    /**
+     * The current age of the particle, in seconds.
+     */
+    age: number;
+    /**
+     * The current age of the particle as a normalized value between 0 and 1.
+     */
+    agePercent: number;
+    /**
+     * One divided by the max life of the particle, saved for slightly faster math.
+     */
+    oneOverLife: number;
+    /**
+     * Reference to the next particle in the list.
+     */
+    next: ContainerParticle;
+    /**
+     * Reference to the previous particle in the list.
+     */
+    prev: ContainerParticle;
+    prevChild: ContainerParticle;
+    nextChild: ContainerParticle;
+    /**
+     * Static per-particle configuration for behaviors to use. Is not cleared when recycling.
+     */
+    config: {
+        [key: string]: any;
+    };
+    /** Принимается от BlendModeBehavior, но ParticleContainer рендерит одним блендом — игнорируется */
+    blendMode: BLEND_MODES;
+    /** Флаг видимости для совместимости с эмиттером; рендер частицы им не управляет */
+    visible: boolean;
+    /** ParticleContainer не является родителем в терминах сцен-графа — удаление делает эмиттер */
+    readonly parent: null;
+    readonly position: PositionProxy;
+    readonly scale: ScaleProxy;
+    readonly anchor: AnchorProxy;
+    /**
+     * @param emitter The emitter that controls this particle.
+     */
+    constructor(emitter: Emitter);
+    /**
+     * Initializes the particle for use, based on the properties that have to
+     * have been set already on the particle.
+     */
+    init(maxLife: number): void;
+    /**
+     * Kills the particle, removing it from the display list
+     * and telling the emitter to recycle it.
+     */
+    kill(): void;
+    /**
+     * Destroys the particle, removing references and preventing future use.
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=ContainerParticle.d.ts.map

package/dist/types/src/libs/particles/ContainerParticle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContainerParticle.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/ContainerParticle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAW,MAAM,SAAS,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAE1C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;GAEG;AACH,cAAM,aAAa;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAEnD,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,GAAG,CAAC,CAAC,SAAI,EAAE,CAAC,SAAI,GAAG,IAAI;CAI1B;AAED;;GAEG;AACH,cAAM,UAAU;IACA,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAEnD,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,GAAG,CAAC,CAAC,SAAI,EAAE,CAAC,SAAI,GAAG,IAAI;CAI1B;AAED;;GAEG;AACH,cAAM,WAAW;IACD,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,YAAY;IAEnD,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,IAAI,CAAC,IAAI,MAAM,CAEd;IACD,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAElB;IAED,GAAG,CAAC,CAAC,SAAI,EAAE,CAAC,SAAI,GAAG,IAAI;CAI1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IAC/C;;OAEG;IACI,OAAO,EAAE,OAAO,CAAA;IACvB;;OAEG;IACI,OAAO,EAAE,MAAM,CAAA;IACtB;;OAEG;IACI,GAAG,EAAE,MAAM,CAAA;IAClB;;OAEG;IACI,UAAU,EAAE,MAAM,CAAA;IACzB;;OAEG;IACI,WAAW,EAAE,MAAM,CAAA;IAC1B;;OAEG;IACI,IAAI,EAAE,iBAAiB,CAAA;IAE9B;;OAEG;IACI,IAAI,EAAE,iBAAiB,CAAA;IAEvB,SAAS,EAAE,iBAAiB,CAAA;IAC5B,SAAS,EAAE,iBAAiB,CAAA;IAEnC;;OAEG;IACI,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAA;IAErC,mGAAmG;IAC5F,SAAS,EAAE,WAAW,CAAA;IAE7B,mFAAmF;IAC5E,OAAO,EAAE,OAAO,CAAA;IAEvB,8FAA8F;IAC9F,SAAgB,MAAM,EAAE,IAAI,CAAO;IAEnC,SAAgB,QAAQ,EAAE,aAAa,CAAA;IACvC,SAAgB,KAAK,EAAE,UAAU,CAAA;IACjC,SAAgB,MAAM,EAAE,WAAW,CAAA;IAEnC;;OAEG;gBACS,OAAO,EAAE,OAAO;IAoB5B;;;OAGG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAYlC;;;OAGG;IACI,IAAI,IAAI,IAAI;IAInB;;OAEG;IACI,OAAO,IAAI,IAAI;CAGzB"}

package/dist/types/src/libs/particles/Emitter.d.ts

@@ -0,0 +1,303 @@
+import { Container, Point, Ticker } from 'pixi.js';
+import { IEmitterBehavior, IEmitterBehaviorClass } from './behaviors/Behaviors';
+import { EmitterConfigV3 } from './EmitterConfig';
+import { Particle } from './Particle';
+import { SimpleEase } from './ParticleUtils';
+/**
+ * Key used in sorted order to determine when to set particle position from the emitter position
+ * and rotation.
+ */
+declare const PositionParticle: unique symbol;
+/**
+ * A particle emitter.
+ *
+ * Режим рендера выбирается типом контейнера, переданного в конструктор:
+ * - обычный PIXI.Container → спрайтовые частицы (Particle), вся гибкость спрайтов
+ * - PIXI.ParticleContainer → лёгкие частицы (ContainerParticle), один дроуколл,
+ *   для массовых эффектов; ограничения см. в ContainerParticle.ts
+ *
+ * Конфиг (EmitterConfigV3) и behaviors одинаковы для обоих режимов.
+ */
+export declare class Emitter {
+    private static knownBehaviors;
+    /**
+     * Registers a new behavior, so that it will be recognized when initializing emitters.
+     * Behaviors registered later with duplicate types will override older ones, although there is no limit on
+     * the allowed types.
+     * @param constructor The behavior class to register.
+     */
+    static registerBehavior(constructor: IEmitterBehaviorClass): void;
+    /**
+     * Active initialization behaviors for this emitter.
+     */
+    protected initBehaviors: (IEmitterBehavior | typeof PositionParticle)[];
+    /**
+     * Active update behaviors for this emitter.
+     */
+    protected updateBehaviors: IEmitterBehavior[];
+    /**
+     * Active recycle behaviors for this emitter.
+     */
+    protected recycleBehaviors: IEmitterBehavior[];
+    /**
+     * The minimum lifetime for a particle, in seconds.
+     */
+    minLifetime: number;
+    /**
+     * The maximum lifetime for a particle, in seconds.
+     */
+    maxLifetime: number;
+    /**
+     * An easing function for nonlinear interpolation of values. Accepts a single
+     * parameter of time as a value from 0-1, inclusive. Expected outputs are values
+     * from 0-1, inclusive.
+     */
+    customEase: SimpleEase;
+    /**
+     * Time between particle spawns in seconds.
+     */
+    protected _frequency: number;
+    /**
+     * Chance that a particle will be spawned on each opportunity to spawn one.
+     * 0 is 0%, 1 is 100%.
+     */
+    spawnChance: number;
+    /**
+     * Maximum number of particles to keep alive at a time. If this limit
+     * is reached, no more particles will spawn until some have died.
+     */
+    maxParticles: number;
+    /**
+     * The amount of time in seconds to emit for before setting emit to false.
+     * A value of -1 is an unlimited amount of time.
+     */
+    emitterLifetime: number;
+    /**
+     * Position at which to spawn particles, relative to the emitter's owner's origin.
+     * For example, the flames of a rocket travelling right might have a spawnPos
+     * of {x:-50, y:0}.
+     * to spawn at the rear of the rocket.
+     * To change this, use updateSpawnPos().
+     */
+    spawnPos: Point;
+    /**
+     * Number of particles to spawn time that the frequency allows for particles to spawn.
+     */
+    particlesPerWave: number;
+    /**
+     * Rotation of the emitter or emitter's owner in degrees. This is added to
+     * the calculated spawn angle.
+     * To change this, use rotate().
+     */
+    protected rotation: number;
+    /**
+     * The world position of the emitter's owner, to add spawnPos to when
+     * spawning particles. To change this, use updateOwnerPos().
+     */
+    protected ownerPos: Point;
+    /**
+     * The origin + spawnPos in the previous update, so that the spawn position
+     * can be interpolated to space out particles better.
+     */
+    protected _prevEmitterPos: Point;
+    /**
+     * If _prevEmitterPos is valid, to prevent interpolation on the first update
+     */
+    protected _prevPosIsValid: boolean;
+    /**
+     * If either ownerPos or spawnPos has changed since the previous update.
+     */
+    protected _posChanged: boolean;
+    /**
+     * The container to add particles to.
+     */
+    protected _parent: Container;
+    /**
+     * If particles should be added at the back of the display list instead of the front.
+     */
+    addAtBack: boolean;
+    /**
+     * The current number of active particles.
+     */
+    particleCount: number;
+    /**
+     * If particles should be emitted during update() calls. Setting this to false
+     * stops new particles from being created, but allows existing ones to die out.
+     */
+    protected _emit: boolean;
+    /**
+     * The timer for when to spawn particles in seconds, where numbers less
+     * than 0 mean that particles should be spawned.
+     */
+    protected _spawnTimer: number;
+    /**
+     * The life of the emitter in seconds.
+     */
+    protected _emitterLife: number;
+    /**
+     * The particles that are active and on the display list. This is the first particle in a
+     * linked list.
+     */
+    protected _activeParticlesFirst: Particle;
+    /**
+     * The particles that are active and on the display list. This is the last particle in a
+     * linked list.
+     */
+    protected _activeParticlesLast: Particle;
+    /**
+     * The particles that are not currently being used. This is the first particle in a
+     * linked list.
+     */
+    protected _poolFirst: Particle;
+    /**
+     * The original config object that this emitter was initialized with.
+     */
+    protected _origConfig: any;
+    /**
+     * If the update function is called automatically from the shared ticker.
+     * Setting this to false requires calling the update function manually.
+     */
+    protected _autoUpdate: boolean;
+    /**
+     * Родитель является PIXI.ParticleContainer (частицы добавляются через addParticle)
+     */
+    protected _isParticleContainer: boolean;
+    /**
+     * If the emitter should destroy itself when all particles have died out. This is set by
+     * playOnceAndDestroy();
+     */
+    protected _destroyWhenComplete: boolean;
+    /**
+     * A callback for when all particles have died out. This is set by
+     * playOnceAndDestroy() or playOnce();
+     */
+    protected _completeCallback: () => void;
+    /**
+     * @param particleParent The container to add the particles to.
+     * @param particleImages A texture or array of textures to use
+     *                       for the particles. Strings will be turned
+     *                       into textures via Texture.from().
+     * @param config A configuration object containing settings for the emitter.
+     * @param config.emit If config.emit is explicitly passed as false, the
+     *                    Emitter will start disabled.
+     * @param config.autoUpdate If config.autoUpdate is explicitly passed as
+     *                          true, the Emitter will automatically call
+     *                          update via the PIXI shared ticker.
+     */
+    constructor(particleParent: Container, config: EmitterConfigV3);
+    /**
+     * Time between particle spawns in seconds. If this value is not a number greater than 0,
+     * it will be set to 1 (particle per second) to prevent infinite loops.
+     */
+    get frequency(): number;
+    set frequency(value: number);
+    /**
+     * The container to add particles to. Settings this will dump any active particles.
+     */
+    get parent(): Container;
+    set parent(value: Container);
+    /**
+     * Создать частицу подходящего класса: лёгкую для ParticleContainer или спрайтовую для обычного контейнера
+     */
+    protected _createParticle(): Particle;
+    /**
+     * Добавить частицу в контейнер (addParticle для ParticleContainer, addChild для обычного)
+     */
+    protected _addParticleToParent(p: Particle): void;
+    /**
+     * Sets up the emitter based on the config settings.
+     * @param config A configuration object containing settings for the emitter.
+     */
+    init(config: EmitterConfigV3): void;
+    /**
+     * Gets the instantiated behavior of the specified type, if it is present on this emitter.
+     * @param type The behavior type to find.
+     */
+    getBehavior(type: string): IEmitterBehavior | null;
+    /**
+     * Fills the pool with the specified number of particles, so that they don't have to be instantiated later.
+     * @param count The number of particles to create.
+     */
+    fillPool(count: number): void;
+    /**
+     * Recycles an individual particle. For internal use only.
+     * @param particle The particle to recycle.
+     * @param fromCleanup If this is being called to manually clean up all particles.
+     * @internal
+     */
+    recycle(particle: Particle, fromCleanup?: boolean): void;
+    /**
+     * Sets the rotation of the emitter to a new value. This rotates the spawn position in addition
+     * to particle direction.
+     * @param newRot The new rotation, in degrees.
+     */
+    rotate(newRot: number): void;
+    /**
+     * Changes the spawn position of the emitter.
+     * @param x The new x value of the spawn position for the emitter.
+     * @param y The new y value of the spawn position for the emitter.
+     */
+    updateSpawnPos(x: number, y: number): void;
+    /**
+     * Changes the position of the emitter's owner. You should call this if you are adding
+     * particles to the world container that your emitter's owner is moving around in.
+     * @param x The new x value of the emitter's owner.
+     * @param y The new y value of the emitter's owner.
+     */
+    updateOwnerPos(x: number, y: number): void;
+    /**
+     * Prevents emitter position interpolation in the next update.
+     * This should be used if you made a major position change of your emitter's owner
+     * that was not normal movement.
+     */
+    resetPositionTracking(): void;
+    /**
+     * If particles should be emitted during update() calls. Setting this to false
+     * stops new particles from being created, but allows existing ones to die out.
+     */
+    get emit(): boolean;
+    set emit(value: boolean);
+    /**
+     * If the update function is called automatically from the shared ticker.
+     * Setting this to false requires calling the update function manually.
+     */
+    get autoUpdate(): boolean;
+    set autoUpdate(value: boolean);
+    /**
+     * Starts emitting particles, sets autoUpdate to true, and sets up the Emitter to destroy itself
+     * when particle emission is complete.
+     * @param callback Callback for when emission is complete (all particles have died off)
+     */
+    playOnceAndDestroy(callback?: () => void): void;
+    /**
+     * Starts emitting particles and optionally calls a callback when particle emission is complete.
+     * @param callback Callback for when emission is complete (all particles have died off)
+     */
+    playOnce(callback?: () => void): void;
+    /**
+     * Updates all particles spawned by this emitter and emits new ones.
+     * @param delta Time elapsed since the previous frame, in __seconds__.
+     */
+    update(delta: number | Ticker): void;
+    /**
+     * Emits a single wave of particles, using standard spawnChance & particlesPerWave settings. Does not affect
+     * regular spawning through the frequency, and ignores the emit property. The max particle count is respected, however,
+     * so if there are already too many particles then nothing will happen.
+     */
+    emitNow(): void;
+    /**
+     * Kills all active particles immediately.
+     */
+    cleanup(): void;
+    /**
+     * If this emitter has been destroyed. Note that a destroyed emitter can still be reused, after
+     * having a new parent set and being reinitialized.
+     */
+    get destroyed(): boolean;
+    /**
+     * Destroys the emitter and all of its particles.
+     */
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=Emitter.d.ts.map

package/dist/types/src/libs/particles/Emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Emitter.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/Emitter.ts"],"names":[],"mappings":"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"}

package/dist/types/src/libs/particles/EmitterConfig.d.ts

@@ -0,0 +1,228 @@
+import { PointData } from 'pixi.js';
+import { EaseSegment, SimpleEase } from './ParticleUtils';
+import { ValueList } from './PropertyNode';
+/**
+ * Full Emitter configuration for initializing an Emitter instance.
+ */
+export type EmitterConfigV3 = {
+    /**
+     * Random number configuration for picking the lifetime for each particle..
+     */
+    lifetime: RandNumber;
+    /**
+     * Easing to be applied to all interpolated or stepped values across the particle lifetime.
+     */
+    ease?: SimpleEase | EaseSegment[];
+    /**
+     * How many particles to spawn at once, each time that it is determined that particles should be spawned.
+     * If omitted, only one particle will spawn at a time.
+     */
+    particlesPerWave?: number;
+    /**
+     * How often to spawn particles. This is a value in seconds, so a value of 0.5 would be twice a second.
+     */
+    frequency: number;
+    /**
+     * Defines a chance to not spawn particles. Values lower than 1 mean particles may not be spawned each time.
+     * If omitted, particles will always spawn.
+     */
+    spawnChance?: number;
+    /**
+     * How long to run the Emitter before it stops spawning particles. If omitted, runs forever (or until told to stop
+     * manually).
+     */
+    emitterLifetime?: number;
+    /**
+     * Maximum number of particles that can be alive at any given time for this emitter.
+     */
+    maxParticles?: number;
+    /**
+     * If newly spawned particles should be added to the back of the parent container (to make them less conspicuous
+     * as they pop in). If omitted, particles will be added to the top of the container.
+     */
+    addAtBack?: boolean;
+    /**
+     * Default position to spawn particles from inside the parent container.
+     */
+    pos: {
+        x: number;
+        y: number;
+    };
+    /**
+     * If the emitter should start out emitting particles. If omitted, it will be treated as `true` and will emit particles
+     * immediately.
+     */
+    emit?: boolean;
+    /**
+     * If the Emitter should hook into PixiJS's shared ticker. If this is false or emitted, you will be responsible for
+     * connecting it to update ticks.
+     */
+    autoUpdate?: boolean;
+    /**
+     * The list of behaviors to apply to this emitter. See the behaviors namespace for
+     * a list of built in behaviors. Custom behaviors may be registered with {@link Emitter.registerBehavior}.
+     */
+    behaviors: BehaviorEntry[];
+};
+/**
+ * See {@link EmitterConfigV3.behaviors}
+ */
+export type BehaviorEntry = {
+    /**
+     * The behavior type, as defined as the static `type` property of a behavior class.
+     */
+    type: string;
+    /**
+     * Configuration data specific to that behavior.
+     */
+    config: any;
+};
+/**
+ * Configuration for how to pick a random number (inclusive).
+ */
+export type RandNumber = {
+    /**
+     * Maximum pickable value.
+     */
+    max: number;
+    /**
+     * Minimum pickable value.
+     */
+    min: number;
+};
+/**
+ * Converts emitter configuration from pre-5.0.0 library values into the current version.
+ *
+ * Example usage:
+ * ```javascript
+ * const emitter = new Emitter(myContainer, upgradeConfig(myOldConfig, [myTexture, myOtherTexture]));
+ * ```
+ * @param config The old emitter config to upgrade.
+ * @param art The old art values as would have been passed into the Emitter constructor or `Emitter.init()`
+ */
+export declare function upgradeConfig(config: EmitterConfigV2 | EmitterConfigV1, art: any): EmitterConfigV3;
+/**
+ * The obsolete emitter configuration format from version 3.0.0 of the library.
+ * This type information is kept to make it easy to upgrade, but otherwise
+ * configuration should be made as {@link EmitterConfigV3}.
+ */
+export type EmitterConfigV2 = {
+    alpha?: ValueList<number>;
+    speed?: ValueList<number>;
+    minimumSpeedMultiplier?: number;
+    maxSpeed?: number;
+    acceleration?: {
+        x: number;
+        y: number;
+    };
+    scale?: ValueList<number>;
+    minimumScaleMultiplier?: number;
+    color?: ValueList<string>;
+    startRotation?: RandNumber;
+    noRotation?: boolean;
+    rotationSpeed?: RandNumber;
+    rotationAcceleration?: number;
+    lifetime: RandNumber;
+    blendMode?: string;
+    ease?: SimpleEase | EaseSegment[];
+    extraData?: any;
+    particlesPerWave?: number;
+    /**
+     * Really "rect"|"circle"|"ring"|"burst"|"point"|"polygonalChain", but that
+     * tends to be too strict for random object creation.
+     */
+    spawnType?: string;
+    spawnRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    spawnCircle?: {
+        x: number;
+        y: number;
+        r: number;
+        minR?: number;
+    };
+    particleSpacing?: number;
+    angleStart?: number;
+    spawnPolygon?: PointData[] | PointData[][];
+    frequency: number;
+    spawnChance?: number;
+    emitterLifetime?: number;
+    maxParticles?: number;
+    addAtBack?: boolean;
+    pos: {
+        x: number;
+        y: number;
+    };
+    emit?: boolean;
+    autoUpdate?: boolean;
+    orderedArt?: boolean;
+};
+export type BasicTweenable<T> = {
+    start: T;
+    end: T;
+};
+/**
+ * The obsolete emitter configuration format of the initial library release.
+ * This type information is kept to maintain compatibility with the older particle tool, but otherwise
+ * configuration should be made as {@link EmitterConfigV3}.
+ */
+export type EmitterConfigV1 = {
+    alpha?: BasicTweenable<number>;
+    speed?: BasicTweenable<number> & {
+        minimumSpeedMultiplier?: number;
+    };
+    maxSpeed?: number;
+    acceleration?: {
+        x: number;
+        y: number;
+    };
+    scale?: BasicTweenable<number> & {
+        minimumScaleMultiplier?: number;
+    };
+    color?: BasicTweenable<string>;
+    startRotation?: RandNumber;
+    noRotation?: boolean;
+    rotationSpeed?: RandNumber;
+    rotationAcceleration?: number;
+    lifetime: RandNumber;
+    blendMode?: string;
+    ease?: SimpleEase | EaseSegment[];
+    extraData?: any;
+    particlesPerWave?: number;
+    /**
+     * Really "rect"|"circle"|"ring"|"burst"|"point"|"polygonalChain", but that
+     * tends to be too strict for random object creation.
+     */
+    spawnType?: string;
+    spawnRect?: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    spawnCircle?: {
+        x: number;
+        y: number;
+        r: number;
+        minR?: number;
+    };
+    particleSpacing?: number;
+    angleStart?: number;
+    spawnPolygon?: PointData[] | PointData[][];
+    frequency: number;
+    spawnChance?: number;
+    emitterLifetime?: number;
+    maxParticles?: number;
+    addAtBack?: boolean;
+    pos: {
+        x: number;
+        y: number;
+    };
+    emit?: boolean;
+    autoUpdate?: boolean;
+    orderedArt?: boolean;
+};
+//# sourceMappingURL=EmitterConfig.d.ts.map

package/dist/types/src/libs/particles/EmitterConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmitterConfig.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/EmitterConfig.ts"],"names":[],"mappings":"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"}