@almadar/std 16.231.0 → 16.232.0

package/behaviors/registry/ui/core/molecules/ui-top-nav-item.orb

@@ -0,0 +1,277 @@
+{
+  "description": "TopNavItem — UI factory (1:1 with the @almadar/ui top-nav-item pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M3G7RV7Y1VMG26ZA75YVB8HY": {
+        "bakedName": "TopNavItemItem",
+        "curName": "TopNavItemItem",
+        "id": "ent_01M3G7RV7Y1VMG26ZA75YVB8HY",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M3G7RV7YCAVAZV02Y27KVT03": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M3G7RV7YCAVAZV02Y27KVT03",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3G7RV7YK1N1Z1HPYK8R52DK",
+        "renames": []
+      },
+      "orb_01M3G7RV7YS5PB48G5GNFNX4D9": {
+        "bakedName": "TopNavItemOrbital",
+        "curName": "TopNavItemOrbital",
+        "id": "orb_01M3G7RV7YS5PB48G5GNFNX4D9",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M3G7RV7YC5BWHR163PAX7PX1": {
+        "bakedName": "TopNavItemPage",
+        "curName": "TopNavItemPage",
+        "id": "pag_01M3G7RV7YC5BWHR163PAX7PX1",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3G7RV7YK1N1Z1HPYK8R52DK": {
+        "bakedName": "TopNavItemRender",
+        "curName": "TopNavItemRender",
+        "id": "trt_01M3G7RV7YK1N1Z1HPYK8R52DK",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-top-nav-item",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M3G7RV7Y1VMG26ZA75YVB8HY",
+        "name": "TopNavItemItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M3G7RV7YS5PB48G5GNFNX4D9",
+      "name": "TopNavItemOrbital",
+      "pages": [
+        {
+          "id": "pag_01M3G7RV7YC5BWHR163PAX7PX1",
+          "name": "TopNavItemPage",
+          "path": "/top-nav-item",
+          "traits": [
+            {
+              "ref": "TopNavItemRender",
+              "refId": "trt_01M3G7RV7YK1N1Z1HPYK8R52DK"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "activeHref": {
+              "description": "The href of the active page, used to mark the item (or its parent) active.",
+              "label": "Active Href",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "className": {
+              "description": "className prop",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "item": {
+              "default": {
+                "active": false,
+                "badge": "Badge",
+                "children": [],
+                "href": "Href",
+                "icon": "circle",
+                "label": "Label"
+              },
+              "description": "item prop",
+              "label": "Item",
+              "properties": {
+                "active": {
+                  "name": "active",
+                  "required": false,
+                  "type": "boolean"
+                },
+                "badge": {
+                  "name": "badge",
+                  "required": false,
+                  "type": "string"
+                },
+                "children": {
+                  "items": {
+                    "type": "union",
+                    "values": [
+                      "TopNavItemItem"
+                    ]
+                  },
+                  "name": "children",
+                  "required": false,
+                  "type": "array"
+                },
+                "href": {
+                  "name": "href",
+                  "required": false,
+                  "type": "string"
+                },
+                "icon": {
+                  "name": "icon",
+                  "required": false,
+                  "type": "string"
+                },
+                "label": {
+                  "name": "label",
+                  "required": true,
+                  "type": "string"
+                }
+              },
+              "tier": "presentation",
+              "type": "TopNavItemItem"
+            },
+            "tone": {
+              "default": "solid",
+              "description": "Active styling: `solid` fills with the primary colour (dashboard top bar); `soft` tints it (site header).",
+              "label": "Tone",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "solid",
+                "soft"
+              ]
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "TopNavItemItem": "ent_01M3G7RV7Y1VMG26ZA75YVB8HY"
+          },
+          "id": "trt_01M3G7RV7YK1N1Z1HPYK8R52DK",
+          "linkedEntity": "TopNavItemItem",
+          "linkedEntityId": "ent_01M3G7RV7Y1VMG26ZA75YVB8HY",
+          "name": "TopNavItemRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M3G7RV7YCAVAZV02Y27KVT03",
+                "key": "INIT",
+                "name": "Initialize"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "activeHref": "@config.activeHref",
+                      "className": "@config.className",
+                      "item": "@config.item",
+                      "tone": "@config.tone",
+                      "type": "top-nav-item"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3G7RV7YCAVAZV02Y27KVT03",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "TopNavItemItem": [
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "href",
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "badge",
+            "type": "string"
+          },
+          {
+            "name": "active",
+            "type": "boolean"
+          },
+          {
+            "name": "children",
+            "properties": [
+              {
+                "name": "label",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "href",
+                "type": "string"
+              },
+              {
+                "name": "icon",
+                "type": "icon"
+              },
+              {
+                "name": "badge",
+                "type": "string"
+              },
+              {
+                "name": "active",
+                "type": "boolean"
+              },
+              {
+                "name": "children",
+                "properties": [],
+                "type": "[TopNavItemItem]"
+              }
+            ],
+            "type": "[object]"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/core/molecules/ui-version-diff.orb

@@ -1,5 +1,5 @@
 {
-  "description": "VersionDiff — UI factory (1:1 with the @almadar/ui version-diff pattern).",
+  "description": "A line diff between two versions — two whole texts, or a pre-computed diff such as one commit. — UI factory (1:1 with the @almadar/ui version-diff pattern).",
   "ledger": {
     "entries": {
       "ent_01KXG04S04E95FG50ZVMHKA7EM": {
@@ -125,6 +125,59 @@
               "tier": "presentation",
               "type": "string"
             },
+            "hunks": {
+              "default": [],
+              "description": "A pre-computed diff to render instead of diffing `revisions` (no revision pickers).",
+              "items": {
+                "properties": {
+                  "header": {
+                    "name": "header",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "lines": {
+                    "items": {
+                      "properties": {
+                        "afterLineNumber": {
+                          "name": "afterLineNumber",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "beforeLineNumber": {
+                          "name": "beforeLineNumber",
+                          "required": false,
+                          "type": "number"
+                        },
+                        "content": {
+                          "name": "content",
+                          "required": true,
+                          "type": "string"
+                        },
+                        "type": {
+                          "name": "type",
+                          "required": true,
+                          "type": "string",
+                          "values": [
+                            "added",
+                            "removed",
+                            "unchanged",
+                            "context"
+                          ]
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "name": "lines",
+                    "required": true,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Hunks",
+              "tier": "presentation",
+              "type": "[VersionDiffHunksItem]"
+            },
             "language": {
               "description": "Language label (informational).",
               "label": "Language",
@@ -160,22 +213,7 @@
               "type": "event"
             },
             "revisions": {
-              "default": [
-                {
-                  "author": "Author",
-                  "content": "Content",
-                  "id": "Id",
-                  "label": "Label",
-                  "timestamp": "Timestamp"
-                },
-                {
-                  "author": "Author 2",
-                  "content": "Content 2",
-                  "id": "Id 2",
-                  "label": "Label 2",
-                  "timestamp": "Timestamp 2"
-                }
-              ],
+              "default": [],
               "description": "All available revisions (at least 2). Accepts either a typed array (direct consumers) or the runtime payload shape from a render-ui binding (`@payload.revisions`). Narrowed to `[]` internally when the value isn't an array.",
               "items": {
                 "properties": {
@@ -227,7 +265,7 @@
             },
             "view": {
               "default": "side-by-side",
-              "description": "Display mode.",
+              "description": "Display mode to start in; the toggle switches it.",
               "label": "View",
               "tier": "presentation",
               "type": "string",
@@ -363,6 +401,7 @@
                       "afterId": "@config.afterId",
                       "beforeId": "@config.beforeId",
                       "className": "@config.className",
+                      "hunks": "@config.hunks",
                       "language": "@config.language",
                       "onRevert": "@config.onRevert",
                       "onSelectAfter": "@config.onSelectAfter",
@@ -386,6 +425,58 @@
         }
       ],
       "types": {
+        "VersionDiffHunksItem": [
+          {
+            "name": "header",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "lines",
+            "properties": [
+              {
+                "name": "type",
+                "required": true,
+                "type": "string"
+              },
+              {
+                "name": "beforeLineNumber",
+                "type": "number"
+              },
+              {
+                "name": "afterLineNumber",
+                "type": "number"
+              },
+              {
+                "name": "content",
+                "required": true,
+                "type": "string"
+              }
+            ],
+            "required": true,
+            "type": "[object]"
+          }
+        ],
+        "VersionDiffHunksItemLinesItem": [
+          {
+            "name": "type",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "beforeLineNumber",
+            "type": "number"
+          },
+          {
+            "name": "afterLineNumber",
+            "type": "number"
+          },
+          {
+            "name": "content",
+            "required": true,
+            "type": "string"
+          }
+        ],
         "VersionDiffRevisionsItem": [
           {
             "name": "id",

package/behaviors/registry/ui/core/organisms/ui-dock-layout.orb

@@ -138,7 +138,6 @@
               "type": "string"
             },
             "bottomPanelCollapsed": {
-              "default": false,
               "description": "Whether `bottomPanel` is collapsed. @default false",
               "label": "Bottom Panel Collapsed",
               "tier": "presentation",
@@ -151,6 +150,18 @@
               "tier": "presentation",
               "type": "number"
             },
+            "bottomPanelIcon": {
+              "description": "bottomPanelIcon prop",
+              "label": "Bottom Panel Icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "bottomPanelLabel": {
+              "description": "Compact: the top-bar button that opens `bottomPanel`.",
+              "label": "Bottom Panel Label",
+              "tier": "presentation",
+              "type": "string"
+            },
             "bottomPanelMinSize": {
               "default": 120.0,
               "description": "Minimum bottom panel size in pixels, forwarded to SplitPane's `minSize`. @default 120",
@@ -164,6 +175,12 @@
               "tier": "presentation",
               "type": "string"
             },
+            "compact": {
+              "description": "The mobile variant; decided by the viewport (narrower than 1024px) when omitted.",
+              "label": "Compact",
+              "tier": "presentation",
+              "type": "boolean"
+            },
             "main": {
               "default": [],
               "description": "Required center region.",
@@ -225,8 +242,7 @@
               "type": "string"
             },
             "railWidth": {
-              "default": 56.0,
-              "description": "Width of `rail` in pixels. @default 56",
+              "description": "Width of `rail` in pixels; the rail sizes the column itself when omitted.",
               "label": "Rail Width",
               "tier": "presentation",
               "type": "number"
@@ -244,12 +260,23 @@
               "type": "string"
             },
             "secondarySidebarCollapsed": {
-              "default": false,
               "description": "Whether `secondarySidebar` is collapsed. @default false",
               "label": "Secondary Sidebar Collapsed",
               "tier": "presentation",
               "type": "boolean"
             },
+            "secondarySidebarIcon": {
+              "description": "secondarySidebarIcon prop",
+              "label": "Secondary Sidebar Icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
+            "secondarySidebarLabel": {
+              "description": "Compact: the top-bar button that opens `secondarySidebar` (e.g. 'Inspector', 'Chat').",
+              "label": "Secondary Sidebar Label",
+              "tier": "presentation",
+              "type": "string"
+            },
             "secondarySidebarWidth": {
               "default": 280.0,
               "description": "Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280",
@@ -270,7 +297,6 @@
               "type": "string"
             },
             "sidebarCollapsed": {
-              "default": false,
               "description": "Whether `sidebar` is collapsed. @default false",
               "label": "Sidebar Collapsed",
               "tier": "presentation",
@@ -301,6 +327,12 @@
               "label": "Status Bar Class Name",
               "tier": "presentation",
               "type": "string"
+            },
+            "topBarActions": {
+              "description": "Compact: the host's own actions at the end of the top bar (e.g. Run).",
+              "label": "Top Bar Actions",
+              "tier": "presentation",
+              "type": "node"
             }
           },
           "effectRow": [
@@ -484,8 +516,11 @@
                       "bottomPanelClassName": "@config.bottomPanelClassName",
                       "bottomPanelCollapsed": "@config.bottomPanelCollapsed",
                       "bottomPanelHeight": "@config.bottomPanelHeight",
+                      "bottomPanelIcon": "@config.bottomPanelIcon",
+                      "bottomPanelLabel": "@config.bottomPanelLabel",
                       "bottomPanelMinSize": "@config.bottomPanelMinSize",
                       "className": "@config.className",
+                      "compact": "@config.compact",
                       "main": "@config.main",
                       "mainClassName": "@config.mainClassName",
                       "onBottomPanelCollapsedChange": "@config.onBottomPanelCollapsedChange",
@@ -499,6 +534,8 @@
                       "secondarySidebar": "@config.secondarySidebar",
                       "secondarySidebarClassName": "@config.secondarySidebarClassName",
                       "secondarySidebarCollapsed": "@config.secondarySidebarCollapsed",
+                      "secondarySidebarIcon": "@config.secondarySidebarIcon",
+                      "secondarySidebarLabel": "@config.secondarySidebarLabel",
                       "secondarySidebarWidth": "@config.secondarySidebarWidth",
                       "sidebar": "@config.sidebar",
                       "sidebarClassName": "@config.sidebarClassName",
@@ -507,6 +544,7 @@
                       "sidebarWidth": "@config.sidebarWidth",
                       "statusBar": "@config.statusBar",
                       "statusBarClassName": "@config.statusBarClassName",
+                      "topBarActions": "@config.topBarActions",
                       "type": "dock-layout"
                     }
                   ]

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

@@ -765,6 +765,10 @@
                   "required": true,
                   "type": "number"
                 },
+                {
+                  "name": "type",
+                  "type": "string"
+                },
                 {
                   "name": "elevation",
                   "type": "number"
@@ -929,6 +933,10 @@
                     "required": true,
                     "type": "number"
                   },
+                  {
+                    "name": "type",
+                    "type": "string"
+                  },
                   {
                     "name": "elevation",
                     "type": "number"