@unboxy/phaser-sdk 0.2.33 → 0.2.34

package/dist/scene/HudRuntime.js

@@ -140,7 +140,27 @@ function createText(ctx, entity, pos) {
     return text;
 }
 function createImage(ctx, entity, pos) {
-    const asset = ctx.resolveAsset(entity.visual.assetId);
+    let asset;
+    try {
+        asset = ctx.resolveAsset(entity.visual.assetId);
+    }
+    catch {
+        // Soft-fail when the assetId isn't in the manifest. Mirrors the world
+        // scene's createSprite missing-asset path. Wraps a Graphics in a
+        // Container so the editor's bounds-based hit-test has a sized target.
+        const w = entity.visual.width ?? 64;
+        const h = entity.visual.height ?? 64;
+        const g = ctx.scene.add.graphics();
+        g.fillStyle(0x4d2244, 0.4);
+        g.fillRect(-w / 2, -h / 2, w, h);
+        g.lineStyle(2, 0xff00ff, 0.9);
+        g.strokeRect(-w / 2, -h / 2, w, h);
+        g.lineBetween(-w / 2, -h / 2, w / 2, h / 2);
+        g.lineBetween(w / 2, -h / 2, -w / 2, h / 2);
+        const container = ctx.scene.add.container(pos.x, pos.y, [g]);
+        container.setSize(w, h);
+        return container;
+    }
     const image = entity.visual.frame !== undefined
         ? ctx.scene.add.image(pos.x, pos.y, asset.textureKey, entity.visual.frame)
         : ctx.scene.add.image(pos.x, pos.y, asset.textureKey);
@@ -478,7 +498,12 @@ export function preloadHudAssets(scene, hudScene, manifest) {
     for (const id of ids) {
         const asset = manifest.assets?.find((a) => a.id === id);
         if (!asset) {
-            throw new Error(`[unboxy/hud] HUD scene '${hudScene.id}' references assetId '${id}' but the manifest has no such asset`);
+            // Soft-fail: warn + continue. createImage / createIconButton render
+            // a placeholder when the asset is unresolvable. Mirrors the world
+            // scene's preloadSceneAssets soft-fail (SceneLoader.ts).
+            // eslint-disable-next-line no-console
+            console.warn(`[unboxy/hud] HUD scene '${hudScene.id}' references assetId '${id}' but the manifest has no such asset; widget will render as a placeholder`);
+            continue;
         }
         if (scene.textures.exists(asset.textureKey))
             continue;

package/dist/scene/SceneLoader.js

@@ -84,7 +84,15 @@ export function preloadSceneAssets(scene, sceneFile, manifest) {
             continue;
         const asset = state.assetsById.get(id);
         if (!asset) {
-            throw new Error(`[unboxy/scene] scene '${sceneFile.id}' references assetId '${id}' but the manifest has no such asset`);
+            // Soft-fail: warn, continue. The downstream spawn path renders a
+            // magenta "?" placeholder for the offending entity so the user sees
+            // *where* a missing asset would have been, without losing every
+            // other entity in the scene. Common cause is the editor adding a
+            // sprite that references an asset whose manifest entry never got
+            // synced (e.g. AssetShelf drag without manifest update).
+            // eslint-disable-next-line no-console
+            console.warn(`[unboxy/scene] scene '${sceneFile.id}' references assetId '${id}' but the manifest has no such asset; entity will render as a placeholder`);
+            continue;
         }
         queueAssetLoad(scene, asset);
         state.requestedAssetIds.add(id);

package/dist/scene/spawnEntity.js

@@ -36,7 +36,18 @@ export function spawnEntity(ctx, entity) {
 }
 function createSprite(ctx, entity) {
     const v = entity.visual;
-    const asset = ctx.resolveAsset(v.assetId);
+    let asset;
+    try {
+        asset = ctx.resolveAsset(v.assetId);
+    }
+    catch (e) {
+        // Soft-fail when the assetId isn't in the manifest. SceneLoader's
+        // preloadSceneAssets logged the warning; here we render a clear
+        // magenta-bordered "?" placeholder so the entity is still visible
+        // and selectable in the editor. Same pattern as createCodeRendered's
+        // missing-render-script path.
+        return missingAssetPlaceholder(ctx, v.assetId);
+    }
     // Phaser's add.sprite handles both plain images and atlas/spritesheet
     // textures uniformly when given (key, frame). For plain images, frame
     // is undefined and Phaser uses the default frame.
@@ -51,6 +62,29 @@ function createSprite(ctx, entity) {
         sprite.setFlipY(true);
     return sprite;
 }
+/**
+ * Magenta "?" placeholder for an entity whose assetId isn't in the manifest.
+ * Drawn as a Graphics so the editor's hit-test (which uses getBounds) lands
+ * on the visible square. Mirrors createCodeRendered's missing-script path.
+ */
+function missingAssetPlaceholder(ctx, assetId) {
+    const w = 64;
+    const h = 64;
+    const g = ctx.scene.add.graphics();
+    g.fillStyle(0x4d2244, 0.4);
+    g.fillRect(-w / 2, -h / 2, w, h);
+    g.lineStyle(2, 0xff00ff, 0.9);
+    g.strokeRect(-w / 2, -h / 2, w, h);
+    // Diagonal "no entry" lines + a "?" text so it's obvious from a glance.
+    g.lineBetween(-w / 2, -h / 2, w / 2, h / 2);
+    g.lineBetween(w / 2, -h / 2, -w / 2, h / 2);
+    // Phaser Graphics has no intrinsic size — sizeForHitTest sets bounds so
+    // the editor's hit-test (which uses getBounds) can find this entity.
+    sizeForHitTest(g, w, h);
+    g.setDataEnabled();
+    g.setData('unboxyMissingAssetId', assetId);
+    return g;
+}
 function createPrimitive(ctx, entity) {
     const v = entity.visual;
     if (v.kind === 'rect')

package/package.json

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