@energy8platform/shell 0.5.0 → 0.6.1

package/dist/html.cjs.js

@@ -67,8 +67,17 @@ function createInitialState(config) {
         freeSpins: { current: 0, total: 0, totalWin: 0 },
         bonus: null,
         activeFeature: null,
+        volumes: {
+            master: clampVolume(config.volumes?.master),
+            music: clampVolume(config.volumes?.music),
+            sfx: clampVolume(config.volumes?.sfx),
+        },
     };
 }
+/** Clamp a configured volume to 0..1, defaulting to full (1) when unset/invalid. */
+function clampVolume(v) {
+    return typeof v === 'number' && Number.isFinite(v) ? Math.max(0, Math.min(1, v)) : 1;
+}
 /** Step bet up/down within availableBets, clamped at the ends. */
 function stepBet(state, direction) {
     const idx = state.availableBets.indexOf(state.bet);
@@ -1439,7 +1448,7 @@ class KeyboardController {
 
 // 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. */
-const PACKAGE_VERSION = '0.5.0';
+const PACKAGE_VERSION = '0.6.1';
 
 /** Apply defaults to the raw config (the mount target lives on the renderer, not here). */
 function resolveConfig(config) {
@@ -1456,6 +1465,7 @@ function resolveConfig(config) {
         features: config.features,
         theme: config.theme,
         onBonusBuy: config.onBonusBuy,
+        volumes: config.volumes,
         version: config.version ?? '1.0.0',
         isSocial: config.isSocial ?? false,
         replay: config.replay ?? config.mode === 'replay',
@@ -1477,6 +1487,7 @@ class ShellController extends EventEmitter {
     kbd;
     overlay = null;
     soundRefresh = null;
+    volumeRefresh = null;
     prevBalance;
     prevWin;
     destroyed = false;
@@ -1660,6 +1671,7 @@ class ShellController extends EventEmitter {
             return;
         this.overlay = null;
         this.soundRefresh = null;
+        this.volumeRefresh = null;
         this.renderer.closeOverlay();
     }
     // ── sound ──────────────────────────────────────────────────────────────────
@@ -1672,6 +1684,22 @@ class ShellController extends EventEmitter {
     setSoundRefresh(fn) {
         this.soundRefresh = fn;
     }
+    // ── volume ─────────────────────────────────────────────────────────────────
+    getVolume(key) {
+        return this.state.volumes[key];
+    }
+    /** Set a volume slider (0..1). Shared by the slider control (drag) and game code (public API):
+     *  clamps, stores so a reopened Settings overlay reflects it, emits `settingChange`, and
+     *  live-updates the slider if the overlay is currently open. */
+    setVolume(key, value) {
+        const v = Math.max(0, Math.min(1, value));
+        this.state.volumes[key] = v;
+        this.emit('settingChange', { key, value: v });
+        this.volumeRefresh?.(key, v);
+    }
+    setVolumeRefresh(fn) {
+        this.volumeRefresh = fn;
+    }
     // ── features ─────────────────────────────────────────────────────────────────
     activateFeature(bonus) {
         this.state.activeFeature = bonus;
@@ -1698,10 +1726,17 @@ class ShellController extends EventEmitter {
         this.prevBalance = n;
         this.money('balance', from, n);
     }
-    setWin(n) {
+    /** 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, opts) {
         const from = this.prevWin;
         this.state.win = n;
         this.prevWin = n;
+        if (opts?.animate === false) {
+            this.renderer.renderBar(); // instant repaint from state; cancels running money anims
+            return;
+        }
         this.money('win', from, n);
     }
     setBet(n) {
@@ -2829,7 +2864,10 @@ function openSettingsModal(host) {
         return row;
     })();
     body.appendChild(sound);
-    // Volume sliders — full-width column rows with a live value readout
+    // Volume sliders — full-width column rows with a live value readout. Positions are read from the
+    // shell's stored volumes (not hardcoded to 100%), so reopening the overlay reflects the last set
+    // value, and `host.setVolume()` from game code updates them live via the registered refreshers.
+    const updaters = {};
     const slider = (key, label) => {
         const row = document.createElement('div');
         row.className = 'ge-ov-row ge-col';
@@ -2837,7 +2875,6 @@ function openSettingsModal(host) {
         head.className = 'ge-row-head';
         const val = document.createElement('span');
         val.className = 'ge-val';
-        val.textContent = '100%';
         head.innerHTML = `<span>${label}</span>`;
         head.appendChild(val);
         const input = document.createElement('input');
@@ -2845,19 +2882,23 @@ function openSettingsModal(host) {
         input.min = '0';
         input.max = '1';
         input.step = '0.05';
-        input.value = '1';
         input.className = 'ge-slider';
         input.dataset.ge = `setting-${key}`;
+        const paint = (v) => { input.value = String(v); val.textContent = `${Math.round(v * 100)}%`; };
+        paint(host.getVolume(key));
         input.addEventListener('input', () => {
             val.textContent = `${Math.round(Number(input.value) * 100)}%`;
-            host.emit('settingChange', { key, value: Number(input.value) });
+            host.setVolume(key, Number(input.value));
         });
+        updaters[key] = paint;
         row.append(head, input);
         return row;
     };
     body.appendChild(slider('master', host.t('Master volume')));
     body.appendChild(slider('music', host.t('Music')));
     body.appendChild(slider('sfx', host.t('SFX')));
+    // Live-update sliders when volume changes via host.setVolume (shell clears on close).
+    host.setVolumeRefresh((key, v) => updaters[key]?.(v));
     // Game info — full-width row button that opens its own overlay
     const gameInfo = document.createElement('button');
     gameInfo.className = 'ge-ov-row';