@energy8platform/platform-core 0.23.2 → 0.24.0

package/dist/index.d.ts

@@ -501,11 +501,12 @@ type ShellMode = 'base' | 'freeSpins' | 'replay';
 interface CurrencyConfig {
     symbol: string;
     position: 'left' | 'right';
-    /** Maximum fraction digits (default 2). The value is rounded to this precision. */
-    decimals?: number;
-    /** Minimum fraction digits (defaults to `decimals`). Trailing zeros are trimmed down to
-     *  this many places, so small wins keep their significant digits (e.g. 0.0673) while round
-     *  amounts stay compact (e.g. 0.30). */
+    /** Maximum fraction digits (default 2). Win / total-win readouts are rounded to this precision;
+     *  balance / bet / prices stay fixed at `minDecimals`. */
+    maxDecimals?: number;
+    /** Minimum fraction digits (defaults to `maxDecimals`). For win / total-win, trailing zeros are
+     *  trimmed down to this many places so small wins keep their significant digits (e.g. 0.0673)
+     *  while round amounts stay compact (e.g. 0.30). Everything else is shown at exactly this many. */
     minDecimals?: number;
     separator?: {
         thousands?: string;
@@ -552,8 +553,9 @@ interface BonusCardContext {
 interface ThemeConfig {
     /** Palette scheme: 'dark' (default) for dark games, 'light' for light backgrounds. */
     scheme?: 'dark' | 'light';
+    /** Brand accent — active states, the SPIN hover glow, and the BUY BONUS button.
+     *  (Per-bonus card accents are set on each `BonusOption.accentColor`.) */
     accent?: string;
-    buyBonusColor?: string;
 }
 /** One paytable entry: a symbol (text/image) and its win tiers, rendered "<count> x<multiplier>". */
 interface PaytableRow {
@@ -658,7 +660,9 @@ interface AutoplayOptions {
     remaining: number;
 }
 interface FreeSpinsState {
-    current: number;
+    /** Spin index for the `current / total` counter. Set to `null` (or omit) to instead show just
+     *  `total` as a single number — drive a countdown by decrementing `total` each spin. */
+    current?: number | null;
     total: number;
     totalWin: number;
 }

package/dist/index.esm.js

@@ -1026,7 +1026,7 @@ const PALETTE = {
     },
 };
 /** CSS custom-property block for the shell root. `scheme` picks the palette;
- *  only accent and buyBonus are additionally game-overridable. */
+ *  only the accent is additionally game-overridable. */
 function buildThemeVars(theme = {}) {
     const p = PALETTE[theme.scheme === 'light' ? 'light' : 'dark'];
     return [
@@ -1055,8 +1055,6 @@ function buildThemeVars(theme = {}) {
         `--shell-plaque-line: rgba(255,255,255,.22)`,
         `--shell-plaque-label: rgba(255,255,255,.6)`,
         `--shell-accent: ${theme.accent ?? DEFAULT_ACCENT}`,
-        // buy-bonus tint follows the accent by default; only overridden when set explicitly
-        `--shell-buybonus: ${theme.buyBonusColor ?? theme.accent ?? DEFAULT_ACCENT}`,
     ].join('; ') + ';';
 }
 
@@ -1120,7 +1118,7 @@ const SHELL_CSS = SHELL_FONT_CSS + `
 
 /* BUY BONUS — round accent badge, 2-line label, text pulses + accent glow on hover */
 #${SHELL_ROOT_ID} .ge-shell-buybonus { pointer-events:auto; cursor:pointer; box-sizing:border-box;
-  width:80px; height:80px; border-radius:50%; border:3px solid #000; background:var(--shell-buybonus);
+  width:80px; height:80px; border-radius:50%; border:3px solid #000; background:var(--shell-accent);
   color:#fff; font-weight:800; letter-spacing:.02em; font-size:13px; line-height:1.08; text-align:center;
   display:flex; align-items:center; justify-content:center; transition:transform .08s ease, box-shadow .12s ease; }
 #${SHELL_ROOT_ID} .ge-shell-buybonus span { display:inline-block; will-change:transform; }
@@ -1452,22 +1450,25 @@ const SHELL_CSS = SHELL_FONT_CSS + `
 
 /** The shared money formatter for every shell readout (balance, win, total win, bet, prices).
  *
- *  `decimals` is the MAXIMUM number of fraction digits; `minDecimals` (defaults to `decimals`)
- *  is the MINIMUM. The value is rounded to `decimals`, then trailing zeros are trimmed down to
- *  — but never past — `minDecimals`. With `minDecimals` unset both bounds are equal, so the
- *  output is always exactly `decimals` places (the classic behaviour).
+ *  `maxDecimals` is the MAXIMUM fraction digits (default 2); `minDecimals` (defaults to
+ *  `maxDecimals`) is the MINIMUM. By default the value is shown at exactly `minDecimals` places.
+ *  With `variableDecimals` — used only for win / total-win — it is rounded to `maxDecimals`, then
+ *  trailing zeros are trimmed down to (but never past) `minDecimals`, so small wins keep their
+ *  significant digits. Balance / bet / prices stay fixed at `minDecimals`.
  *
- *  Example with `decimals: 4, minDecimals: 2`:
- *    0.0673 → 0,0673   0.0670 → 0,067   0.0600 → 0,06
- *    0.0004 → 0,0004   0.0040 → 0,004   0.3000 → 0,30   0.0000 → 0,00
+ *  Example with `maxDecimals: 4, minDecimals: 2`:
+ *    fixed    → 0.0673 → 0,07     0.3 → 0,30
+ *    variable → 0.0673 → 0,0673   0.067 → 0,067   0.3 → 0,30   0 → 0,00
  */
-function formatCurrency(value, currency) {
-    const decimals = currency.decimals ?? 2;
-    const minDecimals = Math.max(0, Math.min(decimals, currency.minDecimals ?? decimals));
+function formatCurrency(value, currency, variableDecimals = false) {
+    const maxDecimals = currency.maxDecimals ?? 2;
+    const minDecimals = Math.max(0, Math.min(maxDecimals, currency.minDecimals ?? maxDecimals));
     const thousands = currency.separator?.thousands ?? '.';
     const decimal = currency.separator?.decimal ?? ',';
     const safe = Number.isFinite(value) ? value : 0;
-    const fixed = safe.toFixed(decimals); // round at the max precision, e.g. "0.0670"
+    // fixed callers round at minDecimals; variable callers round at maxDecimals then trim back down.
+    const places = variableDecimals ? maxDecimals : minDecimals;
+    const fixed = safe.toFixed(places);
     const [intPart, rawFrac = ''] = fixed.split('.');
     // trim trailing zeros, but keep at least `minDecimals` fraction digits
     let fracPart = rawFrac;
@@ -1628,6 +1629,7 @@ function iconBtn(ge, name, onClick, active = false) {
 function renderBottomBar(shell) {
     const { state, config } = shell;
     const fmt = (n) => formatCurrency(n, config.currency);
+    const fmtWin = (n) => formatCurrency(n, config.currency, true); // win / total-win: variable decimals
     const mobile = shell.layout === 'mobile';
     const bar = document.createElement('div');
     bar.className = 'ge-shell-bottom';
@@ -1648,8 +1650,13 @@ function renderBottomBar(shell) {
     const betShown = feature ? state.bet * feature.priceMultiplier : state.bet;
     const betValue = readout('bet-value', shell.t('Bet'), fmt(betShown));
     if (feature) {
+        const accent = effectiveAccent(feature);
         betValue.classList.add('ge-bet-feature');
-        betValue.style.color = effectiveAccent(feature);
+        betValue.style.color = accent;
+        // tint the "BET" label too (its .ge-lbl colour is set in CSS, so override inline)
+        const lbl = betValue.querySelector('.ge-lbl');
+        if (lbl)
+            lbl.style.color = accent;
     }
     const turbo = config.features.turbo > 0
         ? iconBtn('turbo', turboIcon(state.turbo), () => onTurbo(shell), state.turbo > 0) : null;
@@ -1666,10 +1673,13 @@ function renderBottomBar(shell) {
         auto = config.features.autoplay ? autoButton(shell) : null;
         buy = (config.features.buyBonus !== false || config.onBonusBuy) ? buyBtn(shell) : null;
     }
-    const winEl = state.win > 0 ? readout('win', shell.t('Win'), fmt(state.win)) : null;
+    const winEl = state.win > 0 ? readout('win', shell.t('Win'), fmtWin(state.win)) : null;
     // FS/replay left blocks: spins counter + accumulated Total Win (shown even at €0).
-    const fsCounter = showFsBlocks ? readout('fs-counter', shell.t('Free spins'), `${state.freeSpins.current} / ${state.freeSpins.total}`) : null;
-    const fsTotalWin = showFsBlocks ? readout('fs-totalwin', shell.t('Total win'), fmt(state.freeSpins.totalWin)) : null;
+    // current = number → "current / total"; current = null/undefined → just the (game-driven) total.
+    const fs = state.freeSpins;
+    const fsText = fs.current == null ? `${fs.total}` : `${fs.current} / ${fs.total}`;
+    const fsCounter = showFsBlocks ? readout('fs-counter', shell.t('Free spins'), fsText) : null;
+    const fsTotalWin = showFsBlocks ? readout('fs-totalwin', shell.t('Total win'), fmtWin(fs.totalWin)) : null;
     if (mobile) {
         // rows: [balance · win] · [menu · auto · spin · FS counter · Total Win · turbo · buy] · [− bet +]
         // FS counter + Total Win live in the controls row (alongside menu/turbo), not the top readouts.
@@ -2485,6 +2495,7 @@ function buildModal(opts) {
 function buildReplayModal(shell, opts) {
     const { bonusId, bet, payoutMultiplier } = opts;
     const fmt = (n) => formatCurrency(n, shell.config.currency);
+    const fmtWin = (n) => formatCurrency(n, shell.config.currency, true); // total win: variable decimals
     const bonus = Array.isArray(shell.config.features.buyBonus)
         ? shell.config.features.buyBonus.find((b) => b.id === bonusId)
         : undefined;
@@ -2513,7 +2524,7 @@ function buildReplayModal(shell, opts) {
     row('Cost multiplier', `${costMultiplier}×`);
     row('Total cost bet', fmt(bet * costMultiplier));
     row('Payout multiplier', `${payoutMultiplier}×`);
-    row('Total win', fmt(payoutMultiplier * bet), true);
+    row('Total win', fmtWin(payoutMultiplier * bet), true);
     ui.body.appendChild(rows);
     const actions = document.createElement('div');
     actions.className = 'ge-modal-actions';
@@ -2802,12 +2813,13 @@ class GameShell extends EventEmitter {
     }
     animateMoney() {
         const fmt = (n) => formatCurrency(n, this.config.currency);
+        const fmtWin = (n) => formatCurrency(n, this.config.currency, true); // win: variable decimals
         const bal = this.barHost.querySelector('[data-ge="balance"]');
         const win = this.barHost.querySelector('[data-ge="win"]');
         if (bal && this.state.balance !== this.prevBalance)
             this.moneyAnims.push(animateReadout(bal, this.prevBalance, this.state.balance, fmt));
         if (win && this.state.win !== this.prevWin)
-            this.moneyAnims.push(animateReadout(win, this.prevWin, this.state.win, fmt));
+            this.moneyAnims.push(animateReadout(win, this.prevWin, this.state.win, fmtWin));
         this.prevBalance = this.state.balance;
         this.prevWin = this.state.win;
     }