pixi-reels 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -0,0 +1,65 @@
+# pixi-reels
+
+## 0.3.0
+
+### Minor Changes
+
+- [#61](https://github.com/schmooky/pixi-reels/pull/61) [`28551ca`](https://github.com/schmooky/pixi-reels/commit/28551ca72e6cbc1e95984cf1b35e71bdb5f18d22) Thanks [@schmooky](https://github.com/schmooky)! - Add: per-reel geometry, MultiWays, big symbols, and expanding wilds.
+
+  - **Per-reel static shape (pyramids):** `builder.visibleRowsPerReel([3, 5, 5, 5, 3])`, optional `reelPixelHeights`, `reelAnchor: 'top' | 'center' | 'bottom'`. Reels can now have non-uniform row counts at build time.
+  - **MultiWays (per-spin row variation):** `builder.multiways({ minRows, maxRows, reelPixelHeight })` plus `reelSet.setShape(rowsPerReel)` mid-spin. A new `AdjustPhase` (inserted only when `.multiways(...)` is called) reshapes reels between SPIN and STOP. Pin migration follows: pins gain a frozen `originRow` and migrate back toward it on each reshape.
+  - **Big symbols (`N×M` blocks):** `register('bonus', SymbolClass, { size: { w: 2, h: 2 } })`. The result grid stays `string[][]` — the engine paints OCCUPIED across the block. `getSymbolFootprint(col, row)` resolves any cell to the anchor.
+  - **Expanding wilds:** unchanged from the existing pin API; reaffirmed via tests as a degenerate big-symbol case.
+
+  New events: `shape:changed`, `adjust:start`, `adjust:complete`, `pin:migrated`. They only fire on MultiWays slots — non-MultiWays event surfaces are unchanged.
+
+  New runtime: `reelSet.setShape()`, `reelSet.getSymbolFootprint()`, `reelSet.getVisibleGrid()`, `reelSet.isMultiWaysSlot`. New builder fluents: `.visibleRowsPerReel()`, `.reelPixelHeights()`, `.reelAnchor()`, `.multiways()`, `.pinMigrationDuration()`, `.pinMigrationEase()`. Pin gains optional `originRow`.
+
+  AdjustPhase animates the reshape: every visible symbol tweens its height + Y from the old shape to the new one over `pinMigrationDuration` ms with the configurable `pinMigrationEase`. Pin overlays tween in lock-step so a sticky wild visibly slides to its migrated row. Set `pinMigrationDuration(0)` for an instant snap.
+
+  Constraints: big symbols and MultiWays are mutually exclusive per slot in v1. Cascade mode + MultiWays throws at build.
+
+  **Breaking** (debug-only, not protected by semver but called out): `DebugSnapshot.visibleRows` widens from `number` to `number[]` so jagged shapes are representable. Adapt downstream code that deep-reads the snapshot.
+
+### Patch Changes
+
+- [#61](https://github.com/schmooky/pixi-reels/pull/61) [`4b22c00`](https://github.com/schmooky/pixi-reels/commit/4b22c00b0f5733d141de1fee4ed8bf515cc2a513) Thanks [@schmooky](https://github.com/schmooky)! - Fix and harden a handful of follow-ups from the per-reel-geometry / MultiWays / big-symbols PR:
+
+  - `Reel.reshape()` now keeps `_reelHeight` in sync with the new geometry so the field doesn't go stale after a reshape. Previously a direct external call left `reelHeight` reporting the construction-time value. The method is also marked `@internal` in JSDoc — `ReelSet.setShape()` is the supported entry point.
+  - `ReelSetBuilder.maskStrategy()` now validates its argument synchronously: passing `null`, `undefined`, or an object missing `build()` / `update()` methods throws with a grep-able error instead of crashing later inside `ReelViewport`.
+  - Added a comment in `SpinController.skip()` documenting the reshape-on-skip contract — pin overlays migrate instantly on slam-stop regardless of `pinMigrationDuration`, and the rationale (overlays are destroyed at land anyway).
+
+  No new public API; behaviour for existing well-formed callers is unchanged.
+
+## 0.2.0
+
+### Minor Changes
+
+- [`3fd806a`](https://github.com/schmooky/pixi-reels/commit/3fd806a31d76be5fc6ac7ff8e23852814c542e1a) - Backfill for three engine PRs merged without changesets after `0.1.0`:
+
+  - Cascade drop-in mechanic and anticipation recipe ([#51](https://github.com/schmooky/pixi-reels/issues/51)).
+  - Engine primitives: `CellPin`, `movePin`, and `reelSet.frame` exposure ([#52](https://github.com/schmooky/pixi-reels/issues/52)).
+  - `ReelSet.getCellBounds` for overlays, paylines, and hit areas ([#53](https://github.com/schmooky/pixi-reels/issues/53)).
+
+  All three are additive, so this bundles them into a single minor bump.
+
+- [`555c9f0`](https://github.com/schmooky/pixi-reels/commit/555c9f007d749a8e2329a53dc17208fc94d7b5f3) - Add: `WinPresenter` — a minimal win-presentation layer that animates winning cells and fires events. Paylines, cluster pops, scatter splashes all use the same shape. The library never draws lines or overlays; user code does that by reacting to events.
+
+  - `WinPresenter.show(wins: Win[])` — animates each win's cells, one by one. `stagger: 0` flashes simultaneously, `stagger > 0` sweeps left-to-right in cell order.
+  - `Win` — one shape: `{ cells: SymbolPosition[]; value?: number; kind?: string; id?: number }`. Covers paylines, clusters, cascade pops, scatters.
+  - `dimLosers` (default 0.35 alpha) fades non-winning cells during each win; restored on `win:end`.
+  - `symbolAnim`: `'win'` (default, calls `playWin()`), a named spine animation, or `(symbol, cell, win) => Promise<void>` for a custom callback.
+  - Events fire on `ReelSet.events`: `win:start` (full list), `win:group` (per-win), `win:symbol` (per-cell), `win:end` (`complete` / `aborted`). Subscribe with `reelSet.getCellBounds` to draw any overlay you want.
+  - Cascades: call `presenter.show([{ cells: winners }])` from `runCascade`'s `onWinnersVanish` hook — same API.
+  - Helper: `sortByValueDesc` exported for convenience.
+  - Types: `Win`, `SymbolPosition` (canonicalised to `config/types`, re-exported from events).
+  - Reels now have an explicit `container.zIndex = reelIndex` so the viewport's sorted `maskedContainer` draws reels deterministically — same order as before, but callers can flip it for bottom-left diagonal overflow.
+
+  No existing API is changed or removed.
+
+### Patch Changes
+
+- [`7792142`](https://github.com/schmooky/pixi-reels/commit/779214217bb341cfb66f2db74616b2e8608893b9) - Fix: Two `AnimatedSpriteSymbol` bugs that only manifest on symbols with non-trivial win animations:
+
+  - `resize()` now positions the sprite according to its configured anchor, so `anchor: { x: 0.5, y: 0.5 }` renders the symbol centred in its cell instead of with its centre pinned to the cell's top-left corner (which clipped three quarters of the symbol under the reel mask). `anchor: (0, 0)` — the prior default and only combination that worked — is unchanged.
+  - `playWin()` now returns the animation to frame 0 (`gotoAndStop(0)`) when the sequence completes, so the idle visible state settles on the neutral base frame. Previously the sprite held its last animation frame indefinitely — fine for symmetric pulses that happen to end where they started, a visible glitch for anything else (AI-generated or keyframe sequences that end mid-action).

package/dist/cascade/CascadeAnticipationPhase.d.ts

@@ -0,0 +1,23 @@
+import { ReelPhase } from '../spin/phases/ReelPhase.js';
+/**
+ * Anticipation phase for cascade drop-in mechanics.
+ *
+ * The default AnticipationPhase slows a spinning reel — useless when
+ * the reel is stationary. This phase shakes the column instead, giving
+ * the player a clear "something's about to drop here" signal.
+ *
+ * Register it to replace the default for cascade games:
+ *   builder.phases(f => f.register('anticipation', CascadeAnticipationPhase))
+ *
+ * Duration is driven by speed.anticipationDelay (same as standard anticipation).
+ */
+export declare class CascadeAnticipationPhase extends ReelPhase<void> {
+    readonly name = "anticipation";
+    readonly skippable = true;
+    private _tween;
+    private _baseX;
+    protected onEnter(): void;
+    update(_deltaMs: number): void;
+    protected onSkip(): void;
+}
+//# sourceMappingURL=CascadeAnticipationPhase.d.ts.map

package/dist/cascade/CascadeAnticipationPhase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CascadeAnticipationPhase.d.ts","sourceRoot":"","sources":["../../src/cascade/CascadeAnticipationPhase.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAyB,SAAQ,SAAS,CAAC,IAAI,CAAC;IAC3D,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,SAAS,QAAQ;IAE1B,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,MAAM,CAAK;IAEnB,SAAS,CAAC,OAAO,IAAI,IAAI;IA2BzB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAE9B,SAAS,CAAC,MAAM,IAAI,IAAI;CAKzB"}

package/dist/cascade/DropRecipes.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Configuration for cascade drop-in behavior.
+ * Passed to ReelSetBuilder.cascade() to replace the default strip-spin mechanic.
+ */
+export interface CascadeDropConfig {
+    /** Stagger between rows dropping in (ms). 0 = all rows arrive simultaneously. Default: 0. */
+    rowDelay?: number;
+    /** Stagger between rows falling out (ms). 0 = all rows fall simultaneously. Default: 0. */
+    fallRowDelay?: number;
+    /** Distance symbols travel (px) — both falling out and dropping in. Default: auto (full column height). */
+    fromY?: number;
+    /** GSAP easing for the drop-in animation. Default: 'bounce.out'. */
+    easing?: string;
+    /** Duration of each symbol's drop-in animation (ms). 0 = instant. Default: 600. */
+    dropDuration?: number;
+    /** Duration of each symbol's fall-out animation (ms). 0 = skip fall. Default: 300. */
+    fallDuration?: number;
+}
+/**
+ * Named presets for common cascade drop patterns.
+ *
+ * Pass one to ReelSetBuilder.cascade():
+ *   builder.cascade(DropRecipes.cascadeDrop)
+ *
+ * Control reel order per-spin with reelSet.setDropOrder():
+ *   reelSet.setDropOrder('ltr')  // left-to-right stagger
+ *   reelSet.setDropOrder('rtl')  // right-to-left stagger
+ *   reelSet.setDropOrder('all')  // all columns simultaneously
+ */
+export declare const DropRecipes: {
+    /** Old symbols fall out, then new ones drop in row by row with bounce. Classic cascade feel. */
+    readonly cascadeDrop: CascadeDropConfig;
+    /** Stiff landing — no bounce. Symbols fall out then drop in cleanly with a hard stop. */
+    readonly stiffDrop: CascadeDropConfig;
+    /** Old symbols fall out, then all new symbols in a column drop simultaneously. Good for refills. */
+    readonly simultaneousDrop: CascadeDropConfig;
+    /** Instant placement — no fall, no drop animation. Equivalent to slam-stop. */
+    readonly slamDrop: CascadeDropConfig;
+};
+//# sourceMappingURL=DropRecipes.d.ts.map

package/dist/cascade/DropRecipes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropRecipes.d.ts","sourceRoot":"","sources":["../../src/cascade/DropRecipes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2GAA2G;IAC3G,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW;IACtB,gGAAgG;0BACH,iBAAiB;IAE9G,yFAAyF;wBACE,iBAAiB;IAE5G,oGAAoG;+BACH,iBAAiB;IAElH,+EAA+E;uBAChB,iBAAiB;CACxE,CAAC"}

package/dist/config/types.d.ts

@@ -31,17 +31,64 @@ export interface SymbolData {
     zIndex?: number;
     /** If true, this symbol renders above the reel mask (for oversized animations). */
     unmask?: boolean;
+    /**
+     * Footprint in cells. Default `{ w: 1, h: 1 }`. When `w * h > 1` this
+     * symbol is a "big symbol" — at landing it occupies an `w × h` block of
+     * cells anchored at the (col, row) where its id appears in the result.
+     * Big-symbol registration is rejected on MultiWays slots.
+     */
+    size?: {
+        w: number;
+        h: number;
+    };
+}
+/** How to vertically align reels of differing pixel heights. */
+export type ReelAnchor = 'top' | 'center' | 'bottom';
+/**
+ * MultiWays configuration knobs. Set via `builder.multiways({ ... })` —
+ * mutually exclusive with big-symbol registration.
+ */
+export interface MultiWaysConfig {
+    /** Minimum visible rows the server can request. Inclusive. */
+    minRows: number;
+    /** Maximum visible rows the server can request. Inclusive. */
+    maxRows: number;
+    /**
+     * Pixel height of every reel box. Cell height per reel becomes
+     * `reelPixelHeight / visibleRows[i]` after each reshape.
+     */
+    reelPixelHeight: number;
 }
 /** Configuration for the reel grid layout. */
 export interface ReelGridConfig {
     /** Number of reel columns. */
     reelCount: number;
-    /** Number of visible symbol rows per reel. */
+    /**
+     * Default visible rows when all reels are uniform. Ignored if
+     * `visibleRowsPerReel` is set.
+     */
     visibleRows: number;
+    /**
+     * Per-reel row counts (static shape). Length MUST equal `reelCount`.
+     * Example: `[3, 5, 5, 5, 3]` for a pyramid layout. Mutually exclusive
+     * with the scalar `visibleRows` field at the builder level.
+     */
+    visibleRowsPerReel?: number[];
     /** Symbol width in pixels. */
     symbolWidth: number;
-    /** Symbol height in pixels. */
+    /** Symbol height in pixels. Used as the SPIN-time uniform cell height. */
     symbolHeight: number;
+    /**
+     * Per-reel pixel-box heights. Length MUST equal `reelCount` when set.
+     * For MultiWays: every entry is the same fixed reel height. For static
+     * pyramids: defaults to `visibleRowsPerReel[i] * symbolHeight`.
+     */
+    reelPixelHeights?: number[];
+    /**
+     * How short reels align vertically inside the tallest reel's height.
+     * Default: 'center'.
+     */
+    reelAnchor?: ReelAnchor;
     /** Gap between symbols. Default: { x: 0, y: 0 }. */
     symbolGap?: {
         x: number;
@@ -49,6 +96,13 @@ export interface ReelGridConfig {
     };
     /** Number of buffer symbols above and below the visible area. Default: 1. */
     bufferSymbols?: number;
+    /**
+     * MultiWays configuration. Set by `builder.multiways(...)`. When present:
+     *   - `setShape(rowsPerReel)` becomes callable mid-spin
+     *   - AdjustPhase is inserted between SPIN and STOP
+     *   - big-symbol registration throws at build time
+     */
+    multiways?: MultiWaysConfig;
 }
 /** Extra symbols above/below config per reel. */
 export interface ReelExtraSymbols {
@@ -76,14 +130,88 @@ export interface Position {
     x: number;
     y: number;
 }
+/**
+ * Axis-aligned bounding box of a single grid cell in ReelSet-local
+ * coordinates. Returned by `reelSet.getCellBounds(col, row)`.
+ *
+ * Use this to draw paylines, hit areas, debug overlays, or any graphic
+ * that needs to align precisely with a visible symbol cell.
+ */
+export interface CellBounds {
+    /** Left edge of the cell in ReelSet-local pixels. */
+    x: number;
+    /** Top edge of the cell in ReelSet-local pixels. */
+    y: number;
+    /** Cell width — equals the configured symbol width. */
+    width: number;
+    /** Cell height — equals the configured symbol height. */
+    height: number;
+}
+/**
+ * A cell on the visible grid — `reelIndex` is the column, `rowIndex` the
+ * row from the top. This is the canonical grid-cell shape used across
+ * events (`win:symbol`, `spotlight:start`), `Spotlight.show`, and
+ * `ClusterWin.cells`.
+ *
+ * Named `SymbolPosition` for back-compat with the original events module.
+ */
+export interface SymbolPosition {
+    reelIndex: number;
+    rowIndex: number;
+}
+/**
+ * One "win" as the presenter sees it: an ordered set of cells to highlight.
+ *
+ * Use cases collapse onto this one shape — whether those cells came from a
+ * classic payline ("row 1 across all 5 reels"), a cascade pop ("this cluster
+ * vanished"), a scatter splash, or a bonus reveal.
+ *
+ * The presenter's job is to **animate these cells**. Anything beyond that —
+ * drawing a polyline, a cluster outline, a number popup, a sound cue — is
+ * user-land code reacting to the `win:*` events. pixi-reels never draws wins.
+ *
+ * Order of `cells` matters when `WinPresenter.stagger > 0` (e.g. a
+ * left-to-right sweep): cell N starts animating `stagger` ms after cell N-1.
+ * Pass the cells in the order you want the sweep to run.
+ */
+export interface Win {
+    /** Cells to highlight. Order matters when `stagger > 0`. */
+    cells: ReadonlyArray<SymbolPosition>;
+    /** Optional payout — used for the default value-desc sort. */
+    value?: number;
+    /** Optional tag for routing events to different handlers. */
+    kind?: string;
+    /** Optional stable id so event consumers can key per-win state. */
+    id?: number;
+}
 /** Mask configuration for the reel viewport. */
 export interface MaskConfig {
     mask: Container;
     position: Position;
 }
+/**
+ * Resolved grid view used internally — every defaulted field is filled in,
+ * but per-reel-shape and MultiWays extensions stay optional because they're
+ * genuinely opt-in.
+ */
+export interface ResolvedReelGridConfig {
+    reelCount: number;
+    visibleRows: number;
+    symbolWidth: number;
+    symbolHeight: number;
+    symbolGap: {
+        x: number;
+        y: number;
+    };
+    bufferSymbols: number;
+    visibleRowsPerReel?: number[];
+    reelPixelHeights?: number[];
+    reelAnchor: ReelAnchor;
+    multiways?: MultiWaysConfig;
+}
 /** Full internal configuration assembled by the builder. */
 export interface ReelSetInternalConfig {
-    grid: Required<ReelGridConfig>;
+    grid: ResolvedReelGridConfig;
     symbols: Record<string, SymbolData>;
     speeds: Map<string, SpeedProfile>;
     initialSpeed: string;

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

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

package/dist/core/Reel.d.ts

@@ -21,7 +21,31 @@ export interface ReelConfig {
     symbolGapY: number;
     symbolsData: Record<string, SymbolData>;
     initialSymbols: string[];
+    /**
+     * Y offset of this reel relative to the viewport's top edge. Set by the
+     * builder so jagged shapes (pyramids) align according to `reelAnchor`.
+     * Default 0.
+     */
+    offsetY?: number;
+    /**
+     * Pixel height of this reel's box. Used for MultiWays cell-height
+     * derivation (`reelHeight / visibleRows`). Defaults to
+     * `visibleRows * symbolHeight`.
+     */
+    reelHeight?: number;
+    /**
+     * SPIN-time uniform cell height. During SPIN every reel uses this same
+     * height. AdjustPhase later swaps to per-reel `reelHeight / visibleRows`.
+     * Defaults to `symbolHeight`.
+     */
+    spinSymbolHeight?: number;
 }
+/**
+ * Internal sentinel marking non-anchor cells of a big symbol's block.
+ * Never crosses the public API — `getVisibleSymbols()` resolves it to the
+ * anchor's id.
+ */
+export declare const OCCUPIED_SENTINEL = "__pixi_reels_occupied__";
 /**
  * One vertical column of a slot board.
  *
@@ -59,8 +83,37 @@ export declare class Reel implements Disposable {
     private _bufferAbove;
     private _symbolWidth;
     private _symbolHeight;
+    private _offsetY;
+    private _reelHeight;
+    private _spinSymbolHeight;
+    private _symbolGapY;
+    private _symbolGapX;
     private _isDestroyed;
     private _isStopping;
+    /**
+     * Internal stub instances reused for OCCUPIED cells inside a big-symbol
+     * block. Allocated on demand (one per concurrent OCCUPIED cell on this
+     * reel), never pooled through `SymbolFactory`. The views are invisible —
+     * the anchor symbol is sized up to cover the whole block.
+     */
+    private _occupiedStubs;
+    /**
+     * Per-row marker recording which rows are non-anchor cells of a big
+     * symbol. Populated when frames are placed; consulted by `getVisibleSymbols`
+     * and `getSymbolAt` so anchor identity propagates through the block.
+     *
+     * Indexed by visible-row 0..visibleRows-1. Each entry is `null` for a
+     * normal cell, or `{ anchorRow }` for a cell occupied by another row's
+     * anchor.
+     */
+    private _occupancy;
+    /**
+     * Optional resolver for cross-reel OCCUPIED cells. Set by `ReelSet` so
+     * `getVisibleSymbols()` returns the anchor's id even when the anchor
+     * lives on a different reel (a 2×2 bonus straddles cols c, c+1).
+     * Without it, cross-reel OCCUPIED cells return the OCCUPIED sentinel.
+     */
+    private _crossReelResolver;
     constructor(config: ReelConfig, symbolFactory: SymbolFactory, randomProvider: RandomSymbolProvider, viewport: ReelViewport);
     get isDestroyed(): boolean;
     get isStopping(): boolean;
@@ -68,24 +121,106 @@ export declare class Reel implements Disposable {
     get bufferAbove(): number;
     get bufferBelow(): number;
     get visibleRows(): number;
+    /** The symbol cell width (in pixels). Constant for the reel's lifetime. */
+    get symbolWidth(): number;
+    /**
+     * The symbol cell height (in pixels). Mutates on MultiWays reshape via
+     * `reshape()`. During SPIN this still equals `spinSymbolHeight`; the
+     * per-reel target value comes into effect when AdjustPhase commits the
+     * reshape. For non-MultiWays slots this is constant for the reel's lifetime.
+     */
+    get symbolHeight(): number;
+    /** Pixel height of this reel's box. Set by builder, immutable. */
+    get reelHeight(): number;
+    /** Y offset of this reel relative to the viewport top. Set by builder, immutable. */
+    get offsetY(): number;
+    /**
+     * SPIN-time uniform cell height. All reels in a slot use this value during
+     * the SPIN phase regardless of their per-reel `symbolHeight`. Frozen at
+     * construction.
+     */
+    get spinSymbolHeight(): number;
     /** Update reel for one frame. Called by SpinController via ticker. */
     update(deltaMs: number): void;
     /** Set the target frame for stopping. */
     setStopFrame(frame: string[]): void;
-    /** Get visible symbol IDs (top to bottom, excluding buffers). */
+    /**
+     * Get visible symbol IDs (top to bottom, excluding buffers).
+     *
+     * Big-symbol cells resolve to the anchor's id — both **same-reel**
+     * (the anchor lives on this reel) and **cross-reel** (the anchor is on
+     * a leftward reel of a wider block). The cross-reel resolver is
+     * injected by `ReelSet`; without it, cross-reel OCCUPIED cells would
+     * return the OCCUPIED sentinel, which is the only difference vs.
+     * `ReelSet.getVisibleGrid()`. With the resolver wired, the two are
+     * equivalent for any reel — `reels.map(r => r.getVisibleSymbols())`
+     * matches `reelSet.getVisibleGrid()`.
+     */
     getVisibleSymbols(): string[];
-    /** Get symbol at a visible row (0-indexed from top visible). */
+    /**
+     * Internal: register a callback used to resolve cross-reel OCCUPIED
+     * cells to the originating big-symbol's id. Wired by `ReelSet` so this
+     * reel can answer "what id is at (myCol, row)?" even when the anchor is
+     * on a different reel.
+     *
+     * @internal
+     */
+    setCrossReelResolver(resolver: ((col: number, row: number) => string) | null): void;
+    /**
+     * Get symbol at a visible row (0-indexed from top visible).
+     * For non-anchor cells of a big symbol, walks up to the anchor row and
+     * returns the anchor symbol so animations target the actual visual.
+     */
     getSymbolAt(visibleRow: number): ReelSymbol;
+    /**
+     * Anchor row for a visible row. Equals `visibleRow` for normal cells;
+     * for non-anchor cells inside a big-symbol block, returns the row where
+     * the anchor lives.
+     *
+     * @internal — used by `ReelSet.getSymbolFootprint` and the cross-reel
+     * resolver wired in `ReelSet`'s constructor. Not intended for consumer
+     * use; prefer `ReelSet.getSymbolFootprint(col, row)` which returns full
+     * anchor + size info.
+     */
+    _getAnchorRow(visibleRow: number): number;
+    /**
+     * Record that the given visible row is the non-anchor cell of a big
+     * symbol whose anchor lives at `anchorRow`. Pass `null` to clear the
+     * occupancy mark.
+     *
+     * @internal — called by `_finalizeFrame` and the big-symbol coordinator.
+     */
+    _setOccupancy(visibleRow: number, anchorRow: number | null): void;
     /** Notify all visible symbols that the reel has started spinning. */
     notifySpinStart(): void;
     /** Notify all visible symbols that the reel is about to stop (just before bounce). */
     notifySpinEnd(): void;
     /** Notify all visible symbols that the reel has landed on its target. */
     notifyLanded(): void;
-    /** Snap all symbols to grid. */
+    /**
+     * Snap all symbols to grid and finalize big-symbol layout. Called at the
+     * end of every stop sequence.
+     */
     snapToGrid(): void;
     /** Place symbols immediately at target positions (for skip/turbo). */
     placeSymbols(symbolIds: string[]): void;
+    /**
+     * @internal — MultiWays orchestration only.
+     *
+     * Commit a new visible-row count and per-reel cell height. Resizes every
+     * existing symbol on the strip to the new cell height, rebuilds the
+     * symbol array (extending or truncating buffers as needed), reshapes the
+     * motion layer, and recomputes `_reelHeight` from the new geometry so
+     * `reelHeight` stays consistent. Idempotent if the shape doesn't change.
+     *
+     * Only the engine should call this — `SpinController._applyReshape` is
+     * the single source of truth for reshape orchestration. Direct external
+     * calls are unsupported and may leave pin overlays, the cross-reel
+     * resolver, and the parent `ReelSet`'s shape state out of sync. Use
+     * `ReelSet.setShape()` instead, which gates this method on a MultiWays
+     * slot and migrates pins atomically.
+     */
+    reshape(newVisibleRows: number, newSymbolHeight: number, bufferAbove: number, bufferBelow: number): void;
     /**
      * Recompute `zIndex` for every symbol in the reel.
      *
@@ -102,5 +237,22 @@ export declare class Reel implements Disposable {
     private _setupSymbolPositions;
     private _onSymbolWrapped;
     private _replaceSymbol;
+    /**
+     * Acquire an OCCUPIED stub. Reuses any free stub stored locally; allocates
+     * a new one if none are available. Stubs are never returned to
+     * `SymbolFactory`.
+     */
+    private _acquireOccupiedStub;
+    private _releaseOccupiedStub;
+    /**
+     * After the visible target frame has been placed, scan visible rows to
+     * size big-symbol anchors and populate the OCCUPIED occupancy map.
+     *
+     * Called from `snapToGrid` and `placeSymbols` so it runs both for normal
+     * stop landing AND for skip/turbo. For non-anchor rows of a block, the
+     * anchor symbol is sized to span the block; the OCCUPIED stub at that
+     * row stays invisible underneath.
+     */
+    private _finalizeFrame;
 }
 //# sourceMappingURL=Reel.d.ts.map

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

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

package/dist/core/ReelMotion.d.ts

@@ -37,6 +37,14 @@ export declare class ReelMotion {
     /** Get the correct Y position for a symbol at a given row. */
     getRowY(row: number): number;
     get slotHeight(): number;
+    /**
+     * Reshape the motion layer for a new visible-row count and cell height.
+     * Recomputes wrap bounds and the slot height. Called by `Reel.reshape()`
+     * during AdjustPhase on MultiWays slots. The symbol array is re-bound by
+     * `Reel.reshape()` directly via the same array reference, so this method
+     * doesn't take a new array.
+     */
+    reshape(symbolHeight: number, symbolGapY: number, bufferAbove: number, visibleRows: number): void;
     private _wrapBottomToTop;
     private _wrapTopToBottom;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"ReelMotion.d.ts","sourceRoot":"","sources":["../../src/core/ReelMotion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAU;IAQnB,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,YAAY;IAEpB,OAAO,CAAC,gBAAgB;IAZ1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;gBAGZ,QAAQ,EAAE,UAAU,EAAE,EAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EAC5B,WAAW,EAAE,MAAM,EACX,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI;IAStG;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY9B,mFAAmF;IACnF,UAAU,IAAI,IAAI;IAOlB,4EAA4E;IAC5E,gBAAgB,IAAI,IAAI;IAMxB,8DAA8D;IAC9D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5B,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;CAUzB"}
+{"version":3,"file":"ReelMotion.d.ts","sourceRoot":"","sources":["../../src/core/ReelMotion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAE3D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,UAAU;IAQnB,OAAO,CAAC,QAAQ;IAGhB,OAAO,CAAC,YAAY;IAEpB,OAAO,CAAC,gBAAgB;IAZ1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;gBAGZ,QAAQ,EAAE,UAAU,EAAE,EAC9B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EACV,YAAY,EAAE,MAAM,EAC5B,WAAW,EAAE,MAAM,EACX,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,GAAG,MAAM,KAAK,IAAI;IAStG;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY9B,mFAAmF;IACnF,UAAU,IAAI,IAAI;IAOlB,4EAA4E;IAC5E,gBAAgB,IAAI,IAAI;IAMxB,8DAA8D;IAC9D,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5B,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;;;;;OAMG;IACH,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IASjG,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;CAUzB"}