@smwb/ui-mcp-react 2.7.0 → 2.8.0

package/component-meta/base/icon/icon.json

@@ -59,12 +59,17 @@
     "title": {
       "type": "string",
       "required": false,
-      "description": "Accessible name. When provided the icon is exposed as\n`role=\"img\"`; otherwise it is `aria-hidden` (decorative)."
+      "description": "Accessible name, also shown as a tooltip. A non-empty `title`,\n`aria-label` or `aria-labelledby` names the icon: it is exposed as\n`role=\"img\"`, or with the `role` you pass. Without any of them the icon is\ndecorative and `aria-hidden`."
     },
     "source": {
       "type": "IconSource",
       "required": false,
       "description": "Overrides the icon source for this icon only. See IconSource."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<span>`; `icon` unless given."
     }
   }
 }

package/component-meta/base/ripple/ripple.json

@@ -29,7 +29,7 @@
     "classes": {
       "type": "RippleClasses",
       "required": false,
-      "description": "Classes. Optional. Type: RippleClasses."
+      "description": "Extra classes: `ripple` for the root, `child` for each ripple."
     },
     "center": {
       "type": "boolean",
@@ -45,6 +45,11 @@
       "type": "string",
       "required": false,
       "description": "Ripple color (any CSS color). Defaults to inherited currentColor."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<span>`; `ripple` unless given."
     }
   }
 }

package/component-meta/connects/rt/table/table.json

@@ -6,7 +6,7 @@
     "rendering": "universal"
   },
   "extends": [
-    "SMWBTableProps & {\n  withPagination?: boolean;\n  isInfinite?: boolean;\n  dense?: boolean;\n  limit?: number;\n  limitOptions?: number[];\n  sortable?: boolean;\n  expandable?: boolean;\n  draggableColumns?: boolean;\n  enableColumnResizing?: boolean;\n  onColumnSizingChange?: (oldValue: ColumnSizingState, newValue: ColumnSizingState) => void;\n  onColumnOrderChange?: (oldValue: ColumnOrderState, newValue: ColumnOrderState) => void;\n  getRowCanExpand?: (row: Row<TData>) => boolean;\n  renderSubComponent?: (props: { row: Row<TData> }) => React.ReactElement;\n  cellAlign?: \"left\" | \"right\" | \"center\";\n  isLoading?: boolean;\n  onNextPage?: () => void;\n  onPrevPage?: () => void;\n  error?: string;\n  onHeadCellClick?: (colDef?: ColumnDef<TData, TValue>) => void;\n  headerCellInnerRenderer?: React.ReactElement;\n  onBodyRowClick?: (row: Row<TData>, event: React.MouseEvent<HTMLTableRowElement>) => void;\n  data: TData[];\n  columns: ColumnDef<TData, TValue>[];\n  columnResizeMode?: ColumnResizeMode;\n}"
+    "SMWBTableProps & {\n  withPagination?: boolean;\n  isInfinite?: boolean;\n  dense?: boolean;\n  limit?: number;\n  limitOptions?: number[];\n  sortable?: boolean;\n  expandable?: boolean;\n  draggableColumns?: boolean;\n  enableColumnResizing?: boolean;\n  onColumnSizingChange?: (oldValue: ColumnSizingState, newValue: ColumnSizingState) => void;\n  onColumnOrderChange?: (oldValue: ColumnOrderState, newValue: ColumnOrderState) => void;\n  getRowCanExpand?: (row: Row<TData>) => boolean;\n  renderSubComponent?: (props: { row: Row<TData> }) => React.ReactElement;\n  cellAlign?: \"left\" | \"right\" | \"center\";\n  isLoading?: boolean;\n  onNextPage?: () => void;\n  onPrevPage?: () => void;\n  error?: string;\n  onHeadCellClick?: (colDef?: ColumnDef<TData, TValue>) => void;\n  headerCellInnerRenderer?: React.ReactElement;\n  onBodyRowClick?: (row: Row<TData>, event: React.MouseEvent<HTMLTableRowElement>) => void;\n  data: TData[];\n  /**\n   * TanStack column definitions. A column's `meta` may add `headerActions`\n   * (controls drawn beside the sort control in its head cell), `label` (its\n   * name on stacked rows), `cellProps` (attributes of its body cells) and\n   * `draggableColumn`.\n   */\n  columns: ColumnDef<TData, TValue>[];\n  columnResizeMode?: ColumnResizeMode;\n}"
   ],
   "styles": {
     "base": [

package/component-meta/dataDisplay/avatar/avatar.avatarGroup.json

@@ -50,6 +50,11 @@
       "type": "AvatarSize | number",
       "required": false,
       "description": "Size of the \"+N\" surplus chip: match the avatars in the group."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `avatar-group` unless given."
     }
   }
 }

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

