@almadar/std 16.192.0 → 16.194.0

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

@@ -192,14 +192,14 @@
               "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"
+              "type": "event"
             },
             "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"
+              "type": "event"
             },
             "selfFetch": {
               "default": true,

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

@@ -150,7 +150,7 @@
                   "event": {
                     "name": "event",
                     "required": false,
-                    "type": "string"
+                    "type": "event"
                   },
                   "icon": {
                     "name": "icon",
@@ -197,7 +197,7 @@
               "description": "Forwarded to the embedded RichTextEditor's autosave stream: { value }",
               "label": "Content Change Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "coverImage": {
               "description": "Cover/hero image URL painted as a full-bleed banner above the header row (Notion/article-hero shape); hidden when empty",
@@ -210,7 +210,7 @@
               "description": "Emitted by the Done button that ends the editing session: { id }",
               "label": "Done Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "doneLabel": {
               "description": "doneLabel prop",
@@ -223,7 +223,7 @@
               "description": "Emitted by the header Edit affordance and a click on the read body: { id }",
               "label": "Edit Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "editLabel": {
               "description": "editLabel prop",
@@ -273,7 +273,7 @@
               "description": "Emitted when the title commits: { title, id }",
               "label": "Title Commit Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "value": {
               "description": "The document body as rich-text HTML",

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

@@ -123,8 +123,9 @@
               "default": "CLOSE",
               "description": "Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close",
               "label": "Close Event",
+              "refId": "evt_01KXG04NNQMAR2GZF96Z86E0YV",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "closeOnEscape": {
               "default": true,
@@ -158,7 +159,7 @@
               "description": "Callback when drawer should close (injected by slot wrapper)",
               "label": "On Close",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "position": {
               "default": "right",

package/behaviors/registry/ui/core/molecules/ui-emoji-picker.orb

@@ -100,7 +100,7 @@
               "description": "Declarative event name — picking an emoji emits UI:{pickEvent} with { emoji } via eventBus",
               "label": "Pick Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "position": {
               "default": "top",

package/behaviors/registry/ui/core/molecules/ui-empty-state.orb

@@ -94,7 +94,7 @@
               "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked",
               "label": "Action Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "actionLabel": {
               "description": "actionLabel prop",
@@ -150,7 +150,7 @@
               "description": "onAction prop",
               "label": "On Action",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "title": {
               "description": "Primary text to display - use title or message (message is alias for backwards compat)",

package/behaviors/registry/ui/core/molecules/ui-error-state.orb

@@ -112,14 +112,14 @@
               "description": "onRetry prop",
               "label": "On Retry",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "retryEvent": {
               "default": "RETRY",
               "description": "Declarative retry event — emits UI:{retryEvent} via eventBus when retry button is clicked",
               "label": "Retry Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "title": {
               "description": "title prop",

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

@@ -134,18 +134,54 @@
               "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",
               "label": "On File Select",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
+            },
+            "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": "event"
             },
             "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`.",
               "label": "On Node Select",
               "tier": "presentation",
+              "type": "event"
+            },
+            "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": {
@@ -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-filter-group.orb

@@ -127,14 +127,14 @@
               "description": "Declarative clear event — emits UI:{clearEvent} via eventBus on clear-all (alongside canonical UI:CLEAR_FILTERS)",
               "label": "Clear Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "event": {
               "default": "EVENT",
               "description": "Declarative filter event — emits UI:{event} via eventBus on filter change (alongside canonical UI:FILTER)",
               "label": "Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "filters": {
               "default": [
@@ -265,14 +265,14 @@
               "description": "Callback to clear all filters",
               "label": "On Clear All",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onFilterChange": {
               "default": "FILTER_CHANGE",
               "description": "Callback when a filter changes - for EntityStore integration",
               "label": "On Filter Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "query": {
               "description": "Query singleton binding for state management. When provided, syncs filter state with the query singleton. Example: '@TaskQuery'",

package/behaviors/registry/ui/core/molecules/ui-flip-card.orb

@@ -128,7 +128,7 @@
               "description": "Callback when the card is clicked to flip",
               "label": "On Flip",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             }
           },
           "emits": [

package/behaviors/registry/ui/core/molecules/ui-floating-action-button.orb

@@ -103,7 +103,7 @@
               "description": "Declarative event name. When set, clicking the FAB emits `UI:{action}` via the event bus and (if also provided) calls `onClick`. Mirrors the Button atom's `action` prop so schemas can write `{ type: 'floating-action-button', action: 'INIT' }` uniformly.",
               "label": "Action",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "actionPayload": {
               "default": {},
@@ -179,7 +179,7 @@
               "description": "Optional direct click handler. Runs after the action emit when both are present.",
               "label": "On Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "position": {
               "default": "bottom-right",

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

@@ -147,7 +147,7 @@
               "description": "Toggle collapse handler (makes header clickable)",
               "label": "On Toggle",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "subtitle": {
               "description": "Section subtitle",

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

@@ -283,7 +283,7 @@
               "description": "Node click event",
               "label": "Node Click Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "nodeSpacing": {
               "default": 28.0,
@@ -366,28 +366,28 @@
               "description": "On node badge click (e.g. to expand a merged cluster).",
               "label": "On Badge Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onMarkClick": {
               "default": "MARK_CLICK",
               "description": "On marked-node click (suggestion/proposal target). Takes priority over onNodeClick.",
               "label": "On Mark Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onNodeClick": {
               "default": "NODE_CLICK",
               "description": "On node click",
               "label": "On Node Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onNodeDoubleClick": {
               "default": "NODE_DOUBLE_CLICK",
               "description": "On node double-click (e.g. to drill in)",
               "label": "On Node Double Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "proposedEdges": {
               "default": [],

package/behaviors/registry/ui/core/molecules/ui-graph-view.orb

@@ -226,14 +226,14 @@
               "description": "Callback when a node is clicked",
               "label": "On Node Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onNodeHover": {
               "default": "NODE_HOVER",
               "description": "Callback when a node is hovered (null on leave)",
               "label": "On Node Hover",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "showLabels": {
               "default": true,

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

@@ -245,28 +245,28 @@
               "description": "Callback when logo/brand is clicked",
               "label": "On Logo Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onMenuToggle": {
               "default": "MENU_TOGGLE",
               "description": "Menu toggle callback",
               "label": "On Menu Toggle",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onSearch": {
               "default": "SEARCH",
               "description": "Search callback",
               "label": "On Search",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onUserClick": {
               "default": "USER_CLICK",
               "description": "Callback when user avatar is clicked",
               "label": "On User Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "searchPlaceholder": {
               "description": "Search placeholder",

package/behaviors/registry/ui/core/molecules/ui-import-preview-tree.orb

@@ -157,14 +157,14 @@
               "description": "Called when the user cancels the staged import",
               "label": "On Cancel",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onConfirm": {
               "default": "CONFIRM",
               "description": "Called when the user confirms the staged import",
               "label": "On Confirm",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "skipped": {
               "default": [],

package/behaviors/registry/ui/core/molecules/ui-import-source-picker.orb

@@ -106,7 +106,7 @@
               "description": "Called with the source id when an 'action' option is picked",
               "label": "On Select",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "sources": {
               "default": [

package/behaviors/registry/ui/core/molecules/ui-input-group.orb

@@ -112,7 +112,7 @@
               "description": "Declarative event name for trait dispatch",
               "label": "Action",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "className": {
               "description": "Additional CSS classes",
@@ -189,14 +189,14 @@
               "description": "onChange handler or declarative event key for trait dispatch",
               "label": "On Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onClear": {
               "default": "CLEAR",
               "description": "Callback or declarative event key when clear button is clicked",
               "label": "On Clear",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "options": {
               "default": [],

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

@@ -185,14 +185,14 @@
               "description": "Direct onClose callback",
               "label": "On Close",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onIndexChange": {
               "default": "INDEX_CHANGE",
               "description": "Direct onIndexChange callback",
               "label": "On Index Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "showCounter": {
               "default": true,

package/behaviors/registry/ui/core/molecules/ui-likert-scale.orb

@@ -94,7 +94,7 @@
               "description": "Event name dispatched via event bus on change. Payload: { value: number | string }",
               "label": "Change Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "className": {
               "description": "Additional CSS classes",
@@ -114,7 +114,7 @@
               "description": "Change callback",
               "label": "On Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "options": {
               "default": [],

package/behaviors/registry/ui/core/molecules/ui-map-view.orb

@@ -130,14 +130,14 @@
               "description": "Event name dispatched via event bus when the map is clicked. Payload: { latitude, longitude }",
               "label": "Map Click Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "markerClickEvent": {
               "default": "MARKER_CLICK",
               "description": "Event name dispatched via event bus when a marker is clicked. Payload: full MapMarkerData spread.",
               "label": "Marker Click Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "markers": {
               "default": [],
@@ -181,14 +181,14 @@
               "description": "Callback when the map is clicked (programmatic use)",
               "label": "On Map Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onMarkerClick": {
               "default": "MARKER_CLICK",
               "description": "Callback when a marker is clicked (programmatic use)",
               "label": "On Marker Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "routes": {
               "default": [],

package/behaviors/registry/ui/core/molecules/ui-matrix-question.orb

@@ -94,7 +94,7 @@
               "description": "Event name dispatched via event bus when a row's value changes. Payload: { rowId, value }",
               "label": "Change Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "className": {
               "description": "Additional CSS classes",
@@ -136,7 +136,7 @@
               "description": "Change handler invoked with rowId and selected column value",
               "label": "On Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "rows": {
               "default": [

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

@@ -132,8 +132,9 @@
               "default": "CLOSE",
               "description": "Declarative close event — emits UI:{closeEvent} via eventBus when modal should close",
               "label": "Close Event",
+              "refId": "evt_01KXG04Q5T3B6FYMBQPC1QFABB",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "closeOnEscape": {
               "default": true,
@@ -180,14 +181,14 @@
               "description": "Callback when modal should close (injected by slot wrapper)",
               "label": "On Close",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onExited": {
               "default": "EXITED",
               "description": "Fires after the exit animation completes (the modal is about to unmount).",
               "label": "On Exited",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "showCloseButton": {
               "default": true,

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

@@ -103,7 +103,7 @@
               "description": "Declarative action event — emits UI:{actionEvent} via eventBus when action button is clicked",
               "label": "Action Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "actionLabel": {
               "description": "Action button label",
@@ -128,7 +128,7 @@
               "description": "Declarative dismiss event — emits UI:{dismissEvent} via eventBus when toast is dismissed",
               "label": "Dismiss Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "dismissible": {
               "default": true,
@@ -156,14 +156,14 @@
               "description": "Action button click handler",
               "label": "On Action",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "onDismiss": {
               "default": "DISMISS",
               "description": "Callback when toast is dismissed",
               "label": "On Dismiss",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "title": {
               "description": "Toast title (optional)",

package/behaviors/registry/ui/core/molecules/ui-number-stepper.orb

@@ -117,7 +117,7 @@
               "description": "Declarative event name for value changes",
               "label": "Action",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "actionPayload": {
               "default": {},
@@ -162,7 +162,7 @@
               "description": "Direct onChange callback",
               "label": "On Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "size": {
               "default": "md",

package/behaviors/registry/ui/core/molecules/ui-option-constraint-group.orb

@@ -94,7 +94,7 @@
               "description": "changeEvent prop",
               "label": "Change Event",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "className": {
               "description": "className prop",
@@ -120,7 +120,7 @@
               "description": "onChange prop",
               "label": "On Change",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "options": {
               "default": [

package/behaviors/registry/ui/core/molecules/ui-orbital-visualization.orb

@@ -147,7 +147,7 @@
               "description": "Click handler",
               "label": "On Click",
               "tier": "presentation",
-              "type": "string"
+              "type": "event"
             },
             "schema": {
               "description": "Full KFlow schema object",