npm - @instruments/materia-ui - Versions diffs - 0.4.6 → 0.4.7 - Mend

@instruments/materia-ui 0.4.6 → 0.4.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (119) hide show

package/dist/data/docs-manifest.js CHANGED Viewed

@@ -19,6 +19,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"default" | "outline" | "solid" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Item styling, inherited by every item: `default` is ruled rows divided by bottom borders, `outline` bordered cards, `solid` filled cards. `outline` and `solid` space the items apart.",
                         },
                         {
                             name: "className",
@@ -127,6 +129,8 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `neutral` for information, `danger` for an error or a destructive warning.",
                         },
                     ],
                 },
@@ -319,6 +323,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"default" | "muted" | "plain" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Link treatment: `default` is a medium-weight underlined link, `muted` reads as body text until hovered, `plain` has no underline until hovered.",
                         },
                     ],
                 },
@@ -506,6 +512,7 @@ export const docsManifest = {
                             type: "AvatarSize | undefined",
                             required: false,
                             defaultValue: '"base"',
+                            description: "Avatar width and height, `2xs` (20px) to `6xl` (128px). Inside an `AvatarGroup`, the group's `size` wins.",
                         },
                         {
                             name: "radius",
@@ -574,6 +581,7 @@ export const docsManifest = {
                             type: '"bottom-right" | "top-right" | "bottom-left" | "top-left"',
                             required: false,
                             defaultValue: '"top-right"',
+                            description: "Which corner of the avatar the badge overlaps.",
                         },
                         {
                             name: "size",
@@ -610,6 +618,7 @@ export const docsManifest = {
                             type: "AvatarSize | undefined",
                             required: false,
                             defaultValue: '"base"',
+                            description: "Initials text size; set it to the same `size` as the parent `AvatarRoot`, as it does not inherit it. At `2xs` and `xs` only one initial shows.",
                         },
                         {
                             name: "name",
@@ -735,6 +744,7 @@ export const docsManifest = {
                             type: '"bottom-right" | "top-right" | "bottom-left" | "top-left"',
                             required: false,
                             defaultValue: '"bottom-right"',
+                            description: "Which corner of the avatar the dot sits in.",
                         },
                         {
                             name: "size",
@@ -746,6 +756,7 @@ export const docsManifest = {
                             name: "status",
                             type: "AvatarStatusType",
                             required: true,
+                            description: "Presence shown by the dot colour: `online` green, `away` and `busy` amber (the same colour), `dnd` red, `offline` muted grey.",
                         },
                         {
                             name: "withBorder",
@@ -800,6 +811,7 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Dims the badge to half opacity and stops it receiving pointer events.",
                         },
                         {
                             name: "focused",
@@ -817,12 +829,14 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Icon component (not an element) drawn beside the text, sized to match the badge. Replaced by a spinner while `loading`.",
                         },
                         {
                             name: "iconPlacement",
                             type: '"end" | "start"',
                             required: false,
                             defaultValue: '"start"',
+                            description: "Which side of the text `icon` sits on.",
                         },
                         {
                             name: "label",
@@ -846,6 +860,7 @@ export const docsManifest = {
                             name: "testid",
                             type: "string",
                             required: false,
+                            description: "Sets `data-testid` on the badge. Lower-case `testid`, unlike the `testId` prop on other components.",
                         },
                         {
                             name: "value",
@@ -877,16 +892,22 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `neutral` for plain labels, `brand` for the house yellow, `success` / `warning` / `info` / `danger` for status.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a capsule, `rounded` a soft rectangle, `square` has sharp corners. Overrides the size's own corner radius.",
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight: `solid` is a filled pill, `soft` a pale tint, `outline` a border, `ghost` text only, `transparent` frosted glass for use over images only.",
                         },
                         {
                             name: "asInput",
@@ -904,11 +925,14 @@ export const docsManifest = {
                             name: "icon",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Element shown when no `children` are given, an X icon unless replaced; an icon-only button needs an `aria-label`.",
                         },
                         {
                             name: "variant",
                             type: '"default" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Button style; `default` is the only one, so leave it unset.",
                         },
                     ],
                 },
@@ -1107,6 +1131,7 @@ export const docsManifest = {
                             name: "separator",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Not used by `Breadcrumb`: set the divider by passing children to each `BreadcrumbSeparator` instead.",
                         },
                     ],
                 },
@@ -1211,36 +1236,50 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
@@ -1328,6 +1367,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -1426,21 +1466,28 @@ export const docsManifest = {
                             name: "orientation",
                             type: '"horizontal" | "vertical" | null | undefined',
                             required: false,
+                            defaultValue: '"horizontal"',
+                            description: "Direction the children are laid out: `horizontal` in a row, `vertical` in a column.",
                         },
                         {
                             name: "variant",
                             type: '"segmented" | "joined" | null | undefined',
                             required: false,
+                            defaultValue: '"joined"',
+                            description: "Group style: `joined` lets each child draw its own border and merges the shared edges; `segmented` draws one bordered, shadowed container around the children.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Outer corners of the group: only the first and last child are rounded, the inner edges stay square. `segmented` rounds the container too.",
                         },
                         {
                             name: "dividers",
                             type: "boolean | null | undefined",
                             required: false,
+                            description: "Draw a line between children. Defaults on for the `segmented` variant and off for `joined`.",
                         },
                     ],
                 },
@@ -1518,6 +1565,8 @@ export const docsManifest = {
                             name: "border",
                             type: "BorderStyle",
                             required: false,
+                            defaultValue: '"none"',
+                            description: "Outline: `none` draws no border, `solid` a 1px border, `dashed` a faint dashed one for placeholder or drop areas.",
                         },
                         {
                             name: "inset",
@@ -1543,11 +1592,14 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "variant",
                             type: '"muted" | "ghost" | "accent" | "card" | null | undefined',
                             required: false,
+                            defaultValue: '"card"',
+                            description: "Surface: `card` is the standard card fill, `muted` and `accent` are tinted fills, `ghost` has no fill or shadow.",
                         },
                     ],
                 },
@@ -2199,6 +2251,7 @@ export const docsManifest = {
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
                             defaultValue: '"base"',
+                            description: "Padding, corner radius and icon size of every card in the group; items read it from context.",
                         },
                     ],
                 },
@@ -2297,21 +2350,25 @@ export const docsManifest = {
                             type: '"xs" | "sm"',
                             required: false,
                             defaultValue: '"xs"',
+                            description: "Checkbox size; only `xs` and `sm` are allowed.",
                         },
                         {
                             name: "checkboxClassName",
                             type: "string",
                             required: false,
+                            description: "Extra classes for the checkbox itself; `className` styles the outer field row.",
                         },
                         {
                             name: "labelClassName",
                             type: "string",
                             required: false,
+                            description: "Extra classes for the label text.",
                         },
                         {
                             name: "descriptionClassName",
                             type: "string",
                             required: false,
+                            description: "Extra classes for the description text; only applied when `description` is set.",
                         },
                     ],
                 },
