@smwb/ui-mcp-react 2.7.0 → 2.9.0

package/component-meta/dataDisplay/kbd/kbd.json

@@ -0,0 +1,55 @@
+{
+  "name": "Kbd",
+  "description": "A keyboard shortcut as key caps (<kbd>): `Mod` is Command on macOS and Ctrl elsewhere, Mac names become symbols; for a tooltip, a menu item or a command palette.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<HTMLAttributes<HTMLElement>, \"children\">"
+  ],
+  "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/kbd/kbd.entry.less"
+    ],
+    "dependencies": [],
+    "importExample": "@import (less) \"node_modules/@smwb/ui-styles/less/foundation.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/theme.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/kbd/kbd.entry.less\";"
+  },
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false,
+      "description": "Additional CSS class name(s) for the root element."
+    },
+    "keys": {
+      "type": "string[]",
+      "required": true,
+      "description": "The keys of the shortcut in order, e.g. `[\"Mod\", \"K\"]` or `[\"Shift\", \"Enter\"]`. `Mod` is the\nCommand key on macOS and Ctrl elsewhere. On macOS, `Shift`, `Alt`/`Option`, `Ctrl`/`Control`,\n`Meta`/`Cmd`/`Command`, `Enter`, `Escape`, `Tab`, `Backspace` and `Delete` are drawn as the\nsymbols of the Mac keyboard; elsewhere the same names are drawn as Ctrl, Alt, Shift, Meta, Enter,\nEsc, Tab, Backspace and Del, whatever their case. `\" \"` and `Space` are the Space key, `+` and\n`Plus` the plus key.\nArrow names (`ArrowUp` or `Up`, …) are arrows everywhere; any other key is drawn as given\n(a single letter in upper case)."
+    },
+    "platform": {
+      "type": "KbdPlatform",
+      "required": false,
+      "description": "The platform whose keys are drawn. Without it the browser's own is used: `other` on the\nserver and in the first client render (so that hydration matches), `mac` right after on a Mac.\nSet it for a fixed look, in stories and in tests."
+    },
+    "separator": {
+      "type": "string",
+      "required": false,
+      "description": "Drawn between the key caps. By default `+` on `other` and nothing on `mac`, where the symbols\nstand side by side; `\"\"` draws none. It is for the eye only; assistive technology reads `label`."
+    },
+    "label": {
+      "type": "string",
+      "required": false,
+      "description": "What assistive technology reads instead of the key caps. By default the key names, joined\nwith `+` on `other` (\"Ctrl+K\") and with a space on `mac` (\"Command K\")."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<kbd>`; `kbd` unless given."
+    }
+  }
+}

package/component-meta/dataDisplay/list/list.json

@@ -35,6 +35,11 @@
       "type": "ReactNode",
       "required": false,
       "description": "Section subheader rendered before the items."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<ul>`; `list` unless given."
     }
   }
 }

package/component-meta/dataDisplay/list/listItem.json

@@ -30,7 +30,7 @@
     "selected": {
       "type": "boolean",
       "required": false,
-      "description": "Controlled selected tab index or value."
+      "description": "Paints the row as the current one. On a link row (with `href`) it also marks the link as the current page\nwith `aria-current=\"page\"`, because `aria-selected` is not a state a list item can have; on another row it\nstays `aria-selected`."
     },
     "dense": {
       "type": "boolean",
@@ -50,12 +50,27 @@
     "endAdornment": {
       "type": "React.ReactNode",
       "required": false,
-      "description": "End Adornment. Optional. Type: React.ReactNode."
+      "description": "Trailing content. On a link row (with `href`) it sits beside the link, not inside it, so it can hold a control\n(a pin button, a toggle) without nesting it in the `<a>`; a click on it does not reach `onClick`."
+    },
+    "href": {
+      "type": "string",
+      "required": false,
+      "description": "Makes the row a link: the `startAdornment` and the children sit in an `<a href>` that fills the row, so it can be\nfocused with Tab, opened with middle click or copied. Keep the `startAdornment` non-interactive; a control\nbelongs in the `endAdornment`. A disabled row has no `href`. A router takes the\nplain click in `onClick` with `event.preventDefault()`, and leaves a modified one (Ctrl, Meta, Shift,\nAlt, or a button other than the main one) to the browser, as a router's `Link` does."
+    },
+    "target": {
+      "type": "string | null",
+      "required": false,
+      "description": "Where the link (with `href`) opens. By default `\"_blank\"`: a new tab, as for `Button`. Pass `null` for an\ninternal link: the `target` attribute is left out and the link opens in place. An empty string does the same; any other\nstring is used as is."
+    },
+    "rel": {
+      "type": "string",
+      "required": false,
+      "description": "The `rel` of the link (with `href`). By default `\"noreferrer\"` for a link that opens another tab or window,\nand none for one that opens in place. Your own value replaces the default, so add `noreferrer` yourself\nif you still want it; an empty string drops the attribute."
     },
     "onClick": {
       "type": "React.MouseEventHandler<HTMLLIElement>",
       "required": false,
-      "description": "Callback fired when the element is clicked."
+      "description": "Click handler of the row. With an `href` it runs for a click on the link (not on the `endAdornment`), before the\nbrowser follows it, so `event.preventDefault()` cancels the navigation; the row then is not a Tab stop of its\nown, the link is."
     }
   }
 }

