pixi-reels 0.1.0

package/dist/spin/phases/AnticipationPhase.d.ts

@@ -0,0 +1,24 @@
+import { ReelPhase } from './ReelPhase.js';
+export interface AnticipationPhaseConfig {
+    /** Duration override in ms. Uses speed profile anticipationDelay if not set. */
+    duration?: number;
+    /** Speed multiplier during anticipation. Default: 0.3 (30% of spin speed). */
+    speedMultiplier?: number;
+}
+/**
+ * Anticipation phase: slow-down tease before a reel stops.
+ *
+ * Decelerates to a fraction of spin speed, holds for a duration, then hands
+ * off to StopPhase. StopPhase resets speed to full spin speed at the start
+ * of its spin-out stage, so leaving speed low here is fine.
+ */
+export declare class AnticipationPhase extends ReelPhase<AnticipationPhaseConfig> {
+    readonly name = "anticipation";
+    readonly skippable = true;
+    private _tween;
+    protected onEnter(config: AnticipationPhaseConfig): void;
+    update(_deltaMs: number): void;
+    protected onSkip(): void;
+    private _kill;
+}
+//# sourceMappingURL=AnticipationPhase.d.ts.map

package/dist/spin/phases/AnticipationPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnticipationPhase.d.ts","sourceRoot":"","sources":["../../../src/spin/phases/AnticipationPhase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,SAAS,CAAC,uBAAuB,CAAC;IACvE,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,MAAM,CAAmC;IAEjD,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAqBxD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,SAAS,CAAC,MAAM,IAAI,IAAI;IAKxB,OAAO,CAAC,KAAK;CAMd"}

package/dist/spin/phases/PhaseFactory.d.ts

@@ -0,0 +1,21 @@
+import { Reel } from '../../core/Reel.js';
+import { SpeedProfile } from '../../config/types.js';
+import { ReelPhase } from './ReelPhase.js';
+type PhaseConstructor<T extends ReelPhase<any> = ReelPhase<any>> = new (reel: Reel, speed: SpeedProfile) => T;
+/**
+ * Factory for creating reel phase instances.
+ *
+ * Ships with all four default phases pre-registered.
+ * Users can override any phase by registering a custom constructor.
+ */
+export declare class PhaseFactory {
+    private _registry;
+    constructor();
+    /** Register or override a phase type. */
+    register<T extends ReelPhase<any>>(name: string, PhaseClass: PhaseConstructor<T>): void;
+    /** Create a phase instance for a reel. */
+    create<T extends ReelPhase<any> = ReelPhase<any>>(name: string, reel: Reel, speed: SpeedProfile): T;
+    has(name: string): boolean;
+}
+export {};
+//# sourceMappingURL=PhaseFactory.d.ts.map

package/dist/spin/phases/PhaseFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PhaseFactory.d.ts","sourceRoot":"","sources":["../../../src/spin/phases/PhaseFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAM3C,KAAK,gBAAgB,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,IAC7D,KAAK,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,KAAK,CAAC,CAAC;AAE7C;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAAuC;;IAUxD,yCAAyC;IACzC,QAAQ,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvF,0CAA0C;IAC1C,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EAC9C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,YAAY,GAClB,CAAC;IAUJ,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}

package/dist/spin/phases/ReelPhase.d.ts

@@ -0,0 +1,39 @@
+import { Reel } from '../../core/Reel.js';
+import { SpeedProfile } from '../../config/types.js';
+/**
+ * Abstract base for reel spin phases.
+ *
+ * Each phase represents one stage of the spin lifecycle:
+ * START → SPIN → ANTICIPATION → STOP.
+ *
+ * Phases are entered and exited by SpinController, and can be skipped
+ * if marked as skippable and the user triggers skip/slam-stop.
+ *
+ * @typeParam TConfig - Phase-specific configuration type.
+ */
+export declare abstract class ReelPhase<TConfig = void> {
+    abstract readonly name: string;
+    abstract readonly skippable: boolean;
+    protected _reel: Reel;
+    protected _speed: SpeedProfile;
+    protected _resolve: (() => void) | null;
+    protected _isActive: boolean;
+    constructor(reel: Reel, speed: SpeedProfile);
+    get reel(): Reel;
+    get isActive(): boolean;
+    /** Enter the phase. Returns a promise that resolves when the phase is complete. */
+    run(config: TConfig): Promise<void>;
+    /** Skip the phase immediately (if skippable). */
+    skip(): void;
+    /** Force-complete the phase regardless of skippable flag. */
+    forceComplete(): void;
+    /** Called each frame while the phase is active. */
+    abstract update(deltaMs: number): void;
+    /** Subclass: set up the phase (start tweens, set speed, etc). */
+    protected abstract onEnter(config: TConfig): void;
+    /** Subclass: clean up when skipped or force-completed. */
+    protected abstract onSkip(): void;
+    /** Call when the phase naturally completes. */
+    protected _complete(): void;
+}
+//# sourceMappingURL=ReelPhase.d.ts.map

package/dist/spin/phases/ReelPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReelPhase.d.ts","sourceRoot":"","sources":["../../../src/spin/phases/ReelPhase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,8BAAsB,SAAS,CAAC,OAAO,GAAG,IAAI;IAC5C,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAErC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;IACtB,SAAS,CAAC,MAAM,EAAE,YAAY,CAAC;IAC/B,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/C,SAAS,CAAC,SAAS,UAAS;gBAEhB,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY;IAK3C,IAAI,IAAI,IAAI,IAAI,CAEf;IAED,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,mFAAmF;IAC7E,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC,iDAAiD;IACjD,IAAI,IAAI,IAAI;IAMZ,6DAA6D;IAC7D,aAAa,IAAI,IAAI;IAMrB,mDAAmD;IACnD,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAEtC,iEAAiE;IACjE,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAEjD,0DAA0D;IAC1D,SAAS,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI;IAEjC,+CAA+C;IAC/C,SAAS,CAAC,SAAS,IAAI,IAAI;CAO5B"}

package/dist/spin/phases/SpinPhase.d.ts

@@ -0,0 +1,25 @@
+import { ReelPhase } from './ReelPhase.js';
+export interface SpinPhaseConfig {
+    /** Minimum time to spin before allowing stop. Overrides speed profile if set. */
+    minimumSpinTime?: number;
+}
+/**
+ * Continuous spinning at constant speed.
+ *
+ * Runs until externally resolved (when setResult arrives). Tracks minimum
+ * spin time via ticker accumulation so it behaves consistently when the tab
+ * is hidden (no reliance on wall-clock performance.now()).
+ */
+export declare class SpinPhase extends ReelPhase<SpinPhaseConfig> {
+    readonly name = "spin";
+    readonly skippable = false;
+    private _elapsed;
+    private _minTime;
+    private _readyToStop;
+    protected onEnter(config: SpinPhaseConfig): void;
+    update(deltaMs: number): void;
+    /** Signal that this phase should end (called by SpinController when result arrives). */
+    resolve(): void;
+    protected onSkip(): void;
+}
+//# sourceMappingURL=SpinPhase.d.ts.map