@@ -2939,7 +2996,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -2964,6 +3021,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Size of every item, label and shortcut inside, which read it from context. Submenus inherit it.",
                         },
                         {
                             name: "itemRadius",
@@ -3009,16 +3068,20 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar.",
                         },
                         {
                             name: "tone",
                             type: '"neutral" | "danger"',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red highlight.",
                         },
                         {
                             name: "avatar",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom leading element, such as an `Avatar`. Takes precedence over `dot` and `icon`.",
                         },
                         {
                             name: "dot",
@@ -3030,21 +3093,25 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. Hidden when `avatar` or `dot` is set.",
                         },
                         {
                             name: "suffixIcon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Trailing icon, passed as a component. Replaces `kbd` when both are set.",
                         },
                         {
                             name: "kbd",
                             type: "string[]",
                             required: false,
+                            description: 'Keyboard shortcut keys shown as keycaps at the end, for example `["⌘", "C"]`. Ignored when `suffixIcon` is set.',
                         },
                         {
                             name: "suffix",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom trailing content, rendered after `suffixIcon` or `kbd`.",
                         },
                         {
                             name: "active",
@@ -3060,7 +3127,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row (e.g. with a link); glyph props render inside it, around `children`.",
                         },
@@ -3085,6 +3152,7 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so the label lines up with items that have a leading icon.",
                         },
                     ],
                 },
@@ -3109,7 +3177,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -3134,6 +3202,8 @@ export const docsManifest = {
                             name: "spacing",
                             type: '"default" | "compact"',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "`default` is a 1px rule with 4px margins. `compact` centres the same rule in a taller transparent band, leaving more room around it.",
                         },
                     ],
                 },
@@ -3160,6 +3230,7 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: "Item size for this submenu only. Omit to inherit the parent menu's `size`.",
                         },
                     ],
                 },
@@ -3174,7 +3245,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -3188,11 +3259,13 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading icon lines up with rows that have one.",
                         },
                         {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. The trailing chevron is added for you.",
                         },
                     ],
                 },
@@ -3690,6 +3763,8 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `success`, `warning`, `danger` and `info` for status, `brand` for the accent, `neutral` for a muted grey. Ignored when `color` is set.",
                         },
                     ],
                 },
@@ -3807,6 +3882,7 @@ export const docsManifest = {
                             name: "container",
                             type: "HTMLElement | null",
                             required: false,
+                            description: "Element the drawer and its scrim portal into, bounding them to that element instead of the page. Omit to portal to the document body.",
                         },
                     ],
                 },
@@ -3930,7 +4006,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -3955,6 +4031,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Size of every item, label and shortcut inside, which read it from context. Submenus inherit it.",
                         },
                         {
                             name: "itemRadius",
@@ -4000,16 +4078,20 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar.",
                         },
                         {
                             name: "tone",
                             type: '"neutral" | "danger"',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red highlight.",
                         },
                         {
                             name: "avatar",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom leading element, such as an `Avatar`. Takes precedence over `dot` and `icon`.",
                         },
                         {
                             name: "dot",
@@ -4021,21 +4103,25 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. Hidden when `avatar` or `dot` is set.",
                         },
                         {
                             name: "suffixIcon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Trailing icon, passed as a component. Replaces `kbd` when both are set.",
                         },
                         {
                             name: "kbd",
                             type: "string[]",
                             required: false,
+                            description: 'Keyboard shortcut keys shown as keycaps at the end, for example `["⌘", "C"]`. Ignored when `suffixIcon` is set.',
                         },
                         {
                             name: "suffix",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom trailing content, rendered after `suffixIcon` or `kbd`.",
                         },
                         {
                             name: "active",
@@ -4051,7 +4137,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row (e.g. with a link); glyph props render inside it, around `children`.",
                         },
@@ -4076,6 +4162,7 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so the label lines up with items that have a leading icon.",
                         },
                     ],
                 },
@@ -4100,7 +4187,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -4125,6 +4212,8 @@ export const docsManifest = {
                             name: "spacing",
                             type: '"default" | "compact"',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "`default` is a 1px rule with 4px margins. `compact` centres the same rule in a taller transparent band, leaving more room around it.",
                         },
                     ],
                 },
@@ -4151,6 +4240,7 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: "Item size for this submenu only. Omit to inherit the parent menu's `size`.",
                         },
                     ],
                 },
@@ -4165,7 +4255,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -4179,11 +4269,13 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading icon lines up with rows that have one.",
                         },
                         {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. The trailing chevron is added for you.",
                         },
                     ],
                 },
@@ -4359,6 +4451,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "sm" | "lg" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Scale of the whole empty state: the title, description and icon sizes, the gaps, and the vertical padding in the `card` layouts.",
                         },
                     ],
                 },
@@ -4505,6 +4599,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Square button edge and icon size, `2xs` (14px) to `3xl` (32px). Smaller than a `Button` of the same size, so it suits dense rows.",
                         },
                         {
                             name: "expanded",
@@ -4690,6 +4786,8 @@ export const docsManifest = {
                             name: "orientation",
                             type: '"horizontal" | "vertical" | "responsive" | null | undefined',
                             required: false,
+                            defaultValue: '"vertical"',
+                            description: "How label and control are arranged: `vertical` stacks them, `horizontal` puts them in a row, `responsive` stacks until the enclosing `FieldGroup` reaches its `md` container width, then switches to a row (needs a `FieldGroup` ancestor).",
                         },
                         {
                             name: "className",
@@ -4728,6 +4826,7 @@ export const docsManifest = {
                             name: "errors",
                             type: "({ message?: string; } | undefined)[]",
                             required: false,
+                            description: "Validation errors to show: one renders as plain text, several as a bulleted list. Duplicate messages collapse; ignored when `children` is set.",
                         },
                     ],
                 },
@@ -5589,21 +5688,29 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour of the icon and its tinted surface: `brand` for the accent, `danger`, `warning`, `success` and `info` for status, `neutral` for everything else.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` scales with `size`, `square` has sharp corners, `full` is a circle.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Box width and height, `2xs` (16px) to `3xl` (96px); the icon and corner radius scale with it.",
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Surface fill: `solid` is the tinted fill, `soft` the same except `neutral` takes the muted fill, `outline` a border with no fill, `ghost` neither. The icon keeps the tone's colour in every case.",
                         },
                     ],
                 },
@@ -5655,6 +5762,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -5775,16 +5883,21 @@ export const docsManifest = {
                             name: "label",
                             type: "string",
                             required: true,
+                            description: "Name of the identified object, shown in the label pill. The label appears only while `highlighted` or `active`.",
                         },
                         {
                             name: "labelAlign",
                             type: '"center" | "end" | "start"',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Which edge of the frame the label lines up with: `start` the left, `end` the right, `center` centred.",
                         },
                         {
                             name: "labelPlacement",
                             type: '"above" | "below"',
                             required: false,
+                            defaultValue: '"above"',
+                            description: "Whether the label sits above or below the frame.",
                         },
                         {
                             name: "persistentFrame",
@@ -5796,11 +5909,13 @@ export const docsManifest = {
                             name: "secondaryLabel",
                             type: "string | undefined",
                             required: false,
+                            description: "Smaller grey text after `label`, such as a code or category; truncated to a short width.",
                         },
                         {
                             name: "thumbnailUrl",
                             type: "string | null | undefined",
                             required: false,
+                            description: "Image URL for a small round thumbnail at the start of the label. Decorative, so it carries empty alt text.",
                         },
                     ],
                 },
@@ -5833,11 +5948,14 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` is the standard 8px radius, `square` has sharp corners, `full` is a pill.",
                         },
                         {
                             name: "size",
@@ -5945,16 +6063,19 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: true,
+                            description: "Icon component (not an element) to draw.",
                         },
                         {
                             name: "selected",
                             type: "boolean",
                             required: false,
+                            description: "Tints the icon with the primary colour instead of muted.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: true,
+                            description: "Size of the parent card, not of the icon: the icon renders smaller than the card (`xs` at `base`).",
                         },
                     ],
                 },
