@energy8platform/platform-core 0.23.3 → 0.24.1

package/src/shell/format.ts

@@ -2,23 +2,26 @@ import type { CurrencyConfig } from './types';
 
 /** 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
  */
-export function formatCurrency(value: number, currency: CurrencyConfig): string {
-  const decimals = currency.decimals ?? 2;
-  const minDecimals = Math.max(0, Math.min(decimals, currency.minDecimals ?? decimals));
+export function formatCurrency(value: number, currency: CurrencyConfig, variableDecimals = false): string {
+  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;

package/src/shell/shell.css.ts

@@ -209,6 +209,12 @@ export 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.

package/src/shell/types.ts

@@ -3,11 +3,12 @@ export type ShellMode = 'base' | 'freeSpins' | 'replay';
 export 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; decimal?: string };
 }
@@ -75,6 +76,15 @@ export interface PaylineDef {
 /** A single grid cell, 0-based, row 0 = top. */
 export type CellRef = [col: number, row: number];
 
+/** A named winning shape: an arbitrary set of grid cells (not one-per-column like a payline),
+ *  shown as a grid illustration with its name and optional description. */
+export interface ShapeDef {
+  /** The lit cells, in any pattern. */
+  cells: CellRef[];
+  name: string;
+  description?: string;
+}
+
 /** How a game pays — drives the GameInfo win-section illustration. One section = one kind.
  *  `example`/`winExample`/`loseExample` are optional; omit them for an auto-drawn illustration
  *  sized to `grid`. */
@@ -90,6 +100,7 @@ export type WinSection = {
   | { kind: 'cluster'; minCount: number; example?: CellRef[] }
   | { kind: 'anywhere'; minCount: number; example?: CellRef[] }
   | { kind: 'ways'; winExample?: CellRef[]; loseExample?: CellRef[] }
+  | { kind: 'shapes'; shapes: ShapeDef[] }
 );
 
 /** A playable mode / bonus-buy option, shown for comparison (informational only). */
@@ -138,7 +149,9 @@ export interface AutoplayOptions {
 }
 
 export 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;
 }