package/dist/spin/phases/SpinPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpinPhase.d.ts","sourceRoot":"","sources":["../../../src/spin/phases/SpinPhase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,SAAU,SAAQ,SAAS,CAAC,eAAe,CAAC;IACvD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,SAAS,SAAS;IAE3B,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,YAAY,CAAS;IAE7B,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAMhD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO7B,wFAAwF;IACxF,OAAO,IAAI,IAAI;IAOf,SAAS,CAAC,MAAM,IAAI,IAAI;CAGzB"}

package/dist/spin/phases/StartPhase.d.ts

@@ -0,0 +1,26 @@
+import { ReelPhase } from './ReelPhase.js';
+import { SpinningMode } from '../modes/SpinningMode.js';
+export interface StartPhaseConfig {
+    /** Spinning mode to set on enter. */
+    spinningMode: SpinningMode;
+    /** Delay before this reel starts (for staggered start). */
+    delay?: number;
+}
+/**
+ * Accelerates the reel from rest to full spin speed.
+ *
+ * Optionally performs a brief step-back (reel reverses a tiny amount) before
+ * accelerating upward, giving the classic slot machine "pull" feel.
+ */
+export declare class StartPhase extends ReelPhase<StartPhaseConfig> {
+    readonly name = "start";
+    readonly skippable = true;
+    private _tween;
+    private _delayedCall;
+    protected onEnter(config: StartPhaseConfig): void;
+    private _launch;
+    update(_deltaMs: number): void;
+    protected onSkip(): void;
+    private _kill;
+}
+//# sourceMappingURL=StartPhase.d.ts.map

package/dist/spin/phases/StartPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartPhase.d.ts","sourceRoot":"","sources":["../../../src/spin/phases/StartPhase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,YAAY,EAAE,YAAY,CAAC;IAC3B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,SAAS,CAAC,gBAAgB,CAAC;IACzD,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,YAAY,CAAgC;IAEpD,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAejD,OAAO,CAAC,OAAO;IA6Bf,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAI9B,SAAS,CAAC,MAAM,IAAI,IAAI;IAKxB,OAAO,CAAC,KAAK;CAUd"}

package/dist/spin/phases/StopPhase.d.ts

@@ -0,0 +1,37 @@
+import { ReelPhase } from './ReelPhase.js';
+export interface StopPhaseConfig {
+    /** Target symbols for this reel (full frame including buffers, top-to-bottom). */
+    targetFrame: string[];
+    /** Delay before this reel starts stopping (for staggered stop). */
+    delay?: number;
+}
+/**
+ * Stops the reel on the target frame with a weighted, slot-machine feel.
+ *
+ * Sequence:
+ * 1. Wait for the staggered delay.
+ * 2. Keep spinning at full speed with `isStopping` flagged. The target frame
+ *    is loaded into the StopSequencer; each wrap event at the top of the
+ *    reel pulls the next frame symbol — so targets arrive in the visible
+ *    area naturally, carrying the full momentum of the spin.
+ * 3. When the sequencer is exhausted, snap to grid and bounce:
+ *    - overshoot downward by `bounceDistance` with `power1.out`
+ *    - settle back upward with `power1.out`
+ *    Both legs share a duration for a symmetric, weighty landing.
+ */
+export declare class StopPhase extends ReelPhase<StopPhaseConfig> {
+    readonly name = "stop";
+    readonly skippable = true;
+    private _config;
+    private _delayTween;
+    private _bounceTween;
+    private _stage;
+    private _baseY;
+    protected onEnter(config: StopPhaseConfig): void;
+    private _beginSpinOut;
+    update(_deltaMs: number): void;
+    private _landAndBounce;
+    protected onSkip(): void;
+    private _killTweens;
+}
+//# sourceMappingURL=StopPhase.d.ts.map

package/dist/spin/phases/StopPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StopPhase.d.ts","sourceRoot":"","sources":["../../../src/spin/phases/StopPhase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,SAAU,SAAQ,SAAS,CAAC,eAAe,CAAC;IACvD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,YAAY,CAAmC;IACvD,OAAO,CAAC,MAAM,CAAuD;IACrE,OAAO,CAAC,MAAM,CAAK;IAEnB,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI;IAahD,OAAO,CAAC,aAAa;IAcrB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS9B,OAAO,CAAC,cAAc;IAoCtB,SAAS,CAAC,MAAM,IAAI,IAAI;IAkBxB,OAAO,CAAC,WAAW;CAUpB"}

package/dist/spine/SpineReelSymbol.d.ts

