@duro-app/cli 5.26.0 → 5.28.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duro-app/cli",
-  "version": "5.26.0",
+  "version": "5.28.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.",
@@ -46,7 +46,7 @@
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": ">=1.0.0",
-    "@duro-app/ui": "^5.26.0"
+    "@duro-app/ui": "^5.28.0"
   },
   "peerDependenciesMeta": {
     "@duro-app/ui": {
@@ -61,9 +61,9 @@
     "@types/node": "^24.0.0",
     "ts-morph": "^26.0.0",
     "typescript": "^5.7.0",
-    "@duro-app/eslint-plugin": "^5.26.0",
-    "@duro-app/tokens": "^5.26.0",
-    "@duro-app/ui": "^5.26.0"
+    "@duro-app/eslint-plugin": "^5.28.0",
+    "@duro-app/tokens": "^5.28.0",
+    "@duro-app/ui": "^5.28.0"
   },
   "scripts": {
     "registry": "node scripts/build-registry.mjs",

package/registry.json

@@ -1193,7 +1193,7 @@
       "importPath": "@duro-app/ui",
       "kind": "component",
       "meta": {
-        "description": "A block of code with a copy button: a pre that scrolls sideways when a line is long, and a Button that copies its text, shows the copied label for copiedDuration ms and announces it through a polite LiveRegion. Labels come from props. With language=\"diff\", added, removed and hunk lines are coloured from tokens. On native the text is selectable and scrolls sideways; there is no copy button.",
+        "description": "A block of code with a copy button: a pre that scrolls sideways when a line is long, and a Button that copies its text, shows the copied label for copiedDuration ms and announces it through a polite LiveRegion. Labels come from props. With language=\"diff\", added, removed and hunk lines are coloured from tokens. On native the text is selectable and scrolls sideways; there is no copy button. A diff can carry a lineAction (a button beside each line inside a hunk, one tab stop, Up and Down between them; the line handed over has its old and new line numbers) and renderAfterLine (content under a line, full width: a review comment, an editor); the copied text stays the diff.",
         "example": "<CodeBlock copyLabel=\"Copy\" copiedLabel=\"Copied\">\n  <code>pnpm add @duro-app/ui</code>\n</CodeBlock>",
         "relatedTo": [
           {
@@ -1213,7 +1213,8 @@
         ],
         "whenToUse": [
           "Code or a command the reader is likely to paste: a docs page, an install step",
-          "A Markdown renderer's pre, inside Prose"
+          "A Markdown renderer's pre, inside Prose",
+          "A diff people comment on line by line (lineAction, renderAfterLine)"
         ]
       },
       "name": "CodeBlock",
@@ -1255,6 +1256,18 @@
           "name": "onCopyError",
           "required": false,
           "type": "(error: unknown) => void"
+        },
+        {
+          "description": "With `language=\"diff\"`: a button in a gutter beside each line it is available on. The gutter is one tab stop; Up and Down move between its buttons.",
+          "name": "lineAction",
+          "required": false,
+          "type": "CodeBlockLineAction"
+        },
+        {
+          "description": "With `language=\"diff\"`: content shown under a line, full width (a comment thread, an editor). Return null for lines with nothing under them. What is copied stays the diff text.",
+          "name": "renderAfterLine",
+          "required": false,
+          "type": "(line: DiffLineInfo) => ReactNode"
         }
       ],
       "sourcePath": "packages/ui/src/components/CodeBlock/CodeBlock.tsx"
@@ -5576,7 +5589,7 @@
             "Item"
           ]
         },