@@ -6073,12 +6194,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger"',
                             required: false,
-                            description: "Button tone.",
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.\nSemantic colour, as on Button.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.\nCorner shape; leave unset - the corners follow the InputGroup's `radius`, tighter inside the field.",
                         },
                         {
                             name: "dot",
@@ -6097,6 +6221,8 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.\nSquare by default, as an icon button sized from the InputGroup.",
                         },
                         {
                             name: "icon",
@@ -6108,27 +6234,35 @@ export const docsManifest = {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent"',
                             required: false,
-                            description: "Button emphasis.",
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button; ghost keeps the button quiet inside the field.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -6348,11 +6482,15 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Padding and gap between the item's parts, `2xs` (tightest) to `3xl` (roomiest).",
                         },
                         {
                             name: "variant",
                             type: '"default" | "outline" | "muted" | "card" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Surface: `default` is transparent, `outline` adds a border, `muted` a faint fill, `card` a bordered rounded card. Inside an `ItemGroup` the group's variant overrides most of this.",
                         },
                     ],
                 },
@@ -6396,6 +6534,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"divided" | "separated" | "grouped" | null | undefined',
                             required: false,
+                            defaultValue: '"divided"',
+                            description: "List style: `divided` is plain rows with lines between, `separated` makes each item its own card with a gap, `grouped` joins the items inside one bordered card.",
                         },
                     ],
                 },
@@ -6422,27 +6562,35 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Has no effect: the `icon` variant always renders a `neutral` icon box.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Has no effect: the `icon` variant always renders the default icon box corners.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Has no effect: the `icon` variant always renders a `sm` (32px) icon box.",
                         },
                         {
-                            name: "icon",
-                            type: 'import("../../tokens/icon-component").IconComponent',
+                            name: "emphasis",
+                            type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
                             required: false,
-                            description: "Icon component from lucide-react or any SVG React component.",
+                            defaultValue: '"solid"',
+                            description: "Has no effect: the `icon` variant always renders the default solid icon box.",
                         },
                         {
-                            name: "emphasis",
-                            type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
+                            name: "icon",
+                            type: 'import("../../tokens/icon-component").IconComponent',
                             required: false,
+                            description: "Icon component from lucide-react or any SVG React component.",
                         },
                         {
                             name: "iconSize",
@@ -6460,6 +6608,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"image" | "default" | "icon" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Media type: `icon` renders the `icon` prop in a small neutral `IconBox`, `image` crops its child `<img>` to a 40px square, `default` wraps any children as they are.",
                         },
                     ],
                 },
@@ -6561,11 +6711,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: 'Semantic colour: `neutral` for ordinary keys, `brand` to highlight one, `danger` for a destructive shortcut. `brand` and `danger` are only styled with `emphasis="solid"`.',
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Fill treatment: `solid` is a muted chip, `soft` a secondary-coloured fill, `outline` a bordered key on the page background, `ghost` bare text.",
                         },
                         {
                             name: "size",
@@ -6730,6 +6884,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -7016,26 +7171,36 @@ export const docsManifest = {
                             name: "variant",
                             type: '"input" | "default" | "outline" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Surface treatment: `default` tints on hover, `input` uses the input fill, `outline` adds a ring.",
                         },
                         {
                             name: "tone",
                             type: '"neutral" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red hover and active tint.",
                         },
                         {
                             name: "inset",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar. Switched on automatically when `indicator` is set.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill, `rounded` a soft rectangle, `square` has sharp corners.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Row height, padding and text size, on the shared component scale. Match the surrounding menu's `size`.",
                         },
                         {
                             name: "render",
@@ -7203,7 +7368,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -7228,6 +7393,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Size of every item, label and shortcut inside, which read it from context. Submenus inherit it.",
                         },
                         {
                             name: "itemRadius",
@@ -7273,16 +7440,20 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar.",
                         },
                         {
                             name: "tone",
                             type: '"neutral" | "danger"',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red highlight.",
                         },
                         {
                             name: "avatar",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom leading element, such as an `Avatar`. Takes precedence over `dot` and `icon`.",
                         },
                         {
                             name: "dot",
@@ -7294,21 +7465,25 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. Hidden when `avatar` or `dot` is set.",
                         },
                         {
                             name: "suffixIcon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Trailing icon, passed as a component. Replaces `kbd` when both are set.",
                         },
                         {
                             name: "kbd",
                             type: "string[]",
                             required: false,
+                            description: 'Keyboard shortcut keys shown as keycaps at the end, for example `["⌘", "C"]`. Ignored when `suffixIcon` is set.',
                         },
                         {
                             name: "suffix",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom trailing content, rendered after `suffixIcon` or `kbd`.",
                         },
                         {
                             name: "active",
@@ -7324,7 +7499,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row (e.g. with a link); glyph props render inside it, around `children`.",
                         },
@@ -7349,6 +7524,7 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so the label lines up with items that have a leading icon.",
                         },
                     ],
                 },
@@ -7378,7 +7554,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -7403,6 +7579,8 @@ export const docsManifest = {
                             name: "spacing",
                             type: '"default" | "compact"',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "`default` is a 1px rule with 4px margins. `compact` centres the same rule in a taller transparent band, leaving more room around it.",
                         },
                     ],
                 },
@@ -7429,6 +7607,7 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: "Item size for this submenu only. Omit to inherit the parent menu's `size`.",
                         },
                     ],
                 },
@@ -7443,7 +7622,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -7457,11 +7636,13 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading icon lines up with rows that have one.",
                         },
                         {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. The trailing chevron is added for you.",
                         },
                     ],
                 },
