@almadar/std 16.187.0 → 16.189.0

package/behaviors/registry/ui/core/atoms/std-tree.orb

@@ -1,5 +1,5 @@
 {
-  "description": "std-tree — generic hierarchical node browser. Fetches a flat TreeNode collection and renders it through file-tree's flat `items` mode (parentId-nested at render time by the component, not the .lolo); OPEN_NODE is the external handoff for a selected node's id. Rebindable: pass `fields` at the call site to retarget it at any parent-pointer entity (categories, org units, comment threads).",
+  "description": "std-tree — generic hierarchical node browser. Fetches a flat TreeNode collection and renders it through file-tree's flat `items` mode (parentId-nested at render time by the component, not the .lolo); OPEN_NODE is the external handoff for a selected node's id. Rebindable: pass `fields` at the call site to retarget it at any parent-pointer entity (categories, org units, comment threads). Search/filter are wired (REFETCH_QUERY/REFETCH_FILTER re-fetch the flat node set server-side); pagination is deliberately NOT offered — a hierarchy is not a paged list, and paging a flat node set would sever children from parents that fell on another page.",
   "ledger": {
     "entries": {
       "ent_01M0RYHNM1NXR2J5S0HK2WFDS3": {
@@ -55,6 +55,24 @@
         "parent": "trt_01M0RYHNM11N15TSY0QWVC2GH5",
         "renames": []
       },
+      "evt_01M11H00X42VFQ0VXEXV7ES6F9": {
+        "bakedName": "REFETCH_QUERY",
+        "curName": "REFETCH_QUERY",
+        "id": "evt_01M11H00X42VFQ0VXEXV7ES6F9",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYHNM11N15TSY0QWVC2GH5",
+        "renames": []
+      },
+      "evt_01M11H00X4BMW519Q3CSP735Z8": {
+        "bakedName": "REFETCH_FILTER",
+        "curName": "REFETCH_FILTER",
+        "id": "evt_01M11H00X4BMW519Q3CSP735Z8",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M0RYHNM11N15TSY0QWVC2GH5",
+        "renames": []
+      },
       "orb_01M0RYHNM15ZXYERAB9GSZFAZE": {
         "bakedName": "TreeNodeOrbital",
         "curName": "TreeNodeOrbital",
@@ -142,6 +160,68 @@
         {
           "category": "interaction",
           "config": {
+            "bodySearch": {
+              "default": false,
+              "description": "Embeds a search box above the tree that re-fetches the flat node set server-side. Set false (the default) when the page already provides a search affordance (a toolbar Search molecule), so the surface shows one search box instead of two.",
+              "label": "Show the tree's own search box?",
+              "synonyms": "inline search, list search, built-in search, show search, duplicate search",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "filterBarLook": {
+              "default": "toolbar",
+              "description": "Visual treatment for the embedded filter bar, mirroring std-filter's own enum. Only applies when `filters` is non-empty.",
+              "label": "Filter bar look",
+              "synonyms": "filter bar style, facet style, chips, pills",
+              "tier": "presentation",
+              "type": "string",
+              "values": [
+                "toolbar",
+                "chips",
+                "pills",
+                "popover-trigger",
+                "inline-column-header"
+              ]
+            },
+            "filters": {
+              "default": [],
+              "description": "Dropdown filter facets by field, rendered as an embedded filter bar above the tree; each selection fires REFETCH_FILTER on this trait, re-fetching the flat node set. Empty (the default) = no filter bar, which is the right setting whenever the page already composes std-filter beside this tree and routes `XFilter.FILTER -> REFETCH_FILTER` — that is the wired owner and remains the primary path.",
+              "items": {
+                "properties": {
+                  "field": {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "options": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "options",
+                    "required": false,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Which filters should appear above the tree?",
+              "synonyms": "filter bar, faceted filters, field filters, dropdowns",
+              "tier": "presentation",
+              "type": "[FilterSpec]"
+            },
+            "searchPlaceholder": {
+              "default": "Search…",
+              "description": "Hint text inside the tree search box (e.g. 'Search nodes…').",
+              "label": "Search box placeholder text",
+              "synonyms": "search hint, placeholder, search box text, search label",
+              "tier": "presentation",
+              "type": "string"
+            },
             "title": {
               "default": "Tree",
               "description": "Heading shown above the tree",
@@ -248,6 +328,41 @@
                 "synonyms": "error, failed, problem, unsuccessful",
                 "tier": "internal"
               },
+              {
+                "description": "Triggers a tree refresh based on the current search query.",
+                "id": "evt_01M11H00X42VFQ0VXEXV7ES6F9",
+                "key": "REFETCH_QUERY",
+                "name": "Refetch Query",
+                "payloadSchema": [
+                  {
+                    "name": "searchTerm",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "refresh, reload, update, re-query",
+                "tier": "domain"
+              },
+              {
+                "description": "Triggers a tree refresh based on current filter criteria.",
+                "id": "evt_01M11H00X4BMW519Q3CSP735Z8",
+                "key": "REFETCH_FILTER",
+                "name": "Refetch Filter",
+                "payloadSchema": [
+                  {
+                    "name": "field",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "value",
+                    "required": true,
+                    "type": "string"
+                  }
+                ],
+                "synonyms": "refresh, filter, update, reload",
+                "tier": "domain"
+              },
               {
                 "description": "Signals a tree node has been selected for external handoff.",
                 "id": "evt_01M0RYHNM50RK3ZYBW4S0JVZ2N",
@@ -358,6 +473,59 @@
                         {
                           "type": "divider"
                         },
+                        [
+                          "if",
+                          "@config.bodySearch",
+                          {
+                            "children": [
+                              {
+                                "className": "w-full max-w-md",
+                                "clearable": true,
+                                "event": "REFETCH_QUERY",
+                                "placeholder": "@config.searchPlaceholder",
+                                "type": "search-input"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
+                        [
+                          "if",
+                          [
+                            ">",
+                            [
+                              "array/len",
+                              "@config.filters"
+                            ],
+                            0.0
+                          ],
+                          {
+                            "children": [
+                              {
+                                "entity": "TreeNode",
+                                "event": "REFETCH_FILTER",
+                                "filters": "@config.filters",
+                                "look": "@config.filterBarLook",
+                                "type": "filter-group"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
                         {
                           "items": [
                             "array/map",
@@ -472,6 +640,76 @@
                 "from": "browsing",
                 "to": "loading"
               },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "TreeNode",
+                    {
+                      "emit": {
+                        "failure": "TreeNodeLoadFailed",
+                        "success": "TreeNodeLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.searchTerm",
+                          ""
+                        ],
+                        [
+                          "str/includes",
+                          [
+                            "object/get",
+                            "@entity",
+                            "name"
+                          ],
+                          "@payload.searchTerm"
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "REFETCH_QUERY",
+                "eventId": "evt_01M11H00X42VFQ0VXEXV7ES6F9",
+                "from": "browsing",
+                "to": "browsing"
+              },
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "TreeNode",
+                    {
+                      "emit": {
+                        "failure": "TreeNodeLoadFailed",
+                        "success": "TreeNodeLoaded"
+                      },
+                      "filter": [
+                        "or",
+                        [
+                          "=",
+                          "@payload.value",
+                          ""
+                        ],
+                        [
+                          "=",
+                          [
+                            "object/get",
+                            "@entity",
+                            "@payload.field"
+                          ],
+                          "@payload.value"
+                        ]
+                      ]
+                    }
+                  ]
+                ],
+                "event": "REFETCH_FILTER",
+                "eventId": "evt_01M11H00X4BMW519Q3CSP735Z8",
+                "from": "browsing",
+                "to": "browsing"
+              },
               {
                 "effects": [
                   [
@@ -521,6 +759,59 @@
                         {
                           "type": "divider"
                         },
+                        [
+                          "if",
+                          "@config.bodySearch",
+                          {
+                            "children": [
+                              {
+                                "className": "w-full max-w-md",
+                                "clearable": true,
+                                "event": "REFETCH_QUERY",
+                                "placeholder": "@config.searchPlaceholder",
+                                "type": "search-input"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
+                        [
+                          "if",
+                          [
+                            ">",
+                            [
+                              "array/len",
+                              "@config.filters"
+                            ],
+                            0.0
+                          ],
+                          {
+                            "children": [
+                              {
+                                "entity": "TreeNode",
+                                "event": "REFETCH_FILTER",
+                                "filters": "@config.filters",
+                                "look": "@config.filterBarLook",
+                                "type": "filter-group"
+                              }
+                            ],
+                            "direction": "horizontal",
+                            "gap": "sm",
+                            "type": "stack"
+                          },
+                          {
+                            "children": [],
+                            "gap": "none",
+                            "type": "stack"
+                          }
+                        ],
                         {
                           "items": [
                             "array/map",

package/behaviors/registry/ui/core/atoms/std-version-history.orb

@@ -172,7 +172,7 @@
             "type": "string"
           },
           {
-            "description": "The textual data of the revision.",
+            "description": "The snapshotted body of the revision — plain text or the rich-text HTML a document-look record carries. Rollback hands the whole row back to the host, which restores content onto the source document.",
             "name": "content",
             "synonyms": "text, body, data, value",
             "type": "string"

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

@@ -0,0 +1,342 @@
+{
+  "description": "DocumentDetails — the document's metadata as a compact settings card for the rail beside a DocumentPanel, each property committing in place. — UI factory (1:1 with the @almadar/ui document-details pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M13ZXC5915PAZWDBTP787F3C": {
+        "bakedName": "DocumentDetailsItem",
+        "curName": "DocumentDetailsItem",
+        "id": "ent_01M13ZXC5915PAZWDBTP787F3C",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M13ZXC59HB41Z83ZYJR50JQP": {
+        "bakedName": "DocumentDetailsLoaded",
+        "curName": "DocumentDetailsLoaded",
+        "id": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "renames": []
+      },
+      "evt_01M13ZXC59R4VP1T1DHD262B08": {
+        "bakedName": "@config.metaCommitEvent",
+        "curName": "@config.metaCommitEvent",
+        "id": "evt_01M13ZXC59R4VP1T1DHD262B08",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "renames": []
+      },
+      "evt_01M13ZXC59XKCDATMN4TVFVMZ7": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "renames": []
+      },
+      "orb_01M13ZXC59HR3466AAAMSKD8MY": {
+        "bakedName": "DocumentDetailsOrbital",
+        "curName": "DocumentDetailsOrbital",
+        "id": "orb_01M13ZXC59HR3466AAAMSKD8MY",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M13ZXC59XXQ26RB47SYE4W95": {
+        "bakedName": "DocumentDetailsPage",
+        "curName": "DocumentDetailsPage",
+        "id": "pag_01M13ZXC59XXQ26RB47SYE4W95",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M13ZXC5906BVQKXF5JMWBD0E": {
+        "bakedName": "DocumentDetailsRender",
+        "curName": "DocumentDetailsRender",
+        "id": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-document-details",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          }
+        ],
+        "id": "ent_01M13ZXC5915PAZWDBTP787F3C",
+        "name": "DocumentDetailsItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M13ZXC59HR3466AAAMSKD8MY",
+      "name": "DocumentDetailsOrbital",
+      "pages": [
+        {
+          "id": "pag_01M13ZXC59XXQ26RB47SYE4W95",
+          "name": "DocumentDetailsPage",
+          "path": "/document-details",
+          "traits": [
+            {
+              "ref": "DocumentDetailsRender",
+              "refId": "trt_01M13ZXC5906BVQKXF5JMWBD0E"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "className": {
+              "description": "className prop",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "fields": {
+              "default": [],
+              "description": "The properties shown; empty renders nothing.",
+              "items": {
+                "properties": {
+                  "format": {
+                    "name": "format",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "date",
+                      "currency",
+                      "number",
+                      "boolean",
+                      "percent"
+                    ]
+                  },
+                  "header": {
+                    "name": "header",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "key": {
+                    "name": "key",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "kind": {
+                    "name": "kind",
+                    "required": false,
+                    "type": "string",
+                    "values": [
+                      "text",
+                      "boolean",
+                      "select",
+                      "readonly"
+                    ]
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "name": {
+                    "name": "name",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "options": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "options",
+                    "required": false,
+                    "type": "array"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Fields",
+              "tier": "presentation",
+              "type": "[DocumentDetailsFieldsItem]"
+            },
+            "metaCommitEvent": {
+              "default": "META_COMMIT",
+              "description": "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update.",
+              "label": "Meta Commit Event",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "title": {
+              "description": "Card heading (defaults to the localized 'Details')",
+              "label": "Title",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "description": "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update.",
+              "event": "@config.metaCommitEvent",
+              "eventId": "evt_01M13ZXC59R4VP1T1DHD262B08",
+              "payloadSchema": [
+                {
+                  "name": "id",
+                  "required": true,
+                  "type": "string"
+                },
+                {
+                  "name": "patch",
+                  "required": true,
+                  "type": "object"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
+              "event": "DocumentDetailsLoaded",
+              "eventId": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+              "payloadSchema": [
+                {
+                  "name": "data",
+                  "type": "[DocumentDetailsItem]"
+                }
+              ],
+              "scope": "internal",
+              "synonyms": "loaded, fetched, retrieved",
+              "tier": "essential"
+            }
+          ],
+          "entityContract": {
+            "provides": [],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "DocumentDetailsItem": "ent_01M13ZXC5915PAZWDBTP787F3C"
+          },
+          "id": "trt_01M13ZXC5906BVQKXF5JMWBD0E",
+          "linkedEntity": "DocumentDetailsItem",
+          "linkedEntityId": "ent_01M13ZXC5915PAZWDBTP787F3C",
+          "name": "DocumentDetailsRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "description": "DocumentDetails rows finished loading; payload.data holds the collection.",
+                "id": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+                "key": "DocumentDetailsLoaded",
+                "name": "Document details loaded",
+                "payloadSchema": [
+                  {
+                    "name": "data",
+                    "type": "[DocumentDetailsItem]"
+                  }
+                ],
+                "synonyms": "loaded, fetched, retrieved",
+                "tier": "essential"
+              },
+              {
+                "description": "Emitted when a property commits: { id, patch } — patch carries the id plus the one changed field, ready for a partial persist update.",
+                "id": "evt_01M13ZXC59R4VP1T1DHD262B08",
+                "key": "@config.metaCommitEvent",
+                "name": "@config.meta commit event",
+                "payloadSchema": [
+                  {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  {
+                    "name": "patch",
+                    "required": true,
+                    "type": "object"
+                  }
+                ],
+                "tier": "essential"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "fetch",
+                    "DocumentDetailsItem",
+                    {
+                      "emit": {
+                        "success": "DocumentDetailsLoaded"
+                      }
+                    }
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "entity": "@entity",
+                      "fields": "@config.fields",
+                      "metaCommitEvent": "@config.metaCommitEvent",
+                      "title": "@config.title",
+                      "type": "document-details"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M13ZXC59XKCDATMN4TVFVMZ7",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "entity": "@payload.data",
+                      "fields": "@config.fields",
+                      "metaCommitEvent": "@config.metaCommitEvent",
+                      "title": "@config.title",
+                      "type": "document-details"
+                    }
+                  ]
+                ],
+                "event": "DocumentDetailsLoaded",
+                "eventId": "evt_01M13ZXC59HB41Z83ZYJR50JQP",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ]
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}