@energy8platform/shell 0.6.4 → 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;
@@ -452,6 +454,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. */
@@ -513,7 +520,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;
@@ -557,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;
@@ -595,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.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. */
@@ -661,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;
@@ -672,10 +682,6 @@ declare class PixiRenderer implements ShellRenderer {
     closeLayer(): void;
     private clearLayer;
     fitModals(): void;
-    /** Replay's reopen path: a replay modal can rebuild itself (e.g. after a replay completes). It is
-     *  routed back through the controller-equivalent open flow so the layer stack + backdrop stay in
-     *  sync — mirrors PixiGameShell.openReplay (push a fresh replay modal). */
-    private openReplayInternal;
     /** Snapshot the scene behind the modal layer and blur it — the Pixi analogue of the overlay's
      *  `backdrop-filter: blur(20px) saturate(120%)`. Static (captured at open time): the game is paused
      *  under a modal, so a live re-blur each frame isn't worth the cost. */

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.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) {
@@ -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;
@@ -1932,6 +1934,11 @@ function makeText(str, opts) {
     if (opts.wrapWidth != null) {
         style.wordWrap = true;
         style.wordWrapWidth = opts.wrapWidth;
+        // CJK (and any long unbroken run) has no spaces to wrap on — without breakWords the line
+        // overflows the wrap width instead of wrapping. This is the single shell text helper (How to
+        // Play, disclaimer, Game Info section titles, mode table, win messages, buy-bonus cards), so
+        // one flag fixes wrapping everywhere.
+        style.breakWords = true;
     }
     if (opts.lineHeight != null)
         style.lineHeight = opts.lineHeight;
@@ -5957,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() {
@@ -5991,7 +6002,7 @@ class PixiRenderer {
                 layer = openAutoplayPicker(this.ctx);
                 break;
             case 'replay':
-                layer = buildReplayModal(this.ctx, req.opts, () => this.openReplayInternal(req.opts));
+                layer = buildReplayModal(this.ctx, req.opts, () => this.host.openReplay(req.opts));
                 break;
             case 'modal':
                 layer = buildModal(this.ctx, req.opts);
@@ -6065,15 +6076,6 @@ class PixiRenderer {
     fitModals() {
         this.currentLayer?.fit?.();
     }
-    /** Replay's reopen path: a replay modal can rebuild itself (e.g. after a replay completes). It is
-     *  routed back through the controller-equivalent open flow so the layer stack + backdrop stay in
-     *  sync — mirrors PixiGameShell.openReplay (push a fresh replay modal). */
-    openReplayInternal(opts) {
-        if (this.destroyed)
-            return;
-        const layer = buildReplayModal(this.ctx, opts, () => this.openReplayInternal(opts));
-        this.pushLayer(layer);
-    }
     // ── frosted backdrop ─────────────────────────────────────────────────────────
     /** Snapshot the scene behind the modal layer and blur it — the Pixi analogue of the overlay's
      *  `backdrop-filter: blur(20px) saturate(120%)`. Static (captured at open time): the game is paused
@@ -6170,6 +6172,7 @@ class PixiRenderer {
             get layout() { return host.layout; },
             get soundOn() { return host.soundOn; },
             get actions() { return host.actions; },
+            openReplay: (opts) => host.openReplay(opts),
             t: (s) => host.t(s),
             formatCurrency: (n, win) => host.formatCurrency(n, win),
             emit: host.emit.bind(host),