@umicat/phaser-sdk 1.0.18 → 1.0.19

package/dist/editor/EditorBridge.js

@@ -79,7 +79,7 @@ function handleMessage(game, msg) {
             applyPanZoomToWorld(game, msg);
             break;
         case 'umicat:editor:createEntity':
-            void createEntity(game, msg.entity, msg.manifestAsset);
+            void createEntity(game, msg.entity, msg.manifestAsset, msg.tilemapFile);
             break;
         case 'umicat:editor:deleteEntity':
             deleteEntity(game, msg.entityId);
@@ -1206,7 +1206,7 @@ function applyVisualPatch(go, v) {
  * the host would have to coordinate a build before showing a dropped
  * sprite, which defeats the point of drag-to-place.
  */
-async function createEntity(game, entity, manifestAsset) {
+async function createEntity(game, entity, manifestAsset, tilemapFile) {
     // HUD mode dispatches to the HUD-runtime spawner (slice 5). The host
     // sends HudEntity records (not WorldEntity), so we type-erase.
     if (getEditorMode(game) === 'hud') {
@@ -1288,13 +1288,26 @@ async function createEntity(game, entity, manifestAsset) {
         // dropped tilemap renders LIVE without a save+reload round-trip.
         const tilemapId = entity.tilemapId;
         if (tilemapId) {
-            try {
-                await loadTilemapFileIntoScene(sceneRef, tilemapId);
+            const key = tilemapFileCacheKey(tilemapId);
+            // Prefer the host-supplied file CONTENT (the workspace truth). The dist
+            // copy that `loadTilemapFileIntoScene` fetches is STALE until the next
+            // game build, so a freshly-authored/edited tilemap 404s there → magenta
+            // placeholder until save+rebuild. Injecting the passed content renders it
+            // LIVE. Fall back to the dist fetch when the host didn't supply it.
+            if (tilemapFile) {
+                if (sceneRef.cache.json.exists(key))
+                    sceneRef.cache.json.remove(key);
+                sceneRef.cache.json.add(key, tilemapFile);
             }
-            catch (e) {
-                console.warn('[umicat/editor] createEntity: tilemap-ref file load failed:', e);
+            else {
+                try {
+                    await loadTilemapFileIntoScene(sceneRef, tilemapId);
+                }
+                catch (e) {
+                    console.warn('[umicat/editor] createEntity: tilemap-ref file load failed:', e);
+                }
             }
-            const file = sceneRef.cache.json.get(tilemapFileCacheKey(tilemapId));
+            const file = sceneRef.cache.json.get(key);
             for (const layer of file?.layers ?? []) {
                 for (const tid of layer.tilesetIds ?? []) {
                     queueIfMissing(resolveById(tid));

package/dist/protocol.d.ts

@@ -194,6 +194,15 @@ export interface EditorCreateEntityMessage {
     entity: unknown;
     /** Asset record to add to runtime cache before spawn. Omit if assetId is already loaded. */
     manifestAsset?: unknown;
+    /**
+     * For a `tilemap-ref`: the standalone tilemap file's CONTENT (the parsed
+     * `public/tilemaps/{id}.json`). The host fetches it from the WORKSPACE
+     * (current truth) and passes it so the SDK injects it into the JSON cache
+     * directly. Without this the SDK fetches the file from the deployed dist,
+     * which is STALE until the next game build — so a freshly-authored/edited
+     * tilemap renders as the magenta placeholder until save+reload.
+     */
+    tilemapFile?: unknown;
 }
 export interface EditorDeleteEntityMessage {
     type: 'umicat:editor:deleteEntity';

package/package.json

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