pixi-reels 0.1.0

package/dist/symbols/ReelSymbol.d.ts

@@ -0,0 +1,84 @@
+import { Container } from 'pixi.js';
+import { Disposable } from '../utils/Disposable.js';
+/**
+ * One visible cell on a reel — the thing that actually draws.
+ *
+ * `ReelSymbol` is the abstract base class. Subclass it to pick a rendering
+ * technology (`SpriteSymbol`, `AnimatedSpriteSymbol`, `SpineSymbol`, or a
+ * custom class of your own). The reel set pools instances aggressively:
+ * one instance is reused many times as it scrolls off one identity and on
+ * to another, so implementations must never assume "I was just created".
+ *
+ * Required lifecycle hooks:
+ *
+ *   - `onActivate(symbolId)` — the pool just handed me a new identity. Swap
+ *     texture, restart animations, bring myself out of any "ended" pose.
+ *   - `onDeactivate()` — I am about to be pooled. Pause animations, clear
+ *     listeners, leave myself in a clean state for the next activation.
+ *   - `playWin()` — the spotlight is celebrating me. Return a promise that
+ *     resolves when the one-shot animation is done.
+ *   - `stopAnimation()` — spotlight is over, return to idle.
+ *   - `resize(w, h)` — the reel's cell size changed (on every symbol swap).
+ *     Store the dimensions and reposition internal children. Forgetting
+ *     this is the single most common "why do my symbols scatter" bug.
+ *
+ * ```
+ * create → activate(symbolId) → [playWin / stopAnimation]
+ *                             → deactivate
+ *                             → activate(newId) → ...
+ * ```
+ *
+ * There's no hidden GC. Hold resources? Override `onDestroy()`.
+ */
+export declare abstract class ReelSymbol implements Disposable {
+    /** The PixiJS container that holds this symbol's visual. */
+    readonly view: Container;
+    private _symbolId;
+    private _isDestroyed;
+    constructor();
+    get symbolId(): string;
+    get isDestroyed(): boolean;
+    /**
+     * Activate the symbol with a new identity.
+     * Called when the symbol enters the visible reel or is recycled from the pool.
+     */
+    activate(symbolId: string): void;
+    /**
+     * Deactivate the symbol before returning it to the pool.
+     * Stops any running animations and hides the view.
+     */
+    deactivate(): void;
+    /** Pool reset — aliases deactivate. */
+    reset(): void;
+    destroy(): void;
+    /** Subclass hook: set up visuals for the given symbolId. */
+    protected abstract onActivate(symbolId: string): void;
+    /** Subclass hook: clean up visuals. */
+    protected abstract onDeactivate(): void;
+    /** Subclass hook: additional cleanup on destroy. */
+    protected onDestroy(): void;
+    /** Play the win/highlight animation for this symbol. Resolves when complete. */
+    abstract playWin(): Promise<void>;
+    /** Immediately stop any running animation and return to idle. */
+    abstract stopAnimation(): void;
+    /** Resize the symbol's visual to fit the given dimensions. */
+    abstract resize(width: number, height: number): void;
+    /**
+     * Lifecycle hook: the owning reel has started spinning.
+     * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayBlur) to swap to
+     * a blur animation automatically.
+     */
+    onReelSpinStart(): void;
+    /**
+     * Lifecycle hook: the owning reel is about to stop (just before bounce).
+     * Default: no-op.
+     */
+    onReelSpinEnd(): void;
+    /**
+     * Lifecycle hook: the owning reel has landed on its final symbols.
+     * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayLanding) to fire
+     * a landing animation concurrently with the bounce.
+     */
+    onReelLanded(): void;
+}
+//# sourceMappingURL=ReelSymbol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReelSymbol.d.ts","sourceRoot":"","sources":["../../src/symbols/ReelSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,8BAAsB,UAAW,YAAW,UAAU;IACpD,4DAA4D;IAC5D,SAAgB,IAAI,EAAE,SAAS,CAAC;IAEhC,OAAO,CAAC,SAAS,CAAc;IAC/B,OAAO,CAAC,YAAY,CAAS;;IAM7B,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMhC;;;OAGG;IACH,UAAU,IAAI,IAAI;IAOlB,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,IAAI;IAQf,4DAA4D;IAC5D,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAErD,uCAAuC;IACvC,SAAS,CAAC,QAAQ,CAAC,YAAY,IAAI,IAAI;IAEvC,oDAAoD;IACpD,SAAS,CAAC,SAAS,IAAI,IAAI;IAI3B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjC,iEAAiE;IACjE,QAAQ,CAAC,aAAa,IAAI,IAAI;IAE9B,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAEpD;;;;OAIG;IACH,eAAe,IAAI,IAAI;IAEvB;;;OAGG;IACH,aAAa,IAAI,IAAI;IAErB;;;;OAIG;IACH,YAAY,IAAI,IAAI;CACrB"}

