@energy8platform/platform-core 0.25.4 → 0.26.1

package/src/shell/shell.css.ts

@@ -151,6 +151,21 @@ export 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;
@@ -245,20 +260,26 @@ export const SHELL_CSS = SHELL_FONT_CSS + `
 #${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-ov-body { max-width:none; padding:clamp(6px,2.5cqh,16px) clamp(12px,3vw,28px); }
 #${SHELL_ROOT_ID} .ge-bb-grid { display:flex; gap:14px; justify-content:safe center; overflow-x:auto; overflow-y:hidden; padding-bottom:6px;
   scroll-snap-type:x proximity; -webkit-overflow-scrolling:touch; }
-/* the one knob that scales the whole card — cqh measures the overlay (popout frame), not the
-   browser window, so cards shrink to fit the real container height. The floor is deliberately tiny:
-   on a 400×225 popout the whole card (incl. the CTA) only fits below ~5px, and a fully visible,
-   single-axis-scrolling card beats a bigger one whose button is clipped or needs a 2nd scrollbar. */
+/* the one knob that scales the whole card (its whole layout is em-relative). It is the SMALLER of two
+   fits, so the card is always fully visible:
+     • 3.4cqh — height: the card stays inside the band between the header and the bet footer (cqh
+       measures the overlay popout frame, not the browser window);
+     • 84cqw / (N*18) — width: the N cards (each 18em) fit the frame width side-by-side instead of
+       overflowing into an X-scroll. --ge-bb-n is the live card count, set in BuyBonus.ts.
+   Floor is deliberately tiny: on a 400×225 popout a fully visible card beats a bigger clipped one. */
 #${SHELL_ROOT_ID} .ge-bb-grid .ge-bonus-card { flex:0 0 18em; scroll-snap-align:start;
-  font-size:clamp(4px, 3.4cqh, 12px); }
-/* mobile: vertical stack at a fixed, readable size — scroll the list, don't shrink the cards */
+  font-size:clamp(4px, min(3.4cqh, calc(84cqw / (var(--ge-bb-n,3) * 18))), 12px); }
+/* mobile: vertical stack at a fixed, readable size — scroll the list; only shrink if the card would
+   be wider than the frame (very narrow viewport), so it never overflows horizontally. */
 #${SHELL_ROOT_ID}.ge-mobile .ge-bb-grid { display:flex; flex-direction:column; gap:14px; overflow:visible; }
-#${SHELL_ROOT_ID}.ge-mobile .ge-bb-grid .ge-bonus-card { flex:0 0 auto; font-size:12px; }
+#${SHELL_ROOT_ID}.ge-mobile .ge-bb-grid .ge-bonus-card { flex:0 0 auto; font-size:min(12px, calc(92cqw / 18)); }
 #${SHELL_ROOT_ID} .ge-bonus-card { display:flex; flex-direction:column; border-radius:1.4em; overflow:hidden;
   background:var(--shell-plaque-glass); border:1px solid var(--shell-plaque-line); color:#fff; text-align:center;
   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; }
@@ -314,13 +335,15 @@ export const SHELL_CSS = SHELL_FONT_CSS + `
 #${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-ov-spacer { width:clamp(24px,7cqh,32px); }
 #${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-ov-nav { width:clamp(24px,7cqh,32px); height:clamp(24px,7cqh,32px);
   font-size:clamp(14px,4cqh,18px); border-radius:clamp(7px,2cqh,9px); }
