@unboxy/phaser-sdk 0.2.35 → 0.2.36

package/dist/scene/SceneLoader.js

@@ -172,12 +172,29 @@ function queueAssetLoad(scene, asset) {
         case 'image':
             scene.load.image(asset.textureKey, asset.path);
             return;
-        case 'spritesheet':
-            if (!asset.spriteSheetConfig) {
-                throw new Error(`[unboxy/scene] asset '${asset.id}' kind=spritesheet missing spriteSheetConfig`);
+        case 'spritesheet': {
+            // Tolerant config resolution: prefer nested `spriteSheetConfig`, fall
+            // back to top-level `frameWidth/frameHeight/margin/spacing` if the
+            // agent put them there (common typo — both shapes appear in real
+            // workspaces). Soft-fail with warning when neither shape provides
+            // frame dims so the rest of the scene still boots.
+            const cfg = asset.spriteSheetConfig
+                ?? (asset.frameWidth && asset.frameHeight
+                    ? {
+                        frameWidth: asset.frameWidth,
+                        frameHeight: asset.frameHeight,
+                        margin: asset.margin,
+                        spacing: asset.spacing,
+                    }
+                    : null);
+            if (!cfg) {
+                // eslint-disable-next-line no-console
+                console.warn(`[unboxy/scene] asset '${asset.id}' kind=spritesheet missing spriteSheetConfig (and no top-level frameWidth/frameHeight); skipping load`);
+                return;
             }
-            scene.load.spritesheet(asset.textureKey, asset.path, asset.spriteSheetConfig);
+            scene.load.spritesheet(asset.textureKey, asset.path, cfg);
             return;
+        }
         case 'atlas':
             if (!asset.atlasPath || !asset.atlasFormat) {
                 throw new Error(`[unboxy/scene] asset '${asset.id}' kind=atlas missing atlasPath/atlasFormat`);

package/dist/scene/types.d.ts

@@ -42,6 +42,15 @@ export interface AssetRecord {
         margin?: number;
         spacing?: number;
     };
+    /**
+     * Top-level convenience fields. When the agent writes a spritesheet asset
+     * entry, it commonly puts these at the top level instead of nested in
+     * `spriteSheetConfig` — both shapes are now accepted by the loader.
+     */
+    frameWidth?: number;
+    frameHeight?: number;
+    margin?: number;
+    spacing?: number;
     /** For `atlas`: companion atlas file path (xml or json). */
     atlasPath?: string;
     /** `'xml'` (Starling) or `'json'` (TexturePacker). */

package/package.json

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