package/dist/symbols/SpineSymbol.d.ts

@@ -0,0 +1,34 @@
+import { ReelSymbol } from './ReelSymbol.js';
+export interface SpineSymbolOptions {
+    /** Map of symbolId → SkeletonData. */
+    skeletonDataMap: Record<string, any>;
+    /** Default animation name to play in idle. Default: 'idle'. */
+    idleAnimation?: string;
+    /** Animation name to play on win. Default: 'win'. */
+    winAnimation?: string;
+    /** Default skin name. Default: 'default'. */
+    defaultSkin?: string;
+}
+/**
+ * Symbol implementation using Spine 2D skeletal animation.
+ *
+ * Requires `@esotericsoftware/spine-pixi-v8` as an optional peer dependency.
+ * If Spine is not installed, constructing a SpineSymbol will throw.
+ */
+export declare class SpineSymbol extends ReelSymbol {
+    private _spine;
+    private _skeletonDataMap;
+    private _idleAnimation;
+    private _winAnimation;
+    private _defaultSkin;
+    private _winResolve;
+    private _currentSkeletonKey;
+    constructor(options: SpineSymbolOptions);
+    protected onActivate(symbolId: string): void;
+    protected onDeactivate(): void;
+    playWin(): Promise<void>;
+    stopAnimation(): void;
+    resize(width: number, height: number): void;
+    protected onDestroy(): void;
+}
+//# sourceMappingURL=SpineSymbol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpineSymbol.d.ts","sourceRoot":"","sources":["../../src/symbols/SpineSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAiB7C,MAAM,WAAW,kBAAkB;IACjC,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,WAAY,SAAQ,UAAU;IACzC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,gBAAgB,CAAsB;IAC9C,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,mBAAmB,CAAc;gBAE7B,OAAO,EAAE,kBAAkB;IAcvC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAyB5C,SAAS,CAAC,YAAY,IAAI,IAAI;IAQxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB9B,aAAa,IAAI,IAAI;IAYrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;cAWxB,SAAS,IAAI,IAAI;CAOrC"}

package/dist/symbols/SpriteSymbol.d.ts

