@duro-app/cli 3.5.0 → 3.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duro-app/cli",
-  "version": "3.5.0",
+  "version": "3.7.0",
   "type": "module",
   "license": "MIT",
   "description": "Machine-queryable docs for the Duro design system: components, props, recipes, tokens and rules as CLI output, JSON, or an MCP server.",
@@ -45,7 +45,7 @@
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": ">=1.0.0",
-    "@duro-app/ui": "^3.5.0"
+    "@duro-app/ui": "^3.7.0"
   },
   "peerDependenciesMeta": {
     "@duro-app/ui": {
@@ -60,9 +60,9 @@
     "@types/node": "^24.0.0",
     "ts-morph": "^26.0.0",
     "typescript": "^5.7.0",
-    "@duro-app/eslint-plugin": "^3.5.0",
-    "@duro-app/tokens": "^3.5.0",
-    "@duro-app/ui": "^3.5.0"
+    "@duro-app/tokens": "^3.7.0",
+    "@duro-app/ui": "^3.7.0",
+    "@duro-app/eslint-plugin": "^3.7.0"
   },
   "scripts": {
     "registry": "node scripts/build-registry.mjs",

package/registry.json

@@ -2933,6 +2933,22 @@
           "required": false,
           "type": "() => void"
         },
+        {
+          "name": "onFocus",
+          "required": false,
+          "type": "(e: React.FocusEvent<HTMLInputElement>) => void"
+        },
+        {
+          "description": "Keyboard handlers — e.g. Enter to commit, Escape to cancel, arrow-key navigation of a list driven by this field.",
+          "name": "onKeyDown",
+          "required": false,
+          "type": "(e: React.KeyboardEvent<HTMLInputElement>) => void"
+        },
+        {
+          "name": "onKeyUp",
+          "required": false,
+          "type": "(e: React.KeyboardEvent<HTMLInputElement>) => void"
+        },
         {
           "name": "ref",
           "required": false,
@@ -3310,8 +3326,8 @@
             "Item"
           ]
         },
-        "description": "Dropdown action menu. Triggers actions (not value selection). Compound component — Root is required (throws without it).",
-        "example": "<Menu.Root>\n  <Menu.Trigger>\n    <Button variant=\"secondary\">Actions</Button>\n  </Menu.Trigger>\n  <Menu.Popup>\n    <Menu.Item onClick={() => console.log('edit')}>Edit</Menu.Item>\n    <Menu.Item onClick={() => console.log('duplicate')}>Duplicate</Menu.Item>\n    <Menu.LinkItem href=\"/settings\">Settings</Menu.LinkItem>\n  </Menu.Popup>\n</Menu.Root>",
+        "description": "Dropdown action menu. Triggers actions (not value selection). Compound component — Root is required (throws without it). Menu.Trigger renders the button itself: give it the label (text, an Icon), never a Button.",
+        "example": "<Menu.Root>\n  <Menu.Trigger>Actions</Menu.Trigger>\n  <Menu.Popup>\n    <Menu.Item onClick={() => console.log('edit')}>Edit</Menu.Item>\n    <Menu.Item onClick={() => console.log('duplicate')}>Duplicate</Menu.Item>\n    <Menu.LinkItem href=\"/settings\">Settings</Menu.LinkItem>\n  </Menu.Popup>\n</Menu.Root>",
         "relatedTo": [
           {
             "component": "Select",
@@ -3320,8 +3336,8 @@
           },
           {
             "component": "Button",
-            "kind": "composition",
-            "relationship": "Often used as Menu.Trigger content"
+            "kind": "contrast",
+            "relationship": "Button runs one action; Menu opens a list of them. Menu.Trigger is already a button — never put a Button inside it"
           }
         ],
         "whenNotToUse": [
@@ -5505,6 +5521,22 @@
           "required": false,
           "type": "() => void"
         },
+        {
+          "name": "onFocus",
+          "required": false,
+          "type": "(e: React.FocusEvent<HTMLTextAreaElement>) => void"
+        },
+        {
+          "description": "Keyboard handlers — e.g. Enter to commit, Escape to cancel, arrow-key navigation of a list driven by this field.",
+          "name": "onKeyDown",
+          "required": false,
+          "type": "(e: React.KeyboardEvent<HTMLTextAreaElement>) => void"
+        },
+        {
+          "name": "onKeyUp",
+          "required": false,
+          "type": "(e: React.KeyboardEvent<HTMLTextAreaElement>) => void"
+        },
         {
           "name": "ref",
           "required": false,
@@ -5845,6 +5877,138 @@
       "props": null,
       "sourcePath": "packages/ui/src/components/Tooltip/Tooltip.tsx"
     },
