@energy8platform/platform-core 0.25.4 → 0.26.0

package/dist/index.cjs.js

@@ -712,7 +712,7 @@ const GRADIENT_DEFS = `
       <stop stop-color="#316FB0"/><stop stop-color="#1FCDE6" offset=".5"/><stop stop-color="#29FEE7" offset="1"/>
     </linearGradient>`;
 /** Max width of the loader bar in SVG units */
-const LOADER_BAR_MAX_WIDTH = 174;
+const LOADER_BAR_MAX_WIDTH$1 = 174;
 /**
  * Build the Energy8 SVG logo with a loader bar, using unique IDs.
  *
@@ -745,61 +745,27 @@ ${defs}
 </svg>`;
 }
 
-const PRELOADER_ID = '__ge-css-preloader__';
-const RECT_ID = 'ge-pl-loader-rect';
-const TEXT_ID = 'ge-pl-loader-text';
-const REMOVE_FADE_TIMEOUT_MS = 600;
-const LOGO_SVG = buildLogoSVG({
+/** Element ids the lifecycle handle binds to (also asserted by tests). */
+const RECT_ID$1 = 'ge-pl-loader-rect';
+const TEXT_ID$1 = 'ge-pl-loader-text';
+const LOGO_SVG$1 = buildLogoSVG({
     idPrefix: 'pl',
     svgClass: 'ge-logo-svg',
     clipRectClass: 'ge-clip-rect',
-    clipRectId: RECT_ID,
+    clipRectId: RECT_ID$1,
     textClass: 'ge-preloader-svg-text',
-    textId: TEXT_ID,
+    textId: TEXT_ID$1,
 });