@@ -0,0 +1,29 @@
+import { Texture } from 'pixi.js';
+import { ReelSymbol } from './ReelSymbol.js';
+export interface SpriteSymbolOptions {
+    /** Map of symbolId → Texture. */
+    textures: Record<string, Texture>;
+    /** Anchor point. Default: { x: 0.5, y: 0.5 }. */
+    anchor?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Symbol implementation using a simple PixiJS Sprite.
+ * Swaps texture on activate. Win animation is a scale pulse via GSAP.
+ */
+export declare class SpriteSymbol extends ReelSymbol {
+    private _sprite;
+    private _textures;
+    private _winTween;
+    constructor(options: SpriteSymbolOptions);
+    protected onActivate(symbolId: string): void;
+    protected onDeactivate(): void;
+    playWin(): Promise<void>;
+    stopAnimation(): void;
+    resize(width: number, height: number): void;
+    protected onDestroy(): void;
+    private _killWinTween;
+}
+//# sourceMappingURL=SpriteSymbol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SpriteSymbol.d.ts","sourceRoot":"","sources":["../../src/symbols/SpriteSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,mBAAmB;IAClC,iCAAiC;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,iDAAiD;IACjD,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED;;;GAGG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,SAAS,CAAgC;gBAErC,OAAO,EAAE,mBAAmB;IASxC,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAO5C,SAAS,CAAC,YAAY,IAAI,IAAI;IAKxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAe9B,aAAa,IAAI,IAAI;IAKrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;cAKxB,SAAS,IAAI,IAAI;IAIpC,OAAO,CAAC,aAAa;CAMtB"}

package/dist/symbols/SymbolFactory.d.ts

@@ -0,0 +1,20 @@
+import { ReelSymbol } from './ReelSymbol.js';
+import { SymbolRegistry } from './SymbolRegistry.js';
+/**
+ * Creates and pools ReelSymbol instances.
+ *
+ * Wraps SymbolRegistry for creation and ObjectPool for recycling.
+ * Game code should not need to interact with this directly —
+ * it's managed by Reel internally.
+ */
+export declare class SymbolFactory {
+    private _registry;
+    private _pool;
+    constructor(_registry: SymbolRegistry, maxPoolPerKey?: number);
+    /** Get a symbol (from pool or newly created), activated with symbolId. */
+    acquire(symbolId: string): ReelSymbol;
+    /** Return a symbol to the pool. */
+    release(symbol: ReelSymbol): void;
+    destroy(): void;
+}
+//# sourceMappingURL=SymbolFactory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolFactory.d.ts","sourceRoot":"","sources":["../../src/symbols/SymbolFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;GAMG;AACH,qBAAa,aAAa;IAItB,OAAO,CAAC,SAAS;IAHnB,OAAO,CAAC,KAAK,CAAyB;gBAG5B,SAAS,EAAE,cAAc,EACjC,aAAa,GAAE,MAAW;IAU5B,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IAQrC,mCAAmC;IACnC,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAMjC,OAAO,IAAI,IAAI;CAGhB"}

package/dist/symbols/SymbolRegistry.d.ts

@@ -0,0 +1,25 @@
+import { ReelSymbol } from './ReelSymbol.js';
+/**
+ * Registry that maps symbolIds to their constructors and options.
+ *
+ * Used by the builder and SymbolFactory to create symbols on demand.
+ */
+export declare class SymbolRegistry {
+    private _entries;
+    /**
+     * Register a symbol type.
+     *
+     * ```ts
+     * registry.register('cherry', SpriteSymbol, { textures: { cherry: tex } });
+     * ```
+     */
+    register<T extends ReelSymbol>(symbolId: string, SymbolClass: new (options: any) => T, options: T extends {
+        constructor: (options: infer O) => any;
+    } ? O : any): void;
+    /** Create a new symbol instance for the given symbolId. */
+    create(symbolId: string): ReelSymbol;
+    has(symbolId: string): boolean;
+    get symbolIds(): string[];
+    get size(): number;
+}
+//# sourceMappingURL=SymbolRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SymbolRegistry.d.ts","sourceRoot":"","sources":["../../src/symbols/SymbolRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AASlD;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAoC;IAEpD;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,SAAS,UAAU,EAC3B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,KAAK,OAAO,EAAE,GAAG,KAAK,CAAC,EACpC,OAAO,EAAE,CAAC,SAAS;QAAE,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,GAAG,CAAA;KAAE,GAAG,CAAC,GAAG,GAAG,GACtE,IAAI;IAOP,2DAA2D;IAC3D,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU;IAYpC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF"}

package/dist/testing/FakeTicker.d.ts

@@ -0,0 +1,45 @@
+import { Ticker } from 'pixi.js';
+type TickerCallback = (ticker: Ticker) => void;
+/**
+ * Minimal drop-in replacement for `PIXI.Ticker` for tests.
+ *
+ * Exposes the exact surface `pixi-reels` uses internally (`add`, `remove`,
+ * `deltaMS`) plus a manual `tick(deltaMs)` method so tests can advance time
+ * deterministically without depending on requestAnimationFrame.
+ *
+ * ```ts
+ * const ticker = new FakeTicker();
+ * const reelSet = new ReelSetBuilder()
+ *   .ticker(ticker as unknown as PIXI.Ticker)
+ *   ...
+ *   .build();
+ *
+ * ticker.tick(16);  // advance one frame
+ * ticker.tickFor(500);  // advance 500ms in 16ms frames
+ * ```
+ */
+export declare class FakeTicker {
+    deltaMS: number;
+    deltaTime: number;
+    elapsedMS: number;
+    lastTime: number;
+    speed: number;
+    started: boolean;
+    FPS: number;
+    minFPS: number;
+    maxFPS: number;
+    private _callbacks;
+    add(fn: TickerCallback): this;
+    addOnce(fn: TickerCallback): this;
+    remove(fn: TickerCallback): this;
+    start(): this;
+    stop(): this;
+    destroy(): void;
+    /** Manually advance time by `deltaMs` milliseconds and fire all listeners. */
+    tick(deltaMs?: number): void;
+    /** Advance time by `totalMs`, chopped into `stepMs` frames. */
+    tickFor(totalMs: number, stepMs?: number): void;
+    get listenerCount(): number;
+}
+export {};
+//# sourceMappingURL=FakeTicker.d.ts.map

package/dist/testing/FakeTicker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeTicker.d.ts","sourceRoot":"","sources":["../../src/testing/FakeTicker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAE/C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAU;IACd,OAAO,SAAM;IACb,SAAS,SAAK;IACd,SAAS,SAAK;IACd,QAAQ,SAAK;IACb,KAAK,SAAK;IACV,OAAO,UAAS;IAChB,GAAG,SAAM;IACT,MAAM,SAAM;IACZ,MAAM,SAAK;IAElB,OAAO,CAAC,UAAU,CAAwB;IAE1C,GAAG,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAK7B,OAAO,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAQjC,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAMhC,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAKZ,OAAO,IAAI,IAAI;IAKf,8EAA8E;IAC9E,IAAI,CAAC,OAAO,SAAK,GAAG,IAAI;IAWxB,+DAA+D;IAC/D,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,IAAI;IAS3C,IAAI,aAAa,IAAI,MAAM,CAE1B;CACF"}

package/dist/testing/HeadlessSymbol.d.ts

@@ -0,0 +1,28 @@
+import { ReelSymbol } from '../symbols/ReelSymbol.js';
+/**
+ * A `ReelSymbol` implementation that does no rendering at all.
+ *
+ * It creates a `Container` for its `view` (so the Reel's child-tree logic works)
+ * but never paints anything. This lets tests build a real `ReelSet` without a
+ * renderer, textures, or assets.
+ *
+ * ```ts
+ * builder.symbols((r) => {
+ *   for (const id of ['cherry', 'lemon', 'seven']) {
+ *     r.register(id, HeadlessSymbol, {});
+ *   }
+ * });
+ * ```
+ */
+export declare class HeadlessSymbol extends ReelSymbol {
+    private _width;
+    private _height;
+    protected onActivate(_symbolId: string): void;
+    protected onDeactivate(): void;
+    playWin(): Promise<void>;
+    stopAnimation(): void;
+    resize(width: number, height: number): void;
+    get width(): number;
+    get height(): number;
+}
+//# sourceMappingURL=HeadlessSymbol.d.ts.map

package/dist/testing/HeadlessSymbol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HeadlessSymbol.d.ts","sourceRoot":"","sources":["../../src/testing/HeadlessSymbol.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAAK;IAEpB,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI7C,SAAS,CAAC,YAAY,IAAI,IAAI;IAIxB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B,aAAa,IAAI,IAAI;IAIrB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAK3C,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;CACF"}

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+export { FakeTicker } from './FakeTicker.js';
+export { HeadlessSymbol } from './HeadlessSymbol.js';
+export { createTestReelSet, spinAndLand, captureEvents, expectGrid, countSymbol, } from './testHarness.js';
+export type { TestReelSetOptions, TestReelSetHandle } from './testHarness.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/testing/testHarness.d.ts

@@ -0,0 +1,70 @@
+import { ReelSet } from '../core/ReelSet.js';
+import { SpinResult } from '../events/ReelEvents.js';
+import { FakeTicker } from './FakeTicker.js';
+export interface TestReelSetOptions {
+    reels?: number;
+    visibleRows?: number;
+    symbolIds?: string[];
+    weights?: Record<string, number>;
+    symbolSize?: {
+        width: number;
+        height: number;
+    };
+}
+export interface TestReelSetHandle {
+    reelSet: ReelSet;
+    ticker: FakeTicker;
+    /** Advance the ticker by `ms` milliseconds. */
+    advance(ms: number, stepMs?: number): void;
+    /** Run one full spin that lands on `grid`. Uses `skip()` for deterministic synchronous completion. */
+    spinAndLand(grid: string[][]): Promise<SpinResult>;
+    /** Destroy the reel set. */
+    destroy(): void;
+}
+/**
+ * Build a headless `ReelSet` wired to a `FakeTicker`. Ideal for mechanic tests.
+ *
+ * The returned `ReelSet` uses `HeadlessSymbol` for every registered symbol,
+ * so no textures, renderer, or DOM are required.
+ *
+ * ```ts
+ * const { reelSet, spinAndLand } = createTestReelSet({
+ *   reels: 5, visibleRows: 3,
+ *   symbolIds: ['cherry', 'seven', 'wild'],
+ * });
+ *
+ * await spinAndLand([
+ *   ['cherry','cherry','cherry'],
+ *   ['seven','seven','seven'],
+ *   ['wild','wild','wild'],
+ *   ['cherry','cherry','cherry'],
+ *   ['seven','seven','seven'],
+ * ]);
+ * ```
+ */
+export declare function createTestReelSet(opts?: TestReelSetOptions): TestReelSetHandle;
+/**
+ * Deterministically run a spin to a target grid.
+ *
+ * Internally: `spin() → setResult(grid) → skip()`. The `skip()` path bypasses
+ * all async phases and directly places the symbols, so the returned promise
+ * resolves on a microtask.
+ */
+export declare function spinAndLand(reelSet: ReelSet, grid: string[][]): Promise<SpinResult>;
+/** Record every occurrence of the given events in order for assertion. */
+export declare function captureEvents(reelSet: ReelSet, names: Array<keyof import('../events/ReelEvents.js').ReelSetEvents>): Array<{
+    event: string;
+    args: unknown[];
+}>;
+/**
+ * Assert that the current visible grid equals `expected`.
+ *
+ * Throws a readable error showing the full current grid on mismatch.
+ */
+export declare function expectGrid(reelSet: ReelSet, expected: string[][]): void;
+/**
+ * Count how many times a given symbol appears in the visible grid.
+ * Handy for scatter/wild-count assertions.
+ */
+export declare function countSymbol(reelSet: ReelSet, symbolId: string): number;
+//# sourceMappingURL=testHarness.d.ts.map

package/dist/testing/testHarness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHarness.d.ts","sourceRoot":"","sources":["../../src/testing/testHarness.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,UAAU,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,sGAAsG;IACtG,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACnD,4BAA4B;IAC5B,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,kBAAuB,GAAG,iBAAiB,CAwClF;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAKzF;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAC3B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,yBAAyB,EAAE,aAAa,CAAC,GAClE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,EAAE,CAAA;CAAE,CAAC,CAQ3C;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAyBvE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE"}

package/dist/utils/Disposable.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Contract for objects that allocate resources and need cleanup.
+ * Every class that subscribes to tickers, creates display objects, or holds references
+ * must implement this to prevent memory leaks.
+ */
+export interface Disposable {
+    destroy(): void;
+    readonly isDestroyed: boolean;
+}
+//# sourceMappingURL=Disposable.d.ts.map

package/dist/utils/Disposable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Disposable.d.ts","sourceRoot":"","sources":["../../src/utils/Disposable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,IAAI,IAAI,CAAC;IAChB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}

