@smwb/ui-mcp-solid 0.13.0 → 1.0.0

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

@@ -0,0 +1,222 @@
+{
+  "name": "Composer",
+  "description": "A task input: a multi-line field that grows from minRows to maxRows, a toolbar slot under it for chip selectors, a send button that becomes Stop while busy, keyboard send (Ctrl/⌘+Enter by default), optional attach button and drop target, and a character counter.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "extends": [
+    "Omit<\n  JSX.HTMLAttributes<HTMLDivElement>,\n  \"onChange\" | \"defaultValue\" | \"onKeyDown\" | \"onFocus\" | \"onBlur\" | \"children\"\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/composer/composer.entry.less"
+    ],
+    "dependencies": [
+      "@smwb/ui-styles/less/components/icon/icon.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/composer/composer.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/icon/icon.entry.less\";"
+  },
+  "props": {
+    "value": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Controlled text. The composer is controlled while this is not `undefined` (checked reactively); a parent that\nignores `onValueChange` keeps the field showing this value."
+    },
+    "defaultValue": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Initial text while uncontrolled. Defaults to an empty string."
+    },
+    "onValueChange": {
+      "type": "((value: string) => void) | undefined",
+      "required": false,
+      "description": "Called on every text change: typing, a newline, and the clear after a send. Called in both modes."
+    },
+    "onSend": {
+      "type": "((text: string) => void) | undefined",
+      "required": false,
+      "description": "Called with the trimmed text when the user sends it: the send key (see `sendKey`) or a click on the action\nbutton. Nothing is called while sending is not allowed: no `onSend`, an empty or whitespace-only text, `disabled`,\n`readOnly`, `busy`, or a text over `maxLength`. Async work is shown with `busy`; the return value is ignored."
+    },
+    "sendKey": {
+      "type": "ComposerSendKey | undefined",
+      "required": false,
+      "description": "Which Enter sends. `\"modEnter\"` (default): Ctrl/⌘+Enter sends and Enter inserts a newline. `\"enter\"`: Enter sends,\nShift+Enter inserts a newline, Ctrl/⌘+Enter sends too. An Enter that commits an IME composition never sends."
+    },
+    "clearOnSend": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Clear the text after `onSend`: the composer's own state while uncontrolled, `onValueChange(\"\")` while controlled.\nDefaults to `true`."
+    },
+    "busy": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "The agent is working: the action button turns into Stop and calls `onStop`, and the keys and the button do not\nsend. The text stays editable. The composer never changes `busy` itself, the parent owns it."
+    },
+    "onStop": {
+      "type": "(() => void) | undefined",
+      "required": false,
+      "description": "Called when Stop is pressed (click, Enter or Space on the button) while `busy` and not `disabled`. Without it the\nStop button does nothing, so pass it whenever `busy` can be set."
+    },
+    "placeholder": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Placeholder of the textarea. It is not a name for the field, set `aria-label` or `aria-labelledby` as well."
+    },
+    "maxLength": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Hard limit on the text (the native `maxlength` of the textarea, counted in UTF-16 units, so an emoji is 2).\nTurns the counter on."
+    },
+    "counter": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Show the counter (`n / maxLength`, or `n` without `maxLength`). Defaults to `true` when `maxLength` is set."
+    },
+    "counterAnnouncement": {
+      "type": "((remaining: number, maxLength: number) => string) | undefined",
+      "required": false,
+      "description": "Text for the polite status region that announces how many characters are left. It is spoken only near the limit\n(within the larger of 10 characters and 10% of `maxLength`) and when the text is over it, with a negative\n`remaining`. Defaults to \"N characters left\" / \"N characters over the limit\"."
+    },
+    "minRows": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Height of the empty field in rows, and the `rows` of the textarea. Defaults to `1`."
+    },
+    "maxRows": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Rows the field grows to before it scrolls. Clamped to at least `minRows`. Defaults to `8`."
+    },
+    "layout": {
+      "type": "ComposerLayout | undefined",
+      "required": false,
+      "description": "`\"stacked\"` (default): the field on top, a bar under it with the attach button, the toolbar, the counter and the\naction. `\"inline\"`: the attach button, the field, the counter and the action in one row, the toolbar (if any)\nin a row under it."
+    },
+    "toolbar": {
+      "type": "JSX.Element",
+      "required": false,
+      "description": "Slot under the field for chips and selectors (agent, model, mode, …). Drawn in every state. It is a plain `div`,\nnot `role=\"toolbar\"`: the content brings its own keyboard handling and disabled state."
+    },
+    "attachments": {
+      "type": "JSX.Element",
+      "required": false,
+      "description": "Slot above the field for the app's file chips. The composer keeps no file state: the app lists what `onAttach`\ngave it here."
+    },
+    "onAttach": {
+      "type": "((files: File[]) => void) | undefined",
+      "required": false,
+      "description": "Turns on the attach button, the hidden file input and the drop target (the whole composer). Called with the files\nof a pick or a drop that are left after `accept`, `multiple` and `maxFiles`, never with an empty list. Only a drag\nof files is taken: dragged text or a link still goes into the field."
+    },
+    "accept": {
+      "type": "Record<string, string[]> | string | undefined",
+      "required": false,
+      "description": "Accepted file types, as a record of mime type to extensions or a raw `accept` string (`image/*`, `.pdf`, an exact\nmime type). It sets the picker's filter, and the files of a pick or a drop that do not match are left out."
+    },
+    "multiple": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Allow several files per pick or drop. When `false` the picker takes one and a drop keeps the first. Defaults to `true`."
+    },
+    "maxFiles": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Files beyond this number are dropped from a pick or a drop (counted after `accept`)."
+    },
+    "dropTarget": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Whether `onAttach` also makes the composer a drop target for files. Set `false` when a parent already takes drops\n(a chat panel): the attach button and the picker stay, and a drop on the composer bubbles to the parent untouched.\nDefaults to `true`."
+    },
+    "disabled": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Disables the textarea, the attach button, the action button and the drop target. Toolbar content is the app's to\ndisable."
+    },
+    "readOnly": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "The textarea is `readonly`: sending is unavailable, Stop still works."
+    },
+    "autofocus": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Focus the textarea on mount."
+    },
+    "name": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Name of the textarea."
+    },
+    "id": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Id of the textarea (the root keeps no id). Generated when not given."
+    },
+    "aria-label": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the textarea. Set this or `aria-labelledby`: a placeholder is not a name."
+    },
+    "aria-labelledby": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Id(s) of the element(s) that name the textarea."
+    },
+    "aria-describedby": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Id(s) that describe the textarea. They come first, the counter's id is appended."
+    },
+    "onKeyDown": {
+      "type": "JSX.EventHandlerUnion<HTMLTextAreaElement, KeyboardEvent> | undefined",
+      "required": false,
+      "description": "Key handler of the textarea. It runs before the composer's own; if it calls `preventDefault()`, the composer does nothing for that key."
+    },
+    "onFocus": {
+      "type": "JSX.EventHandlerUnion<HTMLTextAreaElement, FocusEvent> | undefined",
+      "required": false,
+      "description": "Focus handler of the textarea."
+    },
+    "onBlur": {
+      "type": "JSX.EventHandlerUnion<HTMLTextAreaElement, FocusEvent> | undefined",
+      "required": false,
+      "description": "Blur handler of the textarea."
+    },
+    "inputRef": {
+      "type": "((el: HTMLTextAreaElement) => void) | undefined",
+      "required": false,
+      "description": "Ref of the textarea (the root takes the component's own `ref`)."
+    },
+    "sendLabel": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the action button while it sends. Defaults to \"Send\"."
+    },
+    "stopLabel": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the action button while `busy`. Defaults to \"Stop\"."
+    },
+    "attachLabel": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the attach button. Defaults to \"Attach file\"."
+    },
+    "class": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Class name(s) for the root `<div>`. `style`, `ref`, `data-*` attributes and every other HTML attribute or event\nhandler go to the root too; the root's drag handlers run after yours."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root `<div>`. Defaults to `composer`; the parts inside have their own (`composer-input`, `composer-action`, …)."
+    }
+  }
+}

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

