@almadar/std 16.152.0 → 16.154.0

package/behaviors/registry/ui/game/molecules/std-worldmap-board-2d.orb

@@ -2360,7 +2360,6 @@
                       "children": [
                         {
                           "camera": {
-                            "mode": "isometric",
                             "pos": {
                               "x": [
                                 "/",
@@ -2396,32 +2395,7 @@
                                 ],
                                 2.0
                               ]
-                            },
-                            "zoom": [
-                              "math/min",
-                              1.0,
-                              [
-                                "/",
-                                5.0,
-                                [
-                                  "+",
-                                  1.0,
-                                  [
-                                    "math/max",
-                                    [
-                                      "array/max",
-                                      "@entity.tiles",
-                                      "x"
-                                    ],
-                                    [
-                                      "array/max",
-                                      "@entity.tiles",
-                                      "y"
-                                    ]
-                                  ]
-                                ]
-                              ]
-                            ]
+                            }
                           },
                           "children": [
                             {
@@ -2819,6 +2793,7 @@
                               "type": "draw-sprite-layer"
                             }
                           ],
+                          "fit": true,
                           "projection": "isometric",
                           "showMinimap": true,
                           "tileClickEvent": "HERO_MOVE",
@@ -3582,7 +3557,6 @@
                     "children": [
                       {
                         "camera": {
-                          "mode": "isometric",
                           "pos": {
                             "x": [
                               "/",
@@ -3618,32 +3592,7 @@
                               ],
                               2.0
                             ]
-                          },
-                          "zoom": [
-                            "math/min",
-                            1.0,
-                            [
-                              "/",
-                              5.0,
-                              [
-                                "+",
-                                1.0,
-                                [
-                                  "math/max",
-                                  [
-                                    "array/max",
-                                    "@entity.tiles",
-                                    "x"
-                                  ],
-                                  [
-                                    "array/max",
-                                    "@entity.tiles",
-                                    "y"
-                                  ]
-                                ]
-                              ]
-                            ]
-                          ]
+                          }
                         },
                         "children": [
                           {
@@ -4041,6 +3990,7 @@
                             "type": "draw-sprite-layer"
                           }
                         ],
+                        "fit": true,
                         "projection": "isometric",
                         "showMinimap": true,
                         "tileClickEvent": "HERO_MOVE",

package/behaviors/registry/ui/game/molecules/ui-canvas-2d.orb

@@ -207,6 +207,13 @@
               "tier": "presentation",
               "type": "Canvas2dError"
             },
+            "fit": {
+              "default": false,
+              "description": "Auto-fit the board's grid extent to the viewport (default false — boards render at their authored `scale` and overflow → pan). Opt in for whole-board-overview boards. User wheel/pinch zoom always wins after the initial fit.",
+              "label": "Fit",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "followTarget": {
               "description": "Follow-camera target in scene space (the neutral core `Camera.target`). When `camera:'follow'` the host lerps to keep this point centered.",
               "label": "Follow Target",
@@ -277,7 +284,7 @@
             },
             "scale": {
               "default": 0.4,
-              "description": "Render scale (0.4 = 40% zoom). Ignored by `free`/`side` (world-pixel-direct).",
+              "description": "Render scale, legacy-squared semantics: on-screen cell ≈ `256 × scale²` px (the authored contract every board tuned its value for). Converted internally to the single camera zoom against the board's native tile width, so the cell pitch follows the asset while the on-screen size stays as authored. Ignored when `fit` is on; passed through raw for `free`/`side` (world-pixel-direct).",
               "label": "Scale",
               "tier": "presentation",
               "type": "number"
@@ -310,6 +317,12 @@
               "tier": "presentation",
               "type": "string"
             },
+            "tileWidth": {
+              "description": "Native tile/cell width in source px for this board's asset (e.g. 16 for Kenney tiny-dungeon, ~128 for iso blocks). The grid cell pitch follows the asset, so tile textures map 1:1 (crisp, no stretch). Defaults to the detected atlas tile width, else 256.",
+              "label": "Tile Width",
+              "tier": "presentation",
+              "type": "number"
+            },
             "unitClickEvent": {
               "default": "UNIT_CLICK",
               "description": "Unit-click event. The neutral drawable host cannot resolve a click to a per-entity id (descriptors carry only a `ScenePos`, no id), so this prop is accepted but not yet emitted — the id-hit-test is a tracked fork (docs/Almadar_Std_Game_V2_PLAN.md).",
@@ -491,6 +504,7 @@
                       "className": "@config.className",
                       "drawables": "@config.drawables",
                       "error": "@config.error",
+                      "fit": "@config.fit",
                       "followTarget": "@config.followTarget",
                       "isLoading": "@config.isLoading",
                       "keyMap": "@config.keyMap",
@@ -501,6 +515,7 @@
                       "tileClickEvent": "@config.tileClickEvent",
                       "tileHoverEvent": "@config.tileHoverEvent",
                       "tileLeaveEvent": "@config.tileLeaveEvent",
+                      "tileWidth": "@config.tileWidth",
                       "type": "canvas-2d",
                       "unitClickEvent": "@config.unitClickEvent"
                     }

package/behaviors/registry/ui/game/molecules/ui-canvas.orb

@@ -167,6 +167,12 @@
               "tier": "presentation",
               "type": "string"
             },