package/dist/utils/TickerRef.d.ts

@@ -0,0 +1,30 @@
+import { Ticker } from 'pixi.js';
+import { Disposable } from './Disposable.js';
+type TickerCallback = (ticker: Ticker) => void;
+/**
+ * Safe wrapper around PixiJS Ticker subscriptions.
+ *
+ * Solves the #1 memory leak in the original library: dangling ticker callbacks.
+ * When `destroy()` is called, ALL registered callbacks are automatically
+ * removed from the ticker.
+ *
+ * Usage:
+ * ```ts
+ * const ref = new TickerRef(app.ticker);
+ * ref.add((ticker) => reel.update(ticker));
+ * // Later:
+ * ref.destroy(); // all callbacks removed
+ * ```
+ */
+export declare class TickerRef implements Disposable {
+    private _ticker;
+    private _callbacks;
+    private _isDestroyed;
+    constructor(_ticker: Ticker);
+    get isDestroyed(): boolean;
+    add(fn: TickerCallback): void;
+    remove(fn: TickerCallback): void;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=TickerRef.d.ts.map

package/dist/utils/TickerRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TickerRef.d.ts","sourceRoot":"","sources":["../../src/utils/TickerRef.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,KAAK,cAAc,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,qBAAa,SAAU,YAAW,UAAU;IAI9B,OAAO,CAAC,OAAO;IAH3B,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,YAAY,CAAS;gBAET,OAAO,EAAE,MAAM;IAEnC,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,GAAG,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAM7B,MAAM,CAAC,EAAE,EAAE,cAAc,GAAG,IAAI;IAQhC,OAAO,IAAI,IAAI;CAQhB"}

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "pixi-reels",
+  "version": "0.1.0",
+  "description": "A batteries-included slot machine reel engine for PixiJS v8 — fluent builder, typed events, spin phases, speed modes, win spotlight, and a headless testing harness.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    },
+    "./spine": {
+      "import": "./dist/spine.js",
+      "require": "./dist/spine.cjs",
+      "types": "./dist/spine.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "peerDependencies": {
+    "@esotericsoftware/spine-pixi-v8": "^4.2.110",
+    "gsap": "^3.15.0",
+    "pixi.js": "^8.18.1"
+  },
+  "peerDependenciesMeta": {
+    "@esotericsoftware/spine-pixi-v8": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@esotericsoftware/spine-pixi-v8": "^4.2.110",
+    "gsap": "^3.15.0",
+    "pixi.js": "^8.18.1",
+    "typescript": "^6.0.3",
+    "vite": "^8.0.9",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.1.4"
+  },
+  "license": "MIT",
+  "author": "schmooky",
+  "homepage": "https://pixi-reels.dev",
+  "bugs": {
+    "url": "https://github.com/schmooky/pixi-reels/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/schmooky/pixi-reels.git",
+    "directory": "packages/pixi-reels"
+  },
+  "keywords": [
+    "pixi",
+    "pixijs",
+    "pixi.js",
+    "slot",
+    "reel",
+    "reels",
+    "casino",
+    "slot-machine",
+    "game",
+    "gamedev",
+    "html5-game",
+    "spine",
+    "animation",
+    "gsap",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src/"
+  }
+}