+    "Tree": {
+      "importPath": "@duro-app/ui",
+      "kind": "compound",
+      "meta": {
+        "anatomy": {
+          "required": [
+            "Root",
+            "Item"
+          ]
+        },
+        "description": "Hierarchy of items with single selection and expandable branches (the WAI-ARIA tree pattern): one tab stop, arrow keys, Home/End, typeahead. Compound component — Root is required.",
+        "example": "<Tree.Root aria-label=\"Blocs\" defaultExpanded={['energy']} onValueChange={setSelected}>\n  <Tree.Item value=\"energy\" label=\"Core business — Energy\">\n    <Tree.Item value=\"generation\" label=\"Generation\" meta=\"4 apps\" />\n    <Tree.Item value=\"network\" label=\"Network operations\">\n      <Tree.Item value=\"scada\" label=\"SCADA supervision\" />\n    </Tree.Item>\n  </Tree.Item>\n  <Tree.Item value=\"finance\" label=\"Finance & steering\" />\n</Tree.Root>",
+        "relatedTo": [
+          {
+            "component": "SideNav",
+            "kind": "contrast",
+            "relationship": "SideNav is navigation between pages; Tree browses arbitrary-depth data. Never nest SideNav to fake a tree"
+          },
+          {
+            "component": "split-pane",
+            "kind": "composition",
+            "relationship": "A Tree in the list column of the split-pane recipe, the selection’s details beside it"
+          }
+        ],
+        "whenNotToUse": [
+          "Site or app navigation — use SideNav (a rail advertises destinations; a tree browses data)",
+          "A flat list of choices — use List or RadioGroup",
+          "Choosing several nodes at once — not supported (single selection)"
+        ],
+        "whenToUse": [
+          "Browsing data that nests to any depth — a file tree, zones › services › capabilities, namespace › resource",
+          "Picking one node of a hierarchy to show its details beside the tree"
+        ]
+      },
+      "name": "Tree",
+      "parts": {
+        "Item": {
+          "name": "Item",
+          "props": [
+            {
+              "description": "unique within the tree",
+              "name": "value",
+              "required": true,
+              "type": "string"
+            },
+            {
+              "description": "what the row shows",
+              "name": "label",
+              "required": true,
+              "type": "ReactNode"
+            },
+            {
+              "description": "plain text for typeahead when `label` isn't a string",
+              "name": "textValue",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "description": "nested items: the branch's children (none = a leaf)",
+              "name": "children",
+              "required": false,
+              "type": "ReactNode"
+            },
+            {
+              "description": "trailing content on the row (a count, a status)",
+              "name": "meta",
+              "required": false,
+              "type": "ReactNode"
+            }
+          ],
+          "sourcePath": "packages/ui/src/components/Tree/Tree.tsx"
+        },
+        "Root": {
+          "name": "Root",
+          "props": [
+            {
+              "name": "children",
+              "required": true,
+              "type": "ReactNode"
+            },
+            {
+              "description": "accessible name of the tree (or give `aria-labelledby`)",
+              "name": "aria-label",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "name": "aria-labelledby",
+              "required": false,
+              "type": "string"
+            },
+            {
+              "description": "the selected item (controlled)",
+              "name": "value",
+              "required": false,
+              "type": "string | null"
+            },
+            {
+              "default": "null",
+              "name": "defaultValue",
+              "required": false,
+              "type": "string | null"
+            },
+            {
+              "name": "onValueChange",
+              "required": false,
+              "type": "(value: string) => void"
+            },
+            {
+              "description": "the open branches (controlled)",
+              "name": "expanded",
+              "required": false,
+              "type": "ReadonlyArray<string>"
+            },
+            {
+              "default": "[]",
+              "name": "defaultExpanded",
+              "required": false,
+              "type": "ReadonlyArray<string>"
+            },
+            {
+              "name": "onExpandedChange",
+              "required": false,
+              "type": "(expanded: string[]) => void"
+            }
+          ],
+          "sourcePath": "packages/ui/src/components/Tree/Tree.tsx"
+        }
+      },
+      "props": null,
+      "sourcePath": "packages/ui/src/components/Tree/Tree.tsx"
+    },
     "VirtualTable": {
       "importPath": "@duro-app/ui/table",
       "kind": "component",
@@ -6325,11 +6489,10 @@
       },
       "name": "action-menu",
       "peerDeps": [],
-      "source": "import {Menu, Button} from '@duro-app/ui'\n\nexport function ActionMenuRecipe() {\n  return (\n    <Menu.Root>\n      <Menu.Trigger>\n        <Button variant=\"secondary\">Actions</Button>\n      </Menu.Trigger>\n      <Menu.Popup>\n        <Menu.Item onClick={() => console.log('edit')}>Edit</Menu.Item>\n        <Menu.Item onClick={() => console.log('duplicate')}>Duplicate</Menu.Item>\n        <Menu.Item onClick={() => console.log('archive')}>Archive</Menu.Item>\n        <Menu.LinkItem href=\"/settings\">Settings</Menu.LinkItem>\n      </Menu.Popup>\n    </Menu.Root>\n  )\n}\n",
+      "source": "import {Menu} from '@duro-app/ui'\n\nexport function ActionMenuRecipe() {\n  return (\n    <Menu.Root>\n      {/* Menu.Trigger is the button: give it the label, not a <Button>. */}\n      <Menu.Trigger>Actions</Menu.Trigger>\n      <Menu.Popup>\n        <Menu.Item onClick={() => console.log('edit')}>Edit</Menu.Item>\n        <Menu.Item onClick={() => console.log('duplicate')}>Duplicate</Menu.Item>\n        <Menu.Item onClick={() => console.log('archive')}>Archive</Menu.Item>\n        <Menu.LinkItem href=\"/settings\">Settings</Menu.LinkItem>\n      </Menu.Popup>\n    </Menu.Root>\n  )\n}\n",
       "sourcePath": "docs/ai/recipes/action-menu.recipe.tsx",
       "title": "Action Menu",
       "usesComponents": [
-        "Button",
         "Menu"
       ]
     },