@energy8platform/game-engine 0.23.0 → 0.25.0

package/dist/harness.d.ts

@@ -0,0 +1,25 @@
+import { HarnessPlugin } from '@energy8platform/harness';
+
+/**
+ * `@energy8platform/game-engine/harness` — node-only entry.
+ *
+ * Contributes the reel-config **panel** to `@energy8platform/harness`: a docked
+ * right sidebar that tunes a running game's ReelSystem live. Pair it with
+ * `mountReelDevBridge` (from `@energy8platform/game-engine/devtools`) in the game.
+ *
+ * Usage in a game's vite.config:
+ *   import { createHarness } from '@energy8platform/harness';
+ *   import { reelDevtoolsPlugin } from '@energy8platform/game-engine/harness';
+ *   createHarness({ plugins: [ reelDevtoolsPlugin() ] });
+ *
+ * Node-only: resolves the built, self-contained panel-client ESM the harness serves.
+ */
+
+interface ReelDevtoolsPluginOptions {
+    /** Sidebar header / tab label. Default 'Reels'. */
+    title?: string;
+}
+declare function reelDevtoolsPlugin(opts?: ReelDevtoolsPluginOptions): HarnessPlugin;
+
+export { reelDevtoolsPlugin };
+export type { ReelDevtoolsPluginOptions };

package/dist/harness.esm.js

@@ -0,0 +1,30 @@
+import { fileURLToPath } from 'node:url';
+
+/**
+ * `@energy8platform/game-engine/harness` — node-only entry.
+ *
+ * Contributes the reel-config **panel** to `@energy8platform/harness`: a docked
+ * right sidebar that tunes a running game's ReelSystem live. Pair it with
+ * `mountReelDevBridge` (from `@energy8platform/game-engine/devtools`) in the game.
+ *
+ * Usage in a game's vite.config:
+ *   import { createHarness } from '@energy8platform/harness';
+ *   import { reelDevtoolsPlugin } from '@energy8platform/game-engine/harness';
+ *   createHarness({ plugins: [ reelDevtoolsPlugin() ] });
+ *
+ * Node-only: resolves the built, self-contained panel-client ESM the harness serves.
+ */
+function reelDevtoolsPlugin(opts = {}) {
+    // The self-contained panel client sits next to this module in dist/.
+    const clientEntry = fileURLToPath(new URL('./reel-panel-client.esm.js', import.meta.url));
+    const panel = {
+        id: 'reels',
+        title: opts.title ?? 'Reels',
+        placement: 'sidebar',
+        clientEntry,
+    };
+    return { panel };
+}
+
+export { reelDevtoolsPlugin };
+//# sourceMappingURL=harness.esm.js.map

package/dist/harness.esm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"harness.esm.js","sources":["../src/harness/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAAA;;;;;;;;;;;;;AAaG;AAWG,SAAU,kBAAkB,CAAC,IAAA,GAAkC,EAAE,EAAA;;AAErE,IAAA,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,4BAA4B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzF,IAAA,MAAM,KAAK,GAAiB;AAC1B,QAAA,EAAE,EAAE,OAAO;AACX,QAAA,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,OAAO;AAC5B,QAAA,SAAS,EAAE,SAAS;QACpB,WAAW;KACZ;IACD,OAAO,EAAE,KAAK,EAAE;AAClB;;;;"}

package/dist/host.cjs.js

@@ -3,7 +3,8 @@
 var pixi_js = require('pixi.js');
 var platformCore = require('@energy8platform/platform-core');
 var loading = require('@energy8platform/platform-core/loading');
-var shell = require('@energy8platform/platform-core/shell');
+var pixi = require('@energy8platform/shell/pixi');
+var shell = require('@energy8platform/shell');
 
 // ─── Scale Modes ───────────────────────────────────────────
 var ScaleMode;
@@ -1887,7 +1888,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
@@ -1922,7 +1923,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;
         }
@@ -2369,7 +2370,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;
@@ -2419,7 +2420,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());
@@ -2771,8 +2775,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).
@@ -2972,13 +2977,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) {
@@ -2989,7 +3000,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);
@@ -3054,6 +3065,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).
@@ -3499,6 +3512,18 @@ var autoplay = /*#__PURE__*/Object.freeze({
     createAutoplayLoop: createAutoplayLoop
 });
 
+Object.defineProperty(exports, "PixiRenderer", {
+    enumerable: true,
+    get: function () { return pixi.PixiRenderer; }
+});
+Object.defineProperty(exports, "createPixiShell", {
+    enumerable: true,
+    get: function () { return pixi.createPixiShell; }
+});
+Object.defineProperty(exports, "createShell", {
+    enumerable: true,
+    get: function () { return pixi.createShell; }
+});
 Object.defineProperty(exports, "socialize", {
     enumerable: true,
     get: function () { return shell.socialize; }