@@ -8142,11 +8323,15 @@ export const docsManifest = {
                             name: "radius",
                             type: '"rounded" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` for a soft rectangle, `full` for a capsule.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"xl"',
+                            description: "Control height and text size, matching Button and Input at the same size. Also sizes the country selector.",
                         },
                         {
                             name: "value",
@@ -8194,6 +8379,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -8234,6 +8420,7 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Dims the pill and blocks pointer events. Styling only: no `disabled` attribute reaches the element.",
                         },
                         {
                             name: "render",
@@ -8258,16 +8445,22 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `neutral` for plain labels, `brand` for the house yellow, `success` / `warning` / `info` / `danger` for status.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a capsule, `rounded` a soft rectangle, `square` has sharp corners. Overrides the size's own corner radius.",
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight: `solid` is a filled pill, `soft` a pale tint, `outline` a border, `ghost` text only, `transparent` frosted glass for use over images only.",
                         },
                         {
                             name: "asInput",
@@ -8442,11 +8635,14 @@ export const docsManifest = {
                             name: "positionerClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the positioning layer around the content, such as a lower `z-*` for a panel that sits beneath fixed chrome. Defaults to `z-50`.",
                         },
                         {
                             name: "size",
                             type: "PopoverSize",
                             required: false,
+                            defaultValue: '"lg"',
+                            description: "Padding and corner radius: `sm` is compact (8px), `base` is 16px, `lg` is roomy (24px).",
                         },
                     ],
                 },
@@ -8513,6 +8709,7 @@ export const docsManifest = {
                             name: "indicatorClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the filled arc, for example a stroke colour such as `stroke-brand`. Defaults to `stroke-primary`.",
                         },
                         {
                             name: "label",
@@ -8545,6 +8742,7 @@ export const docsManifest = {
                             name: "trackClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the unfilled ring behind the arc, for example a stroke colour such as `stroke-border`. Defaults to `stroke-muted`.",
                         },
                         {
                             name: "value",
@@ -9302,6 +9500,7 @@ export const docsManifest = {
                             type: "ScrollFrameFadeMode | undefined",
                             required: false,
                             defaultValue: '"color"',
+                            description: "How the fades are drawn: `color` blends a gradient of `fadeTheme` into a solid surface, `mask` fades the content itself to transparent, for use over images or blurs.",
                         },
                         {
                             name: "fades",
@@ -9336,6 +9535,7 @@ export const docsManifest = {
                             type: "Orientation | undefined",
                             required: false,
                             defaultValue: '"vertical"',
+                            description: "Scroll axis: `vertical` scrolls up and down, `horizontal` left and right, as for a row of chips.",
                         },
                         {
                             name: "viewportClassName",
@@ -9571,12 +9771,14 @@ export const docsManifest = {
                             type: 'ResponsiveValue<"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl">',
                             required: false,
                             defaultValue: '"sm"',
+                            description: 'Size of every segment (text and padding), or an object per breakpoint like `{ base: "sm", md: "lg" }`.',
                         },
                         {
                             name: "fullWidth",
                             type: "boolean",
                             required: false,
                             defaultValue: "false",
+                            description: "Stretches the control to its container's width, with the segments sharing the space equally; otherwise it hugs its content.",
                         },
                     ],
                 },
@@ -9674,6 +9876,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9695,11 +9898,14 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Size of every SelectItem, label and group inside, which read it from context. Match the trigger's `size`.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9711,6 +9917,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9727,6 +9934,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9743,6 +9951,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9759,6 +9968,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9770,21 +9980,29 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.\nSemantic colour of the trigger, as on Button.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.\nCorner shape, as on Button.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button; the outline reads as a form field.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.\nShrink while held down, as on Button, but off by default here.",
                         },
                         {
                             name: "className",
@@ -9802,6 +10020,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9813,6 +10032,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -10272,11 +10492,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "dot",
@@ -10295,26 +10519,35 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -10465,6 +10698,8 @@ export const docsManifest = {
                             name: "variant",
                             type: "SidepanelHeaderVariant",
                             required: false,
+                            defaultValue: '"default"',
+                            description: "`default` is a stacked title and description with a bottom border. `bar` is a transparent toolbar pinned over the top of the panel, for two `SidepanelControls` groups.",
                         },
                     ],
                 },
@@ -11438,6 +11673,7 @@ export const docsManifest = {
                             name: "href",
                             type: "string",
                             required: false,
+                            description: "Destination of the default `<a>`. Not used when `render` supplies its own element.",
                         },
                         {
                             name: "icon",
@@ -11695,6 +11931,7 @@ export const docsManifest = {
                             name: "radius",
                             type: "string",
                             required: true,
+                            description: "Tailwind rounding class (such as `rounded-xl`) matching the framed container's corners, so the ring follows them.",
                         },
                     ],
                 },
@@ -12018,6 +12255,7 @@ export const docsManifest = {
                             name: "href",
                             type: "string",
                             required: true,
+                            description: "Destination of the link. Also forwarded to the element given in `render`, such as a router `Link`.",
                         },
                         {
                             name: "icon",
@@ -12036,11 +12274,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                     ],
                 },
@@ -12052,11 +12292,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                     ],
                 },
@@ -12230,11 +12472,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                     ],
                 },
@@ -12256,6 +12500,8 @@ export const docsManifest = {
                             name: "layout",
                             type: 'boolean | "position" | "size" | "preserve-aspect"',
                             required: false,
+                            defaultValue: "true",
+                            description: 'Motion `layout` value for the height animation when the active tab\'s content changes size: `false` switches it off, `"size"` or `"position"` animates only that, `"preserve-aspect"` keeps the aspect ratio.',
                         },
                     ],
                 },
@@ -12267,11 +12513,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                         {
                             name: "className",
@@ -12418,16 +12666,22 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `neutral` for plain labels, `brand` for the house yellow, `success` / `warning` / `info` / `danger` for status.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a capsule, `rounded` a soft rectangle, `square` has sharp corners. Overrides the size's own corner radius.",
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight: `solid` is a filled pill, `soft` a pale tint, `outline` a border, `ghost` text only, `transparent` frosted glass for use over images only.",
                         },
                         {
                             name: "asInput",
@@ -12579,6 +12833,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -12694,11 +12949,13 @@ export const docsManifest = {
                             name: "current",
                             type: "number",
                             required: true,
+                            description: "Number shown before the slash, counted from one (the first step is `1`).",
                         },
                         {
                             name: "total",
                             type: "number",
                             required: true,
+                            description: "Number shown after the slash.",
                         },
                     ],
                 },
@@ -12710,11 +12967,13 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | undefined",
                             required: true,
+                            description: "Icon to show. Renders nothing when `undefined`.",
                         },
                         {
                             name: "stepId",
                             type: "string",
                             required: true,
+                            description: "Id of the current step. A new id makes the previous icon crossfade into this one.",
                         },
                     ],
                 },
@@ -12753,6 +13012,8 @@ export const docsManifest = {
                             name: "shimmer",
                             type: "boolean",
                             required: false,
+                            defaultValue: "true",
+                            description: "Sweeps a highlight across the label; `false` renders it as plain text.",
                         },
                         {
                             name: "shimmerVariant",
@@ -12764,6 +13025,7 @@ export const docsManifest = {
                             name: "step",
                             type: "ThinkingStep",
                             required: true,
+                            description: "The step to show: its `label` is the text, and its `icon` leads it unless `hideIcon` is set.",
                         },
                     ],
                 },
