@energy8platform/platform-core 0.24.6 → 0.25.1

package/dist/index.cjs.js

@@ -610,6 +610,26 @@ class PlatformSession extends EventEmitter {
         }
         return this.sdk.play(params);
     }
+    /**
+     * Acknowledge a finished PLAY_RESULT (call AFTER the game has animated it).
+     *
+     * The host uses this to know the client is ready for the next action and, on
+     * Stake, to settle the round (`/wallet/end-round`) only once the win
+     * animation has played. No-op when constructed with `sdk: false`.
+     */
+    playAck(result) {
+        this.sdk?.playAck(result);
+    }
+    /**
+     * Query the host for an in-flight round (e.g. after a page reload). Resolves with the last
+     * result snapshot when a round is still open, or `null`. Used to offer a "resume / finish"
+     * choice on boot. Resolves `null` when constructed with `sdk: false`.
+     */
+    async getState() {
+        if (!this.sdk)
+            return null;
+        return this.sdk.getState();
+    }
     /** Tear down the SDK, DevBridge, and clear listeners. */
     destroy() {
         this.sdk?.destroy();
@@ -649,6 +669,9 @@ async function createPlatformSession(config = {}) {
         sdk.on('balanceUpdate', (data) => {
             session.emit('balanceUpdate', data);
         });
+        sdk.on('connectionStateChanged', (state) => {
+            session.emit('connectionStateChanged', state);
+        });
     }
     return session;
 }
@@ -828,6 +851,10 @@ function createCSSPreloader(container, config) {
       50%      { opacity: 1; }
     }
   `;
+    // The absolute overlay needs a positioned ancestor. Only override a STATIC container, and
+    // remember the prior inline value so removeCSSPreloader can restore it (an inline `relative`
+    // left behind would beat the game's `#game { position: fixed; inset: 0 }` and collapse it).
+    const prevPosition = container.style.position;
     container.style.position = container.style.position || 'relative';
     container.appendChild(styleEl);
     container.appendChild(overlay);