-let state = null;
-function clampProgress(p) {
-    if (!Number.isFinite(p))
-        return 0;
-    return Math.max(0, Math.min(1, p));
-}
-function createCSSPreloader(container, config) {
-    if (document.getElementById(PRELOADER_ID))
-        return;
-    const bgColor = typeof config?.backgroundColor === 'string'
-        ? config.backgroundColor
-        : typeof config?.backgroundColor === 'number'
-            ? `#${config.backgroundColor.toString(16).padStart(6, '0')}`
-            : '#0a0a1a';
-    const bgGradient = config?.backgroundGradient ?? `linear-gradient(135deg, ${bgColor} 0%, #1a1a3e 100%)`;
-    const customHTML = config?.cssPreloaderHTML ?? '';
-    const overlay = document.createElement('div');
-    overlay.id = PRELOADER_ID;
-    overlay.innerHTML = customHTML || `
+/** The default Energy8-branded preloader: animated wordmark + shimmering loader bar. */
+const energy8Variant = {
+    buildContentHTML() {
+        return `
     <div class="ge-preloader-content">
-      ${LOGO_SVG}
+      ${LOGO_SVG$1}
     </div>
   `;
-    const styleEl = document.createElement('style');
-    styleEl.textContent = `
-    #${PRELOADER_ID} {
-      position: absolute;
-      top: 0; left: 0;
-      width: 100%; height: 100%;
-      background: ${bgGradient};
-      display: flex;
-      align-items: center;
-      justify-content: center;
-      z-index: 10000;
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      transition: opacity 0.4s ease-out;
-    }
-
-    #${PRELOADER_ID}.ge-preloader-hidden {
-      opacity: 0;
-      pointer-events: none;
-    }
-
+    },
+    css: `
     .ge-preloader-content {
       display: flex;
       flex-direction: column;
@@ -850,6 +816,219 @@ function createCSSPreloader(container, config) {
       0%, 100% { opacity: 0.5; }
       50%      { opacity: 1; }
     }
+  `,
+    mount(overlay) {
+        const rectEl = overlay.querySelector(`#${RECT_ID$1}`);
+        const textEl = overlay.querySelector(`#${TEXT_ID$1}`);
+        // Custom HTML mode (or missing logo) — no progress target; lifecycle inert.
+        if (!rectEl || !textEl)
+            return null;
+        let driven = false;
+        return {
+            setProgress(p, showPercentage) {
+                if (!driven) {
+                    rectEl.classList.add('driven');
+                    driven = true;
+                }
+                rectEl.setAttribute('width', String(p * LOADER_BAR_MAX_WIDTH$1));
+                if (showPercentage) {
+                    textEl.textContent = `${Math.round(p * 100)}%`;
+                }
+            },
+            showTapText(text) {
+                textEl.textContent = text;
+                textEl.classList.add('ge-svg-pulse');
+            },
+        };
+    },
+};
+
+/** Element ids the lifecycle handle binds to. */
+const RECT_ID = 'ge-vm-loader-rect';
+const TEXT_ID = 'ge-vm-loader-text';
+/** Max width (SVG units) of the voidmoon loader bar fill. Spans the first 'o' → end of the crescent. */
+const LOADER_BAR_MAX_WIDTH = 751;
+/**
+ * "voidmoon" wordmark — the official logo, embedded verbatim as SVG outlines:
+ * thin white letters with the final "o" of "moon" rendered as a purple crescent
+ * (#9D63FE). The glyphs live in a flipped group (`translate(0,941) scale(1,-1)`)
+ * exactly as exported; the loader bar + status text are added beneath it in the
+ * outer (un-flipped) viewBox space.
+ */
+const LOGO_SVG = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="301 339 1075 335" class="ge-vm-logo-svg" style="overflow:visible" role="img">
+  <title>voidmoon</title>
+  <g transform="translate(0,941) scale(1,-1)">
+    <g fill="#ffffff" fill-rule="evenodd">
+      <path d="M627 562 c-4 -2 -7 -6 -7 -12 0 -13 14 -18 23 -10 3 3 3 5 4 9 0 7 -2 11 -7 13 -5 2 -9 2 -13 0z"/>
+      <path d="M780 531 l0 -31 -6 5 c-14 14 -35 17 -56 10 -24 -8 -40 -28 -42 -53 0 -11 1 -19 6 -30 8 -16 22 -27 40 -32 8 -2 23 -2 31 0 18 4 34 17 42 33 2 5 4 11 5 14 1 3 1 24 1 61 l0 55 -10 0 -11 0 0 -32z m-24 -38 c20 -10 28 -31 20 -50 -3 -6 -13 -16 -19 -19 -21 -10 -45 -2 -56 18 -2 4 -2 7 -3 14 -1 14 4 24 15 33 8 6 15 8 27 8 9 -1 10 -1 16 -4z"/>
+      <path d="M520 518 c-26 -6 -45 -25 -50 -51 -1 -9 -1 -11 0 -19 3 -12 7 -21 15 -30 8 -8 16 -13 28 -17 6 -2 9 -2 19 -2 10 0 13 0 20 2 21 8 36 24 41 46 1 8 1 13 0 22 -5 23 -21 40 -44 47 -6 2 -23 3 -29 2z m29 -25 c9 -4 16 -11 20 -19 2 -5 3 -6 3 -15 0 -10 -1 -11 -3 -16 -8 -15 -23 -24 -40 -23 -9 1 -15 3 -22 8 -22 15 -21 48 2 63 7 4 14 6 24 6 8 -1 10 -1 16 -4z"/>
+      <path d="M869 518 c-21 -4 -35 -18 -40 -38 -1 -6 -1 -14 -1 -43 l1 -35 10 0 11 0 0 37 c0 33 1 38 2 41 3 7 7 11 13 14 5 2 8 3 13 3 11 0 20 -5 25 -16 l3 -5 0 -37 1 -37 10 0 10 0 0 37 c0 35 1 37 3 42 5 10 14 16 26 16 11 0 21 -7 25 -17 2 -5 2 -7 2 -41 0 -19 0 -36 1 -37 0 -1 3 -1 11 -1 l10 1 0 35 c0 23 0 38 -1 42 -2 9 -8 21 -14 27 -20 17 -51 17 -68 -1 l-5 -5 -5 5 c-9 9 -19 13 -31 14 -5 0 -10 0 -12 -1z"/>
+      <path d="M1077 517 c-9 -1 -20 -7 -27 -12 -7 -6 -14 -16 -18 -25 -4 -11 -5 -25 -3 -35 5 -21 21 -37 42 -44 38 -12 78 14 81 53 1 15 -4 31 -14 43 -14 17 -38 25 -61 20z m25 -22 c19 -5 31 -24 28 -42 -4 -26 -34 -41 -59 -29 -20 10 -27 32 -17 52 8 16 29 25 48 19z"/>
+      <path d="M1282 516 c-18 -5 -34 -21 -38 -39 -1 -4 -1 -18 -1 -40 l1 -35 10 -1 10 0 0 32 c0 20 0 35 1 38 2 11 8 18 18 23 7 3 18 3 26 0 6 -3 12 -9 15 -16 2 -4 3 -6 3 -40 l1 -36 10 0 11 0 0 33 c0 38 0 43 -6 54 -7 14 -19 24 -34 28 -7 1 -20 1 -27 -1z"/>
+      <path d="M329 515 c0 -1 2 -5 4 -9 2 -5 13 -28 24 -53 12 -24 21 -45 22 -46 2 -4 10 -7 15 -7 4 0 11 3 13 6 3 2 50 105 50 108 0 1 -3 1 -11 1 l-11 0 -7 -14 c-3 -8 -12 -28 -20 -45 -7 -17 -13 -31 -14 -31 -1 -1 -3 5 -17 35 -19 43 -23 53 -24 54 -1 1 -5 1 -13 1 -6 0 -11 0 -11 0z"/>
+      <path d="M623 514 c0 -1 0 -26 0 -57 l1 -55 10 0 10 0 0 56 0 57 -10 0 c-7 0 -10 0 -11 -1z"/>
+    </g>
+    <g fill="#9D63FE" fill-rule="evenodd">
+      <path d="M1150 515 c-3 0 -6 -1 -6 -1 0 -1 2 -2 5 -2 10 -4 26 -17 31 -27 11 -21 8 -44 -7 -62 -5 -7 -17 -16 -24 -18 -3 -1 -5 -2 -4 -2 0 -2 16 -3 24 -3 35 3 59 40 49 74 -2 8 -7 18 -13 24 -5 6 -15 13 -23 16 -8 3 -24 4 -32 1z"/>
+    </g>
+  </g>
+
+  <rect x="469" y="600" width="751" height="9" rx="4.5" fill="rgba(255,255,255,0.12)"/>
+  <clipPath id="vm-loader-clip">
+    <rect id="${RECT_ID}" x="469" y="600" width="0" height="9" rx="4.5" class="ge-vm-clip-rect"/>
+  </clipPath>
+  <rect x="469" y="600" width="751" height="9" rx="4.5" fill="#9D63FE" clip-path="url(#vm-loader-clip)"/>
+
+  <text id="${TEXT_ID}" x="844.5" y="650" text-anchor="middle" class="ge-vm-text">Loading...</text>
+</svg>`;
+const voidmoonVariant = {
+    buildContentHTML() {
+        return `
+    <div class="ge-vm-content">
+      ${LOGO_SVG}
+    </div>
+  `;
+    },
+    css: `
+    .ge-vm-content {
+      display: flex;
+      flex-direction: column;
+      align-items: center;
+      width: 82%;
+      max-width: 680px;
+    }
+
+    .ge-vm-logo-svg {
+      width: 100%;
+      height: auto;
+      filter: drop-shadow(0 0 26px rgba(157, 99, 254, 0.3));
+    }
+
+    /* Shimmer the loader bar while waiting */
+    .ge-vm-clip-rect {
+      animation: ge-vm-fill 2s ease-in-out infinite;
+    }
+
+    @keyframes ge-vm-fill {
+      0%   { width: 0; }
+      50%  { width: 751; }
+      100% { width: 0; }
+    }
+
+    /* Stop shimmer once JS-driven progress takes over. */
+    .ge-vm-clip-rect.driven {
+      animation: none;
+    }
+
+    .ge-vm-text {
+      fill: rgba(255, 255, 255, 0.6);
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      font-size: 20px;
+      font-weight: 600;
+      letter-spacing: 3px;
+      animation: ge-vm-pulse 1.5s ease-in-out infinite;
+    }
+
+    @keyframes ge-vm-pulse {
+      0%, 100% { opacity: 0.4; }
+      50% { opacity: 1; }
+    }
+
+    /* Tap-to-start CTA pulse. Compound selector outweighs the ambient
+       .ge-vm-text rule, swapping the animation cleanly. */
+    .ge-vm-text.ge-vm-tap-pulse {
+      animation: ge-vm-tap 1.2s ease-in-out infinite;
+    }
+
+    @keyframes ge-vm-tap {
+      0%, 100% { opacity: 0.5; }
+      50%      { opacity: 1; }
+    }
+  `,
+    mount(overlay) {
+        const rectEl = overlay.querySelector(`#${RECT_ID}`);
+        const textEl = overlay.querySelector(`#${TEXT_ID}`);
+        if (!rectEl || !textEl)
+            return null;
+        let driven = false;
+        return {
+            setProgress(p, showPercentage) {
+                if (!driven) {
+                    rectEl.classList.add('driven');
+                    driven = true;
+                }
+                rectEl.setAttribute('width', String(p * LOADER_BAR_MAX_WIDTH));
+                if (showPercentage) {
+                    textEl.textContent = `${Math.round(p * 100)}%`;
+                }
+            },
+            showTapText(text) {
+                textEl.textContent = text;
+                textEl.classList.add('ge-vm-tap-pulse');
+            },
+        };
+    },
+};
+
+/**
+ * Registry of selectable preloader variants. Add a new variant by writing a
+ * file in this folder and adding one entry here — `PreloaderVariantName` and
+ * `LoadingScreenConfig.preloaderVariant` widen automatically.
+ */
+const VARIANTS = {
+    energy8: energy8Variant,
+    voidmoon: voidmoonVariant,
+};
+/** Default variant used when `preloaderVariant` is omitted or unknown. */
+const DEFAULT_VARIANT_NAME = 'energy8';
+
+const PRELOADER_ID = '__ge-css-preloader__';
+const REMOVE_FADE_TIMEOUT_MS = 600;
+let state = null;
+function clampProgress(p) {
+    if (!Number.isFinite(p))
+        return 0;
+    return Math.max(0, Math.min(1, p));
+}
+function createCSSPreloader(container, config) {
+    if (document.getElementById(PRELOADER_ID))
+        return;
+    const bgColor = typeof config?.backgroundColor === 'string'
+        ? config.backgroundColor
+        : typeof config?.backgroundColor === 'number'
+            ? `#${config.backgroundColor.toString(16).padStart(6, '0')}`
+            : '#0a0a1a';
+    const bgGradient = config?.backgroundGradient ?? `linear-gradient(135deg, ${bgColor} 0%, #1a1a3e 100%)`;
+    const customHTML = config?.cssPreloaderHTML ?? '';
+    // Pick the visual identity. Unknown names fall back to the default so a bad
+    // config value degrades to a working preloader rather than a blank overlay.
+    const variant = VARIANTS[config?.preloaderVariant ?? DEFAULT_VARIANT_NAME] ??
+        VARIANTS[DEFAULT_VARIANT_NAME];
+    const overlay = document.createElement('div');
+    overlay.id = PRELOADER_ID;
+    overlay.innerHTML = customHTML || variant.buildContentHTML(config);
+    const styleEl = document.createElement('style');
+    // Shared overlay infrastructure (positioning / background / fade) plus the
+    // variant's own content styling and animations.
+    styleEl.textContent = `
+    #${PRELOADER_ID} {
+      position: absolute;
+      top: 0; left: 0;
+      width: 100%; height: 100%;
+      background: ${bgGradient};
+      display: flex;
+      align-items: center;
+      justify-content: center;
+      z-index: 10000;
+      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+      transition: opacity 0.4s ease-out;
+    }
+
+    #${PRELOADER_ID}.ge-preloader-hidden {
+      opacity: 0;
+      pointer-events: none;
+    }
+${variant.css}
   `;
     // 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`
@@ -858,41 +1037,18 @@ function createCSSPreloader(container, config) {
     container.style.position = container.style.position || 'relative';
     container.appendChild(styleEl);
     container.appendChild(overlay);
-    const rectEl = overlay.querySelector(`#${RECT_ID}`);
-    const textEl = overlay.querySelector(`#${TEXT_ID}`);
-    if (!rectEl || !textEl) {
-        // Custom HTML mode — no logo SVG, lifecycle API becomes mostly inert.
-        // We still record state so removeCSSPreloader works.
-        state = {
-            container,
-            prevPosition,
-            overlay,
-            styleEl,
-            rectEl: null,
-            textEl: null,
-            showPercentage: false,
-            tapToStart: config?.tapToStart !== false,
-            tapToStartText: config?.tapToStartText ?? 'TAP TO START',
-            driven: false,
-            tapState: 'idle',
-            tapPromise: null,
-            tapResolve: null,
-            tapHandler: null,
-            removed: false,
-        };
-        return;
-    }
+    // Custom HTML bypasses the variant's content, so there is no progress target
+    // to bind to and the handle stays null (lifecycle API becomes inert).
+    const handle = customHTML ? null : variant.mount(overlay, config);
     state = {
         container,
         prevPosition,
         overlay,
         styleEl,
-        rectEl,
-        textEl,
+        handle,
         showPercentage: config?.showPercentage === true,
         tapToStart: config?.tapToStart !== false,
         tapToStartText: config?.tapToStartText ?? 'TAP TO START',
-        driven: false,
         tapState: 'idle',
         tapPromise: null,
         tapResolve: null,
@@ -905,17 +1061,9 @@ function setCSSPreloaderProgress(progress) {
         return;
     if (state.tapState === 'waiting' || state.tapState === 'resolved')
         return;
-    if (!state.rectEl)
+    if (!state.handle)
         return;
-    const p = clampProgress(progress);
-    if (!state.driven) {
-        state.rectEl.classList.add('driven');
-        state.driven = true;
-    }
-    state.rectEl.setAttribute('width', String(p * LOADER_BAR_MAX_WIDTH));
-    if (state.showPercentage && state.textEl) {
-        state.textEl.textContent = `${Math.round(p * 100)}%`;
-    }
+    state.handle.setProgress(clampProgress(progress), state.showPercentage);
 }
 function waitCSSPreloaderTap() {
     if (!state) {
@@ -927,10 +1075,7 @@ function waitCSSPreloaderTap() {
         return Promise.resolve();
     if (state.tapPromise)
         return state.tapPromise;
-    if (state.textEl) {
-        state.textEl.textContent = state.tapToStartText;
-        state.textEl.classList.add('ge-svg-pulse');
-    }
+    state.handle?.showTapText(state.tapToStartText);
     state.overlay.style.cursor = 'pointer';
     state.tapState = 'waiting';
     state.tapPromise = new Promise((resolve) => {
@@ -984,6 +1129,221 @@ function removeCSSPreloader(_container) {
     });
 }
 
+// Bet key detection: bet-up needs Shift for arrow/equal, NumpadAdd is bare; same logic for down.
+// Exported so overlays with their own bet stepper (Buy bonus) honour the SAME keys as the bar.
+function betDir(e) {
+    if (e.code === 'ArrowUp' && e.shiftKey)
+        return 1;
+    if (e.code === 'Equal' && e.shiftKey)
+        return 1;
+    if (e.code === 'NumpadAdd')
+        return 1;
+    if (e.code === 'ArrowDown' && e.shiftKey)
+        return -1;
+    if (e.code === 'Minus' && e.shiftKey)
+        return -1;
+    if (e.code === 'NumpadSubtract')
+        return -1;
+    return null;
+}
+class KeyboardController {
+    host;
+    doc;
+    spaceHeld = false;
+    holdTimer = null;
+    // Bet hold-repeat state
+    betHeldCode = null;
+    betTimer = null;
+    constructor(host, doc) {
+        this.host = host;
+        this.doc = doc ?? (typeof document !== 'undefined' ? document : null);
+    }
+    isSpinAllowed() {
+        const h = this.host;
+        const s = h.state;
+        return (h.spacebarEnabled &&
+            h.hotkeysEnabled &&
+            !h.hasOpenLayer() &&
+            s.mode === 'base' &&
+            !s.autoplay.active);
+    }
+    isBetAllowed() {
+        const h = this.host;
+        const s = h.state;
+        return (h.hotkeysEnabled &&
+            !h.hasOpenLayer() &&
+            s.mode === 'base' &&
+            !s.busy);
+    }
+    clearBetTimer() {
+        if (this.betTimer !== null) {
+            clearTimeout(this.betTimer);
+            this.betTimer = null;
+        }
+    }
+    startBetRepeat(dir, elapsed) {
+        // elapsed is ms already spent holding; use it to accelerate toward 45ms floor.
+        // Start at 90ms, decrease ~1ms per 10ms held after the first repeat, floor at 45ms.
+        const interval = Math.max(45, 90 - Math.floor(elapsed / 10));
+        this.betTimer = setTimeout(() => {
+            this.betTimer = null;
+            if (this.betHeldCode !== null && this.isBetAllowed()) {
+                this.host.stepBet(dir);
+                this.startBetRepeat(dir, elapsed + interval);
+            }
+        }, interval);
+    }
+    onKeyDown = (e) => {
+        const target = e.target;
+        // Editable element guard — never intercept keyboard input
+        if (target && (target.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(target.tagName)))
+            return;
+        // For Space: claim preventDefault early (before layer/mode/busy bail) so the browser's
+        // native "Space activates focused button" can't re-fire a shell control and flicker a modal.
+        if (e.code === 'Space' && !e.repeat) {
+            if (!this.host.spacebarEnabled || !this.host.hotkeysEnabled)
+                return;
+            e.preventDefault();
+            if (this.host.hasOpenLayer()) {
+                this.host.routeToLayer(e);
+                return;
+            }
+            const s = this.host.state;
+            if (s.mode !== 'base' || s.busy || s.autoplay.active)
+                return;
+            this.spaceHeld = true;
+            this.host.spin();
+            return;
+        }
+        // Bet step keys (Shift+arrows, Shift+=/-, NumpadAdd/Subtract) — non-repeat only
+        if (!e.repeat) {
+            const dir = betDir(e);
+            if (dir !== null && this.isBetAllowed()) {
+                this.betHeldCode = e.code;
+                this.host.stepBet(dir);
+                // First repeat after 350ms initial delay
+                this.clearBetTimer();
+                const capturedDir = dir;
+                this.betTimer = setTimeout(() => {
+                    this.betTimer = null;
+                    if (this.betHeldCode !== null && this.isBetAllowed()) {
+                        this.host.stepBet(capturedDir);
+                        this.startBetRepeat(capturedDir, 350);
+                    }
+                }, 350);
+                return;
+            }
+        }
+        // Non-Space keys: give the open layer first refusal. If it consumes the key, done; Escape closes
+        // it. Anything the layer does NOT consume falls through to the chrome hotkeys below — so the
+        // Settings/Info pages still honour Shift+I (Game info), Shift+M (sound), Shift+S, etc.
+        if (this.host.hasOpenLayer()) {
+            const consumed = this.host.routeToLayer(e);
+            if (consumed)
+                return;
+            if (e.code === 'Escape') {
+                this.host.closeLayer();
+                return;
+            }
+            // not consumed → fall through to the Shift+letter chrome hotkeys
+        }
+        // Shift+letter bar hotkeys — fire when no layer is open, OR when an open layer left the key
+        // unconsumed (see fall-through above); gated on hotkeys being enabled.
+        if (!e.repeat && e.shiftKey && this.host.hotkeysEnabled) {
+            const h = this.host;
+            const s = h.state;
+            switch (e.code) {
+                case 'KeyA':
+                    if (h.autoplayEnabled && !s.replay) {
+                        h.toggleAutoplay();
+                        return;
+                    }
+                    break;
+                case 'KeyT':
+                    if (h.turboLevels > 0 && !s.replay) {
+                        h.cycleTurbo();
+                        return;
+                    }
+                    break;
+                case 'KeyB':
+                    if (h.buyBonusEnabled && s.mode === 'base' && !s.replay) {
+                        h.openBuyBonus();
+                        return;
+                    }
+                    break;
+                case 'KeyI':
+                    h.openInfo();
+                    return;
+                case 'KeyS':
+                    h.openMenu();
+                    return;
+                case 'KeyM':
+                    h.toggleMute();
+                    return;
+            }
+        }
+    };
+    onKeyUp = (e) => {
+        if (e.code === 'Space') {
+            this.spaceHeld = false;
+            this.clearHoldTimer();
+        }
+        // Stop bet repeat on key release
+        if (e.code === this.betHeldCode) {
+            this.betHeldCode = null;
+            this.clearBetTimer();
+        }
+    };
+    onBlur = () => {
+        // Window blur — stop bet repeat AND hold-to-spin (same as releasing both keys)
+        this.betHeldCode = null;
+        this.clearBetTimer();
+        this.spaceHeld = false;
+        this.clearHoldTimer();
+    };
+    clearHoldTimer() {
+        if (this.holdTimer !== null) {
+            clearTimeout(this.holdTimer);
+            this.holdTimer = null;
+        }
+    }
+    attach() {
+        this.doc.addEventListener('keydown', this.onKeyDown);
+        this.doc.addEventListener('keyup', this.onKeyUp);
+        // Use window if available for blur events
+        if (typeof window !== 'undefined') {
+            window.addEventListener('blur', this.onBlur);
+        }
+    }
+    detach() {
+        this.doc.removeEventListener('keydown', this.onKeyDown);
+        this.doc.removeEventListener('keyup', this.onKeyUp);
+        if (typeof window !== 'undefined') {
+            window.removeEventListener('blur', this.onBlur);
+        }
+        this.spaceHeld = false;
+        this.clearHoldTimer();
+        this.betHeldCode = null;
+        this.clearBetTimer();
+    }
+    notifyBusyChanged(busy) {
+        if (busy)
+            return;
+        if (!this.spaceHeld)
+            return;
+        if (!this.isSpinAllowed())
+            return;
+        // Schedule the next spin after the 120 ms floor (gap between completion and next spin).
+        this.clearHoldTimer();
+        this.holdTimer = setTimeout(() => {
+            this.holdTimer = null;
+            if (this.spaceHeld && this.isSpinAllowed()) {
+                this.host.spin();
+            }
+        }, 120);
+    }
+}
+
 function createInitialState(config) {
     return {
         mode: config.mode,
@@ -1253,6 +1613,21 @@ const SHELL_CSS = SHELL_FONT_CSS + `
 #${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; }
 
+/* hotkeys — keycap chips → localized action label, mirrors controls row layout */
+#${SHELL_ROOT_ID} .ge-gi-hk-block { display:flex; flex-direction:column; }
+#${SHELL_ROOT_ID} .ge-gi-hk { display:flex; align-items:center; justify-content:space-between; gap:12px; padding:9px 0; }
+#${SHELL_ROOT_ID} .ge-gi-hk + .ge-gi-hk { border-top:1px solid var(--shell-plaque-line); }
+#${SHELL_ROOT_ID} .ge-gi-hk-chips { display:flex; align-items:center; flex-wrap:wrap; gap:4px; flex:0 0 auto; }
+#${SHELL_ROOT_ID} .ge-gi-hk-combo { display:inline-flex; align-items:center; gap:4px; }
+#${SHELL_ROOT_ID} .ge-gi-hk-chip { display:inline-flex; align-items:center; justify-content:center;
+  padding:2px 7px; border-radius:6px; border:1px solid var(--shell-plaque-line);
+  background:var(--shell-plaque-dark); color:#fff;
+  font-family:'SFMono-Regular',Consolas,'Liberation Mono',Menlo,monospace; font-size:12px;
+  font-weight:600; line-height:1.5; white-space:nowrap; min-width:1.6em; text-align:center; }
+#${SHELL_ROOT_ID} .ge-gi-hk-sep { color:var(--shell-plaque-label); font-size:11px; padding:0 1px; }
+#${SHELL_ROOT_ID} .ge-gi-hk-sep2 { color:var(--shell-plaque-label); font-size:11px; padding:0 4px; }
+#${SHELL_ROOT_ID} .ge-gi-hk-tx { color:rgba(255,255,255,.88); font-size:14px; font-weight:600; text-align:right; flex:1; }
+
 /* 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); }
 #${SHELL_ROOT_ID} .ge-gi-ctl-block-h { color:var(--shell-plaque-label); font-size:11px; letter-spacing:.12em;
@@ -1361,6 +1736,8 @@ const SHELL_CSS = SHELL_FONT_CSS + `
   pointer-events:auto; cursor:pointer; transition:box-shadow .12s ease, background .12s ease; }
 #${SHELL_ROOT_ID} .ge-bonus-card:hover:not(.ge-bonus-off) {
   box-shadow:0 0 0 1px var(--card-acc), 0 12px 34px -12px var(--card-acc); }
+#${SHELL_ROOT_ID} .ge-bonus-card--kbd-focus:not(.ge-bonus-off) {
+  box-shadow:0 0 0 1px var(--card-acc), 0 12px 34px -12px var(--card-acc); }
 /* custom card (BonusOption.custom): keep grid sizing + accent vars, drop the default chrome so the game owns the UI */
 #${SHELL_ROOT_ID} .ge-bonus-card--custom { background:none; border:none; cursor:default; }
 #${SHELL_ROOT_ID} .ge-bonus-body { display:flex; flex-direction:column; align-items:center; flex:1; padding:1.25em 1.1em .9em; }
@@ -1639,7 +2016,8 @@ function createCardModal(opts) {
     }
     return { root, card, body };
 }
-/** Full-screen overlay. Returns { root, body }; append content to body. */
+/** Full-screen overlay. Returns { root, body, scroll }; append content to body.
+ *  The `scroll` element is the scrollable container (overflow-y: auto). */
 function createOverlay(opts) {
     const root = document.createElement('div');
     root.className = 'ge-shell-overlay';
@@ -1677,7 +2055,7 @@ function createOverlay(opts) {
     body.className = 'ge-ov-body';
     scroll.appendChild(body);
     root.append(head, scroll);
-    return { root, body };
+    return { root, body, scroll };
 }
 
 /** A floating labelled money readout (balance/win/bet). */
@@ -1929,24 +2307,22 @@ function applyBusy(shell, bar) {
 function openSettingsModal(shell) {
     const { root, body } = createOverlay({ title: shell.t('Settings'), onClose: () => root.remove() });
     root.dataset.ge = 'settings-modal';
-    // Sound on/off (starts on) — full-width row with a speaker icon button
+    // Sound on/off — backed by the shell's shared `soundOn` state so this toggle and the Shift+M
+    // hotkey stay in sync; `setSound` emits `settingChange({ key: 'sound' })` and refreshes the icon.
     const sound = (() => {
-        let on = true;
         const btn = document.createElement('button');
-        btn.className = 'ge-snd ge-active';
+        btn.className = 'ge-snd';
         btn.dataset.ge = 'setting-sound';
-        btn.setAttribute('aria-label', 'Sound');
-        const paint = () => {
+        btn.setAttribute('aria-label', shell.t('Sound'));
+        const paint = (on) => {
             btn.innerHTML = icon(on ? 'soundOn' : 'soundOff');
             btn.classList.toggle('ge-active', on);
             btn.setAttribute('aria-pressed', String(on));
         };
-        paint();
-        btn.addEventListener('click', () => {
-            on = !on;
-            paint();
-            shell.emit('settingChange', { key: 'sound', value: on });
-        });
+        paint(shell.soundOn);
+        btn.addEventListener('click', () => shell.setSound(!shell.soundOn));
+        // Live-update the icon when sound changes from here OR via Shift+M (shell clears on close).
+        shell.setSoundRefresh(paint);
         const row = document.createElement('div');
         row.className = 'ge-ov-row';
         row.innerHTML = `<span class="ge-grow">${shell.t('Sound')}</span>`;
@@ -1996,17 +2372,25 @@ function openSettingsModal(shell) {
 
 // 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.4';
+const PACKAGE_VERSION = '0.26.0';
 
+/** Default order key for the auto-injected hotkeys section: just after `controls` (-1). */
+const HOTKEYS_DEFAULT_ORDER = -0.5;
 const SVG_NS = 'http://www.w3.org/2000/svg';
 function openGameInfoModal(shell) {
-    const { root, body } = createOverlay({
+    const { root, body, scroll } = createOverlay({
         title: shell.t('Game info'),
         onClose: () => root.remove(),
         onBack: () => { root.remove(); shell.openSettings(); },
     });
     root.dataset.ge = 'info-modal';
-    const sections = shell.config.gameInfo.sections ?? [];
+    const rawSections = shell.config.gameInfo.sections ?? [];
+    // Auto-inject a hotkeys section unless the game already provides one or features.hotkeys === false.
+    const sectionsWithHotkeys = [...rawSections];
+    if (shell.config.features.hotkeys !== false && !rawSections.some((s) => s.type === 'hotkeys')) {
+        sectionsWithHotkeys.push({ type: 'hotkeys', order: HOTKEYS_DEFAULT_ORDER });
+    }
+    const sections = sectionsWithHotkeys;
     // Default placement: modes first, controls second, the rest in declaration order.
     // An explicit `order` overrides; ties keep declaration order (stable).
     const base = (s, i) => s.order ?? (s.type === 'modes' ? -2 : s.type === 'controls' ? -1 : i);
@@ -2015,7 +2399,40 @@ function openGameInfoModal(shell) {
         .sort((a, b) => a.k - b.k || a.i - b.i)
         .forEach(({ s }) => body.appendChild(renderSection(shell, s)));
     body.appendChild(versionFooter(shell));
-    return root;
+    const LINE = 60;
+    const PAGE = () => Math.floor(scroll.clientHeight * 0.9) || Math.floor(540 * 0.9);
+    const onKey = (e) => {
+        switch (e.code) {
+            case 'ArrowDown':
+                scroll.scrollTop += LINE;
+                return true;
+            case 'ArrowUp':
+                scroll.scrollTop = Math.max(0, scroll.scrollTop - LINE);
+                return true;
+            case 'PageDown':
+                scroll.scrollTop += PAGE();
+                return true;
+            case 'PageUp':
+                scroll.scrollTop = Math.max(0, scroll.scrollTop - PAGE());
+                return true;
+            case 'Space':
+                if (e.shiftKey) {
+                    scroll.scrollTop = Math.max(0, scroll.scrollTop - PAGE());
+                }
+                else {
+                    scroll.scrollTop += PAGE();
+                }
+                return true;
+            case 'Home':
+                scroll.scrollTop = 0;
+                return true;
+            case 'End':
+                scroll.scrollTop = scroll.scrollHeight - scroll.clientHeight;
+                return true;
+            default: return false;
+        }
+    };
+    return { root, onKey };
 }
 /** 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'). */
@@ -2031,9 +2448,11 @@ function renderSection(shell, s) {
     switch (s.type) {
         case 'modes': return sectionModes(shell, s.modes, sec('info-modes', s.title, shell.t('Modes')));
         case 'controls': return sectionControls(shell, sec('info-controls', s.title, shell.t('Controls')));
+        case 'hotkeys': return sectionHotkeys(shell, sec('info-hotkeys', s.title, shell.t('Hotkeys')));
         case 'paytable': return sectionPaytable(s.rows, sec('info-paytable', s.title, shell.t('Paytable')));
         case 'wins': return sectionWins(s, sec('info-wins', s.title, shell.t(winFallbackTitle(s.kind))));
-        case 'custom': return sectionCustom(s, sec('info-custom', s.title, ''));
+        // Translate the heading (e.g. the host-built DISCLAIMER title); the body stays verbatim.
+        case 'custom': return sectionCustom(s, sec('info-custom', s.title != null ? shell.t(s.title) : undefined, ''));
     }
 }
 /** A titled glass-plaque section shell. */
@@ -2115,6 +2534,57 @@ function ctlBlock(shell, label, rows) {
     }
     return block;
 }
+function sectionHotkeys(shell, el) {
+    const { features } = shell.config;
+    /** Render one or more key names as keycap chips joined by " / ". */
+    const chips = (...keys) => keys.map((k) => `<span class="ge-gi-hk-chip">${k}</span>`).join('<span class="ge-gi-hk-sep"> / </span>');
+    const rows = [
+        { chips: ['Space'], name: 'Spin', on: true },
+        { chips: ['Shift', '↑', 'Shift', '='], name: 'Raise bet', on: true },
+        { chips: ['Shift', '↓', 'Shift', '-'], name: 'Lower bet', on: true },
+        { chips: ['Shift', 'A'], name: 'Autoplay', on: features.autoplay != null },
+        { chips: ['Shift', 'T'], name: 'Turbo', on: features.turbo > 0 },
+        { chips: ['Shift', 'B'], name: 'Buy bonus', on: features.buyBonus !== false },
+        { chips: ['Shift', 'I'], name: 'Game info', on: true },
+        { chips: ['Shift', 'S'], name: 'Menu', on: true },
+        { chips: ['Shift', 'M'], name: 'Mute', on: true },
+        { chips: ['←', '→'], name: 'Navigate', on: true },
+        { chips: ['Enter'], name: 'Confirm', on: true },
+        { chips: ['Esc'], name: 'Close', on: true },
+    ];
+    const block = document.createElement('div');
+    block.className = 'ge-gi-hk-block';
+    for (const r of rows.filter((x) => x.on)) {
+        const row = document.createElement('div');
+        row.className = 'ge-gi-hk';
+        // Build the chips column
+        const chipsEl = document.createElement('div');
+        chipsEl.className = 'ge-gi-hk-chips';
+        if (r.name === 'Raise bet' || r.name === 'Lower bet') {
+            // Two combos separated by " / ": Shift+↑ / Shift+=  and  Shift+↓ / Shift+-
+            const [k1, k2, k3, k4] = r.chips;
+            chipsEl.innerHTML =
+                `<span class="ge-gi-hk-combo">${chips(k1, k2)}</span>` +
+                    `<span class="ge-gi-hk-sep2"> / </span>` +
+                    `<span class="ge-gi-hk-combo">${chips(k3, k4)}</span>`;
+        }
+        else if (r.chips.length > 1) {
+            // Chord: Shift + X
+            chipsEl.innerHTML = `<span class="ge-gi-hk-combo">${chips(...r.chips)}</span>`;
+        }
+        else {
+            chipsEl.innerHTML = chips(...r.chips);
+        }
+        const tx = document.createElement('div');
+        tx.className = 'ge-gi-hk-tx';
+        tx.textContent = shell.t(r.name);
+        row.appendChild(chipsEl);
+        row.appendChild(tx);
+        block.appendChild(row);
+    }
+    el.appendChild(block);
+    return el;
+}
 // ── paytable (cards — image on top, name, then win tiers "<count> x<mult>") ────
 function sectionPaytable(rows, el) {
     const grid = document.createElement('div');
@@ -2313,25 +2783,165 @@ function sectionCustom(s, el) {
     return el;
 }
 
-/** Buy-bonus overlay — a grid of art-forward cards, one per option. */
+/** Buy-bonus overlay — a grid of art-forward cards, one per option.
+ *  Returns the overlay element + a keyboard handler for the shell's `showModal`. */
 function openBuyBonusOverlay(shell) {
     const bonuses = shell.config.features.buyBonus;
     if (bonuses === false || bonuses.length === 0)
         return null;
-    const { root, body } = createOverlay({ title: shell.t('Buy bonus'), onClose: () => root.remove() });
+    const st = { focusIndex: -1, confirmBonus: undefined };
+    const { root, body } = createOverlay({ title: shell.t('Buy bonus'), onClose: () => shell.closeModal() });
     root.dataset.ge = 'buybonus-overlay';
     // Re-render the grid whenever the bet changes so every card's price stays live.
     const renderGrid = () => {
         body.innerHTML = '';
         const grid = document.createElement('div');
         grid.className = 'ge-bb-grid';
-        for (const bonus of bonuses)
-            grid.appendChild(buildCard(shell, bonus, root));
+        const affordable = [];
+        for (const bonus of bonuses) {
+            const card = buildCard(shell, bonus, root, st);
+            grid.appendChild(card);
+            if (isAffordable(shell, bonus))
+                affordable.push(bonus);
+        }
         body.appendChild(grid);
+        // Initialize or restore focus index
+        if (affordable.length > 0) {
+            if (st.focusIndex < 0)
+                st.focusIndex = 0;
+            else
+                st.focusIndex = Math.min(st.focusIndex, affordable.length - 1);
+            applyFocusClass(root, bonuses, affordable, st.focusIndex);
+        }
+        else {
+            st.focusIndex = -1;
+        }
     };
     renderGrid();
     root.appendChild(buildBetBar(shell, renderGrid)); // thin bottom footer, only as tall as the pill
-    return root;
+    /** Step the bet by `dir` and re-render the grid (live prices + affordability) when it changed.
+     *  Shared by the keyboard bet keys (the footer ± buttons keep their own copy). */
+    const stepBetBy = (dir) => {
+        const next = stepBet(shell.state, dir);
+        if (next === shell.state.bet)
+            return;
+        shell.state.bet = next;
+        shell.emit('betChange', next);
+        shell.render();
+        renderGrid();
+    };
+    /** Keyboard handler for both browse and confirm phases. */
+    const onKey = (e) => {
+        const affordable = bonuses.filter((b) => isAffordable(shell, b));
+        // ── Confirm phase ──
+        if (st.confirmBonus) {
+            switch (e.code) {
+                case 'Enter':
+                case 'Space': {
+                    const bonus = st.confirmBonus;
+                    if (!isAffordable(shell, bonus))
+                        return true;
+                    if (bonus.type === 'feature')
+                        shell.activateFeature(bonus);
+                    else
+                        shell.emit('buyBonusSelect', { id: bonus.id });
+                    shell.closeModal();
+                    return true;
+                }
+                case 'Escape':
+                    // Remove the confirm dialog, return to browse
+                    closeConfirm(root, st);
+                    return true;
+                default:
+                    return false;
+            }
+        }
+        // ── Browse phase ──
+        const last = affordable.length - 1;
+        const mobile = shell.layout === 'mobile';
+        // Bet stepping mirrors the bar's keys (Shift+↑/↓, Shift+=/-, Numpad ±). Checked BEFORE arrow
+        // navigation so a bare arrow still moves card focus while a Shift+arrow changes the bet.
+        const bet = betDir(e);
+        if (bet !== null) {
+            stepBetBy(bet);
+            return true;
+        }
+        // Determine navigation direction from key code + layout (mobile uses vertical arrows)
+        const fwdKey = e.code === 'ArrowRight' || (mobile && e.code === 'ArrowDown');
+        const bwdKey = e.code === 'ArrowLeft' || (mobile && e.code === 'ArrowUp');
+        if (fwdKey) {
+            if (last < 0)
+                return true;
+            if (st.focusIndex < last) {
+                st.focusIndex++;
+                applyFocusClass(root, bonuses, affordable, st.focusIndex);
+            }
+            return true;
+        }
+        if (bwdKey) {
+            if (last < 0)
+                return true;
+            if (st.focusIndex > 0) {
+                st.focusIndex--;
+                applyFocusClass(root, bonuses, affordable, st.focusIndex);
+            }
+            return true;
+        }
+        switch (e.code) {
+            case 'Enter':
+            case 'Space':
+                if (last < 0 || st.focusIndex < 0)
+                    return true;
+                {
+                    const bonus = affordable[st.focusIndex];
+                    openConfirm(shell, bonus, root, st);
+                }
+                return true;
+            // Bare =/- also step the bet (the Shift+=/- and Numpad variants are handled by betDir above).
+            case 'Equal':
+                stepBetBy(1);
+                return true;
+            case 'Minus':
+                stepBetBy(-1);
+                return true;
+            case 'Escape':
+                shell.closeModal();
+                return true;
+            default:
+                return false;
+        }
+    };
+    return { root, onKey };
+}
+/** Apply a CSS keyboard-focus class to the currently focused affordable card. */
+function applyFocusClass(overlay, bonuses, affordable, focusIndex) {
+    for (const b of bonuses) {
+        const card = overlay.querySelector(`[data-ge="bonus-card-${b.id}"]`);
+        if (!card)
+            continue;
+        card.classList.remove('ge-bonus-card--kbd-focus');
+    }
+    const focused = affordable[focusIndex];
+    if (!focused)
+        return;
+    const card = overlay.querySelector(`[data-ge="bonus-card-${focused.id}"]`);
+    if (card)
+        card.classList.add('ge-bonus-card--kbd-focus');
+}
+/** Open the confirm dialog for the given bonus and track it in overlay state. */
+function openConfirm(shell, bonus, overlay, st) {
+    closeConfirm(overlay, st); // remove any existing confirm
+    st.confirmBonus = bonus;
+    overlay.appendChild(buildConfirm(shell, bonus, overlay, st));
+    shell.fitModals();
+}
+/** Remove the confirm dialog and clear the overlay state. */
+function closeConfirm(overlay, st) {
+    // The confirm dialog is a .ge-sheet with data-ge="bonus-confirm" appended directly to overlay.
+    const sheet = overlay.querySelector('[data-ge="bonus-confirm"]');
+    if (sheet)
+        sheet.remove();
+    st.confirmBonus = undefined;
 }
 /** Bet control — a compact −/+ pill around the live stake, in a thin footer at the screen bottom.
  *  Stepping repaints the value, re-prices the cards, and updates the control bar. */
@@ -2378,7 +2988,7 @@ function stepButton(ge, name) {
 }
 /** A grid card: title → thumbnail → description → volatility → price → full-bleed CTA.
  *  Clicking (when affordable) opens the confirmation modal. */
-function buildCard(shell, bonus, overlay) {
+function buildCard(shell, bonus, overlay, st) {
     const accent = effectiveAccent(bonus);
     const card = document.createElement('div');
     card.className = 'ge-bonus-card';
@@ -2391,8 +3001,7 @@ function buildCard(shell, bonus, overlay) {
     const select = () => {
         if (!isAffordable(shell, bonus))
             return;
-        overlay.appendChild(buildConfirm(shell, bonus, overlay));
-        shell.fitModals();
+        openConfirm(shell, bonus, overlay, st);
     };
     // Game-supplied card UI: the shell keeps the wrapper (grid sizing + accent vars) and runs the
     // buy flow when the game calls ctx.select(); the game owns everything inside.
@@ -2437,9 +3046,9 @@ function cardBody(shell, bonus) {
 }
 /** Confirmation modal — the shared card chrome (accent title heading, no ✕) with a bonus
  *  preview body and a full-bleed Cancel + action footer. */
-function buildConfirm(shell, bonus, overlay) {
+function buildConfirm(shell, bonus, overlay, st) {
     const accent = effectiveAccent(bonus);
-    const ui = createCardModal({ ge: 'bonus-confirm', title: bonus.title, accent, onClose: () => ui.root.remove() });
+    const ui = createCardModal({ ge: 'bonus-confirm', title: bonus.title, accent, onClose: () => { closeConfirm(overlay, st); } });
     const price = bonus.priceMultiplier * shell.state.bet;
     const preview = document.createElement('div');
     preview.className = 'ge-confirm-preview';
@@ -2455,7 +3064,7 @@ function buildConfirm(shell, bonus, overlay) {
     cancel.className = 'ge-modal-btn ge-modal-btn--ghost';
     cancel.dataset.ge = 'bonus-confirm-cancel';
     cancel.textContent = shell.t('Cancel');
-    cancel.addEventListener('click', () => ui.root.remove());
+    cancel.addEventListener('click', () => closeConfirm(overlay, st));
     const buy = document.createElement('button');
     buy.className = 'ge-modal-btn ge-modal-btn--accent';
     buy.dataset.ge = 'bonus-confirm-buy';
@@ -2470,8 +3079,7 @@ function buildConfirm(shell, bonus, overlay) {
             shell.activateFeature(bonus);
         else
             shell.emit('buyBonusSelect', { id: bonus.id });
-        ui.root.remove();
-        overlay.remove();
+        shell.closeModal();
     });
     actions.append(cancel, buy);
     ui.card.appendChild(actions);
@@ -2500,36 +3108,79 @@ function isAffordable(shell, bonus) {
 
 /** A centred picker (chips grid + accent Confirm) on the shared card modal. */
 function buildSheet(opts) {
-    const ui = createCardModal({ ge: opts.ge, title: opts.title, onClose: () => ui.root.remove() });
+    const ui = createCardModal({ ge: opts.ge, title: opts.title, onClose: () => opts.onClose() });
     const grid = document.createElement('div');
     grid.className = 'ge-sheet-grid';
     const cols = typeof opts.columns === 'number' ? { wide: opts.columns, mobile: opts.columns } : opts.columns;
     grid.style.setProperty('--cols', String(cols.wide));
     grid.style.setProperty('--cols-m', String(cols.mobile));
     let selected = opts.selected;
+    let focusIndex = opts.choices.findIndex((c) => c.id === selected);
+    if (focusIndex < 0)
+        focusIndex = 0;
     const chips = [];
-    for (const c of opts.choices) {
+    /** Update chip visuals to reflect the current selected/focused index. */
+    function setHighlight(newIndex) {
+        focusIndex = newIndex;
+        selected = opts.choices[focusIndex].id;
+        for (let i = 0; i < chips.length; i++) {
+            chips[i].classList.toggle('ge-on', i === focusIndex);
+        }
+    }
+    for (let i = 0; i < opts.choices.length; i++) {
+        const c = opts.choices[i];
         const chip = document.createElement('button');
-        chip.className = 'ge-chip' + (c.id === selected ? ' ge-on' : '');
+        chip.className = 'ge-chip' + (i === focusIndex ? ' ge-on' : '');
         chip.dataset.id = c.id;
         chip.textContent = c.label;
+        const idx = i; // capture for closure
         chip.addEventListener('click', () => {
-            selected = c.id;
-            for (const x of chips)
-                x.classList.toggle('ge-on', x.dataset.id === selected);
+            setHighlight(idx);
         });
         chips.push(chip);
         grid.appendChild(chip);
     }
     ui.body.appendChild(grid);
+    function doConfirm() {
+        opts.onConfirm(selected);
+        opts.onClose();
+    }
     // Single full-bleed Confirm; dismissal is the ✕ (top-right). No Cancel button.
     const confirm = document.createElement('button');
     confirm.className = 'ge-modal-btn ge-modal-btn--accent';
     confirm.dataset.ge = 'sheet-confirm';
     confirm.textContent = opts.confirmLabel;
-    confirm.addEventListener('click', () => { opts.onConfirm(selected); ui.root.remove(); });
+    confirm.addEventListener('click', doConfirm);
     ui.card.appendChild(confirm);
-    return ui.root;
+    function onKey(e) {
+        const last = opts.choices.length - 1;
+        switch (e.code) {
+            case 'ArrowRight':
+            case 'ArrowDown':
+            case 'Equal': // + on most keyboards
+            case 'NumpadAdd':
+                if (focusIndex < last)
+                    setHighlight(focusIndex + 1);
+                return true;
+            case 'ArrowLeft':
+            case 'ArrowUp':
+            case 'Minus':
+            case 'NumpadSubtract':
+                if (focusIndex > 0)
+                    setHighlight(focusIndex - 1);
+                return true;
+            case 'Enter':
+            case 'Space':
+                doConfirm();
+                return true;
+            case 'Escape':
+                opts.onClose();
+                return true;
+            default:
+                return false;
+        }
+    }
+    return { root: ui.root, onKey };
 }
 /** Bet picker — all available bets as chips (6 per row, 3 on mobile), accent Confirm applies it. */
 function openBetModal(shell) {
@@ -2537,6 +3188,7 @@ function openBetModal(shell) {
         ge: 'bet-modal', title: shell.t('Bet'), columns: { wide: 6, mobile: 3 }, confirmLabel: shell.t('Confirm'),
         choices: shell.state.availableBets.map((b) => ({ id: String(b), label: formatCurrency(b, shell.config.currency) })),
         selected: String(shell.state.bet),
+        onClose: () => shell.closeModal(),
         onConfirm: (id) => {
             const v = Number(id);
             if (v !== shell.state.bet) {
@@ -2567,6 +3219,7 @@ function openAutoplayModal(shell) {
         ge: 'autoplay-modal', title: shell.t('Autoplay'), columns: 3, confirmLabel: shell.t('Start'),
         choices: counts.map((n) => ({ id: String(n), label: Number.isFinite(n) ? String(n) : '∞' })),
         selected: String(shell.state.autoplay.remaining || counts[0]),
+        onClose: () => shell.closeModal(),
         onConfirm: (id) => {
             let remaining = Number(id); // "Infinity" → Infinity
             if (maxCount != null)
@@ -2714,6 +3367,868 @@ function countUp(el, from, to, fmt, durationMs = 450) {
     };
 }
 
+// MACHINE-TRANSLATED — native QA required before production use.
+// Keys are the English source strings exactly as they appear at t('…') call sites.
+// Entries within each language block are sorted alphabetically by key for diff stability.
+// 'en' is omitted: the resolver returns the source string unchanged for English.
+const LOCALES = {
+    da: {
+        DISCLAIMER: 'Ansvarsfraskrivelse',
+        Activate: 'Aktivér',
+        Autoplay: 'Autoplay',
+        Balance: 'Saldo',
+        Bet: 'Indsats',
+        'BUY BONUS': 'KØB BONUS',
+        Buy: 'Køb',
+        'Buy bonus': 'Køb bonus',
+        Cancel: 'Annuller',
+        Close: 'Luk',
+        'Cluster pays': 'Klyngeudbetaling',
+        Confirm: 'Bekræft',
+        Controls: 'Kontroller',
+        'Decrease your stake.': 'Reducer din indsats.',
+        DISABLE: 'DEAKTIVER',
+        'Dismiss the current overlay.': 'Luk det aktuelle overlay.',
+        'Free spins': 'Gratisspins',
+        Game: 'Spil',
+        'Game info': 'Spilinfo',
+        Hotkeys: 'Tastaturgenveje',
+        'Increase your stake.': 'Forøg din indsats.',
+        'Lower bet': 'Lavere indsats',
+        'Master volume': 'Hovedvolumen',
+        'Max win': 'Maks gevinst',
+        Menu: 'Menu',
+        'Menu & info': 'Menu og info',
+        Modes: 'Tilstande',
+        Music: 'Musik',
+        Mute: 'Lydløs',
+        'Mute or unmute the game.': 'Slå lyden til/fra.',
+        Navigate: 'Naviger',
+        'Open settings and game info.': 'Åbn indstillinger og spilinfo.',
+        'Open the paytable and rules.': 'Åbn gevinsttabel og regler.',
+        'Pay a fixed cost to enter a bonus feature.': 'Betal en fast pris for at aktivere en bonusfunktion.',
+        Paylines: 'Gevinstlinjer',
+        Paytable: 'Gevinsttabel',
+        'Pays anywhere': 'Udbetaler overalt',
+        Price: 'Pris',
+        'Raise bet': 'Hæv indsats',
+        Replay: 'Genspil',
+        RTP: 'RTP',
+        SFX: 'Lydeffekter',
+        Settings: 'Indstillinger',
+        Sound: 'Lyd',
+        Spin: 'Drej',
+        'Spin automatically a set number of times.': 'Spin automatisk et bestemt antal gange.',
+        'Speed up spin animations.': 'Gør spilanimationer hurtigere.',
+        Start: 'Start',
+        'Start a spin at the current bet.': 'Start et spin med den aktuelle indsats.',
+        'Start replay': 'Start genspil',
+        'Total win': 'Samlet gevinst',
+        Turbo: 'Turbo',
+        'Ways to win': 'Vindermuligheder',
+        Win: 'Gevinst',
+        'Winning shapes': 'Vindende former',
+    },
+    de: {
+        DISCLAIMER: 'Haftungsausschluss',
+        Activate: 'Aktivieren',
+        Autoplay: 'Autoplay',
+        Balance: 'Kontostand',
+        Bet: 'Einsatz',
+        'BUY BONUS': 'BONUS KAUFEN',
+        Buy: 'Kaufen',
+        'Buy bonus': 'Bonus kaufen',
+        Cancel: 'Abbrechen',
+        Close: 'Schließen',
+        'Cluster pays': 'Cluster-Gewinne',
+        Confirm: 'Bestätigen',
+        Controls: 'Steuerung',
+        'Decrease your stake.': 'Einsatz verringern.',
+        DISABLE: 'DEAKTIVIEREN',
+        'Dismiss the current overlay.': 'Aktuelles Overlay schließen.',
+        'Free spins': 'Freispiele',
+        Game: 'Spiel',
+        'Game info': 'Spielinfo',
+        Hotkeys: 'Tastenkürzel',
+        'Increase your stake.': 'Einsatz erhöhen.',
+        'Lower bet': 'Einsatz senken',
+        'Master volume': 'Gesamtlautstärke',
+        'Max win': 'Max. Gewinn',
+        Menu: 'Menü',
+        'Menu & info': 'Menü & Info',
+        Modes: 'Modi',
+        Music: 'Musik',
+        Mute: 'Stummschalten',
+        'Mute or unmute the game.': 'Ton stummschalten oder aktivieren.',
+        Navigate: 'Navigieren',
+        'Open settings and game info.': 'Einstellungen und Spielinfo öffnen.',
+        'Open the paytable and rules.': 'Gewinntabelle und Regeln öffnen.',
+        'Pay a fixed cost to enter a bonus feature.': 'Zahle einen festen Betrag, um ein Bonus-Feature zu aktivieren.',
+        Paylines: 'Gewinnlinien',
+        Paytable: 'Gewinntabelle',
+        'Pays anywhere': 'Zahlt überall',
+        Price: 'Preis',
+        'Raise bet': 'Einsatz erhöhen',
+        Replay: 'Wiederholen',
+        RTP: 'RTP',
+        SFX: 'Soundeffekte',
+        Settings: 'Einstellungen',
+        Sound: 'Ton',
+        Spin: 'Drehen',
+        'Spin automatically a set number of times.': 'Automatisch eine festgelegte Anzahl von Runden spielen.',
+        'Speed up spin animations.': 'Animationen beschleunigen.',
+        Start: 'Start',
+        'Start a spin at the current bet.': 'Mit dem aktuellen Einsatz drehen.',
+        'Start replay': 'Wiederholen',
+        'Total win': 'Gesamtgewinn',
+        Turbo: 'Turbo',
+        'Ways to win': 'Gewinnwege',
+        Win: 'Gewinn',
+        'Winning shapes': 'Gewinnmuster',
+    },
+    es: {
+        DISCLAIMER: 'Aviso legal',
+        Activate: 'Activar',
+        Autoplay: 'Giro automático',
+        Balance: 'Saldo',
+        Bet: 'Apuesta',
+        'BUY BONUS': 'COMPRAR BONO',
+        Buy: 'Comprar',
+        'Buy bonus': 'Comprar bono',
+        Cancel: 'Cancelar',
+        Close: 'Cerrar',
+        'Cluster pays': 'Pago en racimo',
+        Confirm: 'Confirmar',
+        Controls: 'Controles',
+        'Decrease your stake.': 'Reducir apuesta.',
+        DISABLE: 'DESACTIVAR',
+        'Dismiss the current overlay.': 'Cerrar el panel actual.',
+        'Free spins': 'Giros gratis',
+        Game: 'Juego',
+        'Game info': 'Info del juego',
+        Hotkeys: 'Atajos de teclado',
+        'Increase your stake.': 'Aumentar apuesta.',
+        'Lower bet': 'Bajar apuesta',
+        'Master volume': 'Volumen principal',
+        'Max win': 'Ganancia máxima',
+        Menu: 'Menú',
+        'Menu & info': 'Menú e info',
+        Modes: 'Modos',
+        Music: 'Música',
+        Mute: 'Silenciar',
+        'Mute or unmute the game.': 'Activar o silenciar el sonido.',
+        Navigate: 'Navegar',
+        'Open settings and game info.': 'Abrir ajustes e info del juego.',
+        'Open the paytable and rules.': 'Abrir tabla de pagos y reglas.',
+        'Pay a fixed cost to enter a bonus feature.': 'Paga un coste fijo para acceder a una función de bono.',
+        Paylines: 'Líneas de pago',
+        Paytable: 'Tabla de pagos',
+        'Pays anywhere': 'Paga en cualquier lugar',
+        Price: 'Precio',
+        'Raise bet': 'Subir apuesta',
+        Replay: 'Repetir',
+        RTP: 'RTP',
+        SFX: 'Efectos de sonido',
+        Settings: 'Ajustes',
+        Sound: 'Sonido',
+        Spin: 'Girar',
+        'Spin automatically a set number of times.': 'Girar automáticamente un número determinado de veces.',
+        'Speed up spin animations.': 'Acelerar las animaciones de giro.',
+        Start: 'Iniciar',
+        'Start a spin at the current bet.': 'Iniciar un giro con la apuesta actual.',
+        'Start replay': 'Iniciar repetición',
+        'Total win': 'Ganancia total',
+        Turbo: 'Turbo',
+        'Ways to win': 'Formas de ganar',
+        Win: 'Premio',
+        'Winning shapes': 'Figuras ganadoras',
+    },
+    fi: {
+        DISCLAIMER: 'Vastuuvapauslauseke',
+        Activate: 'Aktivoi',
+        Autoplay: 'Automaattipeli',
+        Balance: 'Saldo',
+        Bet: 'Panos',
+        'BUY BONUS': 'OSTA BONUS',
+        Buy: 'Osta',
+        'Buy bonus': 'Osta bonus',
+        Cancel: 'Peruuta',
+        Close: 'Sulje',
+        'Cluster pays': 'Ryhmävoitto',
+        Confirm: 'Vahvista',
+        Controls: 'Ohjaimet',
+        'Decrease your stake.': 'Pienennä panostasi.',
+        DISABLE: 'POISTA KÄYTÖSTÄ',
+        'Dismiss the current overlay.': 'Sulje nykyinen näkymä.',
+        'Free spins': 'Ilmaiskierrokset',
+        Game: 'Peli',
+        'Game info': 'Pelitiedot',
+        Hotkeys: 'Pikanäppäimet',
+        'Increase your stake.': 'Kasvata panostasi.',
+        'Lower bet': 'Pienennä panosta',
+        'Master volume': 'Pääänenvoimakkuus',
+        'Max win': 'Maksimivoitto',
+        Menu: 'Valikko',
+        'Menu & info': 'Valikko ja tiedot',
+        Modes: 'Tilat',
+        Music: 'Musiikki',
+        Mute: 'Mykistä',
+        'Mute or unmute the game.': 'Mykistä tai poista mykistys.',
+        Navigate: 'Navigoi',
+        'Open settings and game info.': 'Avaa asetukset ja pelitiedot.',
+        'Open the paytable and rules.': 'Avaa voittotaulukko ja säännöt.',
+        'Pay a fixed cost to enter a bonus feature.': 'Maksa kiinteä summa päästäksesi bonusominaisuuteen.',
+        Paylines: 'Voittolinjat',
+        Paytable: 'Voittotaulukko',
+        'Pays anywhere': 'Voittaa missä tahansa',
+        Price: 'Hinta',
+        'Raise bet': 'Nosta panosta',
+        Replay: 'Toista uudelleen',
+        RTP: 'RTP',
+        SFX: 'Ääniefektit',
+        Settings: 'Asetukset',
+        Sound: 'Ääni',
+        Spin: 'Pyöräytä',
+        'Spin automatically a set number of times.': 'Pyöräytä automaattisesti määritetty määrä kertoja.',
+        'Speed up spin animations.': 'Nopeuta pyöräytysanimaatioita.',
+        Start: 'Aloita',
+        'Start a spin at the current bet.': 'Aloita pyöräytys nykyisellä panoksella.',
+        'Start replay': 'Aloita uudelleentoisto',
+        'Total win': 'Kokonaisvoitto',
+        Turbo: 'Turbo',
+        'Ways to win': 'Voittotavat',
+        Win: 'Voitto',
+        'Winning shapes': 'Voittokuviot',
+    },
+    fr: {
+        DISCLAIMER: 'Avertissement',
+        Activate: 'Activer',
+        Autoplay: 'Jeu automatique',
+        Balance: 'Solde',
+        Bet: 'Mise',
+        'BUY BONUS': 'ACHETER BONUS',
+        Buy: 'Acheter',
+        'Buy bonus': 'Acheter un bonus',
+        Cancel: 'Annuler',
+        Close: 'Fermer',
+        'Cluster pays': 'Gains en grappe',
+        Confirm: 'Confirmer',
+        Controls: 'Commandes',
+        'Decrease your stake.': 'Diminuer votre mise.',
+        DISABLE: 'DÉSACTIVER',
+        'Dismiss the current overlay.': 'Fermer le panneau actuel.',
+        'Free spins': 'Tours gratuits',
+        Game: 'Jeu',
+        'Game info': 'Infos du jeu',
+        Hotkeys: 'Raccourcis clavier',
+        'Increase your stake.': 'Augmenter votre mise.',
+        'Lower bet': 'Baisser la mise',
+        'Master volume': 'Volume principal',
+        'Max win': 'Gain maximum',
+        Menu: 'Menu',
+        'Menu & info': 'Menu et info',
+        Modes: 'Modes',
+        Music: 'Musique',
+        Mute: 'Couper le son',
+        'Mute or unmute the game.': 'Couper ou rétablir le son.',
+        Navigate: 'Naviguer',
+        'Open settings and game info.': 'Ouvrir les paramètres et infos du jeu.',
+        'Open the paytable and rules.': 'Ouvrir la table des gains et les règles.',
+        'Pay a fixed cost to enter a bonus feature.': 'Payez un coût fixe pour accéder à une fonctionnalité bonus.',
+        Paylines: 'Lignes de paiement',
+        Paytable: 'Table des gains',
+        'Pays anywhere': 'Gains sur toute la grille',
+        Price: 'Prix',
+        'Raise bet': 'Augmenter la mise',
+        Replay: 'Revoir',
+        RTP: 'RTP',
+        SFX: 'Effets sonores',
+        Settings: 'Paramètres',
+        Sound: 'Son',
+        Spin: 'Tourner',
+        'Spin automatically a set number of times.': 'Tourner automatiquement un nombre de fois défini.',
+        'Speed up spin animations.': 'Accélérer les animations de spin.',
+        Start: 'Lancer',
+        'Start a spin at the current bet.': 'Lancer un tour avec la mise actuelle.',
+        'Start replay': 'Lancer le replay',
+        'Total win': 'Gain total',
+        Turbo: 'Turbo',
+        'Ways to win': 'Façons de gagner',
+        Win: 'Gain',
+        'Winning shapes': 'Figures gagnantes',
+    },
+    hi: {
+        DISCLAIMER: 'अस्वीकरण',
+        Activate: 'सक्रिय करें',
+        Autoplay: 'ऑटोप्ले',
+        Balance: 'बैलेंस',
+        Bet: 'दांव',
+        'BUY BONUS': 'बोनस खरीदें',
+        Buy: 'खरीदें',
+        'Buy bonus': 'बोनस खरीदें',
+        Cancel: 'रद्द करें',
+        Close: 'बंद करें',
+        'Cluster pays': 'क्लस्टर भुगतान',
+        Confirm: 'पुष्टि करें',
+        Controls: 'नियंत्रण',
+        'Decrease your stake.': 'अपना दांव कम करें।',
+        DISABLE: 'बंद करें',
+        'Dismiss the current overlay.': 'वर्तमान ओवरले बंद करें।',
+        'Free spins': 'फ्री स्पिन',
+        Game: 'खेल',
+        'Game info': 'गेम जानकारी',
+        Hotkeys: 'कीबोर्ड शॉर्टकट',
+        'Increase your stake.': 'अपना दांव बढ़ाएं।',
+        'Lower bet': 'दांव घटाएं',
+        'Master volume': 'मुख्य वॉल्यूम',
+        'Max win': 'अधिकतम जीत',
+        Menu: 'मेनू',
+        'Menu & info': 'मेनू और जानकारी',
+        Modes: 'मोड',
+        Music: 'संगीत',
+        Mute: 'म्यूट करें',
+        'Mute or unmute the game.': 'गेम को म्यूट या अनम्यूट करें।',
+        Navigate: 'नेविगेट करें',
+        'Open settings and game info.': 'सेटिंग और गेम जानकारी खोलें।',
+        'Open the paytable and rules.': 'पेटेबल और नियम खोलें।',
+        'Pay a fixed cost to enter a bonus feature.': 'बोनस फीचर में प्रवेश के लिए एक निश्चित राशि दें।',
+        Paylines: 'पेलाइन',
+        Paytable: 'पेटेबल',
+        'Pays anywhere': 'कहीं भी जीत',
+        Price: 'मूल्य',
+        'Raise bet': 'दांव बढ़ाएं',
+        Replay: 'दोबारा खेलें',
+        RTP: 'RTP',
+        SFX: 'ध्वनि प्रभाव',
+        Settings: 'सेटिंग',
+        Sound: 'ध्वनि',
+        Spin: 'स्पिन',
+        'Spin automatically a set number of times.': 'एक निश्चित संख्या में स्वचालित रूप से स्पिन करें।',
+        'Speed up spin animations.': 'स्पिन एनिमेशन को तेज़ करें।',
+        Start: 'शुरू करें',
+        'Start a spin at the current bet.': 'वर्तमान दांव पर स्पिन शुरू करें।',
+        'Start replay': 'रीप्ले शुरू करें',
+        'Total win': 'कुल जीत',
+        Turbo: 'टर्बो',
+        'Ways to win': 'जीत के तरीके',
+        Win: 'जीत',
+        'Winning shapes': 'जीत के आकार',
+    },
+    id: {
+        DISCLAIMER: 'Penafian',
+        Activate: 'Aktifkan',
+        Autoplay: 'Putar Otomatis',
+        Balance: 'Saldo',
+        Bet: 'Taruhan',
+        'BUY BONUS': 'BELI BONUS',
+        Buy: 'Beli',
+        'Buy bonus': 'Beli bonus',
+        Cancel: 'Batal',
+        Close: 'Tutup',
+        'Cluster pays': 'Bayar kluster',
+        Confirm: 'Konfirmasi',
+        Controls: 'Kontrol',
+        'Decrease your stake.': 'Kurangi taruhan Anda.',
+        DISABLE: 'NONAKTIFKAN',
+        'Dismiss the current overlay.': 'Tutup overlay saat ini.',
+        'Free spins': 'Putaran gratis',
+        Game: 'Permainan',
+        'Game info': 'Info permainan',
+        Hotkeys: 'Pintasan keyboard',
+        'Increase your stake.': 'Tingkatkan taruhan Anda.',
+        'Lower bet': 'Turunkan taruhan',
+        'Master volume': 'Volume utama',
+        'Max win': 'Kemenangan maks',
+        Menu: 'Menu',
+        'Menu & info': 'Menu & info',
+        Modes: 'Mode',
+        Music: 'Musik',
+        Mute: 'Bisukan',
+        'Mute or unmute the game.': 'Bisukan atau aktifkan suara permainan.',
+        Navigate: 'Navigasi',
+        'Open settings and game info.': 'Buka pengaturan dan info permainan.',
+        'Open the paytable and rules.': 'Buka tabel pembayaran dan aturan.',
+        'Pay a fixed cost to enter a bonus feature.': 'Bayar biaya tetap untuk masuk ke fitur bonus.',
+        Paylines: 'Garis pembayaran',
+        Paytable: 'Tabel pembayaran',
+        'Pays anywhere': 'Menang di mana saja',
+        Price: 'Harga',
+        'Raise bet': 'Naikkan taruhan',
+        Replay: 'Putar ulang',
+        RTP: 'RTP',
+        SFX: 'Efek suara',
+        Settings: 'Pengaturan',
+        Sound: 'Suara',
+        Spin: 'Putar',
+        'Spin automatically a set number of times.': 'Putar otomatis sejumlah kali yang ditentukan.',
+        'Speed up spin animations.': 'Percepat animasi putaran.',
+        Start: 'Mulai',
+        'Start a spin at the current bet.': 'Mulai putaran dengan taruhan saat ini.',
+        'Start replay': 'Mulai putar ulang',
+        'Total win': 'Total kemenangan',
+        Turbo: 'Turbo',
+        'Ways to win': 'Cara menang',
+        Win: 'Menang',
+        'Winning shapes': 'Bentuk kemenangan',
+    },
+    ja: {
+        DISCLAIMER: '免責事項',
+        Activate: '有効化',
+        Autoplay: 'オートプレイ',
+        Balance: '残高',
+        Bet: 'ベット',
+        'BUY BONUS': 'ボーナス購入',
+        Buy: '購入',
+        'Buy bonus': 'ボーナス購入',
+        Cancel: 'キャンセル',
+        Close: '閉じる',
+        'Cluster pays': 'クラスター配当',
+        Confirm: '確認',
+        Controls: '操作方法',
+        'Decrease your stake.': 'ベットを減らす。',
+        DISABLE: '無効',
+        'Dismiss the current overlay.': '現在のオーバーレイを閉じる。',
+        'Free spins': 'フリースピン',
+        Game: 'ゲーム',
+        'Game info': 'ゲーム情報',
+        Hotkeys: 'キーボードショートカット',
+        'Increase your stake.': 'ベットを増やす。',
+        'Lower bet': 'ベットを下げる',
+        'Master volume': 'マスターボリューム',
+        'Max win': '最大当選',
+        Menu: 'メニュー',
+        'Menu & info': 'メニューと情報',
+        Modes: 'モード',
+        Music: 'ミュージック',
+        Mute: 'ミュート',
+        'Mute or unmute the game.': 'ゲームをミュート/ミュート解除する。',
+        Navigate: 'ナビゲート',
+        'Open settings and game info.': '設定とゲーム情報を開く。',
+        'Open the paytable and rules.': '配当表とルールを開く。',
+        'Pay a fixed cost to enter a bonus feature.': 'ボーナス機能に入るために固定料金を支払う。',
+        Paylines: 'ペイライン',
+        Paytable: '配当表',
+        'Pays anywhere': 'どこでも当選',
+        Price: '価格',
+        'Raise bet': 'ベットを上げる',
+        Replay: 'リプレイ',
+        RTP: 'RTP',
+        SFX: '効果音',
+        Settings: '設定',
+        Sound: 'サウンド',
+        Spin: 'スピン',
+        'Spin automatically a set number of times.': '設定した回数だけ自動でスピンする。',
+        'Speed up spin animations.': 'スピンアニメーションを高速化する。',
+        Start: 'スタート',
+        'Start a spin at the current bet.': '現在のベットでスピンを開始する。',
+        'Start replay': 'リプレイ開始',
+        'Total win': '合計当選',
+        Turbo: 'ターボ',
+        'Ways to win': '当選方法',
+        Win: '当選',
+        'Winning shapes': '当選形状',
+    },
+    ko: {
+        DISCLAIMER: '면책 조항',
+        Activate: '활성화',
+        Autoplay: '자동 플레이',
+        Balance: '잔액',
+        Bet: '베팅',
+        'BUY BONUS': '보너스 구매',
+        Buy: '구매',
+        'Buy bonus': '보너스 구매',
+        Cancel: '취소',
+        Close: '닫기',
+        'Cluster pays': '클러스터 페이',
+        Confirm: '확인',
+        Controls: '조작법',
+        'Decrease your stake.': '베팅을 줄이세요.',
+        DISABLE: '비활성화',
+        'Dismiss the current overlay.': '현재 오버레이를 닫습니다.',
+        'Free spins': '무료 스핀',
+        Game: '게임',
+        'Game info': '게임 정보',
+        Hotkeys: '키보드 단축키',
+        'Increase your stake.': '베팅을 늘리세요.',
+        'Lower bet': '베팅 낮추기',
+        'Master volume': '마스터 볼륨',
+        'Max win': '최대 당첨',
+        Menu: '메뉴',
+        'Menu & info': '메뉴 & 정보',
+        Modes: '모드',
+        Music: '음악',
+        Mute: '음소거',
+        'Mute or unmute the game.': '게임 소리를 켜거나 끕니다.',
+        Navigate: '이동',
+        'Open settings and game info.': '설정 및 게임 정보를 엽니다.',
+        'Open the paytable and rules.': '페이테이블 및 규칙을 엽니다.',
+        'Pay a fixed cost to enter a bonus feature.': '고정 비용을 지불하고 보너스 기능에 진입하세요.',
+        Paylines: '페이라인',
+        Paytable: '페이테이블',
+        'Pays anywhere': '어디서나 당첨',
+        Price: '가격',
+        'Raise bet': '베팅 올리기',
+        Replay: '다시보기',
+        RTP: 'RTP',
+        SFX: '효과음',
+        Settings: '설정',
+        Sound: '사운드',
+        Spin: '스핀',
+        'Spin automatically a set number of times.': '정해진 횟수만큼 자동으로 스핀합니다.',
+        'Speed up spin animations.': '스핀 애니메이션을 빠르게 합니다.',
+        Start: '시작',
+        'Start a spin at the current bet.': '현재 베팅으로 스핀을 시작합니다.',
+        'Start replay': '다시보기 시작',
+        'Total win': '총 당첨',
+        Turbo: '터보',
+        'Ways to win': '당첨 방법',
+        Win: '당첨',
+        'Winning shapes': '당첨 패턴',
+    },
+    pl: {
+        DISCLAIMER: 'Zastrzeżenie',
+        Activate: 'Aktywuj',
+        Autoplay: 'Autoplay',
+        Balance: 'Saldo',
+        Bet: 'Zakład',
+        'BUY BONUS': 'KUP BONUS',
+        Buy: 'Kup',
+        'Buy bonus': 'Kup bonus',
+        Cancel: 'Anuluj',
+        Close: 'Zamknij',
+        'Cluster pays': 'Wypłaty klastrowe',
+        Confirm: 'Potwierdź',
+        Controls: 'Sterowanie',
+        'Decrease your stake.': 'Zmniejsz swój zakład.',
+        DISABLE: 'WYŁĄCZ',
+        'Dismiss the current overlay.': 'Zamknij bieżące okno.',
+        'Free spins': 'Darmowe spiny',
+        Game: 'Gra',
+        'Game info': 'Informacje o grze',
+        Hotkeys: 'Skróty klawiaturowe',
+        'Increase your stake.': 'Zwiększ swój zakład.',
+        'Lower bet': 'Obniż zakład',
+        'Master volume': 'Głośność główna',
+        'Max win': 'Maks. wygrana',
+        Menu: 'Menu',
+        'Menu & info': 'Menu i informacje',
+        Modes: 'Tryby',
+        Music: 'Muzyka',
+        Mute: 'Wycisz',
+        'Mute or unmute the game.': 'Wycisz lub odcisz dźwięk gry.',
+        Navigate: 'Nawiguj',
+        'Open settings and game info.': 'Otwórz ustawienia i informacje o grze.',
+        'Open the paytable and rules.': 'Otwórz tabelę wygranych i zasady.',
+        'Pay a fixed cost to enter a bonus feature.': 'Zapłać stałą kwotę, aby wejść do funkcji bonusowej.',
+        Paylines: 'Linie wygrywające',
+        Paytable: 'Tabela wygranych',
+        'Pays anywhere': 'Wypłaca wszędzie',
+        Price: 'Cena',
+        'Raise bet': 'Podnieś zakład',
+        Replay: 'Odtwórz ponownie',
+        RTP: 'RTP',
+        SFX: 'Efekty dźwiękowe',
+        Settings: 'Ustawienia',
+        Sound: 'Dźwięk',
+        Spin: 'Zakręć',
+        'Spin automatically a set number of times.': 'Obracaj automatycznie określoną liczbę razy.',
+        'Speed up spin animations.': 'Przyspiesz animacje obrotów.',
+        Start: 'Start',
+        'Start a spin at the current bet.': 'Rozpocznij obrót przy bieżącym zakładzie.',
+        'Start replay': 'Rozpocznij odtwarzanie',
+        'Total win': 'Łączna wygrana',
+        Turbo: 'Turbo',
+        'Ways to win': 'Sposoby wygrywania',
+        Win: 'Wygrana',
+        'Winning shapes': 'Wzory wygrywające',
+    },
+    pt: {
+        DISCLAIMER: 'Aviso legal',
+        Activate: 'Ativar',
+        Autoplay: 'Giro automático',
+        Balance: 'Saldo',
+        Bet: 'Aposta',
+        'BUY BONUS': 'COMPRAR BÔNUS',
+        Buy: 'Comprar',
+        'Buy bonus': 'Comprar bônus',
+        Cancel: 'Cancelar',
+        Close: 'Fechar',
+        'Cluster pays': 'Pagamento em cluster',
+        Confirm: 'Confirmar',
+        Controls: 'Controles',
+        'Decrease your stake.': 'Diminuir aposta.',
+        DISABLE: 'DESATIVAR',
+        'Dismiss the current overlay.': 'Fechar o painel atual.',
+        'Free spins': 'Giros grátis',
+        Game: 'Jogo',
+        'Game info': 'Info do jogo',
+        Hotkeys: 'Atalhos de teclado',
+        'Increase your stake.': 'Aumentar aposta.',
+        'Lower bet': 'Baixar aposta',
+        'Master volume': 'Volume principal',
+        'Max win': 'Ganho máximo',
+        Menu: 'Menu',
+        'Menu & info': 'Menu e info',
+        Modes: 'Modos',
+        Music: 'Música',
+        Mute: 'Silenciar',
+        'Mute or unmute the game.': 'Ativar ou silenciar o som do jogo.',
+        Navigate: 'Navegar',
+        'Open settings and game info.': 'Abrir configurações e info do jogo.',
+        'Open the paytable and rules.': 'Abrir tabela de pagamentos e regras.',
+        'Pay a fixed cost to enter a bonus feature.': 'Pague um custo fixo para entrar numa funcionalidade de bônus.',
+        Paylines: 'Linhas de pagamento',
+        Paytable: 'Tabela de pagamentos',
+        'Pays anywhere': 'Paga em qualquer posição',
+        Price: 'Preço',
+        'Raise bet': 'Aumentar aposta',
+        Replay: 'Repetir',
+        RTP: 'RTP',
+        SFX: 'Efeitos sonoros',
+        Settings: 'Configurações',
+        Sound: 'Som',
+        Spin: 'Girar',
+        'Spin automatically a set number of times.': 'Girar automaticamente um número definido de vezes.',
+        'Speed up spin animations.': 'Acelerar as animações de giro.',
+        Start: 'Iniciar',
+        'Start a spin at the current bet.': 'Iniciar um giro com a aposta atual.',
+        'Start replay': 'Iniciar repetição',
+        'Total win': 'Ganho total',
+        Turbo: 'Turbo',
+        'Ways to win': 'Formas de ganhar',
+        Win: 'Ganho',
+        'Winning shapes': 'Figuras vencedoras',
+    },
+    ru: {
+        DISCLAIMER: 'Отказ от ответственности',
+        Activate: 'Активировать',
+        Autoplay: 'Автоигра',
+        Balance: 'Баланс',
+        Bet: 'Ставка',
+        'BUY BONUS': 'КУПИТЬ БОНУС',
+        Buy: 'Купить',
+        'Buy bonus': 'Купить бонус',
+        Cancel: 'Отмена',
+        Close: 'Закрыть',
+        'Cluster pays': 'Кластерные выплаты',
+        Confirm: 'Подтвердить',
+        Controls: 'Управление',
+        'Decrease your stake.': 'Уменьшить ставку.',
+        DISABLE: 'ОТКЛЮЧИТЬ',
+        'Dismiss the current overlay.': 'Закрыть текущее окно.',
+        'Free spins': 'Бесплатные вращения',
+        Game: 'Игра',
+        'Game info': 'Информация об игре',
+        Hotkeys: 'Горячие клавиши',
+        'Increase your stake.': 'Увеличить ставку.',
+        'Lower bet': 'Уменьшить ставку',
+        'Master volume': 'Общая громкость',
+        'Max win': 'Макс. выигрыш',
+        Menu: 'Меню',
+        'Menu & info': 'Меню и информация',
+        Modes: 'Режимы',
+        Music: 'Музыка',
+        Mute: 'Отключить звук',
+        'Mute or unmute the game.': 'Включить или отключить звук.',
+        Navigate: 'Навигация',
+        'Open settings and game info.': 'Открыть настройки и информацию об игре.',
+        'Open the paytable and rules.': 'Открыть таблицу выплат и правила.',
+        'Pay a fixed cost to enter a bonus feature.': 'Заплатите фиксированную сумму для входа в бонусный раунд.',
+        Paylines: 'Линии выплат',
+        Paytable: 'Таблица выплат',
+        'Pays anywhere': 'Выплачивает в любом месте',
+        Price: 'Цена',
+        'Raise bet': 'Повысить ставку',
+        Replay: 'Повтор',
+        RTP: 'RTP',
+        SFX: 'Звуковые эффекты',
+        Settings: 'Настройки',
+        Sound: 'Звук',
+        Spin: 'Вращение',
+        'Spin automatically a set number of times.': 'Автоматически вращать заданное количество раз.',
+        'Speed up spin animations.': 'Ускорить анимацию вращений.',
+        Start: 'Начать',
+        'Start a spin at the current bet.': 'Начать вращение с текущей ставкой.',
+        'Start replay': 'Начать повтор',
+        'Total win': 'Общий выигрыш',
+        Turbo: 'Турбо',
+        'Ways to win': 'Способы выигрыша',
+        Win: 'Выигрыш',
+        'Winning shapes': 'Выигрышные комбинации',
+    },
+    tr: {
+        DISCLAIMER: 'Yasal uyarı',
+        Activate: 'Etkinleştir',
+        Autoplay: 'Otomatik Oyun',
+        Balance: 'Bakiye',
+        Bet: 'Bahis',
+        'BUY BONUS': 'BONUS SATIN AL',
+        Buy: 'Satın al',
+        'Buy bonus': 'Bonus satın al',
+        Cancel: 'İptal',
+        Close: 'Kapat',
+        'Cluster pays': 'Küme ödemeleri',
+        Confirm: 'Onayla',
+        Controls: 'Kontroller',
+        'Decrease your stake.': 'Bahsinizi azaltın.',
+        DISABLE: 'DEVRE DIŞI',
+        'Dismiss the current overlay.': 'Mevcut pencereyi kapat.',
+        'Free spins': 'Ücretsiz dönüşler',
+        Game: 'Oyun',
+        'Game info': 'Oyun bilgisi',
+        Hotkeys: 'Klavye kısayolları',
+        'Increase your stake.': 'Bahsinizi artırın.',
+        'Lower bet': 'Bahsi düşür',
+        'Master volume': 'Ana ses',
+        'Max win': 'Maks kazanç',
+        Menu: 'Menü',
+        'Menu & info': 'Menü ve bilgi',
+        Modes: 'Modlar',
+        Music: 'Müzik',
+        Mute: 'Sessiz',
+        'Mute or unmute the game.': 'Oyun sesini aç ya da kapat.',
+        Navigate: 'Gezin',
+        'Open settings and game info.': 'Ayarları ve oyun bilgisini aç.',
+        'Open the paytable and rules.': 'Ödeme tablosunu ve kuralları aç.',
+        'Pay a fixed cost to enter a bonus feature.': 'Bonus özelliğine girmek için sabit bir ücret ödeyin.',
+        Paylines: 'Ödeme çizgileri',
+        Paytable: 'Ödeme tablosu',
+        'Pays anywhere': 'Her yerde kazandırır',
+        Price: 'Fiyat',
+        'Raise bet': 'Bahsi artır',
+        Replay: 'Tekrar oynat',
+        RTP: 'RTP',
+        SFX: 'Ses efektleri',
+        Settings: 'Ayarlar',
+        Sound: 'Ses',
+        Spin: 'Döndür',
+        'Spin automatically a set number of times.': 'Belirlenen sayıda otomatik döndür.',
+        'Speed up spin animations.': 'Döndürme animasyonlarını hızlandır.',
+        Start: 'Başlat',
+        'Start a spin at the current bet.': 'Mevcut bahisle döndürmeyi başlat.',
+        'Start replay': 'Tekrarı başlat',
+        'Total win': 'Toplam kazanç',
+        Turbo: 'Turbo',
+        'Ways to win': 'Kazanma yolları',
+        Win: 'Kazanç',
+        'Winning shapes': 'Kazanan şekiller',
+    },
+    vi: {
+        DISCLAIMER: 'Tuyên bố miễn trừ trách nhiệm',
+        Activate: 'Kích hoạt',
+        Autoplay: 'Tự động quay',
+        Balance: 'Số dư',
+        Bet: 'Cược',
+        'BUY BONUS': 'MUA THƯỞNG',
+        Buy: 'Mua',
+        'Buy bonus': 'Mua thưởng',
+        Cancel: 'Hủy',
+        Close: 'Đóng',
+        'Cluster pays': 'Trả theo cụm',
+        Confirm: 'Xác nhận',
+        Controls: 'Điều khiển',
+        'Decrease your stake.': 'Giảm mức cược.',
+        DISABLE: 'TẮT',
+        'Dismiss the current overlay.': 'Đóng lớp phủ hiện tại.',
+        'Free spins': 'Quay miễn phí',
+        Game: 'Trò chơi',
+        'Game info': 'Thông tin trò chơi',
+        Hotkeys: 'Phím tắt',
+        'Increase your stake.': 'Tăng mức cược.',
+        'Lower bet': 'Giảm cược',
+        'Master volume': 'Âm lượng chính',
+        'Max win': 'Thắng tối đa',
+        Menu: 'Menu',
+        'Menu & info': 'Menu & thông tin',
+        Modes: 'Chế độ',
+        Music: 'Âm nhạc',
+        Mute: 'Tắt âm',
+        'Mute or unmute the game.': 'Tắt hoặc bật âm thanh trò chơi.',
+        Navigate: 'Điều hướng',
+        'Open settings and game info.': 'Mở cài đặt và thông tin trò chơi.',
+        'Open the paytable and rules.': 'Mở bảng trả thưởng và quy tắc.',
+        'Pay a fixed cost to enter a bonus feature.': 'Trả một khoản phí cố định để tham gia tính năng thưởng.',
+        Paylines: 'Đường thắng',
+        Paytable: 'Bảng trả thưởng',
+        'Pays anywhere': 'Trả bất cứ đâu',
+        Price: 'Giá',
+        'Raise bet': 'Tăng cược',
+        Replay: 'Xem lại',
+        RTP: 'RTP',
+        SFX: 'Hiệu ứng âm thanh',
+        Settings: 'Cài đặt',
+        Sound: 'Âm thanh',
+        Spin: 'Quay',
+        'Spin automatically a set number of times.': 'Tự động quay một số lần nhất định.',
+        'Speed up spin animations.': 'Tăng tốc độ hoạt ảnh quay.',
+        Start: 'Bắt đầu',
+        'Start a spin at the current bet.': 'Bắt đầu quay với mức cược hiện tại.',
+        'Start replay': 'Bắt đầu xem lại',
+        'Total win': 'Tổng thắng',
+        Turbo: 'Turbo',
+        'Ways to win': 'Cách thắng',
+        Win: 'Thắng',
+        'Winning shapes': 'Hình thắng',
+    },
+    zh: {
+        DISCLAIMER: '免责声明',
+        Activate: '激活',
+        Autoplay: '自动游戏',
+        Balance: '余额',
+        Bet: '投注',
+        'BUY BONUS': '购买奖励',
+        Buy: '购买',
+        'Buy bonus': '购买奖励',
+        Cancel: '取消',
+        Close: '关闭',
+        'Cluster pays': '集群赔付',
+        Confirm: '确认',
+        Controls: '控制',
+        'Decrease your stake.': '降低投注额。',
+        DISABLE: '禁用',
+        'Dismiss the current overlay.': '关闭当前弹窗。',
+        'Free spins': '免费旋转',
+        Game: '游戏',
+        'Game info': '游戏信息',
+        Hotkeys: '快捷键',
+        'Increase your stake.': '提高投注额。',
+        'Lower bet': '降低投注',
+        'Master volume': '主音量',
+        'Max win': '最大奖金',
+        Menu: '菜单',
+        'Menu & info': '菜单与信息',
+        Modes: '模式',
+        Music: '音乐',
+        Mute: '静音',
+        'Mute or unmute the game.': '静音或取消静音。',
+        Navigate: '导航',
+        'Open settings and game info.': '打开设置和游戏信息。',
+        'Open the paytable and rules.': '打开赔付表和规则。',
+        'Pay a fixed cost to enter a bonus feature.': '支付固定费用以进入奖励功能。',
+        Paylines: '赔付线',
+        Paytable: '赔付表',
+        'Pays anywhere': '任意位置赢',
+        Price: '价格',
+        'Raise bet': '提高投注',
+        Replay: '重播',
+        RTP: 'RTP',
+        SFX: '音效',
+        Settings: '设置',
+        Sound: '声音',
+        Spin: '旋转',
+        'Spin automatically a set number of times.': '自动旋转设定次数。',
+        'Speed up spin animations.': '加速旋转动画。',
+        Start: '开始',
+        'Start a spin at the current bet.': '以当前投注额开始旋转。',
+        'Start replay': '开始重播',
+        'Total win': '总奖金',
+        Turbo: '急速',
+        'Ways to win': '赢法',
+        Win: '奖金',
+        'Winning shapes': '赢利图形',
+    },
+};
+
 // Social-casino language. English is the source (and, for now, the only) language; `socialize`
 // rewrites the restricted gambling vocabulary into social-safe phrasing while preserving case.
 //
@@ -2786,6 +4301,21 @@ function socialize(text) {
         return repl == null ? m : applyCase(m, repl);
     });
 }
+const LANGS = ['de', 'en', 'es', 'fi', 'fr', 'hi', 'id', 'ja', 'ko', 'pl', 'pt', 'ru', 'tr', 'vi', 'zh', 'da'];
+const LANG_SET = new Set(LANGS);
+function normalizeLang(code) {
+    const base = (code ?? '').toLowerCase().split(/[-_]/)[0];
+    return (LANG_SET.has(base) ? base : 'en');
+}
+function createI18n(opts) {
+    const lang = normalizeLang(opts.language);
+    const t = (src) => {
+        if (lang === 'en')
+            return opts.isSocial ? socialize(src) : src;
+        return opts.messages?.[lang]?.[src] ?? LOCALES[lang]?.[src] ?? src;
+    };
+    return { lang, t };
+}
 
 const REMOVE_FADE_MS = 300;
 class GameShell extends EventEmitter {
@@ -2801,10 +4331,19 @@ class GameShell extends EventEmitter {
     prevBalance = 0;
     prevWin = 0;
     moneyAnims = [];
-    keysBound = false;
+    kbd;
+    i18n;
+    /** onKey handler of the currently open modal/overlay, if any (set in showModal, cleared in closeModal). */
+    modalOnKey = undefined;
+    /** Shared sound on/off state — Settings speaker toggle and the Shift+M hotkey stay in sync. The
+     *  game listens to `settingChange({ key: 'sound' })` to (un)mute audio. */
+    soundOn = true;
+    /** Set by the open Settings modal so Shift+M live-updates its speaker icon; cleared on close. */
+    soundRefresh = null;
     constructor(config) {
         super();
         this.config = config;
+        this.i18n = createI18n({ language: config.language, isSocial: config.isSocial });
         this.state = createInitialState(config);
         this.styleEl = document.createElement('style');
         this.styleEl.textContent = SHELL_CSS;
@@ -2820,12 +4359,54 @@ class GameShell extends EventEmitter {
         this.prevWin = this.state.win;
         this.observeLayout();
         if (typeof document !== 'undefined') {
-            document.addEventListener('keydown', this.handleKeyDown);
+            // eslint-disable-next-line @typescript-eslint/no-this-alias
+            const shell = this;
+            const host = {
+                get state() { return shell.state; },
+                get hotkeysEnabled() { return shell.config.features.hotkeys !== false; },
+                get spacebarEnabled() { return shell.config.features.spacebar !== false; },
+                get turboLevels() { return shell.config.features.turbo; },
+                get autoplayEnabled() { return shell.config.features.autoplay != null; },
+                get buyBonusEnabled() { return shell.config.features.buyBonus !== false; },
+                hasOpenLayer: () => shell.modalHost.childElementCount > 0,
+                routeToLayer: (e) => shell.modalOnKey?.(e) ?? false,
+                spin: () => shell.emit('spin'),
+                stepBet: (dir) => {
+                    const next = stepBet(shell.state, dir);
+                    if (next === shell.state.bet)
+                        return;
+                    shell.state.bet = next;
+                    shell.emit('betChange', next);
+                    shell.render();
+                },
+                toggleAutoplay: () => {
+                    if (shell.state.autoplay.active) {
+                        shell.state.autoplay = { active: false, remaining: 0 };
+                        shell.emit('autoplayStop');
+                        shell.render();
+                    }
+                    else {
+                        shell.openAutoplayPicker();
+                    }
+                },
+                cycleTurbo: () => {
+                    const next = nextTurbo(shell.state.turbo, shell.config.features.turbo);
+                    shell.state.turbo = next;
+                    shell.emit('turboChange', next);
+                    shell.render();
+                },
+                openBuyBonus: () => shell.openBuyBonus(),
+                openInfo: () => shell.openInfo(),
+                openMenu: () => shell.openMenu(),
+                toggleMute: () => shell.setSound(!shell.soundOn),
+                closeLayer: () => shell.closeModal(),
+            };
+            this.kbd = new KeyboardController(host);
+            this.kbd.attach();
             // 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();
         // re-fit once the bundled webfont swaps in (text metrics change → row width changes)
@@ -2928,46 +4509,32 @@ class GameShell extends EventEmitter {
             zoomBar(s * (bar.clientWidth / bar.scrollWidth));
         }
     }
-    /** Spacebar starts a spin — same path as the spin disc. Ignored when `features.spacebar` is
-     *  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;
-        if (this.config.features.spacebar === false)
-            return; // shortcut disabled (e.g. jurisdiction)
-        const t = e.target;
-        if (t && (t.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName)))
-            return;
-        // Space is ours now — swallow the browser default before any no-op bail. Otherwise the
-        // native "Space activates the focused button" still fires and re-clicks whichever shell
-        // <button> (menu/buy/auto) opened the overlay, tearing down + rebuilding the modal: a
-        // visible flicker. (Also stops the page from scrolling on Space.)
-        e.preventDefault();
-        if (this.modalHost.childElementCount > 0)
-            return; // an overlay/modal is open
-        if (this.state.mode !== 'base' || this.state.busy || this.state.autoplay.active)
-            return;
-        this.emit('spin');
-    };
     setLayout(layout) {
         if (layout === this.layout)
             return;
         this.layout = layout;
         this.render();
     }
-    /** Resolve a built-in shell string. English is the source; with `isSocial` it is run through
-     *  the social-casino word-swap. Game-supplied strings should NOT be passed through this. */
-    t(text) { return this.config.isSocial ? socialize(text) : text; }
-    /** Toggle the social vocabulary at runtime (re-renders the bar; reopen overlays to refresh them). */
-    setSocial(isSocial) { this.config.isSocial = isSocial; this.render(); }
+    /** Resolve a built-in shell string through the i18n resolver (translation + optional socialize). */
+    t(text) { return this.i18n.t(text); }
+    /** Toggle the social vocabulary at runtime (rebuilds resolver, re-renders bar). */
+    setSocial(isSocial) {
+        this.config.isSocial = isSocial;
+        this.i18n = createI18n({ language: this.config.language, isSocial });
+        this.render();
+    }
+    /** Swap the active language at runtime (rebuilds resolver, re-renders bar). */
+    setLanguage(lang) {
+        this.config.language = lang;
+        this.i18n = createI18n({ language: lang, isSocial: this.config.isSocial });
+        this.render();
+    }
     /** Recolour the shell at runtime (e.g. switch dark/light scheme). */
     setTheme(theme) {
         this.config.theme = theme;
@@ -3008,7 +4575,7 @@ class GameShell extends EventEmitter {
         this.state.mode = mode;
         this.render();
     }
-    setBusy(busy) { this.state.busy = busy; this.render(); }
+    setBusy(busy) { this.state.busy = busy; this.render(); this.kbd?.notifyBusyChanged(busy); }
     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
@@ -3016,7 +4583,7 @@ class GameShell extends EventEmitter {
     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) {
+    showModal(el, onKey) {
         // The control that opened this overlay (menu/buy/auto) keeps DOM focus. Drop it, or a
         // stray Space/Enter would natively re-activate that <button> and rebuild the modal — a
         // visible flicker. Only relinquish focus we own (a shell control), never the host page's.
@@ -3025,6 +4592,7 @@ class GameShell extends EventEmitter {
             active.blur();
         this.modalHost.innerHTML = '';
         this.modalHost.appendChild(el);
+        this.modalOnKey = onKey;
         this.fitModals();
     }
     /** Uniformly scale every open centred card modal (`.ge-sheet`) down so it fits a short/narrow
@@ -3077,22 +4645,31 @@ class GameShell extends EventEmitter {
     }
     openMenu() { this.emit('menuOpen'); this.openSettings(); }
     openSettings() { this.emit('settingsOpen'); this.showModal(openSettingsModal(this)); }
-    openInfo() { this.emit('infoOpen'); this.showModal(openGameInfoModal(this)); }
+    openInfo() { this.emit('infoOpen'); const { root, onKey } = openGameInfoModal(this); this.showModal(root, onKey); }
     openBuyBonus() {
         if (this.config.onBonusBuy) {
             this.config.onBonusBuy();
             return;
         } // game handles it (own UI)
-        const overlay = openBuyBonusOverlay(this);
-        if (overlay)
-            this.showModal(overlay);
+        const result = openBuyBonusOverlay(this);
+        if (result)
+            this.showModal(result.root, result.onKey);
     }
     /** 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)); }
+    openModal(opts) { this.showModal(buildModal(opts), opts.onKey); }
     /** 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 = ''; }
+    closeModal() { this.modalOnKey = undefined; this.soundRefresh = null; this.modalHost.innerHTML = ''; }
+    /** Flip the shared sound state, notify the game (`settingChange({ key: 'sound' })`), and live-update
+     *  the Settings speaker icon if that modal is open. Used by both the Settings toggle and Shift+M. */
+    setSound(on) {
+        this.soundOn = on;
+        this.emit('settingChange', { key: 'sound', value: on });
+        this.soundRefresh?.(on);
+    }
+    /** The Settings modal registers an icon-updater while open (cleared on close). */
+    setSoundRefresh(fn) { this.soundRefresh = fn; }
     /** Open the non-dismissable replay summary modal (START REPLAY → onReplay → reopen). */
     openReplay(opts) {
         if (this.destroyed)
@@ -3100,19 +4677,18 @@ class GameShell extends EventEmitter {
         this.showModal(buildReplayModal(this, opts));
     }
     /** Bet picker — list of available bets with an accent Confirm. */
-    openBetPicker() { this.showModal(openBetModal(this)); }
+    openBetPicker() { const { root, onKey } = openBetModal(this); this.showModal(root, onKey); }
     /** Autoplay picker — spin-count list; Confirm starts autoplay. */
-    openAutoplayPicker() { this.showModal(openAutoplayModal(this)); }
+    openAutoplayPicker() { const { root, onKey } = openAutoplayModal(this); this.showModal(root, onKey); }
     destroy() {
         if (this.destroyed)
             return Promise.resolve();
         this.destroyed = true;
         this.ro?.disconnect();
         this.ro = null;
-        if (this.keysBound) {
-            document.removeEventListener('keydown', this.handleKeyDown);
+        if (typeof document !== 'undefined') {
+            this.kbd?.detach();
             document.removeEventListener('pointerdown', this.pullFocus, true);
-            this.keysBound = false;
         }
         this.cancelMoneyAnims();
         this.removeAllListeners();
@@ -3159,7 +4735,7 @@ function removeGameShell() {
 exports.DevBridge = DevBridge;
 exports.EventEmitter = EventEmitter;
 exports.GameShell = GameShell;
-exports.LOADER_BAR_MAX_WIDTH = LOADER_BAR_MAX_WIDTH;
+exports.LOADER_BAR_MAX_WIDTH = LOADER_BAR_MAX_WIDTH$1;
 exports.PlatformSession = PlatformSession;
 exports.buildLogoSVG = buildLogoSVG;
 exports.createCSSPreloader = createCSSPreloader;