@energy8platform/shell 0.7.1 → 0.7.2

package/dist/pixi.d.ts

@@ -633,7 +633,7 @@ declare class ShellController extends EventEmitter<ShellEvents> implements Shell
     tokens: ShellTokens;
     layout: ShellLayoutMode;
     soundOn: boolean;
-    readonly engineVersion = "0.7.1";
+    readonly engineVersion = "0.7.2";
     readonly actions: ShellActions;
     private renderer;
     private i18n;
@@ -778,7 +778,7 @@ interface I18n {
 declare function createI18n(opts: I18nOptions): I18n;
 
 /** The @energy8platform/shell package version, stamped into the game-info footer. */
-declare const PACKAGE_VERSION = "0.7.1";
+declare const PACKAGE_VERSION = "0.7.2";
 
 /** A shell: the renderer-agnostic controller plus the surface facade (safeArea/barHeight/setVisible)
  *  an embedding host reads. `createShell`, `createGameShell` and `createPixiShell` all return this. */

package/dist/pixi.esm.js

@@ -1692,7 +1692,7 @@ class KeyboardController {
 
 // 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. */
-const PACKAGE_VERSION = '0.7.1';
+const PACKAGE_VERSION = '0.7.2';
 
 /** Apply defaults to the raw config (the mount target lives on the renderer, not here). */
 function resolveConfig(config) {
@@ -2324,7 +2324,22 @@ function prefersReducedMotion() {
 }
 const easeOutCubic = (p) => 1 - Math.pow(1 - p, 3);
 
-/** Tween 0→1 on the Pixi ticker. Returns a canceler. Skips to the end when motion is reduced. */
+/**
+ * Tween 0→1 on the Pixi ticker. Returns a canceler. Skips to the end when motion is reduced.
+ *
+ * CONTRACT — when motion is reduced (or `duration <= 0`) this tween does NOT animate: it applies
+ * the final value and calls `onComplete` SYNCHRONOUSLY, before returning. Callers depend on that
+ * (`PixiRenderer.destroy` resolves its teardown promise from `onComplete`, and must not wait on a
+ * ticker that may already be stopped), so it must stay synchronous.
+ *
+ * The consequence for callers: `onComplete` is NOT an async boundary. An `onComplete` that starts
+ * another tween is then direct recursion with no unwind — tween → onComplete → tween → … until
+ * `RangeError: Maximum call stack size exceeded`. That shipped once: the CTA pulse loop
+ * (`widgets.ts` startPulse) restarted itself from `onComplete`, so every player running the OS
+ * "reduce motion" setting crashed the instant the buy-bonus panel painted its hovered CTA. Any
+ * looping animation must therefore check `prefersReducedMotion()` and not loop — which is also
+ * what reduced motion is asking for.
+ */
 function tween(ticker, opts) {
     const ease = opts.ease ?? easeOutCubic;
     if (prefersReducedMotion() || opts.duration <= 0) {
@@ -3296,6 +3311,15 @@ class BuyBonusBadge extends Container {
     startPulse() {
         if (this.pulseCancel)
             return;
+        // A pulse is exactly the kind of looping decoration "reduce motion" asks us to drop — and
+        // under it `tween` has nothing to animate anyway: it snaps to the end and calls `onComplete`
+        // SYNCHRONOUSLY (see its contract), which this loop would answer by starting another one, and
+        // another, with no unwind — `RangeError: Maximum call stack size exceeded`. That was a live
+        // Stake crash: with the OS "reduce motion" setting on, opening the buy-bonus panel painted its
+        // hovered CTA and killed the game, so the player could never buy. Now the button simply sits
+        // still at scale 1.
+        if (prefersReducedMotion())
+            return;
         // both the label (anchor 0.5) and the icon (pivot centred) scale around their centre
         const loop = () => {
             this.pulseCancel = tween(this.ticker, {