@almadar/std 16.197.0 → 16.199.0

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

@@ -83,6 +83,7 @@
             "items": {
               "default": [
                 {
+                  "anchor": "top-left",
                   "animation": {
                     "durationMs": 1.0,
                     "keyframes": [
@@ -152,7 +153,16 @@
                     },
                     "kind": "linear",
                     "radius": 1.0,
-                    "stops": [],
+                    "stops": [
+                      {
+                        "color": "Color",
+                        "offset": 1.0
+                      },
+                      {
+                        "color": "Color 2",
+                        "offset": 2.0
+                      }
+                    ],
                     "to": {
                       "x": 1.0,
                       "y": 1.0
@@ -207,17 +217,27 @@
                     },
                     "kind": "linear",
                     "radius": 1.0,
-                    "stops": [],
+                    "stops": [
+                      {
+                        "color": "Color",
+                        "offset": 1.0
+                      },
+                      {
+                        "color": "Color 2",
+                        "offset": 2.0
+                      }
+                    ],
                     "to": {
                       "x": 1.0,
                       "y": 1.0
                     }
                   },
                   "strokeWidth": 1.0,
-                  "type": "Type",
+                  "type": "draw-shape",
                   "width": 1.0
                 },
                 {
+                  "anchor": "ground",
                   "animation": {
                     "durationMs": 2.0,
                     "keyframes": [
@@ -287,7 +307,16 @@
                     },
                     "kind": "radial",
                     "radius": 2.0,
-                    "stops": [],
+                    "stops": [
+                      {
+                        "color": "Color",
+                        "offset": 1.0
+                      },
+                      {
+                        "color": "Color 2",
+                        "offset": 2.0
+                      }
+                    ],
                     "to": {
                       "x": 2.0,
                       "y": 2.0
@@ -342,14 +371,23 @@
                     },
                     "kind": "radial",
                     "radius": 2.0,
-                    "stops": [],
+                    "stops": [
+                      {
+                        "color": "Color",
+                        "offset": 1.0
+                      },
+                      {
+                        "color": "Color 2",
+                        "offset": 2.0
+                      }
+                    ],
                     "to": {
                       "x": 2.0,
                       "y": 2.0
                     }
                   },
                   "strokeWidth": 2.0,
-                  "type": "Type 2",
+                  "type": "draw-shape",
                   "width": 2.0
                 }
               ],
@@ -359,7 +397,12 @@
                   "anchor": {
                     "name": "anchor",
                     "required": false,
-                    "type": "object"
+                    "type": "string",
+                    "values": [
+                      "top-left",
+                      "ground",
+                      "center"
+                    ]
                   },
                   "animation": {
                     "name": "animation",
@@ -613,6 +656,18 @@
                       },
                       "stops": {
                         "items": {
+                          "properties": {
+                            "color": {
+                              "name": "color",
+                              "required": true,
+                              "type": "string"
+                            },
+                            "offset": {
+                              "name": "offset",
+                              "required": true,
+                              "type": "number"
+                            }
+                          },
                           "type": "object"
                         },
                         "name": "stops",
@@ -840,6 +895,18 @@
                       },
                       "stops": {
                         "items": {
+                          "properties": {
+                            "color": {
+                              "name": "color",
+                              "required": true,
+                              "type": "string"
+                            },
+                            "offset": {
+                              "name": "offset",
+                              "required": true,
+                              "type": "number"
+                            }
+                          },
                           "type": "object"
                         },
                         "name": "stops",
@@ -875,7 +942,10 @@
                   "type": {
                     "name": "type",
                     "required": true,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "draw-shape"
+                    ]
                   },
                   "width": {
                     "name": "width",

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

@@ -81,11 +81,16 @@
           "category": "interaction",
           "config": {
             "anchor": {
-              "default": {},
+              "default": "top-left",
               "description": "How the shape aligns to its projected position. Default varies by `shape`.",
               "label": "Anchor",
               "tier": "presentation",
-              "type": "object"
+              "type": "string",
+              "values": [
+                "top-left",
+                "ground",
+                "center"
+              ]
             },
             "animation": {
               "description": "Keyframe animation over this shape's props; the host runs a paint clock while present.",
@@ -347,6 +352,18 @@
                 },
                 "stops": {
                   "items": {
+                    "properties": {
+                      "color": {
+                        "name": "color",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "offset": {
+                        "name": "offset",
+                        "required": true,
+                        "type": "number"
+                      }
+                    },
                     "type": "object"
                   },
                   "name": "stops",
@@ -598,6 +615,18 @@
                 },
                 "stops": {
                   "items": {
+                    "properties": {
+                      "color": {
+                        "name": "color",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "offset": {
+                        "name": "offset",
+                        "required": true,
+                        "type": "number"
+                      }
+                    },
                     "type": "object"
                   },
                   "name": "stops",

package/behaviors/registry/ui/game/atoms/ui-draw-sprite-layer.orb

@@ -83,6 +83,7 @@
             "items": {
               "default": [
                 {
+                  "anchor": "top-left",
                   "animation": "Animation",
                   "asset": {
                     "animations": [
@@ -101,6 +102,7 @@
                     "thumbnailUrl": "",
                     "url": "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png"
                   },
+                  "clockMs": 1.0,
                   "flipX": false,
                   "frame": {
                     "h": 1.0,
@@ -121,10 +123,11 @@
                     "blur": 1.0,
                     "color": "Color"
                   },
-                  "type": "Type",
+                  "type": "draw-sprite",
                   "width": 1.0
                 },
                 {
+                  "anchor": "ground",
                   "animation": "Animation 2",
                   "asset": {
                     "animations": [
@@ -143,6 +146,7 @@
                     "thumbnailUrl": "",
                     "url": "https://almadar-kflow-assets.web.app/shared/ui-roguelike-board/default/units/player.png"
                   },
+                  "clockMs": 2.0,
                   "flipX": true,
                   "frame": {
                     "h": 2.0,
@@ -163,7 +167,7 @@
                     "blur": 2.0,
                     "color": "Color 2"
                   },
-                  "type": "Type 2",
+                  "type": "draw-sprite",
                   "width": 2.0
                 }
               ],
@@ -173,7 +177,12 @@
                   "anchor": {
                     "name": "anchor",
                     "required": false,
-                    "type": "object"
+                    "type": "string",
+                    "values": [
+                      "top-left",
+                      "ground",
+                      "center"
+                    ]
                   },
                   "animation": {
                     "name": "animation",
@@ -267,6 +276,11 @@
                     "required": true,
                     "type": "object"
                   },
+                  "clockMs": {
+                    "name": "clockMs",
+                    "required": false,
+                    "type": "number"
+                  },
                   "flipX": {
                     "name": "flipX",
                     "required": false,
@@ -361,7 +375,10 @@
                   "type": {
                     "name": "type",
                     "required": true,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "draw-sprite"
+                    ]
                   },
                   "width": {
                     "name": "width",

package/behaviors/registry/ui/game/atoms/ui-draw-sprite.orb

@@ -81,11 +81,16 @@
           "category": "interaction",
           "config": {
             "anchor": {
-              "default": {},
+              "default": "top-left",
               "description": "How the sprite aligns to its projected position. Default `'top-left'`.",
               "label": "Anchor",
               "tier": "presentation",
-              "type": "object"
+              "type": "string",
+              "values": [
+                "top-left",
+                "ground",
+                "center"
+              ]
             },
             "animation": {
               "description": "Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides.",
@@ -181,6 +186,12 @@
               "tier": "presentation",
               "type": "DrawSpriteAsset"
             },
+            "clockMs": {
+              "description": "Animation clock override in ms (e.g. an fx entry's age since spawn). Omitted → the host paint clock; one-shot rows anchored to wall-time would otherwise sit on their final frame.",
+              "label": "Clock Ms",
+              "tier": "presentation",
+              "type": "number"
+            },
             "flipX": {
               "description": "Mirror horizontally (facing).",
               "label": "Flip X",
@@ -329,6 +340,7 @@
                       "anchor": "@config.anchor",
                       "animation": "@config.animation",
                       "asset": "@config.asset",
+                      "clockMs": "@config.clockMs",
                       "flipX": "@config.flipX",
                       "frame": "@config.frame",
                       "height": "@config.height",

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

@@ -84,6 +84,7 @@
               "default": [
                 {
                   "align": "center",
+                  "anchor": "top-left",
                   "baseline": "alphabetic",
                   "color": "Color",
                   "font": "Font",
@@ -96,10 +97,11 @@
                     "z": 1.0
                   },
                   "text": "Text",
-                  "type": "Type"
+                  "type": "draw-text"
                 },
                 {
                   "align": "end",
+                  "anchor": "ground",
                   "baseline": "bottom",
                   "color": "Color 2",
                   "font": "Font 2",
@@ -112,7 +114,7 @@
                     "z": 2.0
                   },
                   "text": "Text 2",
-                  "type": "Type 2"
+                  "type": "draw-text"
                 }
               ],
               "description": "items prop",
@@ -133,7 +135,12 @@
                   "anchor": {
                     "name": "anchor",
                     "required": false,
-                    "type": "object"
+                    "type": "string",
+                    "values": [
+                      "top-left",
+                      "ground",
+                      "center"
+                    ]
                   },
                   "baseline": {
                     "name": "baseline",
@@ -203,7 +210,10 @@
                   "type": {
                     "name": "type",
                     "required": true,
-                    "type": "string"
+                    "type": "string",
+                    "values": [
+                      "draw-text"
+                    ]
                   }
                 },
                 "type": "object"

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

@@ -95,11 +95,16 @@
               ]
             },
             "anchor": {
-              "default": {},
+              "default": "top-left",
               "description": "anchor prop",
               "label": "Anchor",
               "tier": "presentation",
-              "type": "object"
+              "type": "string",
+              "values": [
+                "top-left",
+                "ground",
+                "center"
+              ]
             },
             "baseline": {
               "default": "alphabetic",

package/behaviors/registry/ui/game/atoms/ui-game-menu.orb

@@ -316,6 +316,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSelect",
               "description": "Called when an option is selected (legacy callback, prefer event bus)",
               "event": "@config.onSelect",
               "eventId": "evt_01M055GPBK52B1E6T4ZAHG6H8W",

package/behaviors/registry/ui/game/atoms/ui-sequence-bar.orb

@@ -221,7 +221,30 @@
                     "url": "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png"
                   },
                   "id": "Id",
-                  "name": "Name"
+                  "name": "Name",
+                  "stateMachine": {
+                    "currentState": "Current State",
+                    "description": "Description",
+                    "name": "Name",
+                    "states": [
+                      "Item",
+                      "Item 2"
+                    ],
+                    "transitions": [
+                      {
+                        "event": "Event",
+                        "from": "From",
+                        "guardHint": "Guard Hint",
+                        "to": "To"
+                      },
+                      {
+                        "event": "Event 2",
+                        "from": "From 2",
+                        "guardHint": "Guard Hint 2",
+                        "to": "To 2"
+                      }
+                    ]
+                  }
                 },
                 {
                   "category": "Category 2",
@@ -241,7 +264,30 @@
                     "url": "https://almadar-kflow-assets.web.app/shared/ui-battle-board/default/ui/star.png"
                   },
                   "id": "Id 2",
-                  "name": "Name 2"
+                  "name": "Name 2",
+                  "stateMachine": {
+                    "currentState": "Current State 2",
+                    "description": "Description 2",
+                    "name": "Name 2",
+                    "states": [
+                      "Item",
+                      "Item 2"
+                    ],
+                    "transitions": [
+                      {
+                        "event": "Event",
+                        "from": "From",
+                        "guardHint": "Guard Hint",
+                        "to": "To"
+                      },
+                      {
+                        "event": "Event 2",
+                        "from": "From 2",
+                        "guardHint": "Guard Hint 2",
+                        "to": "To 2"
+                      }
+                    ]
+                  }
                 }
               ],
               "description": "The current sequence (sparse — undefined means empty slot)",
@@ -361,6 +407,61 @@
                   },
                   "stateMachine": {
                     "name": "stateMachine",
+                    "properties": {
+                      "currentState": {
+                        "name": "currentState",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "description": {
+                        "name": "description",
+                        "required": false,
+                        "type": "string"
+                      },
+                      "name": {
+                        "name": "name",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "states": {
+                        "items": {
+                          "type": "string"
+                        },
+                        "name": "states",
+                        "required": true,
+                        "type": "array"
+                      },
+                      "transitions": {
+                        "items": {
+                          "properties": {
+                            "event": {
+                              "name": "event",
+                              "required": true,
+                              "type": "string"
+                            },
+                            "from": {
+                              "name": "from",
+                              "required": true,
+                              "type": "string"
+                            },
+                            "guardHint": {
+                              "name": "guardHint",
+                              "required": false,
+                              "type": "string"
+                            },
+                            "to": {
+                              "name": "to",
+                              "required": true,
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "name": "transitions",
+                        "required": true,
+                        "type": "array"
+                      }
+                    },
                     "required": false,
                     "type": "object"
                   }
@@ -374,6 +475,7 @@
           },
           "emits": [
             {
+              "definerKnob": "onSlotDrop",
               "description": "Called when an item is dropped into slot at index (callback path)",
               "event": "@config.onSlotDrop",
               "eventId": "evt_01M055GPE1C8HDYAHYQH55SD2Z",
@@ -467,6 +569,53 @@
                     },
                     {
                       "name": "stateMachine",
+                      "properties": [
+                        {
+                          "name": "name",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "states",
+                          "required": true,
+                          "type": "[string]"
+                        },
+                        {
+                          "name": "currentState",
+                          "required": true,
+                          "type": "string"
+                        },
+                        {
+                          "name": "transitions",
+                          "properties": [
+                            {
+                              "name": "from",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "to",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "event",
+                              "required": true,
+                              "type": "string"
+                            },
+                            {
+                              "name": "guardHint",
+                              "type": "string"
+                            }
+                          ],
+                          "required": true,
+                          "type": "[object]"
+                        },
+                        {
+                          "name": "description",
+                          "type": "string"
+                        }
+                      ],
                       "type": "object"
                     }
                   ],
@@ -487,6 +636,7 @@
               "tier": "essential"
             },
             {
+              "definerKnob": "onSlotRemove",
               "description": "Called when a slot is cleared (callback path)",
               "event": "@config.onSlotRemove",
               "eventId": "evt_01M055GPE1FWNY4QX2WEPFAZQS",
@@ -620,6 +770,53 @@
                       },
                       {
                         "name": "stateMachine",
+                        "properties": [
+                          {
+                            "name": "name",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "states",
+                            "required": true,
+                            "type": "[string]"
+                          },
+                          {
+                            "name": "currentState",
+                            "required": true,
+                            "type": "string"
+                          },
+                          {
+                            "name": "transitions",
+                            "properties": [
+                              {
+                                "name": "from",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "to",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "event",
+                                "required": true,
+                                "type": "string"
+                              },
+                              {
+                                "name": "guardHint",
+                                "type": "string"
+                              }
+                            ],
+                            "required": true,
+                            "type": "[object]"
+                          },
+                          {
+                            "name": "description",
+                            "type": "string"
+                          }
+                        ],
                         "type": "object"
                       }
                     ],