@energy8platform/shell 0.6.4 → 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;
@@ -450,6 +452,11 @@ interface ShellHost {
     setVolumeRefresh(fn: ((key: VolumeKey, value: number) => void) | null): void;
     /** Logic-bearing actions invoked by renderer controls. */
     readonly actions: ShellActions;
+    /** Re-show the replay summary modal through the controller (keeps its OverlayHandle in sync).
+     *  Used as the modal's own reopen callback after START REPLAY, so a renderer never re-pushes a
+     *  replay modal behind the controller's back (which would strand `overlay` and dead-end the
+     *  next close). */
+    openReplay(opts: ReplayModalOptions): void;
 }
 /** Every state-changing thing a control can do. Each runs logic in the controller, emits the
  *  matching event, and triggers a re-render. Renderers MUST route input through these. */
@@ -511,7 +518,7 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     tokens: ShellTokens;
     layout: ShellLayoutMode;
     soundOn: boolean;
-    readonly engineVersion = "0.6.4";
+    readonly engineVersion = "0.6.6";
     readonly actions: ShellActions;
     private renderer;
     private i18n;
@@ -555,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;
@@ -593,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.4";
+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. */
@@ -631,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;
@@ -640,8 +650,6 @@ declare class HtmlRenderer implements ShellRenderer {
     fitBar(): void;
     private cancelMoneyAnims;
     private buildOverlay;
-    /** Opens a replay modal and shows it — used as the reopen callback after START REPLAY. */
-    private openReplayInternal;
     private showModal;
     /** Uniformly scale every open centred card modal (.ge-sheet) down so it fits a short/narrow
      *  popout. Covers pickers, generic + replay modals, AND the buy-bonus confirm (which is hosted

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.4';
+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);
@@ -4025,7 +4027,9 @@ class HtmlRenderer {
             }
             case 'replay': {
                 const opts = req.opts;
-                const reopen = () => { this.openReplayInternal(opts); };
+                // Reopen through the controller (not a renderer-direct re-push) so its OverlayHandle stays
+                // in sync — otherwise a reopened replay modal is untracked and the next close no-ops.
+                const reopen = () => { this.host.openReplay(opts); };
                 const root = buildReplayModal(this.host, opts, reopen);
                 return { root };
             }
@@ -4035,14 +4039,6 @@ class HtmlRenderer {
             }
         }
     }
-    /** Opens a replay modal and shows it — used as the reopen callback after START REPLAY. */
-    openReplayInternal(opts) {
-        if (this.destroyed)
-            return;
-        const reopen = () => { this.openReplayInternal(opts); };
-        const root = buildReplayModal(this.host, opts, reopen);
-        this.showModal(root);
-    }
     showModal(el, onKey) {
         // Drop focus from any open shell control so a stray Space/Enter doesn't re-activate it
         const active = document.activeElement;