@@ -13069,11 +13331,15 @@ export const docsManifest = {
                             name: "variant",
                             type: '"default" | "secondary" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "How a pressed toggle shows it is on: `default` greys the fill and border, `secondary` darkens the border only. Inside a `ToggleGroup` the group's value wins.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` for soft corners, `full` for a pill. There is no sharp option. Inside a `ToggleGroup` the group's value wins.",
                         },
                         {
                             name: "icon",
@@ -13418,11 +13684,13 @@ export const docsManifest = {
                             name: "onAction",
                             type: "() => void",
                             required: false,
+                            description: "Called when the action button is clicked. The button only appears when `actionLabel` is set.",
                         },
                         {
                             name: "onDismiss",
                             type: "() => void",
                             required: false,
+                            description: "Called when the dismiss button is clicked. The parent should then set `open` to `false`.",
                         },
                         {
                             name: "dismissLabel",
@@ -13477,11 +13745,14 @@ export const docsManifest = {
                             name: "onClick",
                             type: "() => void",
                             required: false,
+                            description: "Called when the pill is pressed. The parent decides what the press does in each `state`, such as starting or stopping capture.",
                         },
                         {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            defaultValue: "false",
+                            description: "Block presses and dim the pill.",
                         },
                         {
                             name: "label",
@@ -13551,6 +13822,7 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Icon component (e.g. a Lucide icon), not a rendered element; shown small and muted at the top right.",
                         },
                         {
                             name: "valueLabel",
@@ -13678,31 +13950,37 @@ export const docsManifest = {
                             name: "getItemKey",
                             type: "(item: T) => string",
                             required: true,
+                            description: "Stable unique key for an item, such as its id; never the array index.",
                         },
                         {
                             name: "getRowKey",
                             type: "(row: T[], rowIndex: number) => string",
                             required: false,
+                            description: "Stable key for a row. Defaults to `row-<rowIndex>`; supply one when rows can reorder or be re-chunked.",
                         },
                         {
                             name: "metrics",
                             type: 'Omit<CardGridRowMetrics, "rowWidth">',
                             required: true,
+                            description: "Pixel `cardWidth` and `gap` the rows were chunked with (e.g. from\n`calculateColumns`). They only size `renderAfterRow`'s `rowWidth`; they do\nnot lay the cards out.",
                         },
                         {
                             name: "renderAfterRow",
                             type: "(props: { metrics: CardGridRowMetrics; row: T[]; rowIndex: number; }) => ReactNode",
                             required: false,
+                            description: "Content rendered beneath a row, such as an expanded detail panel. Receives\n`metrics` with `rowWidth`, the row's pixel width, so the panel can align to it.",
                         },
                         {
                             name: "renderItem",
                             type: "(props: { index: number; item: T; row: T[]; rowIndex: number; }) => ReactNode",
                             required: true,
+                            description: "Renders one item's card; each result is wrapped in a `CardGridItem`. `index` is the position within its row.",
                         },
                         {
                             name: "rows",
                             type: "T[][]",
                             required: true,
+                            description: "Items already chunked into rows, e.g. with `chunkIntoRows`; one `CardGrid` is rendered per row.",
                         },
                     ],
                 },
@@ -14048,11 +14326,13 @@ export const docsManifest = {
                             name: "loading",
                             type: "boolean",
                             required: false,
+                            description: "Set while the application fetches rows. The body shows placeholder rows or\na spinner per `loadingMode`, and the select-all checkbox and\n`DataGridColumnHeader` buttons are disabled.",
                         },
                         {
                             name: "loadingMessage",
                             type: "ReactNode",
                             required: false,
+                            description: 'Text beside the spinner while loading; only shown when `loadingMode` is `"spinner"`. Defaults to "Loading...".',
                         },
                         {
                             name: "loadingMode",
@@ -14128,6 +14408,8 @@ export const docsManifest = {
                             name: "size",
                             type: "DataGridControlSize",
                             required: false,
+                            defaultValue: '"xs"',
+                            description: "Checkbox size; the grid only uses the two compact steps.",
                         },
                     ],
                 },
@@ -14167,6 +14449,7 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The TanStack row to expand or collapse. The toggle renders nothing unless `row.getCanExpand()` is true.",
                         },
                     ],
                 },
@@ -14188,6 +14471,7 @@ export const docsManifest = {
                             name: "column",
                             type: "Column<TData, TValue>",
                             required: true,
+                            description: "The TanStack column this header sorts and filters.",
                         },
                         {
                             name: "options",
@@ -14244,11 +14528,13 @@ export const docsManifest = {
                             name: "loading",
                             type: "boolean",
                             required: false,
+                            description: "Set while the application fetches rows. The body shows placeholder rows or\na spinner per `loadingMode`, and the select-all checkbox and\n`DataGridColumnHeader` buttons are disabled.",
                         },
                         {
                             name: "loadingMessage",
                             type: "ReactNode",
                             required: false,
+                            description: 'Text beside the spinner while loading; only shown when `loadingMode` is `"spinner"`. Defaults to "Loading...".',
                         },
                         {
                             name: "loadingMode",
@@ -14310,11 +14596,13 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Disable the checkbox; `createSelectionColumn` sets it when the row cannot be selected.",
                         },
                         {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The TanStack row this checkbox selects.",
                         },
                     ],
                 },
@@ -14326,11 +14614,13 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Disable the checkbox, e.g. while loading or when the page has no rows.",
                         },
                         {
                             name: "table",
                             type: "Table<TData>",
                             required: true,
+                            description: "The TanStack table whose current-page rows this checkbox selects.",
                         },
                     ],
                 },
@@ -14552,11 +14842,13 @@ export const docsManifest = {
                             name: "icon",
                             type: "ReactNode",
                             required: false,
+                            description: "Leading glyph shown before the title.",
                         },
                         {
                             name: "pinnable",
                             type: "boolean",
                             required: false,
+                            description: "Not read by the header. Pinning is controlled by `tableLayout.columnsPinnable`\non `DataGrid` and the column's own `enablePinning`.",
                         },
                         {
                             name: "title",
@@ -14771,21 +15063,25 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: 'The TanStack row to render; its selection state sets `data-state="selected"` and its original data goes to `onRowClick`.',
                         },
                         {
                             name: "dndRef",
                             type: "React.Ref<HTMLTableRowElement>",
                             required: false,
+                            description: "Ref attached to the `<tr>`; the virtualiser passes its row-measuring ref here, a drag library can pass its node ref.",
                         },
                         {
                             name: "dndStyle",
                             type: "React.CSSProperties",
                             required: false,
+                            description: "Inline style merged over the row height, e.g. a drag library's transform.",
                         },
                         {
                             name: "dataIndex",
                             type: "number",
                             required: false,
+                            description: "Row position in the full row model, written to `data-index` so the virtualiser can find the row when measuring.",
                         },
                     ],
                 },
@@ -14802,16 +15098,19 @@ export const docsManifest = {
                             name: "cell",
                             type: "Cell<TData>",
                             required: true,
+                            description: "The TanStack cell to render; its column sets pinning, edge and `meta.cellClassName` styling.",
                         },
                         {
                             name: "dndRef",
                             type: "React.Ref<HTMLTableCellElement>",
                             required: false,
+                            description: "Ref attached to the `<td>`, for a drag library's node ref.",
                         },
                         {
                             name: "dndStyle",
                             type: "React.CSSProperties",
                             required: false,
+                            description: "Inline style merged over the pinning styles, e.g. a drag library's transform.",
                         },
                     ],
                 },
@@ -14823,6 +15122,7 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The expanded row; its `original` data is passed to the first column's `meta.expandedContent`.",
                         },
                     ],
                 },
@@ -14850,6 +15150,7 @@ export const docsManifest = {
                             name: "column",
                             type: "Column<TData>",
                             required: true,
+                            description: "The column this placeholder cell sits in; supplies pinning, edge and `meta.cellClassName` styling.",
                         },
                     ],
                 },
@@ -14882,6 +15183,7 @@ export const docsManifest = {
                             name: "headerGroup",
                             type: "HeaderGroup<TData>",
                             required: true,
+                            description: "The TanStack header group this row renders; it supplies the row's React key.",
                         },
                     ],
                 },
@@ -14898,16 +15200,19 @@ export const docsManifest = {
                             name: "header",
                             type: "Header<TData>",
                             required: true,
+                            description: "The TanStack header this `<th>` renders; its column sets size, pinning and `meta.headerClassName`.",
                         },
                         {
                             name: "dndRef",
                             type: "React.Ref<HTMLTableCellElement>",
                             required: false,
+                            description: "Ref attached to the `<th>`, for a drag library's node ref.",
                         },
                         {
                             name: "dndStyle",
                             type: "React.CSSProperties",
                             required: false,
+                            description: "Inline style merged over width and pinning styles, e.g. a drag library's transform.",
                         },
                     ],
                 },
@@ -14919,6 +15224,7 @@ export const docsManifest = {
                             name: "header",
                             type: "Header<TData>",
                             required: true,
+                            description: "The header whose column this handle resizes.",
                         },
                     ],
                 },
@@ -14935,11 +15241,13 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The TanStack row this checkbox selects.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: 'Mirrors the table\'s size: `"2xs"` and `"xs"` (or omitted) give the `"xs"` checkbox, anything larger the `"sm"` one.',
                         },
                     ],
                 },
@@ -14951,6 +15259,7 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: 'Mirrors the table\'s size: `"2xs"` and `"xs"` (or omitted) give the `"xs"` checkbox, anything larger the `"sm"` one.',
                         },
                     ],
                 },
@@ -15101,6 +15410,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"divided" | "separated" | "grouped" | null | undefined',
                             required: false,
+                            defaultValue: '"grouped"',
+                            description: 'Container treatment: `"grouped"` is one bordered, rounded card with the rows inside, `"divided"` separates rows with hairlines and no frame, `"separated"` leaves a gap between rows so each can carry its own surface.',
                         },
                     ],
                 },
@@ -15151,6 +15462,7 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: true,
+                            description: "Icon component (a Lucide icon), not a rendered element; sized from the list's `size`.",
                         },
                     ],
                 },
@@ -15312,11 +15624,13 @@ export const docsManifest = {
                             name: "subtitle",
                             type: "string",
                             required: false,
+                            description: "Small muted line above the title, such as a category or date. Omitted when empty.",
                         },
                         {
                             name: "title",
                             type: "string",
                             required: true,
+                            description: "Main line, shown larger and medium weight.",
                         },
                     ],
                 },
@@ -15533,6 +15847,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "sm" | "lg" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Scale of the whole empty state: the title, description and icon sizes, the gaps, and the vertical padding in the `card` layouts.",
                         },
                     ],
                 },
@@ -15627,6 +15943,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "sm" | "lg" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Scale of the whole empty state: the title, description and icon sizes, the gaps, and the vertical padding in the `card` layouts.",
                         },
                     ],
                 },
@@ -15722,16 +16040,19 @@ export const docsManifest = {
                             name: "onDragLeave",
                             type: "(e: DragEvent<HTMLElement>) => void",
                             required: false,
+                            description: "Fires when a drag leaves the zone; pass `handleDragLeave` to clear the drag state.",
                         },
                         {
                             name: "onDragOver",
                             type: "(e: DragEvent<HTMLElement>) => void",
                             required: false,
+                            description: "Fires continuously while a drag is over the zone; pass `handleDragOver`, which cancels the default so the zone accepts a drop.",
                         },
                         {
                             name: "onDrop",
                             type: "(e: DragEvent<HTMLElement>) => void",
                             required: false,
+                            description: "Fires when files are dropped; pass `handleDrop` to validate and add them.",
                         },
                         {
                             name: "ref",
@@ -15921,11 +16242,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -15951,6 +16276,8 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "icon",
@@ -15962,26 +16289,35 @@ export const docsManifest = {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -16134,6 +16470,7 @@ export const docsManifest = {
                             name: "selected",
                             type: "boolean",
                             required: false,
+                            description: 'Marks the folder as chosen: selected styling and `aria-pressed="true"`. Has no effect while `showSelectedState` is false.',
                         },
                         {
                             name: "showSelectedState",
@@ -16151,6 +16488,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid` on the outer wrapper (not the button), for Playwright targeting.",
                         },
                     ],
                 },