package/component-meta/dataDisplay/meter/meter.json

@@ -65,6 +65,11 @@
       "type": "boolean",
       "required": false,
       "description": "The bar only; the text stays available to assistive technology."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `meter` unless given."
     }
   }
 }

package/component-meta/dataDisplay/personChip/personChip.json

@@ -67,6 +67,11 @@
       "type": "ReactNode",
       "required": false,
       "description": "A second line under the name: a role, a date."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root; `person-chip` unless given."
     }
   }
 }

package/component-meta/dataDisplay/qrCode/qrCode.json

@@ -0,0 +1,60 @@
+{
+  "name": "QrCode",
+  "description": "QR code of a value as an SVG image (role=img), dark modules on white in every theme, with a quiet zone, size, caption and error-correction level.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<React.HTMLAttributes<HTMLElement>, \"children\" | \"role\">"
+  ],
+  "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/qrCode/qrCode.entry.less"
+    ],
+    "dependencies": [],
+    "importExample": "@import (less) \"node_modules/@smwb/ui-styles/less/foundation.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/theme.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/qrCode/qrCode.entry.less\";"
+  },
+  "props": {
+    "value": {
+      "type": "string",
+      "required": true,
+      "description": "Text encoded in the code (a URL, a pairing token). Encoded as UTF-8 bytes."
+    },
+    "size": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Side of the code, quiet zone included, in pixels. Default 192."
+    },
+    "caption": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Shown under the code (a `<figcaption>`), e.g. \"Scan with the phone app\"."
+    },
+    "label": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the image. Default \"QR code\"."
+    },
+    "errorCorrection": {
+      "type": "QrCodeErrorCorrection | undefined",
+      "required": false,
+      "description": "Error-correction level: L 7%, M 15% (default), Q 25%, H 30% of the code may be damaged or covered."
+    },
+    "quietZone": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Light margin around the code in modules. Default 4, the minimum the QR spec asks for; smaller values hurt scanning."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root; `qr-code` unless given."
+    }
+  }
+}

package/component-meta/dataDisplay/stat/stat.json

@@ -62,6 +62,11 @@
       "type": "string",
       "required": false,
       "description": "Make the whole stat a link to what the figure is made of."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root; `stat` unless given."
     }
   }
 }

package/component-meta/dataDisplay/statusDot/statusDot.json

