@energy8platform/shell 0.6.5 → 0.6.6

package/dist/pixi.d.ts

@@ -392,8 +392,10 @@ interface ShellRenderer {
     setLayout(layout: ShellLayoutMode): void;
     /** Apply colour tokens (CSS vars in DOM / repaint in Pixi). */
     applyTheme(tokens: ShellTokens): void;
-    /** Count a money readout from→to on the freshly-rendered bar (DOM rAF / Pixi ticker). */
-    animateMoney(field: 'balance' | 'win', from: number, to: number): void;
+    /** Count a money readout from→to on the freshly-rendered bar (DOM rAF / Pixi ticker).
+     *  `durationMs` overrides the renderer's default count-up length — a cascade/tumble scene
+     *  reporting a win per step needs each count-up to fit inside its step. */
+    animateMoney(field: 'balance' | 'win', from: number, to: number, durationMs?: number): void;
     /** Build + show an overlay from a controller-supplied model; return a handle for key routing
      *  and programmatic close. Returns void when nothing was shown. */
     openOverlay(req: OverlayRequest): OverlayHandle | void;
@@ -518,7 +520,7 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     tokens: ShellTokens;
     layout: ShellLayoutMode;
     soundOn: boolean;
-    readonly engineVersion = "0.6.5";
+    readonly engineVersion = "0.6.6";
     readonly actions: ShellActions;
     private renderer;
     private i18n;
@@ -562,9 +564,12 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     setBalance(n: number): void;
     /** Set the WIN readout. Counts up/down from the previous value by default. Pass
      *  `{ animate: false }` to SNAP instantly (renderBar cancels any in-flight count-up) — used by the
-     *  host to clear WIN to 0 at spin start, where an animated count-DOWN would look wrong. */
+     *  host to clear WIN to 0 at spin start, where an animated count-DOWN would look wrong.
+     *  `{ durationMs }` shortens/lengthens the count-up (default 450ms) — a scene reporting a win per
+     *  cascade step passes its step length so each count-up finishes before the next step lands. */
     setWin(n: number, opts?: {
         animate?: boolean;
+        durationMs?: number;
     }): void;
     setBet(n: number): void;
     setMode(mode: ShellMode): void;
@@ -600,7 +605,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.6.5";
+declare const PACKAGE_VERSION = "0.6.6";
 
 /** A shell: the renderer-agnostic controller plus the surface facade (safeArea/barHeight/setVisible)
  *  an embedding host reads. `createShell`, `createGameShell` and `createPixiShell` all return this. */
@@ -666,7 +671,7 @@ declare class PixiRenderer implements ShellRenderer {
     applyTheme(_tokens: ShellTokens): void;
     /** Count a money readout from→to on the freshly-rendered bar's value Text node. Mirrors
      *  PixiGameShell.animateMoney (which counted on the just-built bar's value Texts). */
-    animateMoney(field: 'balance' | 'win', from: number, to: number): void;
+    animateMoney(field: 'balance' | 'win', from: number, to: number, durationMs?: number): void;
     private cancelMoneyAnims;
     openOverlay(req: OverlayRequest): OverlayHandle | void;
     closeOverlay(): void;

package/dist/pixi.esm.js

@@ -1454,7 +1454,7 @@ class KeyboardController {
 
 // AUTO-GENERATED by scripts/gen-version.mjs — do not edit. Mirrors package.json "version".
 /** The @energy8platform/shell package version, stamped into the game-info footer. */
-const PACKAGE_VERSION = '0.6.5';
+const PACKAGE_VERSION = '0.6.6';
 
 /** Apply defaults to the raw config (the mount target lives on the renderer, not here). */
 function resolveConfig(config) {
@@ -1721,10 +1721,10 @@ class ShellController extends EventEmitter {
         this.renderer.renderBar();
     }
     // ── game-facing public API (mirrors GameShell/PixiGameShell) ───────────────────
-    money(field, from, to) {
+    money(field, from, to, durationMs) {
         this.renderer.renderBar();
         if (to !== from)
-            this.renderer.animateMoney(field, from, to);
+            this.renderer.animateMoney(field, from, to, durationMs);
     }
     setBalance(n) {
         const from = this.prevBalance;
@@ -1734,7 +1734,9 @@ class ShellController extends EventEmitter {
     }
     /** Set the WIN readout. Counts up/down from the previous value by default. Pass
      *  `{ animate: false }` to SNAP instantly (renderBar cancels any in-flight count-up) — used by the
-     *  host to clear WIN to 0 at spin start, where an animated count-DOWN would look wrong. */
+     *  host to clear WIN to 0 at spin start, where an animated count-DOWN would look wrong.
+     *  `{ durationMs }` shortens/lengthens the count-up (default 450ms) — a scene reporting a win per
+     *  cascade step passes its step length so each count-up finishes before the next step lands. */
     setWin(n, opts) {
         const from = this.prevWin;
         this.state.win = n;
@@ -1743,7 +1745,7 @@ class ShellController extends EventEmitter {
             this.renderer.renderBar(); // instant repaint from state; cancels running money anims
             return;
         }
-        this.money('win', from, n);
+        this.money('win', from, n, opts?.durationMs);
     }
     setBet(n) {
         this.state.bet = n;
@@ -5962,14 +5964,18 @@ class PixiRenderer {
     }
     /** Count a money readout from→to on the freshly-rendered bar's value Text node. Mirrors
      *  PixiGameShell.animateMoney (which counted on the just-built bar's value Texts). */
-    animateMoney(field, from, to) {
+    animateMoney(field, from, to, durationMs) {
         if (!this.bar)
             return;
+        // countUpText defaults durationMs to 450 — pass it only when the caller overrode it.
+        const count = (text, fmt) => durationMs == null
+            ? countUpText(this.ticker, text, from, to, fmt)
+            : countUpText(this.ticker, text, from, to, fmt, durationMs);
         if (field === 'balance' && this.bar.balanceValue) {
-            this.moneyAnims.push(countUpText(this.ticker, this.bar.balanceValue, from, to, (n) => this.ctx.fmt(n)));
+            this.moneyAnims.push(count(this.bar.balanceValue, (n) => this.ctx.fmt(n)));
         }
         else if (field === 'win' && this.bar.winValue) {
-            this.moneyAnims.push(countUpText(this.ticker, this.bar.winValue, from, to, (n) => this.ctx.fmtWin(n)));
+            this.moneyAnims.push(count(this.bar.winValue, (n) => this.ctx.fmtWin(n)));
         }
     }
     cancelMoneyAnims() {