@@ -16271,6 +16609,7 @@ export const docsManifest = {
                             name: "positionerClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the positioning layer around the content, such as a lower `z-*` for a panel that sits beneath fixed chrome. Defaults to `z-50`.",
                         },
                     ],
                 },
@@ -16517,11 +16856,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -16547,31 +16890,42 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -16741,6 +17095,7 @@ export const docsManifest = {
                             name: "displayName",
                             type: "string",
                             required: true,
+                            description: "The user's name, shown in medium weight; also the avatar image's alt text.",
                         },
                         {
                             name: "email",
@@ -16934,36 +17289,50 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
@@ -17051,6 +17420,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -17129,6 +17499,7 @@ export const docsManifest = {
                             name: "onClose",
                             type: "() => void",
                             required: true,
+                            description: "Called when the close button is pressed; set your open state to false here.",
                         },
                     ],
                 },
@@ -17140,36 +17511,50 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
@@ -17257,6 +17642,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -17315,11 +17701,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -17339,31 +17729,42 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "expandable",
@@ -17508,11 +17909,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -17531,6 +17936,8 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "icon",
@@ -17542,26 +17949,35 @@ export const docsManifest = {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -17640,6 +18056,7 @@ export const docsManifest = {
                             name: "label",
                             type: "React.ReactNode",
                             required: true,
+                            description: "Project name; truncates to one line.",
                         },
                         {
                             name: "onAction",
@@ -17651,6 +18068,7 @@ export const docsManifest = {
                             name: "actionIcon",
                             type: 'import("../../tokens/icon-component").IconComponent',
                             required: true,
+                            description: "Icon for the trailing action button, such as an ellipsis for project options.",
                         },
                         {
                             name: "actionLabel",
@@ -17684,6 +18102,7 @@ export const docsManifest = {
                             name: "onClose",
                             type: "() => void",
                             required: false,
+                            description: "Called when Escape is pressed. The overlay never unmounts itself, so set your open state to false here.",
                         },
                     ],
                 },
@@ -18126,6 +18545,7 @@ export const docsManifest = {
                             type: "string",
                             required: false,
                             defaultValue: '"Clear all"',
+                            description: "Text of the button that calls `onClear`.",
                         },
                         {
                             name: "separator",
@@ -18228,6 +18648,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"default" | "secondary" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "How a pressed toggle shows it is on: `default` greys the fill and border, `secondary` darkens the border only. Inside a `ToggleGroup` the group's value wins.",
                         },
                         {
                             name: "size",
@@ -18348,6 +18770,8 @@ export const docsManifest = {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -18373,26 +18797,35 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -18482,16 +18915,19 @@ export const docsManifest = {
                             name: "onDirectionChange",
                             type: "(direction: PageToolbarSortDirection) => void",
                             required: false,
+                            description: 'Called with `"asc"` or `"desc"` when the user picks a direction. The Ascending and Descending choices only appear when both this and `direction` are set.',
                         },
                         {
                             name: "onValueChange",
                             type: "(value: string) => void",
                             required: true,
+                            description: "Called with the chosen option's `value` when the user picks an order.",
                         },
                         {
                             name: "options",
                             type: "readonly PageToolbarSortOption[]",
                             required: true,
+                            description: "The orders to offer, each a `value` and a `label`; the label of the current one shows on the button.",
                         },
                         {
                             name: "value",
@@ -18728,6 +19164,7 @@ export const docsManifest = {
                             name: "product",
                             type: "ProductCardProduct",
                             required: true,
+                            description: 'The material to show. In `"group"` mode its `variants` become the colourway\nswatches (the card falls back to the product itself when there are none),\nand `images[0]` of the selected variant is the photograph. A product whose\nselected variant has no images renders a "no photography" placeholder.',
                         },
                         {
                             name: "productUrl",
@@ -18769,13 +19206,13 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
-                            description: "Override image URL - used for visual search to show the matched image",
+                            description: 'Image URL shown in place of the product\'s own first image, e.g. the\nmatched crop in a visual search. Honoured in `"single"` and `"swatch"`\nmodes only.',
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
-                            description: 'Prioritise loading images (sets loading="eager" and adds preload link)',
+                            description: 'Load the main image eagerly (`loading="eager"`, high fetch priority in the\ndefault renderer, and forwarded to `renderImage`). Set it on above-the-fold\ncards, not the whole grid.',
                         },
                         {
                             name: "productBrandLines",
@@ -18787,21 +19224,29 @@ export const docsManifest = {
                             name: "productNameLines",
                             type: "1 | 2 | undefined",
                             required: false,
+                            defaultValue: "1",
+                            description: "How many lines the product name may take before it clamps. Choose `2`\nwhere names differ only at the end; rows stay level because the clamp is\na maximum, not a reserved height.",
                         },
                         {
                             name: "showAddToCart",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the cart control. It only ever appears when `renderAddToCart` is also\nsupplied, and `primaryAction` can replace it with another action.",
                         },
                         {
                             name: "showProductBrand",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the brand name above the product name. Cards without a brand name\nomit the line either way.",
                         },
                         {
                             name: "showProductName",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the product name.",
                         },
                         {
                             name: "showSwatches",
@@ -18814,6 +19259,7 @@ export const docsManifest = {
                             name: "similarityScore",
                             type: "number | undefined",
                             required: false,
+                            description: 'Visual-search match from `0` to `1` (not a percentage), shown as a\nrounded percentage pill over the image: `0.87` reads `87%`. Only\n`"single"` and `"inspiration"` modes show it; omit it for no pill.',
                         },
                     ],
                 },
@@ -18995,13 +19441,13 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
-                            description: "Override image URL - used for visual search to show the matched image",
+                            description: 'Image URL shown in place of the product\'s own first image, e.g. the\nmatched crop in a visual search. Honoured in `"single"` and `"swatch"`\nmodes only.',
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
-                            description: 'Prioritise loading images (sets loading="eager" and adds preload link)',
+                            description: 'Load the main image eagerly (`loading="eager"`, high fetch priority in the\ndefault renderer, and forwarded to `renderImage`). Set it on above-the-fold\ncards, not the whole grid.',
                         },
                         {
                             name: "productBrandLines",
@@ -19013,31 +19459,41 @@ export const docsManifest = {
                             name: "productNameLines",
                             type: "1 | 2 | undefined",
                             required: false,
+                            defaultValue: "1",
+                            description: "How many lines the product name may take before it clamps. Choose `2`\nwhere names differ only at the end; rows stay level because the clamp is\na maximum, not a reserved height.",
                         },
                         {
                             name: "showAddToCart",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the cart control. It only ever appears when `renderAddToCart` is also\nsupplied, and `primaryAction` can replace it with another action.",
                         },
                         {
                             name: "showProductBrand",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the brand name above the product name. Cards without a brand name\nomit the line either way.",
                         },
                         {
                             name: "showProductName",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the product name.",
                         },
                         {
                             name: "similarityScore",
                             type: "number | undefined",
                             required: false,
+                            description: 'Visual-search match from `0` to `1` (not a percentage), shown as a\nrounded percentage pill over the image: `0.87` reads `87%`. Only\n`"single"` and `"inspiration"` modes show it; omit it for no pill.',
                         },
                         {
                             name: "onAddToCartSuccess",
                             type: "(() => void) | undefined",
                             required: false,
+                            description: "Called when the `renderAddToCart` slot reports a successful add, via the `onAdded` it receives.",
                         },
                     ],
                 },
@@ -19101,23 +19557,26 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
-                            description: "Override image URL - used for visual search to show the matched image",
+                            description: "Image URL shown in place of the variant's first image, e.g. the matched crop in a visual search.",
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
-                            description: 'Prioritise loading this image (sets loading="eager" and adds preload link)',
+                            description: 'Load this image eagerly (`loading="eager"`, high fetch priority in the default renderer); forwarded to `renderImage`.',
                         },
                         {
                             name: "showSimilarityScore",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: 'Show the `similarityScore` pill. Needs `similarityScore` too, and is\nignored outside `"single"` and `"inspiration"` modes.',
                         },
                         {
                             name: "similarityScore",
                             type: "number | undefined",
                             required: false,
+                            description: "Match from `0` to `1`, shown as a rounded percentage (`0.87` reads `87%`).",
                         },
                     ],
                 },