@@ -55,6 +55,11 @@
       "type": "ImgHTMLAttributes<HTMLImageElement>",
       "required": false,
       "description": "Extra attributes forwarded to the underlying <img> (srcSet, loading…)."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `avatar` unless given."
     }
   }
 }

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

@@ -24,7 +24,7 @@
     "className": {
       "type": "string",
       "required": false,
-      "description": "Additional CSS class name(s) for the root element."
+      "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. With `onClick`, `role`, `tabIndex`, `onFocus`, `onBlur` and the other `aria-*`\nattributes go to the card's button, `.smwb-card__content` (the title and the children), which is also the element\nto focus. Without `onClick` the card is not a control, and they stay on the root, which holds the footer too."
     },
     "variant": {
       "type": "\"filled\" | \"elevated\" | \"outlined\"",
@@ -34,22 +34,27 @@
     "disabled": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the control is disabled and non-interactive."
+      "description": "Disables the card: it says `aria-disabled`, and neither clicks nor keys run `onClick`. With `onClick` the card is\nstill a button, out of the tab order."
     },
     "title": {
       "type": "string",
       "required": false,
-      "description": "Accessible title or tooltip text."
+      "description": "A heading drawn at the top of the card, not the `title` attribute. With `onClick` it is part of the card's button,\nand the button's name starts with it."
     },
     "footer": {
       "type": "ReactNode",
       "required": false,
-      "description": "Footer slot rendered after the content."
+      "description": "Footer slot rendered after the content. With `onClick` it sits beside the card's button, not inside it, so\ncontrols here keep their own names, clicks and keys; see `onClick`."
     },
     "onClick": {
       "type": "React.MouseEventHandler<HTMLDivElement>",
       "required": false,
-      "description": "Makes the card interactive (role=button, keyboard, focus ring)."
+      "description": "Makes the card interactive: its content (the title and the children) becomes a button, named by that content, with\na focus ring around the whole card. The footer is not part of that button but its sibling, so the card's controls\ngo there: a control in the children would sit inside the button, and its name would join the card's.\n\nRuns when the card is activated: a click on it, or Enter / Space while its button has focus. A click on a control\n(button, link, input, anything focusable), in the footer or the children, or in a portal opened from the card does\nnot run it, and neither do Enter / Space pressed on such a control. Content that is not a control keeps its click\nfrom activating the card by calling `preventDefault()` on it."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `card` unless given."
     }
   }
 }

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

@@ -68,6 +68,11 @@
       "type": "(chart: ChartInstance) => void",
       "required": false,
       "description": "The ECharts instance, once it has drawn — for other events and actions. Called again if a theme change re-creates it."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `chart` unless given."
     }
   }
 }

package/component-meta/dataDisplay/chat/chatLayout.json

@@ -89,6 +89,11 @@
       "type": "ChatLayoutChatProps",
       "required": true,
       "description": "Chat configuration passed to ChatLayout."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `chat-layout` unless given."
     }
   }
 }

package/component-meta/dataDisplay/chat/chatOverlayLayout.json

@@ -74,6 +74,11 @@
       "type": "ChatOverlayLayoutChatProps",
       "required": true,
       "description": "Chat configuration passed to ChatLayout."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `chat-overlay-layout` unless given."
     }
   }
 }

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

