@smwb/ui-mcp-solid 0.12.1 → 0.13.0

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

@@ -54,13 +54,18 @@
     "title": {
       "type": "string",
       "required": false,
-      "description": "Accessible name. When provided the icon is exposed as `role=\"img\"`;\notherwise 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 | undefined",
+      "required": false,
+      "description": "Test id of the root `<span>`; `icon` unless given."
+    },
     "ref": {
       "type": "Ref<HTMLSpanElement>",
       "required": false,

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 | undefined",
@@ -46,6 +46,11 @@
       "required": false,
       "description": "Ripple color (any CSS color). Defaults to inherited currentColor."
     },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root `<span>`; `ripple` unless given."
+    },
     "ref": {
       "type": "Ref<HTMLSpanElement>",
       "required": false,

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

@@ -28,7 +28,7 @@
     "columns": {
       "type": "ColumnDef<TData, TValue>[]",
       "required": true,
-      "description": "Table column definitions."
+      "description": "TanStack column definitions. A column's `meta` may add `headerActions`\n(controls drawn beside the sort control in its head cell), `label` (its\nname on stacked rows) and `cellProps` (attributes of its body cells)."
     },
     "sortable": {
       "type": "boolean",

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

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

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

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

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

@@ -21,6 +21,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/card/card.entry.less\";"
   },
   "props": {
+    "class": {
+      "type": "string | undefined",
+      "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. 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\"",
       "required": false,
@@ -29,17 +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."
+    },
+    "onClick": {
+      "type": "JSX.EventHandlerUnion<HTMLDivElement, MouseEvent> | undefined",
+      "required": false,
+      "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."
     },
     "footer": {
       "type": "JSX.Element",
       "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`."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root `<div>`; `card` unless given."
     },
     "ref": {
       "type": "Ref<HTMLDivElement>",

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

@@ -64,6 +64,11 @@
       "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 | undefined",
+      "required": false,
+      "description": "Test id of the root `<div>`; `chart` unless given."
+    },
     "ref": {
       "type": "Ref<HTMLDivElement>",
       "required": false,

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

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

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

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

package/component-meta/dataDisplay/chip/chip.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/chip/chip.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/icon/icon.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/ripple/ripple.entry.less\";"
   },
   "props": {
+    "class": {
+      "type": "string | undefined",
+      "required": false,
+      "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\"",
       "required": false,
@@ -42,7 +47,7 @@
     "onDelete": {
       "type": "(event: MouseEvent & { currentTarget: HTMLButtonElement; target: Element }) => void",
       "required": false,
-      "description": "On Delete. Optional. Type: (event: MouseEvent & { currentTarget: HTMLButtonElement; target: Element }) => 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": "JSX.Element",
@@ -62,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": "JSX.EventHandlerUnion<HTMLButtonElement, MouseEvent>",
@@ -72,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",
@@ -94,11 +99,21 @@
       "required": false,
       "description": "Controlled selected tab index or value."
     },
+    "labelId": {
+      "type": "string | undefined",
+      "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 | undefined",
+      "required": false,
+      "description": "Test id of the root; `chip`, or `chip-link` for a link, unless given."
+    },
     "ref": {
       "type": "Ref<HTMLSpanElement | HTMLAnchorElement>",
       "required": false,

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

@@ -0,0 +1,170 @@
+{
+  "name": "DagView",
+  "description": "A dependency graph (DAG): nodes laid out in layers (LR or TB) with arrowed edges, status colours from theme tokens, any node content through renderNode, single selection that lights the selected node's edges, and pan/zoom by mouse, wheel, trackpad, touch and keyboard (role=listbox of options).",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<JSX.HTMLAttributes<HTMLDivElement>, \"onClick\">"
+  ],
+  "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/dagView/dagView.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/dagView/dagView.entry.less\";"
+  },
+  "props": {
+    "label": {
+      "type": "string",
+      "required": true,
+      "description": "What the graph shows: its accessible name."
+    },
+    "summary": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "The graph in words, for screen readers; it is there on the server too."
+    },
+    "nodes": {
+      "type": "readonly DagViewNode<T>[]",
+      "required": true,
+      "description": "The nodes. A change of status, label or data alone does not lay the graph out again."
+    },
+    "edges": {
+      "type": "readonly DagViewEdge[]",
+      "required": true,
+      "description": "The edges, from the node depended on to the node that depends on it."
+    },
+    "renderNode": {
+      "type": "((node: DagViewNode<T>, state: DagViewNodeState) => JSX.Element) | undefined",
+      "required": false,
+      "description": "Draws a node's content inside its box; the default shows a status dot,\nthe label and the status word. Called once per node: `node` and `state`\nare reactive, so read their fields in JSX. Keep the content\nnon-interactive where you can: a node is an ARIA option, whose content\nassistive technology may read as plain text, and a click in it also\nselects the node. Links and buttons in it are left out of the Tab order\nexcept in the node that is the graph's Tab stop."
+    },
+    "direction": {
+      "type": "DagDirection | undefined",
+      "required": false,
+      "description": "Which way the layers run: \"LR\" (left to right, default) or \"TB\" (top to bottom)."
+    },
+    "nodeWidth": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "A node's width in pixels, unless the node sets its own; 180 by default."
+    },
+    "nodeHeight": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "A node's height in pixels, unless the node sets its own; 56 by default."
+    },
+    "rankGap": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "The space between layers in pixels; 64 by default."
+    },
+    "nodeGap": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "The space between nodes in a layer in pixels; 24 by default."
+    },
+    "layout": {
+      "type": "((input: DagLayoutInput) => DagLayoutResult) | undefined",
+      "required": false,
+      "description": "Lays the graph out in place of the built-in layout, e.g. with dagre or elk. It must be synchronous."
+    },
+    "selectedId": {
+      "type": "string | null | undefined",
+      "required": false,
+      "description": "The selected node's id (controlled); null selects nothing."
+    },
+    "defaultSelectedId": {
+      "type": "string | null | undefined",
+      "required": false,
+      "description": "The node selected at first (uncontrolled)."
+    },
+    "onSelectedChange": {
+      "type": "((id: string | null) => void) | undefined",
+      "required": false,
+      "description": "A node was selected (its id) or the selection was cleared (null)."
+    },
+    "onNodeClick": {
+      "type": "((node: DagViewNode<T>, event: MouseEvent | KeyboardEvent) => void) | undefined",
+      "required": false,
+      "description": "A node was clicked, or chosen with Enter or Space. Not called for a disabled node."
+    },
+    "dimUnrelated": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Fades the nodes and edges that are not next to the selected node."
+    },
+    "viewport": {
+      "type": "DagViewViewport | undefined",
+      "required": false,
+      "description": "Where the graph is (controlled)."
+    },
+    "defaultViewport": {
+      "type": "DagViewViewport | undefined",
+      "required": false,
+      "description": "Where the graph is at first (uncontrolled); with `fit={false}` the page does not move after it loads."
+    },
+    "onViewportChange": {
+      "type": "((viewport: DagViewViewport) => void) | undefined",
+      "required": false,
+      "description": "The view moved or zoomed: at most once per frame during a gesture."
+    },
+    "fit": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Fits the graph in view once it is in the page, and again when its nodes or edges change; true by default."
+    },
+    "minZoom": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "The smallest zoom; 0.1 by default."
+    },
+    "maxZoom": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "The largest zoom; 2 by default."
+    },
+    "wheel": {
+      "type": "\"zoom\" | \"pan\" | \"none\" | undefined",
+      "required": false,
+      "description": "What a plain mouse wheel does: \"zoom\" (default), \"pan\", or \"none\" (the page scrolls). Ctrl+wheel and a trackpad pinch always zoom."
+    },
+    "controls": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Shows the zoom in, zoom out and fit buttons; true by default."
+    },
+    "labels": {
+      "type": "Partial<DagViewLabels> | undefined",
+      "required": false,
+      "description": "Texts for assistive technology and the buttons, over the English defaults."
+    },
+    "height": {
+      "type": "number | string | undefined",
+      "required": false,
+      "description": "The graph's height: a number of pixels or any CSS length; 480 by default,\nfrom the stylesheet, so a height in `style` works too. It fills the width."
+    },
+    "apiRef": {
+      "type": "((api: DagViewApi) => void) | undefined",
+      "required": false,
+      "description": "Gets the functions that move the view from outside."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root `<div>`; `dag-view` unless given."
+    },
+    "ref": {
+      "type": "Ref<HTMLDivElement>",
+      "required": false,
+      "description": "Ref. Optional. Type: Ref<HTMLDivElement>."
+    }
+  }
+}

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

