@duro-app/cli 5.25.0 → 5.27.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@duro-app/cli",
-  "version": "5.25.0",
+  "version": "5.27.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.25.0"
+    "@duro-app/ui": "^5.27.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.25.0",
-    "@duro-app/tokens": "^5.25.0",
-    "@duro-app/ui": "^5.25.0"
+    "@duro-app/tokens": "^5.27.0",
+    "@duro-app/ui": "^5.27.0",
+    "@duro-app/eslint-plugin": "^5.27.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"
@@ -7525,7 +7538,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 +7653,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,
@@ -8508,7 +8527,7 @@
           "optional": [],
           "required": []
         },
-        "description": "A windowed list on @tanstack/react-virtual: only the rows in view (plus overscan) are mounted, and rows are measured so they may differ in height. role=\"list\" with listitem rows carrying aria-setsize and aria-posinset. anchor=\"end\" opens at the last item and stays pinned to the bottom while new items arrive and the reader is at the bottom (a transcript, a log). It fills its parent, or stops at maxHeight. onStartReached fires once each time the reader scrolls to the start (load older history), and prepending items keeps the first visible row in place. On native it is a FlatList with the same props (role list; rows carry no listitem role, which React Native lacks) (maintainVisibleContentPosition for prepend). The scroll region is a tab stop with a focus ring, so the keyboard can scroll rows that hold no control.",
+        "description": "A windowed list on @tanstack/react-virtual: only the rows in view (plus overscan) are mounted, and rows are measured so they may differ in height. role=\"list\" with listitem rows carrying aria-setsize and aria-posinset. anchor=\"end\" opens at the last item and stays pinned to the bottom while new items arrive and the reader is at the bottom (a transcript, a log). It fills its parent, or stops at maxHeight. onStartReached fires once each time the reader scrolls to the start (load older history), and prepending items keeps the first visible row in place. On native it is a FlatList with the same props (role list; rows carry no listitem role, which React Native lacks) (maintainVisibleContentPosition for prepend). The scroll region is a tab stop with a focus ring, so the keyboard can scroll rows that hold no control. onEndReached mirrors onStartReached at the end (load newer items in a window opened on an older point); scrollToKey centres one item each time it changes to a key in the list (a link to one message), and anchor=\"end\" stops following the end while it applies.",
         "example": "<VirtualList\n  aria-label=\"Transcript\"\n  items={messages}\n  getKey={(m) => m.id}\n  estimateSize=\"controlLg\"\n  anchor=\"end\"\n  renderItem={(m) => <Text>{m.text}</Text>}\n/>",
         "relatedTo": [
           {
@@ -8578,6 +8597,18 @@
           "required": false,
           "type": "() => void"
         },
+        {
+          "description": "Called once each time the reader scrolls to within 44px (touchTarget) of the end (load newer items, as in a window opened on an older point). It fires again only after they move away.",
+          "name": "onEndReached",
+          "required": false,
+          "type": "() => void"
+        },
+        {
+          "description": "Bring this item into view, centred, each time the key changes to an item in the list (a link to one message). A key not in the list yet waits for the items that hold it; `null` or `undefined` does nothing. While it applies, `anchor=\"end\"` stops following the end.",
+          "name": "scrollToKey",
+          "required": false,
+          "type": "string | number | null"
+        },
         {
           "description": "Cap the list's height; without it, it fills its parent.",
           "name": "maxHeight",