@@ -27,7 +27,7 @@
     "className": {
       "type": "string",
       "required": false,
-      "description": "Additional CSS class name(s) for the root element."
+      "description": "Class name(s) for the chip's root, a `<span>` (an `<a>` with `asLink`). `style`, `id`, `data-*`, `aria-hidden`,\n`ref` and event handlers go to the root too. In a clickable chip (`onClick`), `role`, `tabIndex`, `onFocus`,\n`onBlur` and the other `aria-*` attributes go to its button, `.smwb-chip__content` (the icon and the label), which\nis also the element to focus. Otherwise they stay on the root, which holds the delete button too."
     },
     "variant": {
       "type": "\"filled\" | \"outlined\"",
@@ -47,7 +47,7 @@
     "onDelete": {
       "type": "(event: React.SyntheticEvent) => void",
       "required": false,
-      "description": "On Delete. Optional. Type: (event: React.SyntheticEvent) => void."
+      "description": "Shows a delete button in the chip and runs when it is pressed: a click, or\nEnter / Space while the button has focus. In a clickable chip it sits\nbeside the chip's button, not inside it, and pressing it does not run the\nchip's `onClick`."
     },
     "icon": {
       "type": "React.ReactNode",
@@ -67,7 +67,7 @@
     "onClick": {
       "type": "() => void",
       "required": false,
-      "description": "Callback fired when the element is clicked."
+      "description": "Makes the chip clickable: its icon and label become a button, named by\nthem, with a focus ring around the whole chip. The delete button is not\npart of that button but its sibling, so it keeps its own name.\n\nRuns on a click on the chip and on Enter / Space while the chip's button\nhas focus, but not on a click or key on the delete button."
     },
     "onDeleteMouseDown": {
       "type": "React.MouseEventHandler",
@@ -77,7 +77,7 @@
     "disabled": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the control is disabled and non-interactive."
+      "description": "Disables the chip: it is dimmed, takes no pointer input and says `aria-disabled`, and its delete button is\ndisabled too. With `onClick` the chip is still a button, out of the tab order."
     },
     "asLink": {
       "type": "boolean",
@@ -99,10 +99,20 @@
       "required": false,
       "description": "Controlled selected tab index or value."
     },
+    "labelId": {
+      "type": "string",
+      "required": false,
+      "description": "Id of the label's element, for another element to take the chip's text as\nits name (`aria-labelledby`) without the delete button's name."
+    },
     "deleteAriaLabel": {
       "type": "string",
       "required": false,
       "description": "Accessible label for the delete control."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root; `chip`, or `chip-link` for a link, unless given."
     }
   }
 }

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

@@ -34,7 +34,7 @@
     "layout": {
       "type": "DescriptionListLayout",
       "required": false,
-      "description": "Current chat shell layout mode."
+      "description": "\"auto\" (default): each term beside its value while the list is at least\n420px wide, above it when narrower — the list's own width decides. So its\ncontent does not widen it: where the parent takes its width from its\ncontent (a flex item that does not grow, a popover, a table cell) the list\nhas no width; give it one there, or use \"row\" / \"stacked\", which fix one\nlayout and take their width from their content."
     },
     "termWidth": {
       "type": "number | string",

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

@@ -30,6 +30,11 @@
       "type": "number | string",
       "required": false,
       "description": "The narrowest a column gets before the board scrolls sideways: a number of\npixels or any CSS length. 15.5rem by default."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `kanban` unless given."
     }
   }
 }

package/component-meta/dataDisplay/kanban/kanban.kanbanCard.json

@@ -40,6 +40,11 @@
       "type": "number",
       "required": false,
       "description": "Lines the title is clamped to: 3 by default."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the card's `<li>`; `kanban-card` unless given."
     }
   }
 }

package/component-meta/dataDisplay/kanban/kanban.kanbanColumn.json

@@ -50,6 +50,11 @@
       "type": "ReactNode",
       "required": false,
       "description": "Under the cards, e.g. a link to the rest as a list."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the column's `<div>`; `kanban-column` 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/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/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/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

@@ -87,6 +87,11 @@
       "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."
     }
   }
 }

package/component-meta/inputs/button/button.json

@@ -88,6 +88,11 @@
       "type": "boolean",
       "required": false,
       "description": "Whether the ripple touch feedback is disabled."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root; `button`, or `button-link` for a link, unless given."
     }
   }
 }

package/component-meta/inputs/buttonGroups/buttonGroup.json

@@ -55,6 +55,11 @@
       "type": "\"primary\" | \"secondary\" | \"error\" | \"success\" | \"warning\" | \"info\"",
       "required": false,
       "description": "Semantic color propagated to child buttons."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `button-group` unless given."
     }
   }
 }

