@almadar/std 16.190.0 → 16.192.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

@@ -19,15 +19,6 @@
         "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
         "renames": []
       },
-      "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ": {
-        "bakedName": "DocumentPanelLoaded",
-        "curName": "DocumentPanelLoaded",
-        "id": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
-        "kind": "event",
-        "owner": "workspace",
-        "parent": "trt_01M13ZXC5NZQG6MATNRKA9FPS0",
-        "renames": []
-      },
       "evt_01M13ZXC5N2JWNJQNCQBM7ZV84": {
         "bakedName": "TITLE_COMMIT",
         "curName": "TITLE_COMMIT",
@@ -208,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 }",
@@ -241,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",
@@ -340,20 +343,6 @@
               ],
               "scope": "external",
               "tier": "essential"
-            },
-            {
-              "description": "DocumentPanel rows finished loading; payload.data holds the collection.",
-              "event": "DocumentPanelLoaded",
-              "eventId": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
-              "payloadSchema": [
-                {
-                  "name": "data",
-                  "type": "[DocumentPanelItem]"
-                }
-              ],
-              "scope": "internal",
-              "synonyms": "loaded, fetched, retrieved",
-              "tier": "essential"
             }
           ],
           "entityContract": {
@@ -379,20 +368,6 @@
                 "key": "INIT",
                 "name": "Initialize"
               },
-              {
-                "description": "DocumentPanel rows finished loading; payload.data holds the collection.",
-                "id": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
-                "key": "DocumentPanelLoaded",
-                "name": "Document panel loaded",
-                "payloadSchema": [
-                  {
-                    "name": "data",
-                    "type": "[DocumentPanelItem]"
-                  }
-                ],
-                "synonyms": "loaded, fetched, retrieved",
-                "tier": "essential"
-              },
               {
                 "id": "evt_01M13ZXC5N2JWNJQNCQBM7ZV84",
                 "key": "TITLE_COMMIT",
@@ -493,15 +468,6 @@
             "transitions": [
               {
                 "effects": [
-                  [
-                    "fetch",
-                    "DocumentPanelItem",
-                    {
-                      "emit": {
-                        "success": "DocumentPanelLoaded"
-                      }
-                    }
-                  ],
                   [
                     "set",
                     "@entity.title",
@@ -520,12 +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",
-                      "entity": "@entity",
+                      "icon": "@config.icon",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",
@@ -541,37 +508,6 @@
                 "from": "idle",
                 "to": "idle"
               },
-              {
-                "effects": [
-                  [
-                    "render-ui",
-                    "main",
-                    {
-                      "actions": "@config.actions",
-                      "autosaveHint": "@config.autosaveHint",
-                      "className": "@config.className",
-                      "contentChangeEvent": "@config.contentChangeEvent",
-                      "doneEvent": "@config.doneEvent",
-                      "doneLabel": "@config.doneLabel",
-                      "editEvent": "@config.editEvent",
-                      "editLabel": "@config.editLabel",
-                      "editing": "@config.editing",
-                      "entity": "@payload.data",
-                      "maxInlineActions": "@config.maxInlineActions",
-                      "placeholder": "@config.placeholder",
-                      "subtitle": "@config.subtitle",
-                      "title": "@entity.title",
-                      "titleCommitEvent": "@config.titleCommitEvent",
-                      "type": "document-panel",
-                      "value": "@entity.value"
-                    }
-                  ]
-                ],
-                "event": "DocumentPanelLoaded",
-                "eventId": "evt_01M13ZXC5N14ASYCGJ3EKEDMSQ",
-                "from": "idle",
-                "to": "idle"
-              },
               {
                 "effects": [
                   [
@@ -587,12 +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",
-                      "entity": "@entity",
+                      "icon": "@config.icon",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",
@@ -623,12 +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",
-                      "entity": "@entity",
+                      "icon": "@config.icon",
                       "maxInlineActions": "@config.maxInlineActions",
                       "placeholder": "@config.placeholder",
                       "subtitle": "@config.subtitle",

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"
               },
               {