@energy8platform/shell 0.5.0 → 0.6.0

package/dist/pixi.d.ts

@@ -23,6 +23,9 @@ declare class EventEmitter<TEvents extends {}> {
  *  `bonus` pairs with `setBonus()` to show a game-supplied label + value (adventure, hold-and-spin,
  *  respins — anything that isn't a plain free-spins counter). */
 type ShellMode = 'base' | 'bonus' | 'freeSpins' | 'replay';
+/** The three independent volume sliders shown in the Settings overlay. */
+type VolumeKey = 'master' | 'music' | 'sfx';
+type VolumeLevels = Record<VolumeKey, number>;
 interface CurrencyConfig {
     symbol: string;
     position: 'left' | 'right';
@@ -284,9 +287,13 @@ interface ShellConfig {
      *  opening the built-in buy-bonus overlay (e.g. the game shows its own bonus UI). The button
      *  is shown whenever this OR `features.buyBonus` is set. */
     onBonusBuy?: () => void;
+    /** Initial Settings-overlay volume slider positions (each 0..1, defaults to 1 = 100%). The shell
+     *  keeps them stateful across opens; read/update at runtime via `shell.getVolume()` /
+     *  `shell.setVolume()`, and listen to `settingChange` ({ key: 'master'|'music'|'sfx' }) to apply. */
+    volumes?: Partial<VolumeLevels>;
 }
 /** ShellConfig after the controller applies defaults (version, isSocial, replay, theme). No mount. */
-type ResolvedShellConfig = Required<Pick<ShellConfig, 'language' | 'currency' | 'availableBets' | 'defaultBet' | 'balance' | 'win' | 'mode' | 'features' | 'gameInfo' | 'version' | 'isSocial' | 'replay'>> & Pick<ShellConfig, 'currentBet' | 'theme' | 'onBonusBuy'>;
+type ResolvedShellConfig = Required<Pick<ShellConfig, 'language' | 'currency' | 'availableBets' | 'defaultBet' | 'balance' | 'win' | 'mode' | 'features' | 'gameInfo' | 'version' | 'isSocial' | 'replay'>> & Pick<ShellConfig, 'currentBet' | 'theme' | 'onBonusBuy' | 'volumes'>;
 interface ShellState {
     mode: ShellMode;
     /** Sticky replay marker — true for a historical-round replay, regardless of the current
@@ -311,6 +318,9 @@ interface ShellState {
     /** The currently activated `feature` option (e.g. Ante), or null. Drives the
      *  effective-bet readout tint and the BUY BONUS → DISABLE toggle on the bar. */
     activeFeature: BonusOption$1 | null;
+    /** Volume slider positions (0..1) surfaced in the Settings overlay. Stateful across opens so a
+     *  reopened overlay reflects the last-set positions instead of resetting to 100%. */
+    volumes: VolumeLevels;
 }
 interface ShellEvents {
     spin: void;
@@ -433,6 +443,13 @@ interface ShellHost {
     setSound(on: boolean): void;
     /** An open Settings overlay registers an icon updater here (null clears it on close). */
     setSoundRefresh(fn: ((on: boolean) => void) | null): void;
+    /** Current volume slider position (0..1) for master/music/sfx. */
+    getVolume(key: VolumeKey): number;
+    /** Set a volume slider (0..1): clamps, stores, emits `settingChange`, and live-updates an open
+     *  Settings overlay. Called by the slider control on drag AND by game code as the public API. */
+    setVolume(key: VolumeKey, value: number): void;
+    /** An open Settings overlay registers a slider updater here (null clears it on close). */
+    setVolumeRefresh(fn: ((key: VolumeKey, value: number) => void) | null): void;
     /** Logic-bearing actions invoked by renderer controls. */
     readonly actions: ShellActions;
 }
@@ -496,13 +513,14 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     tokens: ShellTokens;
     layout: ShellLayoutMode;
     soundOn: boolean;
-    readonly engineVersion = "0.5.0";
+    readonly engineVersion = "0.6.0";
     readonly actions: ShellActions;
     private renderer;
     private i18n;
     private kbd?;
     private overlay;
     private soundRefresh;
+    private volumeRefresh;
     private prevBalance;
     private prevWin;
     private destroyed;
@@ -527,6 +545,12 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     closeModal(): void;
     setSound(on: boolean): void;
     setSoundRefresh(fn: ((on: boolean) => void) | null): void;
+    getVolume(key: VolumeKey): number;
+    /** 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: VolumeKey, value: number): void;
+    setVolumeRefresh(fn: ((key: VolumeKey, value: number) => void) | null): void;
     activateFeature(bonus: BonusOption$1): void;
     deactivateFeature(): void;
     private money;
@@ -566,7 +590,7 @@ interface I18n {
 declare function createI18n(opts: I18nOptions): I18n;
 
 /** The @energy8platform/shell package version, stamped into the game-info footer. */
-declare const PACKAGE_VERSION = "0.5.0";
+declare const PACKAGE_VERSION = "0.6.0";
 
 /** A shell: the renderer-agnostic controller plus the surface facade (safeArea/barHeight/setVisible)
  *  an embedding host reads. `createShell`, `createGameShell` and `createPixiShell` all return this. */
@@ -706,4 +730,4 @@ declare function createPixiShell(config: PixiShellConfig): PixiGameShell;
 declare function removePixiShell(): Promise<void>;
 
 export { DEFAULT_ACCENT, PACKAGE_VERSION, PixiRenderer, SCHEMES, ShellController, createI18n, createPixiShell, createShell, normalizeLang, removePixiShell, resolveConfig, resolveTheme, socialize };
-export type { AutoplayConfig, AutoplayOptions, BonusCardContext, BonusOption, BonusReadout, CellRef, CreateShellOptions, CurrencyConfig, FreeSpinsState, GameInfoContent, GameInfoSection, GameMode, I18n, I18nOptions, Lang, ModalAction, ModalOptions, OverlayHandle, OverlayRequest, PaylineDef, PaytableRow, PixiGameShell, PixiShellConfig, PixiShellSurface, ReplayModalOptions, ResolvedShellConfig, SafeArea, ShapeDef, Shell, ShellActions, ShellConfig, ShellEvents, ShellFeatures, ShellHost, ShellLayoutMode, ShellMode, ShellRenderer, ShellState, ShellSurface, ShellTokens, ThemeConfig, WinSection };
+export type { AutoplayConfig, AutoplayOptions, BonusCardContext, BonusOption, BonusReadout, CellRef, CreateShellOptions, CurrencyConfig, FreeSpinsState, GameInfoContent, GameInfoSection, GameMode, I18n, I18nOptions, Lang, ModalAction, ModalOptions, OverlayHandle, OverlayRequest, PaylineDef, PaytableRow, PixiGameShell, PixiShellConfig, PixiShellSurface, ReplayModalOptions, ResolvedShellConfig, SafeArea, ShapeDef, Shell, ShellActions, ShellConfig, ShellEvents, ShellFeatures, ShellHost, ShellLayoutMode, ShellMode, ShellRenderer, ShellState, ShellSurface, ShellTokens, ThemeConfig, VolumeKey, VolumeLevels, WinSection };

package/dist/pixi.esm.js

@@ -66,8 +66,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);
@@ -1438,7 +1447,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.0';
 
 /** Apply defaults to the raw config (the mount target lives on the renderer, not here). */
 function resolveConfig(config) {
@@ -1455,6 +1464,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',
@@ -1476,6 +1486,7 @@ class ShellController extends EventEmitter {
     kbd;
     overlay = null;
     soundRefresh = null;
+    volumeRefresh = null;
     prevBalance;
     prevWin;
     destroyed = false;
@@ -1659,6 +1670,7 @@ class ShellController extends EventEmitter {
             return;
         this.overlay = null;
         this.soundRefresh = null;
+        this.volumeRefresh = null;
         this.renderer.closeOverlay();
     }
     // ── sound ──────────────────────────────────────────────────────────────────
@@ -1671,6 +1683,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;
@@ -3947,6 +3975,12 @@ class Slider extends Container {
         this.thumb.circle(cx, cy, r).fill('#ffffff');
         this.hitArea = new Rectangle(0, 0, this.w, h);
     }
+    /** Programmatically move the thumb (0..1) without firing onInput — for live updates driven by
+     *  `host.setVolume()` while the overlay is open. */
+    setValue(v) {
+        this._value = Math.max(0, Math.min(1, v));
+        this.draw();
+    }
     setLayoutSize(w) {
         if (w != null)
             this.w = w;
@@ -4035,10 +4069,13 @@ function buildBody$1(host, width) {
         speaker.active = on;
     });
     col.add(glassRow(host, [textNode(host, host.t('Sound')), new Spacer(), speaker]));
-    // Volume sliders
-    col.add(sliderRow(host, width, 'master', host.t('Master volume')));
-    col.add(sliderRow(host, width, 'music', host.t('Music')));
-    col.add(sliderRow(host, width, 'sfx', host.t('SFX')));
+    // Volume sliders — positions read from the shell's stored volumes (stateful across opens); the
+    // registered refreshers let `host.setVolume()` from game code move the thumbs live.
+    const updaters = {};
+    col.add(sliderRow(host, width, 'master', host.t('Master volume'), updaters));
+    col.add(sliderRow(host, width, 'music', host.t('Music'), updaters));
+    col.add(sliderRow(host, width, 'sfx', host.t('SFX'), updaters));
+    host.setVolumeRefresh?.((key, v) => updaters[key]?.(v));
     // Game info link
     const infoIcon = makeIcon('info', 22, '#ffffff');
     const infoLabel = textNode(host, host.t('Game info'));
@@ -4082,7 +4119,7 @@ function glassRow(host, children, opts = {}) {
     return row;
 }
 /** A column row: head (label + live % value) over a draggable slider. */
-function sliderRow(host, bodyWidth, key, label) {
+function sliderRow(host, bodyWidth, key, label, updaters) {
     const row = new FlexBox({
         direction: 'column',
         align: 'stretch',
@@ -4091,14 +4128,19 @@ function sliderRow(host, bodyWidth, key, label) {
         background: { fill: host.tokens.plaqueGlass, radius: 16 },
     });
     const head = new FlexBox({ direction: 'row', align: 'center', justify: 'space-between' });
-    const valueText = makeText('100%', { size: 13, weight: '700', color: host.tokens.plaqueLabel });
+    const initial = host.getVolume(key);
+    const valueText = makeText(`${Math.round(initial * 100)}%`, { size: 13, weight: '700', color: host.tokens.plaqueLabel });
     head.add(makeText(label, { size: 14, weight: '600', color: '#ffffff' }));
     head.add(new Spacer(), { grow: 1 });
     head.add(valueText);
-    const slider = new Slider(host, 1, (v) => {
+    const slider = new Slider(host, initial, (v) => {
         valueText.text = `${Math.round(v * 100)}%`;
-        host.emit('settingChange', { key, value: v });
+        host.setVolume(key, v);
     });
+    updaters[key] = (v) => {
+        valueText.text = `${Math.round(v * 100)}%`;
+        slider.setValue(v);
+    };
     row.add(head);
     row.add(slider);
     return row;
@@ -6128,6 +6170,9 @@ class PixiRenderer {
             notifyResize: (w, h) => host.notifyResize(w, h),
             setSound: (on) => host.setSound(on),
             setSoundRefresh: (fn) => host.setSoundRefresh(fn),
+            getVolume: (key) => host.getVolume(key),
+            setVolume: (key, v) => host.setVolume(key, v),
+            setVolumeRefresh: (fn) => host.setVolumeRefresh(fn),
             // — Pixi-specific surface —
             get ticker() { return self.app.ticker; },
             get canvas() { return self.app.canvas; },