@umicat/phaser-sdk 1.0.2 → 1.0.3

package/dist/editor/EditorBridge.js

@@ -43,6 +43,16 @@ export function setupEditorBridge(game) {
             return;
         handleMessage(game, data);
     });
+    // Boot-time edit flag (2026-06-11). When the host remounts the iframe
+    // while edit mode is on (post-save / post-agent-turn rebuild), it appends
+    // `umicatEdit=1` to the iframe URL. Enter edit IMMEDIATELY at game
+    // construction so scenes pause before their first update. Without this
+    // the game visibly plays for a second or two after every rebuild: the
+    // host's `enter` postMessage can't arrive any earlier because main.ts
+    // awaits font fetches before createUmicatGame installs this listener.
+    if (typeof window !== 'undefined' && /[?&]umicatEdit=1/.test(window.location.search)) {
+        enterEdit(game);
+    }
 }
 function handleMessage(game, msg) {
     switch (msg.type) {
@@ -134,6 +144,15 @@ function enterEdit(game) {
     restoreCanvasAfterEditor(game);
     setEditorActive(game, true);
     pauseActiveNonEditor(game);
+    // Continuous pause enforcement (2026-06-11) — the bounded 3s re-attempt
+    // loop below misses scenes that finish booting later than 3s after
+    // enter (slow CDN fetch of scene assets, etc.), and even within the
+    // window a scene can run for up to 100ms before the next tick pauses
+    // it. A PRE_STEP hook pauses any newly-active non-editor scene BEFORE
+    // its first update, for as long as edit mode is on. pauseActiveNonEditor
+    // skips already-paused scenes, so the per-frame cost is a short loop
+    // over the scene list.
+    installPauseEnforcement(game);
     // P1 infinite canvas — expand the Phaser canvas to fill its container
     // (host's iframe). Without this, the editor surface stays locked to
     // the game's intrinsic aspect ratio (720×1280 portrait, etc.) with
@@ -199,6 +218,33 @@ function enterEdit(game) {
     };
     setTimeout(reattempt, 100);
 }
+const PAUSE_ENFORCER_FLAG = '__umicatEditorPauseEnforcer';
+/**
+ * While edit mode is active, pause any non-editor scene before each game
+ * step. Catches scenes that boot AFTER enterEdit (iframe rebuild path) no
+ * matter how late — the game never visibly plays under the editor.
+ * Self-disarms via the active check; uninstalled on exitEdit.
+ */
+function installPauseEnforcement(game) {
+    const bag = game;
+    if (bag[PAUSE_ENFORCER_FLAG])
+        return;
+    const handler = () => {
+        if (!getEditorState(game).active)
+            return;
+        pauseActiveNonEditor(game);
+    };
+    game.events.on(Phaser.Core.Events.PRE_STEP, handler);
+    bag[PAUSE_ENFORCER_FLAG] = handler;
+}
+function uninstallPauseEnforcement(game) {
+    const bag = game;
+    const handler = bag[PAUSE_ENFORCER_FLAG];
+    if (!handler)
+        return;
+    game.events.off(Phaser.Core.Events.PRE_STEP, handler);
+    delete bag[PAUSE_ENFORCER_FLAG];
+}
 function pauseActiveNonEditor(game) {
     // P1 infinite canvas (2026-05-17) — use `setActive(false)` instead of
     // `pause()` so scenes STOP updating (game logic frozen) but KEEP
@@ -250,6 +296,9 @@ function exitEdit(game) {
     if (!getEditorState(game).active)
         return;
     setEditorActive(game, false);
+    // Active is false now so the enforcer self-disables, but remove the
+    // hook too — no point paying the per-frame check during play.
+    uninstallPauseEnforcement(game);
     setSelection(game, null);
     // Allow next enter to re-post the snapshot (scene file may have changed).
     delete game[SNAPSHOT_POSTED_FLAG];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umicat/phaser-sdk",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "Umicat Phaser 3 SDK — game infrastructure for the Umicat platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",