@energy8platform/shell 0.7.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energy8platform/shell",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "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/format.ts

@@ -8,15 +8,19 @@ import type { CurrencyConfig } from './types';
  *  trailing zeros are trimmed down to (but never past) `minDecimals`, so small wins keep their
  *  significant digits. Balance / bet / prices stay fixed at `minDecimals`.
  *
+ *  Separators default to the platform convention — `.` decimal, `,` thousands (`€1,234.50`).
+ *  A comma decimal is NOT safe as a default: players read "2,50" as 250 and believe they were
+ *  paid far more than they were. Games that need another convention pass `currency.separator`.
+ *
  *  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
+ *    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, 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 thousands = currency.separator?.thousands ?? ',';
+  const decimal = currency.separator?.decimal ?? '.';
   const safe = Number.isFinite(value) ? value : 0;
 
   // fixed callers round at minDecimals; variable callers round at maxDecimals then trim back down.

package/src/core/types.ts

@@ -20,6 +20,9 @@ export interface CurrencyConfig {
    *  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;
+  /** Defaults to the platform convention: `{ thousands: ',', decimal: '.' }` → `€1,234.50`.
+   *  Override only for a jurisdiction that requires another convention — a comma decimal reads
+   *  as a thousands group to most players and inflates the perceived payout. */
   separator?: { thousands?: string; decimal?: string };
 }
 

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.7.0';
+export const PACKAGE_VERSION = '0.7.1';