pixi-reels 0.1.0

package/dist/core/ReelMotion.d.ts

@@ -0,0 +1,43 @@
+import { ReelSymbol } from '../symbols/ReelSymbol.js';
+/**
+ * The physics of one reel — move symbols down, wrap them around.
+ *
+ * Every frame, `ReelMotion.update(delta)` adds `delta` to each symbol's
+ * Y coordinate. A symbol whose position falls off the bottom wraps back
+ * to the top (and vice versa — reels can run upward). Each wrap fires
+ * the `_onSymbolWrapped` callback so the owning `Reel` can ask the
+ * `FrameBuilder` for the next identity to paint on it.
+ *
+ * Maintains the invariant that `_symbols[0]` is always the visually
+ * topmost symbol and `_symbols[N-1]` is always the bottommost. On each
+ * wrap, the wrapping symbol is moved to the front (or back) of the array
+ * so the ordering stays consistent with the grid. `snapToGrid` and the
+ * visible window selection rely on this.
+ */
+export declare class ReelMotion {
+    private _symbols;
+    private _bufferAbove;
+    private _onSymbolWrapped;
+    private _symbolHeight;
+    private _symbolGapY;
+    private _slotHeight;
+    private _minY;
+    private _maxY;
+    constructor(_symbols: ReelSymbol[], symbolHeight: number, symbolGapY: number, _bufferAbove: number, visibleRows: number, _onSymbolWrapped: (symbol: ReelSymbol, arrayIndex: number, direction: 'up' | 'down') => void);
+    /**
+     * Move all symbols by deltaY pixels (positive = downward).
+     * At most one wrap per call (deltaY is capped at half a symbol by the
+     * spinning mode, so a single symbol can cross the boundary per tick).
+     */
+    displace(deltaY: number): void;
+    /** Snap all symbols to their correct grid positions (array index = visual row). */
+    snapToGrid(): void;
+    /** Position all symbols above the visible area (for cascade mode start). */
+    setToTopPosition(): void;
+    /** Get the correct Y position for a symbol at a given row. */
+    getRowY(row: number): number;
+    get slotHeight(): number;
+    private _wrapBottomToTop;
+    private _wrapTopToBottom;
+}
+//# sourceMappingURL=ReelMotion.d.ts.map

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

@@ -0,0 +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"}

package/dist/core/ReelSet.d.ts