+            "fit": {
+              "description": "Auto-fit the board's grid extent to the viewport (2D grid layouts; default false — boards render at their authored `camera.zoom` scale).",
+              "label": "Fit",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "fogOfWar": {
               "default": [],
               "description": "fogOfWar prop",
@@ -292,6 +298,12 @@
               "tier": "presentation",
               "type": "string"
             },
+            "tileWidth": {
+              "description": "Native tile/cell width in source px of the board's asset (2D grid layouts; defaults to the detected atlas tile width, else 256).",
+              "label": "Tile Width",
+              "tier": "presentation",
+              "type": "number"
+            },
             "unitClickEvent": {
               "default": "UNIT_CLICK",
               "description": "unitClickEvent prop",
@@ -520,6 +532,7 @@
                       "className": "@config.className",
                       "drawables": "@config.drawables",
                       "featureClickEvent": "@config.featureClickEvent",
+                      "fit": "@config.fit",
                       "fogOfWar": "@config.fogOfWar",
                       "isLoading": "@config.isLoading",
                       "keyMap": "@config.keyMap",
@@ -535,6 +548,7 @@
                       "tileClickEvent": "@config.tileClickEvent",
                       "tileHoverEvent": "@config.tileHoverEvent",
                       "tileLeaveEvent": "@config.tileLeaveEvent",
+                      "tileWidth": "@config.tileWidth",
                       "type": "canvas",
                       "unitClickEvent": "@config.unitClickEvent",
                       "unitScale": "@config.unitScale",

package/behaviors/registry/ui/game/organisms/ui-arena-board.orb

@@ -700,8 +700,7 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01KXG04WJHHVKHWKFWX7TFEEAH",
           "name": "ChaseAI",
-          "ref": "Chase.traits.ChaseAi",
-          "refId": "trt_01KXG04TEW4X0PEW1QFM8N84NG"
+          "ref": "Chase.traits.ChaseAi"
         },
         {
           "config": {
@@ -714,8 +713,7 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01KXG04WJHHVKHWKFWX7TFEEAH",
           "name": "FxDecay",
-          "ref": "Particles.traits.FxParticles",
-          "refId": "trt_01KXG04TFZQZVT3F7J3DTM2PXF"
+          "ref": "Particles.traits.FxParticles"
         },
         {
           "config": {
@@ -728,8 +726,7 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01KXG04WJHHVKHWKFWX7TFEEAH",
           "name": "RoundLogic",
-          "ref": "Round.traits.RoundFlow",
-          "refId": "trt_01KXG04TNCJQBQBHH17BMMRPXT"
+          "ref": "Round.traits.RoundFlow"
         },
         {
           "category": "interaction",
@@ -1343,6 +1340,7 @@
                               "type": "draw-text-layer"
                             }
                           ],
+                          "fit": true,
                           "projection": "flat",
                           "showMinimap": false,
                           "type": "canvas"
@@ -1540,6 +1538,7 @@
                             "type": "draw-text-layer"
                           }
                         ],
+                        "fit": true,
                         "projection": "flat",
                         "showMinimap": false,
                         "type": "canvas"