@@ -60,6 +60,26 @@
       "required": false,
       "description": "Reverse Header Actions. Optional. Type: boolean."
     },
+    "closeAriaLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible name of the header close button (default \"Close sheet\")."
+    },
+    "expandAriaLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible name of the size toggle while the sheet is at its normal size (default \"Expand sheet\"). The toggle\ncycles normal, expanded, collapsed and back, and its name always says what the next press does; the\nname changing is how it exposes its state. It shows the `open_in_full` icon, and `close_fullscreen` while expanded."
+    },
+    "collapseAriaLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible name of the size toggle while the sheet is expanded (default \"Collapse sheet\")."
+    },
+    "restoreAriaLabel": {
+      "type": "string",
+      "required": false,
+      "description": "Accessible name of the size toggle while the sheet is collapsed to its header (default \"Restore sheet size\")."
+    },
     "size": {
       "type": "string",
       "required": false,

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

@@ -0,0 +1,118 @@
+{
+  "name": "TabGroups",
+  "description": "Tab groups in a split area: move tabs between groups by drag and drop or keyboard, split right or down, resize, close the last tab to close a group; the layout is a versioned JSON (layout/onLayoutChange).",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal",
+    "note": "Renders the groups, tab rows and selected panels on the server; drag and drop and resizing run in the browser."
+  },
+  "extends": [
+    "Omit<JSX.HTMLAttributes<HTMLDivElement>, \"children\" | \"onChange\" | \"id\">"
+  ],
+  "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/tabGroups/tabGroups.entry.less"
+    ],
+    "dependencies": [
+      "@smwb/ui-styles/less/components/icon/icon.entry.less",
+      "@smwb/ui-styles/less/components/kbd/kbd.entry.less",
+      "@smwb/ui-styles/less/components/menu/menu.entry.less",
+      "@smwb/ui-styles/less/components/ripple/ripple.entry.less",
+      "@smwb/ui-styles/less/components/tabs/tab/tab.entry.less",
+      "@smwb/ui-styles/less/components/tabs/tabs.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/tabGroups/tabGroups.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/kbd/kbd.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/menu/menu.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/tabs/tab/tab.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/tabs/tabs.entry.less\";"
+  },
+  "props": {
+    "layout": {
+      "type": "TabGroupsLayout | undefined",
+      "required": false,
+      "description": "The arrangement to draw: the split tree, every group's tabs and the selected one. Controlled\nwhile it is not `undefined` — the component then only reports changes through\n`onLayoutChange` and draws what the owner gives back."
+    },
+    "defaultLayout": {
+      "type": "TabGroupsLayout | undefined",
+      "required": false,
+      "description": "The arrangement to start from while uncontrolled: one empty group by default."
+    },
+    "onLayoutChange": {
+      "type": "((layout: TabGroupsLayout, change: TabGroupsChange) => void) | undefined",
+      "required": false,
+      "description": "Called with the layout after a change and with what happened, in both the controlled and the\nuncontrolled mode. A controlled owner that does not apply the change simply sees nothing move."
+    },
+    "getTab": {
+      "type": "(tabId: string) => TabGroupsTab | undefined",
+      "required": true,
+      "description": "What a tab shows, by its id; `undefined` draws the id as the label."
+    },
+    "renderPanel": {
+      "type": "(tabId: string) => JSX.Element",
+      "required": true,
+      "description": "The content of a tab's panel, by its id. It is called the first time the tab is selected and\nthe panel stays mounted from then on, hidden while another tab is shown and kept through a\nmove to another group: a form keeps what was typed, a terminal its scrollback. Its node stays\nwhere it is in the DOM, so an iframe in it does not reload either."
+    },
+    "onTabClose": {
+      "type": "((tabId: string, event: Event, reason: TabCloseReason) => boolean | void) | undefined",
+      "required": false,
+      "description": "Asked before a tab closes, with what asked for it (its close button, Delete or Backspace, a\nmiddle click, its `actions`). Return `false` to keep the tab."
+    },
+    "empty": {
+      "type": "JSX.Element",
+      "required": false,
+      "description": "Drawn, centred, when the only group has no tabs left."
+    },
+    "minGroupSize": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "The smallest a group can be resized to, in px of its split; 120 by default."
+    },
+    "keyboardStep": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "The arrow-key step of a separator, in percent of its split; 5 by default."
+    },
+    "groupActions": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Draw each group's actions button and menu; true by default."
+    },
+    "dense": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Compact tab rows, as `Tabs`' `dense`; false by default."
+    },
+    "labels": {
+      "type": "Partial<TabGroupsLabels> | undefined",
+      "required": false,
+      "description": "The texts of the component: its menus, labels and announcements. English by default."
+    },
+    "id": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Base of the generated ids and the id of the root element. Generated by default."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the root element; `tab-groups` unless given."
+    },
+    "class": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Class of the root element, added to the component's own."
+    },
+    "style": {
+      "type": "JSX.HTMLAttributes<HTMLDivElement>[\"style\"]",
+      "required": false,
+      "description": "Inline style of the root element; the component's `grid-template-*` win over it."
+    },
+    "ref": {
+      "type": "Ref<HTMLDivElement>",
+      "required": false,
+      "description": "The root element."
+    }
+  }
+}

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

