@instruments/materia-ui 0.4.6 → 0.4.8

package/dist/data/docs-manifest.js

@@ -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.",
                         },
                     ],
                 },
@@ -3298,12 +3371,6 @@ export const docsManifest = {
                             required: false,
                             description: "Whether disabled",
                         },
-                        {
-                            name: "onValueChange",
-                            type: "((value: string) => void) & ((countryCode: string) => void)",
-                            required: false,
-                            description: 'Called with the selected value, or `""` when the selection is toggled off.\nValue change handler - receives ISO country code',
-                        },
                         {
                             name: "size",
                             type: "ResponsiveSize",
@@ -3348,6 +3415,12 @@ export const docsManifest = {
                             required: false,
                             description: "Current country code (ISO 3166-1 alpha-2) or country name",
                         },
+                        {
+                            name: "onValueChange",
+                            type: "(countryCode: string) => void",
+                            required: false,
+                            description: "Value change handler - receives ISO country code",
+                        },
                     ],
                 },
             ],
@@ -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`).",
                         },
                     ],
                 },
@@ -6069,17 +6190,6 @@ export const docsManifest = {
                             required: false,
                             description: 'Replace the rendered `<button>` with another element or component\n(e.g. `<Link href="…" />`); styling, decorations and props are applied to it.',
                         },
-                        {
-                            name: "tone",
-                            type: '"neutral" | "brand" | "danger"',
-                            required: false,
-                            description: "Button tone.",
-                        },
-                        {
-                            name: "radius",
-                            type: '"rounded" | "square" | "full" | null | undefined',
-                            required: false,
-                        },
                         {
                             name: "dot",
                             type: "string | undefined",
@@ -6093,42 +6203,32 @@ export const docsManifest = {
                             defaultValue: "false",
                             description: "Show a spinner and block presses. The button stays focusable (it is\n`aria-disabled`, not natively disabled) so keyboard focus is kept.",
                         },
-                        {
-                            name: "square",
-                            type: "boolean | null | undefined",
-                            required: false,
-                        },
-                        {
-                            name: "icon",
-                            type: 'import("../../tokens/icon-component").IconComponent & (LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>)',
-                            required: false,
-                            description: "Leading icon (Lucide or SVG component); with no children it becomes an icon-only button.\nIcon to display.",
-                        },
-                        {
-                            name: "emphasis",
-                            type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent"',
-                            required: false,
-                            description: "Button emphasis.",
-                        },
                         {
                             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",
@@ -6180,6 +6280,39 @@ export const docsManifest = {
                             defaultValue: '"start"',
                             description: "Dot position relative to content.",
                         },
+                        {
+                            name: "icon",
+                            type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
+                            required: false,
+                            description: "Icon shown in the button, passed as a component (such as a Lucide icon); with no children the button is icon-only.",
+                        },
+                        {
+                            name: "tone",
+                            type: "ButtonTone",
+                            required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour, as on Button.",
+                        },
+                        {
+                            name: "emphasis",
+                            type: "ButtonEmphasis",
+                            required: false,
+                            defaultValue: '"ghost"',
+                            description: "Visual weight, as on Button; ghost keeps the button quiet inside the field.",
+                        },
+                        {
+                            name: "radius",
+                            type: '"rounded" | "square" | "full" | null | undefined',
+                            required: false,
+                            description: "Corner shape; leave unset - the corners follow the InputGroup's `radius`, tighter inside the field.",
+                        },
+                        {
+                            name: "square",
+                            type: "boolean | null | undefined",
+                            required: false,
+                            defaultValue: "true",
+                            description: "Square by default, as an icon button sized from the InputGroup.",
+                        },
                     ],
                 },
                 {
@@ -6348,11 +6481,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 +6533,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 +6561,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 +6607,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 +6710,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 +6883,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -7016,26 +7170,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 +7367,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 +7392,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 +7439,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 +7464,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 +7498,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 +7523,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 +7553,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 +7578,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 +7606,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 +7621,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 +7635,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 +8322,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 +8378,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -8234,6 +8419,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 +8444,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 +8634,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 +8708,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 +8741,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 +9499,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 +9534,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 +9770,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 +9875,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9695,11 +9897,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 +9916,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9727,6 +9933,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9743,6 +9950,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9759,6 +9967,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9767,29 +9976,37 @@ export const docsManifest = {
                     kind: "component",
                     props: [
                         {
-                            name: "tone",
-                            type: '"neutral" | "brand" | "danger" | null | undefined',
+                            name: "className",
+                            type: "string",
                             required: false,
                         },
                         {
-                            name: "radius",
-                            type: '"rounded" | "square" | "full" | null | undefined',
+                            name: "tone",
+                            type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour of the trigger, as on Button.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"outline"',
+                            description: "Visual weight, as on Button; the outline reads as a form field.",
                         },
                         {
-                            name: "pressed",
-                            type: "boolean | null | undefined",
+                            name: "radius",
+                            type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape, as on Button.",
                         },
                         {
-                            name: "className",
-                            type: "string",
+                            name: "pressed",
+                            type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Shrink while held down, as on Button, but off by default here.",
                         },
                         {
                             name: "size",
@@ -9802,6 +10019,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9813,6 +10031,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -10272,11 +10491,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 +10518,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 +10697,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 +11672,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 +11930,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.",
                         },
                     ],
                 },
@@ -11761,16 +11997,16 @@ export const docsManifest = {
                     kind: "component",
                     props: [
                         {
-                            name: "aria-label",
+                            name: "color",
                             type: "string",
                             required: false,
-                            description: "Defines a string value that labels the current element.\nAccessible label for screen readers.",
+                            description: "CSS colour value (hex, rgb, hsl, etc.).\nIf provided along with children, children render on top.",
                         },
                         {
-                            name: "color",
+                            name: "aria-label",
                             type: "string",
                             required: false,
-                            description: "CSS colour value (hex, rgb, hsl, etc.).\nIf provided along with children, children render on top.",
+                            description: "Accessible label for screen readers.",
                         },
                         {
                             name: "children",
@@ -11813,18 +12049,18 @@ export const docsManifest = {
                             required: false,
                             description: "CSS colour value (hex, rgb, hsl, etc.).\nIf provided along with children, children render on top.",
                         },
-                        {
-                            name: "aria-label",
-                            type: "string",
-                            required: false,
-                            description: "Defines a string value that labels the current element.\nAccessible label for screen readers.",
-                        },
                         {
                             name: "value",
                             type: "string",
                             required: true,
                             description: "Unique value for this swatch",
                         },
+                        {
+                            name: "aria-label",
+                            type: "string",
+                            required: false,
+                            description: "Accessible label for screen readers.",
+                        },
                         {
                             name: "children",
                             type: 'import("react").ReactNode',
@@ -11891,18 +12127,18 @@ export const docsManifest = {
                             required: false,
                             description: "CSS colour value (hex, rgb, hsl, etc.).\nIf provided along with children, children render on top.",
                         },
-                        {
-                            name: "aria-label",
-                            type: "string",
-                            required: false,
-                            description: "Defines a string value that labels the current element.\nAccessible label for screen readers.",
-                        },
                         {
                             name: "value",
                             type: "string",
                             required: true,
                             description: "Unique value for this swatch",
                         },
+                        {
+                            name: "aria-label",
+                            type: "string",
+                            required: false,
+                            description: "Accessible label for screen readers.",
+                        },
                         {
                             name: "children",
                             type: 'import("react").ReactNode',
@@ -12018,6 +12254,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 +12273,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 +12291,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 +12471,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 +12499,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 +12512,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 +12665,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 +12832,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -12694,11 +12948,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 +12966,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 +13011,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 +13024,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 +13330,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 +13683,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 +13744,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 +13821,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 +13949,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 +14325,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 +14407,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 +14448,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 +14470,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 +14527,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 +14595,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 +14613,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 +14841,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 +15062,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 +15097,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 +15121,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 +15149,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 +15182,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 +15199,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 +15223,7 @@ export const docsManifest = {
                             name: "header",
                             type: "Header<TData>",
                             required: true,
+                            description: "The header whose column this handle resizes.",
                         },
                     ],
                 },
@@ -14935,11 +15240,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 +15258,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 +15409,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 +15461,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 +15623,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 +15846,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 +15942,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 +16039,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 +16241,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 +16275,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 +16288,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 +16469,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 +16487,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 +16608,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 +16855,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 +16889,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 +17094,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 +17288,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 +17419,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -17129,6 +17498,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.",
                         },
                     ],
                 },
@@ -17136,40 +17506,25 @@ export const docsManifest = {
                     name: "MobileNavigationHeaderAction",
                     kind: "component",
                     props: [
+                        {
+                            name: "render",
+                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            required: false,
+                            description: 'Replace the rendered `<button>` with another element or component\n(e.g. `<Link href="…" />`); styling, decorations and props are applied to it.',
+                        },
                         {
                             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,
-                        },
-                        {
-                            name: "square",
-                            type: "boolean | null | undefined",
-                            required: false,
-                        },
-                        {
-                            name: "emphasis",
-                            type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
-                            required: false,
-                        },
-                        {
-                            name: "asInput",
-                            type: "boolean | null | undefined",
-                            required: false,
-                        },
-                        {
-                            name: "align",
-                            type: '"center" | "end" | "start" | null | undefined',
-                            required: false,
-                        },
-                        {
-                            name: "pressed",
-                            type: "boolean | 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",
@@ -17179,10 +17534,10 @@ export const docsManifest = {
                             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" }`.',
                         },
                         {
-                            name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            name: "dot",
+                            type: "string | undefined",
                             required: false,
-                            description: 'Replace the rendered `<button>` with another element or component\n(e.g. `<Link href="…" />`); styling, decorations and props are applied to it.',
+                            description: "CSS colour for a status dot; empty/undefined renders no dot.",
                         },
                         {
                             name: "loading",
@@ -17192,10 +17547,11 @@ export const docsManifest = {
                             description: "Show a spinner and block presses. The button stays focusable (it is\n`aria-disabled`, not natively disabled) so keyboard focus is kept.",
                         },
                         {
-                            name: "loadingLabel",
-                            type: "string | undefined",
+                            name: "square",
+                            type: "boolean | null | undefined",
                             required: false,
-                            description: "Label shown in place of `children` while `loading`.",
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "icon",
@@ -17204,35 +17560,37 @@ export const docsManifest = {
                             description: "Leading icon (Lucide or SVG component); with no children it becomes an icon-only button.",
                         },
                         {
-                            name: "iconClassName",
-                            type: "string | undefined",
+                            name: "asInput",
+                            type: "boolean | null | undefined",
                             required: false,
-                            description: "Extra classes for the leading icon.",
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
-                            name: "suffixIcon",
-                            type: "IconComponent | undefined",
+                            name: "align",
+                            type: '"center" | "end" | "start" | null | undefined',
                             required: false,
-                            description: "Trailing icon (Lucide or SVG component) rendered at the end.",
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
-                            name: "suffixIconClassName",
-                            type: "string | undefined",
+                            name: "pressed",
+                            type: "boolean | null | undefined",
                             required: false,
-                            description: "Extra classes for the trailing icon.",
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
-                            name: "dot",
-                            type: "string | undefined",
+                            name: "testId",
+                            type: "string",
                             required: false,
-                            description: "CSS colour for a status dot; empty/undefined renders no dot.",
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
-                            name: "dotPlacement",
-                            type: '"end" | "start" | undefined',
+                            name: "suffixIcon",
+                            type: "IconComponent | undefined",
                             required: false,
-                            defaultValue: '"start"',
-                            description: "Dot position relative to content.",
+                            description: "Trailing icon (Lucide or SVG component) rendered at the end.",
                         },
                         {
                             name: "expandable",
@@ -17254,9 +17612,36 @@ export const docsManifest = {
                             description: "Force the hover state on - for documentation/testing only.",
                         },
                         {
-                            name: "testId",
-                            type: "string",
+                            name: "loadingLabel",
+                            type: "string | undefined",
                             required: false,
+                            description: "Label shown in place of `children` while `loading`.",
+                        },
+                        {
+                            name: "iconClassName",
+                            type: "string | undefined",
+                            required: false,
+                            description: "Extra classes for the leading icon.",
+                        },
+                        {
+                            name: "suffixIconClassName",
+                            type: "string | undefined",
+                            required: false,
+                            description: "Extra classes for the trailing icon.",
+                        },
+                        {
+                            name: "dotPlacement",
+                            type: '"end" | "start" | undefined',
+                            required: false,
+                            defaultValue: '"start"',
+                            description: "Dot position relative to content.",
+                        },
+                        {
+                            name: "emphasis",
+                            type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
+                            required: false,
+                            defaultValue: '"soft"',
+                            description: "Visual weight, as on Button.",
                         },
                     ],
                 },
@@ -17315,11 +17700,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 +17728,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 +17908,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 +17935,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 +17948,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 +18055,7 @@ export const docsManifest = {
                             name: "label",
                             type: "React.ReactNode",
                             required: true,
+                            description: "Project name; truncates to one line.",
                         },
                         {
                             name: "onAction",
@@ -17651,6 +18067,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 +18101,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 +18544,7 @@ export const docsManifest = {
                             type: "string",
                             required: false,
                             defaultValue: '"Clear all"',
+                            description: "Text of the button that calls `onClear`.",
                         },
                         {
                             name: "separator",
@@ -18228,6 +18647,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 +18769,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 +18796,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 +18914,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 +19163,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 +19205,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 +19223,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 +19258,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 +19440,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 +19458,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 +19556,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 +19701,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 +19824,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 +20016,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 +20103,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 +20185,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 +20227,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 +20261,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -20145,12 +20613,6 @@ export const docsManifest = {
                             type: "string",
                             required: false,
                         },
-                        {
-                            name: "aria-label",
-                            type: "string",
-                            required: true,
-                            description: 'Defines a string value that labels the current element.\nNames the scrolling region for assistive tech, e.g. "Product details".',
-                        },
                         {
                             name: "allowOverflow",
                             type: "boolean",
@@ -20169,6 +20631,12 @@ export const docsManifest = {
                             required: false,
                             description: "Additional classes for the viewport (scrolling container)",
                         },
+                        {
+                            name: "aria-label",
+                            type: "string",
+                            required: true,
+                            description: 'Names the scrolling region for assistive tech, e.g. "Product details".',
+                        },
                     ],
                 },
                 {
@@ -20649,6 +21117,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 +21144,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.",
                         },
                     ],
                 },
