@almadar/std 16.191.0 → 16.193.0

package/behaviors/registry/ui/core/molecules/ui-data-grid.orb

@@ -464,6 +464,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
+            },
             "sortable": {
               "description": "Enable in-container reorder; items can be dragged to new positions among siblings",
               "label": "Sortable",
@@ -657,6 +664,54 @@
                 "event": "INIT",
                 "eventId": "evt_01KXG04N8BTF6MP6RFAPG69EK9",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "accepts": "@config.accepts",
+                      "className": "@config.className",
+                      "cols": "@config.cols",
+                      "columns": "@config.columns",
+                      "dndItemIdField": "@config.dndItemIdField",
+                      "dndRoot": "@config.dndRoot",
+                      "dragGroup": "@config.dragGroup",
+                      "dropEvent": "@config.dropEvent",
+                      "entity": "@entity",
+                      "error": "@config.error",
+                      "fields": "@config.fields",
+                      "gap": "@config.gap",
+                      "hasMore": "@config.hasMore",
+                      "imageField": "@config.imageField",
+                      "infiniteScroll": "@config.infiniteScroll",
+                      "isLoading": "@config.isLoading",
+                      "itemActions": "@config.itemActions",
+                      "loadMoreEvent": "@config.loadMoreEvent",
+                      "look": "@config.look",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "minCardWidth": "@config.minCardWidth",
+                      "pageSize": "@config.pageSize",
+                      "positionEvent": "@config.positionEvent",
+                      "reorderEvent": "@config.reorderEvent",
+                      "scrollX": "@config.scrollX",
+                      "selectable": "@config.selectable",
+                      "selectionEvent": "@config.selectionEvent",
+                      "sortable": "@config.sortable",
+                      "type": "data-grid"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04N8BTF6MP6RFAPG69EK9",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {

package/behaviors/registry/ui/core/molecules/ui-data-list.orb

@@ -477,6 +477,13 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
+            },
             "senderField": {
               "description": "Field name identifying the sender (used with variant: 'message')",
               "label": "Sender Field",
@@ -905,6 +912,63 @@
                 "event": "INIT",
                 "eventId": "evt_01KXG04N9J3A885VW02NZQMP51",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "accepts": "@config.accepts",
+                      "className": "@config.className",
+                      "columns": "@config.columns",
+                      "currentUser": "@config.currentUser",
+                      "dndItemIdField": "@config.dndItemIdField",
+                      "dndRoot": "@config.dndRoot",
+                      "dragGroup": "@config.dragGroup",
+                      "dropEvent": "@config.dropEvent",
+                      "emptyMessage": "@config.emptyMessage",
+                      "entity": "@entity",
+                      "error": "@config.error",
+                      "fields": "@config.fields",
+                      "gap": "@config.gap",
+                      "groupBy": "@config.groupBy",
+                      "hasMore": "@config.hasMore",
+                      "infiniteScroll": "@config.infiniteScroll",
+                      "isLoading": "@config.isLoading",
+                      "itemActions": "@config.itemActions",
+                      "itemClickEvent": "@config.itemClickEvent",
+                      "loadMoreEvent": "@config.loadMoreEvent",
+                      "longPressEvent": "@config.longPressEvent",
+                      "look": "@config.look",
+                      "maxInlineActions": "@config.maxInlineActions",
+                      "pageSize": "@config.pageSize",
+                      "positionEvent": "@config.positionEvent",
+                      "reorderEvent": "@config.reorderEvent",
+                      "reorderable": "@config.reorderable",
+                      "senderField": "@config.senderField",
+                      "senderLabelField": "@config.senderLabelField",
+                      "sortBy": "@config.sortBy",
+                      "sortDirection": "@config.sortDirection",
+                      "sortable": "@config.sortable",
+                      "swipeLeftActions": "@config.swipeLeftActions",
+                      "swipeLeftEvent": "@config.swipeLeftEvent",
+                      "swipeRightActions": "@config.swipeRightActions",
+                      "swipeRightEvent": "@config.swipeRightEvent",
+                      "type": "data-list",
+                      "variant": "@config.variant"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04N9J3A885VW02NZQMP51",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {

package/behaviors/registry/ui/core/molecules/ui-document-details.orb

@@ -37,6 +37,15 @@
         "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
         "renames": []
       },