@@ -56,11 +56,26 @@
       "required": false,
       "description": "Accessible title or tooltip text."
     },
+    "titleAs": {
+      "type": "\"div\" | \"h1\" | \"h2\" | \"h3\" | \"h4\" | \"h5\" | \"h6\"",
+      "required": false,
+      "description": "Tag the `title` is rendered in: a `div` (default) or a heading, `h1`–`h6`,\nfor the page's main heading. Only the tag changes — a heading is drawn with\nthe bar's own font size, weight and no margins, so it looks exactly like the\ndiv. The heading's text is the `title` itself, so pass a string or plain\nmarkup rather than a `Typography` heading."
+    },
     "midContentAlign": {
       "type": "\"middle\" | \"left\" | \"right\"",
       "required": false,
       "description": "Mid Content Align. Optional. Type: \"middle\" | \"left\" | \"right\"."
     },
+    "variant": {
+      "type": "\"default\" | \"window\"",
+      "required": false,
+      "description": "`window`: the bar is the title bar of a desktop app window (Electron, Tauri, an installed PWA with Window\nControls Overlay). The bar drags the window; buttons, links, fields and other controls in it stay clickable,\nand room is left for the OS window buttons (`windowControls`). In a plain browser tab it looks like `default`."
+    },
+    "windowControls": {
+      "type": "\"auto\" | \"left\" | \"right\" | \"none\"",
+      "required": false,
+      "description": "With `variant=\"window\"`: where the OS window buttons are, so the bar's content keeps clear of them.\n`auto` (default) takes the area from the shell's `env(titlebar-area-*)` (Window Controls Overlay, Electron\n`titleBarOverlay`) and reserves nothing without it; `left` is macOS (traffic lights, `titleBarStyle: \"hiddenInset\"`),\n`right` is Windows/Linux caption buttons drawn by the OS; `none` reserves nothing. The reserved width is\nthe `--smui-appBarWindowControlsWidth` custom property (64px on the left, 138px on the right by default)."
+    },
     "color": {
       "type": "AppBarColor",
       "required": false,

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

@@ -0,0 +1,166 @@
+{
+  "name": "CommandPalette",
+  "description": "Command Palette component from the navigation module.",
+  "ssr": {
+    "safe": true,
+    "rendering": "universal"
+  },
+  "styles": {
+    "base": [
+      "@smwb/ui-styles/less/foundation.less",
+      "@smwb/ui-styles/less/theme.less"
+    ],
+    "entries": [
+      "@smwb/ui-styles/less/components/commandPalette/commandPalette.entry.less"
+    ],
+    "dependencies": [
+      "@smwb/ui-styles/less/components/icon/icon.entry.less",
+      "@smwb/ui-styles/less/components/kbd/kbd.entry.less",
+      "@smwb/ui-styles/less/components/modal/modal.entry.less",
+      "@smwb/ui-styles/less/components/skeleton/skeleton.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/commandPalette/commandPalette.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/kbd/kbd.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/modal/modal.entry.less\";\n@import (less) \"node_modules/@smwb/ui-styles/less/components/skeleton/skeleton.entry.less\";"
+  },
+  "props": {
+    "open": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Whether the palette is open. Any value but `undefined` makes it controlled: the palette then\nshows this and only asks to change it through `onOpenChange`. While it is `undefined`, the\npalette keeps its own state, starting from `defaultOpen`."
+    },
+    "defaultOpen": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Open state to start from while uncontrolled; `false` by default."
+    },
+    "onOpenChange": {
+      "type": "((open: boolean) => void) | undefined",
+      "required": false,
+      "description": "Called for every request to open or close: Escape, a backdrop click, and choosing an item while\n`closeOnSelect`. Called in both the controlled and the uncontrolled mode."
+    },
+    "groups": {
+      "type": "CommandPaletteGroup[] | undefined",
+      "required": false,
+      "description": "The groups to search in, filtered locally by `filter`; empty by default."
+    },
+    "recent": {
+      "type": "CommandPaletteItem[] | undefined",
+      "required": false,
+      "description": "Recently used items, kept by the app (its local storage, its server, per user) and updated from\n`onSelect`. Shown as the first group while the query is empty, unfiltered, and hidden while\nthe user searches."
+    },
+    "recentLabel": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Heading of the recent group; `\"Recent\"` by default."
+    },
+    "query": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "The text in the search field. Any value but `undefined` makes it controlled: the field shows\nthis and only reports edits through `onQueryChange`."
+    },
+    "defaultQuery": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Text to start from while uncontrolled, and to reset to each time the palette opens; `\"\"`."
+    },
+    "onQueryChange": {
+      "type": "((query: string) => void) | undefined",
+      "required": false,
+      "description": "Called for every edit of the field, in both the controlled and the uncontrolled mode."
+    },
+    "filter": {
+      "type": "CommandPaletteFilter | false | undefined",
+      "required": false,
+      "description": "Decides which of `groups` an edit keeps; commandPaletteFilter by default. `false` shows\n`groups` as given, for an app that filters them itself or gets them filtered from a server.\nNever applied to `recent` or to the results of `source`."
+    },
+    "source": {
+      "type": "CommandPaletteSource | undefined",
+      "required": false,
+      "description": "Loads results for the trimmed query, after `debounce` ms of quiet typing. Its `signal` is\naborted when a newer query, a close or an unmount makes the answer useless, and an answer that\narrives for an older query is dropped. Appended after `groups`."
+    },
+    "debounce": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "Milliseconds of quiet typing before `source` is called; `200` by default."
+    },
+    "minQueryLength": {
+      "type": "number | undefined",
+      "required": false,
+      "description": "`source` is called only when the trimmed query has at least this many characters; `1` by\ndefault. `0` also loads for the empty query."
+    },
+    "loading": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "App-driven loading: shows the skeleton like a pending `source` does, for an app that loads\nitself with a controlled `query`; `false` by default."
+    },
+    "onSelect": {
+      "type": "((item: CommandPaletteItem, group: CommandPaletteGroup) => void) | undefined",
+      "required": false,
+      "description": "Called for every chosen item, after the item's own `onSelect`. The place for the app to move the\nitem to the top of its `recent` list."
+    },
+    "closeOnSelect": {
+      "type": "boolean | undefined",
+      "required": false,
+      "description": "Ask to close when an item is chosen; `true` by default."
+    },
+    "placeholder": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Placeholder of the field; `\"Type a command or search…\"` by default. It is not its name."
+    },
+    "searchLabel": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Accessible name of the field and, through `aria-labelledby`, of the listbox; `\"Search commands\"`."
+    },
+    "noResultsText": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Shown and announced when nothing matches; `\"No results\"` by default."
+    },
+    "errorText": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Shown and announced when `source` rejects; `\"Couldn't load results\"` by default."
+    },
+    "resultsAnnouncement": {
+      "type": "((count: number) => string) | undefined",
+      "required": false,
+      "description": "Text of the polite announcement after a search settles; `\"1 result\"` or `\"N results\"` by\ndefault. Not used for zero results, which announce `noResultsText`."
+    },
+    "footer": {
+      "type": "JSX.Element | undefined",
+      "required": false,
+      "description": "Slot under the results, for key hints built with `Kbd`. Drawn only when given:\n`<>Press <Kbd keys={[\"Enter\"]} /> to run</>`."
+    },
+    "class": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Added to the dialog element, after `smwb-command-palette`."
+    },
+    "aria-label": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Name of the dialog; `\"Command palette\"` by default. Not set when `aria-labelledby` is given."
+    },
+    "aria-labelledby": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Id of the element that names the dialog; replaces the default `aria-label`."
+    },
+    "aria-describedby": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Ids of the elements that describe the dialog."
+    },
+    "data-testid": {
+      "type": "string | undefined",
+      "required": false,
+      "description": "Test id of the dialog element; `\"command-palette\"` unless given."
+    },
+    "ref": {
+      "type": "Ref<HTMLDivElement> | undefined",
+      "required": false,
+      "description": "Ref of the dialog element."
+    }
+  }
+}

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

@@ -74,6 +74,11 @@
       "required": false,
       "description": "Accessible label for the built-in collapse toggle."
     },
+    "contained": {
+      "type": "boolean",
+      "required": false,
+      "description": "Place the rail inside its container instead of pinning it to the window.\nThe sidebar stays in the page flow (`position: relative`), keeps its\nvariant width as a non-shrinking flex item and scrolls a long menu inside\nitself, so sibling content flows beside it and reflows when it collapses.\nGive the container a definite height (e.g. a fixed-height flex row) to\nmake the rail fill it; with an auto-height container the rail sizes\nitself to the menu. Defaults to `false`: the sidebar stays viewport-fixed."
+    },
     "ref": {
       "type": "Ref<HTMLElement>",
       "required": false,