@smwb/ui-mcp-solid 0.13.0 → 0.14.0

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

@@ -0,0 +1,24 @@
+{
+  "name": "ChatFooterComposer",
+  "description": "Props for the `Composer` Chat draws as its footer. The props Chat owns itself — `onSendMessage` (the composer's\n`onSend`), `busy`, `onStop`, `composerPlaceholder` (`placeholder`), `composerDisabled` (`disabled`), the file upload\nprops (`onAttach`, `accept`, `multiple`, `maxFiles`) and `dropTarget` (always `false`: the Chat shell is the drop\ntarget) — are left out, Chat passes them and does not let a caller override them.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<\n  ComposerProps,\n  | \"onSend\"\n  | \"busy\"\n  | \"onStop\"\n  | \"disabled\"\n  | \"placeholder\"\n  | \"onAttach\"\n  | \"accept\"\n  | \"multiple\"\n  | \"maxFiles\"\n  | \"dropTarget\"\n>"
+  ],
+  "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/chat/chat.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/chat/chat.entry.less\";"
+  },
+  "props": {}
+}

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

@@ -20,6 +20,7 @@
     ],
     "dependencies": [
       "@smwb/ui-styles/less/components/avatar/avatar.entry.less",
+      "@smwb/ui-styles/less/components/composer/composer.entry.less",
       "@smwb/ui-styles/less/components/floatingButton/floatingButton.entry.less",
       "@smwb/ui-styles/less/components/icon/icon.entry.less",
       "@smwb/ui-styles/less/components/ripple/ripple.entry.less",
@@ -27,7 +28,7 @@
       "@smwb/ui-styles/less/components/textField/textField.entry.less",
       "@smwb/ui-styles/less/components/typography/typography.entry.less"
     ],