@@ -0,0 +1,111 @@
+import { Spine, TrackEntry } from '@esotericsoftware/spine-pixi-v8';
+import { ReelSymbol } from '../symbols/ReelSymbol.js';
+/**
+ * Per-symbol overrides so a skeleton with unusual animation names still works.
+ *
+ * Example: Bonanza's `low_1` has a typo (`ide` instead of `idle`) —
+ * `{ low1: { idle: 'ide' } }` fixes it without touching the asset.
+ */
+export type SymbolAnimOverrides = Record<string, Partial<Record<'idle' | 'landing' | 'win' | 'out' | 'blur', string>>>;
+export interface SpineReelSymbolOptions {
+    /** Map of symbolId -> { skeletonAlias, atlasAlias } */
+    spineMap: Record<string, {
+        skeleton: string;
+        atlas: string;
+    }>;
+    /** Default idle animation name. Default: 'idle'. */
+    idleAnimation?: string;
+    /** Default win animation name. Default: 'win'. */
+    winAnimation?: string;
+    /** Default landing (one-shot) animation name. Default: 'landing'. */
+    landingAnimation?: string;
+    /**
+     * Default "exit" animation name — used as the cascade pop / disintegrate.
+     * If the skeleton doesn't have it, callers should fall back to an alpha tween.
+     * Default: 'disintegration'.
+     */
+    outAnimation?: string;
+    /** Default "blur" (fast spin) animation name. Default: 'blur'. */
+    blurAnimation?: string;
+    /** Per-symbol overrides (see SymbolAnimOverrides). */
+    animations?: SymbolAnimOverrides;
+    /** Scale for spine instances. Default: 1. */
+    scale?: number;
+    /**
+     * If true, automatically plays the `blur` animation when the owning reel
+     * enters the spin phase, and reverts to idle when it lands. Requires the
+     * skeleton to have a `blur` animation (or the overridden name). Default: false.
+     */
+    autoPlayBlur?: boolean;
+    /**
+     * If true, automatically plays the `landing` animation concurrently with
+     * the stop-phase bounce. Requires the skeleton to have a `landing`
+     * animation (or the overridden name). Default: false.
+     */
+    autoPlayLanding?: boolean;
+}
+/**
+ * ReelSymbol implementation using Spine 2D skeletons.
+ *
+ * Caches one Spine instance per symbolId for instant swapping, plays idle on
+ * activate, and exposes the canonical set of one-shot animations (`landing`,
+ * `win`, `out`, reactions). Modeled on the Bonanza / Hold & Win slot-game
+ * conventions — drop in any skeleton that follows the same vocabulary.
+ *
+ * Import from the `pixi-reels/spine` subpath so non-Spine consumers can
+ * tree-shake this module and `@esotericsoftware/spine-pixi-v8` out of their
+ * production bundle:
+ *
+ * ```ts
+ * import { SpineReelSymbol } from 'pixi-reels/spine';
+ * ```
+ */
+export declare class SpineReelSymbol extends ReelSymbol {
+    private _spines;
+    private _currentSpine;
+    private _spineMap;
+    private _defaultAnims;
+    private _overrides;
+    private _scale;
+    private _autoPlayBlur;
+    private _autoPlayLanding;
+    private _oneShotResolve;
+    private _cellWidth;
+    private _cellHeight;
+    constructor(options: SpineReelSymbolOptions);
+    onReelSpinStart(): void;
+    onReelSpinEnd(): void;
+    onReelLanded(): void;
+    /** Resolve an animation name for the current symbol, respecting overrides. */
+    private _animNameFor;
+    protected onActivate(symbolId: string): void;
+    protected onDeactivate(): void;
+    /** Play the win animation on track 0. Returns when it completes. */
+    playWin(): Promise<void>;
+    /**
+     * Play the landing animation (one-shot). Call this when the reel settles —
+     * typically inside a `spin:reelLanded` listener.
+     */
+    playLanding(): Promise<void>;
+    /**
+     * Play the exit / disintegrate animation. Returns a promise that resolves
+     * when it completes. Use in cascades instead of the default alpha fade.
+     */
+    playOut(): Promise<void>;
+    /**
+     * Swap the primary track to the blur animation for the SPIN phase. Reverts
+     * to idle automatically on `stopAnimation()` or next activate.
+     */
+    playBlur(): void;
+    /** Play an arbitrary animation on a given track. Non-blocking. */
+    playOnTrack(track: number, animName: string, loop?: boolean): TrackEntry | null;
+    stopAnimation(): void;
+    /** Access the underlying Spine — for advanced needs (reactions, events). */
+    get spine(): Spine | null;
+    private _currentListener;
+    private _playOneShot;
+    resize(width: number, height: number): void;
+    private _positionSpine;
+    protected onDestroy(): void;
+}
+//# sourceMappingURL=SpineReelSymbol.d.ts.map

package/dist/spine/SpineReelSymbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpineReelSymbol.d.ts","sourceRoot":"","sources":["../../src/spine/SpineReelSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,MAAM,CACtC,MAAM,EACN,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,CACrE,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9D,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,UAAU,CAAC,EAAE,mBAAmB,CAAC;IACjC,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,aAAa,CAA4E;IACjG,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,WAAW,CAAK;gBAEZ,OAAO,EAAE,sBAAsB;IAgBlC,eAAe,IAAI,IAAI;IAIvB,aAAa,IAAI,IAAI;IAIrB,YAAY,IAAI,IAAI;IAM7B,8EAA8E;IAC9E,OAAO,CAAC,YAAY;IAKpB,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IA0B5C,SAAS,CAAC,YAAY,IAAI,IAAI;IAoB9B,oEAAoE;IAC9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;;OAGG;IACH,QAAQ,IAAI,IAAI;IAOhB,kEAAkE;IAClE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,UAAQ,GAAG,UAAU,GAAG,IAAI;IAM7E,aAAa,IAAI,IAAI;IAcrB,4EAA4E;IAC5E,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAExB;IAID,OAAO,CAAC,gBAAgB,CAEjB;YAEO,YAAY;IAkC1B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3C,OAAO,CAAC,cAAc;cAKH,SAAS,IAAI,IAAI;CAOrC"}

package/dist/spine/index.d.ts

@@ -0,0 +1,5 @@
+export { SpineSymbol } from '../symbols/SpineSymbol.js';
+export type { SpineSymbolOptions } from '../symbols/SpineSymbol.js';
+export { SpineReelSymbol } from './SpineReelSymbol.js';
+export type { SpineReelSymbolOptions, SymbolAnimOverrides, } from './SpineReelSymbol.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/spine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spine/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC"}