package/component-meta/inputs/checkbox/checkbox.json

@@ -37,7 +37,7 @@
     "readOnly": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the value is read-only."
+      "description": "Keeps the checkbox as it is: clicks on it or its label and Space change nothing, and `onChange` is not called.\nIt stays focusable, and its input tells assistive technology it is read-only (`aria-readonly`)."
     },
     "required": {
       "type": "boolean",
@@ -57,7 +57,7 @@
     "indeterminate": {
       "type": "boolean",
       "required": false,
-      "description": "Indeterminate. Optional. Type: boolean."
+      "description": "Shows the checkbox as partly checked, as for a \"select all\" over a partial selection: drawn with a dash and\nannounced as \"mixed\" by screen readers, whatever `checked` is. A click does not clear it: the click toggles\n`checked` as usual and `onChange` reports the new `checked`, while the checkbox stays mixed until this prop turns\nfalse."
     },
     "className": {
       "type": "string",

package/component-meta/inputs/radioButton/radioButton.json

@@ -38,7 +38,7 @@
     "readOnly": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the value is read-only."
+      "description": "Keeps the radio as it is: clicks on it or its label, Space and the arrow keys of its group do not check it, and\n`onChange` is not called. It stays focusable.\n\nThe input does not tell assistive technology it is read-only: ARIA has no read-only state for a single radio,\nonly for its group. Put `role=\"radiogroup\"`, a name and `aria-readonly=\"true\"` on the element around the radios."
     },
     "required": {
       "type": "boolean",
@@ -84,6 +84,11 @@
       "type": "( event: React.ChangeEvent<HTMLInputElement>, value: string | number | readonly string[] | boolean | undefined, data: RadioButtonProps ) => void",
       "required": false,
       "description": "Unified handler: `(event, value, data)` where `value` is the radio's value (or checked state)."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the `<input>`; `radio` unless given."
     }
   }
 }

package/component-meta/inputs/rating/rating.json

@@ -92,7 +92,17 @@
     "id": {
       "type": "string",
       "required": false,
-      "description": "Unique identifier for the root element."
+      "description": "Id of the control: the slider, or the image of a read-only rating."
+    },
+    "aria-label": {
+      "type": "string",
+      "required": false,
+      "description": "What is rated: the accessible name of the slider, \"Rating\" by default. A read-only rating is an image named by\nits value (\"3 of 5\"), after this label."
+    },
+    "aria-describedby": {
+      "type": "string",
+      "required": false,
+      "description": "Ids of more elements that describe the control, after its helper text."
     },
     "onChange": {
       "type": "(value: number) => void",

package/component-meta/inputs/selectField/dropdownMenu.json

@@ -106,6 +106,51 @@
       "type": "number",
       "required": false,
       "description": "Row height (px) used when `virtualized`."
+    },
+    "listboxId": {
+      "type": "string",
+      "required": false,
+      "description": "Id of the listbox; the options' ids follow from it (`dropdownOptionId`)."
+    },
+    "labelledBy": {
+      "type": "string",
+      "required": false,
+      "description": "Ids of the elements that name the listbox and the search box in the menu."
+    },
+    "label": {
+      "type": "string",
+      "required": false,
+      "description": "Names the listbox and the search box in the menu when no element does."
+    },
+    "multiple": {
+      "type": "boolean",
+      "required": false,
+      "description": "Several options can be selected (`aria-multiselectable`)."
+    },
+    "activeIndex": {
+      "type": "number",
+      "required": false,
+      "description": "Index of the active option, counting `items` and then the create option; -1 for none."
+    },
+    "showActive": {
+      "type": "boolean",
+      "required": false,
+      "description": "Marks the active option and keeps it in view: the keyboard moved to it."
+    },
+    "searchInputProps": {
+      "type": "React.InputHTMLAttributes<HTMLInputElement>",
+      "required": false,
+      "description": "Attributes and handlers of the search box in the menu, which the field makes a combobox."
+    },
+    "searchInputRef": {
+      "type": "React.Ref<HTMLInputElement>",
+      "required": false,
+      "description": "Search Input Ref. Optional. Type: React.Ref<HTMLInputElement>."
+    },
+    "menuRef": {
+      "type": "React.Ref<HTMLDivElement>",
+      "required": false,
+      "description": "The menu's root element."
     }
   }
 }

