@rb-games/core 0.1.0

package/dist/particle/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 interface 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 interface 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 interface 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 interface 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 interface 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 interface 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/particle/EmitterConfig.d.ts.map

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

package/dist/particle/LinkedListContainer.d.ts

@@ -0,0 +1,7 @@
+import { Container } from "pixi.js";
+/** Interface for a child of a LinkedListContainer (has the prev/next properties added) */
+export interface LinkedListChild extends Container {
+    nextChild: LinkedListChild | null;
+    prevChild: LinkedListChild | null;
+}
+//# sourceMappingURL=LinkedListContainer.d.ts.map

package/dist/particle/LinkedListContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkedListContainer.d.ts","sourceRoot":"","sources":["../../particle/LinkedListContainer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,0FAA0F;AAC1F,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAC9C,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,eAAe,GAAG,IAAI,CAAC;CACrC"}

package/dist/particle/Particle.d.ts

@@ -0,0 +1,63 @@
+import { Sprite } from 'pixi.js';
+import { Emitter } from './Emitter';
+import { LinkedListChild } from './LinkedListContainer';
+/**
+ * An individual particle image. You shouldn't have to deal with these.
+ */
+export declare class Particle extends Sprite implements LinkedListChild {
+    /**
+     * 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: LinkedListChild;
+    nextChild: LinkedListChild;
+    /**
+     * Static per-particle configuration for behaviors to use. Is not cleared when recycling.
+     */
+    config: {
+        [key: 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/particle/Particle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Particle.d.ts","sourceRoot":"","sources":["../../particle/Particle.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD;;GAEG;AACH,qBAAa,QAAS,SAAQ,MAAO,YAAW,eAAe;IAC3D;;OAEG;IACI,OAAO,EAAE,OAAO,CAAC;IACxB;;OAEG;IACI,OAAO,EAAE,MAAM,CAAC;IACvB;;OAEG;IACI,GAAG,EAAE,MAAM,CAAC;IACnB;;OAEG;IACI,UAAU,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACI,WAAW,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACI,IAAI,EAAE,QAAQ,CAAC;IAEtB;;OAEG;IACI,IAAI,EAAE,QAAQ,CAAC;IAEf,SAAS,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,eAAe,CAAC;IAElC;;OAEG;IACI,MAAM,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,CAAC;IAEtC;;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/particle/ParticleUtils.d.ts

@@ -0,0 +1,97 @@
+import { PointData, Texture } 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 interface Color {
+    r: number;
+    g: number;
+    b: number;
+    a?: number;
+}
+export interface 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;
+type BLEND_MODES = 'inherit' | 'normal' | 'add' | 'multiply' | 'screen' | 'darken' | 'lighten' | 'erase' | 'color-dodge' | 'color-burn' | 'linear-burn' | 'linear-dodge' | 'linear-light' | 'hard-light' | 'soft-light' | 'pin-light' | 'difference' | 'exclusion' | 'overlay' | 'saturation' | 'color' | 'luminosity' | 'normal-npm' | 'add-npm' | 'screen-npm' | 'none' | 'subtract' | 'divide' | 'vivid-light' | 'hard-mix' | 'negation' | 'min' | 'max';
+/**
+ * Gets a blend mode, ensuring that it is valid.
+ * @param name The name of the blend mode to get.
+ * @return The blend mode as specified in the PIXI.BLEND_MODES enumeration.
+ */
+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>;
+export {};
+//# sourceMappingURL=ParticleUtils.d.ts.map

package/dist/particle/ParticleUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParticleUtils.d.ts","sourceRoot":"","sources":["../../particle/ParticleUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEzD;;GAEG;AAGH,eAAO,IAAI,oBAAoB,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAsB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,KAAK;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAElD;;GAEG;AACH,eAAO,MAAM,OAAO,QAAQ,CAAC;AAE7B,eAAO,MAAM,WAAW,QAAgB,CAAC;AAEzC;;;;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,GAAW,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE/C;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAKhD;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,CAwB7D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,CAmBhE;AAED,KAAK,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,YAAY,GAAG,aAAa,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAE5b;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAGtD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,SAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAqCnG"}

package/dist/particle/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/particle/PropertyList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyList.d.ts","sourceRoot":"","sources":["../../particle/PropertyList.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,UAAU,EAAS,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAsF9C;;;GAGG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB;;OAEG;IACI,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC9B;;;;;OAKG;IACI,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C;;;;OAIG;IACI,IAAI,EAAE,UAAU,CAAC;IACxB;;OAEG;IACH,OAAO,CAAC,OAAO,CAAU;IAEzB;;OAEG;gBACS,OAAO,UAAQ;IAO3B;;;;OAIG;IACI,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;CAe7C"}

package/dist/particle/PropertyNode.d.ts

@@ -0,0 +1,74 @@
+import { EaseSegment, SimpleEase, Color } from './ParticleUtils';
+import { BasicTweenable } from './EmitterConfig';
+/**
+ * A single step of a ValueList.
+ */
+export interface 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 interface 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/particle/PropertyNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyNode.d.ts","sourceRoot":"","sources":["../../particle/PropertyNode.ts"],"names":[],"mappings":"AACA,OAAO,EAA0B,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC;IACT;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC;IACxB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,EAAE,CAAC;CACrC;AACD;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB;;OAEG;IACI,KAAK,EAAE,CAAC,CAAC;IAChB;;OAEG;IACI,IAAI,EAAE,MAAM,CAAC;IACpB;;OAEG;IACI,IAAI,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAC7B;;OAEG;IACI,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,UAAU,CAAC;IAExB;;;;OAIG;gBACS,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,WAAW,EAAE;IAarE;;;;;;;;;OASG;WAEW,UAAU,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,GAAG,CAAC,CAAC;CAiC5I"}

package/dist/particle/SpineEmitter.d.ts

@@ -0,0 +1,55 @@
+import { Container } from 'pixi.js';
+import { Emitter } from './Emitter';
+import { EmitterConfigV3 } from './EmitterConfig';
+/**
+ * Configuration for SpineEmitter, extends standard EmitterConfigV3
+ * Makes 'pos' optional since SpineEmitter can default to {x: 0, y: 0}
+ */
+export interface SpineEmitterConfig extends Omit<EmitterConfigV3, 'pos'> {
+    /**
+     * Spine data configuration
+     */
+    spineData: {
+        /**
+         * Skeleton asset key (without extension)
+         */
+        skeleton: string;
+        /**
+         * Atlas asset key (without extension)
+         */
+        atlas: string;
+    };
+    /**
+     * Default position to spawn particles from inside the parent container.
+     * Defaults to {x: 0, y: 0} if not provided.
+     */
+    pos?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * A particle emitter that uses Spine animations instead of sprite textures.
+ * Each particle is a SpineParticle containing a Spine instance.
+ *
+ * Overrides createParticle() to create SpineParticle instances instead of
+ * regular Particle (Sprite) instances.
+ */
+export declare class SpineEmitter extends Emitter {
+    /**
+     * Skeleton asset key for creating Spine instances
+     */
+    protected skeletonKey: string;
+    /**
+     * Atlas asset key for creating Spine instances
+     */
+    protected atlasKey: string;
+    constructor(particleParent: Container, config: SpineEmitterConfig);
+    /**
+     * Override createParticle to return SpineParticle instead of Particle.
+     * This is called by the base Emitter when spawning new particles.
+     * Returns any to satisfy base class signature while actually returning SpineParticle.
+     */
+    protected createParticle(): any;
+}
+//# sourceMappingURL=SpineEmitter.d.ts.map

package/dist/particle/SpineEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpineEmitter.d.ts","sourceRoot":"","sources":["../../particle/SpineEmitter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAGlD;;;GAGG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC;IACtE;;OAEG;IACH,SAAS,EAAE;QACT;;WAEG;QACH,QAAQ,EAAE,MAAM,CAAC;QACjB;;WAEG;QACH,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF;;;OAGG;IACH,GAAG,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,SAAQ,OAAO;IACvC;;OAEG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAEf,cAAc,EAAE,SAAS,EAAE,MAAM,EAAE,kBAAkB;IAkBjE;;;;OAIG;cACgB,cAAc,IAAI,GAAG;CASzC"}

package/dist/particle/SpineParticle.d.ts

@@ -0,0 +1,74 @@
+import { Container } from 'pixi.js';
+import { Spine } from '@esotericsoftware/spine-pixi-v8';
+import { LinkedListChild } from './LinkedListContainer';
+/**
+ * A Spine-based particle. Uses a Spine animation instead of a Sprite texture.
+ * Extends Container to hold the Spine instance.
+ */
+export declare class SpineParticle extends Container implements LinkedListChild {
+    /**
+     * The Spine instance for this particle.
+     */
+    spine: Spine;
+    /**
+     * The emitter that controls this particle.
+     * Using any to avoid circular dependency with SpineEmitter.
+     */
+    emitter: any;
+    /**
+     * 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: SpineParticle;
+    /**
+     * Reference to the previous particle in the list.
+     */
+    prev: SpineParticle;
+    prevChild: LinkedListChild;
+    nextChild: LinkedListChild;
+    /**
+     * Static per-particle configuration for behaviors to use. Is not cleared when recycling.
+     */
+    config: {
+        [key: string]: any;
+    };
+    /**
+     * @param emitter The emitter that controls this particle.
+     */
+    constructor(emitter: any);
+    /**
+     * Sets the Spine instance for this particle.
+     * Called by SpineEmitter when creating the particle.
+     */
+    setSpine(spine: Spine): void;
+    /**
+     * 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=SpineParticle.d.ts.map