package/dist/spine.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./SpineSymbol-B40TevSr.cjs`);let t=require(`@esotericsoftware/spine-pixi-v8`);var n=class extends e.n{_spines=new Map;_currentSpine=null;_spineMap;_defaultAnims;_overrides;_scale;_autoPlayBlur;_autoPlayLanding;_oneShotResolve=null;_cellWidth=0;_cellHeight=0;constructor(e){super(),this._spineMap=e.spineMap,this._defaultAnims={idle:e.idleAnimation??`idle`,win:e.winAnimation??`win`,landing:e.landingAnimation??`landing`,out:e.outAnimation??`disintegration`,blur:e.blurAnimation??`blur`},this._overrides=e.animations??{},this._scale=e.scale??1,this._autoPlayBlur=e.autoPlayBlur??!1,this._autoPlayLanding=e.autoPlayLanding??!1}onReelSpinStart(){this._autoPlayBlur&&this.playBlur()}onReelSpinEnd(){this._autoPlayBlur&&this.stopAnimation()}onReelLanded(){this._autoPlayLanding&&this.playLanding()}_animNameFor(e){return this._overrides[this.symbolId]?.[e]??this._defaultAnims[e]}onActivate(e){this._currentSpine&&(this._currentSpine.visible=!1);let n=this._spines.get(e);if(!n){let r=this._spineMap[e];if(!r)return;n=t.Spine.from({skeleton:r.skeleton,atlas:r.atlas}),n.scale.set(this._scale),this.view.addChild(n),this._spines.set(e,n)}this._positionSpine(n),n.visible=!0,this._currentSpine=n,this._oneShotResolve=null;let r=this._animNameFor(`idle`);n.skeleton.data.findAnimation(r)&&n.state.setAnimation(0,r,!0)}onDeactivate(){if(this._currentSpine&&=(this._currentSpine.state.clearTracks(),this._currentSpine.state.removeListener(this._currentListener),this._currentSpine.skeleton.setToSetupPose(),this._currentSpine.visible=!1,null),this._oneShotResolve){let e=this._oneShotResolve;this._oneShotResolve=null,e()}}async playWin(){return this._playOneShot(this._animNameFor(`win`),0,!0)}async playLanding(){return this._playOneShot(this._animNameFor(`landing`),0,!0)}async playOut(){return this._playOneShot(this._animNameFor(`out`),0,!1)}playBlur(){if(!this._currentSpine)return;let e=this._animNameFor(`blur`);this._currentSpine.skeleton.data.findAnimation(e)&&this._currentSpine.state.setAnimation(0,e,!0)}playOnTrack(e,t,n=!1){return!this._currentSpine||!this._currentSpine.skeleton.data.findAnimation(t)?null:this._currentSpine.state.setAnimation(e,t,n)}stopAnimation(){if(!this._currentSpine)return;this._currentSpine.state.removeListener(this._currentListener);let e=this._animNameFor(`idle`);if(this._currentSpine.skeleton.data.findAnimation(e)&&this._currentSpine.state.setAnimation(0,e,!0),this._oneShotResolve){let e=this._oneShotResolve;this._oneShotResolve=null,e()}}get spine(){return this._currentSpine}_currentListener={};async _playOneShot(e,t,n){if(!this._currentSpine)return;let r=this._currentSpine;if(r.skeleton.data.findAnimation(e))return new Promise(i=>{this._oneShotResolve=i;let a=r.state.setAnimation(t,e,!1),o={complete:e=>{if(e===a){if(r.state.removeListener(this._currentListener),n){let e=this._animNameFor(`idle`);r.skeleton.data.findAnimation(e)&&r.state.setAnimation(t,e,!0)}if(this._oneShotResolve){let e=this._oneShotResolve;this._oneShotResolve=null,e()}}}};this._currentListener=o,r.state.addListener(o)})}resize(e,t){this._cellWidth=e,this._cellHeight=t;for(let[,e]of this._spines)this._positionSpine(e)}_positionSpine(e){e.x=this._cellWidth/2,e.y=this._cellHeight/2}onDestroy(){for(let[,e]of this._spines)e.state.clearListeners(),e.destroy();this._spines.clear()}};exports.SpineReelSymbol=n,exports.SpineSymbol=e.t;
+//# sourceMappingURL=spine.cjs.map

package/dist/spine.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine.cjs","names":[],"sources":["../src/spine/SpineReelSymbol.ts"],"sourcesContent":["import { Spine, type TrackEntry } from '@esotericsoftware/spine-pixi-v8';\nimport { ReelSymbol } from '../symbols/ReelSymbol.js';\n\n/**\n * Per-symbol overrides so a skeleton with unusual animation names still works.\n *\n * Example: Bonanza's `low_1` has a typo (`ide` instead of `idle`) —\n * `{ low1: { idle: 'ide' } }` fixes it without touching the asset.\n */\nexport type SymbolAnimOverrides = Record<\n  string,\n  Partial<Record<'idle' | 'landing' | 'win' | 'out' | 'blur', string>>\n>;\n\nexport interface SpineReelSymbolOptions {\n  /** Map of symbolId -> { skeletonAlias, atlasAlias } */\n  spineMap: Record<string, { skeleton: string; atlas: string }>;\n  /** Default idle animation name. Default: 'idle'. */\n  idleAnimation?: string;\n  /** Default win animation name. Default: 'win'. */\n  winAnimation?: string;\n  /** Default landing (one-shot) animation name. Default: 'landing'. */\n  landingAnimation?: string;\n  /**\n   * Default \"exit\" animation name — used as the cascade pop / disintegrate.\n   * If the skeleton doesn't have it, callers should fall back to an alpha tween.\n   * Default: 'disintegration'.\n   */\n  outAnimation?: string;\n  /** Default \"blur\" (fast spin) animation name. Default: 'blur'. */\n  blurAnimation?: string;\n  /** Per-symbol overrides (see SymbolAnimOverrides). */\n  animations?: SymbolAnimOverrides;\n  /** Scale for spine instances. Default: 1. */\n  scale?: number;\n  /**\n   * If true, automatically plays the `blur` animation when the owning reel\n   * enters the spin phase, and reverts to idle when it lands. Requires the\n   * skeleton to have a `blur` animation (or the overridden name). Default: false.\n   */\n  autoPlayBlur?: boolean;\n  /**\n   * If true, automatically plays the `landing` animation concurrently with\n   * the stop-phase bounce. Requires the skeleton to have a `landing`\n   * animation (or the overridden name). Default: false.\n   */\n  autoPlayLanding?: boolean;\n}\n\n/**\n * ReelSymbol implementation using Spine 2D skeletons.\n *\n * Caches one Spine instance per symbolId for instant swapping, plays idle on\n * activate, and exposes the canonical set of one-shot animations (`landing`,\n * `win`, `out`, reactions). Modeled on the Bonanza / Hold & Win slot-game\n * conventions — drop in any skeleton that follows the same vocabulary.\n *\n * Import from the `pixi-reels/spine` subpath so non-Spine consumers can\n * tree-shake this module and `@esotericsoftware/spine-pixi-v8` out of their\n * production bundle:\n *\n * ```ts\n * import { SpineReelSymbol } from 'pixi-reels/spine';\n * ```\n */\nexport class SpineReelSymbol extends ReelSymbol {\n  private _spines = new Map<string, Spine>();\n  private _currentSpine: Spine | null = null;\n  private _spineMap: Record<string, { skeleton: string; atlas: string }>;\n  private _defaultAnims: { idle: string; win: string; landing: string; out: string; blur: string };\n  private _overrides: SymbolAnimOverrides;\n  private _scale: number;\n  private _autoPlayBlur: boolean;\n  private _autoPlayLanding: boolean;\n  private _oneShotResolve: (() => void) | null = null;\n  private _cellWidth = 0;\n  private _cellHeight = 0;\n\n  constructor(options: SpineReelSymbolOptions) {\n    super();\n    this._spineMap = options.spineMap;\n    this._defaultAnims = {\n      idle: options.idleAnimation ?? 'idle',\n      win: options.winAnimation ?? 'win',\n      landing: options.landingAnimation ?? 'landing',\n      out: options.outAnimation ?? 'disintegration',\n      blur: options.blurAnimation ?? 'blur',\n    };\n    this._overrides = options.animations ?? {};\n    this._scale = options.scale ?? 1;\n    this._autoPlayBlur = options.autoPlayBlur ?? false;\n    this._autoPlayLanding = options.autoPlayLanding ?? false;\n  }\n\n  override onReelSpinStart(): void {\n    if (this._autoPlayBlur) this.playBlur();\n  }\n\n  override onReelSpinEnd(): void {\n    if (this._autoPlayBlur) this.stopAnimation();\n  }\n\n  override onReelLanded(): void {\n    if (this._autoPlayLanding) {\n      void this.playLanding();\n    }\n  }\n\n  /** Resolve an animation name for the current symbol, respecting overrides. */\n  private _animNameFor(role: 'idle' | 'landing' | 'win' | 'out' | 'blur'): string {\n    const override = this._overrides[this.symbolId]?.[role];\n    return override ?? this._defaultAnims[role];\n  }\n\n  protected onActivate(symbolId: string): void {\n    if (this._currentSpine) this._currentSpine.visible = false;\n\n    let spine = this._spines.get(symbolId);\n    if (!spine) {\n      const cfg = this._spineMap[symbolId];\n      if (!cfg) return;\n      spine = Spine.from({ skeleton: cfg.skeleton, atlas: cfg.atlas });\n      spine.scale.set(this._scale);\n      this.view.addChild(spine);\n      this._spines.set(symbolId, spine);\n    }\n\n    this._positionSpine(spine);\n    spine.visible = true;\n    this._currentSpine = spine;\n\n    // Clear any lingering one-shot resolve from a prior pool use\n    this._oneShotResolve = null;\n\n    const idleName = this._animNameFor('idle');\n    if (spine.skeleton.data.findAnimation(idleName)) {\n      spine.state.setAnimation(0, idleName, true);\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._currentSpine) {\n      this._currentSpine.state.clearTracks();\n      this._currentSpine.state.removeListener(this._currentListener);\n      // Reset the skeleton to its setup pose, otherwise a symbol that ends on\n      // an invisible \"out\" frame (e.g. after `playOut()` / disintegrate) is\n      // still invisible when the pool reassigns it on the next spin.\n      this._currentSpine.skeleton.setToSetupPose();\n      this._currentSpine.visible = false;\n      this._currentSpine = null;\n    }\n    if (this._oneShotResolve) {\n      const fn = this._oneShotResolve;\n      this._oneShotResolve = null;\n      fn();\n    }\n  }\n\n  // -- Canonical one-shot animations ---------------------------------------\n\n  /** Play the win animation on track 0. Returns when it completes. */\n  async playWin(): Promise<void> {\n    return this._playOneShot(this._animNameFor('win'), 0, true);\n  }\n\n  /**\n   * Play the landing animation (one-shot). Call this when the reel settles —\n   * typically inside a `spin:reelLanded` listener.\n   */\n  async playLanding(): Promise<void> {\n    return this._playOneShot(this._animNameFor('landing'), 0, true);\n  }\n\n  /**\n   * Play the exit / disintegrate animation. Returns a promise that resolves\n   * when it completes. Use in cascades instead of the default alpha fade.\n   */\n  async playOut(): Promise<void> {\n    return this._playOneShot(this._animNameFor('out'), 0, false);\n  }\n\n  /**\n   * Swap the primary track to the blur animation for the SPIN phase. Reverts\n   * to idle automatically on `stopAnimation()` or next activate.\n   */\n  playBlur(): void {\n    if (!this._currentSpine) return;\n    const name = this._animNameFor('blur');\n    if (!this._currentSpine.skeleton.data.findAnimation(name)) return;\n    this._currentSpine.state.setAnimation(0, name, true);\n  }\n\n  /** Play an arbitrary animation on a given track. Non-blocking. */\n  playOnTrack(track: number, animName: string, loop = false): TrackEntry | null {\n    if (!this._currentSpine) return null;\n    if (!this._currentSpine.skeleton.data.findAnimation(animName)) return null;\n    return this._currentSpine.state.setAnimation(track, animName, loop);\n  }\n\n  stopAnimation(): void {\n    if (!this._currentSpine) return;\n    this._currentSpine.state.removeListener(this._currentListener);\n    const idleName = this._animNameFor('idle');\n    if (this._currentSpine.skeleton.data.findAnimation(idleName)) {\n      this._currentSpine.state.setAnimation(0, idleName, true);\n    }\n    if (this._oneShotResolve) {\n      const fn = this._oneShotResolve;\n      this._oneShotResolve = null;\n      fn();\n    }\n  }\n\n  /** Access the underlying Spine — for advanced needs (reactions, events). */\n  get spine(): Spine | null {\n    return this._currentSpine;\n  }\n\n  // -- Internals -----------------------------------------------------------\n\n  private _currentListener: {\n    complete?: (entry: TrackEntry) => void;\n  } = {};\n\n  private async _playOneShot(\n    animName: string,\n    track: number,\n    returnToIdle: boolean,\n  ): Promise<void> {\n    if (!this._currentSpine) return;\n    const spine = this._currentSpine;\n    if (!spine.skeleton.data.findAnimation(animName)) return;\n\n    return new Promise<void>((resolve) => {\n      this._oneShotResolve = resolve;\n      const entry = spine.state.setAnimation(track, animName, false);\n      const listener = {\n        complete: (done: TrackEntry) => {\n          if (done !== entry) return;\n          spine.state.removeListener(this._currentListener);\n          if (returnToIdle) {\n            const idleName = this._animNameFor('idle');\n            if (spine.skeleton.data.findAnimation(idleName)) {\n              spine.state.setAnimation(track, idleName, true);\n            }\n          }\n          if (this._oneShotResolve) {\n            const fn = this._oneShotResolve;\n            this._oneShotResolve = null;\n            fn();\n          }\n        },\n      };\n      this._currentListener = listener;\n      spine.state.addListener(listener);\n    });\n  }\n\n  resize(width: number, height: number): void {\n    this._cellWidth = width;\n    this._cellHeight = height;\n    for (const [, spine] of this._spines) this._positionSpine(spine);\n  }\n\n  private _positionSpine(spine: Spine): void {\n    spine.x = this._cellWidth / 2;\n    spine.y = this._cellHeight / 2;\n  }\n\n  protected override onDestroy(): void {\n    for (const [, spine] of this._spines) {\n      spine.state.clearListeners();\n      spine.destroy();\n    }\n    this._spines.clear();\n  }\n}\n"],"mappings":"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"}

package/dist/spine.js

@@ -0,0 +1,123 @@
+import { n as e, t } from "./SpineSymbol-D2jhCzFW.js";
+import { Spine as n } from "@esotericsoftware/spine-pixi-v8";
+//#region src/spine/SpineReelSymbol.ts
+var r = class extends e {
+	_spines = /* @__PURE__ */ new Map();
+	_currentSpine = null;
+	_spineMap;
+	_defaultAnims;
+	_overrides;
+	_scale;
+	_autoPlayBlur;
+	_autoPlayLanding;
+	_oneShotResolve = null;
+	_cellWidth = 0;
+	_cellHeight = 0;
+	constructor(e) {
+		super(), this._spineMap = e.spineMap, this._defaultAnims = {
+			idle: e.idleAnimation ?? "idle",
+			win: e.winAnimation ?? "win",
+			landing: e.landingAnimation ?? "landing",
+			out: e.outAnimation ?? "disintegration",
+			blur: e.blurAnimation ?? "blur"
+		}, this._overrides = e.animations ?? {}, this._scale = e.scale ?? 1, this._autoPlayBlur = e.autoPlayBlur ?? !1, this._autoPlayLanding = e.autoPlayLanding ?? !1;
+	}
+	onReelSpinStart() {
+		this._autoPlayBlur && this.playBlur();
+	}
+	onReelSpinEnd() {
+		this._autoPlayBlur && this.stopAnimation();
+	}
+	onReelLanded() {
+		this._autoPlayLanding && this.playLanding();
+	}
+	_animNameFor(e) {
+		return this._overrides[this.symbolId]?.[e] ?? this._defaultAnims[e];
+	}
+	onActivate(e) {
+		this._currentSpine && (this._currentSpine.visible = !1);
+		let t = this._spines.get(e);
+		if (!t) {
+			let r = this._spineMap[e];
+			if (!r) return;
+			t = n.from({
+				skeleton: r.skeleton,
+				atlas: r.atlas
+			}), t.scale.set(this._scale), this.view.addChild(t), this._spines.set(e, t);
+		}
+		this._positionSpine(t), t.visible = !0, this._currentSpine = t, this._oneShotResolve = null;
+		let r = this._animNameFor("idle");
+		t.skeleton.data.findAnimation(r) && t.state.setAnimation(0, r, !0);
+	}
+	onDeactivate() {
+		if (this._currentSpine &&= (this._currentSpine.state.clearTracks(), this._currentSpine.state.removeListener(this._currentListener), this._currentSpine.skeleton.setToSetupPose(), this._currentSpine.visible = !1, null), this._oneShotResolve) {
+			let e = this._oneShotResolve;
+			this._oneShotResolve = null, e();
+		}
+	}
+	async playWin() {
+		return this._playOneShot(this._animNameFor("win"), 0, !0);
+	}
+	async playLanding() {
+		return this._playOneShot(this._animNameFor("landing"), 0, !0);
+	}
+	async playOut() {
+		return this._playOneShot(this._animNameFor("out"), 0, !1);
+	}
+	playBlur() {
+		if (!this._currentSpine) return;
+		let e = this._animNameFor("blur");
+		this._currentSpine.skeleton.data.findAnimation(e) && this._currentSpine.state.setAnimation(0, e, !0);
+	}
+	playOnTrack(e, t, n = !1) {
+		return !this._currentSpine || !this._currentSpine.skeleton.data.findAnimation(t) ? null : this._currentSpine.state.setAnimation(e, t, n);
+	}
+	stopAnimation() {
+		if (!this._currentSpine) return;
+		this._currentSpine.state.removeListener(this._currentListener);
+		let e = this._animNameFor("idle");
+		if (this._currentSpine.skeleton.data.findAnimation(e) && this._currentSpine.state.setAnimation(0, e, !0), this._oneShotResolve) {
+			let e = this._oneShotResolve;
+			this._oneShotResolve = null, e();
+		}
+	}
+	get spine() {
+		return this._currentSpine;
+	}
+	_currentListener = {};
+	async _playOneShot(e, t, n) {
+		if (!this._currentSpine) return;
+		let r = this._currentSpine;
+		if (r.skeleton.data.findAnimation(e)) return new Promise((i) => {
+			this._oneShotResolve = i;
+			let a = r.state.setAnimation(t, e, !1), o = { complete: (e) => {
+				if (e === a) {
+					if (r.state.removeListener(this._currentListener), n) {
+						let e = this._animNameFor("idle");
+						r.skeleton.data.findAnimation(e) && r.state.setAnimation(t, e, !0);
+					}
+					if (this._oneShotResolve) {
+						let e = this._oneShotResolve;
+						this._oneShotResolve = null, e();
+					}
+				}
+			} };
+			this._currentListener = o, r.state.addListener(o);
+		});
+	}
+	resize(e, t) {
+		this._cellWidth = e, this._cellHeight = t;
+		for (let [, e] of this._spines) this._positionSpine(e);
+	}
+	_positionSpine(e) {
+		e.x = this._cellWidth / 2, e.y = this._cellHeight / 2;
+	}
+	onDestroy() {
+		for (let [, e] of this._spines) e.state.clearListeners(), e.destroy();
+		this._spines.clear();
+	}
+};
+//#endregion
+export { r as SpineReelSymbol, t as SpineSymbol };
+
+//# sourceMappingURL=spine.js.map

package/dist/spine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spine.js","names":[],"sources":["../src/spine/SpineReelSymbol.ts"],"sourcesContent":["import { Spine, type TrackEntry } from '@esotericsoftware/spine-pixi-v8';\nimport { ReelSymbol } from '../symbols/ReelSymbol.js';\n\n/**\n * Per-symbol overrides so a skeleton with unusual animation names still works.\n *\n * Example: Bonanza's `low_1` has a typo (`ide` instead of `idle`) —\n * `{ low1: { idle: 'ide' } }` fixes it without touching the asset.\n */\nexport type SymbolAnimOverrides = Record<\n  string,\n  Partial<Record<'idle' | 'landing' | 'win' | 'out' | 'blur', string>>\n>;\n\nexport interface SpineReelSymbolOptions {\n  /** Map of symbolId -> { skeletonAlias, atlasAlias } */\n  spineMap: Record<string, { skeleton: string; atlas: string }>;\n  /** Default idle animation name. Default: 'idle'. */\n  idleAnimation?: string;\n  /** Default win animation name. Default: 'win'. */\n  winAnimation?: string;\n  /** Default landing (one-shot) animation name. Default: 'landing'. */\n  landingAnimation?: string;\n  /**\n   * Default \"exit\" animation name — used as the cascade pop / disintegrate.\n   * If the skeleton doesn't have it, callers should fall back to an alpha tween.\n   * Default: 'disintegration'.\n   */\n  outAnimation?: string;\n  /** Default \"blur\" (fast spin) animation name. Default: 'blur'. */\n  blurAnimation?: string;\n  /** Per-symbol overrides (see SymbolAnimOverrides). */\n  animations?: SymbolAnimOverrides;\n  /** Scale for spine instances. Default: 1. */\n  scale?: number;\n  /**\n   * If true, automatically plays the `blur` animation when the owning reel\n   * enters the spin phase, and reverts to idle when it lands. Requires the\n   * skeleton to have a `blur` animation (or the overridden name). Default: false.\n   */\n  autoPlayBlur?: boolean;\n  /**\n   * If true, automatically plays the `landing` animation concurrently with\n   * the stop-phase bounce. Requires the skeleton to have a `landing`\n   * animation (or the overridden name). Default: false.\n   */\n  autoPlayLanding?: boolean;\n}\n\n/**\n * ReelSymbol implementation using Spine 2D skeletons.\n *\n * Caches one Spine instance per symbolId for instant swapping, plays idle on\n * activate, and exposes the canonical set of one-shot animations (`landing`,\n * `win`, `out`, reactions). Modeled on the Bonanza / Hold & Win slot-game\n * conventions — drop in any skeleton that follows the same vocabulary.\n *\n * Import from the `pixi-reels/spine` subpath so non-Spine consumers can\n * tree-shake this module and `@esotericsoftware/spine-pixi-v8` out of their\n * production bundle:\n *\n * ```ts\n * import { SpineReelSymbol } from 'pixi-reels/spine';\n * ```\n */\nexport class SpineReelSymbol extends ReelSymbol {\n  private _spines = new Map<string, Spine>();\n  private _currentSpine: Spine | null = null;\n  private _spineMap: Record<string, { skeleton: string; atlas: string }>;\n  private _defaultAnims: { idle: string; win: string; landing: string; out: string; blur: string };\n  private _overrides: SymbolAnimOverrides;\n  private _scale: number;\n  private _autoPlayBlur: boolean;\n  private _autoPlayLanding: boolean;\n  private _oneShotResolve: (() => void) | null = null;\n  private _cellWidth = 0;\n  private _cellHeight = 0;\n\n  constructor(options: SpineReelSymbolOptions) {\n    super();\n    this._spineMap = options.spineMap;\n    this._defaultAnims = {\n      idle: options.idleAnimation ?? 'idle',\n      win: options.winAnimation ?? 'win',\n      landing: options.landingAnimation ?? 'landing',\n      out: options.outAnimation ?? 'disintegration',\n      blur: options.blurAnimation ?? 'blur',\n    };\n    this._overrides = options.animations ?? {};\n    this._scale = options.scale ?? 1;\n    this._autoPlayBlur = options.autoPlayBlur ?? false;\n    this._autoPlayLanding = options.autoPlayLanding ?? false;\n  }\n\n  override onReelSpinStart(): void {\n    if (this._autoPlayBlur) this.playBlur();\n  }\n\n  override onReelSpinEnd(): void {\n    if (this._autoPlayBlur) this.stopAnimation();\n  }\n\n  override onReelLanded(): void {\n    if (this._autoPlayLanding) {\n      void this.playLanding();\n    }\n  }\n\n  /** Resolve an animation name for the current symbol, respecting overrides. */\n  private _animNameFor(role: 'idle' | 'landing' | 'win' | 'out' | 'blur'): string {\n    const override = this._overrides[this.symbolId]?.[role];\n    return override ?? this._defaultAnims[role];\n  }\n\n  protected onActivate(symbolId: string): void {\n    if (this._currentSpine) this._currentSpine.visible = false;\n\n    let spine = this._spines.get(symbolId);\n    if (!spine) {\n      const cfg = this._spineMap[symbolId];\n      if (!cfg) return;\n      spine = Spine.from({ skeleton: cfg.skeleton, atlas: cfg.atlas });\n      spine.scale.set(this._scale);\n      this.view.addChild(spine);\n      this._spines.set(symbolId, spine);\n    }\n\n    this._positionSpine(spine);\n    spine.visible = true;\n    this._currentSpine = spine;\n\n    // Clear any lingering one-shot resolve from a prior pool use\n    this._oneShotResolve = null;\n\n    const idleName = this._animNameFor('idle');\n    if (spine.skeleton.data.findAnimation(idleName)) {\n      spine.state.setAnimation(0, idleName, true);\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._currentSpine) {\n      this._currentSpine.state.clearTracks();\n      this._currentSpine.state.removeListener(this._currentListener);\n      // Reset the skeleton to its setup pose, otherwise a symbol that ends on\n      // an invisible \"out\" frame (e.g. after `playOut()` / disintegrate) is\n      // still invisible when the pool reassigns it on the next spin.\n      this._currentSpine.skeleton.setToSetupPose();\n      this._currentSpine.visible = false;\n      this._currentSpine = null;\n    }\n    if (this._oneShotResolve) {\n      const fn = this._oneShotResolve;\n      this._oneShotResolve = null;\n      fn();\n    }\n  }\n\n  // -- Canonical one-shot animations ---------------------------------------\n\n  /** Play the win animation on track 0. Returns when it completes. */\n  async playWin(): Promise<void> {\n    return this._playOneShot(this._animNameFor('win'), 0, true);\n  }\n\n  /**\n   * Play the landing animation (one-shot). Call this when the reel settles —\n   * typically inside a `spin:reelLanded` listener.\n   */\n  async playLanding(): Promise<void> {\n    return this._playOneShot(this._animNameFor('landing'), 0, true);\n  }\n\n  /**\n   * Play the exit / disintegrate animation. Returns a promise that resolves\n   * when it completes. Use in cascades instead of the default alpha fade.\n   */\n  async playOut(): Promise<void> {\n    return this._playOneShot(this._animNameFor('out'), 0, false);\n  }\n\n  /**\n   * Swap the primary track to the blur animation for the SPIN phase. Reverts\n   * to idle automatically on `stopAnimation()` or next activate.\n   */\n  playBlur(): void {\n    if (!this._currentSpine) return;\n    const name = this._animNameFor('blur');\n    if (!this._currentSpine.skeleton.data.findAnimation(name)) return;\n    this._currentSpine.state.setAnimation(0, name, true);\n  }\n\n  /** Play an arbitrary animation on a given track. Non-blocking. */\n  playOnTrack(track: number, animName: string, loop = false): TrackEntry | null {\n    if (!this._currentSpine) return null;\n    if (!this._currentSpine.skeleton.data.findAnimation(animName)) return null;\n    return this._currentSpine.state.setAnimation(track, animName, loop);\n  }\n\n  stopAnimation(): void {\n    if (!this._currentSpine) return;\n    this._currentSpine.state.removeListener(this._currentListener);\n    const idleName = this._animNameFor('idle');\n    if (this._currentSpine.skeleton.data.findAnimation(idleName)) {\n      this._currentSpine.state.setAnimation(0, idleName, true);\n    }\n    if (this._oneShotResolve) {\n      const fn = this._oneShotResolve;\n      this._oneShotResolve = null;\n      fn();\n    }\n  }\n\n  /** Access the underlying Spine — for advanced needs (reactions, events). */\n  get spine(): Spine | null {\n    return this._currentSpine;\n  }\n\n  // -- Internals -----------------------------------------------------------\n\n  private _currentListener: {\n    complete?: (entry: TrackEntry) => void;\n  } = {};\n\n  private async _playOneShot(\n    animName: string,\n    track: number,\n    returnToIdle: boolean,\n  ): Promise<void> {\n    if (!this._currentSpine) return;\n    const spine = this._currentSpine;\n    if (!spine.skeleton.data.findAnimation(animName)) return;\n\n    return new Promise<void>((resolve) => {\n      this._oneShotResolve = resolve;\n      const entry = spine.state.setAnimation(track, animName, false);\n      const listener = {\n        complete: (done: TrackEntry) => {\n          if (done !== entry) return;\n          spine.state.removeListener(this._currentListener);\n          if (returnToIdle) {\n            const idleName = this._animNameFor('idle');\n            if (spine.skeleton.data.findAnimation(idleName)) {\n              spine.state.setAnimation(track, idleName, true);\n            }\n          }\n          if (this._oneShotResolve) {\n            const fn = this._oneShotResolve;\n            this._oneShotResolve = null;\n            fn();\n          }\n        },\n      };\n      this._currentListener = listener;\n      spine.state.addListener(listener);\n    });\n  }\n\n  resize(width: number, height: number): void {\n    this._cellWidth = width;\n    this._cellHeight = height;\n    for (const [, spine] of this._spines) this._positionSpine(spine);\n  }\n\n  private _positionSpine(spine: Spine): void {\n    spine.x = this._cellWidth / 2;\n    spine.y = this._cellHeight / 2;\n  }\n\n  protected override onDestroy(): void {\n    for (const [, spine] of this._spines) {\n      spine.state.clearListeners();\n      spine.destroy();\n    }\n    this._spines.clear();\n  }\n}\n"],"mappings":"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"}

package/dist/spotlight/SymbolSpotlight.d.ts

@@ -0,0 +1,70 @@
+import { Reel } from '../core/Reel.js';
+import { ReelViewport } from '../core/ReelViewport.js';
+import { SymbolPosition } from '../events/ReelEvents.js';
+import { Disposable } from '../utils/Disposable.js';
+export interface SpotlightOptions {
+    /** Opacity of the dim overlay (0-1). Default: 0.5. */
+    dimAmount?: number;
+    /** Whether to play win animation on spotlighted symbols. Default: true. */
+    playWinAnimation?: boolean;
+    /** Whether to re-parent symbols above the mask. Default: true. */
+    promoteAboveMask?: boolean;
+}
+export interface WinLine {
+    positions: SymbolPosition[];
+}
+export interface CycleOptions extends SpotlightOptions {
+    /** Milliseconds to display each win line. Default: 2000. */
+    displayDuration?: number;
+    /** Milliseconds between lines. Default: 300. */
+    gapDuration?: number;
+    /** Number of cycles (-1 for infinite). Default: 1. */
+    cycles?: number;
+}
+/**
+ * The "we just won" visual primitive.
+ *
+ * The spotlight is what turns a landed grid into a celebration. Given a
+ * list of winning cell positions, it:
+ *
+ *   1. Fades in the dim overlay behind everything (everything that is
+ *      not winning visually sinks into the background).
+ *   2. Re-parents each winning `ReelSymbol` into the viewport's
+ *      spotlight layer so its animation isn't clipped by the reel mask.
+ *   3. Calls `playWin()` on each winner (your symbol class's one-shot).
+ *   4. When you call `hide()` or the cycle ends, it puts every symbol
+ *      back where it came from and removes the dim overlay.
+ *
+ * Two modes:
+ *   - `show(positions, options)` — one-shot. Cell highlight + promote +
+ *     play win. Returns when the animation fully ends.
+ *   - `cycle(lines, options)` — iterate multiple win lines with a
+ *     configurable per-line duration and gap, optionally repeating.
+ *
+ * Win detection is NOT part of this. pixi-reels never computes wins —
+ * your server / game code decides which cells are winners and passes
+ * them here. See [ADR 007](../../docs/adr/007-scope.md).
+ */
+export declare class SymbolSpotlight implements Disposable {
+    private _reels;
+    private _viewport;
+    private _promoted;
+    private _isActive;
+    private _isDestroyed;
+    private _cycleAbort;
+    constructor(reels: Reel[], viewport: ReelViewport);
+    get isActive(): boolean;
+    get isDestroyed(): boolean;
+    /** Show spotlight on specific positions. */
+    show(positions: SymbolPosition[], options?: SpotlightOptions): Promise<void>;
+    /** Hide the spotlight and return symbols to their original positions. */
+    hide(): void;
+    /**
+     * Cycle through win lines, showing each for a duration.
+     * Returns when all cycles complete or when hide() is called.
+     */
+    cycle(winLines: WinLine[], options?: CycleOptions): Promise<void>;
+    destroy(): void;
+    private _wait;
+}
+//# sourceMappingURL=SymbolSpotlight.d.ts.map

package/dist/spotlight/SymbolSpotlight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolSpotlight.d.ts","sourceRoot":"","sources":["../../src/spotlight/SymbolSpotlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,WAAW,gBAAgB;IAC/B,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACpD,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,eAAgB,YAAW,UAAU;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,SAAS,CAAwB;IACzC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAAgC;gBAEvC,KAAK,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,YAAY;IAKjD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,4CAA4C;IACtC,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IA8CtF,yEAAyE;IACzE,IAAI,IAAI,IAAI;IAyBZ;;;OAGG;IACG,KAAK,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3E,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,KAAK;CAad"}

package/dist/symbols/AnimatedSpriteSymbol.d.ts

@@ -0,0 +1,30 @@
+import { Texture } from 'pixi.js';
+import { ReelSymbol } from './ReelSymbol.js';
+export interface AnimatedSpriteSymbolOptions {
+    /** Map of symbolId → array of frame textures. */
+    frames: Record<string, Texture[]>;
+    /** Playback speed (frames per second multiplier). Default: 1. */
+    animationSpeed?: number;
+    /** Anchor point. Default: { x: 0.5, y: 0.5 }. */
+    anchor?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Symbol implementation using PixiJS AnimatedSprite.
+ * Swaps frame arrays on activate. Win animation plays the full sequence.
+ */
+export declare class AnimatedSpriteSymbol extends ReelSymbol {
+    private _animSprite;
+    private _frames;
+    private _animationSpeed;
+    private _winResolve;
+    constructor(options: AnimatedSpriteSymbolOptions);
+    protected onActivate(symbolId: string): void;
+    protected onDeactivate(): void;
+    playWin(): Promise<void>;
+    stopAnimation(): void;
+    resize(width: number, height: number): void;
+}
+//# sourceMappingURL=AnimatedSpriteSymbol.d.ts.map

package/dist/symbols/AnimatedSpriteSymbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnimatedSpriteSymbol.d.ts","sourceRoot":"","sources":["../../src/symbols/AnimatedSpriteSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,2BAA2B;IAC1C,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAClC,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,WAAW,CAAiB;IACpC,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAA6B;gBAEpC,OAAO,EAAE,2BAA2B;IAehD,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQ5C,SAAS,CAAC,YAAY,IAAI,IAAI;IAKxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAa9B,aAAa,IAAI,IAAI;IASrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAI5C"}