package/component-meta/inputs/selectField/selectField.json

@@ -33,7 +33,7 @@
     "value": {
       "type": "null | string | number | (string | number | undefined | null)[]",
       "required": false,
-      "description": "Controlled value."
+      "description": "The selected value, or the values of a `multiple` field. Any value but\n`undefined` makes the field controlled: it shows this value and nothing\nelse, and a pick, a chip delete or a clear only asks for a change through\n`onChange`. `null` means nothing is selected. While `value` is `undefined`,\nthe field keeps its own value, starting from `defaultValue`."
     },
     "defaultValue": {
       "type": "null | string | number | (string | number)[]",
@@ -88,7 +88,7 @@
     "search": {
       "type": "true | false | \"menu\"",
       "required": false,
-      "description": "Search. Optional. Type: true | false | \"menu\"."
+      "description": "A search box for the options: `true` puts it in the field, where it takes\nthe focus and is the combobox; `\"menu\"` puts it at the top of the menu,\nwhich moves the focus into it when it opens."
     },
     "chips": {
       "type": "boolean",
@@ -113,7 +113,7 @@
     "label": {
       "type": "string",
       "required": false,
-      "description": "Visible label text."
+      "description": "Visible label, drawn above the field (an `inline` field draws none). It\nnames the combobox, whose value is the selected text: \"Country\", \"Russia\".\nWith `chips` the chips' texts follow it in the name: \"Labels Backend Docs\"."
     },
     "variant": {
       "type": "\"outlined\" | \"filled\"",
@@ -168,7 +168,7 @@
     "optionRenderer": {
       "type": "(args: MenuItemProps) => React.ReactNode",
       "required": false,
-      "description": "Option Renderer. Optional. Type: (args: MenuItemProps) => React.ReactNode."
+      "description": "Draws an option in place of the default one. It gets the option's props\nand returns its `<li>`: pass `id`, `role`, `aria-selected`, `aria-disabled`,\n`className` and `onClick` on to it, so the option can be reached from the\nkeyboard, read out and picked."
     },
     "clearable": {
       "type": "boolean",
@@ -198,12 +198,12 @@
     "aria-label": {
       "type": "string",
       "required": false,
-      "description": "Accessible label for the combobox control."
+      "description": "Accessible name of the combobox. Replaces the name the visible `label`\ngives it; a field without a drawn label needs it."
     },
     "id": {
       "type": "string",
       "required": false,
-      "description": "Unique identifier for the root element."
+      "description": "Id of the control, the part of the field that holds the selected text. It is\nthe combobox, unless `search` puts a search box in it: then the box is."
     }
   }
 }

package/component-meta/inputs/slider/slider.json

@@ -71,7 +71,7 @@
     "valueField": {
       "type": "boolean",
       "required": false,
-      "description": "Value Field. Optional. Type: boolean."
+      "description": "Draws a number field beside the slider for typing the value; a single\n`discrete` slider only. The field is named as the slider is (see `label`\nand `aria-label`)."
     },
     "withTicks": {
       "type": "boolean",
@@ -81,7 +81,7 @@
     "label": {
       "type": "string",
       "required": false,
-      "description": "Visible label text."
+      "description": "Visible label, drawn above the slider. It names the slider; each thumb of a\nrange adds its own word: with `label=\"Price\"` they read \"Price minimum\" and\n\"Price maximum\"."
     },
     "helperText": {
       "type": "React.ReactNode",
@@ -121,7 +121,12 @@
     "aria-label": {
       "type": "string",
       "required": false,
-      "description": "Accessible label applied to the slider control."
+      "description": "Accessible name of the slider. Replaces the name the visible `label` gives\nit; a slider without a label needs it or `aria-labelledby`. Each thumb of a\nrange adds its own word, as with `label`."
+    },
+    "aria-labelledby": {
+      "type": "string",
+      "required": false,
+      "description": "Ids of the elements whose text names the slider. It goes on the range input,\nnot the root, and replaces the name the visible `label` gives it; as on any\nelement, it also wins over `aria-label`. Each thumb of a range adds its own\nword, as with `label`."
     },
     "getAriaValueText": {
       "type": "(value: number) => string",

package/component-meta/inputs/textField/textField.json

@@ -24,7 +24,7 @@
     "label": {
       "type": "string",
       "required": false,
-      "description": "Visible label text."
+      "description": "Visible label; it points to the `<input>`, so it also names the field. Not drawn for an `inline` field."
     },
     "helperText": {
       "type": "React.ReactNode",
@@ -59,7 +59,7 @@
     "className": {
       "type": "string",
       "required": false,
-      "description": "Additional CSS class name(s) for the root element."
+      "description": "Class name(s) for the root wrapper `<div>`. `style` and `data-*` attributes go to the wrapper too (a `data-testid`\nreplaces its default `text-field`); every other HTML attribute (`aria-*`, `autoFocus`, `maxLength`, event handlers)\ngoes to the `<input>`."
     },
     "placeholder": {
       "type": "string",
@@ -119,7 +119,7 @@
     "id": {
       "type": "string",
       "required": false,
-      "description": "Unique identifier for the root element."
+      "description": "Id of the `<input>`; the label points to it. Generated when not given."
     },
     "inline": {
       "type": "boolean",

package/component-meta/inputs/textField/textFieldWrapper.json

@@ -31,6 +31,11 @@
       "required": false,
       "description": "Supplementary hint text displayed below the control."
     },
+    "helperTextId": {
+      "type": "string",
+      "required": false,
+      "description": "Id of the helper text, for the control's `aria-describedby`. Only shown helper text takes it: not the blank line\ndrawn without helper text, and an inline field shows none."
+    },
     "variant": {
       "type": "\"outlined\" | \"filled\"",
       "required": false,
@@ -74,7 +79,12 @@
     "htmlFor": {
       "type": "string",
       "required": false,
-      "description": "Html For. Optional. Type: string."
+      "description": "Id of the control the label names. Without it, the label names nothing."
+    },
+    "labelId": {
+      "type": "string",
+      "required": false,
+      "description": "Id of the `<label>`. A control that `htmlFor` cannot label (one that is not\na form element, such as SelectField's `role=\"button\"`) points\n`aria-labelledby` at it."
     },
     "shrink": {
       "type": "boolean",
@@ -100,6 +110,11 @@
       "type": "boolean",
       "required": false,
       "description": "Inline. Optional. Type: boolean."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `text-field` unless given."
     }
   }
 }

package/component-meta/inputs/toggle/toggle.json

@@ -33,7 +33,7 @@
     "readOnly": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the value is read-only."
+      "description": "Keeps the switch as it is: clicks on it or its label and Space change nothing, and `onChange` is not called.\nIt stays focusable, and its input tells assistive technology it is read-only (`aria-readonly`)."
     },
     "required": {
       "type": "boolean",

package/component-meta/inputs/valueSlider/valueSlider.json

@@ -22,6 +22,16 @@
     "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/valueSlider/valueSlider.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/slider/slider.entry.less\";"
   },
   "props": {
+    "label": {
+      "type": "string",
+      "required": false,
+      "description": "Label text, drawn in the header row beside the readout. It names the slider,\nas `Slider`'s label does; each thumb of a range adds its own word: with\n`label=\"Price\"` they read \"Price minimum\" and \"Price maximum\"."
+    },
+    "aria-label": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible name of the slider. Replaces the name the header `label` gives\nit; a ValueSlider without a label needs it or `aria-labelledby`. Each thumb\nof a range adds its own word, as with `label`."
+    },
     "readout": {
       "type": "boolean | ((value: SliderValue | undefined) => string)",
       "required": false,
@@ -90,18 +100,13 @@
     "valueField": {
       "type": "boolean",
       "required": false,
-      "description": "Value Field. Optional. Type: boolean."
+      "description": "Draws a number field beside the slider for typing the value; a single\n`discrete` slider only. The field is named as the slider is (see `label`\nand `aria-label`)."
     },
     "withTicks": {
       "type": "boolean",
       "required": false,
       "description": "With Ticks. Optional. Type: boolean."
     },
-    "label": {
-      "type": "string",
-      "required": false,
-      "description": "Visible label text."
-    },
     "helperText": {
       "type": "React.ReactNode",
       "required": false,
@@ -137,10 +142,10 @@
       "required": false,
       "description": "Show ticks/marks. `true` derives marks from `step`; an array gives explicit positions/labels."
     },
-    "aria-label": {
+    "aria-labelledby": {
       "type": "string",
       "required": false,
-      "description": "Accessible label applied to the slider control."
+      "description": "Ids of the elements whose text names the slider. It goes on the range input,\nnot the root, and replaces the name the visible `label` gives it; as on any\nelement, it also wins over `aria-label`. Each thumb of a range adds its own\nword, as with `label`."
     },
     "getAriaValueText": {
       "type": "(value: number) => string",

package/component-meta/layout/appLayout/appLayout.json

@@ -87,6 +87,11 @@
       "type": "string",
       "required": false,
       "description": "Additional CSS class name(s) for the root element."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `app-layout` unless given."
     }
   }
 }

package/component-meta/layout/divider/divider.json

@@ -55,6 +55,11 @@
       "type": "boolean",
       "required": false,
       "description": "Stretch to fill a flex container along the cross axis."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `divider` unless given."
     }
   }
 }

package/component-meta/layout/floatingWindow/floatingWindow.json

@@ -193,6 +193,11 @@
       "type": "string",
       "required": false,
       "description": "Accessible label when no visible title is present."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the window's root `<div>`; `floating-window` unless given."
     }
   }
 }

