@almadar/std 16.233.0 → 16.235.0

package/behaviors/registry/ui/core/organisms/ui-state-machine-view.orb

@@ -19,6 +19,24 @@
         "parent": "trt_01KXG04T1T06NK46N3XNS6A39R",
         "renames": []
       },
+      "evt_01M3M10FFMFFZ8ARQA8JP84FYC": {
+        "bakedName": "@config.transitionClickEvent",
+        "curName": "@config.transitionClickEvent",
+        "id": "evt_01M3M10FFMFFZ8ARQA8JP84FYC",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04T1T06NK46N3XNS6A39R",
+        "renames": []
+      },
+      "evt_01M3M10FFMVZ9WJ687ACZPMT6M": {
+        "bakedName": "@config.stateClickEvent",
+        "curName": "@config.stateClickEvent",
+        "id": "evt_01M3M10FFMVZ9WJ687ACZPMT6M",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04T1T06NK46N3XNS6A39R",
+        "renames": []
+      },
       "orb_01KXG04T1T79Z22NYF26EFB081": {
         "bakedName": "StateMachineViewOrbital",
         "curName": "StateMachineViewOrbital",
@@ -80,12 +98,45 @@
         {
           "category": "interaction",
           "config": {
+            "activeState": {
+              "description": "State execution is currently in.",
+              "label": "Active State",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "activeTransition": {
+              "description": "`index` of the transition that just fired.",
+              "label": "Active Transition",
+              "tier": "presentation",
+              "type": "number"
+            },
             "className": {
-              "description": "Additional CSS classes",
+              "description": "className prop",
               "label": "Class Name",
               "tier": "presentation",
               "type": "string"
             },
+            "direction": {
+              "default": "ltr",
+              "description": "Flow direction. @default 'ltr'",
+              "label": "Direction",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "ltr",
+                "rtl"
+              ]
+            },
+            "entityFields": {
+              "default": [],
+              "description": "Entity field names listed in the header.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Entity Fields",
+              "tier": "presentation",
+              "type": "[string]"
+            },
             "error": {
               "description": "Error state",
               "label": "Error",
@@ -115,10 +166,182 @@
               "type": "StateMachineViewError"
             },
             "isLoading": {
+              "default": false,
               "description": "Loading state indicator",
               "label": "Is Loading",
               "tier": "presentation",
               "type": "boolean"
+            },
+            "nodeShape": {
+              "default": "pill",
+              "description": "Node silhouette. @default 'pill'",
+              "label": "Node Shape",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "pill",
+                "gear"
+              ]
+            },
+            "pendingSourceState": {
+              "description": "Source of a transition being drawn — the next state click picks its target.",
+              "label": "Pending Source State",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "selectedState": {
+              "description": "State picked in an editor (first click).",
+              "label": "Selected State",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "showHeader": {
+              "description": "Show the trait header (name, entity, listens/emits). @default true",
+              "label": "Show Header",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "stateClickEvent": {
+              "default": "STATE_CLICK",
+              "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+              "label": "State Click Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "traitProp": {
+              "description": "The trait to draw (see `parseTraitLevel` / `traitLevelFromTrait`).",
+              "label": "Trait",
+              "properties": {
+                "emittedEvents": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "emittedEvents",
+                  "required": true,
+                  "type": "array"
+                },
+                "linkedEntity": {
+                  "name": "linkedEntity",
+                  "required": true,
+                  "type": "string"
+                },
+                "listenedEvents": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "name": "listenedEvents",
+                  "required": true,
+                  "type": "array"
+                },
+                "name": {
+                  "name": "name",
+                  "required": true,
+                  "type": "string"
+                },
+                "states": {
+                  "items": {
+                    "properties": {
+                      "isInitial": {
+                        "name": "isInitial",
+                        "required": false,
+                        "type": "boolean"
+                      },
+                      "isTerminal": {
+                        "name": "isTerminal",
+                        "required": false,
+                        "type": "boolean"
+                      },
+                      "name": {
+                        "name": "name",
+                        "required": true,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "states",
+                  "required": true,
+                  "type": "array"
+                },
+                "transitions": {
+                  "items": {
+                    "properties": {
+                      "effects": {
+                        "items": {
+                          "properties": {
+                            "args": {
+                              "items": {
+                                "type": "object"
+                              },
+                              "name": "args",
+                              "required": true,
+                              "type": "array"
+                            },
+                            "type": {
+                              "name": "type",
+                              "required": true,
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        },
+                        "name": "effects",
+                        "required": true,
+                        "type": "array"
+                      },
+                      "event": {
+                        "name": "event",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "from": {
+                        "name": "from",
+                        "required": true,
+                        "type": "string"
+                      },
+                      "guard": {
+                        "name": "guard",
+                        "required": false,
+                        "type": "object"
+                      },
+                      "index": {
+                        "name": "index",
+                        "required": true,
+                        "type": "number"
+                      },
+                      "to": {
+                        "name": "to",
+                        "required": true,
+                        "type": "string"
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "name": "transitions",
+                  "required": true,
+                  "type": "array"
+                }
+              },
+              "synonyms": "trait",
+              "tier": "presentation",
+              "type": "StateMachineViewTrait"
+            },
+            "transitionClickEvent": {
+              "default": "TRANSITION_CLICK",
+              "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+              "label": "Transition Click Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "visitedStates": {
+              "default": [],
+              "description": "States already passed through, in order.",
+              "items": {
+                "type": "string"
+              },
+              "label": "Visited States",
+              "tier": "presentation",
+              "type": "[string]"
             }
           },
           "effectRow": [
@@ -127,6 +350,53 @@
               "resource": "main"
             }
           ],
+          "emits": [
+            {
+              "definerKnob": "stateClickEvent",
+              "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+              "event": "@config.stateClickEvent",
+              "eventId": "evt_01M3M10FFMVZ9WJ687ACZPMT6M",
+              "payloadSchema": [
+                {
+                  "name": "stateId",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "transitionClickEvent",
+              "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+              "event": "@config.transitionClickEvent",
+              "eventId": "evt_01M3M10FFMFFZ8ARQA8JP84FYC",
+              "payloadSchema": [
+                {
+                  "name": "index",
+                  "required": true,
+                  "type": "number"
+                },
+                {
+                  "name": "event",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "from",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "to",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
             "provides": [],
             "requires": []
@@ -146,6 +416,49 @@
                 "id": "evt_01KXG04T1TMWAASNMASVKJGGM0",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+                "id": "evt_01M3M10FFMVZ9WJ687ACZPMT6M",
+                "key": "@config.stateClickEvent",
+                "name": "@config.state click event",
+                "payloadSchema": [
+                  {
+                    "name": "stateId",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+                "id": "evt_01M3M10FFMFFZ8ARQA8JP84FYC",
+                "key": "@config.transitionClickEvent",
+                "name": "@config.transition click event",
+                "payloadSchema": [
+                  {
+                    "name": "index",
+                    "required": true,
+                    "type": "number"
+                  },
+                  {
+                    "name": "event",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "from",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "to",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -161,10 +474,22 @@
                     "render-ui",
                     "main",
                     {
+                      "activeState": "@config.activeState",
+                      "activeTransition": "@config.activeTransition",
                       "className": "@config.className",
+                      "direction": "@config.direction",
+                      "entityFields": "@config.entityFields",
                       "error": "@config.error",
                       "isLoading": "@config.isLoading",
-                      "type": "state-machine-view"
+                      "nodeShape": "@config.nodeShape",
+                      "pendingSourceState": "@config.pendingSourceState",
+                      "selectedState": "@config.selectedState",
+                      "showHeader": "@config.showHeader",
+                      "stateClickEvent": "@config.stateClickEvent",
+                      "trait": "@config.traitProp",
+                      "transitionClickEvent": "@config.transitionClickEvent",
+                      "type": "state-machine-view",
+                      "visitedStates": "@config.visitedStates"
                     }
                   ]
                 ],
@@ -196,6 +521,166 @@
             "name": "stack",
             "type": "string"
           }
+        ],
+        "StateMachineViewTrait": [
+          {
+            "name": "name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "linkedEntity",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "states",
+            "properties": [
+              {
+                "name": "name",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "isInitial",
+                "type": "boolean"
+              },
+              {
+                "name": "isTerminal",
+                "type": "boolean"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          },
+          {
+            "name": "transitions",
+            "properties": [
+              {
+                "name": "from",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "to",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "event",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "guard",
+                "type": "SExpr"
+              },
+              {
+                "name": "effects",
+                "properties": [
+                  {
+                    "name": "type",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "args",
+                    "required": true,
+                    "type": "[SExpr]"
+                  }
+                ],
+                "required": true,
+                "type": "[object]"
+              },
+              {
+                "name": "index",
+                "required": true,
+                "type": "number"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          },
+          {
+            "name": "emittedEvents",
+            "required": true,
+            "type": "[string]"
+          },
+          {
+            "name": "listenedEvents",
+            "required": true,
+            "type": "[string]"
+          }
+        ],
+        "StateMachineViewTraitStatesItem": [
+          {
+            "name": "name",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "isInitial",
+            "type": "boolean"
+          },
+          {
+            "name": "isTerminal",
+            "type": "boolean"
+          }
+        ],
+        "StateMachineViewTraitTransitionsItem": [
+          {
+            "name": "from",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "to",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "event",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "guard",
+            "type": "SExpr"
+          },
+          {
+            "name": "effects",
+            "properties": [
+              {
+                "name": "type",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "args",
+                "required": true,
+                "type": "[SExpr]"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          },
+          {
+            "name": "index",
+            "required": true,
+            "type": "number"
+          }
+        ],
+        "StateMachineViewTraitTransitionsItemEffectsItem": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "args",
+            "required": true,
+            "type": "[SExpr]"
+          }
         ]
       }
     }

package/behaviors/registry/ui/game/atoms/ui-draw-skinned-mesh.orb

@@ -208,7 +208,7 @@
                   },
                   "parent": {
                     "name": "parent",
-                    "required": true,
+                    "required": false,
                     "type": "string"
                   },
                   "pivot": {
@@ -538,7 +538,6 @@
           },
           {
             "name": "parent",
-            "required": true,
             "type": "string"
           },
           {