@@ -0,0 +1,60 @@
+{
+  "name": "StatusDot",
+  "description": "Small status marker dot coloured by status or theme colour, with a pulse for active (role=img).",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<HTMLAttributes<HTMLSpanElement>, \"role\" | \"children\" | \"aria-label\">"
+  ],
+  "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/statusDot/statusDot.entry.less"
+    ],
+    "dependencies": [],
+    "importExample": "@import (less) \"node_modules/@smwb/ui-styles/less/foundation.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/theme.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/statusDot/statusDot.entry.less\";"
+  },
+  "props": {
+    "className": {
+      "type": "string",
+      "required": false,
+      "description": "Class name(s) for the dot's root `<span>`."
+    },
+    "status": {
+      "type": "StatusDotStatus | undefined",
+      "required": false,
+      "description": "What the dot says, and so its colour: `active` info, `attention` warning, `idle` neutral, `done` success,\n`error` error. `unknown` is a ring in the outline colour. Without `status` (and without `color`) the dot is\n`unknown`."
+    },
+    "color": {
+      "type": "StatusDotColor | undefined",
+      "required": false,
+      "description": "A theme colour instead of the status's own, or on its own with no `status` (a plain disc). Given with a\n`status`, the status still sets the shape."
+    },
+    "size": {
+      "type": "StatusDotSize | undefined",
+      "required": false,
+      "description": "`md` (12px) unless given; `sm` is 8px."
+    },
+    "pulse": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "A ring spreads from the dot. On unless given for `active`, off for every other status. Never drawn while the\nuser prefers reduced motion."
+    },
+    "label": {
+      "type": "string",
+      "required": true,
+      "description": "What the dot means in words, e.g. \"Working\": the accessible name, read by assistive technology."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root; `status-dot` unless given."
+    }
+  }
+}

package/component-meta/dataDisplay/swimlanes/swimlanes.json

@@ -0,0 +1,90 @@
+{
+  "name": "Swimlanes",
+  "description": "Participant lanes: a virtualised grid (role=grid) with one row per lane, a fixed rowheader column (avatar, name, role) and a content cell that scrolls sideways; fixed rowHeight, single selection (selectedId/defaultSelectedId/onSelectedChange), arrow/Home/End/Page keys with one Tab stop.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<React.HTMLAttributes<HTMLDivElement>, \"onSelect\" | \"role\" | \"children\">"
+  ],
+  "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/swimlanes/swimlanes.entry.less"
+    ],
+    "dependencies": [],
+    "importExample": "@import (less) \"node_modules/@smwb/ui-styles/less/foundation.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/theme.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/swimlanes/swimlanes.entry.less\";"
+  },
+  "props": {
+    "lanes": {
+      "type": "readonly SwimlanesLane[]",
+      "required": true,
+      "description": "The lanes, one row each, in the order they are drawn."
+    },
+    "label": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the grid (aria-label); `aria-labelledby` wins when given."
+    },
+    "selectedId": {
+      "type": "string | null | undefined",
+      "required": false,
+      "description": "The selected lane's id (controlled); null selects nothing."
+    },
+    "defaultSelectedId": {
+      "type": "string | null | undefined",
+      "required": false,
+      "description": "The lane selected at first (uncontrolled)."
+    },
+    "onSelectedChange": {
+      "type": "((id: string | null) => void) | undefined",
+      "required": false,
+      "description": "A lane was selected (its id) or the selection was cleared (null)."
+    },
+    "selectable": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Whether lanes can be selected; true by default. False: no aria-selected, no selected look,\nand Enter, Space, Escape and a click select nothing; a `selectedId` given anyway is ignored."
+    },
+    "rowHeight": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Row height in px (every lane is this tall; virtualisation needs a fixed height). 64 by default."
+    },
+    "headerWidth": {
+      "type": "number | string | undefined",
+      "required": false,
+      "description": "Width of the fixed header column: px or any CSS length; 240px by default from the stylesheet."
+    },
+    "contentMinWidth": {
+      "type": "number | string | undefined",
+      "required": false,
+      "description": "Narrowest width of the content column; when the grid is narrower, it scrolls sideways. 0 by default."
+    },
+    "height": {
+      "type": "number | string | undefined",
+      "required": false,
+      "description": "The grid's height (the scroller): a number of pixels or any CSS length; 480\nby default, from the stylesheet, so a height in `style` works too."
+    },
+    "overscan": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Lanes rendered above and below the visible ones. 4 by default."
+    },
+    "emptyLabel": {
+      "type": "React.ReactNode",
+      "required": false,
+      "description": "Shown instead of the grid when `lanes` is empty."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root `<div>`; `swimlanes` unless given."
+    }
+  }
+}

package/component-meta/dataDisplay/table/table.json

