@almadar/std 16.233.0 → 16.235.0

package/behaviors/behaviors-registry.json

@@ -1,13 +1,13 @@
 {
-  "$generated": "2026-09-27T12:53:28.059Z",
+  "$generated": "2026-09-28T12:50:01.615Z",
   "$source": "tools/almadar-pattern-sync/behaviors",
   "$package": "@almadar/std",
-  "totalBehaviors": 440,
-  "atoms": 281,
+  "totalBehaviors": 442,
+  "atoms": 283,
   "molecules": 119,
   "organisms": 40,
   "layers": {
-    "UI Patterns": 427,
+    "UI Patterns": 429,
     "ML": 13
   },
   "behaviors": {
@@ -20425,6 +20425,684 @@
         "reactor"
       ]
     },
+    "ui-avl-glyph": {
+      "name": "ui-avl-glyph",
+      "level": "atom",
+      "topic": "ui/avl",
+      "family": "ui/avl",
+      "layer": "UI Patterns",
+      "description": "AvlGlyph — UI factory (1:1 with the @almadar/ui avl-glyph pattern).",
+      "defaultOrbitalName": "AvlGlyphOrbital",
+      "statePattern": "idle",
+      "complexity": {
+        "states": 1,
+        "events": 1,
+        "transitions": 1
+      },
+      "defaultEntity": {
+        "name": "AvlGlyphItem",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          }
+        ]
+      },
+      "defaultLabels": {
+        "title": "AvlGlyphItems",
+        "entitySingular": "AvlGlyphItem",
+        "entityPlural": "AvlGlyphItems"
+      },
+      "defaultIcons": [],
+      "composableWith": [
+        "std-integration-settings",
+        "std-service-accounting",
+        "std-service-arxiv",
+        "std-service-banking",
+        "std-service-calendar",
+        "std-service-calendar-ical",
+        "std-service-cli",
+        "std-service-custom-bearer",
+        "std-service-database",
+        "std-service-deepagent",
+        "std-service-docker",
+        "std-service-drive",
+        "std-service-email",
+        "std-service-esign",
+        "std-service-github",
+        "std-service-iconify",
+        "std-service-llm",
+        "std-service-maps",
+        "std-service-marketplace",
+        "std-service-meta-ads",
+        "std-service-ml",
+        "std-service-oauth",
+        "std-service-otel",
+        "std-service-print",
+        "std-service-push",
+        "std-service-queue",
+        "std-service-redis",
+        "std-service-research-assistant",
+        "std-service-storage",
+        "std-service-stripe",
+        "std-service-twilio",
+        "std-service-webhook",
+        "std-service-wikimedia",
+        "std-service-youtube",
+        "ui-avl-state-machine",
+        "ui-behavior-view",
+        "ui-module-card"
+      ],
+      "connectableEvents": [],
+      "eventPayloads": {},
+      "exposure": "palette",
+      "provenance": "generated",
+      "pattern": "avl-glyph",
+      "traits": [
+        {
+          "name": "AvlGlyphRender",
+          "orbital": "AvlGlyphOrbital",
+          "role": "renderer",
+          "emittedEvents": [],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "className",
+              "type": "string",
+              "label": "Class Name",
+              "description": "className prop",
+              "tier": "presentation"
+            },
+            {
+              "key": "effectType",
+              "type": "string",
+              "label": "Effect Type",
+              "description": "Effect symbol variant. @default 'set'",
+              "tier": "presentation"
+            },
+            {
+              "key": "kind",
+              "type": "string",
+              "default": "@state",
+              "label": "Kind",
+              "description": "Which notation symbol to draw.",
+              "tier": "presentation",
+              "enumValues": [
+                "application",
+                "orbital",
+                "entity",
+                "trait",
+                "page",
+                "state",
+                "transition",
+                "event",
+                "guard",
+                "effect",
+                "field",
+                "fieldType",
+                "binding",
+                "bindingRef",
+                "persistence",
+                "operator",
+                "sexpr",
+                "literal"
+              ]
+            },
+            {
+              "key": "label",
+              "type": "string",
+              "label": "Label",
+              "description": "Caption, and the drawn text for operator / literal / bindingRef symbols.",
+              "tier": "presentation"
+            },
+            {
+              "key": "showCaption",
+              "type": "boolean",
+              "default": true,
+              "label": "Show Caption",
+              "description": "Show the caption under the symbol. @default true",
+              "tier": "presentation"
+            },
+            {
+              "key": "size",
+              "type": "string",
+              "default": "md",
+              "label": "Size",
+              "description": "Symbol height. @default 'md'",
+              "tier": "presentation",
+              "enumValues": [
+                "sm",
+                "md",
+                "lg"
+              ]
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "interaction",
+          "entityRebindable": true,
+          "linkedEntity": "AvlGlyphItem",
+          "entityContract": {
+            "requires": [],
+            "provides": []
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "transitionEvents": [
+            "INIT"
+          ],
+          "events": [
+            {
+              "name": "INIT",
+              "direction": "listen"
+            }
+          ],
+          "definerKnobs": []
+        }
+      ],
+      "factoryPath": "behaviors/functions/ui/avl/atoms/ui-avl-glyph.ts",
+      "roles": [
+        "renderer"
+      ],
+      "sourceValid": true
+    },
+    "ui-avl-state-machine": {
+      "name": "ui-avl-state-machine",
+      "level": "atom",
+      "topic": "ui/avl",
+      "family": "ui/avl",
+      "layer": "UI Patterns",
+      "description": "AvlStateMachine — UI factory (1:1 with the @almadar/ui avl-state-machine pattern).",
+      "defaultOrbitalName": "AvlStateMachineOrbital",
+      "statePattern": "idle",
+      "complexity": {
+        "states": 1,
+        "events": 3,
+        "transitions": 1
+      },
+      "defaultEntity": {
+        "name": "AvlStateMachineItem",
+        "persistence": "runtime",
+        "fields": [
+          {
+            "name": "id",
+            "type": "string",
+            "required": true
+          }
+        ]
+      },
+      "defaultLabels": {
+        "title": "AvlStateMachineItems",
+        "entitySingular": "AvlStateMachineItem",
+        "entityPlural": "AvlStateMachineItems"
+      },
+      "defaultIcons": [],
+      "composableWith": [
+        "std-integration-settings",
+        "std-service-accounting",
+        "std-service-arxiv",
+        "std-service-banking",
+        "std-service-calendar",
+        "std-service-calendar-ical",
+        "std-service-cli",
+        "std-service-custom-bearer",
+        "std-service-database",
+        "std-service-deepagent",
+        "std-service-docker",
+        "std-service-drive",
+        "std-service-email",
+        "std-service-esign",
+        "std-service-github",
+        "std-service-iconify",
+        "std-service-llm",
+        "std-service-maps",
+        "std-service-marketplace",
+        "std-service-meta-ads",
+        "std-service-ml",
+        "std-service-oauth",
+        "std-service-otel",
+        "std-service-print",
+        "std-service-push",
+        "std-service-queue",
+        "std-service-redis",
+        "std-service-research-assistant",
+        "std-service-storage",
+        "std-service-stripe",
+        "std-service-twilio",
+        "std-service-webhook",
+        "std-service-wikimedia",
+        "std-service-youtube",
+        "ui-avl-glyph",
+        "ui-behavior-view",
+        "ui-module-card",
+        "ui-state-machine-view"
+      ],
+      "connectableEvents": [
+        "@config.stateClickEvent",
+        "@config.transitionClickEvent"
+      ],
+      "eventPayloads": {},
+      "exposure": "palette",
+      "provenance": "generated",
+      "pattern": "avl-state-machine",
+      "traits": [
+        {
+          "name": "AvlStateMachineRender",
+          "orbital": "AvlStateMachineOrbital",
+          "role": "renderer",
+          "emittedEvents": [
+            "STATE_CLICK",
+            "TRANSITION_CLICK"
+          ],
+          "listenedEvents": [],
+          "overridableConfigKeys": [
+            {
+              "key": "activeState",
+              "type": "string",
+              "label": "Active State",
+              "description": "State execution is currently in.",
+              "tier": "presentation"
+            },
+            {
+              "key": "activeTransition",
+              "type": "number",
+              "label": "Active Transition",
+              "description": "`index` of the transition that just fired.",
+              "tier": "presentation"
+            },
+            {
+              "key": "className",
+              "type": "string",
+              "label": "Class Name",
+              "description": "className prop",
+              "tier": "presentation"
+            },
+            {
+              "key": "direction",
+              "type": "string",
+              "default": "ltr",
+              "label": "Direction",
+              "description": "Flow direction. @default 'ltr'",
+              "tier": "presentation",
+              "enumValues": [
+                "ltr",
+                "rtl"
+              ]
+            },
+            {
+              "key": "entityFields",
+              "type": "[string]",
+              "default": [],
+              "label": "Entity Fields",
+              "description": "Entity field names listed in the header.",
+              "tier": "presentation",
+              "items": {
+                "type": "string"
+              }
+            },
+            {
+              "key": "nodeShape",
+              "type": "string",
+              "default": "pill",
+              "label": "Node Shape",
+              "description": "Node silhouette. @default 'pill'",
+              "tier": "presentation",
+              "enumValues": [
+                "pill",
+                "gear"
+              ]
+            },
+            {
+              "key": "pendingSourceState",
+              "type": "string",
+              "label": "Pending Source State",
+              "description": "Source of a transition being drawn — the next state click picks its target.",
+              "tier": "presentation"
+            },
+            {
+              "key": "selectedState",
+              "type": "string",
+              "label": "Selected State",
+              "description": "State picked in an editor (first click).",
+              "tier": "presentation"
+            },
+            {
+              "key": "showHeader",
+              "type": "boolean",
+              "default": true,
+              "label": "Show Header",
+              "description": "Show the trait header (name, entity, listens/emits). @default true",
+              "tier": "presentation"
+            },
+            {
+              "key": "stateClickEvent",
+              "type": "event",
+              "default": "STATE_CLICK",
+              "label": "State Click Event",
+              "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+              "tier": "presentation"
+            },
+            {
+              "key": "traitProp",
+              "type": "AvlStateMachineTrait",
+              "default": {
+                "emittedEvents": [
+                  "ORDER_SAVED"
+                ],
+                "linkedEntity": "Order",
+                "listenedEvents": [
+                  "PAYMENT_OK"
+                ],
+                "name": "OrderFlow",
+                "states": [
+                  {
+                    "isInitial": true,
+                    "isTerminal": false,
+                    "name": "browsing"
+                  },
+                  {
+                    "isInitial": false,
+                    "isTerminal": false,
+                    "name": "editing"
+                  },
+                  {
+                    "isInitial": false,
+                    "isTerminal": false,
+                    "name": "saving"
+                  },
+                  {
+                    "isInitial": false,
+                    "isTerminal": true,
+                    "name": "confirmed"
+                  },
+                  {
+                    "isInitial": false,
+                    "isTerminal": false,
+                    "name": "failed"
+                  }
+                ],
+                "transitions": [
+                  {
+                    "effects": [
+                      {
+                        "args": [],
+                        "type": "render-ui"
+                      }
+                    ],
+                    "event": "EDIT",
+                    "from": "browsing",
+                    "index": 0,
+                    "to": "editing"
+                  },
+                  {
+                    "effects": [
+                      {
+                        "args": [],
+                        "type": "persist"
+                      },
+                      {
+                        "args": [],
+                        "type": "notify"
+                      }
+                    ],
+                    "event": "SAVE",
+                    "from": "editing",
+                    "index": 1,
+                    "to": "saving"
+                  },
+                  {
+                    "effects": [
+                      {
+                        "args": [],
+                        "type": "emit"
+                      },
+                      {
+                        "args": [],
+                        "type": "render-ui"
+                      }
+                    ],
+                    "event": "SAVED",
+                    "from": "saving",
+                    "index": 2,
+                    "to": "confirmed"
+                  },
+                  {
+                    "effects": [
+                      {
+                        "args": [],
+                        "type": "notify"
+                      }
+                    ],
+                    "event": "SAVE_FAILED",
+                    "from": "saving",
+                    "index": 3,
+                    "to": "failed"
+                  },
+                  {
+                    "effects": [],
+                    "event": "RETRY",
+                    "from": "failed",
+                    "index": 4,
+                    "to": "editing"
+                  },
+                  {
+                    "effects": [
+                      {
+                        "args": [],
+                        "type": "render-ui"
+                      }
+                    ],
+                    "event": "CANCEL",
+                    "from": "editing",
+                    "index": 5,
+                    "to": "browsing"
+                  },
+                  {
+                    "effects": [
+                      {
+                        "args": [],
+                        "type": "navigate"
+                      }
+                    ],
+                    "event": "DONE",
+                    "from": "confirmed",
+                    "index": 6,
+                    "to": "browsing"
+                  }
+                ]
+              },
+              "label": "Trait",
+              "description": "The trait to draw (see `parseTraitLevel`).",
+              "synonyms": "trait",
+              "tier": "presentation",
+              "properties": {
+                "emittedEvents": {
+                  "name": "emittedEvents",
+                  "required": true,
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "linkedEntity": {
+                  "name": "linkedEntity",
+                  "required": true,
+                  "type": "string"
+                },
+                "listenedEvents": {
+                  "name": "listenedEvents",
+                  "required": true,
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "name": {
+                  "name": "name",
+                  "required": true,
+                  "type": "string"
+                },
+                "states": {
+                  "name": "states",
+                  "required": true,
+                  "type": "array",
+                  "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"
+                  }
+                },
+                "transitions": {
+                  "name": "transitions",
+                  "required": true,
+                  "type": "array",
+                  "items": {
+                    "properties": {
+                      "effects": {
+                        "name": "effects",
+                        "required": true,
+                        "type": "array",
+                        "items": {
+                          "properties": {
+                            "args": {
+                              "name": "args",
+                              "required": true,
+                              "type": "array",
+                              "items": {
+                                "type": "object"
+                              }
+                            },
+                            "type": {
+                              "name": "type",
+                              "required": true,
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "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"
+                  }
+                }
+              }
+            },
+            {
+              "key": "transitionClickEvent",
+              "type": "event",
+              "default": "TRANSITION_CLICK",
+              "label": "Transition Click Event",
+              "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+              "tier": "presentation"
+            },
+            {
+              "key": "visitedStates",
+              "type": "[string]",
+              "default": [],
+              "label": "Visited States",
+              "description": "States already passed through, in order.",
+              "tier": "presentation",
+              "items": {
+                "type": "string"
+              }
+            }
+          ],
+          "capabilities": [],
+          "ticks": [],
+          "rendersUi": true,
+          "category": "interaction",
+          "entityRebindable": true,
+          "linkedEntity": "AvlStateMachineItem",
+          "entityContract": {
+            "requires": [],
+            "provides": []
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "transitionEvents": [
+            "INIT"
+          ],
+          "events": [
+            {
+              "name": "STATE_CLICK",
+              "direction": "emit",
+              "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+              "tier": "essential"
+            },
+            {
+              "name": "TRANSITION_CLICK",
+              "direction": "emit",
+              "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+              "tier": "essential"
+            },
+            {
+              "name": "INIT",
+              "direction": "listen"
+            }
+          ],
+          "definerKnobs": [
+            "stateClickEvent",
+            "transitionClickEvent"
+          ]
+        }
+      ],
+      "factoryPath": "behaviors/functions/ui/avl/atoms/ui-avl-state-machine.ts",
+      "roles": [
+        "renderer"
+      ],
+      "sourceValid": true
+    },
     "ui-behavior-view": {
       "name": "ui-behavior-view",
       "level": "atom",
@@ -20491,6 +21169,8 @@
         "std-service-webhook",
         "std-service-wikimedia",
         "std-service-youtube",
+        "ui-avl-glyph",
+        "ui-avl-state-machine",
         "ui-module-card"
       ],
       "connectableEvents": [],
@@ -20510,81 +21190,188 @@
               "key": "data",
               "type": "BehaviorViewData",
               "default": {
-                "entityName": "Entity Name",
+                "entityName": "Order",
                 "externalLinks": [
                   {
-                    "direction": "Direction",
-                    "eventName": "Event Name",
-                    "targetOrbital": "Target Orbital",
-                    "traitName": "Trait Name"
-                  },
-                  {
-                    "direction": "Direction 2",
-                    "eventName": "Event Name 2",
-                    "targetOrbital": "Target Orbital 2",
-                    "traitName": "Trait Name 2"
+                    "direction": "in",
+                    "eventName": "PAYMENT_OK",
+                    "targetOrbital": "PaymentOrbital",
+                    "traitName": "OrderFlow"
                   }
                 ],
                 "fields": [
                   {
                     "hasDefault": false,
-                    "name": "Name",
-                    "required": false,
-                    "type": "Type"
+                    "name": "customer",
+                    "required": true,
+                    "type": "string"
                   },
                   {
                     "hasDefault": true,
-                    "name": "Name 2",
+                    "name": "qty",
                     "required": true,
-                    "type": "Type 2"
+                    "type": "number"
+                  },
+                  {
+                    "hasDefault": true,
+                    "name": "status",
+                    "required": false,
+                    "type": "string"
                   }
                 ],
-                "orbitalName": "Orbital Name",
+                "orbitalName": "OrderOrbital",
                 "pages": [
                   {
-                    "name": "Name",
-                    "route": "Route"
-                  },
-                  {
-                    "name": "Name 2",
-                    "route": "Route 2"
+                    "name": "Orders",
+                    "route": "/orders"
                   }
                 ],
-                "persistence": "Persistence",
-                "traitDetails": {},
-                "traits": [
-                  {
-                    "emits": [
-                      "Item",
-                      "Item 2"
+                "persistence": "persistent",
+                "traitDetails": {
+                  "OrderFlow": {
+                    "emittedEvents": [
+                      "ORDER_SAVED"
                     ],
-                    "eventCount": 1,
-                    "listens": [
-                      "Item",
-                      "Item 2"
+                    "linkedEntity": "Order",
+                    "listenedEvents": [
+                      "PAYMENT_OK"
                     ],
-                    "name": "Name",
-                    "stateCount": 1,
-                    "transitionCount": 1
-                  },
+                    "name": "OrderFlow",
+                    "states": [
+                      {
+                        "isInitial": true,
+                        "isTerminal": false,
+                        "name": "browsing"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": false,
+                        "name": "editing"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": false,
+                        "name": "saving"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": true,
+                        "name": "confirmed"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": false,
+                        "name": "failed"
+                      }
+                    ],
+                    "transitions": [
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "render-ui"
+                          }
+                        ],
+                        "event": "EDIT",
+                        "from": "browsing",
+                        "index": 0,
+                        "to": "editing"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "persist"
+                          },
+                          {
+                            "args": [],
+                            "type": "notify"
+                          }
+                        ],
+                        "event": "SAVE",
+                        "from": "editing",
+                        "index": 1,
+                        "to": "saving"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "emit"
+                          },
+                          {
+                            "args": [],
+                            "type": "render-ui"
+                          }
+                        ],
+                        "event": "SAVED",
+                        "from": "saving",
+                        "index": 2,
+                        "to": "confirmed"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "notify"
+                          }
+                        ],
+                        "event": "SAVE_FAILED",
+                        "from": "saving",
+                        "index": 3,
+                        "to": "failed"
+                      },
+                      {
+                        "effects": [],
+                        "event": "RETRY",
+                        "from": "failed",
+                        "index": 4,
+                        "to": "editing"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "render-ui"
+                          }
+                        ],
+                        "event": "CANCEL",
+                        "from": "editing",
+                        "index": 5,
+                        "to": "browsing"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "navigate"
+                          }
+                        ],
+                        "event": "DONE",
+                        "from": "confirmed",
+                        "index": 6,
+                        "to": "browsing"
+                      }
+                    ]
+                  }
+                },
+                "traits": [
                   {
                     "emits": [
-                      "Item",
-                      "Item 2"
+                      "ORDER_SAVED"
                     ],
-                    "eventCount": 2,
+                    "eventCount": 7,
                     "listens": [
-                      "Item",
-                      "Item 2"
+                      "PAYMENT_OK"
                     ],
-                    "name": "Name 2",
-                    "stateCount": 2,
-                    "transitionCount": 2
+                    "name": "OrderFlow",
+                    "stateCount": 5,
+                    "transitionCount": 7
                   }
                 ]
               },
               "label": "Data",
