@energy8platform/game-engine 0.22.0 → 0.24.0

package/dist/slot.d.ts

@@ -5,8 +5,11 @@ interface SymbolView extends Container {
     playIdle?(): void;
     playWin?(): Promise<void>;
     showStatic?(): void;
-    /** Resize the symbol to the given cell size in pixels. */
-    resize?(size: number): void;
+    /** Resize the symbol to the given cell size in pixels (square scalar or rectangular). */
+    resize?(size: number | {
+        width: number;
+        height: number;
+    }): void;
 }
 /** Game-supplied factory: build the view for a symbol id (sprite / layered sprites / Spine / composite). */
 type SymbolResolver = (symbolId: string) => SymbolView | null;
@@ -18,7 +21,10 @@ interface SymbolTextures {
 }
 interface AnimatedSymbolConfig {
     textures: SymbolTextures;
-    size: number;
+    size: number | {
+        width: number;
+        height: number;
+    };
     fps?: number;
 }
 /** Built-in SymbolView: a static base sprite with optional idle/win spritesheet frames. */
@@ -26,11 +32,15 @@ declare class AnimatedSymbol extends Container implements SymbolView {
     private _base;
     private _anim;
     private _textures;
-    private _size;
+    private _w;
+    private _h;
     private _fps;
     constructor(config: AnimatedSymbolConfig);
     setTextures(t: SymbolTextures): void;
-    resize(size: number): void;
+    resize(size: number | {
+        width: number;
+        height: number;
+    }): void;
     showStatic(): void;
     playIdle(): void;
     playWin(): Promise<void>;
@@ -70,13 +80,18 @@ interface CellState {
     fresh?: boolean;
 }
 interface SymbolCellConfig {
-    size: number;
+    /** Square scalar or rectangular cell size in px. */
+    size: number | {
+        width: number;
+        height: number;
+    };
     resolve: SymbolResolver;
     frameStyle?: CellFrameStyle;
 }
 declare class SymbolCell extends Container {
     readonly __uiComponent: true;
-    private _size;
+    private _w;
+    private _h;
     private _resolve;
     private _style;
     private _frame;
@@ -99,6 +114,64 @@ declare class SymbolCell extends Container {
     private _badge;
 }
 
+/** Per-strip cell size override: a square scalar, or an explicit width/height. */
+type CellSizeSpec = number | {
+    width: number;
+    height: number;
+};
+/** Structural input any grid config (GridConfig / ReelGridConfig) satisfies. */
+interface GeometryInput {
+    cols: number;
+    /** Uniform row count. Ignored when `rowsPerReel` is set (and length matches `cols`). */
+    rows: number;
+    rowsPerReel?: number[];
+    /** Square cell size (shorthand: same width & height, all reels). */
+    cellSize: number;
+    /** Rectangular cells, uniform across reels. Override `cellSize`. */
+    cellWidth?: number;
+    cellHeight?: number;
+    /** Per-strip cell size (square scalar or {width,height}). Overrides the above for that reel. */
+    cellSizePerReel?: CellSizeSpec[];
+    /** Uniform gap (shorthand for both axes). */
+    gap?: number;
+    /** Horizontal gap between adjacent reels. Scalar, or per-boundary (length cols-1). */
+    colGap?: number | number[];
+    /** Vertical gap between rows. Scalar, or per-reel (length cols). */
+    rowGap?: number | number[];
+}
+interface ResolvedGeometry {
+    cols: number;
+    rowsPerReel: number[];
+    maxRows: number;
+    /** Per-reel cell width / height (px). */
+    cellW: number[];
+    cellH: number[];
+    /** Per-reel vertical gap between rows (px). */
+    rowGap: number[];
+    /** Horizontal gap between reel i and i+1 (px), length cols-1. */
+    colGap: number[];
+    /** Cell-centre X of each reel (px). */
+    colX: number[];
+    /** Row-0 cell-centre Y of each reel (px) — centring offset baked in. */
+    yOff: number[];
+    /** Total grid bounding size (px). */
+    gridW: number;
+    gridH: number;
+    /** Grid bounding-box centre in local coords (px). */
+    centerX: number;
+    centerY: number;
+    /** Top-left corner of the grid bounding box in local coords (px). */
+    leftX: number;
+    topY: number;
+}
+/** Resolve a grid config into a fully-populated per-reel geometry. */
+declare function resolveGeometry(g: GeometryInput): ResolvedGeometry;
+/** Cell-centre position from a resolved geometry. */
+declare function cellPositionOf(geom: ResolvedGeometry, col: number, row: number): {
+    x: number;
+    y: number;
+};
+
 interface DecorationConfig {
     texture?: Texture;
     padding?: number;
@@ -109,48 +182,80 @@ interface ReelGridConfig {
     rows: number;
     /** Per-reel row counts for Megaways / variable-height reels. Length must equal `cols`. */
     rowsPerReel?: number[];
+    /** Square cell size (shorthand: same width & height, all reels). */
     cellSize: number;
+    /** Rectangular cells, uniform across reels. Override `cellSize` when set. */
+    cellWidth?: number;
+    cellHeight?: number;
+    /** Per-strip cell size (square scalar or {width,height}). */
+    cellSizePerReel?: CellSizeSpec[];
+    /** Uniform gap (shorthand for both axes). */
     gap?: number;
+    /** Horizontal gap between adjacent reels. Scalar, or per-boundary (length cols-1). */
+    colGap?: number | number[];
+    /** Vertical gap between rows. Scalar, or per-reel (length cols). */
+    rowGap?: number | number[];
     resolve: SymbolResolver;
     frameStyle?: CellFrameStyle;
     decoration?: DecorationConfig;
     mask?: boolean;
 }
 /**
- * A grid of `SymbolCell`s. Supports uniform grids and variable-height reels (Megaways):
- * when `rowsPerReel` is set each reel is vertically centred inside the tallest reel's envelope.
+ * A grid of `SymbolCell`s. Supports uniform grids, variable-height reels (Megaways), and
+ * rectangular / per-strip cell sizes with per-strip gaps. All layout flows through a single
+ * resolved geometry (see grid/geometry.ts); every consumer reads positions via `cellPosition`
+ * and dimensions via `cellSize(col)` rather than assuming a square cell.
  */
 declare class ReelGrid extends Container {
     readonly __uiComponent: true;
-    private _cols;
-    private _rowsPerReel;
-    private _maxRows;
-    private _cellSize;
-    private _gap;
+    private _cfg;
+    private _geom;
     private _cells;
     private _cellLayer;
     private _resolve;
     private _frameStyle?;
     private _mask;
     constructor(config: ReelGridConfig);
+    private get _cols();
+    private get _rowsPerReel();
     private _buildCells;
+    /** Per-strip mask: one window per reel sized to that reel's own cell width × column height. */
     private _applyMask;
     get cols(): number;
     /** Tallest reel's row count (the grid's visual height in rows). */
     get rows(): number;
-    get cellSize(): number;
+    /** Cell dimensions (px) for a reel. Rectangular / per-strip aware. */
+    cellSize(col: number): {
+        width: number;
+        height: number;
+    };
+    /** The fully-resolved grid geometry (read-only view). */
+    get geometry(): ResolvedGeometry;
     rowsOf(col: number): number;
     get rowsPerReel(): number[];
-    /** Cell centre position. Variable-height reels are centred in the max-rows envelope. */
+    /** Cell centre position. Variable-height reels are centred about a shared centre line. */
     cellPosition(col: number, row: number): {
         x: number;
         y: number;
     };
+    /** Grid bounding-box centre in local coords. */
+    center(): {
+        x: number;
+        y: number;
+    };
     getCell(col: number, row: number): SymbolCell;
     setGrid(cells: CellData[][]): void;
     /** Rebuild the grid with new per-reel row counts (Megaways re-roll / dynamic rows). */
     reshape(rowsPerReel: number[]): void;
-    resize(cellSize: number): void;
+    /**
+     * Re-resolve geometry after a base cell-size change and reposition cells. Accepts a square
+     * scalar (updates `cellSize`) or explicit `{width,height}`. Per-strip overrides still apply.
+     * (Cell frames are not re-drawn here — a geometry change routes through a full rebuild upstream.)
+     */
+    resize(size: number | {
+        width: number;
+        height: number;
+    }): void;
 }
 
 interface CascadeStepData {
@@ -266,8 +371,19 @@ interface GridConfig {
     rows: number;
     /** Per-reel row counts (Megaways / variable-height reels). Length should equal `cols`. */
     rowsPerReel?: number[];
+    /** Square cell size (shorthand: same width & height, all reels). */
     cellSize: number;
+    /** Rectangular cells, uniform across reels. Override `cellSize` when set. */
+    cellWidth?: number;
+    cellHeight?: number;
+    /** Per-strip cell size (square scalar or {width,height}). Overrides the above for that reel. */
+    cellSizePerReel?: CellSizeSpec[];
+    /** Uniform gap (shorthand for both axes). */
     gap: number;
+    /** Horizontal gap between adjacent reels. Scalar, or per-boundary (length cols-1). Overrides `gap`. */
+    colGap?: number | number[];
+    /** Vertical gap between rows. Scalar, or per-reel (length cols). Overrides `gap`. */
+    rowGap?: number | number[];
     evaluation: EvaluationMode;
     /** For Megaways: clamp per-reel rows to [minRows, maxRows]. */
     minRows?: number;
@@ -557,6 +673,8 @@ declare function mergeReelConfig<T>(base: T, partial?: DeepPartial<T>): T;
 declare function resolveReelConfig(partial?: DeepPartial<ReelSystemConfig>): ReelSystemConfig;
 /** Effective per-reel row counts (resolves Megaways `rowsPerReel`, else uniform `rows`). */
 declare function effectiveRowsPerReel(grid: GridConfig): number[];
+/** Resolve a `GridConfig` into a fully-populated per-reel geometry (rectangular / per-strip aware). */
+declare function resolveGridGeometry(grid: GridConfig): ResolvedGeometry;
 /** Total ways-to-win for a ways/megaways grid (product of per-reel heights). */
 declare function waysCount(grid: GridConfig): number;
 
@@ -856,5 +974,5 @@ declare class MultiplierAccumulator {
     reset(boundary: CarryPolicy): void;
 }
 
-export { AnimatedSymbol, AnticipationController, BigWinOverlay, CascadeController, CountUpDisplay, DEFAULT_REEL_CONFIG, EASING_BY_NAME, FEATURES, FEATURE_KEYS, FEATURE_LIST, INTENSITY_SCALE, MultiplierAccumulator, PRESETS, PRESET_LIST, ReelGrid, ReelSpinController, SpinEngine, SymbolCell, TumbleController, createReelSystem, easingByName, effectiveRowsPerReel, mergeReelConfig, pickTier, resolveReelConfig, tierIndexAtValue, valueAt, waysCount };
-export type { AnimatedSymbolConfig, AnticipationConfig, AnticipationDecision, BigWinOverlayConfig, BlurConfig, CarryPolicy, CascadeAnim, CascadeConfig, CascadeStepData, CascadeTimings, CellData, CellFrameStyle, CellState, CountUpConfig, CreateReelSystemOptions, DecorationConfig, DeepPartial, EasingName, EvaluationMode, ExpandingWildConfig, FeatureContext, FeatureKey, FeaturesConfig, GiantConfig, GridConfig, HoldAndSpinConfig, Intensity, MotionConfig, MotionStyle, MultiplierConfig, MysteryConfig, NudgeConfig, PresetId, RandomWildConfig, ReelFeature, ReelGridConfig, ReelModifierConfig, ReelPreset, ReelSpinData, ReelSpinTimings, ReelStopPlan$1 as ReelStopPlan, ReelSystem, ReelSystemConfig, SettleConfig, SpinData, SpinRunOpts, ReelStopPlan as SpinStopPlan, SplitConfig, SquashConfig, StackedConfig, StickyConfig, StopMode, StopOrder, SymbolCellConfig, SymbolResolver, SymbolTextures, SymbolView, TransformConfig, TumbleStep, WalkingWildConfig, WinConfig, WinTier };
+export { AnimatedSymbol, AnticipationController, BigWinOverlay, CascadeController, CountUpDisplay, DEFAULT_REEL_CONFIG, EASING_BY_NAME, FEATURES, FEATURE_KEYS, FEATURE_LIST, INTENSITY_SCALE, MultiplierAccumulator, PRESETS, PRESET_LIST, ReelGrid, ReelSpinController, SpinEngine, SymbolCell, TumbleController, cellPositionOf, createReelSystem, easingByName, effectiveRowsPerReel, mergeReelConfig, pickTier, resolveGeometry, resolveGridGeometry, resolveReelConfig, tierIndexAtValue, valueAt, waysCount };
+export type { AnimatedSymbolConfig, AnticipationConfig, AnticipationDecision, BigWinOverlayConfig, BlurConfig, CarryPolicy, CascadeAnim, CascadeConfig, CascadeStepData, CascadeTimings, CellData, CellFrameStyle, CellSizeSpec, CellState, CountUpConfig, CreateReelSystemOptions, DecorationConfig, DeepPartial, EasingName, EvaluationMode, ExpandingWildConfig, FeatureContext, FeatureKey, FeaturesConfig, GeometryInput, GiantConfig, GridConfig, HoldAndSpinConfig, Intensity, MotionConfig, MotionStyle, MultiplierConfig, MysteryConfig, NudgeConfig, PresetId, RandomWildConfig, ReelFeature, ReelGridConfig, ReelModifierConfig, ReelPreset, ReelSpinData, ReelSpinTimings, ReelStopPlan$1 as ReelStopPlan, ReelSystem, ReelSystemConfig, ResolvedGeometry, SettleConfig, SpinData, SpinRunOpts, ReelStopPlan as SpinStopPlan, SplitConfig, SquashConfig, StackedConfig, StickyConfig, StopMode, StopOrder, SymbolCellConfig, SymbolResolver, SymbolTextures, SymbolView, TransformConfig, TumbleStep, WalkingWildConfig, WinConfig, WinTier };