@@ -54,7 +54,7 @@
     "stackBelow": {
       "type": "\"sm\" | \"md\" | \"lg\"",
       "required": false,
-      "description": "Show each row as a card — cells one under another, each with its column's\nlabel — while the table's container is narrower than this breakpoint:\n`sm` (420px), `md` (768px) or `lg` (1024px). A container query: the space\nthe table has decides, not the window. Labels come from `TableCell label`."
+      "description": "Show each row as a card — cells one under another, each with its column's\nlabel — while the table's container is narrower than this breakpoint:\n`sm` (420px), `md` (768px) or `lg` (1024px). A container query: the space\nthe table has decides, not the window.\n\nA cell's label is its `TableCell label`, or else the label of the head cell\nof its column: the head cell's `label`, or the text of its content. Columns\ncount as in HTML: by position in the row, with `colSpan`, after the columns\nthat `rowSpan` cells of the rows above take in the same head or body. A cell\nspanning several columns takes no label from the head and fills the card's\nwidth, and a head cell spanning several columns labels none of them. With\nseveral head rows, the lowest head cell over a column names it.\n\nThe columns come from the elements written: rows written as `TableRow` in\n`TableHead` or `TableBody`, and cells in a row (arrays and fragments\nincluded). A component that renders a row counts as a row whose cells span\nno rows down, and a component that renders cells counts as one cell, with\nits own `colSpan` and `rowSpan`: give the cells after such a component, or\nthe component's own cells, a `label`."
     },
     "paginationSettings": {
       "type": "TablePaginationProps",

package/component-meta/dataDisplay/table/tableCell.json

@@ -32,9 +32,14 @@
       "description": "Cell Align. Optional. Type: \"left\" | \"right\" | \"center\"."
     },
     "label": {
+      "type": "string | false",
+      "required": false,
+      "description": "The column's name, shown next to the value when the table stacks rows as\ncards (`Table stackBelow`). Without it, the cell takes the label of its\ncolumn's head cell; `false` keeps the cell unlabelled, so it fills the\ncard's width (an action, a sub-row). A caller's own `data-label` counts as a\ngiven label too."
+    },
+    "data-label": {
       "type": "string",
       "required": false,
-      "description": "The column's name, shown next to the value when the table stacks rows as cards (`Table stackBelow`)."
+      "description": "The cell's label written by hand, as the attribute the stacked layout shows; `label` replaces it."
     }
   }
 }

package/component-meta/dataDisplay/table/tableHeadCell.json

@@ -46,7 +46,7 @@
     "sortable": {
       "type": "boolean",
       "required": false,
-      "description": "Enables the interactive sort affordance with keyboard/aria support.\n\nThe children sit inside the sort control, and controls among them keep\ntheir own input: Enter and Space sort only while the sort control itself\nhas focus, and a click sorts unless it lands in a nested control (input,\nbutton, link, label, anything focusable) or in a portal. Content that is not\na control, such as click-to-edit text, keeps its click from sorting by\ncalling `preventDefault()` on it. A nested control's name, or its value,\nbecomes part of the sort control's accessible name."
+      "description": "Enables the interactive sort affordance with keyboard/aria support.\n\nThe children sit inside the sort control, and controls among them keep\ntheir own input: Enter and Space sort only while the sort control itself\nhas focus, and a click sorts unless it lands in a nested control (input,\nbutton, link, label, anything focusable) or in a portal. Content that is not\na control, such as click-to-edit text, keeps its click from sorting by\ncalling `preventDefault()` on it. A nested control's name, or its value,\nbecomes part of the sort control's accessible name: put controls in\n`actions` instead."
     },
     "sortDirection": {
       "type": "SortDirection",
@@ -57,6 +57,16 @@
       "type": "() => void",
       "required": false,
       "description": "Invoked when the user activates the sort control."
+    },
+    "actions": {
+      "type": "ReactNode",
+      "required": false,
+      "description": "The column's controls — a filter field, a menu button, a column resizer —\ndrawn after the sort control, outside it. Their names and values stay out\nof the sort control's accessible name, and their keys and clicks never\nreach it. Rendered whether or not the cell is sortable.\n\nThe column header is then named after the children alone: the cell's\n`aria-labelledby` points at the sort control, unless the cell is given\n`aria-label` or `aria-labelledby`. Named from its content, the header would\ntake in the controls' names and values too."
+    },
+    "label": {
+      "type": "string",
+      "required": false,
+      "description": "The column's name for its body cells while the table stacks rows as cards\n(`Table stackBelow`). Without it, the text of the children is the name; give\n`label` where they hold no text of their own (an icon, a translated message\ncomponent) or more than the name. An empty `label` leaves the column's cells\nunlabelled, so they fill the card's width."
     }
   }
 }

