@unboxy/phaser-sdk 0.2.22 → 0.2.23

package/dist/editor/EditorBridge.js

@@ -209,15 +209,15 @@ function hitTest(game, worldX, worldY) {
     let topmost = null;
     let topmostDepth = -Infinity;
     for (const go of registry.all()) {
-        const withBounds = go;
-        if (typeof withBounds.getBounds !== 'function')
+        const r = entityHitRect(go);
+        if (!r)
             continue;
-        const r = withBounds.getBounds();
         if (worldX < r.x || worldX > r.x + r.width)
             continue;
         if (worldY < r.y || worldY > r.y + r.height)
             continue;
-        const depth = typeof withBounds.depth === 'number' ? withBounds.depth : 0;
+        const withDepth = go;
+        const depth = typeof withDepth.depth === 'number' ? withDepth.depth : 0;
         if (depth >= topmostDepth) {
             topmostDepth = depth;
             topmost = go;
@@ -225,6 +225,37 @@ function hitTest(game, worldX, worldY) {
     }
     return topmost;
 }
+/**
+ * Compute a hit-test rectangle for a spawned entity in world coords.
+ *
+ * 1. If the entity has `editorHitWidth` / `editorHitHeight` set in data
+ *    (code-rendered entities — Graphics has no intrinsic bounds), use
+ *    those centered on the entity's x/y.
+ * 2. Otherwise fall back to Phaser's `getBounds()` (works for Sprite,
+ *    Rectangle, Arc, Container — anything with a Size component).
+ *
+ * Returns null if neither path yields a usable rect.
+ */
+function entityHitRect(go) {
+    const hitW = go.getData('editorHitWidth');
+    const hitH = go.getData('editorHitHeight');
+    if (typeof hitW === 'number' && typeof hitH === 'number') {
+        const positioned = go;
+        return {
+            x: positioned.x - hitW / 2,
+            y: positioned.y - hitH / 2,
+            width: hitW,
+            height: hitH,
+        };
+    }
+    const withBounds = go;
+    if (typeof withBounds.getBounds !== 'function')
+        return null;
+    const r = withBounds.getBounds();
+    if (r.width === 0 && r.height === 0)
+        return null;
+    return { x: r.x, y: r.y, width: r.width, height: r.height };
+}
 function findRegistry(game) {
     for (const scene of game.scene.getScenes(false)) {
         const reg = getEntityRegistry(scene);

package/dist/editor/EditorOverlayScene.js

@@ -190,10 +190,24 @@ export class EditorOverlayScene extends Phaser.Scene {
     }
 }
 function computeBounds(go) {
-    // Most game objects implement getBounds; Container does too.
+    // Code-rendered entities stash hit dimensions on data because Phaser
+    // Graphics has no intrinsic bounds. Use those when present.
+    const hitW = go.getData('editorHitWidth');
+    const hitH = go.getData('editorHitHeight');
+    if (typeof hitW === 'number' && typeof hitH === 'number') {
+        const positioned = go;
+        return {
+            x: positioned.x - hitW / 2,
+            y: positioned.y - hitH / 2,
+            width: hitW,
+            height: hitH,
+        };
+    }
     const withBounds = go;
     if (typeof withBounds.getBounds !== 'function')
         return null;
     const r = withBounds.getBounds();
+    if (r.width === 0 && r.height === 0)
+        return null;
     return { x: r.x, y: r.y, width: r.width, height: r.height };
 }

package/dist/scene/spawnEntity.js

@@ -94,6 +94,8 @@ function createGroup(ctx, entity) {
     return container;
 }
 function createCodeRendered(ctx, entity) {
+    const w = entity.visual.width ?? 64;
+    const h = entity.visual.height ?? 64;
     const render = ctx.resolveRenderScript?.(entity.visual.script);
     if (!render) {
         // Slice 3.5: render scripts have a registry now, but a missing entry
@@ -102,21 +104,35 @@ function createCodeRendered(ctx, entity) {
         // the user sees the entity exists but the visual is unresolved.
         const ph = ctx.scene.add.graphics();
         ph.fillStyle(0x666666, 0.4);
-        ph.fillRect(-16, -16, 32, 32);
+        ph.fillRect(-w / 2, -h / 2, w, h);
         ph.lineStyle(2, 0xff8800, 0.9);
-        ph.strokeRect(-16, -16, 32, 32);
-        // Annotate so editor / debug overlays can identify.
+        ph.strokeRect(-w / 2, -h / 2, w, h);
+        sizeForHitTest(ph, w, h);
         ph.setData('renderScriptMissing', entity.visual.script);
         return ph;
     }
     const g = ctx.scene.add.graphics();
     const params = entity.visual.params ?? {};
     render(g, params);
+    sizeForHitTest(g, w, h);
     // Stash data needed for live re-render from EditorBridge.applyEdit.
     g.setData('renderScriptPath', entity.visual.script);
     g.setData('renderScriptParams', params);
     return g;
 }
+/**
+ * Phaser Graphics doesn't track its drawn area — `getBounds()` returns
+ * a 0×0 rect because the Graphics class doesn't include the Size/Origin
+ * mixins. Rather than fight Phaser's class hierarchy with method casts,
+ * stash the editor hit area on the GameObject's data manager. The editor
+ * overlay reads these before falling back to `getBounds()`. The implicit
+ * convention: hit area is centered on the GameObject's x/y, matching how
+ * render scripts conventionally draw around (0, 0).
+ */
+function sizeForHitTest(g, width, height) {
+    g.setData('editorHitWidth', width);
+    g.setData('editorHitHeight', height);
+}
 function applyTransform(go, t) {
     // Most game objects implement Transform; Container does too. Cast through
     // a permissive shape so this works for sprite/rect/circle/container alike.

package/dist/scene/types.d.ts

@@ -116,6 +116,14 @@ export interface CodeRenderedVisual {
     /** Path to render script, e.g. `"src/visuals/boss-renderer.ts"`. */
     script: string;
     params?: Record<string, unknown>;
+    /**
+     * Optional bounds used for editor hit-testing (click + drag) and the
+     * selection rectangle. Phaser Graphics has no intrinsic size, so we set
+     * it explicitly. Defaults to 64×64 centered on the entity. The agent can
+     * override per-entity when the script draws something larger or smaller.
+     */
+    width?: number;
+    height?: number;
 }
 export type WorldVisual = SpriteVisual | PrimitiveVisual | CodeRenderedVisual;
 export type WorldEntityKind = 'sprite' | 'primitive' | 'code-rendered' | 'group' | 'tilemap' | 'trigger';

package/package.json

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