@energy8platform/shell 0.4.0 → 0.5.0

package/dist/pixi.d.ts

@@ -18,7 +18,11 @@ declare class EventEmitter<TEvents extends {}> {
     removeAllListeners(event?: keyof TEvents): this;
 }
 
-type ShellMode = 'base' | 'freeSpins' | 'replay';
+/** `freeSpins` and `bonus` are the SAME bar layout (host-driven hero + Total Win); `freeSpins` is
+ *  kept as a back-compat alias for the common case (its readout is derived current/total), while
+ *  `bonus` pairs with `setBonus()` to show a game-supplied label + value (adventure, hold-and-spin,
+ *  respins — anything that isn't a plain free-spins counter). */
+type ShellMode = 'base' | 'bonus' | 'freeSpins' | 'replay';
 interface CurrencyConfig {
     symbol: string;
     position: 'left' | 'right';
@@ -207,6 +211,19 @@ interface FreeSpinsState {
     total: number;
     totalWin: number;
 }
+/** A game-supplied bonus readout for the bar hero, set via `setBonus()`. Generalizes the
+ *  free-spins counter: the shell renders `label` (localized via the shell translator, so a game
+ *  i18n entry for it is honoured) + `value` (a pre-formatted string, shown verbatim — "2 / 10",
+ *  "3", "×5", "7 coins") + the Total Win accumulator. The shell stays free of any per-game bonus
+ *  concept — the label/value semantics live in the game/host. */
+interface BonusReadout {
+    /** Bar label, e.g. 'Free spins' | 'Adventure' | 'Hold & Spin'. Run through the shell translator. */
+    label: string;
+    /** Pre-formatted counter value shown verbatim (NOT translated). */
+    value: string;
+    /** Cumulative bonus win for the Total Win readout. */
+    totalWin: number;
+}
 /** One footer button of a generic modal. Clicking it runs `on` (if any), then closes the modal. */
 interface ModalAction {
     title: string;
@@ -285,6 +302,12 @@ interface ShellState {
     turbo: number;
     buyBonusEnabled: boolean;
     freeSpins: FreeSpinsState;
+    /** Game-supplied bonus label + value override (from `setBonus()`). When null the bar derives the
+     *  readout from `freeSpins` (label 'Free spins', value current/total) — the back-compat default. */
+    bonus: {
+        label: string;
+        value: string;
+    } | null;
     /** The currently activated `feature` option (e.g. Ante), or null. Drives the
      *  effective-bet readout tint and the BUY BONUS → DISABLE toggle on the bar. */
     activeFeature: BonusOption$1 | null;
@@ -473,7 +496,7 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     tokens: ShellTokens;
     layout: ShellLayoutMode;
     soundOn: boolean;
-    readonly engineVersion = "0.4.0";
+    readonly engineVersion = "0.5.0";
     readonly actions: ShellActions;
     private renderer;
     private i18n;
@@ -516,6 +539,10 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     setTurbo(level: number): void;
     setBuyBonusEnabled(enabled: boolean): void;
     setFreeSpins(fs: FreeSpinsState): void;
+    /** Generic bonus readout (adventure / hold-and-spin / respins). Sets a game-supplied label+value
+     *  override for the bar hero and folds `totalWin` into the shared accumulator. Pairs with
+     *  `setMode('bonus')`. `setFreeSpins()` clears the override back to the derived current/total. */
+    setBonus(b: BonusReadout): void;
     setTheme(theme: ThemeConfig): void;
     setLanguage(lang: string): void;
     setSocial(isSocial: boolean): void;
@@ -539,7 +566,7 @@ interface I18n {
 declare function createI18n(opts: I18nOptions): I18n;
 
 /** The @energy8platform/shell package version, stamped into the game-info footer. */
-declare const PACKAGE_VERSION = "0.4.0";
+declare const PACKAGE_VERSION = "0.5.0";
 
 /** A shell: the renderer-agnostic controller plus the surface facade (safeArea/barHeight/setVisible)
  *  an embedding host reads. `createShell`, `createGameShell` and `createPixiShell` all return this. */
@@ -679,4 +706,4 @@ declare function createPixiShell(config: PixiShellConfig): PixiGameShell;
 declare function removePixiShell(): Promise<void>;
 
 export { DEFAULT_ACCENT, PACKAGE_VERSION, PixiRenderer, SCHEMES, ShellController, createI18n, createPixiShell, createShell, normalizeLang, removePixiShell, resolveConfig, resolveTheme, socialize };
-export type { AutoplayConfig, AutoplayOptions, BonusCardContext, BonusOption, CellRef, CreateShellOptions, CurrencyConfig, FreeSpinsState, GameInfoContent, GameInfoSection, GameMode, I18n, I18nOptions, Lang, ModalAction, ModalOptions, OverlayHandle, OverlayRequest, PaylineDef, PaytableRow, PixiGameShell, PixiShellConfig, PixiShellSurface, ReplayModalOptions, ResolvedShellConfig, SafeArea, ShapeDef, Shell, ShellActions, ShellConfig, ShellEvents, ShellFeatures, ShellHost, ShellLayoutMode, ShellMode, ShellRenderer, ShellState, ShellSurface, ShellTokens, ThemeConfig, WinSection };
+export type { AutoplayConfig, AutoplayOptions, BonusCardContext, BonusOption, BonusReadout, CellRef, CreateShellOptions, CurrencyConfig, FreeSpinsState, GameInfoContent, GameInfoSection, GameMode, I18n, I18nOptions, Lang, ModalAction, ModalOptions, OverlayHandle, OverlayRequest, PaylineDef, PaytableRow, PixiGameShell, PixiShellConfig, PixiShellSurface, ReplayModalOptions, ResolvedShellConfig, SafeArea, ShapeDef, Shell, ShellActions, ShellConfig, ShellEvents, ShellFeatures, ShellHost, ShellLayoutMode, ShellMode, ShellRenderer, ShellState, ShellSurface, ShellTokens, ThemeConfig, WinSection };