@@ -838,6 +865,7 @@ function createCSSPreloader(container, config) {
         // We still record state so removeCSSPreloader works.
         state = {
             container,
+            prevPosition,
             overlay,
             styleEl,
             rectEl: null,
@@ -856,6 +884,7 @@ function createCSSPreloader(container, config) {
     }
     state = {
         container,
+        prevPosition,
         overlay,
         styleEl,
         rectEl,
@@ -934,7 +963,7 @@ function removeCSSPreloader(_container) {
         state.tapResolve = null;
     }
     state.removed = true;
-    const { overlay, styleEl } = state;
+    const { overlay, styleEl, container, prevPosition } = state;
     overlay.classList.add('ge-preloader-hidden');
     return new Promise((resolve) => {
         let settled = false;
@@ -944,6 +973,9 @@ function removeCSSPreloader(_container) {
             settled = true;
             overlay.remove();
             styleEl.remove();
+            // Restore the container's original inline position so the game's own layout
+            // (e.g. `#game { position: fixed; inset: 0 }`) is no longer defeated by our inline override.
+            container.style.position = prevPosition;
             state = null;
             resolve();
         };
@@ -1218,6 +1250,8 @@ const SHELL_CSS = SHELL_FONT_CSS + `
 #${SHELL_ROOT_ID} .ge-gi-sec h3 { color:var(--shell-plaque-label); font-size:11px; letter-spacing:.14em;
   text-transform:uppercase; margin:0 0 12px; }
 #${SHELL_ROOT_ID} .ge-gi-sec p { color:rgba(255,255,255,.88); font-size:15px; line-height:1.6; margin:0; }
+#${SHELL_ROOT_ID} .ge-gi-version { text-align:center; color:var(--shell-muted); font-size:11px;
+  letter-spacing:.08em; opacity:.7; margin:4px 0 2px; }
 
 /* controls — two blocks (gameplay / menu & info), icon/name/description per control */
 #${SHELL_ROOT_ID} .ge-gi-ctl-block + .ge-gi-ctl-block { margin-top:16px; padding-top:4px; border-top:1px solid var(--shell-plaque-line); }
@@ -1927,6 +1961,10 @@ function openSettingsModal(shell) {
     return root;
 }
 
+// AUTO-GENERATED by scripts/gen-version.mjs — do not edit. Mirrors package.json "version".
+/** The @energy8platform/platform-core package version, stamped at build time. */
+const PACKAGE_VERSION = '0.25.1';
+
 const SVG_NS = 'http://www.w3.org/2000/svg';
 function openGameInfoModal(shell) {
     const { root, body } = createOverlay({
@@ -1943,8 +1981,19 @@ function openGameInfoModal(shell) {
         .map((s, i) => ({ s, i, k: base(s, i) }))
         .sort((a, b) => a.k - b.k || a.i - b.i)
         .forEach(({ s }) => body.appendChild(renderSection(shell, s)));
+    body.appendChild(versionFooter(shell));
     return root;
 }
+/** A muted version stamp pinned to the bottom of the game-info modal:
+ *  `${config.version ?? '1.0.0'}.${engine version without dots}` (e.g. '1.0.0.0246'). */
+function versionFooter(shell) {
+    const gameVersion = shell.config.version ?? '1.0.0';
+    const el = document.createElement('div');
+    el.dataset.ge = 'info-version';
+    el.className = 'ge-gi-version';
+    el.textContent = `${gameVersion}.${PACKAGE_VERSION.replaceAll('.', '')}`;
+    return el;
+}
 function renderSection(shell, s) {
     switch (s.type) {
         case 'modes': return sectionModes(shell, s.modes, sec('info-modes', s.title, shell.t('Modes')));
@@ -2738,6 +2787,10 @@ class GameShell extends EventEmitter {
         this.observeLayout();
         if (typeof document !== 'undefined') {
             document.addEventListener('keydown', this.handleKeyDown);
+            // Stake serves the game in an iframe; on first paint focus is on the HOST page, so a `document`
+            // keydown never fires and Space scrolls the parent. Pull window focus into the iframe on the
+            // first pointer interaction so the spacebar shortcut works. Harmless on full-page Energy8.
+            document.addEventListener('pointerdown', this.pullFocus, true);
             this.keysBound = true;
         }
         this.render();
@@ -2823,6 +2876,12 @@ class GameShell extends EventEmitter {
      *  false, while a spin is running, while autoplay is active, outside base mode, when an
      *  overlay/modal is open, or when an editable element is focused. `repeat` (held key) is
      *  ignored so it can't spam. */
+    /** Pull window focus into the iframe on first pointer interaction so `document` keydown (the
+     *  spacebar shortcut) fires. No-op / harmless when already focused or full-page. */
+    pullFocus = () => { try {
+        window.focus();
+    }
+    catch { /* cross-origin / non-browser */ } };
     handleKeyDown = (e) => {
         if (this.destroyed || e.code !== 'Space' || e.repeat)
             return;
@@ -2896,6 +2955,9 @@ class GameShell extends EventEmitter {
     setBusy(busy) { this.state.busy = busy; this.render(); }
     setAutoplay(a) { this.state.autoplay = a; this.render(); }
     setTurbo(level) { this.state.turbo = level; this.render(); }
+    /** Currency-aware money formatter for WIN amounts (variable decimals: 0.0041 stays 0.0041, not
+     *  0.00). The host hands this to a scene so games format money without knowing the currency. */
+    formatWin(value) { return formatCurrency(value, this.config.currency, true); }
     setBuyBonusEnabled(enabled) { this.state.buyBonusEnabled = enabled; this.render(); }
     setFreeSpins(fs) { this.state.freeSpins = fs; this.render(); }
     showModal(el) {
@@ -2966,6 +3028,9 @@ class GameShell extends EventEmitter {
     /** Open a generic, externally-driven modal (title + body + optional action buttons).
      *  Each action runs its `on` then closes; the ✕ shows when `availableClose` is true. */
     openModal(opts) { this.showModal(buildModal(opts)); }
+    /** Programmatically dismiss whatever modal/overlay is currently shown (e.g. auto-close the
+     *  reconnect overlay once the link is restored). No-op when nothing is open. */
+    closeModal() { this.modalHost.innerHTML = ''; }
     /** Open the non-dismissable replay summary modal (START REPLAY → onReplay → reopen). */
     openReplay(opts) {
         if (this.destroyed)
@@ -2984,6 +3049,7 @@ class GameShell extends EventEmitter {
         this.ro = null;
         if (this.keysBound) {
             document.removeEventListener('keydown', this.handleKeyDown);
+            document.removeEventListener('pointerdown', this.pullFocus, true);
             this.keysBound = false;
         }
         this.cancelMoneyAnims();