pixi-reels 2.4.0 → 2.6.0

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # pixi-reels
 
+## 2.6.0
+
+### Minor Changes
+
+- [#221](https://github.com/schmooky/pixi-reels/pull/221) [`c96cfdd`](https://github.com/schmooky/pixi-reels/commit/c96cfdd5a29ccbb783425bd4f35765b43fd49941) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Add: `RoundedRectMaskStrategy` gains `scope: 'outer'` (one rect per reel, only the corners that sit on the set's bounding box rounded, safe at a zero cross gap) and a `corners` option (`{ topLeft, topRight, bottomLeft, bottomRight }`, screen-space) that limits which corners round in any scope. `HoldAndWinBuilder.cellMask` and the `BoardGrid` `mask` option now hand the factory `(cell, { cols, rows, corners })`, where `corners` are the board corners that cell sits on, so `(_, { corners }) => new RoundedRectMaskStrategy({ radius, corners })` clips a gapless board as one rounded window with a separate rect mask per cell. Zero-argument factories keep working.
+
+### Patch Changes
+
+- [#220](https://github.com/schmooky/pixi-reels/pull/220) [`767453a`](https://github.com/schmooky/pixi-reels/commit/767453a4f32c1c84ae4a8f0589d9f6a93ba6d0b9) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Perf: `SpineReelSymbol` takes its cached, hidden Spine instances off the ticker. It keeps one instance per symbol id for instant swaps, and each of those was created with spine-pixi's default `autoUpdate`, so every parked skeleton kept updating its animation state and world transform every frame while invisible - hundreds of them on a Hold & Win board of 1x1 reels. Now only the instance on screen updates; a parked one is resumed the moment it is shown again.
+
+## 2.5.0
+
+### Minor Changes
+
+- [#218](https://github.com/schmooky/pixi-reels/pull/218) [`e341a10`](https://github.com/schmooky/pixi-reels/commit/e341a10221197bd7db04cbf047c46fd8e2af41f0) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Add: named speed profiles for the whole Hold & Win board. `HoldAndWinBuilder.speeds({ normal, turbo, superTurbo })` registers each profile into every cell's SpeedManager (`speedProfile(p)` is now `speeds({ normal: p })`), `initialSpeed(name)` picks the one active at build, `board.setSpeed(name)` switches every cell at once and fires `speed:changed`, `board.addSpeed(name, profile)` registers another after build, and `board.speed` / `board.speedNames` read them back. As on a single reel set, a cell already in flight finishes on the profile it started with; the next wave (or `skip()`) shows the new one. The `stagger` callback now receives the active speed name as its third argument.
+
+- [#218](https://github.com/schmooky/pixi-reels/pull/218) [`e341a10`](https://github.com/schmooky/pixi-reels/commit/e341a10221197bd7db04cbf047c46fd8e2af41f0) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Add: dormant Hold & Win cells for boards that grow mid-feature. `HoldAndWinBuilder.inactive(cells, id?)` builds the cells but keeps them out of the feature - they never spin, take no coin, show `id` (default: the empty id) and do not count toward `capacity` / `isFull` - until `HoldAndWinBoard.activate(cells)` wakes them, which fires the new `cells:activated` event. `reset()` puts them back to dormant. `HoldAndWinState` takes the inactive set as a third constructor argument and gains `activate`, `inactiveCells` and `isActive`; the board mirrors them as `activate`, `inactiveCells`.
+
+- [#218](https://github.com/schmooky/pixi-reels/pull/218) [`e341a10`](https://github.com/schmooky/pixi-reels/commit/e341a10221197bd7db04cbf047c46fd8e2af41f0) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Add: `HoldAndWinBuilder.lockAnimation('win' | 'landing' | 'none')` picks what a coin's symbol plays the moment it locks. The default stays `'win'` (the board's existing `playWin()` on `coin:locked`); `'landing'` plays the new `ReelSymbol.playLanding()` land beat only and `'none'` plays nothing, so a board can land every cell quietly and celebrate once. `HoldAndWinBoard.playWin(cells?)` is the explicit celebration: it plays the win on every locked coin (or just `cells`) and resolves when they finish. `ReelSymbol.playLanding()` is a new base-class one-shot that resolves at once by default; `SpineReelSymbol` already implements it with the skeleton's `landing` track.
+
+- [#218](https://github.com/schmooky/pixi-reels/pull/218) [`e341a10`](https://github.com/schmooky/pixi-reels/commit/e341a10221197bd7db04cbf047c46fd8e2af41f0) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Add: rectangular Hold & Win cells and per-axis gaps. `HoldAndWinBuilder.cellSize` takes `{ width, height }` as well as a number, and its options accept `columnGap` / `rowGap` beside the uniform `gap`. `BoardGrid` gains the same (`cellSize: number | { width, height }`, `columnGap`, `rowGap`) and exposes `cellWidth`, `cellHeight`, `columnGap`, `rowGap`; `cellSize` and `gap` remain as deprecated aliases. `cellChrome` / `chrome` callbacks now receive `(graphics, width, height)` - a square-board callback that reads one size argument keeps working. `HoldAndWinBuilder.cellMask(factory)` / `BoardGrid` option `mask` supply each cell's mask strategy, for example a `RoundedRectMaskStrategy` so rounded cell corners match a rounded frame.
+
+### Patch Changes
+
+- [#218](https://github.com/schmooky/pixi-reels/pull/218) [`e341a10`](https://github.com/schmooky/pixi-reels/commit/e341a10221197bd7db04cbf047c46fd8e2af41f0) Thanks [@igaming-bulochka](https://github.com/igaming-bulochka)! - Fix: `BoardGrid` (and so `HoldAndWinBoard`) now draws every cell's chrome beneath every reel and renders the unmasked, at-rest symbols of all cells on one `RenderLayer` above the whole board. A coin with `unmask: true` whose art overflows its cell used to be covered by the next cell's chrome and blank symbol, cutting it along the neighbour's edge.
+
 ## 2.4.0
 
 ### Minor Changes

package/dist/{ReelSymbol-JASIxGy4.js → ReelSymbol-D698guvK.js}

@@ -41,6 +41,7 @@ var n = t, r = class {
 		this._isDestroyed ||= (this.stopAnimation(), this.onDeactivate(), this.onDestroy(), this.view.destroyed || this.view.destroy({ children: !0 }), !0);
 	}
 	onDestroy() {}
+	async playLanding() {}
 	async playDestroy(e) {
 		let t = this.view, n = t.pivot.x, r = t.pivot.y, i = t.x, a = t.y, o = t.getLocalBounds(), s = o.x + o.width / 2, c = o.y + o.height / 2;
 		t.pivot.set(s, c), t.x = i + (s - n) * t.scale.x, t.y = a + (c - r) * t.scale.y;
@@ -145,4 +146,4 @@ var n = t, r = class {
 //#endregion
 export { n, r as t };
 
-//# sourceMappingURL=ReelSymbol-JASIxGy4.js.map
+//# sourceMappingURL=ReelSymbol-D698guvK.js.map

package/dist/ReelSymbol-D698guvK.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReelSymbol-D698guvK.js","names":[],"sources":["../src/utils/gsap.ts","../src/symbols/ReelSymbol.ts"],"sourcesContent":["import { gsap as resolvedGsap } from 'gsap';\n\n/** The gsap namespace type, as the engine passes it around. */\nexport type Gsap = typeof resolvedGsap;\n\n/**\n * The gsap instance resolved at lib-load time. Used by any `ReelSet` whose\n * builder did not call `.gsap(...)`, and by any symbol not yet bound to a\n * set.\n *\n * **Why the engine passes gsap around at all:** under tools that resolve\n * modules through symlinked workspaces (vite + a locally-linked pixi-reels,\n * pnpm dev setups, esbuild plugin chains), the gsap import inside the lib's\n * compiled `dist/index.js` and the gsap import in the consumer's source can\n * resolve to *different module instances*. each with its own root timeline.\n * The consumer drives one, the lib's tweens live on the other, and reels\n * stall at progress 0. `ReelSetBuilder.gsap(myGsap)` hands the engine the\n * consumer's instance so both live on the same timeline.\n *\n * Held PER REEL SET, not process-wide: two sets on one stage can be driven\n * by different gsap instances, which is what a composed stage (a banner reel\n * above a main grid, a bonus board beside it) needs.\n */\nexport const DEFAULT_GSAP: Gsap = resolvedGsap;\n","import { Container } from 'pixi.js';\nimport type { Disposable } from '../utils/Disposable.js';\nimport type { ReelCellInset, ReelCellQuad } from '../config/types.js';\nimport { DEFAULT_GSAP, type Gsap } from '../utils/gsap.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  private _gsap: Gsap = DEFAULT_GSAP;\n  private _mainAxis: 'x' | 'y' = 'y';\n\n  constructor() {\n    this.view = new Container();\n  }\n\n  /**\n   * The gsap instance this symbol should animate on. Use it instead of\n   * importing `gsap` in a subclass: under a symlinked-workspace module\n   * resolution your import and the engine's can be different instances, and\n   * only this one is on the timeline the reel set actually drives.\n   *\n   * Bound to the owning set by `SymbolFactory`; falls back to the instance\n   * resolved at lib-load time for a symbol built outside a set.\n   */\n  protected get gsap(): Gsap {\n    return this._gsap;\n  }\n\n  /**\n   * @internal. Called by `SymbolFactory` when the symbol is created, so a\n   * pooled symbol animates on its own set's gsap rather than whichever set\n   * happened to build last.\n   */\n  bindGsap(instance: Gsap): void {\n    this._gsap = instance;\n  }\n\n  /**\n   * The screen axis the owning set's strips travel along: `'y'` for a\n   * vertical set, `'x'` for a horizontal one.\n   *\n   * Symbols are otherwise orientation-agnostic - `resize(width, height)` is\n   * screen-space and always will be. This exists for the few effects that\n   * genuinely follow travel, motion blur being the one in the box.\n   */\n  protected get mainAxis(): 'x' | 'y' {\n    return this._mainAxis;\n  }\n\n  /** @internal. Bound by `SymbolFactory` from the set's orientation. */\n  bindMainAxis(prop: 'x' | 'y'): void {\n    this._mainAxis = prop;\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. Called when the symbol enters\n   * the visible reel or is recycled from the pool. Resets container\n   * transform / filter state for parity with deactivate().\n   */\n  activate(symbolId: string): void {\n    this._symbolId = symbolId;\n    this.view.visible = true;\n    this.view.alpha = 1;\n    this.view.scale.set(1, 1);\n    this.view.rotation = 0;\n    this.view.filters = null;\n    this.view.zIndex = 0;\n    this.onActivate(symbolId);\n  }\n\n  /**\n   * Deactivate the symbol before returning it to the pool. Stops\n   * animations, hides the view, and resets container transform / filter\n   * state so subclass decorations don't leak across recycles.\n   */\n  deactivate(): void {\n    this.stopAnimation();\n    this.onDeactivate();\n    this._symbolId = '';\n    this.view.visible = false;\n    this.view.alpha = 1;\n    this.view.scale.set(1, 1);\n    this.view.rotation = 0;\n    this.view.filters = null;\n    this.view.zIndex = 0;\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.stopAnimation();\n    this.onDeactivate();\n    this.onDestroy();\n    if (!this.view.destroyed) 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\n  /** Play the win/highlight animation for this symbol. Resolves when complete. */\n  abstract playWin(): Promise<void>;\n\n  /**\n   * Play the landing beat for this symbol - the settle a symbol does as its\n   * reel stops, before (or instead of) any celebration. Resolves when done.\n   *\n   * The reel engine never calls this itself: `onReelLanded()` is the\n   * engine-driven hook, fired on every landed symbol. This is the explicit\n   * counterpart for a caller that lands cells one at a time - `HoldAndWinBoard`\n   * calls it on each lock when built with `lockAnimation('landing')`.\n   *\n   * Default: resolves at once. `SpineReelSymbol` overrides it with the\n   * skeleton's `landing` track; a sprite symbol can override it with a tween.\n   */\n  async playLanding(): 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   * Play the cascade-destruction animation for this symbol. Called by\n   * consumers (typically via `reelSet.destroySymbols(...)`) to disintegrate\n   * a winning cell before the next cascade refill drops fresh symbols in.\n   *\n   * Override in subclasses for art-appropriate destruction, e.g. a Spine\n   * symbol can play its `disintegration` track here, or a sprite symbol can\n   * swap to a shatter atlas. The promise must resolve when the symbol is no\n   * longer visible.\n   *\n   * Default: a snappy \"poof\" centered on the symbol's bounds regardless of\n   * the view's anchor. Tiny anticipation pop (~60 ms) then a fast implode to\n   * `scale: 0` + `alpha: 0` (~140 ms), ~200 ms total, no rotation. Reads\n   * cleanly under win-cluster pacing without competing with the win\n   * presenter. The view is left at `alpha: 0` (destroyed); position / pivot\n   * are restored so pool reuse via `_replaceSymbol`'s same-id fast path\n   * doesn't inherit a stale pivot offset.\n   *\n   * `opts.delay`. seconds to wait before the animation starts. Use to\n   * stagger a cluster of winners (e.g. `i * 0.015`).\n   * `opts.signal`. abort signal. If aborted (now or mid-animation), the\n   * tween is killed and the view is snapped to its destroyed pose\n   * (`alpha: 0`, transform restored). The promise resolves normally. abort\n   * means \"skip to the end,\" not \"fail\". Subclasses that override this\n   * method MUST honor the signal or document why they can't (e.g. a Spine\n   * `disintegration` track is uninterruptible).\n   */\n  async playDestroy(opts?: { delay?: number; signal?: AbortSignal }): Promise<void> {\n    const view = this.view;\n    // Capture original transform so pool reuse sees a clean state.\n    const originalPivotX = view.pivot.x;\n    const originalPivotY = view.pivot.y;\n    const originalX = view.x;\n    const originalY = view.y;\n\n    // Pivot to bounds-center so the scale collapses around the visual\n    // centre instead of the view's (0,0) corner. and compensate position\n    // so the symbol doesn't visibly jump when the pivot moves.\n    const bounds = view.getLocalBounds();\n    const cx = bounds.x + bounds.width / 2;\n    const cy = bounds.y + bounds.height / 2;\n    // Moving the pivot moves the view by `delta * scale`, not by `delta`: a\n    // container renders a local point at `position + (point - pivot) * scale`.\n    // Scale is 1 on a plain reel, which is why dropping it went unnoticed, but\n    // a curved reel scales every cell and the symbol would jump on destroy.\n    view.pivot.set(cx, cy);\n    view.x = originalX + (cx - originalPivotX) * view.scale.x;\n    view.y = originalY + (cy - originalPivotY) * view.scale.y;\n\n    const delay = opts?.delay ?? 0;\n    const signal = opts?.signal;\n\n    const snapDestroyed = (): void => {\n      view.alpha = 0;\n      view.scale.set(0, 0);\n    };\n\n    // Pre-abort: skip the tween entirely and snap to the destroyed pose.\n    if (signal?.aborted) {\n      snapDestroyed();\n      view.pivot.set(originalPivotX, originalPivotY);\n      view.x = originalX;\n      view.y = originalY;\n      view.scale.set(1, 1);\n      view.alpha = 0;\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      const tl = this.gsap\n        .timeline({ onComplete: () => {\n          if (signal) signal.removeEventListener('abort', onAbort);\n          resolve();\n        }, delay })\n        // Brief anticipation pop. small upscale, ~60 ms, with overshoot\n        // so the implode reads as a release. No rotation.\n        .to(view.scale, { x: 1.1, y: 1.1, duration: 0.06, ease: 'back.out(2.5)' })\n        // Snap implode. scale -> 0 + alpha -> 0 together, snappy ease-in\n        // so the symbol collapses into the cell centre and is gone.\n        .to(view.scale, { x: 0, y: 0, duration: 0.14, ease: 'power3.in' }, '<+=0.04')\n        .to(view, { alpha: 0, duration: 0.14, ease: 'power3.in' }, '<');\n\n      const onAbort = (): void => {\n        tl.kill();\n        snapDestroyed();\n        resolve();\n      };\n      if (signal) signal.addEventListener('abort', onAbort, { once: true });\n    });\n\n    // Restore transform. alpha stays 0 (the symbol IS destroyed). Scale\n    // restored to 1 so pool reuse via `_replaceSymbol`'s same-id fast path\n    // doesn't inherit a stale 0× scale; _replaceSymbol also resets scale\n    // explicitly but a defensive restore here makes the destroyed cell\n    // observably \"ready to be re-skinned\" between calls.\n    view.pivot.set(originalPivotX, originalPivotY);\n    view.x = originalX;\n    view.y = originalY;\n    view.scale.set(1, 1);\n  }\n\n  /**\n   * Animate this symbol AWAY, without destroying it.\n   *\n   * The counterpart to {@link playIn}, and the seam a mystery reveal needs:\n   * the cells on screen dissolve, their identities are swapped underneath, and\n   * the new ones arrive. `playDestroy` is the cascade's version of the same\n   * beat and is deliberately separate - it is tuned as a \"this cell was a\n   * winner and is being consumed\" poof, and a reveal is not that.\n   *\n   * Leaves the view hidden (`alpha: 0`) with its transform restored, so the\n   * caller may swap the identity and call `playIn` next.\n   *\n   * Override for art-appropriate exits - a Spine symbol plays its own `out`\n   * track here. Honour `opts.signal`: abort means \"snap to the end\", not\n   * \"fail\", so the promise still resolves.\n   *\n   * Default: a ~180 ms shrink-and-fade with no overshoot, centred on the\n   * symbol's bounds rather than the view origin.\n   */\n  async playOut(opts?: { delay?: number; signal?: AbortSignal }): Promise<void> {\n    await this._tweenPresence('out', opts);\n  }\n\n  /**\n   * Animate this symbol IN, from nothing to its resting pose.\n   *\n   * Owns its own start pose. A symbol that has just been re-activated is fully\n   * visible (`activate()` resets alpha and scale), so an entrance that assumed\n   * it started hidden would pop before it animated. This sets the hidden pose\n   * first, then plays.\n   *\n   * Override for art-appropriate entrances - a Spine symbol plays its own `in`\n   * track here. Honour `opts.signal`: abort snaps to the RESTING pose (alpha 1,\n   * scale 1), because arriving is what the caller asked for.\n   *\n   * Default: a ~200 ms fade and scale-up with a small overshoot.\n   */\n  async playIn(opts?: { delay?: number; signal?: AbortSignal }): Promise<void> {\n    await this._tweenPresence('in', opts);\n  }\n\n  /**\n   * Shared body of {@link playIn} / {@link playOut}.\n   *\n   * One function because the two are the same tween read in opposite\n   * directions, and because the fiddly part - pivoting to the visual centre so\n   * the scale does not collapse toward the view's (0, 0) corner, and\n   * compensating the position for the pivot move - is identical and easy to get\n   * subtly wrong twice. Same correction as `playDestroy`: a container renders a\n   * local point at `position + (point - pivot) * scale`, so a curved reel (which\n   * scales every cell) would make the symbol jump without the `* scale` term.\n   */\n  private async _tweenPresence(\n    direction: 'in' | 'out',\n    opts?: { delay?: number; signal?: AbortSignal },\n  ): Promise<void> {\n    const view = this.view;\n    const originalPivotX = view.pivot.x;\n    const originalPivotY = view.pivot.y;\n    const originalX = view.x;\n    const originalY = view.y;\n\n    const bounds = view.getLocalBounds();\n    const cx = bounds.x + bounds.width / 2;\n    const cy = bounds.y + bounds.height / 2;\n    view.pivot.set(cx, cy);\n    view.x = originalX + (cx - originalPivotX) * view.scale.x;\n    view.y = originalY + (cy - originalPivotY) * view.scale.y;\n\n    const restorePivot = (): void => {\n      view.pivot.set(originalPivotX, originalPivotY);\n      view.x = originalX;\n      view.y = originalY;\n    };\n    const snapEnd = (): void => {\n      if (direction === 'out') {\n        view.alpha = 0;\n        view.scale.set(1, 1);\n      } else {\n        view.visible = true;\n        view.alpha = 1;\n        view.scale.set(1, 1);\n      }\n    };\n\n    const delay = opts?.delay ?? 0;\n    const signal = opts?.signal;\n\n    if (direction === 'in') {\n      // Own the start pose: `activate()` leaves a freshly swapped symbol fully\n      // visible, so without this the new art is on screen for a frame before\n      // the entrance begins.\n      view.visible = true;\n      view.alpha = 0;\n      view.scale.set(0.72, 0.72);\n    }\n\n    if (signal?.aborted) {\n      snapEnd();\n      restorePivot();\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      const onAbort = (): void => {\n        tl.kill();\n        snapEnd();\n        resolve();\n      };\n      const tl = this.gsap.timeline({\n        delay,\n        onComplete: () => {\n          if (signal) signal.removeEventListener('abort', onAbort);\n          resolve();\n        },\n      });\n      if (direction === 'out') {\n        tl.to(view.scale, { x: 0.72, y: 0.72, duration: 0.18, ease: 'power2.in' }).to(\n          view,\n          { alpha: 0, duration: 0.18, ease: 'power2.in' },\n          '<',\n        );\n      } else {\n        tl.to(view.scale, { x: 1, y: 1, duration: 0.2, ease: 'back.out(1.7)' }).to(\n          view,\n          { alpha: 1, duration: 0.16, ease: 'power2.out' },\n          '<',\n        );\n      }\n      if (signal) signal.addEventListener('abort', onAbort, { once: true });\n    });\n\n    // Scale back to 1 either way: a hidden symbol still has to be a legal\n    // resting pose, or pool reuse inherits the shrunken scale.\n    view.scale.set(1, 1);\n    restorePivot();\n  }\n\n  /**\n   * The owning reel is curved: render into this projected quad instead of the\n   * flat cell rectangle. `null` means the reel is flat again.\n   *\n   * The quad's corners are SCREEN-space and local to this view's own origin,\n   * clockwise from top-left, and `width` / `height` give the flat cell box the\n   * quad replaces. Called on every frame of motion and on every placement, so\n   * it must be cheap and idempotent.\n   *\n   * **The default is an approximation.** A `Container` transform is affine, so\n   * it cannot express a trapezoid; the base class fits the quad as closely as\n   * an affine transform can - a UNIFORM scale about the quad's centre. Uniform\n   * on purpose: symbol art is usually smaller than its cell and has a shape a\n   * player recognises, and squashing one axis turns a `7` into a squashed `7`\n   * rather than a `7` seen at an angle.\n   *\n   * Override this to render the real perspective. {@link SpriteSymbol} and\n   * {@link AnimatedSpriteSymbol} do, by drawing their texture through a\n   * `PerspectiveMesh`, which costs no extra render pass because the content is\n   * already a texture. A symbol whose content is an arbitrary subtree (Spine, a\n   * composite of sprites and text) cannot do that without rendering itself to a\n   * texture every frame, so it keeps the affine fit.\n   *\n   * Whatever you do here, do NOT move `view.position`: the reel reads that\n   * coordinate back to work out which slot this symbol is in.\n   */\n  /**\n   * The part of its cell this symbol's art actually covers, or `null` (the\n   * default) for \"all of it\".\n   *\n   * Slot art is usually smaller than its cell - a trimmed atlas frame is a\n   * shape floating in a much bigger transparent box - and the reel needs to\n   * know that to project the rectangle the art is really in. Overriding this\n   * is what stops a small symbol being inflated to the cell's edges and given\n   * the cell's keystone instead of its own, milder one.\n   *\n   * Read once per projection, so it may change with the symbol's identity.\n   */\n  get cellInset(): ReelCellInset | null {\n    return null;\n  }\n\n  applyCellQuad(quad: ReelCellQuad | null): void {\n    const view = this.view;\n    if (quad === null) {\n      view.scale.set(1, 1);\n      view.pivot.set(0, 0);\n      return;\n    }\n    // Measure the trapezoid: the mean of its two parallel edges, and the\n    // distance between their midpoints.\n    const nearWidth = Math.hypot(quad.x1 - quad.x0, quad.y1 - quad.y0);\n    const farWidth = Math.hypot(quad.x2 - quad.x3, quad.y2 - quad.y3);\n    const across = (nearWidth + farWidth) / 2;\n    const along = Math.hypot(\n      (quad.x3 + quad.x2) / 2 - (quad.x0 + quad.x1) / 2,\n      (quad.y3 + quad.y2) / 2 - (quad.y0 + quad.y1) / 2,\n    );\n    // CONTAIN, not cover. A quad in the middle of the window is TALLER than\n    // the flat cell (that is the drum magnifying what faces you), so a scale\n    // picked to fill it would also make the symbol wider than its column and\n    // overlap its neighbours - very visible on art that fills its cell\n    // edge-to-edge. Taking the smaller ratio keeps every symbol inside its own\n    // projected footprint at the cost of a little slack on one axis.\n    const scale =\n      quad.width > 0 && quad.height > 0\n        ? Math.min(across / quad.width, along / quad.height)\n        : 1;\n\n    const cx = (quad.x0 + quad.x1 + quad.x2 + quad.x3) / 4;\n    const cy = (quad.y0 + quad.y1 + quad.y2 + quad.y3) / 4;\n    view.scale.set(scale, scale);\n    // A container renders a local point at `position + (point - pivot) * scale`\n    // and `position` must not move, so putting the flat box's centre on the\n    // quad's centre has to be paid for entirely out of the pivot.\n    view.pivot.set(\n      quad.x + quad.width / 2 - cx / scale,\n      quad.y + quad.height / 2 - cy / scale,\n    );\n  }\n\n  /**\n   * Lifecycle hook: the owning reel is spinning.\n   * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayBlur,\n   * StaticSpinSymbol) to swap to a spin presentation automatically.\n   *\n   * Fired on every strip symbol (visible AND buffer cells) when the reel\n   * enters the spin phase, and again with `joinedMidSpin: true` on each\n   * symbol freshly installed while the reel is already spinning (pool\n   * recycling wipes symbol state, so a wrapped-in symbol can't know the\n   * reel is moving without this). Implementations MUST be idempotent.\n   * the same instance can be notified more than once per spin.\n   *\n   * @param joinedMidSpin true when this symbol was installed into a reel\n   * already at speed (skip start-of-spin transitions like blur ramps).\n   */\n  onReelSpinStart(joinedMidSpin?: boolean): 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 entered its anticipation (tease) phase.\n   * it is still spinning, but slowed enough that the strip is readable.\n   * Spin presentations that obscure symbols (blur textures, smear\n   * animations) should relax so the player can follow the tease. Also\n   * fired on symbols installed while the reel is anticipating.\n   * Implementations MUST be idempotent. Default: no-op.\n   */\n  onReelAnticipationStart(): 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"],"mappings":"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"}

package/dist/ReelSymbol-DjJzuBhn.cjs

@@ -0,0 +1,2 @@
+let e=require(`pixi.js`);var t=require(`gsap`).gsap,n=class{view;_symbolId=``;_isDestroyed=!1;_gsap=t;_mainAxis=`y`;constructor(){this.view=new e.Container}get gsap(){return this._gsap}bindGsap(e){this._gsap=e}get mainAxis(){return this._mainAxis}bindMainAxis(e){this._mainAxis=e}get symbolId(){return this._symbolId}get isDestroyed(){return this._isDestroyed}activate(e){this._symbolId=e,this.view.visible=!0,this.view.alpha=1,this.view.scale.set(1,1),this.view.rotation=0,this.view.filters=null,this.view.zIndex=0,this.onActivate(e)}deactivate(){this.stopAnimation(),this.onDeactivate(),this._symbolId=``,this.view.visible=!1,this.view.alpha=1,this.view.scale.set(1,1),this.view.rotation=0,this.view.filters=null,this.view.zIndex=0}reset(){this.deactivate()}destroy(){this._isDestroyed||=(this.stopAnimation(),this.onDeactivate(),this.onDestroy(),this.view.destroyed||this.view.destroy({children:!0}),!0)}onDestroy(){}async playLanding(){}async playDestroy(e){let t=this.view,n=t.pivot.x,r=t.pivot.y,i=t.x,a=t.y,o=t.getLocalBounds(),s=o.x+o.width/2,c=o.y+o.height/2;t.pivot.set(s,c),t.x=i+(s-n)*t.scale.x,t.y=a+(c-r)*t.scale.y;let l=e?.delay??0,u=e?.signal,d=()=>{t.alpha=0,t.scale.set(0,0)};if(u?.aborted){d(),t.pivot.set(n,r),t.x=i,t.y=a,t.scale.set(1,1),t.alpha=0;return}await new Promise(e=>{let n=this.gsap.timeline({onComplete:()=>{u&&u.removeEventListener(`abort`,r),e()},delay:l}).to(t.scale,{x:1.1,y:1.1,duration:.06,ease:`back.out(2.5)`}).to(t.scale,{x:0,y:0,duration:.14,ease:`power3.in`},`<+=0.04`).to(t,{alpha:0,duration:.14,ease:`power3.in`},`<`),r=()=>{n.kill(),d(),e()};u&&u.addEventListener(`abort`,r,{once:!0})}),t.pivot.set(n,r),t.x=i,t.y=a,t.scale.set(1,1)}async playOut(e){await this._tweenPresence(`out`,e)}async playIn(e){await this._tweenPresence(`in`,e)}async _tweenPresence(e,t){let n=this.view,r=n.pivot.x,i=n.pivot.y,a=n.x,o=n.y,s=n.getLocalBounds(),c=s.x+s.width/2,l=s.y+s.height/2;n.pivot.set(c,l),n.x=a+(c-r)*n.scale.x,n.y=o+(l-i)*n.scale.y;let u=()=>{n.pivot.set(r,i),n.x=a,n.y=o},d=()=>{e===`out`?(n.alpha=0,n.scale.set(1,1)):(n.visible=!0,n.alpha=1,n.scale.set(1,1))},f=t?.delay??0,p=t?.signal;if(e===`in`&&(n.visible=!0,n.alpha=0,n.scale.set(.72,.72)),p?.aborted){d(),u();return}await new Promise(t=>{let r=()=>{i.kill(),d(),t()},i=this.gsap.timeline({delay:f,onComplete:()=>{p&&p.removeEventListener(`abort`,r),t()}});e===`out`?i.to(n.scale,{x:.72,y:.72,duration:.18,ease:`power2.in`}).to(n,{alpha:0,duration:.18,ease:`power2.in`},`<`):i.to(n.scale,{x:1,y:1,duration:.2,ease:`back.out(1.7)`}).to(n,{alpha:1,duration:.16,ease:`power2.out`},`<`),p&&p.addEventListener(`abort`,r,{once:!0})}),n.scale.set(1,1),u()}get cellInset(){return null}applyCellQuad(e){let t=this.view;if(e===null){t.scale.set(1,1),t.pivot.set(0,0);return}let n=(Math.hypot(e.x1-e.x0,e.y1-e.y0)+Math.hypot(e.x2-e.x3,e.y2-e.y3))/2,r=Math.hypot((e.x3+e.x2)/2-(e.x0+e.x1)/2,(e.y3+e.y2)/2-(e.y0+e.y1)/2),i=e.width>0&&e.height>0?Math.min(n/e.width,r/e.height):1,a=(e.x0+e.x1+e.x2+e.x3)/4,o=(e.y0+e.y1+e.y2+e.y3)/4;t.scale.set(i,i),t.pivot.set(e.x+e.width/2-a/i,e.y+e.height/2-o/i)}onReelSpinStart(e){}onReelSpinEnd(){}onReelAnticipationStart(){}onReelLanded(){}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return n}});
+//# sourceMappingURL=ReelSymbol-DjJzuBhn.cjs.map

package/dist/ReelSymbol-DjJzuBhn.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReelSymbol-DjJzuBhn.cjs","names":[],"sources":["../src/utils/gsap.ts","../src/symbols/ReelSymbol.ts"],"sourcesContent":["import { gsap as resolvedGsap } from 'gsap';\n\n/** The gsap namespace type, as the engine passes it around. */\nexport type Gsap = typeof resolvedGsap;\n\n/**\n * The gsap instance resolved at lib-load time. Used by any `ReelSet` whose\n * builder did not call `.gsap(...)`, and by any symbol not yet bound to a\n * set.\n *\n * **Why the engine passes gsap around at all:** under tools that resolve\n * modules through symlinked workspaces (vite + a locally-linked pixi-reels,\n * pnpm dev setups, esbuild plugin chains), the gsap import inside the lib's\n * compiled `dist/index.js` and the gsap import in the consumer's source can\n * resolve to *different module instances*. each with its own root timeline.\n * The consumer drives one, the lib's tweens live on the other, and reels\n * stall at progress 0. `ReelSetBuilder.gsap(myGsap)` hands the engine the\n * consumer's instance so both live on the same timeline.\n *\n * Held PER REEL SET, not process-wide: two sets on one stage can be driven\n * by different gsap instances, which is what a composed stage (a banner reel\n * above a main grid, a bonus board beside it) needs.\n */\nexport const DEFAULT_GSAP: Gsap = resolvedGsap;\n","import { Container } from 'pixi.js';\nimport type { Disposable } from '../utils/Disposable.js';\nimport type { ReelCellInset, ReelCellQuad } from '../config/types.js';\nimport { DEFAULT_GSAP, type Gsap } from '../utils/gsap.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  private _gsap: Gsap = DEFAULT_GSAP;\n  private _mainAxis: 'x' | 'y' = 'y';\n\n  constructor() {\n    this.view = new Container();\n  }\n\n  /**\n   * The gsap instance this symbol should animate on. Use it instead of\n   * importing `gsap` in a subclass: under a symlinked-workspace module\n   * resolution your import and the engine's can be different instances, and\n   * only this one is on the timeline the reel set actually drives.\n   *\n   * Bound to the owning set by `SymbolFactory`; falls back to the instance\n   * resolved at lib-load time for a symbol built outside a set.\n   */\n  protected get gsap(): Gsap {\n    return this._gsap;\n  }\n\n  /**\n   * @internal. Called by `SymbolFactory` when the symbol is created, so a\n   * pooled symbol animates on its own set's gsap rather than whichever set\n   * happened to build last.\n   */\n  bindGsap(instance: Gsap): void {\n    this._gsap = instance;\n  }\n\n  /**\n   * The screen axis the owning set's strips travel along: `'y'` for a\n   * vertical set, `'x'` for a horizontal one.\n   *\n   * Symbols are otherwise orientation-agnostic - `resize(width, height)` is\n   * screen-space and always will be. This exists for the few effects that\n   * genuinely follow travel, motion blur being the one in the box.\n   */\n  protected get mainAxis(): 'x' | 'y' {\n    return this._mainAxis;\n  }\n\n  /** @internal. Bound by `SymbolFactory` from the set's orientation. */\n  bindMainAxis(prop: 'x' | 'y'): void {\n    this._mainAxis = prop;\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. Called when the symbol enters\n   * the visible reel or is recycled from the pool. Resets container\n   * transform / filter state for parity with deactivate().\n   */\n  activate(symbolId: string): void {\n    this._symbolId = symbolId;\n    this.view.visible = true;\n    this.view.alpha = 1;\n    this.view.scale.set(1, 1);\n    this.view.rotation = 0;\n    this.view.filters = null;\n    this.view.zIndex = 0;\n    this.onActivate(symbolId);\n  }\n\n  /**\n   * Deactivate the symbol before returning it to the pool. Stops\n   * animations, hides the view, and resets container transform / filter\n   * state so subclass decorations don't leak across recycles.\n   */\n  deactivate(): void {\n    this.stopAnimation();\n    this.onDeactivate();\n    this._symbolId = '';\n    this.view.visible = false;\n    this.view.alpha = 1;\n    this.view.scale.set(1, 1);\n    this.view.rotation = 0;\n    this.view.filters = null;\n    this.view.zIndex = 0;\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.stopAnimation();\n    this.onDeactivate();\n    this.onDestroy();\n    if (!this.view.destroyed) 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\n  /** Play the win/highlight animation for this symbol. Resolves when complete. */\n  abstract playWin(): Promise<void>;\n\n  /**\n   * Play the landing beat for this symbol - the settle a symbol does as its\n   * reel stops, before (or instead of) any celebration. Resolves when done.\n   *\n   * The reel engine never calls this itself: `onReelLanded()` is the\n   * engine-driven hook, fired on every landed symbol. This is the explicit\n   * counterpart for a caller that lands cells one at a time - `HoldAndWinBoard`\n   * calls it on each lock when built with `lockAnimation('landing')`.\n   *\n   * Default: resolves at once. `SpineReelSymbol` overrides it with the\n   * skeleton's `landing` track; a sprite symbol can override it with a tween.\n   */\n  async playLanding(): 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   * Play the cascade-destruction animation for this symbol. Called by\n   * consumers (typically via `reelSet.destroySymbols(...)`) to disintegrate\n   * a winning cell before the next cascade refill drops fresh symbols in.\n   *\n   * Override in subclasses for art-appropriate destruction, e.g. a Spine\n   * symbol can play its `disintegration` track here, or a sprite symbol can\n   * swap to a shatter atlas. The promise must resolve when the symbol is no\n   * longer visible.\n   *\n   * Default: a snappy \"poof\" centered on the symbol's bounds regardless of\n   * the view's anchor. Tiny anticipation pop (~60 ms) then a fast implode to\n   * `scale: 0` + `alpha: 0` (~140 ms), ~200 ms total, no rotation. Reads\n   * cleanly under win-cluster pacing without competing with the win\n   * presenter. The view is left at `alpha: 0` (destroyed); position / pivot\n   * are restored so pool reuse via `_replaceSymbol`'s same-id fast path\n   * doesn't inherit a stale pivot offset.\n   *\n   * `opts.delay`. seconds to wait before the animation starts. Use to\n   * stagger a cluster of winners (e.g. `i * 0.015`).\n   * `opts.signal`. abort signal. If aborted (now or mid-animation), the\n   * tween is killed and the view is snapped to its destroyed pose\n   * (`alpha: 0`, transform restored). The promise resolves normally. abort\n   * means \"skip to the end,\" not \"fail\". Subclasses that override this\n   * method MUST honor the signal or document why they can't (e.g. a Spine\n   * `disintegration` track is uninterruptible).\n   */\n  async playDestroy(opts?: { delay?: number; signal?: AbortSignal }): Promise<void> {\n    const view = this.view;\n    // Capture original transform so pool reuse sees a clean state.\n    const originalPivotX = view.pivot.x;\n    const originalPivotY = view.pivot.y;\n    const originalX = view.x;\n    const originalY = view.y;\n\n    // Pivot to bounds-center so the scale collapses around the visual\n    // centre instead of the view's (0,0) corner. and compensate position\n    // so the symbol doesn't visibly jump when the pivot moves.\n    const bounds = view.getLocalBounds();\n    const cx = bounds.x + bounds.width / 2;\n    const cy = bounds.y + bounds.height / 2;\n    // Moving the pivot moves the view by `delta * scale`, not by `delta`: a\n    // container renders a local point at `position + (point - pivot) * scale`.\n    // Scale is 1 on a plain reel, which is why dropping it went unnoticed, but\n    // a curved reel scales every cell and the symbol would jump on destroy.\n    view.pivot.set(cx, cy);\n    view.x = originalX + (cx - originalPivotX) * view.scale.x;\n    view.y = originalY + (cy - originalPivotY) * view.scale.y;\n\n    const delay = opts?.delay ?? 0;\n    const signal = opts?.signal;\n\n    const snapDestroyed = (): void => {\n      view.alpha = 0;\n      view.scale.set(0, 0);\n    };\n\n    // Pre-abort: skip the tween entirely and snap to the destroyed pose.\n    if (signal?.aborted) {\n      snapDestroyed();\n      view.pivot.set(originalPivotX, originalPivotY);\n      view.x = originalX;\n      view.y = originalY;\n      view.scale.set(1, 1);\n      view.alpha = 0;\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      const tl = this.gsap\n        .timeline({ onComplete: () => {\n          if (signal) signal.removeEventListener('abort', onAbort);\n          resolve();\n        }, delay })\n        // Brief anticipation pop. small upscale, ~60 ms, with overshoot\n        // so the implode reads as a release. No rotation.\n        .to(view.scale, { x: 1.1, y: 1.1, duration: 0.06, ease: 'back.out(2.5)' })\n        // Snap implode. scale -> 0 + alpha -> 0 together, snappy ease-in\n        // so the symbol collapses into the cell centre and is gone.\n        .to(view.scale, { x: 0, y: 0, duration: 0.14, ease: 'power3.in' }, '<+=0.04')\n        .to(view, { alpha: 0, duration: 0.14, ease: 'power3.in' }, '<');\n\n      const onAbort = (): void => {\n        tl.kill();\n        snapDestroyed();\n        resolve();\n      };\n      if (signal) signal.addEventListener('abort', onAbort, { once: true });\n    });\n\n    // Restore transform. alpha stays 0 (the symbol IS destroyed). Scale\n    // restored to 1 so pool reuse via `_replaceSymbol`'s same-id fast path\n    // doesn't inherit a stale 0× scale; _replaceSymbol also resets scale\n    // explicitly but a defensive restore here makes the destroyed cell\n    // observably \"ready to be re-skinned\" between calls.\n    view.pivot.set(originalPivotX, originalPivotY);\n    view.x = originalX;\n    view.y = originalY;\n    view.scale.set(1, 1);\n  }\n\n  /**\n   * Animate this symbol AWAY, without destroying it.\n   *\n   * The counterpart to {@link playIn}, and the seam a mystery reveal needs:\n   * the cells on screen dissolve, their identities are swapped underneath, and\n   * the new ones arrive. `playDestroy` is the cascade's version of the same\n   * beat and is deliberately separate - it is tuned as a \"this cell was a\n   * winner and is being consumed\" poof, and a reveal is not that.\n   *\n   * Leaves the view hidden (`alpha: 0`) with its transform restored, so the\n   * caller may swap the identity and call `playIn` next.\n   *\n   * Override for art-appropriate exits - a Spine symbol plays its own `out`\n   * track here. Honour `opts.signal`: abort means \"snap to the end\", not\n   * \"fail\", so the promise still resolves.\n   *\n   * Default: a ~180 ms shrink-and-fade with no overshoot, centred on the\n   * symbol's bounds rather than the view origin.\n   */\n  async playOut(opts?: { delay?: number; signal?: AbortSignal }): Promise<void> {\n    await this._tweenPresence('out', opts);\n  }\n\n  /**\n   * Animate this symbol IN, from nothing to its resting pose.\n   *\n   * Owns its own start pose. A symbol that has just been re-activated is fully\n   * visible (`activate()` resets alpha and scale), so an entrance that assumed\n   * it started hidden would pop before it animated. This sets the hidden pose\n   * first, then plays.\n   *\n   * Override for art-appropriate entrances - a Spine symbol plays its own `in`\n   * track here. Honour `opts.signal`: abort snaps to the RESTING pose (alpha 1,\n   * scale 1), because arriving is what the caller asked for.\n   *\n   * Default: a ~200 ms fade and scale-up with a small overshoot.\n   */\n  async playIn(opts?: { delay?: number; signal?: AbortSignal }): Promise<void> {\n    await this._tweenPresence('in', opts);\n  }\n\n  /**\n   * Shared body of {@link playIn} / {@link playOut}.\n   *\n   * One function because the two are the same tween read in opposite\n   * directions, and because the fiddly part - pivoting to the visual centre so\n   * the scale does not collapse toward the view's (0, 0) corner, and\n   * compensating the position for the pivot move - is identical and easy to get\n   * subtly wrong twice. Same correction as `playDestroy`: a container renders a\n   * local point at `position + (point - pivot) * scale`, so a curved reel (which\n   * scales every cell) would make the symbol jump without the `* scale` term.\n   */\n  private async _tweenPresence(\n    direction: 'in' | 'out',\n    opts?: { delay?: number; signal?: AbortSignal },\n  ): Promise<void> {\n    const view = this.view;\n    const originalPivotX = view.pivot.x;\n    const originalPivotY = view.pivot.y;\n    const originalX = view.x;\n    const originalY = view.y;\n\n    const bounds = view.getLocalBounds();\n    const cx = bounds.x + bounds.width / 2;\n    const cy = bounds.y + bounds.height / 2;\n    view.pivot.set(cx, cy);\n    view.x = originalX + (cx - originalPivotX) * view.scale.x;\n    view.y = originalY + (cy - originalPivotY) * view.scale.y;\n\n    const restorePivot = (): void => {\n      view.pivot.set(originalPivotX, originalPivotY);\n      view.x = originalX;\n      view.y = originalY;\n    };\n    const snapEnd = (): void => {\n      if (direction === 'out') {\n        view.alpha = 0;\n        view.scale.set(1, 1);\n      } else {\n        view.visible = true;\n        view.alpha = 1;\n        view.scale.set(1, 1);\n      }\n    };\n\n    const delay = opts?.delay ?? 0;\n    const signal = opts?.signal;\n\n    if (direction === 'in') {\n      // Own the start pose: `activate()` leaves a freshly swapped symbol fully\n      // visible, so without this the new art is on screen for a frame before\n      // the entrance begins.\n      view.visible = true;\n      view.alpha = 0;\n      view.scale.set(0.72, 0.72);\n    }\n\n    if (signal?.aborted) {\n      snapEnd();\n      restorePivot();\n      return;\n    }\n\n    await new Promise<void>((resolve) => {\n      const onAbort = (): void => {\n        tl.kill();\n        snapEnd();\n        resolve();\n      };\n      const tl = this.gsap.timeline({\n        delay,\n        onComplete: () => {\n          if (signal) signal.removeEventListener('abort', onAbort);\n          resolve();\n        },\n      });\n      if (direction === 'out') {\n        tl.to(view.scale, { x: 0.72, y: 0.72, duration: 0.18, ease: 'power2.in' }).to(\n          view,\n          { alpha: 0, duration: 0.18, ease: 'power2.in' },\n          '<',\n        );\n      } else {\n        tl.to(view.scale, { x: 1, y: 1, duration: 0.2, ease: 'back.out(1.7)' }).to(\n          view,\n          { alpha: 1, duration: 0.16, ease: 'power2.out' },\n          '<',\n        );\n      }\n      if (signal) signal.addEventListener('abort', onAbort, { once: true });\n    });\n\n    // Scale back to 1 either way: a hidden symbol still has to be a legal\n    // resting pose, or pool reuse inherits the shrunken scale.\n    view.scale.set(1, 1);\n    restorePivot();\n  }\n\n  /**\n   * The owning reel is curved: render into this projected quad instead of the\n   * flat cell rectangle. `null` means the reel is flat again.\n   *\n   * The quad's corners are SCREEN-space and local to this view's own origin,\n   * clockwise from top-left, and `width` / `height` give the flat cell box the\n   * quad replaces. Called on every frame of motion and on every placement, so\n   * it must be cheap and idempotent.\n   *\n   * **The default is an approximation.** A `Container` transform is affine, so\n   * it cannot express a trapezoid; the base class fits the quad as closely as\n   * an affine transform can - a UNIFORM scale about the quad's centre. Uniform\n   * on purpose: symbol art is usually smaller than its cell and has a shape a\n   * player recognises, and squashing one axis turns a `7` into a squashed `7`\n   * rather than a `7` seen at an angle.\n   *\n   * Override this to render the real perspective. {@link SpriteSymbol} and\n   * {@link AnimatedSpriteSymbol} do, by drawing their texture through a\n   * `PerspectiveMesh`, which costs no extra render pass because the content is\n   * already a texture. A symbol whose content is an arbitrary subtree (Spine, a\n   * composite of sprites and text) cannot do that without rendering itself to a\n   * texture every frame, so it keeps the affine fit.\n   *\n   * Whatever you do here, do NOT move `view.position`: the reel reads that\n   * coordinate back to work out which slot this symbol is in.\n   */\n  /**\n   * The part of its cell this symbol's art actually covers, or `null` (the\n   * default) for \"all of it\".\n   *\n   * Slot art is usually smaller than its cell - a trimmed atlas frame is a\n   * shape floating in a much bigger transparent box - and the reel needs to\n   * know that to project the rectangle the art is really in. Overriding this\n   * is what stops a small symbol being inflated to the cell's edges and given\n   * the cell's keystone instead of its own, milder one.\n   *\n   * Read once per projection, so it may change with the symbol's identity.\n   */\n  get cellInset(): ReelCellInset | null {\n    return null;\n  }\n\n  applyCellQuad(quad: ReelCellQuad | null): void {\n    const view = this.view;\n    if (quad === null) {\n      view.scale.set(1, 1);\n      view.pivot.set(0, 0);\n      return;\n    }\n    // Measure the trapezoid: the mean of its two parallel edges, and the\n    // distance between their midpoints.\n    const nearWidth = Math.hypot(quad.x1 - quad.x0, quad.y1 - quad.y0);\n    const farWidth = Math.hypot(quad.x2 - quad.x3, quad.y2 - quad.y3);\n    const across = (nearWidth + farWidth) / 2;\n    const along = Math.hypot(\n      (quad.x3 + quad.x2) / 2 - (quad.x0 + quad.x1) / 2,\n      (quad.y3 + quad.y2) / 2 - (quad.y0 + quad.y1) / 2,\n    );\n    // CONTAIN, not cover. A quad in the middle of the window is TALLER than\n    // the flat cell (that is the drum magnifying what faces you), so a scale\n    // picked to fill it would also make the symbol wider than its column and\n    // overlap its neighbours - very visible on art that fills its cell\n    // edge-to-edge. Taking the smaller ratio keeps every symbol inside its own\n    // projected footprint at the cost of a little slack on one axis.\n    const scale =\n      quad.width > 0 && quad.height > 0\n        ? Math.min(across / quad.width, along / quad.height)\n        : 1;\n\n    const cx = (quad.x0 + quad.x1 + quad.x2 + quad.x3) / 4;\n    const cy = (quad.y0 + quad.y1 + quad.y2 + quad.y3) / 4;\n    view.scale.set(scale, scale);\n    // A container renders a local point at `position + (point - pivot) * scale`\n    // and `position` must not move, so putting the flat box's centre on the\n    // quad's centre has to be paid for entirely out of the pivot.\n    view.pivot.set(\n      quad.x + quad.width / 2 - cx / scale,\n      quad.y + quad.height / 2 - cy / scale,\n    );\n  }\n\n  /**\n   * Lifecycle hook: the owning reel is spinning.\n   * Default: no-op. Override (e.g. SpineReelSymbol.autoPlayBlur,\n   * StaticSpinSymbol) to swap to a spin presentation automatically.\n   *\n   * Fired on every strip symbol (visible AND buffer cells) when the reel\n   * enters the spin phase, and again with `joinedMidSpin: true` on each\n   * symbol freshly installed while the reel is already spinning (pool\n   * recycling wipes symbol state, so a wrapped-in symbol can't know the\n   * reel is moving without this). Implementations MUST be idempotent.\n   * the same instance can be notified more than once per spin.\n   *\n   * @param joinedMidSpin true when this symbol was installed into a reel\n   * already at speed (skip start-of-spin transitions like blur ramps).\n   */\n  onReelSpinStart(joinedMidSpin?: boolean): 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 entered its anticipation (tease) phase.\n   * it is still spinning, but slowed enough that the strip is readable.\n   * Spin presentations that obscure symbols (blur textures, smear\n   * animations) should relax so the player can follow the tease. Also\n   * fired on symbols installed while the reel is anticipating.\n   * Implementations MUST be idempotent. Default: no-op.\n   */\n  onReelAnticipationStart(): 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"],"mappings":"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"}

package/dist/{SpineSymbol-tPguh5gN.js → SpineSymbol-BL7iDOZj.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./ReelSymbol-JASIxGy4.js";
+import { t as e } from "./ReelSymbol-D698guvK.js";
 //#region src/symbols/SpineSymbol.ts
 var t = null, n = (async () => {
 	try {
@@ -67,4 +67,4 @@ var i = class extends e {
 //#endregion
 export { r as n, i as t };
 
-//# sourceMappingURL=SpineSymbol-tPguh5gN.js.map
+//# sourceMappingURL=SpineSymbol-BL7iDOZj.js.map

package/dist/{SpineSymbol-tPguh5gN.js.map → SpineSymbol-BL7iDOZj.js.map}

@@ -1 +1 @@
-{"version":3,"file":"SpineSymbol-tPguh5gN.js","names":[],"sources":["../src/symbols/SpineSymbol.ts"],"sourcesContent":["import { ReelSymbol } from './ReelSymbol.js';\n\n// Spine types imported dynamically. this is an optional peer dependency\nlet SpineClass: any = null;\n\n// Kick off the optional import at module init and keep the promise so callers\n// can wait for it. Without this, constructing a SpineSymbol on a cold start\n// (before the dynamic import resolves) throws the \"not installed\" error even\n// when Spine IS installed - it just hadn't finished loading yet.\nconst spineReady: Promise<void> = (async () => {\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/**\n * Resolves once the optional `@esotericsoftware/spine-pixi-v8` import has\n * settled (whether or not it was installed). Await this before constructing\n * `SpineSymbol`s if you build the reel set immediately on app start, so a cold\n * load can't throw the misleading \"not installed\" error.\n */\nexport function whenSpineReady(): Promise<void> {\n  return spineReady;\n}\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   * Fail loud on unmapped animations. When `true`, activating or winning with\n   * a configured animation name that the skeleton doesn't define throws instead\n   * of silently showing nothing (catches typos like `ide` vs `idle`). Default\n   * `false` to preserve the lenient behavior. See ADR 011.\n   */\n  strict?: boolean;\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  private _strict: boolean;\n\n  constructor(options: SpineSymbolOptions) {\n    super();\n    if (!SpineClass) {\n      throw new Error(\n        'SpineSymbol could not use @esotericsoftware/spine-pixi-v8. Either it is ' +\n        'not installed (npm install @esotericsoftware/spine-pixi-v8), or its ' +\n        'dynamic import has not resolved yet on a cold start — await ' +\n        'whenSpineReady() before constructing SpineSymbols.',\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    this._strict = options.strict ?? false;\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    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    } else if (this._strict) {\n      throw new Error(\n        `SpineSymbol(strict): idle animation '${this._idleAnimation}' not found ` +\n        `on skeleton '${symbolId}'.`,\n      );\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.state.clearTracks();\n    }\n    // Settle any pending playWin so awaiters don't hang when the symbol is\n    // recycled mid-animation. Mirrors the same fix in SpineReelSymbol.\n    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n\n  async playWin(): Promise<void> {\n    if (!this._spine) return;\n    if (!this._spine.skeleton.data.findAnimation(this._winAnimation)) {\n      if (this._strict) {\n        throw new Error(\n          `SpineSymbol(strict): win animation '${this._winAnimation}' not found ` +\n          `on skeleton '${this._currentSkeletonKey}'.`,\n        );\n      }\n      return;\n    }\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            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    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"SpineSymbol-BL7iDOZj.js","names":[],"sources":["../src/symbols/SpineSymbol.ts"],"sourcesContent":["import { ReelSymbol } from './ReelSymbol.js';\n\n// Spine types imported dynamically. this is an optional peer dependency\nlet SpineClass: any = null;\n\n// Kick off the optional import at module init and keep the promise so callers\n// can wait for it. Without this, constructing a SpineSymbol on a cold start\n// (before the dynamic import resolves) throws the \"not installed\" error even\n// when Spine IS installed - it just hadn't finished loading yet.\nconst spineReady: Promise<void> = (async () => {\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/**\n * Resolves once the optional `@esotericsoftware/spine-pixi-v8` import has\n * settled (whether or not it was installed). Await this before constructing\n * `SpineSymbol`s if you build the reel set immediately on app start, so a cold\n * load can't throw the misleading \"not installed\" error.\n */\nexport function whenSpineReady(): Promise<void> {\n  return spineReady;\n}\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   * Fail loud on unmapped animations. When `true`, activating or winning with\n   * a configured animation name that the skeleton doesn't define throws instead\n   * of silently showing nothing (catches typos like `ide` vs `idle`). Default\n   * `false` to preserve the lenient behavior. See ADR 011.\n   */\n  strict?: boolean;\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  private _strict: boolean;\n\n  constructor(options: SpineSymbolOptions) {\n    super();\n    if (!SpineClass) {\n      throw new Error(\n        'SpineSymbol could not use @esotericsoftware/spine-pixi-v8. Either it is ' +\n        'not installed (npm install @esotericsoftware/spine-pixi-v8), or its ' +\n        'dynamic import has not resolved yet on a cold start — await ' +\n        'whenSpineReady() before constructing SpineSymbols.',\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    this._strict = options.strict ?? false;\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    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    } else if (this._strict) {\n      throw new Error(\n        `SpineSymbol(strict): idle animation '${this._idleAnimation}' not found ` +\n        `on skeleton '${symbolId}'.`,\n      );\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.state.clearTracks();\n    }\n    // Settle any pending playWin so awaiters don't hang when the symbol is\n    // recycled mid-animation. Mirrors the same fix in SpineReelSymbol.\n    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n\n  async playWin(): Promise<void> {\n    if (!this._spine) return;\n    if (!this._spine.skeleton.data.findAnimation(this._winAnimation)) {\n      if (this._strict) {\n        throw new Error(\n          `SpineSymbol(strict): win animation '${this._winAnimation}' not found ` +\n          `on skeleton '${this._currentSkeletonKey}'.`,\n        );\n      }\n      return;\n    }\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            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    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/{SpineSymbol-C4hNDBWZ.cjs → SpineSymbol-Dq3IAu_k.cjs}

@@ -1,2 +1,2 @@
-const e=require(`./ReelSymbol-BG8mBj2i.cjs`);var t=null,n=(async()=>{try{t=(await import(`@esotericsoftware/spine-pixi-v8`)).Spine}catch{}})();function r(){return n}var i=class extends e.t{_spine=null;_skeletonDataMap;_idleAnimation;_winAnimation;_defaultSkin;_winResolve=null;_currentSkeletonKey=``;_strict;constructor(e){if(super(),!t)throw Error(`SpineSymbol could not use @esotericsoftware/spine-pixi-v8. Either it is not installed (npm install @esotericsoftware/spine-pixi-v8), or its dynamic import has not resolved yet on a cold start — await whenSpineReady() before constructing SpineSymbols.`);this._skeletonDataMap=e.skeletonDataMap,this._idleAnimation=e.idleAnimation??`idle`,this._winAnimation=e.winAnimation??`win`,this._defaultSkin=e.defaultSkin??`default`,this._strict=e.strict??!1}onActivate(e){let n=this._skeletonDataMap[e];if(n){if(this._currentSkeletonKey!==e&&(this._spine&&(this.view.removeChild(this._spine),this._spine.destroy()),this._spine=new t({skeletonData:n}),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);else if(this._strict)throw Error(`SpineSymbol(strict): idle animation '${this._idleAnimation}' not found on skeleton '${e}'.`)}}onDeactivate(){if(this._spine&&(this._spine.state.clearListeners(),this._spine.state.clearTracks()),this._winResolve){let e=this._winResolve;this._winResolve=null,e()}}async playWin(){if(this._spine){if(!this._spine.skeleton.data.findAnimation(this._winAnimation)){if(this._strict)throw Error(`SpineSymbol(strict): win animation '${this._winAnimation}' not found on skeleton '${this._currentSkeletonKey}'.`);return}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(){if(this._spine&&=(this._spine.state.clearListeners(),this._spine.destroy(),null),this._winResolve){let e=this._winResolve;this._winResolve=null,e()}}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});
-//# sourceMappingURL=SpineSymbol-C4hNDBWZ.cjs.map
+const e=require(`./ReelSymbol-DjJzuBhn.cjs`);var t=null,n=(async()=>{try{t=(await import(`@esotericsoftware/spine-pixi-v8`)).Spine}catch{}})();function r(){return n}var i=class extends e.t{_spine=null;_skeletonDataMap;_idleAnimation;_winAnimation;_defaultSkin;_winResolve=null;_currentSkeletonKey=``;_strict;constructor(e){if(super(),!t)throw Error(`SpineSymbol could not use @esotericsoftware/spine-pixi-v8. Either it is not installed (npm install @esotericsoftware/spine-pixi-v8), or its dynamic import has not resolved yet on a cold start — await whenSpineReady() before constructing SpineSymbols.`);this._skeletonDataMap=e.skeletonDataMap,this._idleAnimation=e.idleAnimation??`idle`,this._winAnimation=e.winAnimation??`win`,this._defaultSkin=e.defaultSkin??`default`,this._strict=e.strict??!1}onActivate(e){let n=this._skeletonDataMap[e];if(n){if(this._currentSkeletonKey!==e&&(this._spine&&(this.view.removeChild(this._spine),this._spine.destroy()),this._spine=new t({skeletonData:n}),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);else if(this._strict)throw Error(`SpineSymbol(strict): idle animation '${this._idleAnimation}' not found on skeleton '${e}'.`)}}onDeactivate(){if(this._spine&&(this._spine.state.clearListeners(),this._spine.state.clearTracks()),this._winResolve){let e=this._winResolve;this._winResolve=null,e()}}async playWin(){if(this._spine){if(!this._spine.skeleton.data.findAnimation(this._winAnimation)){if(this._strict)throw Error(`SpineSymbol(strict): win animation '${this._winAnimation}' not found on skeleton '${this._currentSkeletonKey}'.`);return}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(){if(this._spine&&=(this._spine.state.clearListeners(),this._spine.destroy(),null),this._winResolve){let e=this._winResolve;this._winResolve=null,e()}}};Object.defineProperty(exports,`n`,{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,`t`,{enumerable:!0,get:function(){return i}});
+//# sourceMappingURL=SpineSymbol-Dq3IAu_k.cjs.map

package/dist/{SpineSymbol-C4hNDBWZ.cjs.map → SpineSymbol-Dq3IAu_k.cjs.map}

@@ -1 +1 @@
-{"version":3,"file":"SpineSymbol-C4hNDBWZ.cjs","names":[],"sources":["../src/symbols/SpineSymbol.ts"],"sourcesContent":["import { ReelSymbol } from './ReelSymbol.js';\n\n// Spine types imported dynamically. this is an optional peer dependency\nlet SpineClass: any = null;\n\n// Kick off the optional import at module init and keep the promise so callers\n// can wait for it. Without this, constructing a SpineSymbol on a cold start\n// (before the dynamic import resolves) throws the \"not installed\" error even\n// when Spine IS installed - it just hadn't finished loading yet.\nconst spineReady: Promise<void> = (async () => {\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/**\n * Resolves once the optional `@esotericsoftware/spine-pixi-v8` import has\n * settled (whether or not it was installed). Await this before constructing\n * `SpineSymbol`s if you build the reel set immediately on app start, so a cold\n * load can't throw the misleading \"not installed\" error.\n */\nexport function whenSpineReady(): Promise<void> {\n  return spineReady;\n}\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   * Fail loud on unmapped animations. When `true`, activating or winning with\n   * a configured animation name that the skeleton doesn't define throws instead\n   * of silently showing nothing (catches typos like `ide` vs `idle`). Default\n   * `false` to preserve the lenient behavior. See ADR 011.\n   */\n  strict?: boolean;\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  private _strict: boolean;\n\n  constructor(options: SpineSymbolOptions) {\n    super();\n    if (!SpineClass) {\n      throw new Error(\n        'SpineSymbol could not use @esotericsoftware/spine-pixi-v8. Either it is ' +\n        'not installed (npm install @esotericsoftware/spine-pixi-v8), or its ' +\n        'dynamic import has not resolved yet on a cold start — await ' +\n        'whenSpineReady() before constructing SpineSymbols.',\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    this._strict = options.strict ?? false;\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    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    } else if (this._strict) {\n      throw new Error(\n        `SpineSymbol(strict): idle animation '${this._idleAnimation}' not found ` +\n        `on skeleton '${symbolId}'.`,\n      );\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.state.clearTracks();\n    }\n    // Settle any pending playWin so awaiters don't hang when the symbol is\n    // recycled mid-animation. Mirrors the same fix in SpineReelSymbol.\n    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n\n  async playWin(): Promise<void> {\n    if (!this._spine) return;\n    if (!this._spine.skeleton.data.findAnimation(this._winAnimation)) {\n      if (this._strict) {\n        throw new Error(\n          `SpineSymbol(strict): win animation '${this._winAnimation}' not found ` +\n          `on skeleton '${this._currentSkeletonKey}'.`,\n        );\n      }\n      return;\n    }\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            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    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n}\n"],"mappings":"6CAGA,IAAI,EAAkB,KAMhB,GAA6B,SAAY,CAC7C,GAAI,CAEF,GADoB,MAAM,OAAO,oCACR,WACnB,MAGN,CAQJ,SAAgB,GAAgC,CAC9C,OAAO,EA2BT,IAAa,EAAb,cAAiC,EAAA,CAAW,CAC1C,OAAsB,KACtB,iBACA,eACA,cACA,aACA,YAA2C,KAC3C,oBAAsC,GACtC,QAEA,YAAY,EAA6B,CAEvC,GADA,OAAO,CACH,CAAC,EACH,MAAU,MACR,6PAID,CAEH,KAAK,iBAAmB,EAAQ,gBAChC,KAAK,eAAiB,EAAQ,eAAiB,OAC/C,KAAK,cAAgB,EAAQ,cAAgB,MAC7C,KAAK,aAAe,EAAQ,aAAe,UAC3C,KAAK,QAAU,EAAQ,QAAU,GAGnC,WAAqB,EAAwB,CAC3C,IAAM,EAAe,KAAK,iBAAiB,GACtC,KAiBL,IAdI,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,GAGzB,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,CAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,SACnD,KAAK,QACd,MAAU,MACR,wCAAwC,KAAK,eAAe,2BAC5C,EAAS,IAC1B,EAIL,cAA+B,CAO7B,GANI,KAAK,SACP,KAAK,OAAO,MAAM,gBAAgB,CAClC,KAAK,OAAO,MAAM,aAAa,EAI7B,KAAK,YAAa,CACpB,IAAM,EAAI,KAAK,YACf,KAAK,YAAc,KACnB,GAAG,EAIP,MAAM,SAAyB,CACxB,QAAK,OACV,IAAI,CAAC,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,cAAc,CAAE,CAChE,GAAI,KAAK,QACP,MAAU,MACR,uCAAuC,KAAK,cAAc,2BAC1C,KAAK,oBAAoB,IAC1C,CAEH,OAGF,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,CAC9B,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,EAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,CAE9D,KAAK,YAAc,KACnB,GAAS,GAGd,CAAC,EACF,EAGJ,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,CAMnC,GALA,AAGE,KAAK,UAFL,KAAK,OAAO,MAAM,gBAAgB,CAClC,KAAK,OAAO,SAAS,CACP,MAEZ,KAAK,YAAa,CACpB,IAAM,EAAI,KAAK,YACf,KAAK,YAAc,KACnB,GAAG"}
+{"version":3,"file":"SpineSymbol-Dq3IAu_k.cjs","names":[],"sources":["../src/symbols/SpineSymbol.ts"],"sourcesContent":["import { ReelSymbol } from './ReelSymbol.js';\n\n// Spine types imported dynamically. this is an optional peer dependency\nlet SpineClass: any = null;\n\n// Kick off the optional import at module init and keep the promise so callers\n// can wait for it. Without this, constructing a SpineSymbol on a cold start\n// (before the dynamic import resolves) throws the \"not installed\" error even\n// when Spine IS installed - it just hadn't finished loading yet.\nconst spineReady: Promise<void> = (async () => {\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/**\n * Resolves once the optional `@esotericsoftware/spine-pixi-v8` import has\n * settled (whether or not it was installed). Await this before constructing\n * `SpineSymbol`s if you build the reel set immediately on app start, so a cold\n * load can't throw the misleading \"not installed\" error.\n */\nexport function whenSpineReady(): Promise<void> {\n  return spineReady;\n}\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   * Fail loud on unmapped animations. When `true`, activating or winning with\n   * a configured animation name that the skeleton doesn't define throws instead\n   * of silently showing nothing (catches typos like `ide` vs `idle`). Default\n   * `false` to preserve the lenient behavior. See ADR 011.\n   */\n  strict?: boolean;\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  private _strict: boolean;\n\n  constructor(options: SpineSymbolOptions) {\n    super();\n    if (!SpineClass) {\n      throw new Error(\n        'SpineSymbol could not use @esotericsoftware/spine-pixi-v8. Either it is ' +\n        'not installed (npm install @esotericsoftware/spine-pixi-v8), or its ' +\n        'dynamic import has not resolved yet on a cold start — await ' +\n        'whenSpineReady() before constructing SpineSymbols.',\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    this._strict = options.strict ?? false;\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    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    } else if (this._strict) {\n      throw new Error(\n        `SpineSymbol(strict): idle animation '${this._idleAnimation}' not found ` +\n        `on skeleton '${symbolId}'.`,\n      );\n    }\n  }\n\n  protected onDeactivate(): void {\n    if (this._spine) {\n      this._spine.state.clearListeners();\n      this._spine.state.clearTracks();\n    }\n    // Settle any pending playWin so awaiters don't hang when the symbol is\n    // recycled mid-animation. Mirrors the same fix in SpineReelSymbol.\n    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n\n  async playWin(): Promise<void> {\n    if (!this._spine) return;\n    if (!this._spine.skeleton.data.findAnimation(this._winAnimation)) {\n      if (this._strict) {\n        throw new Error(\n          `SpineSymbol(strict): win animation '${this._winAnimation}' not found ` +\n          `on skeleton '${this._currentSkeletonKey}'.`,\n        );\n      }\n      return;\n    }\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            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    if (this._winResolve) {\n      const r = this._winResolve;\n      this._winResolve = null;\n      r();\n    }\n  }\n}\n"],"mappings":"6CAGA,IAAI,EAAkB,KAMhB,GAA6B,SAAY,CAC7C,GAAI,CAEF,GADoB,MAAM,OAAO,oCACR,WACnB,MAGN,CAQJ,SAAgB,GAAgC,CAC9C,OAAO,EA2BT,IAAa,EAAb,cAAiC,EAAA,CAAW,CAC1C,OAAsB,KACtB,iBACA,eACA,cACA,aACA,YAA2C,KAC3C,oBAAsC,GACtC,QAEA,YAAY,EAA6B,CAEvC,GADA,OAAO,CACH,CAAC,EACH,MAAU,MACR,6PAID,CAEH,KAAK,iBAAmB,EAAQ,gBAChC,KAAK,eAAiB,EAAQ,eAAiB,OAC/C,KAAK,cAAgB,EAAQ,cAAgB,MAC7C,KAAK,aAAe,EAAQ,aAAe,UAC3C,KAAK,QAAU,EAAQ,QAAU,GAGnC,WAAqB,EAAwB,CAC3C,IAAM,EAAe,KAAK,iBAAiB,GACtC,KAiBL,IAdI,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,GAGzB,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,CAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,SACnD,KAAK,QACd,MAAU,MACR,wCAAwC,KAAK,eAAe,2BAC5C,EAAS,IAC1B,EAIL,cAA+B,CAO7B,GANI,KAAK,SACP,KAAK,OAAO,MAAM,gBAAgB,CAClC,KAAK,OAAO,MAAM,aAAa,EAI7B,KAAK,YAAa,CACpB,IAAM,EAAI,KAAK,YACf,KAAK,YAAc,KACnB,GAAG,EAIP,MAAM,SAAyB,CACxB,QAAK,OACV,IAAI,CAAC,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,cAAc,CAAE,CAChE,GAAI,KAAK,QACP,MAAU,MACR,uCAAuC,KAAK,cAAc,2BAC1C,KAAK,oBAAoB,IAC1C,CAEH,OAGF,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,CAC9B,KAAK,OAAO,SAAS,KAAK,cAAc,KAAK,eAAe,EAC9D,KAAK,OAAO,MAAM,aAAa,EAAG,KAAK,eAAgB,GAAK,CAE9D,KAAK,YAAc,KACnB,GAAS,GAGd,CAAC,EACF,EAGJ,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,CAMnC,GALA,AAGE,KAAK,UAFL,KAAK,OAAO,MAAM,gBAAgB,CAClC,KAAK,OAAO,SAAS,CACP,MAEZ,KAAK,YAAa,CACpB,IAAM,EAAI,KAAK,YACf,KAAK,YAAc,KACnB,GAAG"}

package/dist/board/BoardGrid.d.ts

@@ -1,6 +1,8 @@
 import { Container, Graphics, Ticker } from 'pixi.js';
 import { Direction, Orientation } from '../core/ReelAxis.js';
 import { ReelSet } from '../core/ReelSet.js';
+import { MaskStrategy } from '../core/ReelViewport.js';
+import { MaskCorners } from '../core/maskStrategies.js';
 import { ReelSymbol } from '../symbols/ReelSymbol.js';
 import { SymbolRegistry } from '../symbols/SymbolRegistry.js';
 import { SpeedProfile, SymbolData } from '../config/types.js';
@@ -15,16 +17,35 @@ export interface BoardSpinTarget {
     cell: BoardCell;
     id: string;
 }
+/** What a cell-mask factory is told about the cell it builds for. */
+export interface BoardCellMaskInfo {
+    cols: number;
+    rows: number;
+    /**
+     * The BOARD corners this cell sits on: `{ topLeft: true }` and the rest
+     * `false` for cell `(0, 0)`, all `false` for an inner cell. Hand it to
+     * `RoundedRectMaskStrategy` as `corners` and the board reads as one rounded
+     * window built from one rect per cell.
+     */
+    corners: MaskCorners;
+}
 /** A speed profile, or a per-cell function of one (e.g. a stagger wave). */
 export type BoardProfile = SpeedProfile | ((cell: BoardCell) => SpeedProfile);
 export interface BoardGridOptions {
     /** Grid dimensions. */
     cols: number;
     rows: number;
-    /** Cell edge length in pixels. */
-    cellSize: number;
-    /** Gap between cells. Default 4. */
+    /** Cell size in pixels: one number for square cells, or `{ width, height }`. */
+    cellSize: number | {
+        width: number;
+        height: number;
+    };
+    /** Gap between cells on both axes. Default 4. */
     gap?: number;
+    /** Horizontal gap between columns. Falls back to `gap`. */
+    columnGap?: number;
+    /** Vertical gap between rows. Falls back to `gap`. */
+    rowGap?: number;
     /** Id a cell shows when blank - also placed in the off-window buffers. Default `'empty'`. */
     emptyId?: string;
     /** Register symbol classes, exactly like `ReelSetBuilder.symbols`. Applied to every cell. */
@@ -37,8 +58,22 @@ export interface BoardGridOptions {
     rng?: () => number;
     /** Drives every cell's reel - required. */
     ticker: Ticker;
-    /** Per-cell background, drawn behind each reel. */
-    chrome?: (g: Graphics, size: number) => void;
+    /**
+     * Per-cell background, drawn behind each reel, handed the cell's width and
+     * height. A square-board callback that only reads the first size argument
+     * keeps working unchanged.
+     */
+    chrome?: (g: Graphics, width: number, height: number) => void;
+    /**
+     * Mask for each cell, built once per cell (every cell is its own reel set
+     * and owns its mask). Default: a shared rect over the cell. Hand it
+     * `() => new RoundedRectMaskStrategy({ radius })` for cells whose art and
+     * frame have rounded corners. The factory is told which cell it builds for
+     * and which board corners that cell sits on, so
+     * `(_, { corners }) => new RoundedRectMaskStrategy({ radius, corners })`
+     * rounds only the board's outer corners and keeps every other cell square.
+     */
+    mask?: (cell: BoardCell, info: BoardCellMaskInfo) => MaskStrategy;
     /**
      * Which way each cell's own strip travels while it spins. Every cell is a
      * 1x1 reel set, so this changes the direction a symbol scrolls in from, not
@@ -71,7 +106,7 @@ export interface BoardGridOptions {
  *
  * ```ts
  * const grid = new BoardGrid({
- *   cols: 3, rows: 3, cellSize: 80,
+ *   cols: 3, rows: 3, cellSize: { width: 100, height: 84 }, columnGap: 6, rowGap: 0,
  *   symbols: (r) => r.register('prize', PrizeSymbol, {}),
  *   weights: { prize: 1, empty: 4 },
  *   ticker: app.ticker,
@@ -88,13 +123,36 @@ export declare class BoardGrid implements Disposable {
     readonly container: Container;
     readonly cols: number;
     readonly rows: number;
-    readonly cellSize: number;
-    readonly gap: number;
+    readonly cellWidth: number;
+    readonly cellHeight: number;
+    readonly columnGap: number;
+    readonly rowGap: number;
     readonly emptyId: string;
     private readonly _reels;
     private readonly _cells;
+    /**
+     * Every cell's `viewport.unmaskedContainer`, rendered here - above ALL
+     * cells - instead of inside its own reel set. Each cell is its own display
+     * subtree, so a symbol the engine lifts above its cell's mask (`unmask:
+     * true`, at rest) would otherwise still sit below every later cell's
+     * chrome and blank symbol, and art that overflows the cell is cut along
+     * the neighbour's edge.
+     */
+    private readonly _lifted;
     private _destroyed;
     constructor(opts: BoardGridOptions);
+    /**
+     * Cell edge length. Only meaningful on a square board; a rectangular board
+     * reports its width here.
+     * @deprecated Read {@link cellWidth} / {@link cellHeight}.
+     */
+    get cellSize(): number;
+    /**
+     * Gap between cells. Only meaningful when both gaps agree; otherwise this is
+     * the column gap.
+     * @deprecated Read {@link columnGap} / {@link rowGap}.
+     */
+    get gap(): number;
     /** Every cell coordinate, reel-major: (0,0), (0,1), ... then (1,0). */
     cells(): BoardCell[];
     /** Board-local bounds of a cell. `container.toGlobal` for stage space. */

package/dist/board/BoardGrid.d.ts.map

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

package/dist/board/HoldAndWinBoard.d.ts

@@ -5,28 +5,41 @@ import { ReelSymbol } from '../symbols/ReelSymbol.js';
 import { SymbolRegistry } from '../symbols/SymbolRegistry.js';
 import { SpeedProfile, SymbolData } from '../config/types.js';
 import { Disposable } from '../utils/Disposable.js';
+import { BoardCellMaskInfo } from './BoardGrid.js';
 import { Direction, Orientation } from '../core/ReelAxis.js';
+import { MaskStrategy } from '../core/ReelViewport.js';
 import { HwPhase } from './HoldAndWinState.js';
-import { HoldAndWinBoardEvents, HwCell, HwCoin, HwRespinResult } from './HwTypes.js';
+import { HoldAndWinBoardEvents, HwCell, HwCoin, HwLockAnimation, HwRespinResult } from './HwTypes.js';
 /** Internal config produced by {@link HoldAndWinBuilder.build}. */
 export interface HoldAndWinBoardConfig<TData> {
     cols: number;
     rows: number;
-    cell: number;
-    gap: number;
+    cellWidth: number;
+    cellHeight: number;
+    columnGap: number;
+    rowGap: number;
     emptyId: string;
+    /** Cells built dormant; see `HoldAndWinBuilder.inactive`. */
+    inactive: HwCell[];
+    /** Symbol shown on a dormant cell. */
+    inactiveId: string;
     respins: number;
+    lockAnimation: HwLockAnimation;
     configurator: (registry: SymbolRegistry) => void;
     weights: Record<string, number> | null;
     symbolData: Record<string, Partial<SymbolData>> | null;
-    baseProfile: SpeedProfile;
-    stagger: (reel: number, cell: number) => number;
+    /** Named base profiles, registered into every cell. See `HoldAndWinBuilder.speeds`. */
+    speeds: Record<string, SpeedProfile>;
+    initialSpeed: string;
+    stagger: (reel: number, cell: number, speed: string) => number;
     anticipateWhen: ((state: {
         locked: number;
         capacity: number;
         respinsLeft: number;
     }) => boolean) | null;
-    chrome: ((g: Graphics, size: number) => void) | null;
+    chrome: ((g: Graphics, width: number, height: number) => void) | null;
+    /** Per-cell mask factory. See `HoldAndWinBuilder.cellMask`. */
+    mask: ((cell: HwCell, info: BoardCellMaskInfo) => MaskStrategy) | null;
     /** Travel axis for each cell's own strip. See `HoldAndWinBuilder.axis`. */
     orientation?: Orientation;
     direction?: Direction;
@@ -53,7 +66,7 @@ export interface HoldAndWinBoardConfig<TData> {
  *
  * ```ts
  * const board = new HoldAndWinBuilder<{ value: number }>()
- *   .grid(5, 3).cellSize(72, { gap: 4 })
+ *   .grid(5, 3).cellSize({ width: 101, height: 85 }, { columnGap: 4, rowGap: 0 })
  *   .symbols((r) => r.register('coin', CoinSymbol, COIN_TRIGGER))
  *   .weights({ coin: 1, empty: 3 }).respins(3).ticker(app.ticker)
  *   .build();
@@ -74,16 +87,31 @@ export declare class HoldAndWinBoard<TData = unknown> implements Disposable {
     private readonly _grid;
     private readonly _state;
     private readonly _emptyId;
+    private readonly _inactiveId;
+    private readonly _lockAnimation;
     private readonly _anticipateWhen;
+    private readonly _stagger;
+    private readonly _speeds;
+    private _speed;
+    /** Whether the wave in flight (if any) runs on the tension variants. */
+    private _tenseWave;
     constructor(cfg: HoldAndWinBoardConfig<TData>);
     get container(): Container;
+    /** Number of active cells - what `isFull` is measured against. */
     get capacity(): number;
     get respinsLeft(): number;
     get lockedCoins(): HwCoin<TData>[];
     get isFull(): boolean;
+    /** Active cells holding no coin. */
     get freeCells(): HwCell[];
+    /** Dormant cells - built, drawn, but not part of the feature yet. */
+    get inactiveCells(): HwCell[];
     /** Where the feature is right now: idle (no feature), active, or spinning. */
     get phase(): HwPhase;
+    /** Name of the speed profile every cell is set to. */
+    get speed(): string;
+    /** Every registered speed name, initial first. */
+    get speedNames(): string[];
     cellBounds(cell: HwCell): {
         x: number;
         y: number;
@@ -117,6 +145,36 @@ export declare class HoldAndWinBoard<TData = unknown> implements Disposable {
      * resolved. The game layer drives pacing between rounds.
      */
     respin(hits: HwCoin<TData>[]): Promise<HwRespinResult<TData>>;
+    /**
+     * Switch every cell to a registered speed profile at once - the board's
+     * `reelSet.setSpeed()`. Takes hold immediately on every cell's SpeedManager;
+     * as on a reel set, a cell already in flight finishes on the profile it
+     * started with, so a wave in progress shows the change from its next wave -
+     * or right away after `skip()`, the turbo-button semantic. Fires
+     * `speed:changed`.
+     */
+    setSpeed(name: string): void;
+    /**
+     * Register one more named profile into every cell's SpeedManager after
+     * build - `reelSet.speed.addProfile()` for the whole board. Its tension
+     * variant is derived the same way as for the built-in ones. Select it with
+     * {@link setSpeed}.
+     */
+    addSpeed(name: string, profile: SpeedProfile): void;
+    /**
+     * Play the win animation on locked coins - by default every one of them, or
+     * just `cells`. Resolves when the last one finishes. This is the explicit
+     * celebration for a board built with `lockAnimation('landing' | 'none')`,
+     * typically fired on `board:full` or `feature:end`; on the default `'win'`
+     * board it simply replays what each lock already played.
+     */
+    playWin(cells?: HwCell[]): Promise<void>;
+    /**
+     * Wake dormant cells (see `HoldAndWinBuilder.inactive`): they show the empty
+     * symbol, join the next respin and count toward the full board from now on.
+     * Fires `cells:activated`. Not allowed while a wave is in flight.
+     */
+    activate(cells: HwCell[]): void;
     /**
      * Remove locked coins - the collect moment. Clears the cells (they become
      * free again) and returns the released coins; the flight itself is game-layer
@@ -131,12 +189,25 @@ export declare class HoldAndWinBoard<TData = unknown> implements Disposable {
      * were in flight.
      */
     skip(): number;
-    /** Clear the board back to idle. Fires `feature:reset` (not `coin:released`). */
+    /**
+     * Clear the board back to idle. Fires `feature:reset` (not `coin:released`).
+     * Cells activated during the feature go dormant again.
+     */
     reset(): void;
     get isDestroyed(): boolean;
     destroy(): void;
     /** Emit each reducer-decided effect and fire the visual side effects. */
     private _apply;
+    /**
+     * Play one of a symbol's one-shots. Presentation: a hiccup must not break
+     * the feature flow, but it must not vanish silently either - log it like the
+     * rest of the engine.
+     */
+    private _playOn;
+    /** A cell's concrete profile for a named speed: the base plus this cell's stagger. */
+    private _profileFor;
+    /** Show the dormant symbol on every currently inactive cell. */
+    private _dressInactive;
     private _anticipating;
 }
 //# sourceMappingURL=HoldAndWinBoard.d.ts.map