@almadar/std 16.200.0 → 16.202.0

package/behaviors/registry/ui/core/molecules/ui-command-palette.orb

@@ -0,0 +1,589 @@
+{
+  "description": "CommandPalette — UI factory (1:1 with the @almadar/ui command-palette pattern).",
+  "ledger": {
+    "entries": {
+      "ent_01M1KNYATVYPS9P6E4EDEYNG4B": {
+        "bakedName": "CommandPaletteItem",
+        "curName": "CommandPaletteItem",
+        "id": "ent_01M1KNYATVYPS9P6E4EDEYNG4B",
+        "kind": "entity",
+        "owner": "workspace",
+        "renames": []
+      },
+      "evt_01M1KNYATV6A6183DCAHAV8G29": {
+        "bakedName": "@config.onOpenChange",
+        "curName": "@config.onOpenChange",
+        "id": "evt_01M1KNYATV6A6183DCAHAV8G29",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ",
+        "renames": []
+      },
+      "evt_01M1KNYATVPVN3340QMMFYF7Q4": {
+        "bakedName": "@config.onSelect",
+        "curName": "@config.onSelect",
+        "id": "evt_01M1KNYATVPVN3340QMMFYF7Q4",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ",
+        "renames": []
+      },
+      "evt_01M1KNYATVTSADY2GNXYEGFVGQ": {
+        "bakedName": "OPEN_CHANGE",
+        "curName": "OPEN_CHANGE",
+        "id": "evt_01M1KNYATVTSADY2GNXYEGFVGQ",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ",
+        "renames": []
+      },
+      "evt_01M1KNYATVV11B8MNEAHHAR28X": {
+        "bakedName": "INIT",
+        "curName": "INIT",
+        "id": "evt_01M1KNYATVV11B8MNEAHHAR28X",
+        "kind": "event",
+        "owner": "workspace",
+        "parent": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ",
+        "renames": []
+      },
+      "orb_01M1KNYATVRR0J0XVKGCXEN3DY": {
+        "bakedName": "CommandPaletteOrbital",
+        "curName": "CommandPaletteOrbital",
+        "id": "orb_01M1KNYATVRR0J0XVKGCXEN3DY",
+        "kind": "orbital",
+        "owner": "workspace",
+        "renames": []
+      },
+      "pag_01M1KNYATVTH98ZHA1CFNEDKWQ": {
+        "bakedName": "CommandPalettePage",
+        "curName": "CommandPalettePage",
+        "id": "pag_01M1KNYATVTH98ZHA1CFNEDKWQ",
+        "kind": "page",
+        "owner": "workspace",
+        "renames": []
+      },
+      "trt_01M1KNYATV6QJY03T0Z3RRNQSZ": {
+        "bakedName": "CommandPaletteRender",
+        "curName": "CommandPaletteRender",
+        "id": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ",
+        "kind": "trait",
+        "owner": "workspace",
+        "renames": []
+      }
+    },
+    "schemaVersion": 1
+  },
+  "name": "ui-command-palette",
+  "orbitals": [
+    {
+      "entity": {
+        "fields": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "default": false,
+            "name": "open",
+            "type": "boolean"
+          }
+        ],
+        "id": "ent_01M1KNYATVYPS9P6E4EDEYNG4B",
+        "name": "CommandPaletteItem",
+        "persistence": "runtime"
+      },
+      "id": "orb_01M1KNYATVRR0J0XVKGCXEN3DY",
+      "name": "CommandPaletteOrbital",
+      "pages": [
+        {
+          "id": "pag_01M1KNYATVTH98ZHA1CFNEDKWQ",
+          "name": "CommandPalettePage",
+          "path": "/command-palette",
+          "traits": [
+            {
+              "ref": "CommandPaletteRender",
+              "refId": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ"
+            }
+          ]
+        }
+      ],
+      "traits": [
+        {
+          "category": "interaction",
+          "config": {
+            "className": {
+              "description": "Additional CSS classes on the overlay's dialog",
+              "label": "Class Name",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "commands": {
+              "default": [
+                {
+                  "action": "Action",
+                  "disabled": false,
+                  "group": "Group",
+                  "icon": "circle",
+                  "id": "Id",
+                  "keywords": [
+                    "Item",
+                    "Item 2"
+                  ],
+                  "label": "Label",
+                  "shortcut": "Shortcut"
+                },
+                {
+                  "action": "Action 2",
+                  "disabled": true,
+                  "group": "Group 2",
+                  "icon": "circle",
+                  "id": "Id 2",
+                  "keywords": [
+                    "Item",
+                    "Item 2"
+                  ],
+                  "label": "Label 2",
+                  "shortcut": "Shortcut 2"
+                }
+              ],
+              "description": "Commands listed in the palette, filtered as the user types",
+              "items": {
+                "properties": {
+                  "action": {
+                    "name": "action",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "actionPayload": {
+                    "items": {
+                      "type": "scalar"
+                    },
+                    "name": "actionPayload",
+                    "required": false,
+                    "type": "object"
+                  },
+                  "disabled": {
+                    "name": "disabled",
+                    "required": false,
+                    "type": "boolean"
+                  },
+                  "event": {
+                    "name": "event",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "group": {
+                    "name": "group",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "icon": {
+                    "name": "icon",
+                    "required": false,
+                    "type": "string"
+                  },
+                  "id": {
+                    "name": "id",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "keywords": {
+                    "items": {
+                      "type": "string"
+                    },
+                    "name": "keywords",
+                    "required": false,
+                    "type": "array"
+                  },
+                  "label": {
+                    "name": "label",
+                    "required": true,
+                    "type": "string"
+                  },
+                  "shortcut": {
+                    "name": "shortcut",
+                    "required": false,
+                    "type": "string"
+                  }
+                },
+                "type": "object"
+              },
+              "label": "Commands",
+              "tier": "presentation",
+              "type": "[CommandPaletteCommandsItem]"
+            },
+            "emptyLabel": {
+              "default": "No matching commands",
+              "description": "Label shown when no command matches the query",
+              "label": "Empty Label",
+              "tier": "presentation",
+              "type": "string"
+            },
+            "onOpenChange": {
+              "default": "OPEN_CHANGE",
+              "description": "Called to open/close the overlay (Escape, overlay click, or a selection)",
+              "label": "On Open Change",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "onSelect": {
+              "default": "SELECT",
+              "description": "Called with the selected command (click, or Enter on the highlighted row)",
+              "label": "On Select",
+              "tier": "presentation",
+              "type": "event"
+            },
+            "open": {
+              "default": false,
+              "description": "Whether the palette overlay is open",
+              "label": "Open",
+              "tier": "presentation",
+              "type": "boolean"
+            },
+            "placeholder": {
+              "default": "Type a command...",
+              "description": "Search field placeholder. Consumers own i18n — plain string prop, no package-internal translation (matches FloatingToolbar's convention).",
+              "label": "Placeholder",
+              "tier": "presentation",
+              "type": "string"
+            }
+          },
+          "emits": [
+            {
+              "definerKnob": "onOpenChange",
+              "description": "Called to open/close the overlay (Escape, overlay click, or a selection)",
+              "event": "@config.onOpenChange",
+              "eventId": "evt_01M1KNYATV6A6183DCAHAV8G29",
+              "payloadSchema": [
+                {
+                  "name": "open",
+                  "type": "boolean"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            },
+            {
+              "definerKnob": "onSelect",
+              "description": "Called with the selected command (click, or Enter on the highlighted row)",
+              "event": "@config.onSelect",
+              "eventId": "evt_01M1KNYATVPVN3340QMMFYF7Q4",
+              "payloadSchema": [
+                {
+                  "name": "command",
+                  "properties": [
+                    {
+                      "name": "id",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "label",
+                      "required": true,
+                      "type": "string"
+                    },
+                    {
+                      "name": "icon",
+                      "type": "icon"
+                    },
+                    {
+                      "name": "shortcut",
+                      "type": "string"
+                    },
+                    {
+                      "name": "keywords",
+                      "type": "[string]"
+                    },
+                    {
+                      "name": "group",
+                      "type": "string"
+                    },
+                    {
+                      "name": "disabled",
+                      "type": "boolean"
+                    },
+                    {
+                      "name": "event",
+                      "type": "string"
+                    },
+                    {
+                      "name": "action",
+                      "type": "string"
+                    },
+                    {
+                      "name": "actionPayload",
+                      "type": "Map<string,scalar>"
+                    }
+                  ],
+                  "type": "object"
+                }
+              ],
+              "scope": "external",
+              "tier": "essential"
+            }
+          ],
+          "entityContract": {
+            "provides": [
+              "open"
+            ],
+            "requires": []
+          },
+          "entityRebindable": true,
+          "entityRefIds": {
+            "CommandPaletteItem": "ent_01M1KNYATVYPS9P6E4EDEYNG4B"
+          },
+          "id": "trt_01M1KNYATV6QJY03T0Z3RRNQSZ",
+          "linkedEntity": "CommandPaletteItem",
+          "linkedEntityId": "ent_01M1KNYATVYPS9P6E4EDEYNG4B",
+          "name": "CommandPaletteRender",
+          "scope": "instance",
+          "stateMachine": {
+            "events": [
+              {
+                "id": "evt_01M1KNYATVV11B8MNEAHHAR28X",
+                "key": "INIT",
+                "name": "Initialize"
+              },
+              {
+                "id": "evt_01M1KNYATVTSADY2GNXYEGFVGQ",
+                "key": "OPEN_CHANGE",
+                "name": "Open Change",
+                "payloadSchema": [
+                  {
+                    "name": "open",
+                    "type": "boolean"
+                  }
+                ]
+              },
+              {
+                "description": "Called to open/close the overlay (Escape, overlay click, or a selection)",
+                "id": "evt_01M1KNYATV6A6183DCAHAV8G29",
+                "key": "@config.onOpenChange",
+                "name": "@config.on open change",
+                "payloadSchema": [
+                  {
+                    "name": "open",
+                    "type": "boolean"
+                  }
+                ],
+                "tier": "essential"
+              },
+              {
+                "description": "Called with the selected command (click, or Enter on the highlighted row)",
+                "id": "evt_01M1KNYATVPVN3340QMMFYF7Q4",
+                "key": "@config.onSelect",
+                "name": "@config.on select",
+                "payloadSchema": [
+                  {
+                    "name": "command",
+                    "properties": [
+                      {
+                        "name": "id",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "label",
+                        "required": true,
+                        "type": "string"
+                      },
+                      {
+                        "name": "icon",
+                        "type": "icon"
+                      },
+                      {
+                        "name": "shortcut",
+                        "type": "string"
+                      },
+                      {
+                        "name": "keywords",
+                        "type": "[string]"
+                      },
+                      {
+                        "name": "group",
+                        "type": "string"
+                      },
+                      {
+                        "name": "disabled",
+                        "type": "boolean"
+                      },
+                      {
+                        "name": "event",
+                        "type": "string"
+                      },
+                      {
+                        "name": "action",
+                        "type": "string"
+                      },
+                      {
+                        "name": "actionPayload",
+                        "type": "Map<string,scalar>"
+                      }
+                    ],
+                    "type": "object"
+                  }
+                ],
+                "tier": "essential"
+              }
+            ],
+            "states": [
+              {
+                "isInitial": true,
+                "name": "idle"
+              }
+            ],
+            "transitions": [
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.open",
+                    "@config.open"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "commands": "@config.commands",
+                      "emptyLabel": "@config.emptyLabel",
+                      "onOpenChange": "@config.onOpenChange",
+                      "onSelect": "@config.onSelect",
+                      "open": "@entity.open",
+                      "placeholder": "@config.placeholder",
+                      "type": "command-palette"
+                    }
+                  ]
+                ],
+                "event": "INIT",
+                "eventId": "evt_01M1KNYATVV11B8MNEAHHAR28X",
+                "from": "idle",
+                "to": "idle"
+              },
+              {
+                "effects": [
+                  [
+                    "set",
+                    "@entity.open",
+                    "@payload.open"
+                  ],
+                  [
+                    "render-ui",
+                    "main",
+                    {
+                      "className": "@config.className",
+                      "commands": "@config.commands",
+                      "emptyLabel": "@config.emptyLabel",
+                      "onOpenChange": "@config.onOpenChange",
+                      "onSelect": "@config.onSelect",
+                      "open": "@entity.open",
+                      "placeholder": "@config.placeholder",
+                      "type": "command-palette"
+                    }
+                  ]
+                ],
+                "event": "OPEN_CHANGE",
+                "eventId": "evt_01M1KNYATVTSADY2GNXYEGFVGQ",
+                "from": "idle",
+                "to": "idle"
+              }
+            ]
+          }
+        }
+      ],
+      "types": {
+        "CommandPaletteCommandsItem": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "shortcut",
+            "type": "string"
+          },
+          {
+            "name": "keywords",
+            "type": "[string]"
+          },
+          {
+            "name": "group",
+            "type": "string"
+          },
+          {
+            "name": "disabled",
+            "type": "boolean"
+          },
+          {
+            "name": "event",
+            "type": "string"
+          },
+          {
+            "name": "action",
+            "type": "string"
+          },
+          {
+            "name": "actionPayload",
+            "type": "Map<string,scalar>"
+          }
+        ],
+        "CommandPaletteSELECTCommand": [
+          {
+            "name": "id",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "label",
+            "required": true,
+            "type": "string"
+          },
+          {
+            "name": "icon",
+            "type": "icon"
+          },
+          {
+            "name": "shortcut",
+            "type": "string"
+          },
+          {
+            "name": "keywords",
+            "type": "[string]"
+          },
+          {
+            "name": "group",
+            "type": "string"
+          },
+          {
+            "name": "disabled",
+            "type": "boolean"
+          },
+          {
+            "name": "event",
+            "type": "string"
+          },
+          {
+            "name": "action",
+            "type": "string"
+          },
+          {
+            "name": "actionPayload",
+            "type": "Map<string,scalar>"
+          }
+        ]
+      }
+    }
+  ],
+  "schemaVersion": 1,
+  "version": "1.0.0"
+}

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

@@ -171,6 +171,13 @@
               "tier": "presentation",
               "type": "event"
             },
+            "onNodeReorder": {
+              "default": "",
+              "description": "Called when a row is dropped onto another, in flat `items` mode; carries the moved node's id, its new parent id (`null` for a root drop), and its index within the new parent's children. Presence-gated: binding this prop is what turns on row dragging.",
+              "label": "On Node Reorder",
+              "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`.",
@@ -314,6 +321,7 @@
                       "nodeActionLabel": "@config.nodeActionLabel",
                       "onFileSelect": "@config.onFileSelect",
                       "onNodeAction": "@config.onNodeAction",
+                      "onNodeReorder": "@config.onNodeReorder",
                       "onNodeSelect": "@config.onNodeSelect",
                       "selectedId": "@config.selectedId",
                       "selectedPath": "@config.selectedPath",