@unboxy/phaser-sdk 0.2.42 → 0.2.43

package/dist/editor/EditorBridge.js

@@ -49,7 +49,7 @@ function handleMessage(game, msg) {
             postSceneSnapshot(game);
             break;
         case 'unboxy:editor:applyEdit':
-            applyEdit(game, msg.entityId, msg.patch);
+            void applyEdit(game, msg.entityId, msg.patch, msg.manifestAsset);
             break;
         case 'unboxy:editor:setSelection':
             setSelection(game, msg.entityIds[0] ?? null);
@@ -429,7 +429,30 @@ function findRegistry(game) {
     return undefined;
 }
 // --- applyEdit ------------------------------------------------------------
-function applyEdit(game, entityId, patch) {
+async function applyEdit(game, entityId, patch, manifestAsset) {
+    // Lazy-load + manifest-upsert path. When the host's Inspector picks a Bg
+    // image asset that the iframe never preloaded (e.g. a per-game upload that
+    // was never dragged into the scene) OR an asset whose `kind` just flipped
+    // (e.g. region-atlas — slice 10 — flipping from 'image' to 'atlas'), the
+    // host pipelines the new manifest entry along with the patch so the
+    // resulting re-spawn sees a consistent runtime state. Without this, the
+    // re-spawn reads the stale cached manifest and falls back to the
+    // colored-rect placeholder.
+    if (manifestAsset) {
+        const targetScene = getEditorMode(game) === 'hud'
+            ? game.scene.getScene(UNBOXY_HUD_SCENE_KEY)
+            : findWorldScene(game);
+        if (targetScene) {
+            try {
+                upsertCachedManifestAsset(targetScene, manifestAsset);
+                await ensureAssetLoaded(targetScene, manifestAsset);
+            }
+            catch (e) {
+                console.warn('[unboxy/editor] applyEdit asset upsert/load failed:', e);
+                // Fall through — applyHudPatch will render its placeholder.
+            }
+        }
+    }
     // HUD mode — patches modify anchor / HUD-visual fields. World-style
     // transform / sprite-tint patches don't apply to HUD widgets, so we
     // dispatch through a HUD-specific helper that knows the widget kinds.
@@ -625,6 +648,51 @@ async function createEntity(game, entity, manifestAsset) {
         console.warn('[unboxy/editor] spawnEntity failed:', e);
     }
 }
+/**
+ * Merge an asset record into the scene's cached manifest (the one
+ * {@code getManifest(scene)} returns). Used by applyEdit's pipelined-asset
+ * path so subsequent re-spawns see the updated entry (kind / atlasPath /
+ * atlasFormat / ninePatch / etc.) without a full scene reload.
+ *
+ * <p>The manifest object lives in `scene.cache.json` and is shared by
+ * reference — mutating its `assets[]` is sufficient. We replace in place
+ * when an entry with the same id exists (so a stale {@code kind: 'image'}
+ * gets fully overwritten by a fresh {@code kind: 'atlas'} record).
+ */
+function upsertCachedManifestAsset(scene, asset) {
+    let manifest;
+    try {
+        manifest = getManifest(scene);
+    }
+    catch {
+        return; // manifest not in cache — nothing to merge against
+    }
+    if (!manifest.assets)
+        manifest.assets = [];
+    const idx = manifest.assets.findIndex((a) => a.id === asset.id);
+    if (idx >= 0)
+        manifest.assets[idx] = asset;
+    else
+        manifest.assets.push(asset);
+}
+/**
+ * Idempotent asset-loaded check: returns immediately if the texture is in
+ * the cache. For atlas-format assets, ALSO ensures the per-frame ninePatch
+ * sidecar JSON is loaded so the SDK's region-9-slice path can read it back.
+ */
+function ensureAssetLoaded(scene, asset) {
+    if (asset.kind === 'audio')
+        return Promise.resolve();
+    const needsTexture = !scene.textures.exists(asset.textureKey);
+    const sidecarKey = `unboxy:atlas-ninepatch:${asset.textureKey}`;
+    const needsSidecar = asset.kind === 'atlas' &&
+        asset.atlasFormat === 'json' &&
+        !!asset.atlasPath &&
+        !scene.cache.json.exists(sidecarKey);
+    if (!needsTexture && !needsSidecar)
+        return Promise.resolve();
+    return loadAssetIntoScene(scene, asset);
+}
 function loadAssetIntoScene(scene, asset) {
     return new Promise((resolve, reject) => {
         if (scene.textures.exists(asset.textureKey)) {
@@ -673,6 +741,13 @@ function loadAssetIntoScene(scene, asset) {
                 }
                 else if (asset.atlasPath) {
                     scene.load.atlas(asset.textureKey, asset.path, asset.atlasPath);
+                    // Also fetch the raw JSON into the side-cache for per-region
+                    // ninePatch lookups (slice 10). Phaser's atlas parser drops
+                    // unknown per-frame fields, so we keep the original JSON around.
+                    const sidecarKey = `unboxy:atlas-ninepatch:${asset.textureKey}`;
+                    if (!scene.cache.json.exists(sidecarKey)) {
+                        scene.load.json(sidecarKey, asset.atlasPath);
+                    }
                 }
                 break;
             case 'audio':

package/dist/protocol.d.ts

@@ -130,6 +130,21 @@ export interface EditorApplyEditMessage {
     type: 'unboxy:editor:applyEdit';
     entityId: string;
     patch: EditorEntityPatch;
+    /**
+     * Optional asset record to upsert into the iframe's manifest cache + lazy-
+     * load before the patch applies. Mirrors {@link EditorCreateEntityMessage}'s
+     * `manifestAsset` field. Used by the Inspector's Bg-image picker when the
+     * user picks an asset whose manifest entry needs flipping (e.g. region
+     * atlases — visual editor slice 10 — where the existing manifest entry
+     * was {@code kind: 'image'} but the asset is now atlas-format).
+     *
+     * <p>When present, the bridge:
+     *   1. Merges the asset into {@code scene.cache.json}'s manifest record
+     *   2. Lazy-loads the texture (and atlas-ninepatch sidecar JSON when
+     *      {@code kind: 'atlas' + atlasFormat: 'json'})
+     *   3. Applies the entity patch
+     */
+    manifestAsset?: unknown;
 }
 export interface EditorSetSelectionMessage {
     type: 'unboxy:editor:setSelection';

package/package.json

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