-              "description": "data prop",
+              "description": "The orbital to summarize.",
               "tier": "presentation",
               "properties": {
                 "entityName": {
@@ -20677,11 +21464,6 @@
                     "type": "object"
                   }
                 },
-                "persistence": {
-                  "name": "persistence",
-                  "required": true,
-                  "type": "string"
-                },
                 "traitDetails": {
                   "name": "traitDetails",
                   "required": true,
@@ -20722,12 +21504,12 @@
                           "properties": {
                             "isInitial": {
                               "name": "isInitial",
-                              "required": true,
+                              "required": false,
                               "type": "boolean"
                             },
                             "isTerminal": {
                               "name": "isTerminal",
-                              "required": true,
+                              "required": false,
                               "type": "boolean"
                             },
                             "name": {
@@ -20780,7 +21562,7 @@
                             },
                             "guard": {
                               "name": "guard",
-                              "required": true,
+                              "required": false,
                               "type": "object"
                             },
                             "index": {
@@ -20890,7 +21672,7 @@
       "topic": "ui/avl",
       "family": "ui/avl",
       "layer": "UI Patterns",
-      "description": "ModuleCard — a card summarizing one course module or lesson with progress and entry point. — UI factory (1:1 with the @almadar/ui module-card pattern).",
+      "description": "ModuleCard — a compact summary card for one orbital module: its entity and fields, a mini state machine per trait, and its pages. — UI factory (1:1 with the @almadar/ui module-card pattern).",
       "defaultOrbitalName": "ModuleCardOrbital",
       "statePattern": "idle",
       "complexity": {
@@ -20950,13 +21732,15 @@
         "std-service-webhook",
         "std-service-wikimedia",
         "std-service-youtube",
+        "ui-avl-glyph",
+        "ui-avl-state-machine",
         "ui-behavior-view"
       ],
       "connectableEvents": [],
       "eventPayloads": {},
       "exposure": "palette",
       "provenance": "generated",
-      "capabilities": "course module card, lesson card, curriculum unit card, learning-path step card",
+      "capabilities": "orbital module summary card, entity and trait overview card, app architecture node card",
       "pattern": "module-card",
       "traits": [
         {
@@ -20970,81 +21754,188 @@
               "key": "data",
               "type": "ModuleCardData",
               "default": {
-                "entityName": "Entity Name",
+                "entityName": "Order",
                 "externalLinks": [
                   {
-                    "direction": "Direction",
-                    "eventName": "Event Name",
-                    "targetOrbital": "Target Orbital",
-                    "traitName": "Trait Name"
-                  },
-                  {
-                    "direction": "Direction 2",
-                    "eventName": "Event Name 2",
-                    "targetOrbital": "Target Orbital 2",
-                    "traitName": "Trait Name 2"
+                    "direction": "in",
+                    "eventName": "PAYMENT_OK",
+                    "targetOrbital": "PaymentOrbital",
+                    "traitName": "OrderFlow"
                   }
                 ],
                 "fields": [
                   {
                     "hasDefault": false,
-                    "name": "Name",
-                    "required": false,
-                    "type": "Type"
+                    "name": "customer",
+                    "required": true,
+                    "type": "string"
                   },
                   {
                     "hasDefault": true,
-                    "name": "Name 2",
+                    "name": "qty",
                     "required": true,
-                    "type": "Type 2"
+                    "type": "number"
+                  },
+                  {
+                    "hasDefault": true,
+                    "name": "status",
+                    "required": false,
+                    "type": "string"
                   }
                 ],
-                "orbitalName": "Orbital Name",
+                "orbitalName": "OrderOrbital",
                 "pages": [
                   {
-                    "name": "Name",
-                    "route": "Route"
-                  },
-                  {
-                    "name": "Name 2",
-                    "route": "Route 2"
+                    "name": "Orders",
+                    "route": "/orders"
                   }
                 ],
-                "persistence": "Persistence",
-                "traitDetails": {},
-                "traits": [
-                  {
-                    "emits": [
-                      "Item",
-                      "Item 2"
+                "persistence": "persistent",
+                "traitDetails": {
+                  "OrderFlow": {
+                    "emittedEvents": [
+                      "ORDER_SAVED"
                     ],
-                    "eventCount": 1,
-                    "listens": [
-                      "Item",
-                      "Item 2"
+                    "linkedEntity": "Order",
+                    "listenedEvents": [
+                      "PAYMENT_OK"
                     ],
-                    "name": "Name",
-                    "stateCount": 1,
-                    "transitionCount": 1
-                  },
+                    "name": "OrderFlow",
+                    "states": [
+                      {
+                        "isInitial": true,
+                        "isTerminal": false,
+                        "name": "browsing"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": false,
+                        "name": "editing"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": false,
+                        "name": "saving"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": true,
+                        "name": "confirmed"
+                      },
+                      {
+                        "isInitial": false,
+                        "isTerminal": false,
+                        "name": "failed"
+                      }
+                    ],
+                    "transitions": [
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "render-ui"
+                          }
+                        ],
+                        "event": "EDIT",
+                        "from": "browsing",
+                        "index": 0,
+                        "to": "editing"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "persist"
+                          },
+                          {
+                            "args": [],
+                            "type": "notify"
+                          }
+                        ],
+                        "event": "SAVE",
+                        "from": "editing",
+                        "index": 1,
+                        "to": "saving"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "emit"
+                          },
+                          {
+                            "args": [],
+                            "type": "render-ui"
+                          }
+                        ],
+                        "event": "SAVED",
+                        "from": "saving",
+                        "index": 2,
+                        "to": "confirmed"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "notify"
+                          }
+                        ],
+                        "event": "SAVE_FAILED",
+                        "from": "saving",
+                        "index": 3,
+                        "to": "failed"
+                      },
+                      {
+                        "effects": [],
+                        "event": "RETRY",
+                        "from": "failed",
+                        "index": 4,
+                        "to": "editing"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "render-ui"
+                          }
+                        ],
+                        "event": "CANCEL",
+                        "from": "editing",
+                        "index": 5,
+                        "to": "browsing"
+                      },
+                      {
+                        "effects": [
+                          {
+                            "args": [],
+                            "type": "navigate"
+                          }
+                        ],
+                        "event": "DONE",
+                        "from": "confirmed",
+                        "index": 6,
+                        "to": "browsing"
+                      }
+                    ]
+                  }
+                },
+                "traits": [
                   {
                     "emits": [
-                      "Item",
-                      "Item 2"
+                      "ORDER_SAVED"
                     ],
-                    "eventCount": 2,
+                    "eventCount": 7,
                     "listens": [
-                      "Item",
-                      "Item 2"
+                      "PAYMENT_OK"
                     ],
-                    "name": "Name 2",
-                    "stateCount": 2,
-                    "transitionCount": 2
+                    "name": "OrderFlow",
+                    "stateCount": 5,
+                    "transitionCount": 7
                   }
                 ]
               },
               "label": "Data",
