@energy8platform/shell 0.6.5 → 0.6.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energy8platform/shell",
-  "version": "0.6.5",
+  "version": "0.6.6",
   "description": "Energy8 branded game shell — one logic core, pluggable html/pixi renderers behind a stable contract.",
   "type": "module",
   "main": "./dist/index.cjs.js",

package/src/core/ShellController.ts

@@ -304,9 +304,9 @@ export class ShellController extends EventEmitter<ShellEvents> implements ShellH
   }
 
   // ── game-facing public API (mirrors GameShell/PixiGameShell) ───────────────────
-  private money(field: 'balance' | 'win', from: number, to: number): void {
+  private money(field: 'balance' | 'win', from: number, to: number, durationMs?: number): void {
     this.renderer.renderBar();
-    if (to !== from) this.renderer.animateMoney(field, from, to);
+    if (to !== from) this.renderer.animateMoney(field, from, to, durationMs);
   }
   setBalance(n: number): void {
     const from = this.prevBalance;
@@ -316,8 +316,10 @@ export class ShellController extends EventEmitter<ShellEvents> implements ShellH
   }
   /** 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. */
-  setWin(n: number, opts?: { animate?: boolean }): void {
+   *  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 {
     const from = this.prevWin;
     this.state.win = n;
     this.prevWin = n;
@@ -325,7 +327,7 @@ export class ShellController extends EventEmitter<ShellEvents> implements ShellH
       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: number): void {
     this.state.bet = n;

package/src/core/renderer.ts

@@ -18,8 +18,10 @@ export 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;

package/src/core/version.ts

@@ -1,3 +1,3 @@
 // 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. */
-export const PACKAGE_VERSION = '0.6.5';
+export const PACKAGE_VERSION = '0.6.6';

package/src/ui/html/HtmlRenderer.ts

@@ -19,10 +19,10 @@ 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: HTMLElement, from: number, to: number, fmt: (n: number) => string): () => void {
+function animateReadout(el: HTMLElement, from: number, to: number, fmt: (n: number) => string, durationMs?: number): () => void {
   const val = el.querySelector('.ge-rd-val') as HTMLElement | null;
   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);
 }
 
 export class HtmlRenderer implements ShellRenderer {
@@ -87,10 +87,10 @@ export class HtmlRenderer implements ShellRenderer {
     this.renderBar();
   }
 
-  animateMoney(field: 'balance' | 'win', from: number, to: number): void {
+  animateMoney(field: 'balance' | 'win', from: number, to: number, durationMs?: number): void {
     const fmt = (n: number) => this.host.formatCurrency(n, field === 'win');
     const el = this.barHost.querySelector(`[data-ge="${field}"]`) as HTMLElement | null;
-    if (el) this.moneyAnims.push(animateReadout(el, from, to, fmt));
+    if (el) this.moneyAnims.push(animateReadout(el, from, to, fmt, durationMs));
   }
 
   openOverlay(req: OverlayRequest): OverlayHandle | void {

package/src/ui/pixi/PixiRenderer.ts

@@ -6,6 +6,7 @@ import {
   RenderTexture,
   Sprite,
   type Application,
+  type Text,
   type Ticker,
 } from 'pixi.js';
 import type { ShellRenderer, ShellHost, OverlayRequest, OverlayHandle } from '@/core/renderer';
@@ -109,16 +110,17 @@ export class PixiRenderer implements ShellRenderer {
 
   /** 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 {
     if (!this.bar) return;
+    // countUpText defaults durationMs to 450 — pass it only when the caller overrode it.
+    const count = (text: Text, fmt: (n: number) => string) =>
+      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)));
     }
   }