-        "description": "Dropdown select for choosing one value from a list. Compound component — Root is required (throws without it). Select.Trigger takes size=\"small\" to match small Toggles and Buttons in a toolbar. Select.Popup takes label (the list's accessible name) and empty (shown in place of the list when it has no items). On the web the list opens below the trigger, or above it when it would overflow the viewport below and fits above. On React Native the trigger opens a bottom sheet (a Drawer at the medium and large detents) titled by label, with a Cancel text button (cancelLabel); the chosen option is filled with a trailing check, and a press picks an option and closes the sheet. Native has no arrow keys: each option is its own screen-reader stop.",
+        "description": "Dropdown select for choosing one value from a list. Compound component — Root is required (throws without it). Select.Trigger takes size=\"small\" to match small Toggles and Buttons in a toolbar. Select.Popup takes label (the list's accessible name) and empty (shown in place of the list when it has no items). On the web the list opens below the trigger, or above it when it would overflow the viewport below and fits above. On React Native the trigger opens a bottom sheet (a Drawer at the medium and large detents) titled by label, with a Cancel text button (cancelLabel); the chosen option is filled with a trailing check, and a press picks an option and closes the sheet. Native has no arrow keys: each option is its own screen-reader stop. An Item can be disabled (shown, skipped by the keys, inert to a press, announced as disabled), and onOpenChange on Root reports the list opening and closing, so work such as checking which options are available starts only once someone is choosing.",
         "example": "<Select.Root name=\"role\" defaultValue=\"viewer\">\n  <Select.Trigger>\n    <Select.Value placeholder=\"Select role\" />\n    <Select.Icon />\n  </Select.Trigger>\n  <Select.Popup>\n    <Select.Item value=\"admin\">Admin</Select.Item>\n    <Select.Item value=\"editor\">Editor</Select.Item>\n    <Select.Item value=\"viewer\">Viewer</Select.Item>\n  </Select.Popup>\n</Select.Root>",
         "relatedTo": [
           {
@@ -5627,6 +5640,13 @@
               "required": true,
               "type": "string"
             },
+            {
+              "default": "false",
+              "description": "Shown but not choosable: skipped by the arrow keys, inert to a press, announced as disabled.",
+              "name": "disabled",
+              "required": false,
+              "type": "boolean"
+            },
             {
               "name": "children",
               "required": true,
@@ -5703,6 +5723,12 @@
               "required": false,
               "type": "Record<string, string>"
             },
+            {
+              "description": "Called when the list opens or closes (to start work only once someone is choosing).",
+              "name": "onOpenChange",
+              "required": false,
+              "type": "(open: boolean) => void"
+            },
             {
               "name": "children",
               "required": true,
@@ -7525,7 +7551,7 @@
       "importPath": "@duro-app/ui",
       "kind": "component",
       "meta": {
-        "description": "Multi-line text input with automatic Field/Form integration. Same Field binding behavior as Input. autoGrow makes the height follow the content from rows up to maxRows, then it scrolls (CSS field-sizing, with a scrollHeight fallback; native grows with the content and caps at maxRows). The anchor props of Listbox.getAnchorProps() (role combobox, aria-controls, aria-expanded, aria-activedescendant) are forwarded as ARIA attributes on web and as the matching accessibility props on native, so a Listbox can be anchored to it while the editor keeps focus.",
+        "description": "Multi-line text input with automatic Field/Form integration. Same Field binding behavior as Input. autoGrow makes the height follow the content from rows up to maxRows, then it scrolls (CSS field-sizing, with a scrollHeight fallback; native grows with the content and caps at maxRows). The anchor props of Listbox.getAnchorProps() (role combobox, aria-controls, aria-expanded, aria-activedescendant) are forwarded as ARIA attributes on web and as the matching accessibility props on native, so a Listbox can be anchored to it while the editor keeps focus. On the web, onFiles receives files pasted into the field or dropped on it (the drop ring shows while files are dragged over it); text pastes stay text.",
         "example": "<Field.Root name=\"message\">\n  <Field.Label>Message</Field.Label>\n  <Textarea placeholder=\"Tell us what you think...\" rows={4} />\n  <Field.Description>At least 10 characters</Field.Description>\n  <Field.Error />\n</Field.Root>",
         "relatedTo": [
           {
@@ -7640,6 +7666,12 @@
           "required": false,
           "type": "(e: React.KeyboardEvent<HTMLTextAreaElement>) => void"
         },
+        {
+          "description": "Web: files pasted into the field or dropped on it (a screenshot, a log). The field shows the drop ring while files are dragged over it. Text pastes and drops stay text. Native: never called; attach with FileTrigger.",
+          "name": "onFiles",
+          "required": false,
+          "type": "(files: readonly File[]) => void"
+        },
         {
           "name": "ref",
           "required": false,