@umicat/phaser-sdk 1.0.18 → 1.0.20

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/editor/EditorOverlayScene.js

@@ -38,6 +38,10 @@ const WORLD_BOUNDS_ALPHA = 0.7;
 const CAMERA_VIEWPORT_COLOR = 0x4488ee;
 const CAMERA_VIEWPORT_ALPHA = 0.9;
 const CAMERA_VIEWPORT_LINE_WIDTH = 2;
+// HUD edit mode — the PLAYER'S SCREEN frame (full game-intrinsic resolution).
+// Brighter/distinct from the world-camera rect: it's the fixed boundary HUD
+// widgets anchor to (Godot's UI viewport rect), not the movable camera view.
+const HUD_SCREEN_COLOR = 0x5bc0ff;
 // FB.10 polish — CSS cursor name per tilemap resize handle. Corner handles
 // get the diagonal arrows (`nwse-resize` ↖↘ for NW/SE, `nesw-resize` ↗↙ for
 // NE/SW). Edge handles get the axis arrows (ns / ew). Same conventions as
@@ -1774,10 +1778,28 @@ export class EditorOverlayScene extends Phaser.Scene {
             const snap = this.game['__unboxyEditorScaleSnapshot'];
             const intrinsicW = snap?.gameWidth ?? this.game.scale.width;
             const intrinsicH = snap?.gameHeight ?? this.game.scale.height;
-            const camW = intrinsicW / worldSceneCam.zoom;
-            const camH = intrinsicH / worldSceneCam.zoom;
-            this.graphics.lineStyle(CAMERA_VIEWPORT_LINE_WIDTH, CAMERA_VIEWPORT_COLOR, CAMERA_VIEWPORT_ALPHA);
-            this.graphics.strokeRect(camX, camY, camW, camH);
+            if (getEditorMode(this.game) === 'hud') {
+                // HUD mode → draw the PLAYER'S SCREEN frame at FULL intrinsic size
+                // (1280×720), NOT intrinsic/zoom. HUD widgets are screen-anchored:
+                // `syncHudCameraToEditorCam` maps HUD-intrinsic (0..1280, 0..720) onto
+                // the full-intrinsic span at (gameCam.scroll). The world-camera zoom
+                // shrinks how much WORLD fits, NOT the screen — so drawing the frame at
+                // intrinsic/zoom (the world-camera viewport, as world mode does) made
+                // the frame 3× smaller than the HUD, and widgets sprawled OUTSIDE it
+                // (the "I can't tell where to place HUD" bug). At full intrinsic the
+                // frame is exactly the HUD's bounds → a stable boundary to anchor to.
+                this.graphics.lineStyle(CAMERA_VIEWPORT_LINE_WIDTH + 1, HUD_SCREEN_COLOR, 1);
+                this.graphics.strokeRect(camX, camY, intrinsicW, intrinsicH);
+            }
+            else {
+                // World mode → the camera viewport rect: where the runtime camera
+                // looks + how much it sees (intrinsic/zoom). Small inside a larger
+                // world for farming/RPG; coincides with world bounds for Tetris etc.
+                const camW = intrinsicW / worldSceneCam.zoom;
+                const camH = intrinsicH / worldSceneCam.zoom;
+                this.graphics.lineStyle(CAMERA_VIEWPORT_LINE_WIDTH, CAMERA_VIEWPORT_COLOR, CAMERA_VIEWPORT_ALPHA);
+                this.graphics.strokeRect(camX, camY, camW, camH);
+            }
         }
         const selectedId = getSelection(this.game);
         if (selectedId) {

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.20",
   "description": "Umicat Phaser 3 SDK — game infrastructure for the Umicat platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",