pixi-reels 0.1.0

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2026 schmooky and contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This repository bundles third-party runtimes and libraries (PixiJS, GSAP, the
+Spine Runtime, and others) governed by their own license terms. See each
+package's node_modules or upstream project for those terms. In particular, the
+Spine Runtime (@esotericsoftware/spine-*) is licensed under the Spine Runtimes
+License Agreement and requires users to hold a valid Spine Editor license when
+integrating it into their own products.

package/README.md

@@ -0,0 +1,167 @@
+# pixi-reels
+
+[![npm version](https://img.shields.io/npm/v/pixi-reels?color=cb3837&logo=npm)](https://www.npmjs.com/package/pixi-reels)
+[![npm downloads](https://img.shields.io/npm/dm/pixi-reels?color=cb3837&logo=npm)](https://www.npmjs.com/package/pixi-reels)
+[![Bundle size](https://img.shields.io/bundlephobia/minzip/pixi-reels?label=gzip)](https://bundlephobia.com/package/pixi-reels)
+[![CI](https://github.com/schmooky/pixi-reels/actions/workflows/ci.yml/badge.svg)](https://github.com/schmooky/pixi-reels/actions/workflows/ci.yml)
+[![Release](https://github.com/schmooky/pixi-reels/actions/workflows/release.yml/badge.svg)](https://github.com/schmooky/pixi-reels/actions/workflows/release.yml)
+[![CodeQL](https://github.com/schmooky/pixi-reels/actions/workflows/codeql.yml/badge.svg)](https://github.com/schmooky/pixi-reels/actions/workflows/codeql.yml)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
+[![PixiJS v8](https://img.shields.io/badge/PixiJS-v8-e91e63)](https://pixijs.com/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+A slot machine reel engine for [PixiJS v8](https://pixijs.com/). Fluent builder, typed events, and the weighty spin+stop feel modeled on real-money games — in about 35 kB gzipped.
+
+```bash
+pnpm add pixi-reels pixi.js gsap
+```
+
+```ts
+import { Application } from 'pixi.js';
+import { ReelSetBuilder, SpriteSymbol, SpeedPresets } from 'pixi-reels';
+
+const app = new Application();
+await app.init({ width: 900, height: 540, background: '#0a0d14' });
+document.body.appendChild(app.canvas);
+
+const reelSet = new ReelSetBuilder()
+  .reels(5).visibleSymbols(3).symbolSize(140, 140)
+  .symbols((r) => {
+    r.register('cherry', SpriteSymbol, { textures: { cherry: cherryTex } });
+    r.register('seven',  SpriteSymbol, { textures: { seven:  sevenTex } });
+    r.register('bar',    SpriteSymbol, { textures: { bar:    barTex   } });
+  })
+  .weights({ cherry: 40, seven: 10, bar: 20 })
+  .speed('normal', SpeedPresets.NORMAL)
+  .speed('turbo',  SpeedPresets.TURBO)
+  .ticker(app.ticker)
+  .build();
+
+app.stage.addChild(reelSet);
+
+// Kick off the spin, tell it where to land, await the bounce.
+const spin = reelSet.spin();
+reelSet.setResult(await fetchSpinFromServer());
+const { symbols } = await spin;
+```
+
+## What it does
+
+- **Spin lifecycle** — `START -> SPIN -> ANTICIPATION -> STOP` phases, each pluggable.
+- **Weighty stops** — the reel carries momentum through the target frame, snaps, then bounces. No floaty ease-in deceleration.
+- **Speed modes** — Normal / Turbo / SuperTurbo built in, or register your own profile.
+- **Skip / slam-stop** — second tap of the spin button immediately lands the reels on target.
+- **Win spotlight** — dim non-winners, promote winning symbols above the mask, cycle lines.
+- **Symbol plugins** — SpriteSymbol, AnimatedSpriteSymbol, SpineSymbol, or implement `ReelSymbol`.
+- **Frame middleware** — intercept the symbol generator (e.g. "no triples", multiplier injection).
+- **Object pooling** — zero-allocation spinning via `ObjectPool<T>`.
+- **Typed events** — `spin:start`, `spin:reelLanded`, `speed:changed`, `spotlight:end`, ...
+- **Headless testing** — `createTestReelSet` + `FakeTicker` run the full lifecycle in Node.
+- **Debug mode** — `enableDebug(reelSet)` exposes JSON and ASCII snapshots on `window`.
+
+## Docs
+
+The docs site lives in [`apps/site`](apps/site/). Run it locally:
+
+```bash
+pnpm site:dev       # http://localhost:4321
+```
+
+You'll find:
+
+- **Guides** — getting started, spin lifecycle, symbols, speed modes, win animations, debugging.
+- **Recipes** — small how-tos for common mechanics (walking wilds, sticky wilds, cascade, mystery reveal, hold & win, ...). Each ships with a live mini-demo.
+- **Demos** — full mechanic sandboxes with cheat panels. One click forces a scatter, a near-miss, a guaranteed jackpot.
+- **Sandbox** — in-browser TypeScript playground; edit the file, hit Run, reels rebuild.
+- **Wiki** — API reference.
+
+## Examples
+
+Runnable apps in [`examples/`](examples/):
+
+| Example          | What it shows                                              | Run                                    |
+|------------------|------------------------------------------------------------|----------------------------------------|
+| `classic-spin`   | 5x3 line-pay slot with Spine symbols and speed toggle      | `pnpm --filter classic-spin dev`       |
+| `cascade-tumble` | 6x5 tumble mechanic with win spotlight between stages      | `pnpm --filter cascade-tumble dev`     |
+| `hold-and-win`   | 5x3 base game + respin bonus with locking coins            | `pnpm --filter hold-and-win dev`       |
+| `sandbox`        | Single editable TS file, HMR rebuild                       | `pnpm --filter sandbox dev`            |
+
+## Core API at a glance
+
+```ts
+reelSet.spin(): Promise<SpinResult>             // Start spinning
+reelSet.setResult(symbols: string[][])          // Pass the target grid (triggers the stop)
+reelSet.setAnticipation([3, 4])                 // Slow reels 3+4 before their landing
+reelSet.setStopDelays([0, 140, 280, 600, 1100]) // Override per-reel stop stagger
+reelSet.skip()                                  // Slam-stop
+reelSet.setSpeed('turbo')                       // Switch speed profile
+reelSet.spotlight.show(positions, opts)         // One-shot win highlight
+reelSet.spotlight.cycle(lines, opts)            // Cycle through win lines
+reelSet.events.on('spin:reelLanded', (i, s) => {/* ... */})
+reelSet.destroy()                               // Full teardown
+```
+
+Full reference: `/wiki/` on the docs site.
+
+## Spine symbols (optional)
+
+pixi-reels ships a Spine adapter on a separate subpath so the runtime tree-shakes out when you don't need it:
+
+```ts
+import { SpineReelSymbol } from 'pixi-reels/spine';
+
+r.register('wild', SpineReelSymbol, {
+  spineMap: { wild: { skeleton: 'wildData', atlas: 'myAtlas' } },
+  autoPlayBlur: true,     // plays `blur` during spin
+  autoPlayLanding: true,  // plays `landing` on reel stop
+});
+```
+
+Install the peer: `pnpm add @esotericsoftware/spine-pixi-v8`.
+
+## Debug mode
+
+Handy for development and essential when an AI agent needs to inspect reel state without parsing a canvas:
+
+```ts
+import { enableDebug } from 'pixi-reels';
+enableDebug(reelSet);
+```
+
+In the browser console (or via Playwright / an agent's `eval`):
+
+```
+__PIXI_REELS_DEBUG.log()       // ASCII grid + state snapshot
+__PIXI_REELS_DEBUG.snapshot()  // Full JSON state
+__PIXI_REELS_DEBUG.trace()     // Log every domain event as it fires
+```
+
+## Architecture
+
+```
+ReelSetBuilder --builds--> ReelSet
+                             |- SpinController ..... orchestrates the phases per reel
+                             |- SpeedManager ....... named profiles + live switching
+                             |- SymbolSpotlight .... win animations
+                             |- ReelViewport ....... masked + unmasked containers
+                             '- Reel[] ............. one per column
+                                  |- ReelSymbol[] .. SpriteSymbol / AnimatedSpriteSymbol / SpineSymbol
+                                  |- ReelMotion .... y displacement + wrap
+                                  '- StopSequencer . target-frame consumption
+```
+
+Single ticker, no circular deps, no default exports, tree-shakes cleanly.
+
+## Peer dependencies
+
+- `pixi.js` ^8.17.0
+- `gsap` ^3.14.0
+- `@esotericsoftware/spine-pixi-v8` ^4.2.108 _(optional — only if you use `SpineReelSymbol`)_
+
+## Contributing
+
+PRs welcome. [CONTRIBUTING.md](./CONTRIBUTING.md) covers the workflow, changesets, and the handful of style rules the lint guards enforce.
+
+## License
+
+MIT.

package/dist/SpineSymbol-B40TevSr.cjs

@@ -0,0 +1,2 @@
+let e=require(`pixi.js`);var t=class{view;_symbolId=``;_isDestroyed=!1;constructor(){this.view=new e.Container}get symbolId(){return this._symbolId}get isDestroyed(){return this._isDestroyed}activate(e){this._symbolId=e,this.view.visible=!0,this.onActivate(e)}deactivate(){this.stopAnimation(),this.onDeactivate(),this._symbolId=``,this.view.visible=!1}reset(){this.deactivate()}destroy(){this._isDestroyed||=(this.deactivate(),this.onDestroy(),this.view.destroy({children:!0}),!0)}onDestroy(){}onReelSpinStart(){}onReelSpinEnd(){}onReelLanded(){}},n=null;async function r(){try{n=(await import(`@esotericsoftware/spine-pixi-v8`)).Spine}catch{}}r();var i=class extends t{_spine=null;_skeletonDataMap;_idleAnimation;_winAnimation;_defaultSkin;_winResolve=null;_currentSkeletonKey=``;constructor(e){if(super(),!n)throw Error(`SpineSymbol requires @esotericsoftware/spine-pixi-v8 to be installed. Install it with: npm install @esotericsoftware/spine-pixi-v8`);this._skeletonDataMap=e.skeletonDataMap,this._idleAnimation=e.idleAnimation??`idle`,this._winAnimation=e.winAnimation??`win`,this._defaultSkin=e.defaultSkin??`default`}onActivate(e){let t=this._skeletonDataMap[e];t&&(this._currentSkeletonKey!==e&&(this._spine&&(this.view.removeChild(this._spine),this._spine.destroy()),this._spine=new n({skeletonData:t}),this.view.addChild(this._spine),this._currentSkeletonKey=e),this._spine.skeleton.data.findSkin(this._defaultSkin)&&(this._spine.skeleton.setSkinByName(this._defaultSkin),this._spine.skeleton.setSlotsToSetupPose()),this._spine.skeleton.data.findAnimation(this._idleAnimation)&&this._spine.state.setAnimation(0,this._idleAnimation,!0))}onDeactivate(){this._spine&&(this._spine.state.clearListeners(),this._spine.state.clearTracks()),this._winResolve=null}async playWin(){if(this._spine&&this._spine.skeleton.data.findAnimation(this._winAnimation))return new Promise(e=>{this._winResolve=e;let t=this._spine.state.setAnimation(0,this._winAnimation,!1);this._spine.state.addListener({complete:n=>{n===t&&(this._spine.state.clearListeners(),this._spine.skeleton.data.findAnimation(this._idleAnimation)&&this._spine.state.setAnimation(0,this._idleAnimation,!0),this._winResolve=null,e())}})})}stopAnimation(){this._spine&&(this._spine.state.clearListeners(),this._spine.skeleton.data.findAnimation(this._idleAnimation)&&this._spine.state.setAnimation(0,this._idleAnimation,!0),this._winResolve&&=(this._winResolve(),null))}resize(e,t){if(!this._spine)return;let n=this._spine.getBounds();n.width>0&&n.height>0&&this._spine.scale.set(e/n.width,t/n.height)}onDestroy(){this._spine&&=(this._spine.state.clearListeners(),this._spine.destroy(),null)}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});
+//# sourceMappingURL=SpineSymbol-B40TevSr.cjs.map

package/dist/SpineSymbol-B40TevSr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpineSymbol-B40TevSr.cjs","names":[],"sources":["../src/symbols/ReelSymbol.ts","../src/symbols/SpineSymbol.ts"],"sourcesContent":["import { Container } from 'pixi.js';\nimport type { Disposable } from '../utils/Disposable.js';\n\n/**\n * One visible cell on a reel — the thing that actually draws.\n *\n * `ReelSymbol` is the abstract base class. Subclass it to pick a rendering\n * technology (`SpriteSymbol`, `AnimatedSpriteSymbol`, `SpineSymbol`, or a\n * custom class of your own). The reel set pools instances aggressively:\n * one instance is reused many times as it scrolls off one identity and on\n * to another, so implementations must never assume \"I was just created\".\n *\n * Required lifecycle hooks:\n *\n *   - `onActivate(symbolId)` — the pool just handed me a new identity. Swap\n *     texture, restart animations, bring myself out of any \"ended\" pose.\n *   - `onDeactivate()` — I am about to be pooled. Pause animations, clear\n *     listeners, leave myself in a clean state for the next activation.\n *   - `playWin()` — the spotlight is celebrating me. Return a promise that\n *     resolves when the one-shot animation is done.\n *   - `stopAnimation()` — spotlight is over, return to idle.\n *   - `resize(w, h)` — the reel's cell size changed (on every symbol swap).\n *     Store the dimensions and reposition internal children. Forgetting\n *     this is the single most common \"why do my symbols scatter\" bug.\n *\n * ```\n * create → activate(symbolId) → [playWin / stopAnimation]\n *                             → deactivate\n *                             → activate(newId) → ...\n * ```\n *\n * There's no hidden GC. Hold resources? Override `onDestroy()`.\n */\nexport abstract class ReelSymbol implements Disposable {\n  /** The PixiJS container that holds this symbol's visual. */\n  public readonly view: Container;\n\n  private _symbolId: string = '';\n  private _isDestroyed = false;\n\n  constructor() {\n    this.view = new Container();\n  }\n\n  get symbolId(): string {\n    return this._symbolId;\n  }\n\n  get isDestroyed(): boolean {\n    return this._isDestroyed;\n  }\n\n  /**\n   * Activate the symbol with a new identity.\n   * Called when the symbol enters the visible reel or is recycled from the pool.\n   */\n  activate(symbolId: string): void {\n    this._symbolId = symbolId;\n    this.view.visible = true;\n    this.onActivate(symbolId);\n  }\n\n  /**\n   * Deactivate the symbol before returning it to the pool.\n   * Stops any running animations and hides the view.\n   */\n  deactivate(): void {\n    this.stopAnimation();\n    this.onDeactivate();\n    this._symbolId = '';\n    this.view.visible = false;\n  }\n\n  /** Pool reset — aliases deactivate. */\n  reset(): void {\n    this.deactivate();\n  }\n\n  destroy(): void {\n    if (this._isDestroyed) return;\n    this.deactivate();\n    this.onDestroy();\n    this.view.destroy({ children: true });\n    this._isDestroyed = true;\n  }\n\n  /** Subclass hook: set up visuals for the given symbolId. */\n  protected abstract onActivate(symbolId: string): void;\n\n  /** Subclass hook: clean up visuals. */\n  protected abstract onDeactivate(): void;\n\n  /** Subclass hook: additional cleanup on destroy. */\n  protected onDestroy(): void {\n    // Override if needed\n  }\n\n  /** Play the win/highlight animation for this symbol. Resolves when complete. */\n  abstract playWin(): Promise<void>;\n\n  /** Immediately stop any running animation and return to idle. */\n  abstract stopAnimation(): void;\n\n  /** Resize the symbol's visual to fit the given dimensions. */\n  abstract resize(width: number, height: number): void;\n\n  /**\n   * Lifecycle hook: the owning reel has started spinning.\n   * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayBlur) to swap to\n   * a blur animation automatically.\n   */\n  onReelSpinStart(): void {}\n\n  /**\n   * Lifecycle hook: the owning reel is about to stop (just before bounce).\n   * Default: no-op.\n   */\n  onReelSpinEnd(): void {}\n\n  /**\n   * Lifecycle hook: the owning reel has landed on its final symbols.\n   * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayLanding) to fire\n   * a landing animation concurrently with the bounce.\n   */\n  onReelLanded(): void {}\n}\n","import { ReelSymbol } from './ReelSymbol.js';\n\n// Spine types imported dynamically — this is an optional peer dependency\nlet SpineClass: any = null;\n\nasync function loadSpine(): Promise<void> {\n  try {\n    const spineModule = await import('@esotericsoftware/spine-pixi-v8');\n    SpineClass = spineModule.Spine;\n  } catch {\n    // Spine not available — SpineSymbol will throw on construction\n  }\n}\n\n// Attempt to load Spine on module init\nloadSpine();\n\nexport interface SpineSymbolOptions {\n  /** Map of symbolId → SkeletonData. */\n  skeletonDataMap: Record<string, any>;\n  /** Default animation name to play in idle. Default: 'idle'. */\n  idleAnimation?: string;\n  /** Animation name to play on win. Default: 'win'. */\n  winAnimation?: string;\n  /** Default skin name. Default: 'default'. */\n  defaultSkin?: string;\n}\n\n/**\n * Symbol implementation using Spine 2D skeletal animation.\n *\n * Requires `@esotericsoftware/spine-pixi-v8` as an optional peer dependency.\n * If Spine is not installed, constructing a SpineSymbol will throw.\n */\nexport class SpineSymbol extends ReelSymbol {\n  private _spine: any = null;\n  private _skeletonDataMap: Record<string, any>;\n  private _idleAnimation: string;\n  private _winAnimation: string;\n  private _defaultSkin: string;\n  private _winResolve: (() => void) | null = null;\n  private _currentSkeletonKey: string = '';\n\n  constructor(options: SpineSymbolOptions) {\n    super();\n    if (!SpineClass) {\n      throw new Error(\n        'SpineSymbol requires @esotericsoftware/spine-pixi-v8 to be installed. ' +\n        'Install it with: npm install @esotericsoftware/spine-pixi-v8',\n      );\n    }\n    this._skeletonDataMap = options.skeletonDataMap;\n    this._idleAnimation = options.idleAnimation ?? 'idle';\n    this._winAnimation = options.winAnimation ?? 'win';\n    this._defaultSkin = options.defaultSkin ?? 'default';\n  }\n\n  protected onActivate(symbolId: string): void {\n    const skeletonData = this._skeletonDataMap[symbolId];\n    if (!skeletonData) return;\n\n    // Reuse existing spine if same skeleton data\n    if (this._currentSkeletonKey !== symbolId) {\n      if (this._spine) {\n        this.view.removeChild(this._spine);\n        this._spine.destroy();\n      }\n      this._spine = new SpineClass({ skeletonData });\n      this.view.addChild(this._spine);\n      this._currentSkeletonKey = symbolId;\n    }\n\n    // Set to idle\n    if (this._spine.skeleton.data.findSkin(this._defaultSkin)) {\n      this._spine.skeleton.setSkinByName(this._defaultSkin);\n      this._spine.skeleton.setSlotsToSetupPose();\n    }\n    if (this._spine.skeleton.data.findAnimation(this._idleAnimation)) {\n      this._spine.state.setAnimation(0, this._idleAnimation, true);\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.state.clearTracks();\n    }\n    this._winResolve = null;\n  }\n\n  async playWin(): Promise<void> {\n    if (!this._spine) return;\n    if (!this._spine.skeleton.data.findAnimation(this._winAnimation)) return;\n\n    return new Promise<void>((resolve) => {\n      this._winResolve = resolve;\n      const entry = this._spine.state.setAnimation(0, this._winAnimation, false);\n      this._spine.state.addListener({\n        complete: (trackEntry: any) => {\n          if (trackEntry === entry) {\n            this._spine.state.clearListeners();\n            // Return to idle\n            if (this._spine.skeleton.data.findAnimation(this._idleAnimation)) {\n              this._spine.state.setAnimation(0, this._idleAnimation, true);\n            }\n            this._winResolve = null;\n            resolve();\n          }\n        },\n      });\n    });\n  }\n\n  stopAnimation(): void {\n    if (!this._spine) return;\n    this._spine.state.clearListeners();\n    if (this._spine.skeleton.data.findAnimation(this._idleAnimation)) {\n      this._spine.state.setAnimation(0, this._idleAnimation, true);\n    }\n    if (this._winResolve) {\n      this._winResolve();\n      this._winResolve = null;\n    }\n  }\n\n  resize(width: number, height: number): void {\n    if (!this._spine) return;\n    const bounds = this._spine.getBounds();\n    if (bounds.width > 0 && bounds.height > 0) {\n      this._spine.scale.set(\n        width / bounds.width,\n        height / bounds.height,\n      );\n    }\n  }\n\n  protected override onDestroy(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.destroy();\n      this._spine = null;\n    }\n  }\n}\n"],"mappings":"yBAiCA,IAAsB,EAAtB,KAAuD,CAErD,KAEA,UAA4B,GAC5B,aAAuB,GAEvB,aAAc,CACZ,KAAK,KAAO,IAAI,EAAA,UAGlB,IAAI,UAAmB,CACrB,OAAO,KAAK,UAGd,IAAI,aAAuB,CACzB,OAAO,KAAK,aAOd,SAAS,EAAwB,CAC/B,KAAK,UAAY,EACjB,KAAK,KAAK,QAAU,GACpB,KAAK,WAAW,EAAS,CAO3B,YAAmB,CACjB,KAAK,eAAe,CACpB,KAAK,cAAc,CACnB,KAAK,UAAY,GACjB,KAAK,KAAK,QAAU,GAItB,OAAc,CACZ,KAAK,YAAY,CAGnB,SAAgB,CACV,AAIJ,KAAK,gBAHL,KAAK,YAAY,CACjB,KAAK,WAAW,CAChB,KAAK,KAAK,QAAQ,CAAE,SAAU,GAAM,CAAC,CACjB,IAUtB,WAA4B,EAkB5B,iBAAwB,EAMxB,eAAsB,EAOtB,cAAqB,ICzHnB,EAAkB,KAEtB,eAAe,GAA2B,CACxC,GAAI,CAEF,GADoB,MAAM,OAAO,oCACR,WACnB,GAMV,GAAW,CAmBX,IAAa,EAAb,cAAiC,CAAW,CAC1C,OAAsB,KACtB,iBACA,eACA,cACA,aACA,YAA2C,KAC3C,oBAAsC,GAEtC,YAAY,EAA6B,CAEvC,GADA,OAAO,CACH,CAAC,EACH,MAAU,MACR,qIAED,CAEH,KAAK,iBAAmB,EAAQ,gBAChC,KAAK,eAAiB,EAAQ,eAAiB,OAC/C,KAAK,cAAgB,EAAQ,cAAgB,MAC7C,KAAK,aAAe,EAAQ,aAAe,UAG7C,WAAqB,EAAwB,CAC3C,IAAM,EAAe,KAAK,iBAAiB,GACtC,IAGD,KAAK,sBAAwB,IAC3B,KAAK,SACP,KAAK,KAAK,YAAY,KAAK,OAAO,CAClC,KAAK,OAAO,SAAS,EAEvB,KAAK,OAAS,IAAI,EAAW,CAAE,eAAc,CAAC,CAC9C,KAAK,KAAK,SAAS,KAAK,OAAO,CAC/B,KAAK,oBAAsB,GAIzB,KAAK,OAAO,SAAS,KAAK,SAAS,KAAK,aAAa,GACvD,KAAK,OAAO,SAAS,cAAc,KAAK,aAAa,CACrD,KAAK,OAAO,SAAS,qBAAqB,EAExC,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,EAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,EAIhE,cAA+B,CACzB,KAAK,SACP,KAAK,OAAO,MAAM,gBAAgB,CAClC,KAAK,OAAO,MAAM,aAAa,EAEjC,KAAK,YAAc,KAGrB,MAAM,SAAyB,CACxB,QAAK,QACL,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,cAAc,CAEhE,OAAO,IAAI,QAAe,GAAY,CACpC,KAAK,YAAc,EACnB,IAAM,EAAQ,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,cAAe,GAAM,CAC1E,KAAK,OAAO,MAAM,YAAY,CAC5B,SAAW,GAAoB,CACzB,IAAe,IACjB,KAAK,OAAO,MAAM,gBAAgB,CAE9B,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,EAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,CAE9D,KAAK,YAAc,KACnB,GAAS,GAGd,CAAC,EACF,CAGJ,eAAsB,CACf,KAAK,SACV,KAAK,OAAO,MAAM,gBAAgB,CAC9B,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,EAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,CAE9D,AAEE,KAAK,eADL,KAAK,aAAa,CACC,OAIvB,OAAO,EAAe,EAAsB,CAC1C,GAAI,CAAC,KAAK,OAAQ,OAClB,IAAM,EAAS,KAAK,OAAO,WAAW,CAClC,EAAO,MAAQ,GAAK,EAAO,OAAS,GACtC,KAAK,OAAO,MAAM,IAChB,EAAQ,EAAO,MACf,EAAS,EAAO,OACjB,CAIL,WAAqC,CACnC,AAGE,KAAK,UAFL,KAAK,OAAO,MAAM,gBAAgB,CAClC,KAAK,OAAO,SAAS,CACP"}

package/dist/SpineSymbol-D2jhCzFW.js

@@ -0,0 +1,82 @@
+import { Container as e } from "pixi.js";
+//#region src/symbols/ReelSymbol.ts
+var t = class {
+	view;
+	_symbolId = "";
+	_isDestroyed = !1;
+	constructor() {
+		this.view = new e();
+	}
+	get symbolId() {
+		return this._symbolId;
+	}
+	get isDestroyed() {
+		return this._isDestroyed;
+	}
+	activate(e) {
+		this._symbolId = e, this.view.visible = !0, this.onActivate(e);
+	}
+	deactivate() {
+		this.stopAnimation(), this.onDeactivate(), this._symbolId = "", this.view.visible = !1;
+	}
+	reset() {
+		this.deactivate();
+	}
+	destroy() {
+		this._isDestroyed ||= (this.deactivate(), this.onDestroy(), this.view.destroy({ children: !0 }), !0);
+	}
+	onDestroy() {}
+	onReelSpinStart() {}
+	onReelSpinEnd() {}
+	onReelLanded() {}
+}, n = null;
+async function r() {
+	try {
+		n = (await import("@esotericsoftware/spine-pixi-v8")).Spine;
+	} catch {}
+}
+r();
+var i = class extends t {
+	_spine = null;
+	_skeletonDataMap;
+	_idleAnimation;
+	_winAnimation;
+	_defaultSkin;
+	_winResolve = null;
+	_currentSkeletonKey = "";
+	constructor(e) {
+		if (super(), !n) throw Error("SpineSymbol requires @esotericsoftware/spine-pixi-v8 to be installed. Install it with: npm install @esotericsoftware/spine-pixi-v8");
+		this._skeletonDataMap = e.skeletonDataMap, this._idleAnimation = e.idleAnimation ?? "idle", this._winAnimation = e.winAnimation ?? "win", this._defaultSkin = e.defaultSkin ?? "default";
+	}
+	onActivate(e) {
+		let t = this._skeletonDataMap[e];
+		t && (this._currentSkeletonKey !== e && (this._spine && (this.view.removeChild(this._spine), this._spine.destroy()), this._spine = new n({ skeletonData: t }), this.view.addChild(this._spine), this._currentSkeletonKey = e), this._spine.skeleton.data.findSkin(this._defaultSkin) && (this._spine.skeleton.setSkinByName(this._defaultSkin), this._spine.skeleton.setSlotsToSetupPose()), this._spine.skeleton.data.findAnimation(this._idleAnimation) && this._spine.state.setAnimation(0, this._idleAnimation, !0));
+	}
+	onDeactivate() {
+		this._spine && (this._spine.state.clearListeners(), this._spine.state.clearTracks()), this._winResolve = null;
+	}
+	async playWin() {
+		if (this._spine && this._spine.skeleton.data.findAnimation(this._winAnimation)) return new Promise((e) => {
+			this._winResolve = e;
+			let t = this._spine.state.setAnimation(0, this._winAnimation, !1);
+			this._spine.state.addListener({ complete: (n) => {
+				n === t && (this._spine.state.clearListeners(), this._spine.skeleton.data.findAnimation(this._idleAnimation) && this._spine.state.setAnimation(0, this._idleAnimation, !0), this._winResolve = null, e());
+			} });
+		});
+	}
+	stopAnimation() {
+		this._spine && (this._spine.state.clearListeners(), this._spine.skeleton.data.findAnimation(this._idleAnimation) && this._spine.state.setAnimation(0, this._idleAnimation, !0), this._winResolve &&= (this._winResolve(), null));
+	}
+	resize(e, t) {
+		if (!this._spine) return;
+		let n = this._spine.getBounds();
+		n.width > 0 && n.height > 0 && this._spine.scale.set(e / n.width, t / n.height);
+	}
+	onDestroy() {
+		this._spine &&= (this._spine.state.clearListeners(), this._spine.destroy(), null);
+	}
+};
+//#endregion
+export { t as n, i as t };
+
+//# sourceMappingURL=SpineSymbol-D2jhCzFW.js.map

package/dist/SpineSymbol-D2jhCzFW.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpineSymbol-D2jhCzFW.js","names":[],"sources":["../src/symbols/ReelSymbol.ts","../src/symbols/SpineSymbol.ts"],"sourcesContent":["import { Container } from 'pixi.js';\nimport type { Disposable } from '../utils/Disposable.js';\n\n/**\n * One visible cell on a reel — the thing that actually draws.\n *\n * `ReelSymbol` is the abstract base class. Subclass it to pick a rendering\n * technology (`SpriteSymbol`, `AnimatedSpriteSymbol`, `SpineSymbol`, or a\n * custom class of your own). The reel set pools instances aggressively:\n * one instance is reused many times as it scrolls off one identity and on\n * to another, so implementations must never assume \"I was just created\".\n *\n * Required lifecycle hooks:\n *\n *   - `onActivate(symbolId)` — the pool just handed me a new identity. Swap\n *     texture, restart animations, bring myself out of any \"ended\" pose.\n *   - `onDeactivate()` — I am about to be pooled. Pause animations, clear\n *     listeners, leave myself in a clean state for the next activation.\n *   - `playWin()` — the spotlight is celebrating me. Return a promise that\n *     resolves when the one-shot animation is done.\n *   - `stopAnimation()` — spotlight is over, return to idle.\n *   - `resize(w, h)` — the reel's cell size changed (on every symbol swap).\n *     Store the dimensions and reposition internal children. Forgetting\n *     this is the single most common \"why do my symbols scatter\" bug.\n *\n * ```\n * create → activate(symbolId) → [playWin / stopAnimation]\n *                             → deactivate\n *                             → activate(newId) → ...\n * ```\n *\n * There's no hidden GC. Hold resources? Override `onDestroy()`.\n */\nexport abstract class ReelSymbol implements Disposable {\n  /** The PixiJS container that holds this symbol's visual. */\n  public readonly view: Container;\n\n  private _symbolId: string = '';\n  private _isDestroyed = false;\n\n  constructor() {\n    this.view = new Container();\n  }\n\n  get symbolId(): string {\n    return this._symbolId;\n  }\n\n  get isDestroyed(): boolean {\n    return this._isDestroyed;\n  }\n\n  /**\n   * Activate the symbol with a new identity.\n   * Called when the symbol enters the visible reel or is recycled from the pool.\n   */\n  activate(symbolId: string): void {\n    this._symbolId = symbolId;\n    this.view.visible = true;\n    this.onActivate(symbolId);\n  }\n\n  /**\n   * Deactivate the symbol before returning it to the pool.\n   * Stops any running animations and hides the view.\n   */\n  deactivate(): void {\n    this.stopAnimation();\n    this.onDeactivate();\n    this._symbolId = '';\n    this.view.visible = false;\n  }\n\n  /** Pool reset — aliases deactivate. */\n  reset(): void {\n    this.deactivate();\n  }\n\n  destroy(): void {\n    if (this._isDestroyed) return;\n    this.deactivate();\n    this.onDestroy();\n    this.view.destroy({ children: true });\n    this._isDestroyed = true;\n  }\n\n  /** Subclass hook: set up visuals for the given symbolId. */\n  protected abstract onActivate(symbolId: string): void;\n\n  /** Subclass hook: clean up visuals. */\n  protected abstract onDeactivate(): void;\n\n  /** Subclass hook: additional cleanup on destroy. */\n  protected onDestroy(): void {\n    // Override if needed\n  }\n\n  /** Play the win/highlight animation for this symbol. Resolves when complete. */\n  abstract playWin(): Promise<void>;\n\n  /** Immediately stop any running animation and return to idle. */\n  abstract stopAnimation(): void;\n\n  /** Resize the symbol's visual to fit the given dimensions. */\n  abstract resize(width: number, height: number): void;\n\n  /**\n   * Lifecycle hook: the owning reel has started spinning.\n   * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayBlur) to swap to\n   * a blur animation automatically.\n   */\n  onReelSpinStart(): void {}\n\n  /**\n   * Lifecycle hook: the owning reel is about to stop (just before bounce).\n   * Default: no-op.\n   */\n  onReelSpinEnd(): void {}\n\n  /**\n   * Lifecycle hook: the owning reel has landed on its final symbols.\n   * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayLanding) to fire\n   * a landing animation concurrently with the bounce.\n   */\n  onReelLanded(): void {}\n}\n","import { ReelSymbol } from './ReelSymbol.js';\n\n// Spine types imported dynamically — this is an optional peer dependency\nlet SpineClass: any = null;\n\nasync function loadSpine(): Promise<void> {\n  try {\n    const spineModule = await import('@esotericsoftware/spine-pixi-v8');\n    SpineClass = spineModule.Spine;\n  } catch {\n    // Spine not available — SpineSymbol will throw on construction\n  }\n}\n\n// Attempt to load Spine on module init\nloadSpine();\n\nexport interface SpineSymbolOptions {\n  /** Map of symbolId → SkeletonData. */\n  skeletonDataMap: Record<string, any>;\n  /** Default animation name to play in idle. Default: 'idle'. */\n  idleAnimation?: string;\n  /** Animation name to play on win. Default: 'win'. */\n  winAnimation?: string;\n  /** Default skin name. Default: 'default'. */\n  defaultSkin?: string;\n}\n\n/**\n * Symbol implementation using Spine 2D skeletal animation.\n *\n * Requires `@esotericsoftware/spine-pixi-v8` as an optional peer dependency.\n * If Spine is not installed, constructing a SpineSymbol will throw.\n */\nexport class SpineSymbol extends ReelSymbol {\n  private _spine: any = null;\n  private _skeletonDataMap: Record<string, any>;\n  private _idleAnimation: string;\n  private _winAnimation: string;\n  private _defaultSkin: string;\n  private _winResolve: (() => void) | null = null;\n  private _currentSkeletonKey: string = '';\n\n  constructor(options: SpineSymbolOptions) {\n    super();\n    if (!SpineClass) {\n      throw new Error(\n        'SpineSymbol requires @esotericsoftware/spine-pixi-v8 to be installed. ' +\n        'Install it with: npm install @esotericsoftware/spine-pixi-v8',\n      );\n    }\n    this._skeletonDataMap = options.skeletonDataMap;\n    this._idleAnimation = options.idleAnimation ?? 'idle';\n    this._winAnimation = options.winAnimation ?? 'win';\n    this._defaultSkin = options.defaultSkin ?? 'default';\n  }\n\n  protected onActivate(symbolId: string): void {\n    const skeletonData = this._skeletonDataMap[symbolId];\n    if (!skeletonData) return;\n\n    // Reuse existing spine if same skeleton data\n    if (this._currentSkeletonKey !== symbolId) {\n      if (this._spine) {\n        this.view.removeChild(this._spine);\n        this._spine.destroy();\n      }\n      this._spine = new SpineClass({ skeletonData });\n      this.view.addChild(this._spine);\n      this._currentSkeletonKey = symbolId;\n    }\n\n    // Set to idle\n    if (this._spine.skeleton.data.findSkin(this._defaultSkin)) {\n      this._spine.skeleton.setSkinByName(this._defaultSkin);\n      this._spine.skeleton.setSlotsToSetupPose();\n    }\n    if (this._spine.skeleton.data.findAnimation(this._idleAnimation)) {\n      this._spine.state.setAnimation(0, this._idleAnimation, true);\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.state.clearTracks();\n    }\n    this._winResolve = null;\n  }\n\n  async playWin(): Promise<void> {\n    if (!this._spine) return;\n    if (!this._spine.skeleton.data.findAnimation(this._winAnimation)) return;\n\n    return new Promise<void>((resolve) => {\n      this._winResolve = resolve;\n      const entry = this._spine.state.setAnimation(0, this._winAnimation, false);\n      this._spine.state.addListener({\n        complete: (trackEntry: any) => {\n          if (trackEntry === entry) {\n            this._spine.state.clearListeners();\n            // Return to idle\n            if (this._spine.skeleton.data.findAnimation(this._idleAnimation)) {\n              this._spine.state.setAnimation(0, this._idleAnimation, true);\n            }\n            this._winResolve = null;\n            resolve();\n          }\n        },\n      });\n    });\n  }\n\n  stopAnimation(): void {\n    if (!this._spine) return;\n    this._spine.state.clearListeners();\n    if (this._spine.skeleton.data.findAnimation(this._idleAnimation)) {\n      this._spine.state.setAnimation(0, this._idleAnimation, true);\n    }\n    if (this._winResolve) {\n      this._winResolve();\n      this._winResolve = null;\n    }\n  }\n\n  resize(width: number, height: number): void {\n    if (!this._spine) return;\n    const bounds = this._spine.getBounds();\n    if (bounds.width > 0 && bounds.height > 0) {\n      this._spine.scale.set(\n        width / bounds.width,\n        height / bounds.height,\n      );\n    }\n  }\n\n  protected override onDestroy(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.destroy();\n      this._spine = null;\n    }\n  }\n}\n"],"mappings":";;AAiCA,IAAsB,IAAtB,MAAuD;CAErD;CAEA,YAA4B;CAC5B,eAAuB;CAEvB,cAAc;AACZ,OAAK,OAAO,IAAI,GAAW;;CAG7B,IAAI,WAAmB;AACrB,SAAO,KAAK;;CAGd,IAAI,cAAuB;AACzB,SAAO,KAAK;;CAOd,SAAS,GAAwB;AAG/B,EAFA,KAAK,YAAY,GACjB,KAAK,KAAK,UAAU,IACpB,KAAK,WAAW,EAAS;;CAO3B,aAAmB;AAIjB,EAHA,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,IACjB,KAAK,KAAK,UAAU;;CAItB,QAAc;AACZ,OAAK,YAAY;;CAGnB,UAAgB;AACV,EAIJ,KAAK,kBAHL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,KAAK,QAAQ,EAAE,UAAU,IAAM,CAAC,EACjB;;CAUtB,YAA4B;CAkB5B,kBAAwB;CAMxB,gBAAsB;CAOtB,eAAqB;GCzHnB,IAAkB;AAEtB,eAAe,IAA2B;AACxC,KAAI;AAEF,OADoB,MAAM,OAAO,oCACR;SACnB;;AAMV,GAAW;AAmBX,IAAa,IAAb,cAAiC,EAAW;CAC1C,SAAsB;CACtB;CACA;CACA;CACA;CACA,cAA2C;CAC3C,sBAAsC;CAEtC,YAAY,GAA6B;AAEvC,MADA,OAAO,EACH,CAAC,EACH,OAAU,MACR,qIAED;AAKH,EAHA,KAAK,mBAAmB,EAAQ,iBAChC,KAAK,iBAAiB,EAAQ,iBAAiB,QAC/C,KAAK,gBAAgB,EAAQ,gBAAgB,OAC7C,KAAK,eAAe,EAAQ,eAAe;;CAG7C,WAAqB,GAAwB;EAC3C,IAAM,IAAe,KAAK,iBAAiB;AACtC,QAGD,KAAK,wBAAwB,MAC3B,KAAK,WACP,KAAK,KAAK,YAAY,KAAK,OAAO,EAClC,KAAK,OAAO,SAAS,GAEvB,KAAK,SAAS,IAAI,EAAW,EAAE,iBAAc,CAAC,EAC9C,KAAK,KAAK,SAAS,KAAK,OAAO,EAC/B,KAAK,sBAAsB,IAIzB,KAAK,OAAO,SAAS,KAAK,SAAS,KAAK,aAAa,KACvD,KAAK,OAAO,SAAS,cAAc,KAAK,aAAa,EACrD,KAAK,OAAO,SAAS,qBAAqB,GAExC,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,IAC9D,KAAK,OAAO,MAAM,aAAa,GAAG,KAAK,gBAAgB,GAAK;;CAIhE,eAA+B;AAK7B,EAJI,KAAK,WACP,KAAK,OAAO,MAAM,gBAAgB,EAClC,KAAK,OAAO,MAAM,aAAa,GAEjC,KAAK,cAAc;;CAGrB,MAAM,UAAyB;AACxB,WAAK,UACL,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,cAAc,CAEhE,QAAO,IAAI,SAAe,MAAY;AACpC,QAAK,cAAc;GACnB,IAAM,IAAQ,KAAK,OAAO,MAAM,aAAa,GAAG,KAAK,eAAe,GAAM;AAC1E,QAAK,OAAO,MAAM,YAAY,EAC5B,WAAW,MAAoB;AAC7B,IAAI,MAAe,MACjB,KAAK,OAAO,MAAM,gBAAgB,EAE9B,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,IAC9D,KAAK,OAAO,MAAM,aAAa,GAAG,KAAK,gBAAgB,GAAK,EAE9D,KAAK,cAAc,MACnB,GAAS;MAGd,CAAC;IACF;;CAGJ,gBAAsB;AACf,OAAK,WACV,KAAK,OAAO,MAAM,gBAAgB,EAC9B,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,IAC9D,KAAK,OAAO,MAAM,aAAa,GAAG,KAAK,gBAAgB,GAAK,EAE9D,AAEE,KAAK,iBADL,KAAK,aAAa,EACC;;CAIvB,OAAO,GAAe,GAAsB;AAC1C,MAAI,CAAC,KAAK,OAAQ;EAClB,IAAM,IAAS,KAAK,OAAO,WAAW;AACtC,EAAI,EAAO,QAAQ,KAAK,EAAO,SAAS,KACtC,KAAK,OAAO,MAAM,IAChB,IAAQ,EAAO,OACf,IAAS,EAAO,OACjB;;CAIL,YAAqC;AACnC,EAGE,KAAK,YAFL,KAAK,OAAO,MAAM,gBAAgB,EAClC,KAAK,OAAO,SAAS,EACP"}

package/dist/config/SpeedPresets.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Built-in speed profiles covering common slot game needs.
+ *
+ * Bounce values are tuned for the typical 120–200px symbol range. For larger
+ * or smaller symbols, register a custom profile or override `bounceDistance`.
+ * `bounceDuration` is the total time for the two-leg bounce (down then back).
+ */
+export declare const SpeedPresets: {
+    readonly NORMAL: {
+        readonly name: "normal";
+        readonly spinDelay: 100;
+        readonly spinSpeed: 30;
+        readonly stopDelay: 140;
+        readonly anticipationDelay: 450;
+        readonly bounceDistance: 56;
+        readonly bounceDuration: 600;
+        readonly accelerationEase: "power2.in";
+        readonly decelerationEase: "power2.out";
+        readonly accelerationDuration: 300;
+        readonly minimumSpinTime: 500;
+    };
+    readonly TURBO: {
+        readonly name: "turbo";
+        readonly spinDelay: 30;
+        readonly spinSpeed: 50;
+        readonly stopDelay: 0;
+        readonly anticipationDelay: 250;
+        readonly bounceDistance: 42;
+        readonly bounceDuration: 200;
+        readonly accelerationEase: "power2.in";
+        readonly decelerationEase: "power2.out";
+        readonly accelerationDuration: 200;
+        readonly minimumSpinTime: 300;
+    };
+    readonly SUPER_TURBO: {
+        readonly name: "superTurbo";
+        readonly spinDelay: 0;
+        readonly spinSpeed: 80;
+        readonly stopDelay: 0;
+        readonly anticipationDelay: 0;
+        readonly bounceDistance: 14;
+        readonly bounceDuration: 120;
+        readonly accelerationEase: "power1.in";
+        readonly decelerationEase: "power1.out";
+        readonly accelerationDuration: 50;
+        readonly minimumSpinTime: 100;
+    };
+};
+//# sourceMappingURL=SpeedPresets.d.ts.map

package/dist/config/SpeedPresets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpeedPresets.d.ts","sourceRoot":"","sources":["../../src/config/SpeedPresets.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCwB,CAAC"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,12 @@
+/** Default values applied when not explicitly set by the builder. */
+export declare const DEFAULTS: {
+    bufferSymbols: number;
+    symbolGap: {
+        x: number;
+        y: number;
+    };
+    initialSpeed: string;
+    maxPoolPerKey: number;
+    zIndexStep: number;
+};
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,eAAO,MAAM,QAAQ;mBACC,MAAM;;WACL,MAAM;WAAU,MAAM;;kBACjB,MAAM;mBACX,MAAM;gBACR,MAAM;CAC1B,CAAC"}

package/dist/config/types.d.ts

@@ -0,0 +1,93 @@
+import { Container, Ticker } from 'pixi.js';
+/** Timing and animation profile for a speed mode. */
+export interface SpeedProfile {
+    readonly name: string;
+    /** Milliseconds between each reel starting to spin. */
+    readonly spinDelay: number;
+    /** Pixels per frame at full spin speed. */
+    readonly spinSpeed: number;
+    /** Milliseconds between each reel stopping. */
+    readonly stopDelay: number;
+    /** Milliseconds to hold anticipation phase. */
+    readonly anticipationDelay: number;
+    /** Pixels of overshoot when reel lands. */
+    readonly bounceDistance: number;
+    /** Milliseconds for bounce-back animation. */
+    readonly bounceDuration: number;
+    /** Optional GSAP ease string for acceleration. Default: 'power2.in'. */
+    readonly accelerationEase?: string;
+    /** Optional GSAP ease string for deceleration. Default: 'power2.out'. */
+    readonly decelerationEase?: string;
+    /** Milliseconds for acceleration phase. Default: 300. */
+    readonly accelerationDuration?: number;
+    /** Minimum spin time in ms before stop is allowed. Default: 500. */
+    readonly minimumSpinTime?: number;
+}
+/** Per-symbol configuration data. */
+export interface SymbolData {
+    /** Relative weight for random generation (higher = more frequent). */
+    weight: number;
+    /** Display layering order. Higher = in front. */
+    zIndex?: number;
+    /** If true, this symbol renders above the reel mask (for oversized animations). */
+    unmask?: boolean;
+}
+/** Configuration for the reel grid layout. */
+export interface ReelGridConfig {
+    /** Number of reel columns. */
+    reelCount: number;
+    /** Number of visible symbol rows per reel. */
+    visibleRows: number;
+    /** Symbol width in pixels. */
+    symbolWidth: number;
+    /** Symbol height in pixels. */
+    symbolHeight: number;
+    /** Gap between symbols. Default: { x: 0, y: 0 }. */
+    symbolGap?: {
+        x: number;
+        y: number;
+    };
+    /** Number of buffer symbols above and below the visible area. Default: 1. */
+    bufferSymbols?: number;
+}
+/** Extra symbols above/below config per reel. */
+export interface ReelExtraSymbols {
+    symbolsAbove: number;
+    symbolsBelow: number;
+}
+/** Offset modes for X-axis symbol positioning. */
+export type OffsetXMode = 'none' | 'trapezoid';
+/** Trapezoid perspective configuration. */
+export interface TrapezoidConfig {
+    mode: 'trapezoid';
+    widthDifference: number;
+    topWidthFactor: number;
+    bottomWidthFactor: number;
+}
+/** No offset configuration. */
+export interface NoOffsetConfig {
+    mode: 'none';
+}
+export type OffsetConfig = TrapezoidConfig | NoOffsetConfig;
+/** 2D matrix type (reel × row). */
+export type Matrix<T> = T[][];
+/** Simple 2D position. */
+export interface Position {
+    x: number;
+    y: number;
+}
+/** Mask configuration for the reel viewport. */
+export interface MaskConfig {
+    mask: Container;
+    position: Position;
+}
+/** Full internal configuration assembled by the builder. */
+export interface ReelSetInternalConfig {
+    grid: Required<ReelGridConfig>;
+    symbols: Record<string, SymbolData>;
+    speeds: Map<string, SpeedProfile>;
+    initialSpeed: string;
+    offset: OffsetConfig;
+    ticker: Ticker;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/core/Reel.d.ts

@@ -0,0 +1,106 @@
+import { Container } from 'pixi.js';
+import { Disposable } from '../utils/Disposable.js';
+import { ReelSymbol } from '../symbols/ReelSymbol.js';
+import { SymbolFactory } from '../symbols/SymbolFactory.js';
+import { SymbolData } from '../config/types.js';
+import { ReelMotion } from './ReelMotion.js';
+import { StopSequencer } from './StopSequencer.js';
+import { EventEmitter } from '../events/EventEmitter.js';
+import { ReelEvents } from '../events/ReelEvents.js';
+import { RandomSymbolProvider } from '../frame/RandomSymbolProvider.js';
+import { ReelViewport } from './ReelViewport.js';
+import { SpinningMode } from '../spin/modes/SpinningMode.js';
+export interface ReelConfig {
+    reelIndex: number;
+    visibleRows: number;
+    bufferAbove: number;
+    bufferBelow: number;
+    symbolWidth: number;
+    symbolHeight: number;
+    symbolGapX: number;
+    symbolGapY: number;
+    symbolsData: Record<string, SymbolData>;
+    initialSymbols: string[];
+}
+/**
+ * One vertical column of a slot board.
+ *
+ * A `Reel` owns:
+ *   - the `ReelSymbol[]` currently on screen (a small buffer above the
+ *     visible rows + the visible rows + a small buffer below — so symbols
+ *     can fade in from off-screen cleanly)
+ *   - the `ReelMotion` that adds a Y delta each tick and wraps symbols
+ *     that scroll off the ends
+ *   - a `StopSequencer` — the queue of target symbols the reel still has
+ *     to land on before it can stop
+ *
+ * You generally do not touch a `Reel` directly. Drive the `ReelSet` and
+ * let it fan out. Reels are exposed on `reelSet.reels` so you can read
+ * the current grid (`reel.getSymbolAt(row)`) or listen to per-reel
+ * events (`phase:enter`, `landed`, `symbol:created`, ...).
+ */
+export declare class Reel implements Disposable {
+    readonly container: Container;
+    readonly events: EventEmitter<ReelEvents>;
+    readonly reelIndex: number;
+    /** Current symbols in order (top buffer → visible → bottom buffer). */
+    symbols: ReelSymbol[];
+    /** Current spin speed (pixels per frame). Set by phases. */
+    speed: number;
+    /** Current spinning mode. */
+    spinningMode: SpinningMode;
+    readonly motion: ReelMotion;
+    readonly stopSequencer: StopSequencer;
+    private _symbolFactory;
+    private _randomProvider;
+    private _viewport;
+    private _symbolsData;
+    private _visibleRows;
+    private _bufferAbove;
+    private _symbolWidth;
+    private _symbolHeight;
+    private _isDestroyed;
+    private _isStopping;
+    constructor(config: ReelConfig, symbolFactory: SymbolFactory, randomProvider: RandomSymbolProvider, viewport: ReelViewport);
+    get isDestroyed(): boolean;
+    get isStopping(): boolean;
+    set isStopping(value: boolean);
+    get bufferAbove(): number;
+    get bufferBelow(): number;
+    get visibleRows(): number;
+    /** Update reel for one frame. Called by SpinController via ticker. */
+    update(deltaMs: number): void;
+    /** Set the target frame for stopping. */
+    setStopFrame(frame: string[]): void;
+    /** Get visible symbol IDs (top to bottom, excluding buffers). */
+    getVisibleSymbols(): string[];
+    /** Get symbol at a visible row (0-indexed from top visible). */
+    getSymbolAt(visibleRow: number): ReelSymbol;
+    /** Notify all visible symbols that the reel has started spinning. */
+    notifySpinStart(): void;
+    /** Notify all visible symbols that the reel is about to stop (just before bounce). */
+    notifySpinEnd(): void;
+    /** Notify all visible symbols that the reel has landed on its target. */
+    notifyLanded(): void;
+    /** Snap all symbols to grid. */
+    snapToGrid(): void;
+    /** Place symbols immediately at target positions (for skip/turbo). */
+    placeSymbols(symbolIds: string[]): void;
+    /**
+     * Recompute `zIndex` for every symbol in the reel.
+     *
+     * Formula: `symbolData.zIndex ?? 0` (scaled by 100 to leave room for row
+     * ordering), plus the symbol's current array index — so bottom-row symbols
+     * render in front of top-row symbols and any symbol with a higher
+     * configured base zIndex (e.g. wild, bonus) renders above its neighbors.
+     *
+     * Called automatically after wraps, snaps, and direct placement. Call it
+     * manually after mutating `symbolsData.zIndex` at runtime.
+     */
+    refreshZIndex(): void;
+    destroy(): void;
+    private _setupSymbolPositions;
+    private _onSymbolWrapped;
+    private _replaceSymbol;
+}
+//# sourceMappingURL=Reel.d.ts.map

package/dist/core/Reel.d.ts.map

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