+      "evt_01M1694617Q04F1T085TTM4F8C": {
+        "bakedName": "@config.relationEvent",
+        "curName": "@config.relationEvent",
+        "id": "evt_01M1694617Q04F1T085TTM4F8C",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "renames": []
+      },
       "orb_01M13ZXC59HR3466AAAMSKD8MY": {
         "bakedName": "DocumentDetailsOrbital",
         "curName": "DocumentDetailsOrbital",
@@ -144,7 +153,8 @@
                       "text",
                       "boolean",
                       "select",
-                      "readonly"
+                      "readonly",
+                      "image"
                     ]
                   },
                   "label": {
@@ -164,6 +174,11 @@
                     "name": "options",
                     "required": false,
                     "type": "array"
+                  },
+                  "type": {
+                    "name": "type",
+                    "required": false,
+                    "type": "string"
                   }
                 },
                 "type": "object"
@@ -179,6 +194,20 @@
               "tier": "presentation",
               "type": "string"
             },
+            "relationEvent": {
+              "default": "RELATION",
+              "description": "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface.",
+              "label": "Relation Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
+            },
             "title": {
               "description": "Card heading (defaults to the localized 'Details')",
               "label": "Title",
@@ -206,6 +235,30 @@
               "scope": "external",
               "tier": "essential"
             },
+            {
+              "description": "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface.",
+              "event": "@config.relationEvent",
+              "eventId": "evt_01M1694617Q04F1T085TTM4F8C",
+              "payloadSchema": [
+                {
+                  "name": "field",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "name",
+                  "required": true,
+                  "type": "string"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
             {
               "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
               "event": "DocumentDetailsLoaded",
@@ -273,6 +326,30 @@
                   }
                 ],
                 "tier": "essential"
+              },
+              {
+                "description": "Makes relation chips clickable: emitted with { field, id, name } when a hydrated relation value (or one row of a many-relation) is clicked — the host routes it to the linked record's own surface.",
+                "id": "evt_01M1694617Q04F1T085TTM4F8C",
+                "key": "@config.relationEvent",
+                "name": "@config.relation event",
+                "payloadSchema": [
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "name",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "tier": "essential"
               }
             ],
             "states": [
@@ -301,6 +378,7 @@
                       "entity": "@entity",
                       "fields": "@config.fields",
                       "metaCommitEvent": "@config.metaCommitEvent",
+                      "relationEvent": "@config.relationEvent",
                       "title": "@config.title",
                       "type": "document-details"
                     }
@@ -309,6 +387,32 @@
                 "event": "INIT",
                 "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "entity": "@entity",
+                      "fields": "@config.fields",
+                      "metaCommitEvent": "@config.metaCommitEvent",
+                      "relationEvent": "@config.relationEvent",
+                      "title": "@config.title",
+                      "type": "document-details"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {
@@ -321,6 +425,7 @@
                       "entity": "@payload.data",
                       "fields": "@config.fields",
                       "metaCommitEvent": "@config.metaCommitEvent",
+                      "relationEvent": "@config.relationEvent",
                       "title": "@config.title",
                       "type": "document-details"
                     }

package/behaviors/registry/ui/core/molecules/ui-document-panel.orb

@@ -199,6 +199,12 @@
               "tier": "presentation",
               "type": "string"
             },
+            "coverImage": {
+              "description": "Cover/hero image URL painted as a full-bleed banner above the header row (Notion/article-hero shape); hidden when empty",
+              "label": "Cover Image",
+              "tier": "presentation",
+              "type": "string"
+            },
             "doneEvent": {
               "default": "DONE",
               "description": "Emitted by the Done button that ends the editing session: { id }",
@@ -232,6 +238,12 @@
               "tier": "presentation",
               "type": "boolean"
             },