-#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betbar { padding:clamp(2px,.9cqh,4px); }
-#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betpill { padding:clamp(2px,.67cqh,3px) clamp(4px,1.1cqh,5px); }
-#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betstep { width:clamp(24px,7cqh,32px); height:clamp(24px,7cqh,32px);
-  font-size:clamp(15px,4.4cqh,20px); }
-#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betval { min-width:clamp(62px,17.5cqh,80px); }
-#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betval b { font-size:clamp(11px,3.1cqh,14px); }
-#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betval span { font-size:clamp(6px,1.55cqh,7px); }
+/* the bet pill read too large next to the shrunk cards — size it ~0.8× across the board (the floors
+   stay readable; the maxima are what dominate on Popout L / wide frames). */
+#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betbar { padding:clamp(2px,.75cqh,3px); }
+#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betpill { padding:clamp(2px,.55cqh,3px) clamp(3px,.9cqh,4px); }
+#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betstep { width:clamp(20px,5.7cqh,26px); height:clamp(20px,5.7cqh,26px);
+  font-size:clamp(12px,3.5cqh,16px); }
+#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betval { min-width:clamp(50px,14cqh,66px); }
+#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betval b { font-size:clamp(9px,2.5cqh,11px); }
+#${SHELL_ROOT_ID} [data-ge="buybonus-overlay"] .ge-bb-betval span { font-size:clamp(5px,1.25cqh,6px); }
 
 /* ═══ base/wide plaque bar — grouped dark + glass panels (reference-style) ═══ */
 #${SHELL_ROOT_ID} .ge-zone-plaques { gap:0; }                     /* panels connect; buttons overlap */

package/src/shell/types.ts

@@ -117,6 +117,7 @@ export interface GameMode {
 export type GameInfoSection =
   | { type: 'modes'; title?: string; order?: number; modes: GameMode[] }
   | { type: 'controls'; title?: string; order?: number }
+  | { type: 'hotkeys'; title?: string; order?: number }
   | { type: 'paytable'; title?: string; order?: number; rows: PaytableRow[] }
   | WinSection
   | { type: 'custom'; title?: string; order?: number; node?: HTMLElement; html?: string };
@@ -135,6 +136,9 @@ export interface AutoplayConfig {
 
 export interface ShellFeatures {
   turbo: 0 | 1 | 2 | 3;
+  /** Master keyboard-shortcut switch. Defaults to `true`; set `false` to disable ALL hotkeys
+   *  (overrides `spacebar` and any future hotkey). */
+  hotkeys?: boolean;
   /** Spacebar starts a spin in base mode. Defaults to `true`; set `false` to disable the
    *  keyboard shortcut (e.g. jurisdictions that forbid quick-spin keys). */
   spacebar?: boolean;
@@ -187,6 +191,10 @@ export interface ModalOptions {
   actions?: ModalAction[];
   /** Backdrop blur in px (defaults to the shell's standard blur). */
   blurLevel?: number;
+  /** Optional keyboard handler — called by the shell keyboard controller while this modal is
+   *  open. Return true to consume the key (prevents bar actions + Escape close); false to let
+   *  the controller handle it (Escape → closeModal). */
+  onKey?: (e: KeyboardEvent) => boolean;
 }
 
 export interface ShellConfig {

package/src/shell/version.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED by scripts/gen-version.mjs — do not edit. Mirrors package.json "version".
 /** The @energy8platform/platform-core package version, stamped at build time. */
-export const PACKAGE_VERSION = '0.25.4';
+export const PACKAGE_VERSION = '0.26.1';

package/src/types.ts

@@ -3,6 +3,8 @@
 // Phaser/Three/custom-engine consumers import these from
 // `@energy8platform/platform-core` instead of pulling in game-engine.
 
+import type { PreloaderVariantName } from './loading/variants';
+
 // SDK types
 export type {
   InitData,
@@ -43,6 +45,12 @@ export interface AssetManifest {
 // engine-specific loading scenes (in @energy8platform/game-engine etc.).
 
 export interface LoadingScreenConfig {
+  /**
+   * Which visual identity the CSS preloader renders. Defaults to `'energy8'`;
+   * an unknown value falls back to the default. Ignored when `cssPreloaderHTML`
+   * is set (custom HTML bypasses the variant).
+   */
+  preloaderVariant?: PreloaderVariantName;
   /** Background color (hex number or CSS string) */
   backgroundColor?: number | string;
   /** Background gradient (CSS string applied to the CSS preloader) */