@@ -20934,84 +21407,115 @@ export const docsManifest = {
                     name: "SidebarGroupAction",
                     kind: "component",
                     props: [
+                        {
+                            name: "render",
+                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            required: false,
+                            description: 'Replace the rendered `<button>` with another element or component\n(e.g. `<Link href="…" />`); styling, decorations and props are applied to it.',
+                        },
                         {
                             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",
+                            type: "string | undefined",
+                            required: false,
+                            description: "CSS colour for a status dot; empty/undefined renders no dot.",
+                        },
+                        {
+                            name: "loading",
+                            type: "boolean | undefined",
+                            required: false,
+                            defaultValue: "false",
+                            description: "Show a spinner and block presses. The button stays focusable (it is\n`aria-disabled`, not natively disabled) so keyboard focus is kept.",
                         },
                         {
                             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',
+                            name: "icon",
+                            type: "IconComponent | undefined",
                             required: false,
+                            description: "Leading icon (Lucide or SVG component); with no children it becomes an icon-only 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",
+                            name: "testId",
+                            type: "string",
                             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: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
-                            name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            name: "suffixIcon",
+                            type: "IconComponent | undefined",
                             required: false,
-                            description: 'Replace the rendered `<button>` with another element or component\n(e.g. `<Link href="…" />`); styling, decorations and props are applied to it.',
+                            description: "Trailing icon (Lucide or SVG component) rendered at the end.",
                         },
                         {
-                            name: "loading",
+                            name: "expandable",
                             type: "boolean | undefined",
                             required: false,
                             defaultValue: "false",
-                            description: "Show a spinner and block presses. The button stays focusable (it is\n`aria-disabled`, not natively disabled) so keyboard focus is kept.",
+                            description: "Icon-only at rest; expands on hover/focus-visible to reveal the label\nto the right of the icon. Collapsed geometry equals the matching icon-*\nsize, expanded equals the text button of that size - so pass a text\nsize (`sm`/`base`/`lg`) OR its icon twin (`icon-sm` …); both resolve\nidentically. Requires both `icon` and children; ignored with `square`. The label stays in the DOM in both states (stable\naccessible name).",
                         },
                         {
-                            name: "loadingLabel",
-                            type: "string | undefined",
+                            name: "focused",
+                            type: "boolean | undefined",
                             required: false,
-                            description: "Label shown in place of `children` while `loading`.",
+                            description: "Force the focus ring on - for documentation/testing only.",
                         },
                         {
-                            name: "icon",
-                            type: "IconComponent | undefined",
+                            name: "hovered",
+                            type: "boolean | undefined",
                             required: false,
-                            description: "Leading icon (Lucide or SVG component); with no children it becomes an icon-only button.",
+                            description: "Force the hover state on - for documentation/testing only.",
                         },
                         {
-                            name: "iconClassName",
+                            name: "loadingLabel",
                             type: "string | undefined",
                             required: false,
-                            description: "Extra classes for the leading icon.",
+                            description: "Label shown in place of `children` while `loading`.",
                         },
                         {
-                            name: "suffixIcon",
-                            type: "IconComponent | undefined",
+                            name: "iconClassName",
+                            type: "string | undefined",
                             required: false,
-                            description: "Trailing icon (Lucide or SVG component) rendered at the end.",
+                            description: "Extra classes for the leading icon.",
                         },
                         {
                             name: "suffixIconClassName",
@@ -21019,12 +21523,6 @@ export const docsManifest = {
                             required: false,
                             description: "Extra classes for the trailing icon.",
                         },
-                        {
-                            name: "dot",
-                            type: "string | undefined",
-                            required: false,
-                            description: "CSS colour for a status dot; empty/undefined renders no dot.",
-                        },
                         {
                             name: "dotPlacement",
                             type: '"end" | "start" | undefined',
@@ -21033,28 +21531,18 @@ export const docsManifest = {
                             description: "Dot position relative to content.",
                         },
                         {
-                            name: "expandable",
-                            type: "boolean | undefined",
-                            required: false,
-                            defaultValue: "false",
-                            description: "Icon-only at rest; expands on hover/focus-visible to reveal the label\nto the right of the icon. Collapsed geometry equals the matching icon-*\nsize, expanded equals the text button of that size - so pass a text\nsize (`sm`/`base`/`lg`) OR its icon twin (`icon-sm` …); both resolve\nidentically. Requires both `icon` and children; ignored with `square`. The label stays in the DOM in both states (stable\naccessible name).",
-                        },
-                        {
-                            name: "focused",
-                            type: "boolean | undefined",
-                            required: false,
-                            description: "Force the focus ring on - for documentation/testing only.",
-                        },
-                        {
-                            name: "hovered",
-                            type: "boolean | undefined",
+                            name: "size",
+                            type: 'import("../../components/button/button-types").ButtonSizeProp | undefined',
                             required: false,
-                            description: "Force the hover state on - for documentation/testing only.",
+                            defaultValue: '"icon-sm"',
+                            description: "Size token, as on Button.",
                         },
                         {
-                            name: "testId",
-                            type: "string",
+                            name: "emphasis",
+                            type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"ghost"',
+                            description: "Visual weight, as on Button.",
                         },
                         {
                             name: "showWhenCollapsed",
@@ -21087,11 +21575,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 +21711,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 +21743,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 +21755,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",
@@ -21330,11 +21828,6 @@ export const docsManifest = {
                             required: false,
                             description: "Replace the default `<button>` with another element or component. Glyph props render inside it, around `children`; the element should carry no children of its own.",
                         },
-                        {
-                            name: "variant",
-                            type: '"input" | "default" | "outline" | null | undefined',
-                            required: false,
-                        },
                         {
                             name: "indicator",
                             type: "React.ReactNode",
@@ -21345,21 +21838,22 @@ 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,
-                        },
-                        {
-                            name: "size",
-                            type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
-                            required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill, `rounded` a soft rectangle, `square` has sharp corners.",
                         },
                         {
                             name: "loading",
@@ -21391,12 +21885,6 @@ export const docsManifest = {
                             required: false,
                             description: 'Selection visual: "checkbox" renders Checkbox, "radio" renders radio circle. Defaults to "checkbox" when `checked` is set.',
                         },
-                        {
-                            name: "iconClassName",
-                            type: "string",
-                            required: false,
-                            description: "Additional className for the icon",
-                        },
                         {
                             name: "avatar",
                             type: "React.ReactNode",
@@ -21439,6 +21927,26 @@ export const docsManifest = {
                             required: false,
                             description: "Icon to display in the left icon column",
                         },
+                        {
+                            name: "iconClassName",
+                            type: "string",
+                            required: false,
+                            description: "Additional className for the icon",
+                        },
+                        {
+                            name: "size",
+                            type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
+                            required: false,
+                            defaultValue: '"xl"',
+                            description: "Row size, as on MenuItem.",
+                        },
+                        {
+                            name: "variant",
+                            type: '"input" | "default" | "outline" | null | undefined',
+                            required: false,
+                            defaultValue: '"input"',
+                            description: "Row style, as on MenuItem.",
+                        },
                     ],
                 },
                 {
@@ -21615,11 +22123,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 +22157,35 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
-                        },
-                        {
-                            name: "emphasis",
-                            type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | 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",
@@ -21727,6 +22243,13 @@ export const docsManifest = {
                             required: false,
                             description: "Icon to display. Defaults to PanelLeftCloseIcon.",
                         },
+                        {
+                            name: "emphasis",
+                            type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
+                            required: false,
+                            defaultValue: '"ghost"',
+                            description: "Visual weight, as on Button.",
+                        },
                     ],
                 },
                 {
@@ -22914,6 +23437,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",