package/component-meta/dataDisplay/table/tableRow.json

@@ -35,6 +35,11 @@
       "type": "boolean",
       "required": false,
       "description": "Reflects expandable-row state (adds aria-expanded + styling)."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the `<tr>`; `table-row` unless given."
     }
   }
 }

package/component-meta/dataDisplay/thumbCard/thumbCard.json

@@ -24,6 +24,11 @@
     "importExample": "@import (less) \"node_modules/@smwb/ui-styles/less/foundation.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/theme.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/thumbCard/thumbCard.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/lazyImage/lazyImage.entry.less\";"
   },
   "props": {
+    "className": {
+      "type": "string",
+      "required": false,
+      "description": "Class name(s) for the root `<div>`, the card's box. `style`, `id`, `data-*`, `aria-hidden`, `ref` and event\nhandlers go to the root too, but `role`, `tabIndex`, `onFocus`, `onBlur` and the other `aria-*` attributes go to\nthe card's content, `.smwb-thumb-card__content` (the image and the caption): that is the card's button when it has\n`onSelect`, and the element to focus."
+    },
     "src": {
       "type": "string",
       "required": false,
@@ -32,17 +37,22 @@
     "caption": {
       "type": "React.ReactNode",
       "required": false,
-      "description": "Caption. Optional. Type: React.ReactNode."
+      "description": "Text under the image. With `onSelect` it is part of the card's button and names it, so keep controls out of it:\nthey go in `topStart` / `topEnd`."
     },
     "selected": {
       "type": "boolean",
       "required": false,
-      "description": "Controlled selected tab index or value."
+      "description": "Outlines the image; with `onSelect`, the card's button is also `aria-pressed=\"true\"`."
     },
     "onSelect": {
       "type": "() => void",
       "required": false,
-      "description": "Makes the card a selectable button (keyboard + `aria-pressed`)."
+      "description": "Makes the card selectable: its content (the image and the caption) becomes a toggle button with `aria-pressed`,\nselected by a click and by Enter / Space. The corner slots are not part of that button but its siblings, laid over\nthe image, so their controls keep their own names, clicks and keys.\n\nA click selects the card unless it lands in a control in a slot (button, link, input, anything focusable) or in a\nportal opened from the card. Slot content that is not a control keeps its click from selecting the card by calling\n`preventDefault()` on it."
+    },
+    "onClick": {
+      "type": "React.MouseEventHandler<HTMLDivElement> | undefined",
+      "required": false,
+      "description": "Runs on each click on the card, before `onSelect`, but not while the card is `disabled`.\nA click on a control in a slot runs it too, without selecting the card.\nEnter / Space select the card without a click, so they call only `onSelect`."
     },
     "fallback": {
       "type": "React.ReactNode",
@@ -57,12 +67,12 @@
     "topStart": {
       "type": "React.ReactNode",
       "required": false,
-      "description": "Top-left overlay slot (e.g. a favourite star)."
+      "description": "Top-left overlay slot (e.g. a favourite star). It sits over the image, outside the card's button, so controls here\nkeep their own names, clicks and keys; see `onSelect`."
     },
     "topEnd": {
       "type": "React.ReactNode",
       "required": false,
-      "description": "Top-right overlay slot (e.g. a kebab menu)."
+      "description": "Top-right overlay slot (e.g. a kebab menu). It sits over the image, outside the card's button, so controls here\nkeep their own names, clicks and keys; see `onSelect`."
     },
     "lazy": {
       "type": "boolean",
@@ -72,7 +82,7 @@
     "disabled": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the control is disabled and non-interactive."
+      "description": "Dims the card and ignores clicks on it: neither `onClick` nor `onSelect` runs.\nKeys do not select it either, and there is no hover preview. With `onSelect`\nthe card is still a button, `aria-disabled` and out of the tab order."
     },
     "hoverDelay": {
       "type": "number",

package/component-meta/dataDisplay/treeView/treeView.json

@@ -71,22 +71,42 @@
     "selectable": {
       "type": "boolean",
       "required": false,
-      "description": "Enables label click selection."
+      "description": "Enables row selection: a click, Enter or Space on a row toggles its selection. The chevron and the\nLeft/Right keys never change it."
     },
     "checkboxes": {
       "type": "boolean",
       "required": false,
       "description": "Renders a checkbox per node bound to selection."
     },
+    "toggleOnRowClick": {
+      "type": "boolean",
+      "required": false,
+      "description": "Whether a click, Enter or Space on a row also expands or collapses its children. The chevron and the\nRight/Left keys always do. Defaults to `true` while the tree is not `selectable` (a row has nothing else to\ndo) and to `false` otherwise, so that selecting a row leaves it open or closed."
+    },
     "renderLabel": {
       "type": "(item: ITreeNodeItem, nodeId: string) => ReactNode",
       "required": false,
       "description": "Custom node renderer."
     },
+    "renderActions": {
+      "type": "(item: ITreeNodeItem, nodeId: string) => ReactNode",
+      "required": false,
+      "description": "Per-node actions (buttons, a menu trigger), drawn at the end of the row. They sit beside the row's\nbutton, not inside it, so they take their own clicks, Enter and Space, focus and accessible names."
+    },
+    "loadingText": {
+      "type": "string",
+      "required": false,
+      "description": "Text shown while `loadChildren` is pending; \"Loading…\" unless given."
+    },
     "loadChildren": {
       "type": "(item: ITreeNodeItem, nodeId: string) => Promise<ITreeNodeItem[]>",
       "required": false,
       "description": "Lazily resolves children the first time a node is expanded."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `tree-view` unless given."
     }
   }
 }

package/component-meta/feedBack/emptyState/emptyState.json

@@ -52,6 +52,11 @@
       "type": "\"small\" | \"medium\"",
       "required": false,
       "description": "`small`: tighter, for a narrow column or a card."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `empty-state` unless given."
     }
   }
 }