+            "icon": {
+              "description": "Document icon rendered beside the title (a file glyph, a domain icon); hidden when empty",
+              "label": "Icon",
+              "tier": "presentation",
+              "type": "icon"
+            },
             "maxInlineActions": {
               "description": "0 collapses even the primary action into the menu",
               "label": "Max Inline Actions",
@@ -474,11 +486,13 @@
                       "autosaveHint": "@config.autosaveHint",
                       "className": "@config.className",
                       "contentChangeEvent": "@config.contentChangeEvent",
+                      "coverImage": "@config.coverImage",
                       "doneEvent": "@config.doneEvent",
                       "doneLabel": "@config.doneLabel",
                       "editEvent": "@config.editEvent",
                       "editLabel": "@config.editLabel",
                       "editing": "@config.editing",
+                      "icon": "@config.icon",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",
@@ -509,11 +523,13 @@
                       "autosaveHint": "@config.autosaveHint",
                       "className": "@config.className",
                       "contentChangeEvent": "@config.contentChangeEvent",
+                      "coverImage": "@config.coverImage",
                       "doneEvent": "@config.doneEvent",
                       "doneLabel": "@config.doneLabel",
                       "editEvent": "@config.editEvent",
                       "editLabel": "@config.editLabel",
                       "editing": "@config.editing",
+                      "icon": "@config.icon",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",
@@ -544,11 +560,13 @@
                       "autosaveHint": "@config.autosaveHint",
                       "className": "@config.className",
                       "contentChangeEvent": "@config.contentChangeEvent",
+                      "coverImage": "@config.coverImage",
                       "doneEvent": "@config.doneEvent",
                       "doneLabel": "@config.doneLabel",
                       "editEvent": "@config.editEvent",
                       "editLabel": "@config.editLabel",
                       "editing": "@config.editing",
+                      "icon": "@config.icon",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",

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

@@ -134,6 +134,29 @@
               "tier": "presentation",
               "type": "[FileTreeItemsItem]"
             },
