@energy8platform/game-engine 0.22.0 → 0.24.0

package/dist/host.d.ts

@@ -1,12 +1,13 @@
 import { Container, ApplicationOptions, Application, Texture } from 'pixi.js';
 import { GameModel } from '@energy8platform/platform-core/game-spec';
 import { LoadingScreenConfig, AssetManifest, PlatformSession } from '@energy8platform/platform-core';
-import { CurrencyConfig, GameInfoContent, BonusOption, ShellFeatures, ShellMode, PixiShellConfig, PixiGameShell } from '@energy8platform/pixi-shell';
-import * as _energy8platform_platform_core_shell from '@energy8platform/platform-core/shell';
-import { Lang } from '@energy8platform/platform-core/shell';
-export { socialize } from '@energy8platform/platform-core/shell';
+import { CurrencyConfig, GameInfoContent, BonusOption, ShellFeatures, ShellMode, PixiShellConfig, Shell } from '@energy8platform/shell/pixi';
+export { OverlayHandle, OverlayRequest, PixiRenderer, PixiShellConfig, ResolvedShellConfig, SafeArea, Shell, ShellActions, ShellHost, ShellLayoutMode, ShellRenderer, ShellSurface, ShellTokens, createPixiShell, createShell } from '@energy8platform/shell/pixi';
+import * as _energy8platform_shell_html from '@energy8platform/shell/html';
 import { BookAdapter, AdapterModule, StakeBridge } from '@energy8platform/stake-bridge';
 import { CasinoGameSDK, InitData, GameConfigData, SessionData } from '@energy8platform/game-sdk';