package/component-meta/layout/grid/grid.column.json

@@ -6,7 +6,7 @@
     "rendering": "universal"
   },
   "extends": [
-    "React.HTMLAttributes<HTMLDivElement> & {\n  /** Ширина на точке остановы: 1–12 из 12, `\"auto\"` (по контенту) или `true` (заполнить). */\n  xs?: BreakpointType;\n  sm?: BreakpointType;\n  md?: BreakpointType;\n  lg?: BreakpointType;\n  xl?: BreakpointType;\n  /** Сдвиг (пустые ведущие колонки) на точке остановы, 0–11. */\n  xsOffset?: OffsetType;\n  smOffset?: OffsetType;\n  mdOffset?: OffsetType;\n  lgOffset?: OffsetType;\n  xlOffset?: OffsetType;\n  /** Скрыть колонку: булево (всегда) или по точкам остановы `{ xs:true, md:false }`. */\n  hidden?: ResponsiveBool;\n}"
+    "React.HTMLAttributes<HTMLDivElement> & {\n  /** Ширина на точке остановы: 1–12 из 12, `\"auto\"` (по контенту) или `true` (заполнить). */\n  xs?: BreakpointType;\n  sm?: BreakpointType;\n  md?: BreakpointType;\n  lg?: BreakpointType;\n  xl?: BreakpointType;\n  /** Сдвиг (пустые ведущие колонки) на точке остановы, 0–11. */\n  xsOffset?: OffsetType;\n  smOffset?: OffsetType;\n  mdOffset?: OffsetType;\n  lgOffset?: OffsetType;\n  xlOffset?: OffsetType;\n  /** Скрыть колонку: булево (всегда) или по точкам остановы `{ xs:true, md:false }`. */\n  hidden?: ResponsiveBool;\n  /** Test id of the root `<div>`; `grid-col` unless given. */\n  \"data-testid\"?: string;\n}"
   ],
   "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
   "styles": {

package/component-meta/layout/grid/grid.container.json

@@ -30,6 +30,11 @@
       "type": "boolean",
       "required": false,
       "description": "Remove horizontal gutters."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `grid-container` unless given."
     }
   }
 }

