@energy8platform/shell 0.6.5 → 0.6.6

package/dist/html.d.ts

@@ -390,8 +390,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;
@@ -516,7 +518,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;
@@ -560,9 +562,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;
@@ -598,7 +603,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. */
@@ -636,7 +641,7 @@ declare class HtmlRenderer implements ShellRenderer {
     applyTheme(tokens: ShellTokens): void;
     renderBar(): void;
     setLayout(): void;
-    animateMoney(field: 'balance' | 'win', from: number, to: number): void;
+    animateMoney(field: 'balance' | 'win', from: number, to: number, durationMs?: number): void;
     openOverlay(req: OverlayRequest): OverlayHandle | void;
     closeOverlay(): void;
     refreshSoundIcon?(_on: boolean): void;

package/dist/html.esm.js

@@ -1453,7 +1453,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) {
@@ -1720,10 +1720,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;
@@ -1733,7 +1733,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;
@@ -1742,7 +1744,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;
@@ -3888,13 +3890,13 @@ function buildReplayModal(host, opts, reopen) {
 const REMOVE_FADE_MS = 300;
 /** Count-up the value span (.ge-rd-val) of a readout, leaving its label untouched.
  *  Returns the count-up canceler so the renderer can stop it before the node is replaced. */
-function animateReadout(el, from, to, fmt) {
+function animateReadout(el, from, to, fmt, durationMs) {
     const val = el.querySelector('.ge-rd-val');
     if (!val) {
         el.textContent = fmt(to);
         return () => { };
     }
-    return countUp(val, from, to, fmt);
+    return durationMs == null ? countUp(val, from, to, fmt) : countUp(val, from, to, fmt, durationMs);
 }
 class HtmlRenderer {
     host;
@@ -3953,11 +3955,11 @@ class HtmlRenderer {
     setLayout() {
         this.renderBar();
     }
-    animateMoney(field, from, to) {
+    animateMoney(field, from, to, durationMs) {
         const fmt = (n) => this.host.formatCurrency(n, field === 'win');
         const el = this.barHost.querySelector(`[data-ge="${field}"]`);
         if (el)
-            this.moneyAnims.push(animateReadout(el, from, to, fmt));
+            this.moneyAnims.push(animateReadout(el, from, to, fmt, durationMs));
     }
     openOverlay(req) {
         const built = this.buildOverlay(req);