-    "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/chat/chat.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/avatar/avatar.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/floatingButton/floatingButton.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\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/typography/typography.entry.less\";"
+    "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/chat/chat.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/avatar/avatar.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/composer/composer.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/floatingButton/floatingButton.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\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/typography/typography.entry.less\";"
   },
   "props": {
     "class": {
@@ -145,6 +146,26 @@
       "required": false,
       "description": "On Send Message. Optional. Type: ((text: string) => void | Promise<void>) | undefined."
     },
+    "busy": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "The agent is replying: the composer's send button turns into Stop and calls `onStop`, the keys do not send, the\ntext stays editable. Not the same as `loading` (the message list skeleton). The default composer only."
+    },
+    "onStop": {
+      "type": "(() => void) | undefined",
+      "required": false,
+      "description": "Called when Stop is pressed while `busy` (and not `composerDisabled`). The default composer only."
+    },
+    "composerProps": {
+      "type": "ChatFooterComposerProps | undefined",
+      "required": false,
+      "description": "More props for the built-in `Composer`: `toolbar`, `attachments`, `maxLength`, `counter`, `minRows`, `maxRows`,\n`layout`, `sendKey` (default here `\"enter\"`), `value`/`defaultValue`/`onValueChange`, `clearOnSend`, `autofocus`,\n`inputRef`, `aria-*`, `sendLabel`, `stopLabel`, `attachLabel`, `class`, `data-*`, … Chat's own props\n(`onSendMessage`, `busy`, `onStop`, `composerPlaceholder`, `composerDisabled`, the file upload props) win."
+    },
+    "legacyComposer": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Deprecated: draws the old `ChatComposer` (Enter sends, TextField DOM, `chat-composer*` test ids) instead of the\nbuilt-in `Composer`. Kept for the migration and removed with `ChatComposer` in the next major; `busy`, `onStop`\nand `composerProps` are ignored in this mode."
+    },
     "composerPlaceholder": {
       "type": "string | undefined",
       "required": false,
@@ -158,12 +179,12 @@
     "composerShiftEnterNewline": {
       "type": "boolean | undefined",
       "required": false,
-      "description": "Composer Shift Enter Newline. Optional. Type: boolean | undefined."
+      "description": "Deprecated: works with `legacyComposer` only — the built-in `Composer` always inserts a newline on Shift+Enter.\nPass it together with `legacyComposer` until that is removed."
     },
     "composerCtrlEnterNewline": {
       "type": "boolean | undefined",
       "required": false,
-      "description": "Composer Ctrl Enter Newline. Optional. Type: boolean | undefined."
+      "description": "Deprecated: works with `legacyComposer` only — with the built-in `Composer` Ctrl/⌘+Enter sends. Pass it together\nwith `legacyComposer` until that is removed."
     },
     "fileUpload": {
       "type": "boolean | undefined",

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

@@ -1,6 +1,6 @@
 {
   "name": "ChatComposer",
-  "description": "Chat Composer component from the dataDisplay module.",
+  "description": "Deprecated: the old chat input (Enter sends, TextField-based). Use Composer; Chat draws a Composer by default (legacyComposer keeps this one during the migration).",
   "ssr": {
     "safe": true,
     "rendering": "universal"

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

@@ -20,6 +20,7 @@
     ],
     "dependencies": [
       "@smwb/ui-styles/less/components/avatar/avatar.entry.less",
+      "@smwb/ui-styles/less/components/composer/composer.entry.less",
       "@smwb/ui-styles/less/components/floatingButton/floatingButton.entry.less",
       "@smwb/ui-styles/less/components/icon/icon.entry.less",
       "@smwb/ui-styles/less/components/ripple/ripple.entry.less",
@@ -27,7 +28,7 @@
       "@smwb/ui-styles/less/components/textField/textField.entry.less",
       "@smwb/ui-styles/less/components/typography/typography.entry.less"
     ],
-    "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/chat/chat.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/avatar/avatar.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/floatingButton/floatingButton.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\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/typography/typography.entry.less\";"
+    "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/chat/chat.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/avatar/avatar.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/composer/composer.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/floatingButton/floatingButton.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\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/typography/typography.entry.less\";"
   },
   "props": {
     "contentClass": {

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

@@ -20,6 +20,7 @@
     ],
     "dependencies": [
       "@smwb/ui-styles/less/components/avatar/avatar.entry.less",
+      "@smwb/ui-styles/less/components/composer/composer.entry.less",
       "@smwb/ui-styles/less/components/floatingButton/floatingButton.entry.less",
       "@smwb/ui-styles/less/components/icon/icon.entry.less",
       "@smwb/ui-styles/less/components/ripple/ripple.entry.less",
@@ -27,7 +28,7 @@
       "@smwb/ui-styles/less/components/textField/textField.entry.less",
       "@smwb/ui-styles/less/components/typography/typography.entry.less"
     ],
-    "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/chat/chat.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/avatar/avatar.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/floatingButton/floatingButton.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\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/typography/typography.entry.less\";"
+    "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/chat/chat.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/avatar/avatar.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/composer/composer.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/floatingButton/floatingButton.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\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/textField/textField.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/typography/typography.entry.less\";"
   },
   "props": {
     "contentClass": {

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

@@ -0,0 +1,65 @@
+{
+  "name": "DiffStat",
+  "description": "The size of a change: \"+N −M\" (U+2212 minus) in the theme's success and error, with an optional five-cell bar of the same proportions and a compact tab variant; one accessible name (\"added N, removed M\", overridable with format) instead of the digits read twice (role=img).",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<JSX.HTMLAttributes<HTMLSpanElement>, \"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/diffStat/diffStat.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/diffStat/diffStat.entry.less\";"
+  },
+  "props": {
+    "added": {
+      "type": "number",
+      "required": true,
+      "description": "Lines added; the figure behind \"+N\". NaN, `undefined`, Infinity and negatives count as 0."
+    },
+    "removed": {
+      "type": "number",
+      "required": true,
+      "description": "Lines removed; the figure behind \"−M\". NaN, `undefined`, Infinity and negatives count as 0."
+    },
+    "bar": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "The five cells beside the figures. Shown by default, hidden in `compact`; set it either way."
+    },
+    "compact": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "The tab variant: smaller figures, and no bar unless `bar` asks for one."
+    },
+    "format": {
+      "type": "DiffStatFormat | undefined",
+      "required": false,
+      "description": "How the accessible name is made from the two counts, as numbers: `DEFAULT_DIFF_STAT_FORMAT` unless given."
+    },
+    "group": {
+      "type": "((value: number) => string) | undefined",
+      "required": false,
+      "description": "How each figure is written (it gets the count as `diffStatCount` takes it): `groupDiffStatCount` — three digits per group — unless given."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root `<span>`; `diff-stat` unless given."
+    },
+    "ref": {
+      "type": "Ref<HTMLSpanElement>",
+      "required": false,
+      "description": "Ref. Optional. Type: Ref<HTMLSpanElement>."
+    }
+  }
+}

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<JSX.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": {
+    "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 | undefined",
+      "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 | undefined",
+      "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 | undefined",
+      "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 | undefined",
+      "required": false,
+      "description": "Test id of the root `<kbd>`; `kbd` unless given."
+    },
+    "ref": {
+      "type": "Ref<HTMLElement>",
+      "required": false,
+      "description": "Ref. Optional. Type: Ref<HTMLElement>."
+    }
+  }
+}

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": "JSX.Element",
       "required": false,