-              "description": "data prop",
+              "description": "The orbital to summarize.",
               "tier": "presentation",
               "properties": {
                 "entityName": {
@@ -21137,11 +22028,6 @@
                     "type": "object"
                   }
                 },
-                "persistence": {
-                  "name": "persistence",
-                  "required": true,
-                  "type": "string"
-                },
                 "traitDetails": {
                   "name": "traitDetails",
                   "required": true,
@@ -21182,12 +22068,12 @@
                           "properties": {
                             "isInitial": {
                               "name": "isInitial",
-                              "required": true,
+                              "required": false,
                               "type": "boolean"
                             },
                             "isTerminal": {
                               "name": "isTerminal",
-                              "required": true,
+                              "required": false,
                               "type": "boolean"
                             },
                             "name": {
@@ -21240,7 +22126,7 @@
                             },
                             "guard": {
                               "name": "guard",
-                              "required": true,
+                              "required": false,
                               "type": "object"
                             },
                             "index": {
@@ -100002,7 +100888,7 @@
       "statePattern": "idle",
       "complexity": {
         "states": 1,
-        "events": 11,
+        "events": 12,
         "transitions": 8
       },
       "defaultEntity": {
@@ -100346,7 +101232,8 @@
         "SET_MODE",
         "@config.onChange",
         "@config.onEditorFocus",
-        "@config.onEditorBlur"
+        "@config.onEditorBlur",
+        "@config.onGoToDefinition"
       ],
       "eventPayloads": {},
       "exposure": "palette",
@@ -100360,7 +101247,8 @@
           "emittedEvents": [
             "CHANGE",
             "EDITOR_FOCUS",
-            "EDITOR_BLUR"
+            "EDITOR_BLUR",
+            "GO_TO_DEFINITION"
           ],
           "listenedEvents": [],
           "overridableConfigKeys": [
@@ -100416,6 +101304,65 @@
               "description": "The code content to display",
               "tier": "presentation"
             },
+            {
+              "key": "diagnostics",
+              "type": "[CodeBlockDiagnosticsItem]",
+              "default": [],
+              "label": "Diagnostics",
+              "description": "Editable only: problems located in the code (1-based line/column in characters, `endColumn` just past the last one), each underlined exactly — red wavy for an error, amber for a warning, dotted where the position is approximate. The message of the one under the caret shows below the editor.",
+              "tier": "presentation",
+              "items": {
+                "properties": {
+                  "approximate": {
+                    "name": "approximate",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "column": {
+                    "name": "column",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "endColumn": {
+                    "name": "endColumn",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "endLine": {
+                    "name": "endLine",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "line": {
+                    "name": "line",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "message": {
+                    "name": "message",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "severity": {
+                    "name": "severity",
+                    "required": true,
+                    "type": "string",
+                    "values": [
+                      "error",
+                      "warning"
+                    ]
+                  }
+                },
+                "type": "object"
+              }
+            },
+            {
+              "key": "diagnosticsCode",
+              "type": "string",
+              "label": "Diagnostics Code",
+              "description": "The code `diagnostics` were computed on. When the editor's text has moved on, each range is carried over the edit; a range the edit touches is dropped until the code is checked again. Absent: they describe the current text.",
+              "tier": "presentation"
+            },
             {
               "key": "diff",
               "type": "[CodeBlockDiffItem]",
@@ -100632,6 +101579,13 @@
               "description": "Programming language for syntax highlighting (any Prism id; loaded on demand if not pre-registered)",
               "tier": "presentation"
             },
+            {
+              "key": "lineNumbers",
+              "type": "boolean",
+              "label": "Line Numbers",
+              "description": "Editable only: number the lines in a gutter (lines with errors in red). Default on.",
+              "tier": "presentation"
+            },
             {
               "key": "maxHeight",
               "type": "scalar",
@@ -100738,6 +101692,14 @@
               "description": "Declarative bus emit fired when this editor gains focus.",
               "tier": "presentation"
             },
+            {
+              "key": "onGoToDefinition",
+              "type": "event",
+              "default": "GO_TO_DEFINITION",
+              "label": "On Go To Definition",
+              "description": "Editable only: Cmd/Ctrl+click, or Cmd/Ctrl+Enter at the caret, on an identifier `definitionAt` accepts.",
+              "tier": "presentation"
+            },
             {
               "key": "onInsertText",
               "type": "event",
@@ -100808,6 +101770,13 @@
                 ]
               }
             },
+            {
+              "key": "problems",
+              "type": "number",
+              "label": "Problems",
+              "description": "Editable only: how many problems the host knows the code has (some, like a parse error, have no line to mark). With `assist`, the editor offers to fix them.",
+              "tier": "presentation"
+            },
             {
               "key": "showCopy",
               "type": "boolean",
@@ -100911,6 +101880,12 @@
               "description": "Declarative bus emit fired when this editor loses focus.",
               "tier": "essential"
             },
+            {
+              "name": "GO_TO_DEFINITION",
+              "direction": "emit",
+              "description": "Editable only: Cmd/Ctrl+click, or Cmd/Ctrl+Enter at the caret, on an identifier `definitionAt` accepts.",
+              "tier": "essential"
+            },
             {
               "name": "INIT",
               "direction": "listen"
@@ -100935,7 +101910,8 @@
           "definerKnobs": [
             "onChange",
             "onEditorBlur",
-            "onEditorFocus"
+            "onEditorFocus",
+            "onGoToDefinition"
           ]
         }
       ],
@@ -114331,7 +115307,7 @@
       "statePattern": "idle",
       "complexity": {
         "states": 1,
-        "events": 2,
+        "events": 3,
         "transitions": 1
       },
       "defaultEntity": {
@@ -114656,7 +115632,8 @@
         "ui-wizard-progress"
       ],
       "connectableEvents": [
-        "@config.onFileSelect"
+        "@config.onFileSelect",
+        "@config.onNodeExpand"
       ],
       "eventPayloads": {},
       "exposure": "palette",
@@ -114668,7 +115645,8 @@
           "orbital": "FileTreeOrbital",
           "role": "renderer",
           "emittedEvents": [
-            "FILE_SELECT"
+            "FILE_SELECT",
+            "NODE_EXPAND"
           ],
           "listenedEvents": [],
           "overridableConfigKeys": [
@@ -114679,6 +115657,17 @@
               "description": "CSS class",
               "tier": "presentation"
             },
+            {
+              "key": "expandedPaths",
+              "type": "[string]",
+              "default": [],
+              "label": "Expanded Paths",
+              "description": "Paths to show expanded (e.g. to reveal a node): each is expanded when it appears here, loading its children if needed.",
+              "tier": "presentation",
+              "items": {
+                "type": "string"
+              }
+            },
             {
               "key": "indent",
               "type": "number",
@@ -114762,6 +115751,14 @@
               "description": "Called from the row's hover action button, in flat `items` mode; carries that node's id. Presence-gated: binding it renders the action.",
               "tier": "presentation"
             },
+            {
+              "key": "onNodeExpand",
+              "type": "event",
+              "default": "NODE_EXPAND",
+              "label": "On Node Expand",
+              "description": "Called the first time a node marked `expandable` is expanded, with its path, so its children can be loaded.",
+              "tier": "presentation"
+            },
             {
               "key": "onNodeReorder",
               "type": "event",
@@ -114812,6 +115809,11 @@
                       ]
                     }
                   },
+                  "expandable": {
+                    "name": "expandable",
+                    "required": false,
+                    "type": "boolean"
+                  },
                   "language": {
                     "name": "language",
                     "required": false,
@@ -114877,13 +115879,20 @@
               "description": "Called when a file is clicked",
               "tier": "essential"
             },
+            {
+              "name": "NODE_EXPAND",
+              "direction": "emit",
+              "description": "Called the first time a node marked `expandable` is expanded, with its path, so its children can be loaded.",
+              "tier": "essential"
+            },
             {
               "name": "INIT",
               "direction": "listen"
             }
           ],
           "definerKnobs": [
-            "onFileSelect"
+            "onFileSelect",
+            "onNodeExpand"
           ]
         }
       ],
@@ -169996,7 +171005,7 @@
       "statePattern": "idle",
       "complexity": {
         "states": 1,
-        "events": 1,
+        "events": 3,
         "transitions": 1
       },
       "defaultEntity": {
@@ -170123,6 +171132,7 @@
         "ui-atlas-panel",
         "ui-auth-layout",
         "ui-avatar",
+        "ui-avl-state-machine",
         "ui-badge",
         "ui-bloom-quiz-block",
         "ui-box",
@@ -170320,7 +171330,10 @@
         "ui-wizard-navigation",
         "ui-wizard-progress"
       ],
-      "connectableEvents": [],
+      "connectableEvents": [
+        "@config.stateClickEvent",
+        "@config.transitionClickEvent"
+      ],
       "eventPayloads": {},
       "exposure": "palette",
       "provenance": "generated",
@@ -170330,16 +171343,56 @@
           "name": "StateMachineViewRender",
           "orbital": "StateMachineViewOrbital",
           "role": "renderer",
-          "emittedEvents": [],
+          "emittedEvents": [
+            "STATE_CLICK",
+            "TRANSITION_CLICK"
+          ],
           "listenedEvents": [],
           "overridableConfigKeys": [
+            {
+              "key": "activeState",
+              "type": "string",
+              "label": "Active State",
+              "description": "State execution is currently in.",
+              "tier": "presentation"
+            },
+            {
+              "key": "activeTransition",
+              "type": "number",
+              "label": "Active Transition",
+              "description": "`index` of the transition that just fired.",
+              "tier": "presentation"
+            },
             {
               "key": "className",
               "type": "string",
               "label": "Class Name",
-              "description": "Additional CSS classes",
+              "description": "className prop",
               "tier": "presentation"
             },
+            {
+              "key": "direction",
+              "type": "string",
+              "default": "ltr",
+              "label": "Direction",
+              "description": "Flow direction. @default 'ltr'",
+              "tier": "presentation",
+              "enumValues": [
+                "ltr",
+                "rtl"
+              ]
+            },
+            {
+              "key": "entityFields",
+              "type": "[string]",
+              "default": [],
+              "label": "Entity Fields",
+              "description": "Entity field names listed in the header.",
+              "tier": "presentation",
+              "items": {
+                "type": "string"
+              }
+            },
             {
               "key": "error",
               "type": "StateMachineViewError",
@@ -170372,9 +171425,189 @@
             {
               "key": "isLoading",
               "type": "boolean",
+              "default": false,
               "label": "Is Loading",
               "description": "Loading state indicator",
               "tier": "presentation"
+            },
+            {
+              "key": "nodeShape",
+              "type": "string",
+              "default": "pill",
+              "label": "Node Shape",
+              "description": "Node silhouette. @default 'pill'",
+              "tier": "presentation",
+              "enumValues": [
+                "pill",
+                "gear"
+              ]
+            },
+            {
+              "key": "pendingSourceState",
+              "type": "string",
+              "label": "Pending Source State",
+              "description": "Source of a transition being drawn — the next state click picks its target.",
+              "tier": "presentation"
+            },
+            {
+              "key": "selectedState",
+              "type": "string",
+              "label": "Selected State",
+              "description": "State picked in an editor (first click).",
+              "tier": "presentation"
+            },
+            {
+              "key": "showHeader",
+              "type": "boolean",
+              "label": "Show Header",
+              "description": "Show the trait header (name, entity, listens/emits). @default true",
+              "tier": "presentation"
+            },
+            {
+              "key": "stateClickEvent",
+              "type": "event",
+              "default": "STATE_CLICK",
+              "label": "State Click Event",
+              "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+              "tier": "presentation"
+            },
+            {
+              "key": "traitProp",
+              "type": "StateMachineViewTrait",
+              "label": "Trait",
+              "description": "The trait to draw (see `parseTraitLevel` / `traitLevelFromTrait`).",
+              "synonyms": "trait",
+              "tier": "presentation",
+              "properties": {
+                "emittedEvents": {
+                  "name": "emittedEvents",
+                  "required": true,
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "linkedEntity": {
+                  "name": "linkedEntity",
+                  "required": true,
+                  "type": "string"
+                },
+                "listenedEvents": {
+                  "name": "listenedEvents",
+                  "required": true,
+                  "type": "array",
+                  "items": {
+                    "type": "string"
+                  }
+                },
+                "name": {
+                  "name": "name",
+                  "required": true,
+                  "type": "string"
+                },
+                "states": {
+                  "name": "states",
+                  "required": true,
+                  "type": "array",
+                  "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"
+                  }
+                },
+                "transitions": {
+                  "name": "transitions",
+                  "required": true,
+                  "type": "array",
+                  "items": {
+                    "properties": {
+                      "effects": {
+                        "name": "effects",
+                        "required": true,
+                        "type": "array",
+                        "items": {
+                          "properties": {
+                            "args": {
+                              "name": "args",
+                              "required": true,
+                              "type": "array",
+                              "items": {
+                                "type": "object"
+                              }
+                            },
+                            "type": {
+                              "name": "type",
+                              "required": true,
+                              "type": "string"
+                            }
+                          },
+                          "type": "object"
+                        }
+                      },
+                      "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"
+                  }
+                }
+              }
+            },
+            {
+              "key": "transitionClickEvent",
+              "type": "event",
+              "default": "TRANSITION_CLICK",
+              "label": "Transition Click Event",
+              "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+              "tier": "presentation"
+            },
+            {
+              "key": "visitedStates",
+              "type": "[string]",
+              "default": [],
+              "label": "Visited States",
+              "description": "States already passed through, in order.",
+              "tier": "presentation",
+              "items": {
+                "type": "string"
+              }
             }
           ],
           "capabilities": [],
@@ -170397,12 +171630,27 @@
             "INIT"
           ],
           "events": [
+            {
+              "name": "STATE_CLICK",
+              "direction": "emit",
+              "description": "Emits UI:{stateClickEvent} with { stateId } when a state is clicked.",
+              "tier": "essential"
+            },
+            {
+              "name": "TRANSITION_CLICK",
+              "direction": "emit",
+              "description": "Emits UI:{transitionClickEvent} with { index, event, from, to } when a transition label is clicked.",
+              "tier": "essential"
+            },
             {
               "name": "INIT",
               "direction": "listen"
             }
           ],
-          "definerKnobs": []
+          "definerKnobs": [
+            "stateClickEvent",
+            "transitionClickEvent"
+          ]
         }
       ],
       "factoryPath": "behaviors/functions/ui/core/organisms/ui-state-machine-view.ts",
@@ -198322,7 +199570,7 @@
                   },
                   "parent": {
                     "name": "parent",
-                    "required": true,
+                    "required": false,
                     "type": "string"
                   },
                   "pivot": {