+import { Lang } from '@energy8platform/shell';
+export { socialize } from '@energy8platform/shell';
 import { SlotSpinResultBase, SlotResultNormalizer } from '@energy8platform/platform-core/slot-result';
 
 declare enum ScaleMode {
@@ -64,7 +65,7 @@ interface GameApplicationConfig {
     /** Enable debug overlay (FPS, draw calls) */
     debug?: boolean;
     /** When set, GameApplication mounts the branded game shell after the SDK handshake. */
-    shell?: _energy8platform_platform_core_shell.ShellConfig | false;
+    shell?: _energy8platform_shell_html.ShellConfig | false;
 }
 interface SceneConstructor {
     new (): IScene;
@@ -705,7 +706,7 @@ declare class GameApplication extends EventEmitter<GameEngineEvents> {
     /** Platform session (SDK + optional DevBridge). null until start() runs. */
     platformSession: PlatformSession | null;
     /** Branded game shell (only when config.shell is set). */
-    shell?: _energy8platform_platform_core_shell.GameShell;
+    shell?: _energy8platform_shell_html.GameShell;
     /** Configuration */
     readonly config: GameApplicationConfig;
     private _running;
@@ -814,7 +815,9 @@ interface JurisdictionRestrictions {
 declare function stakeForAction(model: GameModel, action: string, bet: number): number;
 /** Pure: assemble the shell config (sans mount target) from the model + runtime context
  *  (currency/balance/language/mode). The host adds `app` at the call site. */
-declare function buildShellConfig(opts: SlotShellOptions, model: GameModel, runtime: ShellRuntime): Omit<PixiShellConfig, 'app' | 'parent'>;
+declare function buildShellConfig(opts: SlotShellOptions, model: GameModel, runtime: ShellRuntime): Omit<PixiShellConfig, 'app' | 'parent' | 'gameInfo'> & {
+    gameInfo: GameInfoContent;
+};
 
 interface StakeIntegration {
     /** The game's BookAdapter (or its module). modeMap + gameId come from the model. */
@@ -865,15 +868,25 @@ interface CreateSlotGameOptions<T extends SlotSpinResultBase = SlotSpinResultBas
     dev?: boolean;
     stake?: StakeIntegration;
     shell?: SlotShellOptions;
+    /** Override how the control-bar shell is built. The host resolves the full shell config (theme,
+     *  features, gameInfo, currency, balance) and the Pixi mount (`app`/`parent`) and hands it to this
+     *  factory; return any `Shell` — e.g. `createShell({ renderer: new MyRenderer(...), ...config })`
+     *  to plug a custom renderer while the shell core still drives bet/balance/overlays. A custom
+     *  renderer can ignore `app`/`parent` and mount elsewhere (a DOM overlay, another canvas).
+     *  Default: the built-in Pixi shell (`createPixiShell`). */
+    shellFactory?: ShellFactory;
     /** Double-tap on the play area to skip the current spin animation. Default `true`. Set `false`
      *  to disable the gesture (e.g. games where a tap means something else). */
     skipGesture?: boolean;
     onFatalError?: (message: string) => void;
 }
+/** Builds the shell the host drives. Receives the fully-resolved Pixi shell config (a custom
+ *  renderer may ignore the `app`/`parent` mount fields). Must return a `Shell`. */
+type ShellFactory = (config: PixiShellConfig) => Shell;
 interface SlotGameHandle {
     game: GameApplication;
     stakeBridge: StakeBridge | null;
-    shell: PixiGameShell | null;
+    shell: Shell | null;
 }
 
 /**
@@ -1001,4 +1014,4 @@ interface SlotSceneController<T extends SlotSpinResultBase = SlotSpinResultBase>
 }
 
 export { buildShellConfig, createSlotGame, resolveReplayBonusId, resolveStartScene, stakeForAction };
-export type { AutoplaySceneState, CreateSlotGameOptions, OverlayShowOptions, RenderContext, SceneApi, SceneAudio, SceneNavData, SceneOverlay, SceneRegistration, SceneShell, SlotGameHandle, SlotSceneController, SlotShellOptions, StakeIntegration };
+export type { AutoplaySceneState, CreateSlotGameOptions, OverlayShowOptions, RenderContext, SceneApi, SceneAudio, SceneNavData, SceneOverlay, SceneRegistration, SceneShell, ShellFactory, SlotGameHandle, SlotSceneController, SlotShellOptions, StakeIntegration };

package/dist/host.esm.js

@@ -1,8 +1,9 @@
 import { Ticker, Assets, Container, Text, Application, Graphics, TextureSource } from 'pixi.js';
 import { createPlatformSession } from '@energy8platform/platform-core';
 import { waitCSSPreloaderTap, removeCSSPreloader, setCSSPreloaderProgress, createCSSPreloader } from '@energy8platform/platform-core/loading';
-import { socialize, createI18n } from '@energy8platform/platform-core/shell';
-export { socialize } from '@energy8platform/platform-core/shell';
+export { PixiRenderer, createPixiShell, createShell } from '@energy8platform/shell/pixi';
+import { socialize, createI18n } from '@energy8platform/shell';
+export { socialize } from '@energy8platform/shell';
 
 // ─── Scale Modes ───────────────────────────────────────────
 var ScaleMode;
@@ -1886,7 +1887,7 @@ class GameApplication extends EventEmitter {
             await this.initSDK();
             // 4b. Mount the branded game shell after the SDK handshake (optional)
             if (this.config.shell) {
-                const { createGameShell } = await import('@energy8platform/platform-core/shell');
+                const { createGameShell } = await import('@energy8platform/shell/html');
                 this.shell = createGameShell(this.config.shell);
             }
             // 5. Merge design dimensions from SDK config
@@ -1921,7 +1922,7 @@ class GameApplication extends EventEmitter {
         this._destroyed = true;
         this._running = false;
         if (this.shell) {
-            const { removeGameShell } = await import('@energy8platform/platform-core/shell');
+            const { removeGameShell } = await import('@energy8platform/shell/html');
             await removeGameShell();
             this.shell = undefined;
         }
@@ -2368,7 +2369,7 @@ async function createSlotGame(opts) {
         ack: (raw) => game.platformSession.playAck(raw),
     });
     if (opts.shell) {
-        const { createPixiShell } = await import('@energy8platform/pixi-shell');
+        const { createPixiShell } = await import('@energy8platform/shell/pixi');
         const { buildShellConfig } = await Promise.resolve().then(function () { return shellConfig; });
         const { resolveReplayBonusId } = await Promise.resolve().then(function () { return replay; });
         const ps = game.platformSession;
@@ -2418,7 +2419,10 @@ async function createSlotGame(opts) {
         // pixi-shell mounts its root onto the engine's unscaled, screen-space UI layer (above the
         // scaled world/scene root) so the control bar fills the real screen, not the letterboxed game.
         // The host adds the mount target (`app`) + parent; buildShellConfig produces everything else.
-        shell = createPixiShell({ ...buildShellConfig(opts.shell, opts.model, runtime), app: game.app, parent: game.uiLayer });
+        const pixiShellCfg = { ...buildShellConfig(opts.shell, opts.model, runtime), app: game.app, parent: game.uiLayer };
+        // The game may swap in its own shell (a custom renderer over the same core) via shellFactory;
+        // default is the built-in Pixi shell. The host drives whichever it gets through the Shell contract.
+        shell = (opts.shellFactory ?? createPixiShell)(pixiShellCfg);
         // Scope the bar to the slot scene: show only when a SlotSceneController scene is current
         // (hidden over the intro / non-slot scenes). Applies in BOTH base and replay modes.
         shell.setVisible(!!gameScene());
@@ -2770,8 +2774,9 @@ async function createSlotGame(opts) {
 }
 
 // packages/game-engine/src/host/shellConfig.ts
-// `socialize` / `createI18n` are runtime helpers sourced from platform-core/shell;
-// pixi-shell re-exports only types so we import directly from platform-core.
+// `socialize` / `createI18n` / `Lang` are renderer-agnostic helpers from the shell core
+// (@energy8platform/shell). Renderer-agnostic types (GameInfoSection/Content, PaytableRow,
+// GameMode) and the pixi-specific surface types come from the @energy8platform/shell/pixi entry.
 /**
  * Apply jurisdiction restrictions over the resolved shell features, in place. A restriction ALWAYS
  * wins over the author's intent (a forbidden control must stay off even if the game enabled it).
@@ -2971,13 +2976,19 @@ function sectionKey(s) {
 function mergeGameInfo(derived, override) {
     if (!override)
         return derived;
+    // `GameInfoContent.sections` is typed with the core GameInfoSection (node?: unknown) because
+    // shell/pixi re-exports GameInfoContent unchanged from core. Host-built sections never set `node`,
+    // so they are structurally compatible with pixi's GameInfoSection (node?: Container). Cast once
+    // here so the rest of the function works against the pixi-widened type.
+    const derivedSections = (derived.sections ?? []);
+    const overrideSections = (override.sections ?? []);
     const authorByKey = new Map();
-    for (const s of override.sections ?? [])
+    for (const s of overrideSections)
         authorByKey.set(sectionKey(s), s);
     const out = [];
     const used = new Set();
     // Keep derived order; swap in the author's version where identities collide.
-    for (const s of derived.sections ?? []) {
+    for (const s of derivedSections) {
         const k = sectionKey(s);
         const replacement = authorByKey.get(k);
         if (replacement) {
@@ -2988,7 +2999,7 @@ function mergeGameInfo(derived, override) {
             out.push(s);
     }
     // Append author sections whose identity wasn't in the derived set, in author order.
-    for (const s of override.sections ?? []) {
+    for (const s of overrideSections) {
         const k = sectionKey(s);
         if (!used.has(k)) {
             out.push(s);
@@ -3053,6 +3064,8 @@ function buildShellConfig(opts, model, runtime) {
     const authored = typeof opts.gameInfo === 'function' ? opts.gameInfo(t) : opts.gameInfo;
     // Pass t() through to spec-derived sections so symbol names, mode titles, and descriptions are
     // pre-translated before they reach the shell renderer.
+    // Cast to { sections?: GameInfoSection[] } (pixi-widened) so downstream map/filter calls work
+    // against the pixi section union. Host-derived sections never set `node`, so the widening is safe.
     let gameInfo = mergeGameInfo(defaultGameInfo(model, runtime, t), authored);
     // The DISCLAIMER is required legal copy and must be shown VERBATIM — never socialized (its
     // wording is mandated, and word-swaps like "bet → play" would corrupt the legal text).