@@ -19243,6 +19702,7 @@ export const docsManifest = {
                             name: "display",
                             type: "ProductCardDisplayOptions | undefined",
                             required: false,
+                            description: "Which parts of the card show: brand, name, line clamps, swatches, add to\ncart. `ProductCard` takes the same switches as flat props (`showProductBrand`\nand so on) and builds this for you; pass `display` only when using\n`ProductCardProvider` directly. Each key falls back to its own default.",
                         },
                         {
                             name: "dragAdapter",
@@ -19365,6 +19825,7 @@ export const docsManifest = {
                             name: "product",
                             type: "ProductCardProduct",
                             required: true,
+                            description: 'The material to show. In `"group"` mode its `variants` become the colourway\nswatches (the card falls back to the product itself when there are none),\nand `images[0]` of the selected variant is the photograph. A product whose\nselected variant has no images renders a "no photography" placeholder.',
                         },
                         {
                             name: "productUrl",
@@ -19556,11 +20017,13 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
+                            description: "Image URL shown in place of the variant's first image.",
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
+                            description: "Load the tile's image eagerly; forwarded to `renderImage`.",
                         },
                     ],
                 },
@@ -19641,6 +20104,8 @@ export const docsManifest = {
                             name: "active",
                             type: "boolean",
                             required: false,
+                            defaultValue: "true",
+                            description: "Whether the `renderTools` buttons are mounted. `ProductCard` sets it while\nthe pointer or keyboard focus is inside the card, so a large grid does not\nrender every hidden action.",
                         },
                         {
                             name: "className",
@@ -19721,11 +20186,13 @@ export const docsManifest = {
                             name: "filters",
                             type: "Record<string, string | null>",
                             required: true,
+                            description: 'The current selection, keyed by filter key (`"color"` for `colorName`, otherwise the\ndimension name such as `"finish"`) to the selected option\'s `value`, or `null` for none.',
                         },
                         {
                             name: "onFilterChange",
                             type: "(key: string, value: string | null) => void",
                             required: true,
+                            description: "Called when an option is picked, with the filter key and the option's `value`;\npicking the selected option again sends `null` to clear it. When `onSiblingSelect` and\n`siblingsWithAttributes` find a matching sibling, that fires instead.",
                         },
                         {
                             name: "onSiblingSelect",
@@ -19761,6 +20228,7 @@ export const docsManifest = {
                             name: "variantOptions",
                             type: 'Partial<Record<"pattern" | "length" | "width" | "size" | "colorName" | "finish" | "substrate" | "finishType", import("./product-specifications-types").VariantOption[]>>',
                             required: true,
+                            description: "The options on offer per dimension (`colorName`, `pattern`, `finish`, `size`, `width`,\n`length`, `substrate`, `finishType`). Each present dimension becomes one field, ordered\nwith colourways first; an option with `available: false` is shown as unavailable.",
                         },
                     ],
                 },