package/component-meta/feedBack/message/message.json

@@ -52,6 +52,11 @@
       "type": "string",
       "required": false,
       "description": "Accessible label for the close button."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `message` unless given."
     }
   }
 }

package/component-meta/feedBack/skeleton/skeleton.json

@@ -49,7 +49,7 @@
     "count": {
       "type": "number",
       "required": false,
-      "description": "Render N stacked placeholders."
+      "description": "Render N stacked placeholders. With `count` > 1 they sit in a group `<span>`, which takes the `ref` and the\nother HTML attributes; `className` and `style` go on each placeholder."
     },
     "animationDelay": {
       "type": "number",
@@ -59,7 +59,12 @@
     "component": {
       "type": "\"span\" | \"div\"",
       "required": false,
-      "description": "Root element."
+      "description": "Element of each placeholder."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the placeholder; `skeleton` unless given. With `count` > 1 it\nmarks the group, and each placeholder keeps `skeleton`."
     }
   }
 }

package/component-meta/feedBack/tooltip/tooltip.json

@@ -31,7 +31,7 @@
     "message": {
       "type": "React.ReactNode",
       "required": true,
-      "description": "Chat message data object."
+      "description": "What the tip says: text or markup."
     },
     "placement": {
       "type": "Placement",
@@ -46,17 +46,17 @@
     "trigger": {
       "type": "TooltipTrigger",
       "required": false,
-      "description": "hover (default): show on pointer enter; click: toggle; manual: use open only."
+      "description": "What shows the tooltip. `hover` (default): the pointer over the target or keyboard focus\nin it, until both have left. Keyboard focus is focus with a focus ring (`:focus-visible`),\nnot the focus a mouse press gives a button. `click`: a click on the target shows or hides\nit. `manual`: `open` alone. Escape hides a `hover` or `click` tooltip."
     },
     "openDelay": {
       "type": "number",
       "required": false,
-      "description": "Open Delay. Optional. Type: number."
+      "description": "Milliseconds from the pointer entering the target, or keyboard focus moving into it, until a hover tooltip shows."
     },
     "closeDelay": {
       "type": "number",
       "required": false,
-      "description": "Close Delay. Optional. Type: number."
+      "description": "Milliseconds from the pointer and keyboard focus both leaving the target until a hover tooltip hides."
     }
   }
 }