@@ -0,0 +1,101 @@
+import { Container } from 'pixi.js';
+import { Disposable } from '../utils/Disposable.js';
+import { ReelSetInternalConfig } from '../config/types.js';
+import { EventEmitter } from '../events/EventEmitter.js';
+import { ReelSetEvents, SpinResult } from '../events/ReelEvents.js';
+import { Reel } from './Reel.js';
+import { ReelViewport } from './ReelViewport.js';
+import { SpeedManager } from '../speed/SpeedManager.js';
+import { SymbolSpotlight } from '../spotlight/SymbolSpotlight.js';
+import { SymbolFactory } from '../symbols/SymbolFactory.js';
+import { FrameBuilder } from '../frame/FrameBuilder.js';
+import { PhaseFactory } from '../spin/phases/PhaseFactory.js';
+import { SpinningMode } from '../spin/modes/SpinningMode.js';
+export interface ReelSetParams {
+    config: ReelSetInternalConfig;
+    reels: Reel[];
+    viewport: ReelViewport;
+    symbolFactory: SymbolFactory;
+    frameBuilder: FrameBuilder;
+    phaseFactory: PhaseFactory;
+    spinningMode: SpinningMode;
+}
+/**
+ * The whole slot board as one object.
+ *
+ * A `ReelSet` is a PixiJS `Container` that owns every reel, the spin
+ * controller, the speed manager, and the win spotlight. You `addChild` it
+ * to your stage and then drive it from the four public verbs below:
+ *
+ *   - `spin()` — start the reels moving, returns a promise that resolves
+ *     when every reel has landed (or been slam-stopped)
+ *   - `setResult(grid)` — tell the reels what to land on; the spin
+ *     controller consumes this and each reel queues its target symbols
+ *   - `setAnticipation(reelIndices)` — slow the given reels before they
+ *     stop, for "will the third scatter land?" tension
+ *   - `skip()` — land immediately; useful for slam-stop UX
+ *
+ * Everything else is subsystems: `speed`, `spotlight`, `events`, `viewport`.
+ * Construction goes through {@link ReelSetBuilder}, never `new ReelSet()`
+ * directly — the builder enforces that every required piece is wired.
+ *
+ * ```ts
+ * const reelSet = new ReelSetBuilder()
+ *   .reels(5).visibleSymbols(3).symbolSize(140, 140)
+ *   .symbols((r) => r.register('cherry', SpriteSymbol, { textures }))
+ *   .ticker(app.ticker)
+ *   .build();
+ * app.stage.addChild(reelSet);
+ *
+ * const spin = reelSet.spin();
+ * reelSet.setResult(await server.spin());
+ * await spin;
+ * ```
+ *
+ * Teardown cascades: one `reelSet.destroy()` disposes every child.
+ */
+export declare class ReelSet extends Container implements Disposable {
+    private _events;
+    private _reels;
+    private _viewport;
+    private _spinController;
+    private _speedManager;
+    private _spotlight;
+    private _symbolFactory;
+    private _isDestroyed;
+    constructor(params: ReelSetParams);
+    /** The event emitter for reel-specific events. */
+    get events(): EventEmitter<ReelSetEvents>;
+    /** Start spinning all reels. Returns a promise that resolves when all reels land. */
+    spin(): Promise<SpinResult>;
+    /** Set the target result symbols. Triggers the stop sequence. */
+    setResult(symbols: string[][]): void;
+    /** Set which reels should show anticipation before stopping. */
+    setAnticipation(reelIndices: number[]): void;
+    /**
+     * Override the per-reel stop delay for the current spin (in ms).
+     * Pass one value per reel. Cleared at the start of each new spin.
+     *
+     * @example
+     * // Stagger the last two reels more than the default for dramatic effect:
+     * reelSet.setStopDelays([0, 140, 280, 600, 1100]);
+     */
+    setStopDelays(delays: number[]): void;
+    /** Skip/slam-stop: immediately land all reels on target. */
+    skip(): void;
+    get isSpinning(): boolean;
+    /** Speed profile manager. */
+    get speed(): SpeedManager;
+    /** Change speed and emit event. */
+    setSpeed(name: string): void;
+    get spotlight(): SymbolSpotlight;
+    /** Get all reels. */
+    get reels(): readonly Reel[];
+    /** Get a reel by index. */
+    getReel(index: number): Reel;
+    /** Get the viewport. */
+    get viewport(): ReelViewport;
+    get isDestroyed(): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=ReelSet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReelSet.d.ts","sourceRoot":"","sources":["../../src/core/ReelSet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,yBAAyB,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,eAAe,EAA0D,MAAM,iCAAiC,CAAC;AAC1H,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;IAC7B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,OAAQ,SAAQ,SAAU,YAAW,UAAU;IAC1D,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAe;IAChC,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,aAAa,CAAe;IACpC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,YAAY,CAAS;gBAEjB,MAAM,EAAE,aAAa;IAkCjC,kDAAkD;IAClD,IAAI,MAAM,IAAI,YAAY,CAAC,aAAa,CAAC,CAExC;IAID,qFAAqF;IAC/E,IAAI,IAAI,OAAO,CAAC,UAAU,CAAC;IAIjC,iEAAiE;IACjE,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAIpC,gEAAgE;IAChE,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAI5C;;;;;;;OAOG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAIrC,4DAA4D;IAC5D,IAAI,IAAI,IAAI;IAIZ,IAAI,UAAU,IAAI,OAAO,CAExB;IAID,6BAA6B;IAC7B,IAAI,KAAK,IAAI,YAAY,CAExB;IAED,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAO5B,IAAI,SAAS,IAAI,eAAe,CAE/B;IAID,qBAAqB;IACrB,IAAI,KAAK,IAAI,SAAS,IAAI,EAAE,CAE3B;IAED,2BAA2B;IAC3B,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI5B,wBAAwB;IACxB,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAID,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,OAAO,IAAI,IAAI;CAkBhB"}

package/dist/core/ReelSetBuilder.d.ts

@@ -0,0 +1,102 @@
+import { Ticker } from 'pixi.js';
+import { SpeedProfile, SymbolData, OffsetConfig } from '../config/types.js';
+import { ReelSet } from './ReelSet.js';
+import { SymbolRegistry } from '../symbols/SymbolRegistry.js';
+import { PhaseFactory } from '../spin/phases/PhaseFactory.js';
+import { SpinningMode } from '../spin/modes/SpinningMode.js';
+import { FrameMiddleware } from '../frame/FrameBuilder.js';
+/**
+ * The configurator you call before every reel set.
+ *
+ * `ReelSetBuilder` is a fluent, chainable builder: every call returns the
+ * builder so you can string setup onto one expression. It exists for two
+ * reasons — it hides the twenty-odd subsystems you'd otherwise have to
+ * wire by hand, and its `.build()` step validates that every required
+ * piece is present (throws at construction, not at first spin).
+ *
+ * Required calls (in any order): `.reels(n)`, `.visibleSymbols(n)`,
+ * `.symbolSize(w, h)`, `.symbols((registry) => ...)`, `.ticker(app.ticker)`.
+ * Optional: `.symbolGap()`, `.weights()`, `.symbolData()`, `.speed()`,
+ * `.bufferSymbols()`, `.offset()`, `.frameMiddleware()`, `.phases()`,
+ * `.spinningMode()`.
+ *
+ * Reduces ~100 lines of manual wiring to ~10 lines of configuration.
+ *
+ * ```ts
+ * const reelSet = new ReelSetBuilder()
+ *   .reels(5)
+ *   .visibleSymbols(3)
+ *   .symbolSize(200, 200)
+ *   .symbols((r) => {
+ *     r.register('cherry', SpriteSymbol, { textures: { cherry: tex } });
+ *   })
+ *   .weights({ cherry: 20 })
+ *   .ticker(app.ticker)
+ *   .build();
+ * ```
+ */
+export declare class ReelSetBuilder {
+    private _reelCount?;
+    private _visibleRows?;
+    private _symbolWidth?;
+    private _symbolHeight?;
+    private _symbolGap;
+    private _bufferSymbols;
+    private _symbolRegistry;
+    private _weights;
+    private _speeds;
+    private _initialSpeed;
+    private _offset;
+    private _ticker?;
+    private _spinningMode;
+    private _phaseFactory;
+    private _middlewares;
+    private _initialFrame?;
+    private _symbolDataOverrides;
+    /** Set number of reel columns. */
+    reels(count: number): this;
+    /** Set number of visible symbol rows per reel. */
+    visibleSymbols(count: number): this;
+    /** Set symbol dimensions in pixels. */
+    symbolSize(width: number, height: number): this;
+    /** Set gap between symbols. Default: { x: 0, y: 0 }. */
+    symbolGap(x: number, y: number): this;
+    /** Set number of buffer symbols above/below visible area. Default: 1. */
+    bufferSymbols(count: number): this;
+    /** Configure symbols via a registry callback. */
+    symbols(configurator: (registry: SymbolRegistry) => void): this;
+    /** Set weights for random symbol generation. */
+    weights(weights: Record<string, number>): this;
+    /**
+     * Per-symbol metadata overrides (zIndex, unmask, or a custom weight that
+     * replaces the one from `weights()`). Merged into the final symbolsData map
+     * — any field you don't specify falls back to the default.
+     *
+     * @example
+     * .symbolData({
+     *   wild:  { zIndex: 5 },                // render above neighbours
+     *   bonus: { zIndex: 10, unmask: true }, // render outside the reel mask
+     * })
+     */
+    symbolData(overrides: Record<string, Partial<SymbolData>>): this;
+    /** Add a named speed profile. */
+    speed(name: string, profile: SpeedProfile): this;
+    /** Set which speed profile to use initially. Default: 'normal'. */
+    initialSpeed(name: string): this;
+    /** Set X-axis offset config (e.g., trapezoid perspective). Default: 'none'. */
+    offsetConfig(config: OffsetConfig): this;
+    /** Set the PixiJS ticker for frame updates. */
+    ticker(ticker: Ticker): this;
+    /** Set the spinning mode. Default: StandardMode. */
+    spinningMode(mode: SpinningMode): this;
+    /** Add custom frame middleware. */
+    frameMiddleware(middleware: FrameMiddleware): this;
+    /** Override default phases. */
+    phases(configurator: (factory: PhaseFactory) => void): this;
+    /** Set the initial symbol grid (visible symbols only). */
+    initialFrame(frame: string[][]): this;
+    /** Build the ReelSet. Validates configuration and assembles all internal objects. */
+    build(): ReelSet;
+    private _validate;
+}
+//# sourceMappingURL=ReelSetBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReelSetBuilder.d.ts","sourceRoot":"","sources":["../../src/core/ReelSetBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAyB,MAAM,oBAAoB,CAAC;AAGxG,OAAO,EAAE,OAAO,EAAsB,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAK9D,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAC9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAGhE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,UAAU,CAA6B;IAC/C,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,eAAe,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,OAAO,CAAmC;IAClD,OAAO,CAAC,aAAa,CAAyB;IAC9C,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,OAAO,CAAC,CAAS;IACzB,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAa;IACnC,OAAO,CAAC,oBAAoB,CAA2C;IAEvE,kCAAkC;IAClC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK1B,kDAAkD;IAClD,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKnC,uCAAuC;IACvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM/C,wDAAwD;IACxD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAKrC,yEAAyE;IACzE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKlC,iDAAiD;IACjD,OAAO,CAAC,YAAY,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAK/D,gDAAgD;IAChD,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAK9C;;;;;;;;;;OAUG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI;IAKhE,iCAAiC;IACjC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAKhD,mEAAmE;IACnE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKhC,+EAA+E;IAC/E,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAKxC,+CAA+C;IAC/C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK5B,oDAAoD;IACpD,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI;IAKtC,mCAAmC;IACnC,eAAe,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAKlD,+BAA+B;IAC/B,MAAM,CAAC,YAAY,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,IAAI,GAAG,IAAI;IAK3D,0DAA0D;IAC1D,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAKrC,qFAAqF;IACrF,KAAK,IAAI,OAAO;IA4GhB,OAAO,CAAC,SAAS;CA6BlB"}

package/dist/core/ReelViewport.d.ts

@@ -0,0 +1,43 @@
+import { Container, Graphics } from 'pixi.js';
+import { Disposable } from '../utils/Disposable.js';
+/**
+ * The clipping window + layering tricks for a reel set.
+ *
+ * The viewport is the "looking-glass" of the slot: a rectangle the size
+ * of the visible grid with a PixiJS mask so symbols scrolling above or
+ * below the visible rows are hidden. It also provides three stacking
+ * layers so win animations can break out of the mask:
+ *
+ *   - `maskedContainer` — the normal place for reels. Clipped to the
+ *     visible area so buffer rows never leak.
+ *   - `unmaskedContainer` — rendered on top of the mask. Use for a symbol
+ *     whose celebration animation expands beyond its cell (a big expanding
+ *     wild, a splash frame).
+ *   - `spotlightContainer` — above everything else. Win spotlight lifts
+ *     winning symbols here temporarily so dim overlay + bounce don't clip.
+ *
+ * `dimOverlay` is a semi-transparent rectangle the spotlight fades in
+ * behind the promoted winners to visually push the losers into the
+ * background.
+ */
+export declare class ReelViewport extends Container implements Disposable {
+    readonly maskedContainer: Container;
+    readonly unmaskedContainer: Container;
+    readonly spotlightContainer: Container;
+    readonly dimOverlay: Graphics;
+    private _mask;
+    private _isDestroyed;
+    constructor(width: number, height: number, position?: {
+        x: number;
+        y: number;
+    });
+    get isDestroyed(): boolean;
+    /** Show the dim overlay with given opacity. */
+    showDim(alpha?: number): void;
+    /** Hide the dim overlay. */
+    hideDim(): void;
+    /** Update mask size (e.g., for Megaways variable rows). */
+    updateMaskSize(width: number, height: number): void;
+    destroy(): void;
+}
+//# sourceMappingURL=ReelViewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ReelViewport.d.ts","sourceRoot":"","sources":["../../src/core/ReelViewport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,YAAa,SAAQ,SAAU,YAAW,UAAU;IAC/D,SAAgB,eAAe,EAAE,SAAS,CAAC;IAC3C,SAAgB,iBAAiB,EAAE,SAAS,CAAC;IAC7C,SAAgB,kBAAkB,EAAE,SAAS,CAAC;IAC9C,SAAgB,UAAU,EAAE,QAAQ,CAAC;IAErC,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,YAAY,CAAS;gBAG3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAmB;IAkCrD,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED,+CAA+C;IAC/C,OAAO,CAAC,KAAK,GAAE,MAAY,GAAG,IAAI;IAKlC,4BAA4B;IAC5B,OAAO,IAAI,IAAI;IAIf,2DAA2D;IAC3D,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAKnD,OAAO,IAAI,IAAI;CAKhB"}

package/dist/core/StopSequencer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The "what do I land on" queue for one reel.
+ *
+ * When a reel enters its stop phase, the `SpinController` loads the
+ * target frame (the exact list of symbol ids that should appear on
+ * screen, top-to-bottom, including the off-screen buffers). As the reel
+ * keeps scrolling downward during deceleration, every `ReelMotion` wrap
+ * event asks this sequencer for the next symbol — and it hands them back
+ * from the END of the frame first, because new symbols arrive at the
+ * top of a reel scrolling downward.
+ *
+ * After the last symbol is consumed the reel lands, and what you see on
+ * screen matches the loaded frame exactly.
+ */
+export declare class StopSequencer {
+    private _frame;
+    private _remaining;
+    /** Load a target frame in top-to-bottom order. */
+    setFrame(frame: string[]): void;
+    /** Deliver the next symbol (consumed from the end of the frame). */
+    next(): string;
+    get hasRemaining(): boolean;
+    get remaining(): number;
+    reset(): void;
+}
+//# sourceMappingURL=StopSequencer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StopSequencer.d.ts","sourceRoot":"","sources":["../../src/core/StopSequencer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAa;IAE/B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAK/B,oEAAoE;IACpE,IAAI,IAAI,MAAM;IAQd,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK,IAAI,IAAI;CAId"}

package/dist/debug/debug.d.ts

@@ -0,0 +1,65 @@
+import { ReelSet } from '../core/ReelSet.js';
+/**
+ * Debug snapshot — plain JSON representation of the entire reel state.
+ *
+ * Designed for AI agents that cannot see the canvas.
+ * Returns no PixiJS display objects, only serializable data.
+ */
+export interface DebugSnapshot {
+    timestamp: number;
+    isSpinning: boolean;
+    currentSpeed: string;
+    availableSpeeds: string[];
+    spotlightActive: boolean;
+    reelCount: number;
+    visibleRows: number;
+    reels: DebugReelSnapshot[];
+    grid: string[][];
+}
+export interface DebugReelSnapshot {
+    index: number;
+    speed: number;
+    isStopping: boolean;
+    allSymbols: {
+        row: number;
+        symbolId: string;
+        y: number;
+    }[];
+    visibleSymbols: string[];
+}
+/**
+ * Take a plain-JSON snapshot of the entire reel set state.
+ *
+ * This is the primary debugging tool for AI agents. The output is
+ * a serializable object with no circular references, no PixiJS types.
+ *
+ * ```ts
+ * const state = debugSnapshot(reelSet);
+ * console.log(JSON.stringify(state, null, 2));
+ * ```
+ */
+export declare function debugSnapshot(reelSet: ReelSet): DebugSnapshot;
+/**
+ * Pretty-print the grid as an ASCII table.
+ *
+ * ```
+ * ┌────────┬────────┬────────┬────────┬────────┐
+ * │ cherry │ lemon  │ bar    │ seven  │ cherry │
+ * │ plum   │ cherry │ wild   │ lemon  │ orange │
+ * │ orange │ bell   │ cherry │ plum   │ bell   │
+ * └────────┴────────┴────────┴────────┴────────┘
+ * ```
+ */
+export declare function debugGrid(reelSet: ReelSet): string;
+/**
+ * Enable debug mode: attaches debug utilities to `window.__PIXI_REELS_DEBUG`.
+ *
+ * After calling this, an AI agent can run in the browser console:
+ * ```js
+ * __PIXI_REELS_DEBUG.snapshot()  // full state JSON
+ * __PIXI_REELS_DEBUG.grid()      // ASCII grid
+ * __PIXI_REELS_DEBUG.log()       // console.log the grid
+ * ```
+ */
+export declare function enableDebug(reelSet: ReelSet): void;
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/debug/debug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC3D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CA+B7D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAqBlD;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgClD"}

package/dist/events/EventEmitter.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Lightweight typed event emitter with zero dependencies.
+ *
+ * Usage:
+ * ```ts
+ * interface MyEvents {
+ *   'foo': [x: number, y: string];
+ *   'bar': [];
+ * }
+ * const emitter = new EventEmitter<MyEvents>();
+ * emitter.on('foo', (x, y) => console.log(x, y));
+ * emitter.emit('foo', 42, 'hello');
+ * ```
+ */
+export declare class EventEmitter<TEvents extends Record<string, unknown[]>> {
+    private _listeners;
+    on<K extends keyof TEvents>(event: K, fn: (...args: TEvents[K]) => void, context?: unknown): this;
+    once<K extends keyof TEvents>(event: K, fn: (...args: TEvents[K]) => void, context?: unknown): this;
+    off<K extends keyof TEvents>(event: K, fn?: (...args: TEvents[K]) => void, context?: unknown): this;
+    emit<K extends keyof TEvents>(event: K, ...args: TEvents[K]): boolean;
+    removeAllListeners(event?: keyof TEvents): this;
+    listenerCount(event: keyof TEvents): number;
+    private _add;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/events/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../../src/events/EventEmitter.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;GAaG;AACH,qBAAa,YAAY,CAAC,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IACjE,OAAO,CAAC,UAAU,CAA6C;IAE/D,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EACxB,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACjC,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IAIP,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAC1B,KAAK,EAAE,CAAC,EACR,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EACjC,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IAIP,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EACzB,KAAK,EAAE,CAAC,EACR,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,EAClC,OAAO,CAAC,EAAE,OAAO,GAChB,IAAI;IAoBP,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO;IAerE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,OAAO,GAAG,IAAI;IAS/C,aAAa,CAAC,KAAK,EAAE,MAAM,OAAO,GAAG,MAAM;IAI3C,OAAO,CAAC,IAAI;CAcb"}

package/dist/events/ReelEvents.d.ts

@@ -0,0 +1,40 @@
+import { SpeedProfile } from '../config/types.js';
+/** Position of a symbol on the reel grid. */
+export interface SymbolPosition {
+    reelIndex: number;
+    rowIndex: number;
+}
+/** Result returned when a spin completes. */
+export interface SpinResult {
+    /** Final symbol grid [reelIndex][rowIndex]. */
+    symbols: string[][];
+    /** Whether the spin was skipped/slam-stopped. */
+    wasSkipped: boolean;
+    /** Total spin duration in milliseconds. */
+    duration: number;
+}
+/** Events emitted by a ReelSet. */
+export interface ReelSetEvents extends Record<string, unknown[]> {
+    'spin:start': [];
+    'spin:allStarted': [];
+    'spin:stopping': [reelIndex: number];
+    'spin:reelLanded': [reelIndex: number, symbols: string[]];
+    'spin:allLanded': [result: SpinResult];
+    'spin:complete': [result: SpinResult];
+    'skip:requested': [];
+    'skip:completed': [];
+    'speed:changed': [profile: SpeedProfile, previous: SpeedProfile];
+    'spotlight:start': [positions: SymbolPosition[]];
+    'spotlight:end': [];
+    'destroyed': [];
+}
+/** Events emitted by an individual Reel. */
+export interface ReelEvents extends Record<string, unknown[]> {
+    'phase:enter': [phaseName: string];
+    'phase:exit': [phaseName: string];
+    'symbol:created': [symbolId: string, row: number];
+    'symbol:recycled': [symbolId: string, row: number];
+    'landed': [symbols: string[]];
+    'destroyed': [];
+}
+//# sourceMappingURL=ReelEvents.d.ts.map

package/dist/events/ReelEvents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReelEvents.d.ts","sourceRoot":"","sources":["../../src/events/ReelEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,6CAA6C;AAC7C,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAc,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC9D,YAAY,EAAE,EAAE,CAAC;IACjB,iBAAiB,EAAE,EAAE,CAAC;IACtB,eAAe,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACrC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1D,gBAAgB,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACvC,eAAe,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,gBAAgB,EAAE,EAAE,CAAC;IACrB,gBAAgB,EAAE,EAAE,CAAC;IACrB,eAAe,EAAE,CAAC,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,CAAC,CAAC;IACjE,iBAAiB,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;IACjD,eAAe,EAAE,EAAE,CAAC;IACpB,WAAW,EAAE,EAAE,CAAC;CACjB;AAED,4CAA4C;AAC5C,MAAM,WAAW,UAAW,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;IAC3D,aAAa,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACnC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClC,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAClD,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9B,WAAW,EAAE,EAAE,CAAC;CACjB"}

package/dist/frame/FrameBuilder.d.ts

@@ -0,0 +1,50 @@
+import { RandomSymbolProvider } from './RandomSymbolProvider.js';
+/** Context passed through the middleware pipeline. */
+export interface FrameContext {
+    /** Reel column index. */
+    readonly reelIndex: number;
+    /** Total visible rows. */
+    readonly visibleRows: number;
+    /** Buffer symbols above visible area. */
+    readonly bufferAbove: number;
+    /** Buffer symbols below visible area. */
+    readonly bufferBelow: number;
+    /** The symbol array being built (buffer + visible + buffer). Mutable by middleware. */
+    symbols: string[];
+    /** Target symbols from setResult() (visible rows only), if available. */
+    readonly targetSymbols?: string[];
+    /** Whether the reel is currently spinning. */
+    readonly isSpinning: boolean;
+    /** Arbitrary metadata middleware can use to communicate. */
+    metadata: Record<string, unknown>;
+}
+/** Middleware that participates in frame building. */
+export interface FrameMiddleware {
+    readonly name: string;
+    /** Lower priority runs first. */
+    readonly priority: number;
+    process(context: FrameContext, next: () => void): void;
+}
+/**
+ * Builds symbol frames using a middleware pipeline.
+ *
+ * Built-in middleware handles random fill and target placement.
+ * Users can inject custom middleware for features like multiplier encoding
+ * or triple-prevention.
+ */
+export declare class FrameBuilder {
+    private _randomProvider;
+    private _middlewares;
+    private _sorted;
+    constructor(_randomProvider: RandomSymbolProvider);
+    /** Add a middleware to the pipeline. */
+    use(middleware: FrameMiddleware): this;
+    /** Remove a middleware by name. */
+    remove(name: string): this;
+    /** Build a frame for a single reel. */
+    build(reelIndex: number, visibleRows: number, bufferAbove: number, bufferBelow: number, targetSymbols?: string[], isSpinning?: boolean): string[];
+    /** Build frames for all reels. */
+    buildAll(reelCount: number, visibleRows: number, bufferAbove: number, bufferBelow: number, targetSymbols?: string[][], isSpinning?: boolean): string[][];
+    get randomProvider(): RandomSymbolProvider;
+}
+//# sourceMappingURL=FrameBuilder.d.ts.map

package/dist/frame/FrameBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameBuilder.d.ts","sourceRoot":"","sources":["../../src/frame/FrameBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uFAAuF;IACvF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACxD;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IAIX,OAAO,CAAC,eAAe;IAHnC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,OAAO,CAAS;gBAEJ,eAAe,EAAE,oBAAoB;IAMzD,wCAAwC;IACxC,GAAG,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAMtC,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAK1B,uCAAuC;IACvC,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EAAE,EACxB,UAAU,GAAE,OAAe,GAC1B,MAAM,EAAE;IA+BX,kCAAkC;IAClC,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,aAAa,CAAC,EAAE,MAAM,EAAE,EAAE,EAC1B,UAAU,GAAE,OAAe,GAC1B,MAAM,EAAE,EAAE;IAab,IAAI,cAAc,IAAI,oBAAoB,CAEzC;CACF"}

package/dist/frame/OffsetCalculator.d.ts

@@ -0,0 +1,19 @@
+import { OffsetConfig } from '../config/types.js';
+/**
+ * Computes X-position offsets for symbols to create visual effects
+ * like trapezoid perspective.
+ */
+export declare class OffsetCalculator {
+    private _reelCount;
+    private _totalRows;
+    private _symbolWidth;
+    private _config;
+    private _offsets;
+    constructor(_reelCount: number, _totalRows: number, _symbolWidth: number, _config: OffsetConfig);
+    /** Get X offset for a specific reel and row. */
+    getOffset(reelIndex: number, rowIndex: number): number;
+    /** Get all offsets as a 2D array [reelIndex][rowIndex]. */
+    get offsets(): readonly (readonly number[])[];
+    private _compute;
+}
+//# sourceMappingURL=OffsetCalculator.d.ts.map

package/dist/frame/OffsetCalculator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OffsetCalculator.d.ts","sourceRoot":"","sources":["../../src/frame/OffsetCalculator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,oBAAoB,CAAC;AAExE;;;GAGG;AACH,qBAAa,gBAAgB;IAIzB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,OAAO;IANjB,OAAO,CAAC,QAAQ,CAAkB;gBAGxB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,YAAY;IAK/B,gDAAgD;IAChD,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAItD,2DAA2D;IAC3D,IAAI,OAAO,IAAI,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAE5C;IAED,OAAO,CAAC,QAAQ;CA8BjB"}

package/dist/frame/RandomSymbolProvider.d.ts

@@ -0,0 +1,27 @@
+import { SymbolData } from '../config/types.js';
+/**
+ * Weighted random symbol selector using binary search on cumulative weights.
+ *
+ * Supports exclusion lists for symbols that shouldn't appear during
+ * spinning or in buffer areas.
+ */
+export declare class RandomSymbolProvider {
+    private _symbols;
+    private _weights;
+    private _cumulativeWeights;
+    private _totalWeight;
+    private _excludeSpinning;
+    private _excludeBuffer;
+    constructor(symbolsData: Record<string, SymbolData>);
+    /** Get a random symbol, optionally excluding buffer-only symbols. */
+    next(useBufferExclusion?: boolean): string;
+    /** Set symbols to exclude during spinning. */
+    setExcludeSpinning(symbolIds: string[]): void;
+    /** Set symbols to exclude from buffer (above/below) areas. */
+    setExcludeBuffer(symbolIds: string[]): void;
+    /** Update weights at runtime (e.g., for different game modes). */
+    updateWeights(symbolsData: Record<string, SymbolData>): void;
+    private _rebuildWeights;
+    private _pickWeighted;
+}
+//# sourceMappingURL=RandomSymbolProvider.d.ts.map

package/dist/frame/RandomSymbolProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RandomSymbolProvider.d.ts","sourceRoot":"","sources":["../../src/frame/RandomSymbolProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;GAKG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,kBAAkB,CAAgB;IAC1C,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,cAAc,CAAqB;gBAE/B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC;IAMnD,qEAAqE;IACrE,IAAI,CAAC,kBAAkB,GAAE,OAAe,GAAG,MAAM;IAyCjD,8CAA8C;IAC9C,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAI7C,8DAA8D;IAC9D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI;IAI3C,kEAAkE;IAClE,aAAa,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;IAM5D,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,aAAa;CActB"}