@@ -29,7 +29,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

@@ -26,6 +26,11 @@
       "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 | undefined",
+      "required": false,
+      "description": "Test id of the root `<div>`; `kanban` unless given."
+    },
     "ref": {
       "type": "Ref<HTMLDivElement>",
       "required": false,

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

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

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

@@ -46,6 +46,11 @@
       "required": false,
       "description": "Under the cards, e.g. a link to the rest as a list."
     },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the column's `<div>`; `kanban-column` unless given."
+    },
     "ref": {
       "type": "Ref<HTMLDivElement>",
       "required": false,

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

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

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

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

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

@@ -63,6 +63,11 @@
       "required": false,
       "description": "A second line under the name: a role, a date."
     },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root; `person-chip` unless given."
+    },
     "ref": {
       "type": "Ref<HTMLElement>",
       "required": false,

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

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

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

@@ -52,7 +52,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. The cells\nand rows count as they are drawn, the ones a component renders included."
     },
     "paginationSettings": {
       "type": "TablePaginationProps",

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

@@ -27,9 +27,14 @@
       "description": "Cell Align. Optional. Type: \"left\" | \"right\" | \"center\"."
     },
     "label": {
-      "type": "string",
+      "type": "string | false",
       "required": false,
-      "description": "The column's name, shown next to the value when the table stacks rows as cards (`Table stackBelow`)."
+      "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 | undefined",
+      "required": false,
+      "description": "The cell's label written by hand, as the attribute the stacked layout shows; `label` replaces it."
     },
     "ref": {
       "type": "Ref<HTMLTableCellElement>",

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

@@ -41,7 +41,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",
@@ -53,6 +53,16 @@
       "required": false,
       "description": "Invoked when the user activates the sort control."
     },
+    "actions": {
+      "type": "JSX.Element",
+      "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) or more than the\nname, or where their text changes inside markup: the text of markup is read\nwhen it is created. An empty `label` leaves the column's cells unlabelled, so\nthey fill the card's width."
+    },
     "ref": {
       "type": "Ref<HTMLTableCellElement>",
       "required": false,

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

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

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": {
+    "class": {
+      "type": "string | undefined",
+      "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": "JSX.Element",
       "required": false,
-      "description": "Caption. Optional. Type: JSX.Element."
+      "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": "JSX.EventHandlerUnion<HTMLDivElement, MouseEvent> | 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": "JSX.Element",
@@ -57,12 +67,12 @@
     "topStart": {
       "type": "JSX.Element",
       "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": "JSX.Element",
       "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",