package/component-meta/layout/grid/grid.row.json

@@ -45,6 +45,11 @@
       "type": "number",
       "required": false,
       "description": "Spacing between stacked children."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `grid-row` unless given."
     }
   }
 }

package/component-meta/layout/page/page.json

@@ -40,6 +40,11 @@
       "type": "string",
       "required": false,
       "description": "Additional CSS class name(s) for the root element."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root element; `page` unless given."
     }
   }
 }

package/component-meta/layout/pageHeader/pageHeader.json

@@ -52,6 +52,11 @@
       "type": "string",
       "required": false,
       "description": "Additional CSS class name(s) for the root element."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<header>`; `page-header` unless given."
     }
   }
 }

package/component-meta/layout/sectionHeader/sectionHeader.json

@@ -63,6 +63,11 @@
       "type": "ReactNode",
       "required": false,
       "description": "A line under the title."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<header>`; `section-header` unless given."
     }
   }
 }

package/component-meta/layout/sheet/sheet.json

@@ -115,6 +115,11 @@
       "type": "string",
       "required": false,
       "description": "Accessible label when no visible title is present."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the sheet panel (the dialog); `sheet` unless given."
     }
   }
 }

package/component-meta/layout/stack/stack.json

@@ -55,6 +55,11 @@
       "type": "string",
       "required": false,
       "description": "Additional CSS class name(s) for the root element."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<div>`; `stack` unless given."
     }
   }
 }

package/component-meta/navigation/appBar/appBar.json

@@ -75,6 +75,11 @@
       "type": "AppBarColor",
       "required": false,
       "description": "Semantic background color."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root (`<header>`, or `<footer>` at the bottom); `app-bar` unless given."
     }
   }
 }

package/component-meta/navigation/breadcrumbs/breadcrumbs.json

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

package/component-meta/navigation/menu/menu.json

@@ -7,7 +7,7 @@
     "note": "The trigger renders on the server; the menu surface mounts on the client."
   },
   "extends": [
-    "MenuFloatingProps &\n  React.HTMLAttributes<HTMLElement> & {\n    variant?: \"static\" | \"floating\";\n    dense?: boolean;\n  }"
+    "MenuFloatingProps &\n  React.HTMLAttributes<HTMLElement> & {\n    variant?: \"static\" | \"floating\";\n    dense?: boolean;\n    /**\n     * Role of the list inside the menu, `menu` by default. A component that draws\n     * a list of its own on the menu's surface sets `presentation`: SelectField's\n     * options are a `listbox` inside it.\n     */\n    listRole?: React.AriaRole;\n  }"
   ],
   "inheritedAttributes": "Also accepts standard HTML attributes for the underlying element (see extends clause in TypeScript).",
   "styles": {

package/component-meta/navigation/menu/menuItem.json

@@ -26,7 +26,7 @@
     "disabled": {
       "type": "boolean",
       "required": false,
-      "description": "Whether the control is disabled and non-interactive."
+      "description": "Greys the item out and marks it `aria-disabled`. It takes no focus, the arrow keys\nskip it, and neither a click nor Enter or Space chooses it."
     },
     "selected": {
       "type": "boolean",

package/component-meta/navigation/pagination/pagination.json

@@ -97,6 +97,11 @@
       "type": "(page: number) => void",
       "required": false,
       "description": "Callback fired when the value changes."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the root `<nav>`; `pagination` unless given."
     }
   }
 }

package/component-meta/navigation/stepper/stepper.json

@@ -52,6 +52,11 @@
       "type": "(index: number) => void",
       "required": false,
       "description": "Makes steps clickable; receives the clicked step index."
+    },
+    "data-testid": {
+      "type": "string",
+      "required": false,
+      "description": "Test id of the stepper `<div>`; `stepper` unless given."
     }
   }
 }

package/component-meta/navigation/tabs/tabs.json

@@ -24,17 +24,17 @@
     "value": {
       "type": "number",
       "required": true,
-      "description": "Controlled value."
+      "description": "Index of the selected tab. Tabs count in the order they render: a tab left out,\nsuch as `{show && <Tab />}` while `show` is false, takes no index."
     },
     "onChange": {
       "type": "(e: React.MouseEvent<HTMLButtonElement>, index: number) => void",
       "required": true,
-      "description": "Callback fired when the value changes."
+      "description": "Called with the index of the clicked tab, counted as for `value`."
     },
     "indicatorContent": {
       "type": "boolean",
       "required": false,
-      "description": "Indicator Content. Optional. Type: boolean."
+      "description": "Draw the indicator as wide as the selected tab's label rather than the whole tab."
     },
     "scrollable": {
       "type": "boolean",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smwb/ui-mcp-react",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "Model Context Protocol server exposing the @smwb/ui-react (React) component catalog and customization guide.",
   "license": "MIT",
   "type": "module",
@@ -28,8 +28,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@smwb/ui-react": "^2.7.0",
-    "@smwb/ui-styles": "^1.5.0",
+    "@smwb/ui-react": "^2.8.0",
+    "@smwb/ui-styles": "^1.6.0",
     "glob": "^13.0.6",
     "typescript": "^6.0.3",
     "vitest": "^2.1.9"