@energy8platform/shell 0.6.3 → 0.6.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@energy8platform/shell",
-  "version": "0.6.3",
+  "version": "0.6.5",
   "description": "Energy8 branded game shell — one logic core, pluggable html/pixi renderers behind a stable contract.",
   "type": "module",
   "main": "./dist/index.cjs.js",

package/src/core/i18n.ts

@@ -26,11 +26,18 @@ export interface I18nOptions { language: string; isSocial?: boolean; messages?:
 export interface I18n { readonly lang: Lang; t(src: string): string; }
 
 export function createI18n(opts: I18nOptions): I18n {
-  // Social is the `en-social` pseudo-locale: it rewrites the English source. Non-English locales are
-  // authored social-safe already, so `socialize` only runs on the English source string.
+  // Social is the `en-social` pseudo-locale: it rewrites the English source into social-safe
+  // vocabulary. The replacement dictionary only exists for English, so social mode FORCES English —
+  // the requested `language` is ignored, matching the `isSocial` contract ("…derived from English…
+  // regardless of `language`"). Rendering a non-English locale in social mode would leak untranslated
+  // restricted terms, so we never do it.
+  if (opts.isSocial) {
+    const t = (src: string): string => socialize(src);
+    return { lang: 'en', t };
+  }
   const lang = normalizeLang(opts.language);
   const t = (src: string): string => {
-    if (lang === 'en') return opts.isSocial ? socialize(src) : src;
+    if (lang === 'en') return src;
     return opts.messages?.[lang]?.[src] ?? LOCALES[lang]?.[src] ?? src;
   };
   return { lang, t };

package/src/core/renderer.ts

@@ -86,6 +86,11 @@ export interface ShellHost {
   setVolumeRefresh(fn: ((key: VolumeKey, value: number) => void) | null): void;
   /** Logic-bearing actions invoked by renderer controls. */
   readonly actions: ShellActions;
+  /** Re-show the replay summary modal through the controller (keeps its OverlayHandle in sync).
+   *  Used as the modal's own reopen callback after START REPLAY, so a renderer never re-pushes a
+   *  replay modal behind the controller's back (which would strand `overlay` and dead-end the
+   *  next close). */
+  openReplay(opts: ReplayModalOptions): void;
 }
 
 /** Every state-changing thing a control can do. Each runs logic in the controller, emits the

package/src/core/version.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED by scripts/gen-version.mjs — do not edit. Mirrors package.json "version".
 /** The @energy8platform/shell package version, stamped into the game-info footer. */
-export const PACKAGE_VERSION = '0.6.3';
+export const PACKAGE_VERSION = '0.6.5';

package/src/ui/html/HtmlRenderer.ts

@@ -162,7 +162,9 @@ export class HtmlRenderer implements ShellRenderer {
       }
       case 'replay': {
         const opts = req.opts;
-        const reopen = (): void => { this.openReplayInternal(opts); };
+        // Reopen through the controller (not a renderer-direct re-push) so its OverlayHandle stays
+        // in sync — otherwise a reopened replay modal is untracked and the next close no-ops.
+        const reopen = (): void => { this.host.openReplay(opts); };
         const root = buildReplayModal(this.host, opts, reopen);
         return { root };
       }
@@ -173,14 +175,6 @@ export class HtmlRenderer implements ShellRenderer {
     }
   }
 
-  /** Opens a replay modal and shows it — used as the reopen callback after START REPLAY. */
-  private openReplayInternal(opts: import('@/core/types').ReplayModalOptions): void {
-    if (this.destroyed) return;
-    const reopen = (): void => { this.openReplayInternal(opts); };
-    const root = buildReplayModal(this.host, opts, reopen);
-    this.showModal(root);
-  }
-
   private showModal(el: HTMLElement, onKey?: (e: KeyboardEvent) => boolean): void {
     // Drop focus from any open shell control so a stray Space/Enter doesn't re-activate it
     const active = document.activeElement as HTMLElement | null;

package/src/ui/pixi/PixiRenderer.ts

@@ -20,7 +20,6 @@ import { openBuyBonus } from './components/BuyBonus';
 import { openBetPicker, openAutoplayPicker } from './components/pickers';
 import { buildModal } from './components/Modal';
 import { buildReplayModal } from './components/ReplayModal';
-import type { ReplayModalOptions } from '@/core/types';
 
 export interface PixiRendererOptions {
   app: Application;
@@ -147,7 +146,7 @@ export class PixiRenderer implements ShellRenderer {
         layer = openAutoplayPicker(this.ctx);
         break;
       case 'replay':
-        layer = buildReplayModal(this.ctx, req.opts, () => this.openReplayInternal(req.opts));
+        layer = buildReplayModal(this.ctx, req.opts, () => this.host.openReplay(req.opts));
         break;
       case 'modal':
         layer = buildModal(this.ctx, req.opts);
@@ -226,15 +225,6 @@ export class PixiRenderer implements ShellRenderer {
     this.currentLayer?.fit?.();
   }
 
-  /** Replay's reopen path: a replay modal can rebuild itself (e.g. after a replay completes). It is
-   *  routed back through the controller-equivalent open flow so the layer stack + backdrop stay in
-   *  sync — mirrors PixiGameShell.openReplay (push a fresh replay modal). */
-  private openReplayInternal(opts: ReplayModalOptions): void {
-    if (this.destroyed) return;
-    const layer = buildReplayModal(this.ctx, opts, () => this.openReplayInternal(opts));
-    this.pushLayer(layer);
-  }
-
   // ── frosted backdrop ─────────────────────────────────────────────────────────
   /** Snapshot the scene behind the modal layer and blur it — the Pixi analogue of the overlay's
    *  `backdrop-filter: blur(20px) saturate(120%)`. Static (captured at open time): the game is paused
@@ -333,6 +323,7 @@ export class PixiRenderer implements ShellRenderer {
       get layout() { return host.layout; },
       get soundOn() { return host.soundOn; },
       get actions() { return host.actions; },
+      openReplay: (opts) => host.openReplay(opts),
       t: (s) => host.t(s),
       formatCurrency: (n, win) => host.formatCurrency(n, win),
       emit: host.emit.bind(host),

package/src/ui/pixi/text.ts

@@ -103,6 +103,11 @@ export function makeText(str: string, opts: TextOpts): Text {
   if (opts.wrapWidth != null) {
     style.wordWrap = true;
     style.wordWrapWidth = opts.wrapWidth;
+    // CJK (and any long unbroken run) has no spaces to wrap on — without breakWords the line
+    // overflows the wrap width instead of wrapping. This is the single shell text helper (How to
+    // Play, disclaimer, Game Info section titles, mode table, win messages, buy-bonus cards), so
+    // one flag fixes wrapping everywhere.
+    style.breakWords = true;
   }
   if (opts.lineHeight != null) style.lineHeight = opts.lineHeight;
   if (opts.shadow) {