@energy8platform/platform-core 0.23.3 → 0.24.1

package/README.md

@@ -684,7 +684,7 @@ await removeGameShell();
 | `theme` | `ThemeConfig?` | `{ scheme?: 'dark' \| 'light', accent? }`. Defaults to dark. `accent` also tints the BUY BONUS button; per-card accents are `BonusOption.accentColor`. |
 | `language` | `string` | Currently `'en'` is the source language. |
 | `isSocial` | `boolean?` | Swap built-in text to social-casino vocabulary (bet → play, win → …). Game-supplied strings are untouched. |
-| `currency` | `CurrencyConfig` | `{ symbol, position: 'left'\|'right', decimals?, minDecimals?, separator? }`. |
+| `currency` | `CurrencyConfig` | `{ symbol, position: 'left'\|'right', maxDecimals?, minDecimals?, separator? }`. `maxDecimals` (default 2) / `minDecimals` (default `maxDecimals`): **win & total-win** show up to `maxDecimals`, trimming trailing zeros down to `minDecimals`; **balance / bet / prices** stay fixed at `minDecimals`. |
 | `availableBets` | `number[]` | Bet ladder shown in the bet picker. |
 | `defaultBet` / `currentBet` | `number` / `number \| null` | `currentBet` restores a saved bet; `null` falls back to `defaultBet`. |
 | `balance` / `win` | `number` | Initial readouts. |
@@ -715,7 +715,8 @@ the previous value.
 shell.setBalance(n); shell.setWin(n); shell.setBet(n);
 shell.setBusy(true);                 // disables controls mid-spin
 shell.setMode('freeSpins');
-shell.setFreeSpins({ current: 1, total: 10, totalWin: 0 });   // Free Spins + Total Win bar readout
+shell.setFreeSpins({ current: 1, total: 10, totalWin: 0 });   // counter shows "1 / 10"
+shell.setFreeSpins({ total: 9, totalWin: 0 });                // current omitted/null → single number "9" (decrement it for a countdown)
 shell.setAutoplay({ active: true, remaining: 25 });
 shell.setTurbo(2);
 shell.setBuyBonusEnabled(false);     // grey out BUY BONUS (e.g. insufficient balance)
@@ -768,7 +769,8 @@ draws the rest:
 - `{ type: 'controls' }` — auto-generated control legend.
 - `{ type: 'paytable', rows: PaytableRow[] }` — symbol → win tiers (`"<count> x<multiplier>"`).
 - `{ type: 'wins', kind, grid, … }` — auto-drawn win illustration. `kind` is `'classic'` (paylines),
-  `'cluster'`, `'anywhere'`, or `'ways'`.
+  `'cluster'`, `'anywhere'`, `'ways'`, or `'shapes'` — `{ kind: 'shapes', shapes: ShapeDef[] }` lists
+  named cell patterns (`{ cells: CellRef[], name, description? }`) as a grid-illustration row each.
 - `{ type: 'custom', title, html | node }` — your own rules markup.
 
 ```typescript

package/dist/index.cjs.js

@@ -1278,6 +1278,12 @@ const SHELL_CSS = SHELL_FONT_CSS + `
 #${SHELL_ROOT_ID} .ge-gi-mode-st span { color:var(--shell-plaque-label); font-size:10px; letter-spacing:.1em; text-transform:uppercase; }
 #${SHELL_ROOT_ID} .ge-gi-mode-st b { color:#fff; font-size:14px; font-weight:800; font-variant-numeric:tabular-nums; }
 #${SHELL_ROOT_ID} .ge-gi-mode-desc { color:rgba(255,255,255,.78); font-size:14px; line-height:1.5; margin:0; }
+/* shapes — row list (grid illustration left, name + description right), modes-style text */
+#${SHELL_ROOT_ID} .ge-gi-shapes { display:flex; flex-direction:column; }
+#${SHELL_ROOT_ID} .ge-gi-shape { display:flex; align-items:center; gap:16px; padding:12px 0; }
+#${SHELL_ROOT_ID} .ge-gi-shape + .ge-gi-shape { border-top:1px solid var(--shell-plaque-line); }
+#${SHELL_ROOT_ID} .ge-gi-shape .ge-gi-pl-svg { flex:0 0 auto; width:96px; }
+#${SHELL_ROOT_ID} .ge-gi-shape-tx { flex:1; min-width:0; display:flex; flex-direction:column; gap:4px; }
 #${SHELL_ROOT_ID} .ge-gi-custom { color:rgba(255,255,255,.88); font-size:15px; line-height:1.6; }
 
 /* buy bonus cards — art-forward, centred, flat (no gradients); --card-acc/--card-ink per card.
@@ -1452,22 +1458,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 +1637,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';
@@ -1671,10 +1681,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.
@@ -2050,7 +2063,7 @@ function paytableCard(r) {
 }
 // ── wins (one section = one pay type; cells filled in the accent colour, no line) ──
 function winFallbackTitle(kind) {
-    return { classic: 'Paylines', cluster: 'Cluster pays', anywhere: 'Pays anywhere', ways: 'Ways to win' }[kind];
+    return { classic: 'Paylines', cluster: 'Cluster pays', anywhere: 'Pays anywhere', ways: 'Ways to win', shapes: 'Winning shapes' }[kind];
 }
 function sectionWins(s, el) {
     if (s.kind === 'classic') {
@@ -2074,6 +2087,15 @@ function sectionWins(s, el) {
             row.appendChild(winDesc(s.description));
         el.appendChild(row);
     }
+    else if (s.kind === 'shapes') {
+        if (s.description)
+            el.appendChild(winDesc(s.description));
+        const list = document.createElement('div');
+        list.className = 'ge-gi-shapes';
+        for (const sh of s.shapes)
+            list.appendChild(shapeRow(s.grid, sh));
+        el.appendChild(list);
+    }
     else {
         if (s.description)
             el.appendChild(winDesc(s.description));
@@ -2084,6 +2106,25 @@ function sectionWins(s, el) {
     }
     return el;
 }
+/** One named shape: grid illustration (left) + name and optional description (right) — modes-style. */
+function shapeRow(grid, sh) {
+    const row = document.createElement('div');
+    row.className = 'ge-gi-shape';
+    const tx = document.createElement('div');
+    tx.className = 'ge-gi-shape-tx';
+    const h = document.createElement('b');
+    h.className = 'ge-gi-mode-h';
+    h.textContent = sh.name;
+    tx.appendChild(h);
+    if (sh.description) {
+        const p = document.createElement('p');
+        p.className = 'ge-gi-mode-desc';
+        p.textContent = sh.description;
+        tx.appendChild(p);
+    }
+    row.append(gridSvg(grid, sh.cells), tx);
+    return row;
+}
 function winDesc(text) {
     const p = document.createElement('p');
     p.className = 'ge-gi-win-desc';
@@ -2490,6 +2531,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;
@@ -2518,7 +2560,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';
@@ -2807,12 +2849,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;
     }