@truelab/truengine 3.0.0 → 4.0.0-rc.0

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

@@ -0,0 +1,70 @@
+import { Sprite } from 'pixi.js';
+import { Emitter } from './Emitter';
+/**
+ * An individual particle image. You shouldn't have to deal with these.
+ *
+ * Спрайтовая частица — используется, когда эмиттеру передан обычный PIXI.Container.
+ * Выбирай этот режим, если эффекту нужно что-то из возможностей полноценного спрайта:
+ * - свой blendMode на каждую частицу (behavior 'blendMode')
+ * - текстуры из разных атласов в одном эмиттере
+ * - встраивание частиц в z-порядок сцены (addAtBack, объекты между частицами)
+ * - фильтры/маски/вложенные объекты на отдельной частице
+ *
+ * Для массовых однородных эффектов (снег, конфетти, монетопад) лучше лёгкая
+ * ContainerParticle через PIXI.ParticleContainer — см. ContainerParticle.ts
+ */
+export declare class Particle extends Sprite {
+    /**
+     * 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: Particle;
+    /**
+     * Reference to the previous particle in the list.
+     */
+    prev: Particle;
+    prevChild: Particle;
+    nextChild: Particle;
+    /**
+     * Static per-particle configuration for behaviors to use. Is not cleared when recycling.
+     */
+    config: Record<string, any>;
+    /**
+     * @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;
+}
+//# sourceMappingURL=Particle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Particle.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/Particle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;;;;;;;;;;;GAYG;AACH,qBAAa,QAAS,SAAQ,MAAM;IAChC;;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,QAAQ,CAAA;IAErB;;OAEG;IACI,IAAI,EAAE,QAAQ,CAAA;IAEd,SAAS,EAAE,QAAQ,CAAA;IACnB,SAAS,EAAE,QAAQ,CAAA;IAE1B;;OAEG;IACI,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAElC;;OAEG;gBACS,OAAO,EAAE,OAAO;IAuB5B;;;OAGG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAiBlC;;;OAGG;IACI,IAAI,IAAI,IAAI;IAInB;;OAEG;IACI,OAAO,IAAI,IAAI;CAOzB"}

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

@@ -0,0 +1,95 @@
+import { BLEND_MODES, Texture, PointData } from 'pixi.js';
+import { PropertyNode, ValueStep } from './PropertyNode';
+/**
+ * The method used by behaviors to fetch textures. Defaults to Texture.from.
+ */
+export declare let GetTextureFromString: (d: string) => Texture;
+/**
+ * A color value, split apart for interpolation.
+ */
+export type Color = {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+};
+export type EaseSegment = {
+    cp: number;
+    s: number;
+    e: number;
+};
+/**
+ * The basic easing function used. Takes in a value between 0-1, and outputs another value between 0-1.
+ * For example, a basic quadratic in ease would be `(time) => time * time`
+ */
+export type SimpleEase = (time: number) => number;
+/**
+ * If errors and warnings should be logged within the library.
+ */
+export declare const verbose = false;
+export declare const DEG_TO_RADS: number;
+/**
+ * Rotates a point by a given angle.
+ * @param angle The angle to rotate by in radians
+ * @param p The point to rotate around 0,0.
+ */
+export declare function rotatePoint(angle: number, p: PointData): void;
+/**
+ * Combines separate color components (0-255) into a single uint color.
+ * @param r The red value of the color
+ * @param g The green value of the color
+ * @param b The blue value of the color
+ * @return The color in the form of 0xRRGGBB
+ */
+export declare function combineRGBComponents(r: number, g: number, b: number): number;
+/**
+ * Returns the length (or magnitude) of this point.
+ * @param point The point to measure length
+ * @return The length of this point.
+ */
+export declare function length(point: PointData): number;
+/**
+ * Reduces the point to a length of 1.
+ * @param point The point to normalize
+ */
+export declare function normalize(point: PointData): void;
+/**
+ * Multiplies the x and y values of this point by a value.
+ * @param point The point to scaleBy
+ * @param value The value to scale by.
+ */
+export declare function scaleBy(point: PointData, value: number): void;
+/**
+ * Converts a hex string from "#AARRGGBB", "#RRGGBB", "0xAARRGGBB", "0xRRGGBB",
+ * "AARRGGBB", or "RRGGBB" to an object of ints of 0-255, as
+ * {r, g, b, (a)}.
+ * @param color The input color string.
+ * @param output An object to put the output in. If omitted, a new object is created.
+ * @return The object with r, g, and b properties, possibly with an a property.
+ */
+export declare function hexToRGB(color: string, output?: Color): Color;
+/**
+ * Generates a custom ease function, based on the GreenSock custom ease, as demonstrated
+ * by the related tool at http://www.greensock.com/customease/.
+ * @param segments An array of segments, as created by
+ * http://www.greensock.com/customease/.
+ * @return A function that calculates the percentage of change at
+ *                    a given point in time (0-1 inclusive).
+ */
+export declare function generateEase(segments: EaseSegment[]): SimpleEase;
+/**
+ * Gets a blend mode, ensuring that it is valid.
+ * @param name The name of the blend mode to get.
+ * @return The blend mode as a PIXI.BLEND_MODES string value.
+ */
+export declare function getBlendMode(name: string): BLEND_MODES;
+/**
+ * Converts a list of {value, time} objects starting at time 0 and ending at time 1 into an evenly
+ * spaced stepped list of PropertyNodes for color values. This is primarily to handle conversion of
+ * linear gradients to fewer colors, allowing for some optimization for Canvas2d fallbacks.
+ * @param list The list of data to convert.
+ * @param [numSteps=10] The number of steps to use.
+ * @return The blend mode as specified in the PIXI.blendModes enumeration.
+ */
+export declare function createSteppedGradient(list: ValueStep<string>[], numSteps?: number): PropertyNode<Color>;
+//# sourceMappingURL=ParticleUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleUtils.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/ParticleUtils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAExD;;GAEG;AAGH,eAAO,IAAI,oBAAoB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAsB,CAAA;AAEtE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG;IAChB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,CAAC,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACZ,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,OAAO,QAAQ,CAAA;AAE5B,eAAO,MAAM,WAAW,QAAgB,CAAA;AAExC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,GAAG,IAAI,CAU7D;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAY,MAAM,CAErF;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAWhD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG7D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAuB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,CAmBhE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAItD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,SAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAqCnG"}

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

@@ -0,0 +1,40 @@
+import { SimpleEase } from './ParticleUtils';
+import { PropertyNode } from './PropertyNode';
+/**
+ * Singly linked list container for keeping track of interpolated properties for particles.
+ * Each Particle will have one of these for each interpolated property.
+ */
+export declare class PropertyList<V> {
+    /**
+     * The first property node in the linked list.
+     */
+    first: PropertyNode<V>;
+    /**
+     * Calculates the correct value for the current interpolation value. This method is set in
+     * the reset() method.
+     * @param lerp The interpolation value from 0-1.
+     * @return The interpolated value. Colors are converted to the hex value.
+     */
+    interpolate: (lerp: number) => number;
+    /**
+     * A custom easing method for this list.
+     * @param lerp The interpolation value from 0-1.
+     * @return The eased value, also from 0-1.
+     */
+    ease: SimpleEase;
+    /**
+     * If this list manages colors, which requires a different method for interpolation.
+     */
+    private isColor;
+    /**
+     * @param isColor If this list handles color values
+     */
+    constructor(isColor?: boolean);
+    /**
+     * Resets the list for use.
+     * @param first The first node in the list.
+     * @param first.isStepped If the values should be stepped instead of interpolated linearly.
+     */
+    reset(first: PropertyNode<V>): void;
+}
+//# sourceMappingURL=PropertyList.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyList.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/PropertyList.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+B,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAsF7C;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB;;OAEG;IACI,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAC7B;;;;;OAKG;IACI,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAC5C;;;;OAIG;IACI,IAAI,EAAE,UAAU,CAAA;IACvB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAS;IAExB;;OAEG;gBACS,OAAO,UAAQ;IAO3B;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;CAa7C"}

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

@@ -0,0 +1,74 @@
+import { BasicTweenable } from './EmitterConfig';
+import { Color, EaseSegment, SimpleEase } from './ParticleUtils';
+/**
+ * A single step of a ValueList.
+ */
+export type ValueStep<T> = {
+    /**
+     * The color or number to use at this step.
+     */
+    value: T;
+    /**
+     * The percentage time of the particle's lifespan that this step happens at.
+     * Values are between 0 and 1, inclusive.
+     */
+    time: number;
+};
+/**
+ * Configuration for an interpolated or stepped list of numeric or color particle values.
+ */
+export type ValueList<T> = {
+    /**
+     * The ordered list of values.
+     */
+    list: ValueStep<T>[];
+    /**
+     * If the list is stepped. Stepped lists don't determine any in-between values, instead sticking with each value
+     * until its time runs out.
+     */
+    isStepped?: boolean;
+    /**
+     * Easing that should be applied to this list, in order to alter how quickly the steps progress.
+     */
+    ease?: SimpleEase | EaseSegment[];
+};
+/**
+ * A single node in a PropertyList.
+ */
+export declare class PropertyNode<V> {
+    /**
+     * Value for the node.
+     */
+    value: V;
+    /**
+     * Time value for the node. Between 0-1.
+     */
+    time: number;
+    /**
+     * The next node in line.
+     */
+    next: PropertyNode<V>;
+    /**
+     * If this is the first node in the list, controls if the entire list is stepped or not.
+     */
+    isStepped: boolean;
+    ease: SimpleEase;
+    /**
+     * @param value The value for this node
+     * @param time The time for this node, between 0-1
+     * @param [ease] Custom ease for this list. Only relevant for the first node.
+     */
+    constructor(value: V, time: number, ease?: SimpleEase | EaseSegment[]);
+    /**
+     * Creates a list of property values from a data object {list, isStepped} with a list of objects in
+     * the form {value, time}. Alternatively, the data object can be in the deprecated form of
+     * {start, end}.
+     * @param data The data for the list.
+     * @param data.list The array of value and time objects.
+     * @param data.isStepped If the list is stepped rather than interpolated.
+     * @param data.ease Custom ease for this list.
+     * @return The first node in the list
+     */
+    static createList<T extends string | number>(data: ValueList<T> | BasicTweenable<T>): PropertyNode<T extends string ? Color : T>;
+}
+//# sourceMappingURL=PropertyNode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyNode.d.ts","sourceRoot":"","sources":["../../../../../src/libs/particles/PropertyNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,WAAW,EAA0B,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAExF;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IACvB;;OAEG;IACH,KAAK,EAAE,CAAC,CAAA;IACR;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI;IACvB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,EAAE,CAAA;CACpC,CAAA;AACD;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB;;OAEG;IACI,KAAK,EAAE,CAAC,CAAA;IACf;;OAEG;IACI,IAAI,EAAE,MAAM,CAAA;IACnB;;OAEG;IACI,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;IAC5B;;OAEG;IACI,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,UAAU,CAAA;IAEvB;;;;OAIG;gBACS,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,EAAE;IAYrE;;;;;;;;;OASG;WAEW,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAC9C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GACvC,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC;CAqChD"}

package/dist/types/src/libs/particles/behaviors/AccelerationMovement.d.ts

@@ -0,0 +1,62 @@
+import { Particle } from '../Particle';
+import { BehaviorOrder, IEmitterBehavior } from './Behaviors';
+import { BehaviorEditorConfig } from './editor/Types';
+/**
+ * A Movement behavior that handles movement by applying a constant acceleration to all particles.
+ *
+ * Example configuration:
+ * ```javascript
+ * {
+ *     "type": "moveAcceleration",
+ *     "config": {
+ *          "accel": {
+ *               "x": 0,
+ *               "y": 2000
+ *          },
+ *          "minStart": 600,
+ *          "maxStart": 600,
+ *          "rotate": true
+ *     }
+ *}
+ * ```
+ */
+export declare class AccelerationBehavior implements IEmitterBehavior {
+    static type: string;
+    static editorConfig: BehaviorEditorConfig;
+    order: BehaviorOrder;
+    private minStart;
+    private maxStart;
+    private accel;
+    private rotate;
+    private maxSpeed;
+    constructor(config: {
+        /**
+         * Minimum speed when initializing the particle, in world units/second.
+         */
+        minStart: number;
+        /**
+         * Maximum speed when initializing the particle. in world units/second.
+         */
+        maxStart: number;
+        /**
+         * Constant acceleration, in the coordinate space of the particle parent, in world units/second.
+         */
+        accel: {
+            x: number;
+            y: number;
+        };
+        /**
+         * Rotate the particle with its direction of movement.
+         * While initial movement direction reacts to rotation settings, this overrides any dynamic rotation.
+         * Defaults to false.
+         */
+        rotate?: boolean;
+        /**
+         * Maximum linear speed. 0 is unlimited. Defaults to 0.
+         */
+        maxSpeed?: number;
+    });
+    initParticles(first: Particle): void;
+    updateParticle(particle: Particle, deltaSec: number): void;
+}
+//# sourceMappingURL=AccelerationMovement.d.ts.map

package/dist/types/src/libs/particles/behaviors/AccelerationMovement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccelerationMovement.d.ts","sourceRoot":"","sources":["../../../../../../src/libs/particles/behaviors/AccelerationMovement.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IACzD,OAAc,IAAI,SAAqB;IACvC,OAAc,YAAY,EAAE,oBAAoB,CAAO;IAIhD,KAAK,gBAAqB;IACjC,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAQ;gBACZ,MAAM,EAAE;QAChB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAA;QAChB;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAA;QAChB;;WAEG;QACH,KAAK,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;QAC/B;;;;WAIG;QACH,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;KACpB;IAQD,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAkBpC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAuB7D"}

package/dist/types/src/libs/particles/behaviors/Alpha.d.ts

@@ -0,0 +1,60 @@
+import { Particle } from '../Particle';
+import { ValueList } from '../PropertyNode';
+import { BehaviorOrder, IEmitterBehavior } from './Behaviors';
+import { BehaviorEditorConfig } from './editor/Types';
+/**
+ * An Alpha behavior that applies an interpolated or stepped list of values to the particle's opacity.
+ *
+ * Example config:
+ * ```javascript
+ * {
+ *     type: 'alpha',
+ *     config: {
+ *         alpha: {
+ *              list: [{value: 0, time: 0}, {value: 1, time: 0.25}, {value: 0, time: 1}]
+ *         },
+ *     }
+ * }
+ * ```
+ */
+export declare class AlphaBehavior implements IEmitterBehavior {
+    static type: string;
+    static editorConfig: BehaviorEditorConfig;
+    order: BehaviorOrder;
+    private list;
+    constructor(config: {
+        /**
+         * Transparency of the particles from 0 (transparent) to 1 (opaque)
+         */
+        alpha: ValueList<number>;
+    });
+    initParticles(first: Particle): void;
+    updateParticle(particle: Particle): void;
+}
+/**
+ * An Alpha behavior that applies a static value to the particle's opacity at particle initialization.
+ *
+ * Example config:
+ * ```javascript
+ * {
+ *     type: 'alphaStatic',
+ *     config: {
+ *         alpha: 0.75,
+ *     }
+ * }
+ * ```
+ */
+export declare class StaticAlphaBehavior implements IEmitterBehavior {
+    static type: string;
+    static editorConfig: BehaviorEditorConfig;
+    order: BehaviorOrder;
+    private value;
+    constructor(config: {
+        /**
+         * Transparency of the particles from 0 (transparent) to 1 (opaque)
+         */
+        alpha: number;
+    });
+    initParticles(first: Particle): void;
+}
+//# sourceMappingURL=Alpha.d.ts.map

package/dist/types/src/libs/particles/behaviors/Alpha.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Alpha.d.ts","sourceRoot":"","sources":["../../../../../../src/libs/particles/behaviors/Alpha.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAgB,SAAS,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,aAAc,YAAW,gBAAgB;IAClD,OAAc,IAAI,SAAU;IAC5B,OAAc,YAAY,EAAE,oBAAoB,CAAO;IAEhD,KAAK,gBAAuB;IACnC,OAAO,CAAC,IAAI,CAAsB;gBACtB,MAAM,EAAE;QAChB;;WAEG;QACH,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,CAAA;KAC3B;IAKD,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IASpC,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAG3C;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,mBAAoB,YAAW,gBAAgB;IACxD,OAAc,IAAI,SAAgB;IAClC,OAAc,YAAY,EAAE,oBAAoB,CAAO;IAEhD,KAAK,gBAAuB;IACnC,OAAO,CAAC,KAAK,CAAQ;gBACT,MAAM,EAAE;QAChB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAA;KAChB;IAID,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAQvC"}

package/dist/types/src/libs/particles/behaviors/AnimatedTexture.d.ts

@@ -0,0 +1,111 @@
+import { Texture } from 'pixi.js';
+import { Particle } from '../Particle';
+import { BehaviorOrder, IEmitterBehavior } from './Behaviors';
+import { BehaviorEditorConfig } from './editor/Types';
+/**
+ * The format of a single animation to be used on a particle.
+ */
+export type AnimatedParticleArt = {
+    /**
+     * Framerate for the animation (in frames per second). A value of -1 will tie the framerate to
+     * the particle's lifetime so that the animation lasts exactly as long as the particle.
+     */
+    framerate: -1 | number;
+    /**
+     * If the animation should loop. Defaults to false.
+     */
+    loop?: boolean;
+    /**
+     * A list of textures or frame descriptions for duplicated frames.
+     * String values will be converted to textures with {@link ParticleUtils.GetTextureFromString}.
+     * Example of a texture repeated for 5 frames, followed by a second texture for one frame:
+     * ```javascript
+     * [{texture: 'myFirstTex', count: 5}, 'mySecondTex']
+     * ```
+     */
+    textures: (string | Texture | {
+        texture: string | Texture;
+        count: number;
+    })[];
+};
+/**
+ * Internal data format for playback.
+ */
+export type ParsedAnimatedParticleArt = {
+    textures: Texture[];
+    duration: number;
+    framerate: number;
+    loop: boolean;
+};
+/**
+ * A Texture behavior that picks a random animation for each particle to play.
+ * See {@link AnimatedParticleArt} for detailed configuration info.
+ *
+ * Example config:
+ * ```javascript
+ * {
+ *     type: 'animatedRandom',
+ *     config: {
+ *         anims: [
+ *              {
+ *                  framerate: 25,
+ *                  loop: true,
+ *                  textures: ['frame1', 'frame2', 'frame3']
+ *              },
+ *              {
+ *                  framerate: 25,
+ *                  loop: true,
+ *                  textures: ['frame3', 'frame2', 'frame1']
+ *              }
+ *         ],
+ *     }
+ * }
+ * ```
+ */
+export declare class RandomAnimatedTextureBehavior implements IEmitterBehavior {
+    static type: string;
+    static editorConfig: BehaviorEditorConfig;
+    order: BehaviorOrder;
+    private anims;
+    constructor(config: {
+        /**
+         * Animation configuration to use for each particle, randomly chosen from the list.
+         */
+        anims: AnimatedParticleArt[];
+    });
+    initParticles(first: Particle): void;
+    updateParticle(particle: Particle, deltaSec: number): void;
+}
+/**
+ * A Texture behavior that uses a single animation for each particle to play.
+ * See {@link AnimatedParticleArt} for detailed configuration info.
+ *
+ * Example config:
+ * ```javascript
+ * {
+ *     type: 'animatedSingle',
+ *     config: {
+ *         anim: {
+ *              framerate: 25,
+ *              loop: true,
+ *              textures: ['frame1', 'frame2', 'frame3']
+ *         }
+ *     }
+ * }
+ * ```
+ */
+export declare class SingleAnimatedTextureBehavior implements IEmitterBehavior {
+    static type: string;
+    static editorConfig: BehaviorEditorConfig;
+    order: BehaviorOrder;
+    private anim;
+    constructor(config: {
+        /**
+         * Animation configuration to use for each particle.
+         */
+        anim: AnimatedParticleArt;
+    });
+    initParticles(first: Particle): void;
+    updateParticle(particle: Particle, deltaSec: number): void;
+}
+//# sourceMappingURL=AnimatedTexture.d.ts.map

package/dist/types/src/libs/particles/behaviors/AnimatedTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedTexture.d.ts","sourceRoot":"","sources":["../../../../../../src/libs/particles/behaviors/AnimatedTexture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAEjC,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAC9B;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,GAAG,MAAM,CAAA;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;IACd;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC,MAAM,GAAG,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAA;CAChF,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACpC,QAAQ,EAAE,OAAO,EAAE,CAAA;IACnB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;CAChB,CAAA;AAgCD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,6BAA8B,YAAW,gBAAgB;IAClE,OAAc,IAAI,SAAmB;IACrC,OAAc,YAAY,EAAE,oBAAoB,CAAO;IAEhD,KAAK,gBAAuB;IACnC,OAAO,CAAC,KAAK,CAA6B;gBAC9B,MAAM,EAAE;QAChB;;WAEG;QACH,KAAK,EAAE,mBAAmB,EAAE,CAAA;KAC/B;IAkBD,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAsBpC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAsB7D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,6BAA8B,YAAW,gBAAgB;IAClE,OAAc,IAAI,SAAmB;IACrC,OAAc,YAAY,EAAE,oBAAoB,CAAO;IAEhD,KAAK,gBAAuB;IACnC,OAAO,CAAC,IAAI,CAA2B;gBAC3B,MAAM,EAAE;QAChB;;WAEG;QACH,IAAI,EAAE,mBAAmB,CAAA;KAC5B;IAcD,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAoBpC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CAsB7D"}

package/dist/types/src/libs/particles/behaviors/Behaviors.d.ts

@@ -0,0 +1,71 @@
+import { Particle } from '../Particle';
+import { BehaviorEditorConfig } from './editor/Types';
+/**
+ * All behaviors instances must implement this interface, and the class must match the
+ * {@link IEmitterBehaviorClass} interface. All behaviors must have an order property and
+ * `initParticles` method. Implementing the `updateParticle` or `recycleParticle` methods is optional.
+ */
+export type IEmitterBehavior = {
+    /**
+     * Order in which the behavior will be handled. Lower numbers are handled earlier, with an order of 0 getting
+     * special treatment before the Emitter's transformation is applied.
+     */
+    order: number;
+    /**
+     * Called to initialize a wave of particles, with a reference to the first particle in the linked list.
+     * @param first The first (maybe only) particle in a newly spawned wave of particles.
+     */
+    initParticles(first: Particle): void;
+    /**
+     * Updates a single particle for a given period of time elapsed. Return `true` to recycle the particle.
+     * @param particle The particle to update.
+     * @param deltaSec The time to advance the particle by in seconds.
+     */
+    updateParticle?(particle: Particle, deltaSec: number): void | boolean;
+    /**
+     * A hook for when a particle is recycled.
+     * @param particle The particle that was just recycled.
+     * @param natural `true` if the reycling was due to natural lifecycle, `false` if it was due to emitter cleanup.
+     */
+    recycleParticle?(particle: Particle, natural: boolean): void;
+};
+/**
+ * All behavior classes must match this interface. The instances need to implement the {@link IEmitterBehavior} interface.
+ */
+export type IEmitterBehaviorClass = {
+    /**
+     * The unique type name that the behavior is registered under.
+     */
+    type: string;
+    /**
+     * Configuration data for an editor to display this behavior. Does not need to exist in production code.
+     */
+    editorConfig?: BehaviorEditorConfig;
+    /**
+     * The behavior constructor itself.
+     * @param config The config for the behavior, which should match its defined specifications.
+     */
+    new (config: any): IEmitterBehavior;
+};
+/**
+ * Standard behavior order values, specifying when/how they are used. Other numeric values can be used,
+ * but only the Spawn value will be handled in a special way. All other values will be sorted numerically.
+ * Behaviors with the same value will not be given any specific sort order, as they are assumed to not
+ * interfere with each other.
+ */
+export declare enum BehaviorOrder {
+    /**
+     * Spawn - initial placement and/or rotation. This happens before rotation/translation due to
+     * emitter rotation/position is applied.
+     */
+    Spawn = 0,
+    /**
+     * Normal priority, for things that don't matter when they are applied.
+     */
+    Normal = 2,
+    /**
+     * Delayed priority, for things that need to read other values in order to act correctly.
+     */
+    Late = 5
+}
+//# sourceMappingURL=Behaviors.d.ts.map

package/dist/types/src/libs/particles/behaviors/Behaviors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Behaviors.d.ts","sourceRoot":"","sources":["../../../../../../src/libs/particles/behaviors/Behaviors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC3B;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAA;IACb;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI,CAAA;IACpC;;;;OAIG;IACH,cAAc,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAA;IACrE;;;;OAIG;IACH,eAAe,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CAC/D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,YAAY,CAAC,EAAE,oBAAoB,CAAA;IACnC;;;OAGG;IACH,KAAK,MAAM,EAAE,GAAG,GAAG,gBAAgB,CAAA;CACtC,CAAA;AAED;;;;;GAKG;AACH,oBAAY,aAAa;IACrB;;;OAGG;IACH,KAAK,IAAI;IACT;;OAEG;IACH,MAAM,IAAI;IACV;;OAEG;IACH,IAAI,IAAI;CACX"}

package/dist/types/src/libs/particles/behaviors/BlendMode.d.ts

@@ -0,0 +1,31 @@
+import { Particle } from '../Particle';
+import { BehaviorOrder, IEmitterBehavior } from './Behaviors';
+import { BehaviorEditorConfig } from './editor/Types';
+/**
+ * A Blend Mode behavior that applies a blend mode value to the particle at initialization.
+ *
+ * Example config:
+ * ```javascript
+ * {
+ *     type: 'blendMode',
+ *     config: {
+ *         blendMode: 'multiply',
+ *     }
+ * }
+ * ```
+ */
+export declare class BlendModeBehavior implements IEmitterBehavior {
+    static type: string;
+    static editorConfig: BehaviorEditorConfig;
+    order: BehaviorOrder;
+    private value;
+    constructor(config: {
+        /**
+         * Blend mode of all particles. This value is a key from
+         * [PixiJs's BLEND_MODE enum](https://pixijs.download/release/docs/PIXI.html#BLEND_MODES).
+         */
+        blendMode: string;
+    });
+    initParticles(first: Particle): void;
+}
+//# sourceMappingURL=BlendMode.d.ts.map

package/dist/types/src/libs/particles/behaviors/BlendMode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlendMode.d.ts","sourceRoot":"","sources":["../../../../../../src/libs/particles/behaviors/BlendMode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAA;AAErD;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,YAAW,gBAAgB;IACtD,OAAc,IAAI,SAAc;IAChC,OAAc,YAAY,EAAE,oBAAoB,CAAO;IAEhD,KAAK,gBAAuB;IACnC,OAAO,CAAC,KAAK,CAAQ;gBACT,MAAM,EAAE;QAChB;;;WAGG;QACH,SAAS,EAAE,MAAM,CAAA;KACpB;IAID,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;CAQvC"}