@almadar/std 16.178.0 → 16.180.0

package/behaviors/registry/ui/core/molecules/ui-breadcrumb.orb

@@ -19,6 +19,15 @@
         "parent": "trt_01KXG04MX6C96QT73HKMXSSXW9",
         "renames": []
       },
+      "evt_01M0HZ7JXZT1B3WE2JVP75FDGK": {
+        "bakedName": "@config.itemEvent",
+        "curName": "@config.itemEvent",
+        "id": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01KXG04MX6C96QT73HKMXSSXW9",
+        "renames": []
+      },
       "orb_01KXG04MX6C39A82D7NECQJ0X8": {
         "bakedName": "BreadcrumbOrbital",
         "curName": "BreadcrumbOrbital",
@@ -86,24 +95,23 @@
               "tier": "presentation",
               "type": "string"
             },
+            "fromNavStack": {
+              "default": false,
+              "description": "Render the current orbital's navigation stack (NavStackProvider) as the trail: one crumb per visited/declared level, last entry current. The stack is client-session state both execution paths maintain; outside a provider this renders nothing.",
+              "label": "From Nav Stack",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "itemEvent": {
+              "default": "ITEM",
+              "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
+              "label": "Item Event",
+              "tier": "presentation",
+              "type": "string"
+            },
             "items": {
-              "default": [
-                {
-                  "href": "Href",
-                  "icon": "circle",
-                  "isCurrent": false,
-                  "label": "Label",
-                  "path": "Path"
-                },
-                {
-                  "href": "Href 2",
-                  "icon": "circle",
-                  "isCurrent": true,
-                  "label": "Label 2",
-                  "path": "Path 2"
-                }
-              ],
-              "description": "Breadcrumb items",
+              "default": [],
+              "description": "Breadcrumb items. Omit together with `fromNavStack` to render the orbital-scoped navigation stack instead of an authored trail.",
               "items": {
                 "properties": {
                   "event": {
@@ -156,6 +164,21 @@
               "type": "icon"
             }
           },
+          "emits": [
+            {
+              "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
+              "event": "@config.itemEvent",
+              "eventId": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
           "entityContract": {
             "provides": [],
             "requires": []
@@ -175,6 +198,19 @@
                 "id": "evt_01KXG04MX61JX4AMH0MQK0YQ6W",
                 "key": "INIT",
                 "name": "Initialize"
+              },
+              {
+                "description": "Event emitted when a non-current crumb is clicked, with payload `{ label, href, index }` — the trait handles it with `(navigate ?href)`. Without it, stack crumbs navigate directly.",
+                "id": "evt_01M0HZ7JXZT1B3WE2JVP75FDGK",
+                "key": "@config.itemEvent",
+                "name": "@config.item event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -191,6 +227,8 @@
                     "main",
                     {
                       "className": "@config.className",
+                      "fromNavStack": "@config.fromNavStack",
+                      "itemEvent": "@config.itemEvent",
                       "items": "@config.items",
                       "maxItems": "@config.maxItems",
                       "separator": "@config.separator",

package/behaviors/registry/ui/core/molecules/ui-fx-overlay.orb

@@ -0,0 +1,281 @@
+{
+  "description": "FxOverlay — UI factory (1:1 with the @almadar/ui fx-overlay pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M0GQAE9VWWQQW98YDF0NXYAC": {
+        "bakedName": "FxOverlayItem",
+        "curName": "FxOverlayItem",
+        "id": "ent_01M0GQAE9VWWQQW98YDF0NXYAC",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M0GQAE9VZDFQJSHRD0XV1TVB": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M0GQAE9VZDFQJSHRD0XV1TVB",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0GQAE9VM32ZSENBMTYEAPST",
+        "renames": []
+      },
+      "orb_01M0GQAE9VFZPV4T0AXTFZJQKB": {
+        "bakedName": "FxOverlayOrbital",
+        "curName": "FxOverlayOrbital",
+        "id": "orb_01M0GQAE9VFZPV4T0AXTFZJQKB",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M0GQAE9YGPXWS4092BVS3JQG": {
+        "bakedName": "FxOverlayPage",
+        "curName": "FxOverlayPage",
+        "id": "pag_01M0GQAE9YGPXWS4092BVS3JQG",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M0GQAE9VM32ZSENBMTYEAPST": {
+        "bakedName": "FxOverlayRender",
+        "curName": "FxOverlayRender",
+        "id": "trt_01M0GQAE9VM32ZSENBMTYEAPST",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-fx-overlay",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M0GQAE9VWWQQW98YDF0NXYAC",
+        "name": "FxOverlayItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M0GQAE9VFZPV4T0AXTFZJQKB",
+      "name": "FxOverlayOrbital",
+      "pages": [
+        {
+          "id": "pag_01M0GQAE9YGPXWS4092BVS3JQG",
+          "name": "FxOverlayPage",
+          "path": "/fx-overlay",
+          "traits": [
+            {
+              "ref": "FxOverlayRender",
+              "refId": "trt_01M0GQAE9VM32ZSENBMTYEAPST"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "children": {
+              "description": "Wrapped content — the `shake` target and the overlay's bounds.",
+              "label": "Children",
+              "tier": "presentation",
+              "type": "node"
+            },
+            "className": {
+              "description": "Additional class names on the outermost element.",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "items": {
+              "default": [
+                {
+                  "id": "e1",
+                  "message": "Unit spawned",
+                  "type": "spawn",
+                  "x": 2.0,
+                  "y": 2.0
+                },
+                {
+                  "id": "e2",
+                  "message": "Attack landed",
+                  "type": "effect",
+                  "x": 3.0,
+                  "y": 1.0
+                }
+              ],
+              "description": "Live screen-space fx entries (the mechanic's fx list filtered to `space == 'screen'`); mount starts each item's animation, ttl decay unmounts it.",
+              "items": {
+                "properties": {
+                  "bornAt": {
+                    "name": "bornAt",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "color": {
+                    "name": "color",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "effect": {
+                    "name": "effect",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "confetti",
+                      "flash",
+                      "shake",
+                      "sparkle",
+                      "float-text",
+                      "streak-glow"
+                    ]
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "maxTtl": {
+                    "name": "maxTtl",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "message": {
+                    "name": "message",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "particleCount": {
+                    "name": "particleCount",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "size": {
+                    "name": "size",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "space": {
+                    "name": "space",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "world",
+                      "screen"
+                    ]
+                  },
+                  "ttl": {
+                    "name": "ttl",
+                    "required": true,
+                    "type": "number"
+                  },
+                  "type": {
+                    "name": "type",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "vx": {
+                    "name": "vx",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "vy": {
+                    "name": "vy",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "vz": {
+                    "name": "vz",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "x": {
+                    "name": "x",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "y": {
+                    "name": "y",
+                    "required": false,
+                    "type": "number"
+                  },
+                  "z": {
+                    "name": "z",
+                    "required": false,
+                    "type": "number"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Items",
+              "tier": "presentation",
+              "type": "[FxOverlayItemsItem]"
+            },
+            "tickMs": {
+              "description": "The fx mechanic's decay tick period in ms; per-item animation duration = maxTtl × tickMs. Default 500.",
+              "label": "Tick Ms",
+              "tier": "presentation",
+              "type": "number"
+            }
+          },
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "FxOverlayItem": "ent_01M0GQAE9VWWQQW98YDF0NXYAC"
+          },
+          "id": "trt_01M0GQAE9VM32ZSENBMTYEAPST",
+          "linkedEntity": "FxOverlayItem",
+          "linkedEntityId": "ent_01M0GQAE9VWWQQW98YDF0NXYAC",
+          "name": "FxOverlayRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M0GQAE9VZDFQJSHRD0XV1TVB",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "children": "@config.children",
+                      "className": "@config.className",
+                      "items": "@config.items",
+                      "tickMs": "@config.tickMs",
+                      "type": "fx-overlay"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M0GQAE9VZDFQJSHRD0XV1TVB",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/core/molecules/ui-page-header.orb

@@ -247,7 +247,7 @@
               "type": "boolean"
             },
             "status": {
-              "description": "Status badge",
+              "description": "Status badge — a bare string (an entity's status field bound directly, e.g. `status: @entity.status`) renders as a default-variant badge",
               "label": "Status",
               "properties": {
                 "label": {

package/behaviors/registry/ui/core/organisms/ui-detail-panel.orb

@@ -315,6 +315,12 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "maxInlineActions": {
+              "description": "Max inline action buttons before the rest collapse into a '⋯' overflow menu (mirrors DataGrid's maxInlineActions). Omit = all inline.",
+              "label": "Max Inline Actions",
+              "tier": "presentation",
+              "type": "number"
+            },
             "mode": {
               "description": "Display mode (passed by compiler)",
               "label": "Mode",
@@ -609,6 +615,7 @@
                       "footer": "@config.footer",
                       "initialData": "@entity",
                       "isLoading": "@config.isLoading",
+                      "maxInlineActions": "@config.maxInlineActions",
                       "mode": "@config.mode",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",
@@ -654,6 +661,7 @@
                       "footer": "@config.footer",
                       "initialData": "@payload.data",
                       "isLoading": "@config.isLoading",
+                      "maxInlineActions": "@config.maxInlineActions",
                       "mode": "@config.mode",
                       "page": "@config.pageProp",
                       "pageSize": "@config.pageSize",

package/behaviors/registry/ui/core/organisms/ui-form-section.orb

@@ -190,11 +190,17 @@
               "label": "Evaluation Context",
               "properties": {
                 "entity": {
+                  "items": {
+                    "type": "object"
+                  },
                   "name": "entity",
                   "required": false,
                   "type": "object"
                 },
                 "formValues": {
+                  "items": {
+                    "type": "object"
+                  },
                   "name": "formValues",
                   "required": true,
                   "type": "object"

package/behaviors/registry/ui/core/organisms/ui-form.orb

@@ -190,11 +190,17 @@
               "label": "Evaluation Context",
               "properties": {
                 "entity": {
+                  "items": {
+                    "type": "object"
+                  },
                   "name": "entity",
                   "required": false,
                   "type": "object"
                 },
                 "formValues": {
+                  "items": {
+                    "type": "object"
+                  },
                   "name": "formValues",
                   "required": true,
                   "type": "object"

package/behaviors/registry/ui/core/templates/ui-dashboard-layout.orb

@@ -335,7 +335,7 @@
               "type": "[DashboardLayoutTopBarActionsItem]"
             },
             "user": {
-              "description": "Current user info (optional - auto-populated from auth context if not provided)",
+              "description": "Current user info (optional - auto-populated from auth context if not provided). Accepts `null` as well as `undefined`: the `.lolo` substrate's signed-out spelling is `(if @config.viewerName {…} null)`, and the compiled path passes that `null` through verbatim.",
               "label": "User",
               "properties": {
                 "avatar": {
@@ -345,7 +345,7 @@
                 },
                 "email": {
                   "name": "email",
-                  "required": true,
+                  "required": false,
                   "type": "string"
                 },
                 "name": {