+            "look": {
+              "default": "files",
+              "description": "Visual treatment for flat `items` mode: `files` (default) keeps the monospace file-browser look; `nav` renders a sidebar navigation tree — regular font, document icons, roomier hit areas.",
+              "label": "Look",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "files",
+                "nav"
+              ]
+            },
+            "nodeActionIcon": {
+              "description": "Icon for the row hover action (default: plus).",
+              "label": "Node Action Icon",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "nodeActionLabel": {
+              "description": "Accessible label/tooltip for the row hover action.",
+              "label": "Node Action Label",
+              "tier": "presentation",
+              "type": "string"
+            },
             "onFileSelect": {
               "default": "FILE_SELECT",
               "description": "Called when a file is clicked",
@@ -141,6 +164,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "onNodeAction": {
+              "default": "",
+              "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.",
+              "label": "On Node Action",
+              "tier": "presentation",
+              "type": "string"
+            },
             "onNodeSelect": {
               "default": "",
               "description": "Called when a node is clicked, in flat `items` mode; carries the selected node's id. Presence-gated: binding this prop is what turns on the click-to-select affordance, mirroring Badge's `onRemove`.",
@@ -148,6 +178,12 @@
               "tier": "presentation",
               "type": "string"
             },
+            "selectedId": {
+              "description": "Currently selected node id, in flat `items` mode: the row highlights and every ancestor auto-expands so the selection is always visible — the 'you are here' a navigation tree needs.",
+              "label": "Selected Id",
+              "tier": "presentation",
+              "type": "string"
+            },
             "selectedPath": {
               "description": "Currently selected file path",
               "label": "Selected Path",
@@ -269,8 +305,13 @@
                       "className": "@config.className",
                       "indent": "@config.indent",
                       "items": "@config.items",
+                      "look": "@config.look",
+                      "nodeActionIcon": "@config.nodeActionIcon",
+                      "nodeActionLabel": "@config.nodeActionLabel",
                       "onFileSelect": "@config.onFileSelect",
+                      "onNodeAction": "@config.onNodeAction",
                       "onNodeSelect": "@config.onNodeSelect",
+                      "selectedId": "@config.selectedId",
                       "selectedPath": "@config.selectedPath",
                       "tree": "@config.tree",
                       "type": "file-tree"

package/behaviors/registry/ui/core/molecules/ui-positioned-canvas.orb

@@ -213,6 +213,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
+            },
             "width": {
               "default": 800.0,
               "description": "width prop",
@@ -379,6 +386,36 @@
                 "event": "INIT",
                 "eventId": "evt_01KXG04QK8NJ7JNE65YZ899XWA",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "editable": "@config.editable",
+                      "height": "@config.height",
+                      "items": "@entity",
+                      "moveEvent": "@config.moveEvent",
+                      "onMove": "@config.onMove",
+                      "onSelect": "@config.onSelect",
+                      "selectEvent": "@config.selectEvent",
+                      "selectedId": "@config.selectedId",
+                      "type": "positioned-canvas",
+                      "width": "@config.width"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04QK8NJ7JNE65YZ899XWA",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {

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

@@ -232,6 +232,13 @@
               "tier": "presentation",
               "type": "string"
             },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
+            },
             "showActions": {
               "default": true,
               "description": "showActions prop",
@@ -461,6 +468,38 @@
                 "event": "INIT",
                 "eventId": "evt_01KXG04QWSXSBBRW7AVGKVHDQ8",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "continueThreadEvent": "@config.continueThreadEvent",
+                      "flagEvent": "@config.flagEvent",
+                      "maxDepth": "@config.maxDepth",
+                      "nodes": "@entity",
+                      "onContinueThread": "@config.onContinueThread",
+                      "onFlag": "@config.onFlag",
+                      "onReply": "@config.onReply",
+                      "onVote": "@config.onVote",
+                      "replyEvent": "@config.replyEvent",
+                      "showActions": "@config.showActions",
+                      "type": "reply-tree",
+                      "voteEvent": "@config.voteEvent"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04QWSXSBBRW7AVGKVHDQ8",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {

package/behaviors/registry/ui/core/molecules/ui-sortable-list.orb

@@ -135,6 +135,13 @@
               "label": "Reorder Payload",
               "tier": "presentation",
               "type": "json"
+            },
+            "selfFetch": {
+              "default": true,
+              "description": "true (default) = standalone mount self-populates on INIT. false = a composing atom owns the fetch and routes its loaded event here — suppresses the wrapper's own un-hydrated fetch so it cannot race the composer's.",
+              "label": "Fetch its own rows on mount?",
+              "tier": "internal",
+              "type": "boolean"
             }
           },
           "emits": [
@@ -261,6 +268,44 @@
                 "event": "INIT",
                 "eventId": "evt_01KXG04RHS5P5JWNREKWNE5SAQ",
                 "from": "idle",
+                "guard": "@config.selfFetch",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "dragHandlePosition": "@config.dragHandlePosition",
+                      "items": "@entity",
+                      "renderItem": [
+                        "fn",
+                        "item",
+                        {
+                          "content": [
+                            "object/get",
+                            "@item",
+                            "@config.itemLabelField",
+                            ""
+                          ],
+                          "type": "typography"
+                        }
+                      ],
+                      "reorderEvent": "@config.reorderEvent",
+                      "reorderPayload": "@config.reorderPayload",
+                      "type": "sortable-list"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01KXG04RHS5P5JWNREKWNE5SAQ",
+                "from": "idle",
+                "guard": [
+                  "not",
+                  "@config.selfFetch"
+                ],
                 "to": "idle"
               },
               {