@@ -19794,6 +20262,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -20649,6 +21118,8 @@ export const docsManifest = {
                             name: "border",
                             type: "BorderStyle",
                             required: false,
+                            defaultValue: '"none"',
+                            description: "Outline: `none` draws no border, `solid` a 1px border, `dashed` a faint dashed one for placeholder or drop areas.",
                         },
                         {
                             name: "inset",
@@ -20674,11 +21145,14 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "variant",
                             type: '"muted" | "ghost" | "accent" | "card" | null | undefined',
                             required: false,
+                            defaultValue: '"card"',
+                            description: "Surface: `card` is the standard card fill, `muted` and `accent` are tinted fills, `ghost` has no fill or shadow.",
                         },
                     ],
                 },
@@ -20938,43 +21412,57 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
                             type: "ButtonSizeProp",
                             required: false,
                             defaultValue: '"base"',
-                            description: 'Size token; `icon-*` variants produce a square icon-only button. Also\naccepts a responsive object keyed by viewport breakpoints and/or `@`-prefixed\ncontainer queries - e.g. `{ base: "sm", md: "base", "@sm": "lg" }`.',
+                            description: 'Size token; `icon-*` variants produce a square icon-only button. Also\naccepts a responsive object keyed by viewport breakpoints and/or `@`-prefixed\ncontainer queries - e.g. `{ base: "sm", md: "base", "@sm": "lg" }`.\nSize token, as on Button.',
                         },
                         {
                             name: "render",
@@ -21055,6 +21543,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "showWhenCollapsed",
@@ -21087,11 +21576,14 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` is the standard 8px radius, `square` has sharp corners, `full` is a pill.",
                         },
                         {
                             name: "size",
@@ -21220,16 +21712,21 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"base"',
+                            description: 'Row height and text size. Use `"xl"` in an icon-collapsible sidebar so the collapsed square centres on the rail.',
                         },
                         {
                             name: "variant",
                             type: '"input" | "default" | "outline"',
                             required: false,
+                            defaultValue: '"input"',
+                            description: 'Surface treatment: `"input"` uses the sidebar\'s accent fill on hover and when active, `"default"` the standard accent tint, `"outline"` adds a ring.',
                         },
                         {
                             name: "icon",
                             type: "IconComponent",
                             required: false,
+                            description: "Leading icon component. When the sidebar collapses to the rail it is the only thing shown, unless `collapsedIcon` or `collapsedContent` replaces it.",
                         },
                         {
                             name: "collapsedIcon",
@@ -21247,6 +21744,7 @@ export const docsManifest = {
                             name: "suffixIcon",
                             type: "IconComponent",
                             required: false,
+                            description: "Trailing icon component, such as a chevron for a submenu. Replaces the `kbd` hint when both are set, and hides when the sidebar collapses.",
                         },
                         {
                             name: "forceExpanded",
@@ -21258,6 +21756,7 @@ export const docsManifest = {
                             name: "kbd",
                             type: "string[]",
                             required: false,
+                            description: 'Keyboard shortcut keys shown as keycaps at the end of the row, one string per key (e.g. `["⌘", "K"]`). Hidden when collapsed or when `suffixIcon` is set.',
                         },
                         {
                             name: "children",
@@ -21334,6 +21833,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"input" | "default" | "outline" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Surface treatment: `default` tints on hover, `input` uses the input fill, `outline` adds a ring.\nRow style, as on MenuItem.",
                         },
                         {
                             name: "indicator",
@@ -21345,21 +21846,29 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red hover and active tint.",
                         },
                         {
                             name: "inset",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar. Switched on automatically when `indicator` is set.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill, `rounded` a soft rectangle, `square` has sharp corners.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Row height, padding and text size, on the shared component scale. Match the surrounding menu's `size`.\nRow size, as on MenuItem.",
                         },
                         {
                             name: "loading",
@@ -21615,11 +22124,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -21645,31 +22158,42 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -22914,6 +23438,7 @@ export const docsManifest = {
                             name: "image",
                             type: "ReactNode",
                             required: false,
+                            description: "Picture shown inside the tile, such as an `<img>` of the variant; omit it for a plain `color` tile.",
                         },
                         {
                             name: "label",