@almadar/std 16.151.0 → 16.153.0

package/behaviors/registry/ui/game/atoms/ui-svg-draw-shape.orb

@@ -0,0 +1,259 @@
+{
+  "description": "SvgDrawShape — UI factory (1:1 with the @almadar/ui svg-draw-shape pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01KYMKTF3TQSHVDC76J06N5NCE": {
+        "bakedName": "SvgDrawShapeItem",
+        "curName": "SvgDrawShapeItem",
+        "id": "ent_01KYMKTF3TQSHVDC76J06N5NCE",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYMKTF3TKA2772N1N9CNSCPJ": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYMKTF3TKA2772N1N9CNSCPJ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYMKTF3TT3YY4G7HJP7K7RJW",
+        "renames": []
+      },
+      "orb_01KYMKTF3TZSC5FY0F8SRMZ6D5": {
+        "bakedName": "SvgDrawShapeOrbital",
+        "curName": "SvgDrawShapeOrbital",
+        "id": "orb_01KYMKTF3TZSC5FY0F8SRMZ6D5",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYMKTF3V6TMQ09CYBXNRZSX9": {
+        "bakedName": "SvgDrawShapePage",
+        "curName": "SvgDrawShapePage",
+        "id": "pag_01KYMKTF3V6TMQ09CYBXNRZSX9",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYMKTF3TT3YY4G7HJP7K7RJW": {
+        "bakedName": "SvgDrawShapeRender",
+        "curName": "SvgDrawShapeRender",
+        "id": "trt_01KYMKTF3TT3YY4G7HJP7K7RJW",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-svg-draw-shape",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01KYMKTF3TQSHVDC76J06N5NCE",
+        "name": "SvgDrawShapeItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYMKTF3TZSC5FY0F8SRMZ6D5",
+      "name": "SvgDrawShapeOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYMKTF3V6TMQ09CYBXNRZSX9",
+          "name": "SvgDrawShapePage",
+          "path": "/svg-draw-shape",
+          "traits": [
+            {
+              "ref": "SvgDrawShapeRender",
+              "refId": "trt_01KYMKTF3TT3YY4G7HJP7K7RJW"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "className": {
+              "description": "Additional CSS classes",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "d": {
+              "description": "Path data, viewBox units relative to the translated origin.",
+              "label": "D",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "fill": {
+              "description": "fill prop",
+              "label": "Fill",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "height": {
+              "description": "Rect height in cell units.",
+              "label": "Height",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "opacity": {
+              "description": "0..1 opacity.",
+              "label": "Opacity",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "points": {
+              "description": "Polygon/polyline points, viewBox units relative to the translated origin.",
+              "label": "Points",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "radius": {
+              "description": "Circle radius / ellipse horizontal radius in cell units.",
+              "label": "Radius",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "radiusY": {
+              "description": "Ellipse vertical radius in cell units; omitted → `radius` (a circle).",
+              "label": "Radius Y",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "shape": {
+              "default": "rect",
+              "description": "shape prop",
+              "label": "Shape",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "rect",
+                "circle",
+                "ellipse",
+                "polygon",
+                "polyline",
+                "path",
+                "line"
+              ]
+            },
+            "stroke": {
+              "description": "stroke prop",
+              "label": "Stroke",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "strokeWidth": {
+              "description": "strokeWidth prop",
+              "label": "Stroke Width",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "width": {
+              "description": "Rect width in cell units.",
+              "label": "Width",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "x": {
+              "default": 1.0,
+              "description": "Grid-cell x of the element's translated origin.",
+              "label": "X",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "x2": {
+              "description": "Line end x in cell units.",
+              "label": "X2",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "y": {
+              "default": 1.0,
+              "description": "Grid-cell y of the element's translated origin.",
+              "label": "Y",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "y2": {
+              "description": "Line end y in cell units.",
+              "label": "Y2",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "SvgDrawShapeItem": "ent_01KYMKTF3TQSHVDC76J06N5NCE"
+          },
+          "id": "trt_01KYMKTF3TT3YY4G7HJP7K7RJW",
+          "linkedEntity": "SvgDrawShapeItem",
+          "linkedEntityId": "ent_01KYMKTF3TQSHVDC76J06N5NCE",
+          "name": "SvgDrawShapeRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYMKTF3TKA2772N1N9CNSCPJ",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "d": "@config.d",
+                      "fill": "@config.fill",
+                      "height": "@config.height",
+                      "opacity": "@config.opacity",
+                      "points": "@config.points",
+                      "radius": "@config.radius",
+                      "radiusY": "@config.radiusY",
+                      "shape": "@config.shape",
+                      "stroke": "@config.stroke",
+                      "strokeWidth": "@config.strokeWidth",
+                      "type": "svg-draw-shape",
+                      "width": "@config.width",
+                      "x": "@config.x",
+                      "x2": "@config.x2",
+                      "y": "@config.y",
+                      "y2": "@config.y2"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYMKTF3TKA2772N1N9CNSCPJ",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/game/atoms/ui-svg-draw-text.orb

@@ -0,0 +1,195 @@
+{
+  "description": "SvgDrawText — UI factory (1:1 with the @almadar/ui svg-draw-text pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01KYMKTF4QQ6FPCBBY32HS73AF": {
+        "bakedName": "SvgDrawTextItem",
+        "curName": "SvgDrawTextItem",
+        "id": "ent_01KYMKTF4QQ6FPCBBY32HS73AF",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01KYMKTF4QYE2WQ95CQPP36TMB": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01KYMKTF4QYE2WQ95CQPP36TMB",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KYMKTF4QTG7QV2Y7N9J2TWY2",
+        "renames": []
+      },
+      "orb_01KYMKTF4QZP93EF8DZMBDZJCR": {
+        "bakedName": "SvgDrawTextOrbital",
+        "curName": "SvgDrawTextOrbital",
+        "id": "orb_01KYMKTF4QZP93EF8DZMBDZJCR",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01KYMKTF4SJXHA654TD526HAJ7": {
+        "bakedName": "SvgDrawTextPage",
+        "curName": "SvgDrawTextPage",
+        "id": "pag_01KYMKTF4SJXHA654TD526HAJ7",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01KYMKTF4QTG7QV2Y7N9J2TWY2": {
+        "bakedName": "SvgDrawTextRender",
+        "curName": "SvgDrawTextRender",
+        "id": "trt_01KYMKTF4QTG7QV2Y7N9J2TWY2",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-svg-draw-text",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01KYMKTF4QQ6FPCBBY32HS73AF",
+        "name": "SvgDrawTextItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01KYMKTF4QZP93EF8DZMBDZJCR",
+      "name": "SvgDrawTextOrbital",
+      "pages": [
+        {
+          "id": "pag_01KYMKTF4SJXHA654TD526HAJ7",
+          "name": "SvgDrawTextPage",
+          "path": "/svg-draw-text",
+          "traits": [
+            {
+              "ref": "SvgDrawTextRender",
+              "refId": "trt_01KYMKTF4QTG7QV2Y7N9J2TWY2"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "anchor": {
+              "default": "middle",
+              "description": "Text anchor (default 'middle').",
+              "label": "Anchor",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "start",
+                "middle",
+                "end"
+              ]
+            },
+            "className": {
+              "description": "Additional CSS classes",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "fill": {
+              "default": "var(--color-foreground)",
+              "description": "fill prop",
+              "label": "Fill",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "size": {
+              "default": 12.0,
+              "description": "Font size in viewBox units (default 12).",
+              "label": "Size",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "text": {
+              "default": "",
+              "description": "The text content.",
+              "label": "Text",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "x": {
+              "default": 1.0,
+              "description": "Grid-cell x of the text anchor.",
+              "label": "X",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "y": {
+              "default": 1.0,
+              "description": "Grid-cell y of the text anchor.",
+              "label": "Y",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "SvgDrawTextItem": "ent_01KYMKTF4QQ6FPCBBY32HS73AF"
+          },
+          "id": "trt_01KYMKTF4QTG7QV2Y7N9J2TWY2",
+          "linkedEntity": "SvgDrawTextItem",
+          "linkedEntityId": "ent_01KYMKTF4QQ6FPCBBY32HS73AF",
+          "name": "SvgDrawTextRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01KYMKTF4QYE2WQ95CQPP36TMB",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "anchor": "@config.anchor",
+                      "className": "@config.className",
+                      "fill": "@config.fill",
+                      "size": "@config.size",
+                      "text": "@config.text",
+                      "type": "svg-draw-text",
+                      "x": "@config.x",
+                      "y": "@config.y"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KYMKTF4QYE2WQ95CQPP36TMB",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

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

@@ -1042,7 +1042,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01KXG04VRWJXZNZBK4QSXVFZK6",
           "name": "TacticsAuthority",
-          "ref": "Tactics.traits.GridTactics"
+          "ref": "Tactics.traits.GridTactics",
+          "refId": "trt_01KXG04THREP6VTN7SEQ5QND02"
         },
         {
           "config": {
@@ -1055,7 +1056,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01KXG04VRWJXZNZBK4QSXVFZK6",
           "name": "RoundLogic",
-          "ref": "Round.traits.RoundFlow"
+          "ref": "Round.traits.RoundFlow",
+          "refId": "trt_01KXG04TNCJQBQBHH17BMMRPXT"
         },
         {
           "config": {
@@ -1076,7 +1078,8 @@
           "linkedEntity": "GameState",
           "linkedEntityId": "ent_01KXG04VRWJXZNZBK4QSXVFZK6",
           "name": "GoldAuthority",
-          "ref": "Gold.traits.GoldMine"
+          "ref": "Gold.traits.GoldMine",
+          "refId": "trt_01KXG04TH34ES2DPDMM3BSZE0W"
         },
         {
           "category": "interaction",

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/molecules/ui-draw-shape-layer.orb

@@ -83,6 +83,7 @@
             "items": {
               "default": [
                 {
+                  "d": "D",
                   "fill": "Fill",
                   "height": 1.0,
                   "offsetX": 1.0,
@@ -103,6 +104,7 @@
                   "width": 1.0
                 },
                 {
+                  "d": "D 2",
                   "fill": "Fill 2",
                   "height": 2.0,
                   "offsetX": 2.0,
@@ -131,6 +133,11 @@
                     "required": false,
                     "type": "string"
                   },
+                  "d": {
+                    "name": "d",
+                    "required": false,
+                    "type": "string"
+                  },
                   "fill": {
                     "name": "fill",
                     "required": false,
@@ -204,7 +211,8 @@
                       "cell",
                       "rect",
                       "ellipse",
-                      "poly"
+                      "poly",
+                      "path"
                     ]
                   },
                   "stroke": {