@almadar/std 16.231.0 → 16.233.0

package/behaviors/registry/ui/core/molecules/ui-commit-row.orb

@@ -0,0 +1,441 @@
+{
+  "description": "One version in a history list — a commit row with select and restore. — UI factory (1:1 with the @almadar/ui commit-row pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M3G7RQCXJSYTV4CHAR22JWGF": {
+        "bakedName": "CommitRowItem",
+        "curName": "CommitRowItem",
+        "id": "ent_01M3G7RQCXJSYTV4CHAR22JWGF",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M3G7RQCX22ZSE5JBZ02SFYAS": {
+        "bakedName": "@config.restoreEvent",
+        "curName": "@config.restoreEvent",
+        "id": "evt_01M3G7RQCX22ZSE5JBZ02SFYAS",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+        "renames": []
+      },
+      "evt_01M3G7RQCXAD5KY0346AAFZVVQ": {
+        "bakedName": "SELECT",
+        "curName": "SELECT",
+        "id": "evt_01M3G7RQCXAD5KY0346AAFZVVQ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+        "renames": []
+      },
+      "evt_01M3G7RQCXJJQMN05KN1T00MF4": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M3G7RQCXJJQMN05KN1T00MF4",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+        "renames": []
+      },
+      "evt_01M3G7RQCXTBG3ZVB870Y096AM": {
+        "bakedName": "@config.selectEvent",
+        "curName": "@config.selectEvent",
+        "id": "evt_01M3G7RQCXTBG3ZVB870Y096AM",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+        "renames": []
+      },
+      "evt_01M3G7RQCXVR8BP9DCWHMJ65X6": {
+        "bakedName": "RESTORE",
+        "curName": "RESTORE",
+        "id": "evt_01M3G7RQCXVR8BP9DCWHMJ65X6",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+        "renames": []
+      },
+      "orb_01M3G7RQCXVXBGD3W72VVVPV5R": {
+        "bakedName": "CommitRowOrbital",
+        "curName": "CommitRowOrbital",
+        "id": "orb_01M3G7RQCXVXBGD3W72VVVPV5R",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M3G7RQCXZ0QER3FEX896FMXP": {
+        "bakedName": "CommitRowPage",
+        "curName": "CommitRowPage",
+        "id": "pag_01M3G7RQCXZ0QER3FEX896FMXP",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M3G7RQCXXH4A2W41QHY3BJC6": {
+        "bakedName": "CommitRowRender",
+        "curName": "CommitRowRender",
+        "id": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-commit-row",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": "",
+            "intrinsic": true,
+            "name": "sha",
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M3G7RQCXJSYTV4CHAR22JWGF",
+        "name": "CommitRowItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M3G7RQCXVXBGD3W72VVVPV5R",
+      "name": "CommitRowOrbital",
+      "pages": [
+        {
+          "id": "pag_01M3G7RQCXZ0QER3FEX896FMXP",
+          "name": "CommitRowPage",
+          "path": "/commit-row",
+          "traits": [
+            {
+              "ref": "CommitRowRender",
+              "refId": "trt_01M3G7RQCXXH4A2W41QHY3BJC6"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "additions": {
+              "description": "additions prop",
+              "label": "Additions",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "author": {
+              "description": "author prop",
+              "label": "Author",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "className": {
+              "description": "className prop",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "current": {
+              "default": false,
+              "description": "The version the app is at now — it cannot be restored to.",
+              "label": "Current",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "deletions": {
+              "description": "deletions prop",
+              "label": "Deletions",
+              "tier": "presentation",
+              "type": "number"
+            },
+            "kind": {
+              "default": "user",
+              "description": "What made this version (a user save, an agent turn, a restore, an undo/redo, a snapshot).",
+              "label": "Kind",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "user",
+                "agent",
+                "restore",
+                "undo",
+                "redo",
+                "snapshot"
+              ]
+            },
+            "message": {
+              "default": "",
+              "description": "Commit message.",
+              "label": "Message",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "restoreEvent": {
+              "default": "RESTORE",
+              "description": "Emitted by the Restore button. Payload: { sha }.",
+              "label": "Restore Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "selectEvent": {
+              "default": "SELECT",
+              "description": "Emitted when the row is picked. Payload: { sha }.",
+              "label": "Select Event",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "selected": {
+              "default": false,
+              "description": "The row the user picked (shows its detail).",
+              "label": "Selected",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "sha": {
+              "default": "",
+              "description": "Commit id; the first 7 characters are shown, the whole id on hover.",
+              "label": "Sha",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "timestamp": {
+              "description": "Display time (already formatted, e.g. '2 min ago').",
+              "label": "Timestamp",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "effectRow": [
+            {
+              "kind": "render-ui",
+              "resource": "main"
+            },
+            {
+              "kind": "set",
+              "resource": "@entity.sha"
+            }
+          ],
+          "emits": [
+            {
+              "definerKnob": "selectEvent",
+              "description": "Emitted when the row is picked. Payload: { sha }.",
+              "event": "@config.selectEvent",
+              "eventId": "evt_01M3G7RQCXTBG3ZVB870Y096AM",
+              "payloadSchema": [
+                {
+                  "name": "sha",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "restoreEvent",
+              "description": "Emitted by the Restore button. Payload: { sha }.",
+              "event": "@config.restoreEvent",
+              "eventId": "evt_01M3G7RQCX22ZSE5JBZ02SFYAS",
+              "payloadSchema": [
+                {
+                  "name": "sha",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "sha"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "CommitRowItem": "ent_01M3G7RQCXJSYTV4CHAR22JWGF"
+          },
+          "id": "trt_01M3G7RQCXXH4A2W41QHY3BJC6",
+          "linkedEntity": "CommitRowItem",
+          "linkedEntityId": "ent_01M3G7RQCXJSYTV4CHAR22JWGF",
+          "name": "CommitRowRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M3G7RQCXJJQMN05KN1T00MF4",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M3G7RQCXAD5KY0346AAFZVVQ",
+                "key": "SELECT",
+                "name": "Select",
+                "payloadSchema": [
+                  {
+                    "name": "sha",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "id": "evt_01M3G7RQCXVR8BP9DCWHMJ65X6",
+                "key": "RESTORE",
+                "name": "Restore",
+                "payloadSchema": [
+                  {
+                    "name": "sha",
+                    "required": true,
+                    "type": "string"
+                  }
+                ]
+              },
+              {
+                "description": "Emitted when the row is picked. Payload: { sha }.",
+                "id": "evt_01M3G7RQCXTBG3ZVB870Y096AM",
+                "key": "@config.selectEvent",
+                "name": "@config.select event",
+                "payloadSchema": [
+                  {
+                    "name": "sha",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Emitted by the Restore button. Payload: { sha }.",
+                "id": "evt_01M3G7RQCX22ZSE5JBZ02SFYAS",
+                "key": "@config.restoreEvent",
+                "name": "@config.restore event",
+                "payloadSchema": [
+                  {
+                    "name": "sha",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.sha",
+                    "@config.sha"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "additions": "@config.additions",
+                      "author": "@config.author",
+                      "className": "@config.className",
+                      "current": "@config.current",
+                      "deletions": "@config.deletions",
+                      "kind": "@config.kind",
+                      "message": "@config.message",
+                      "restoreEvent": "@config.restoreEvent",
+                      "selectEvent": "@config.selectEvent",
+                      "selected": "@config.selected",
+                      "sha": "@entity.sha",
+                      "timestamp": "@config.timestamp",
+                      "type": "commit-row"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M3G7RQCXJJQMN05KN1T00MF4",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.sha",
+                    "@payload.sha"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "additions": "@config.additions",
+                      "author": "@config.author",
+                      "className": "@config.className",
+                      "current": "@config.current",
+                      "deletions": "@config.deletions",
+                      "kind": "@config.kind",
+                      "message": "@config.message",
+                      "restoreEvent": "@config.restoreEvent",
+                      "selectEvent": "@config.selectEvent",
+                      "selected": "@config.selected",
+                      "sha": "@entity.sha",
+                      "timestamp": "@config.timestamp",
+                      "type": "commit-row"
+                    }
+                  ]
+                ],
+                "event": "SELECT",
+                "eventId": "evt_01M3G7RQCXAD5KY0346AAFZVVQ",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.sha",
+                    "@payload.sha"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "additions": "@config.additions",
+                      "author": "@config.author",
+                      "className": "@config.className",
+                      "current": "@config.current",
+                      "deletions": "@config.deletions",
+                      "kind": "@config.kind",
+                      "message": "@config.message",
+                      "restoreEvent": "@config.restoreEvent",
+                      "selectEvent": "@config.selectEvent",
+                      "selected": "@config.selected",
+                      "sha": "@entity.sha",
+                      "timestamp": "@config.timestamp",
+                      "type": "commit-row"
+                    }
+                  ]
+                ],
+                "event": "RESTORE",
+                "eventId": "evt_01M3G7RQCXVR8BP9DCWHMJ65X6",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

package/behaviors/registry/ui/core/molecules/ui-file-tree.orb

@@ -223,6 +223,11 @@
                     "required": true,
                     "type": "string"
                   },
+                  "note": {
+                    "name": "note",
+                    "required": false,
+                    "type": "string"
+                  },
                   "path": {
                     "name": "path",
                     "required": true,
@@ -405,6 +410,10 @@
                 "properties": [],
                 "type": "[FileTreeTreeItem]"
               },
+              {
+                "name": "note",
+                "type": "string"
+              },
               {
                 "name": "size",
                 "type": "number"
@@ -416,6 +425,10 @@
             ],
             "type": "[object]"
           },
+          {
+            "name": "note",
+            "type": "string"
+          },
           {
             "name": "size",
             "type": "number"

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

@@ -218,6 +218,17 @@
                     "required": false,
                     "type": "string"
                   },
+                  "children": {
+                    "items": {
+                      "type": "union",
+                      "values": [
+                        "HeaderNavigationItemsItem"
+                      ]
+                    },
+                    "name": "children",
+                    "required": false,
+                    "type": "array"
+                  },
                   "href": {
                     "name": "href",
                     "required": false,
@@ -525,6 +536,38 @@
           {
             "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": "[HeaderNavigationItemsItem]"
+              }
+            ],
+            "type": "[object]"
           }
         ],
         "HeaderUserAvatar": [