-      "description": "End Adornment. Optional. Type: JSX.Element."
+      "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 | undefined",
+      "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 | undefined",
+      "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": "JSX.EventHandlerUnion<HTMLLIElement, MouseEvent>",
       "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."
     },
     "ref": {
       "type": "Ref<HTMLLIElement>",

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

@@ -0,0 +1,65 @@
+{
+  "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<JSX.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": "JSX.Element",
+      "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."
+    },
+    "ref": {
+      "type": "Ref<HTMLElement>",
+      "required": false,
+      "description": "Ref. Optional. Type: Ref<HTMLElement>."
+    }
+  }
+}

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<JSX.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": {
+    "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."
+    },
+    "ref": {
+      "type": "Ref<HTMLSpanElement>",
+      "required": false,
+      "description": "Ref. Optional. Type: Ref<HTMLSpanElement>."
+    }
+  }
+}

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

@@ -0,0 +1,95 @@
+{
+  "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<JSX.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 shown."
+    },
+    "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": "Height of the grid (the scroller): a number of pixels or any CSS length;\n480 by 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. Read once, when the grid mounts."
+    },
+    "emptyLabel": {
+      "type": "JSX.Element",
+      "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."
+    },
+    "ref": {
+      "type": "Ref<HTMLDivElement>",
+      "required": false,
+      "description": "Ref. Optional. Type: Ref<HTMLDivElement>."
+    }
+  }
+}

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

@@ -71,22 +71,37 @@
     "selectable": {
       "type": "boolean",
       "required": false,
-      "description": "Selectable. Optional. Type: boolean."
+      "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": "Checkboxes. Optional. Type: boolean."
+      "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) => JSX.Element",
       "required": false,
-      "description": "Render Label. Optional. Type: (item: ITreeNodeItem, nodeId: string) => JSX.Element."
+      "description": "Custom node renderer."
+    },
+    "renderActions": {
+      "type": "(item: ITreeNodeItem, nodeId: string) => JSX.Element",
+      "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": "Load Children. Optional. Type: (item: ITreeNodeItem, nodeId: string) => Promise<ITreeNodeItem[]>."
+      "description": "Lazily resolves children the first time a node is expanded."
     },
     "data-testid": {
       "type": "string | undefined",

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

@@ -64,6 +64,16 @@
       "required": false,
       "description": "When set, the component renders as an <a>."
     },
+    "target": {
+      "type": "string | null | undefined",
+      "required": false,
+      "description": "Where a link (with `href`) opens. By default `\"_blank\"`: a new tab. `null` leaves the `target`\nattribute out, so the link opens in place, like an internal one; an empty string does the same, and\nany other string is used as is."
+    },
+    "rel": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "The `rel` of a link (with `href`). By default `\"noreferrer\"` for a link that opens another tab or\nwindow, and 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."
+    },
     "disabled": {
       "type": "boolean",
       "required": false,