@energy8platform/platform-core 0.25.3 → 0.26.0

package/src/shell/shell.css.ts

@@ -64,11 +64,11 @@ export const SHELL_CSS = SHELL_FONT_CSS + `
 
 /* host = bottom-anchored flex column: [win pill (on overflow)] above [the bar] */
 #${SHELL_ROOT_ID} .ge-shell-barhost { position:absolute; left:0; right:0; bottom:0; pointer-events:none;
-  display:flex; flex-direction:column; align-items:center; justify-content:flex-end; gap:8px;
+  display:flex; flex-direction:column; align-items:center; justify-content:flex-end; gap:4px;
   transform-origin:bottom center; }
 /* bottom bar: transparent, two zones (wide default) */
 #${SHELL_ROOT_ID} .ge-shell-bottom { width:100%; box-sizing:border-box; pointer-events:none;
-  display:flex; align-items:center; justify-content:space-between; padding:0 18px 14px; gap:14px; }
+  display:flex; align-items:center; justify-content:space-between; padding:0 18px 6px; gap:14px; }
 #${SHELL_ROOT_ID} .ge-zone { display:flex; align-items:center; gap:14px; pointer-events:none; }
 #${SHELL_ROOT_ID} .ge-zone > * { pointer-events:auto; }
 #${SHELL_ROOT_ID} .ge-betstep { display:flex; flex-direction:column; gap:2px; }
@@ -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;
@@ -259,6 +274,8 @@ export 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; }
@@ -337,7 +354,7 @@ export const SHELL_CSS = SHELL_FONT_CSS + `
 #${SHELL_ROOT_ID} .ge-pl .ge-iconbtn { color:#fff; }
 /* LEFT: [menu] ⊐ coin ⊏ [balance] — coin overlaps both; balance fixed-wide so it doesn't jiggle */
 #${SHELL_ROOT_ID} .ge-pl-menu { border-radius:16px 0 0 16px; padding-right:20px; }
-#${SHELL_ROOT_ID} .ge-pl-bal { border-radius:0 16px 16px 0; padding-left:24px; min-width:240px; }
+#${SHELL_ROOT_ID} .ge-pl-bal { border-radius:0 16px 16px 0; padding-left:24px; min-width:200px; }
 #${SHELL_ROOT_ID} .ge-zone-plaques .ge-shell-buybonus { margin:0 -16px; position:relative; z-index:3; }
 /* RIGHT: [bet] · |divider| · [auto · SPIN · turbo] */
 #${SHELL_ROOT_ID} .ge-pl-bet { border-radius:16px 0 0 16px; justify-content:space-between;

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.3';
+export const PACKAGE_VERSION = '0.26.0';

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) */