@instruments/materia-ui 0.4.5 → 0.4.7

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.",
                         },
                     ],
                 },
@@ -458,8 +464,8 @@ export const docsManifest = {
                             name: "ratio",
                             type: "number",
                             required: false,
-                            defaultValue: "16 / 9",
-                            description: "Desired width-to-height ratio, expressed as a single number (width / height).",
+                            defaultValue: "1",
+                            description: "Desired width-to-height ratio, expressed as a single number (width / height).\nSquare unless asked: a material is shown at 1:1, and only scenes and\nvideo take a wide ratio.",
                         },
                     ],
                 },
@@ -472,8 +478,16 @@ export const docsManifest = {
             bestPractices: [
                 "Give it exactly one child and let it fill - set the media to `size-full object-cover`; `AspectRatio` sizes to the available width and derives height from `ratio`.",
                 "Use `as` to change the element (a tag); use `render` only to swap in a component (e.g. a router Link). Never `render={<Box as=…/>}` - pass `as` directly.",
+                "Show a material, swatch or sample at the default 1:1 - never landscape. A sample is cut square, and a wide crop reads as room photography; set a wide `ratio` only for a scene, an interior or video.",
+            ],
+            keywords: [
+                "material image",
+                "swatch image",
+                "sample image",
+                "thumbnail",
+                "square",
+                "image ratio",
             ],
-            keywords: [],
             uses: [],
             usedBy: [],
             anatomy: {
@@ -498,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",
@@ -566,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",
@@ -602,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",
@@ -727,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",
@@ -738,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",
@@ -792,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",
@@ -809,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",
@@ -838,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",
@@ -869,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",
@@ -896,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.",
                         },
                     ],
                 },
@@ -1099,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.",
                         },
                     ],
                 },
@@ -1203,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",
@@ -1320,6 +1367,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -1418,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`.",
                         },
                     ],
                 },
@@ -1510,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",
@@ -1535,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.",
                         },
                     ],
                 },
@@ -2191,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.",
                         },
                     ],
                 },
@@ -2289,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.",
                         },
                     ],
                 },
@@ -2931,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`.",
                         },
@@ -2956,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",
@@ -3001,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",
@@ -3022,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",
@@ -3052,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`.",
                         },
@@ -3077,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.",
                         },
                     ],
                 },
@@ -3101,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`.",
                         },
@@ -3126,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.",
                         },
                     ],
                 },
@@ -3152,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`.",
                         },
                     ],
                 },
@@ -3166,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`.",
                         },
@@ -3180,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.",
                         },
                     ],
                 },
@@ -3682,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.",
                         },
                     ],
                 },
@@ -3799,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.",
                         },
                     ],
                 },
@@ -3922,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`.",
                         },
@@ -3947,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",
@@ -3992,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",
@@ -4013,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",
@@ -4043,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`.",
                         },
@@ -4068,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.",
                         },
                     ],
                 },
@@ -4092,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`.",
                         },
@@ -4117,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.",
                         },
                     ],
                 },
@@ -4143,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`.",
                         },
                     ],
                 },
@@ -4157,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`.",
                         },
@@ -4171,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.",
                         },
                     ],
                 },
@@ -4351,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.",
                         },
                     ],
                 },
@@ -4497,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",
@@ -4682,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",
@@ -4720,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.",
                         },
                     ],
                 },
@@ -5581,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.",
                         },
                     ],
                 },
@@ -5647,6 +5762,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -5767,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",
@@ -5788,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.",
                         },
                     ],
                 },
@@ -5825,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",
@@ -5937,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`).",
                         },
                     ],
                 },
@@ -6065,12 +6194,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger"',
                             required: false,
-                            description: "Button tone.",
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.\nSemantic colour, as on Button.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.\nCorner shape; leave unset - the corners follow the InputGroup's `radius`, tighter inside the field.",
                         },
                         {
                             name: "dot",
@@ -6089,6 +6221,8 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.\nSquare by default, as an icon button sized from the InputGroup.",
                         },
                         {
                             name: "icon",
@@ -6100,27 +6234,35 @@ export const docsManifest = {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent"',
                             required: false,
-                            description: "Button emphasis.",
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button; ghost keeps the button quiet inside the field.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -6340,11 +6482,15 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Padding and gap between the item's parts, `2xs` (tightest) to `3xl` (roomiest).",
                         },
                         {
                             name: "variant",
                             type: '"default" | "outline" | "muted" | "card" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Surface: `default` is transparent, `outline` adds a border, `muted` a faint fill, `card` a bordered rounded card. Inside an `ItemGroup` the group's variant overrides most of this.",
                         },
                     ],
                 },
@@ -6388,6 +6534,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"divided" | "separated" | "grouped" | null | undefined',
                             required: false,
+                            defaultValue: '"divided"',
+                            description: "List style: `divided` is plain rows with lines between, `separated` makes each item its own card with a gap, `grouped` joins the items inside one bordered card.",
                         },
                     ],
                 },
@@ -6414,27 +6562,35 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Has no effect: the `icon` variant always renders a `neutral` icon box.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Has no effect: the `icon` variant always renders the default icon box corners.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Has no effect: the `icon` variant always renders a `sm` (32px) icon box.",
                         },
                         {
-                            name: "icon",
-                            type: 'import("../../tokens/icon-component").IconComponent',
+                            name: "emphasis",
+                            type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
                             required: false,
-                            description: "Icon component from lucide-react or any SVG React component.",
+                            defaultValue: '"solid"',
+                            description: "Has no effect: the `icon` variant always renders the default solid icon box.",
                         },
                         {
-                            name: "emphasis",
-                            type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
+                            name: "icon",
+                            type: 'import("../../tokens/icon-component").IconComponent',
                             required: false,
+                            description: "Icon component from lucide-react or any SVG React component.",
                         },
                         {
                             name: "iconSize",
@@ -6452,6 +6608,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"image" | "default" | "icon" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Media type: `icon` renders the `icon` prop in a small neutral `IconBox`, `image` crops its child `<img>` to a 40px square, `default` wraps any children as they are.",
                         },
                     ],
                 },
@@ -6553,11 +6711,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: 'Semantic colour: `neutral` for ordinary keys, `brand` to highlight one, `danger` for a destructive shortcut. `brand` and `danger` are only styled with `emphasis="solid"`.',
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Fill treatment: `solid` is a muted chip, `soft` a secondary-coloured fill, `outline` a bordered key on the page background, `ghost` bare text.",
                         },
                         {
                             name: "size",
@@ -6722,6 +6884,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -6957,8 +7120,9 @@ export const docsManifest = {
                 "Use `as` to change the element (a tag); use `render` only to swap in a component (e.g. a router Link). Never `render={<Box as=…/>}` - pass `as` directly.",
                 "Set `edge` to frame photography with an inset hairline that stays above the media; do not fake it with a border or an inset shadow on the frame, which the media hides.",
                 "Reach for `raised` only when the frame sits on the same fill as its surface; in a dense row the edge already separates it.",
+                "Frame a material, swatch or sample square: give the frame `aspect-square` (or wrap it in `AspectRatio`, which defaults to 1:1). Never crop a material landscape.",
             ],
-            keywords: [],
+            keywords: ["material image", "product image", "photo frame", "thumbnail"],
             uses: [],
             usedBy: ["editorial-card", "product-card"],
         },
@@ -7007,26 +7171,36 @@ export const docsManifest = {
                             name: "variant",
                             type: '"input" | "default" | "outline" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Surface treatment: `default` tints on hover, `input` uses the input fill, `outline` adds a ring.",
                         },
                         {
                             name: "tone",
                             type: '"neutral" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red hover and active tint.",
                         },
                         {
                             name: "inset",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar. Switched on automatically when `indicator` is set.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill, `rounded` a soft rectangle, `square` has sharp corners.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Row height, padding and text size, on the shared component scale. Match the surrounding menu's `size`.",
                         },
                         {
                             name: "render",
@@ -7194,7 +7368,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -7219,6 +7393,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Size of every item, label and shortcut inside, which read it from context. Submenus inherit it.",
                         },
                         {
                             name: "itemRadius",
@@ -7264,16 +7440,20 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar.",
                         },
                         {
                             name: "tone",
                             type: '"neutral" | "danger"',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red highlight.",
                         },
                         {
                             name: "avatar",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom leading element, such as an `Avatar`. Takes precedence over `dot` and `icon`.",
                         },
                         {
                             name: "dot",
@@ -7285,21 +7465,25 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. Hidden when `avatar` or `dot` is set.",
                         },
                         {
                             name: "suffixIcon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Trailing icon, passed as a component. Replaces `kbd` when both are set.",
                         },
                         {
                             name: "kbd",
                             type: "string[]",
                             required: false,
+                            description: 'Keyboard shortcut keys shown as keycaps at the end, for example `["⌘", "C"]`. Ignored when `suffixIcon` is set.',
                         },
                         {
                             name: "suffix",
                             type: "React.ReactNode",
                             required: false,
+                            description: "Custom trailing content, rendered after `suffixIcon` or `kbd`.",
                         },
                         {
                             name: "active",
@@ -7315,7 +7499,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row (e.g. with a link); glyph props render inside it, around `children`.",
                         },
@@ -7340,6 +7524,7 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so the label lines up with items that have a leading icon.",
                         },
                     ],
                 },
@@ -7369,7 +7554,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -7394,6 +7579,8 @@ export const docsManifest = {
                             name: "spacing",
                             type: '"default" | "compact"',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "`default` is a 1px rule with 4px margins. `compact` centres the same rule in a taller transparent band, leaving more room around it.",
                         },
                     ],
                 },
@@ -7420,6 +7607,7 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: "Item size for this submenu only. Omit to inherit the parent menu's `size`.",
                         },
                     ],
                 },
@@ -7434,7 +7622,7 @@ export const docsManifest = {
                         },
                         {
                             name: "render",
-                            type: "useRender.RenderProp<Record<string, unknown>> | undefined",
+                            type: 'import("@base-ui/react").useRender.RenderProp<Record<string, unknown>> | undefined',
                             required: false,
                             description: "Replace the default `<button>` row; glyph props render inside it, around `children`.",
                         },
@@ -7448,11 +7636,13 @@ export const docsManifest = {
                             name: "inset",
                             type: "boolean",
                             required: false,
+                            description: "Pads the start so a row with no leading icon lines up with rows that have one.",
                         },
                         {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Leading icon, passed as a component (such as a Lucide icon) rather than an element. The trailing chevron is added for you.",
                         },
                     ],
                 },
@@ -8133,11 +8323,15 @@ export const docsManifest = {
                             name: "radius",
                             type: '"rounded" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` for a soft rectangle, `full` for a capsule.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"xl"',
+                            description: "Control height and text size, matching Button and Input at the same size. Also sizes the country selector.",
                         },
                         {
                             name: "value",
@@ -8185,6 +8379,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -8225,6 +8420,7 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Dims the pill and blocks pointer events. Styling only: no `disabled` attribute reaches the element.",
                         },
                         {
                             name: "render",
@@ -8249,16 +8445,22 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `neutral` for plain labels, `brand` for the house yellow, `success` / `warning` / `info` / `danger` for status.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a capsule, `rounded` a soft rectangle, `square` has sharp corners. Overrides the size's own corner radius.",
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight: `solid` is a filled pill, `soft` a pale tint, `outline` a border, `ghost` text only, `transparent` frosted glass for use over images only.",
                         },
                         {
                             name: "asInput",
@@ -8433,11 +8635,14 @@ export const docsManifest = {
                             name: "positionerClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the positioning layer around the content, such as a lower `z-*` for a panel that sits beneath fixed chrome. Defaults to `z-50`.",
                         },
                         {
                             name: "size",
                             type: "PopoverSize",
                             required: false,
+                            defaultValue: '"lg"',
+                            description: "Padding and corner radius: `sm` is compact (8px), `base` is 16px, `lg` is roomy (24px).",
                         },
                     ],
                 },
@@ -8504,6 +8709,7 @@ export const docsManifest = {
                             name: "indicatorClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the filled arc, for example a stroke colour such as `stroke-brand`. Defaults to `stroke-primary`.",
                         },
                         {
                             name: "label",
@@ -8536,6 +8742,7 @@ export const docsManifest = {
                             name: "trackClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the unfilled ring behind the arc, for example a stroke colour such as `stroke-border`. Defaults to `stroke-muted`.",
                         },
                         {
                             name: "value",
@@ -9293,6 +9500,7 @@ export const docsManifest = {
                             type: "ScrollFrameFadeMode | undefined",
                             required: false,
                             defaultValue: '"color"',
+                            description: "How the fades are drawn: `color` blends a gradient of `fadeTheme` into a solid surface, `mask` fades the content itself to transparent, for use over images or blurs.",
                         },
                         {
                             name: "fades",
@@ -9327,6 +9535,7 @@ export const docsManifest = {
                             type: "Orientation | undefined",
                             required: false,
                             defaultValue: '"vertical"',
+                            description: "Scroll axis: `vertical` scrolls up and down, `horizontal` left and right, as for a row of chips.",
                         },
                         {
                             name: "viewportClassName",
@@ -9562,12 +9771,14 @@ export const docsManifest = {
                             type: 'ResponsiveValue<"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl">',
                             required: false,
                             defaultValue: '"sm"',
+                            description: 'Size of every segment (text and padding), or an object per breakpoint like `{ base: "sm", md: "lg" }`.',
                         },
                         {
                             name: "fullWidth",
                             type: "boolean",
                             required: false,
                             defaultValue: "false",
+                            description: "Stretches the control to its container's width, with the segments sharing the space equally; otherwise it hugs its content.",
                         },
                     ],
                 },
@@ -9665,6 +9876,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9686,11 +9898,14 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Size of every SelectItem, label and group inside, which read it from context. Match the trigger's `size`.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9702,6 +9917,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9718,6 +9934,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9734,6 +9951,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9750,6 +9968,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9761,21 +9980,29 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.\nSemantic colour of the trigger, as on Button.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.\nCorner shape, as on Button.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button; the outline reads as a form field.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.\nShrink while held down, as on Button, but off by default here.",
                         },
                         {
                             name: "className",
@@ -9793,6 +10020,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -9804,6 +10032,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -10263,11 +10492,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "dot",
@@ -10286,26 +10519,35 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -10456,6 +10698,8 @@ export const docsManifest = {
                             name: "variant",
                             type: "SidepanelHeaderVariant",
                             required: false,
+                            defaultValue: '"default"',
+                            description: "`default` is a stacked title and description with a bottom border. `bar` is a transparent toolbar pinned over the top of the panel, for two `SidepanelControls` groups.",
                         },
                     ],
                 },
@@ -11429,6 +11673,7 @@ export const docsManifest = {
                             name: "href",
                             type: "string",
                             required: false,
+                            description: "Destination of the default `<a>`. Not used when `render` supplies its own element.",
                         },
                         {
                             name: "icon",
@@ -11686,6 +11931,7 @@ export const docsManifest = {
                             name: "radius",
                             type: "string",
                             required: true,
+                            description: "Tailwind rounding class (such as `rounded-xl`) matching the framed container's corners, so the ring follows them.",
                         },
                     ],
                 },
@@ -11704,8 +11950,15 @@ export const docsManifest = {
                 "Feed fills through `color`/`background`/`colors`, never a hex in `className`/`style` - the props drive the contrast-aware text colour, selection ring, and darkening overlay.",
                 "Reach for `Swatch` for a selectable colour/gradient/material chip or tile; a tiny non-interactive status marker is `Dot`, and a display-only status/category label is `Badge`.",
                 "For a gradient or image chip fill pass `light` - auto contrast detection (`isLightColor`) only reads solid colours, so overlaid icons/labels lose legibility without it.",
+                "A material swatch is always square, as Swatch draws it; never stretch a tile into a landscape crop, and in a grid let the column set the size.",
+            ],
+            keywords: [
+                "material swatch",
+                "material sample",
+                "finish",
+                "colourway",
+                "colour chip",
             ],
-            keywords: [],
             uses: ["center", "flex", "icon"],
             usedBy: [
                 "swatch-fan",
@@ -12002,6 +12255,7 @@ export const docsManifest = {
                             name: "href",
                             type: "string",
                             required: true,
+                            description: "Destination of the link. Also forwarded to the element given in `render`, such as a router `Link`.",
                         },
                         {
                             name: "icon",
@@ -12020,11 +12274,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                     ],
                 },
@@ -12036,11 +12292,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                     ],
                 },
@@ -12214,11 +12472,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                     ],
                 },
@@ -12240,6 +12500,8 @@ export const docsManifest = {
                             name: "layout",
                             type: 'boolean | "position" | "size" | "preserve-aspect"',
                             required: false,
+                            defaultValue: "true",
+                            description: 'Motion `layout` value for the height animation when the active tab\'s content changes size: `false` switches it off, `"size"` or `"position"` animates only that, `"preserve-aspect"` keeps the aspect ratio.',
                         },
                     ],
                 },
@@ -12251,11 +12513,13 @@ export const docsManifest = {
                             name: "variant",
                             type: '"line" | "pill" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the style for every part, so set `variant` there.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            description: "Ignored on its own: the parent `Tabs` or `TabNavigation` sets the size for every part, so set `size` there.",
                         },
                         {
                             name: "className",
@@ -12402,16 +12666,22 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | "warning" | "success" | "info" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `neutral` for plain labels, `brand` for the house yellow, `success` / `warning` / `info` / `danger` for status.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a capsule, `rounded` a soft rectangle, `square` has sharp corners. Overrides the size's own corner radius.",
                         },
                         {
                             name: "emphasis",
                             type: '"outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight: `solid` is a filled pill, `soft` a pale tint, `outline` a border, `ghost` text only, `transparent` frosted glass for use over images only.",
                         },
                         {
                             name: "asInput",
@@ -12563,6 +12833,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -12678,11 +12949,13 @@ export const docsManifest = {
                             name: "current",
                             type: "number",
                             required: true,
+                            description: "Number shown before the slash, counted from one (the first step is `1`).",
                         },
                         {
                             name: "total",
                             type: "number",
                             required: true,
+                            description: "Number shown after the slash.",
                         },
                     ],
                 },
@@ -12694,11 +12967,13 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | undefined",
                             required: true,
+                            description: "Icon to show. Renders nothing when `undefined`.",
                         },
                         {
                             name: "stepId",
                             type: "string",
                             required: true,
+                            description: "Id of the current step. A new id makes the previous icon crossfade into this one.",
                         },
                     ],
                 },
@@ -12737,6 +13012,8 @@ export const docsManifest = {
                             name: "shimmer",
                             type: "boolean",
                             required: false,
+                            defaultValue: "true",
+                            description: "Sweeps a highlight across the label; `false` renders it as plain text.",
                         },
                         {
                             name: "shimmerVariant",
@@ -12748,6 +13025,7 @@ export const docsManifest = {
                             name: "step",
                             type: "ThinkingStep",
                             required: true,
+                            description: "The step to show: its `label` is the text, and its `icon` leads it unless `hideIcon` is set.",
                         },
                     ],
                 },
@@ -13053,11 +13331,15 @@ export const docsManifest = {
                             name: "variant",
                             type: '"default" | "secondary" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "How a pressed toggle shows it is on: `default` greys the fill and border, `secondary` darkens the border only. Inside a `ToggleGroup` the group's value wins.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` for soft corners, `full` for a pill. There is no sharp option. Inside a `ToggleGroup` the group's value wins.",
                         },
                         {
                             name: "icon",
@@ -13402,11 +13684,13 @@ export const docsManifest = {
                             name: "onAction",
                             type: "() => void",
                             required: false,
+                            description: "Called when the action button is clicked. The button only appears when `actionLabel` is set.",
                         },
                         {
                             name: "onDismiss",
                             type: "() => void",
                             required: false,
+                            description: "Called when the dismiss button is clicked. The parent should then set `open` to `false`.",
                         },
                         {
                             name: "dismissLabel",
@@ -13461,11 +13745,14 @@ export const docsManifest = {
                             name: "onClick",
                             type: "() => void",
                             required: false,
+                            description: "Called when the pill is pressed. The parent decides what the press does in each `state`, such as starting or stopping capture.",
                         },
                         {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            defaultValue: "false",
+                            description: "Block presses and dim the pill.",
                         },
                         {
                             name: "label",
@@ -13535,6 +13822,7 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: false,
+                            description: "Icon component (e.g. a Lucide icon), not a rendered element; shown small and muted at the top right.",
                         },
                         {
                             name: "valueLabel",
@@ -13662,31 +13950,37 @@ export const docsManifest = {
                             name: "getItemKey",
                             type: "(item: T) => string",
                             required: true,
+                            description: "Stable unique key for an item, such as its id; never the array index.",
                         },
                         {
                             name: "getRowKey",
                             type: "(row: T[], rowIndex: number) => string",
                             required: false,
+                            description: "Stable key for a row. Defaults to `row-<rowIndex>`; supply one when rows can reorder or be re-chunked.",
                         },
                         {
                             name: "metrics",
                             type: 'Omit<CardGridRowMetrics, "rowWidth">',
                             required: true,
+                            description: "Pixel `cardWidth` and `gap` the rows were chunked with (e.g. from\n`calculateColumns`). They only size `renderAfterRow`'s `rowWidth`; they do\nnot lay the cards out.",
                         },
                         {
                             name: "renderAfterRow",
                             type: "(props: { metrics: CardGridRowMetrics; row: T[]; rowIndex: number; }) => ReactNode",
                             required: false,
+                            description: "Content rendered beneath a row, such as an expanded detail panel. Receives\n`metrics` with `rowWidth`, the row's pixel width, so the panel can align to it.",
                         },
                         {
                             name: "renderItem",
                             type: "(props: { index: number; item: T; row: T[]; rowIndex: number; }) => ReactNode",
                             required: true,
+                            description: "Renders one item's card; each result is wrapped in a `CardGridItem`. `index` is the position within its row.",
                         },
                         {
                             name: "rows",
                             type: "T[][]",
                             required: true,
+                            description: "Items already chunked into rows, e.g. with `chunkIntoRows`; one `CardGrid` is rendered per row.",
                         },
                     ],
                 },
@@ -14032,11 +14326,13 @@ export const docsManifest = {
                             name: "loading",
                             type: "boolean",
                             required: false,
+                            description: "Set while the application fetches rows. The body shows placeholder rows or\na spinner per `loadingMode`, and the select-all checkbox and\n`DataGridColumnHeader` buttons are disabled.",
                         },
                         {
                             name: "loadingMessage",
                             type: "ReactNode",
                             required: false,
+                            description: 'Text beside the spinner while loading; only shown when `loadingMode` is `"spinner"`. Defaults to "Loading...".',
                         },
                         {
                             name: "loadingMode",
@@ -14112,6 +14408,8 @@ export const docsManifest = {
                             name: "size",
                             type: "DataGridControlSize",
                             required: false,
+                            defaultValue: '"xs"',
+                            description: "Checkbox size; the grid only uses the two compact steps.",
                         },
                     ],
                 },
@@ -14151,6 +14449,7 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The TanStack row to expand or collapse. The toggle renders nothing unless `row.getCanExpand()` is true.",
                         },
                     ],
                 },
@@ -14172,6 +14471,7 @@ export const docsManifest = {
                             name: "column",
                             type: "Column<TData, TValue>",
                             required: true,
+                            description: "The TanStack column this header sorts and filters.",
                         },
                         {
                             name: "options",
@@ -14228,11 +14528,13 @@ export const docsManifest = {
                             name: "loading",
                             type: "boolean",
                             required: false,
+                            description: "Set while the application fetches rows. The body shows placeholder rows or\na spinner per `loadingMode`, and the select-all checkbox and\n`DataGridColumnHeader` buttons are disabled.",
                         },
                         {
                             name: "loadingMessage",
                             type: "ReactNode",
                             required: false,
+                            description: 'Text beside the spinner while loading; only shown when `loadingMode` is `"spinner"`. Defaults to "Loading...".',
                         },
                         {
                             name: "loadingMode",
@@ -14294,11 +14596,13 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Disable the checkbox; `createSelectionColumn` sets it when the row cannot be selected.",
                         },
                         {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The TanStack row this checkbox selects.",
                         },
                     ],
                 },
@@ -14310,11 +14614,13 @@ export const docsManifest = {
                             name: "disabled",
                             type: "boolean",
                             required: false,
+                            description: "Disable the checkbox, e.g. while loading or when the page has no rows.",
                         },
                         {
                             name: "table",
                             type: "Table<TData>",
                             required: true,
+                            description: "The TanStack table whose current-page rows this checkbox selects.",
                         },
                     ],
                 },
@@ -14536,11 +14842,13 @@ export const docsManifest = {
                             name: "icon",
                             type: "ReactNode",
                             required: false,
+                            description: "Leading glyph shown before the title.",
                         },
                         {
                             name: "pinnable",
                             type: "boolean",
                             required: false,
+                            description: "Not read by the header. Pinning is controlled by `tableLayout.columnsPinnable`\non `DataGrid` and the column's own `enablePinning`.",
                         },
                         {
                             name: "title",
@@ -14755,21 +15063,25 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: 'The TanStack row to render; its selection state sets `data-state="selected"` and its original data goes to `onRowClick`.',
                         },
                         {
                             name: "dndRef",
                             type: "React.Ref<HTMLTableRowElement>",
                             required: false,
+                            description: "Ref attached to the `<tr>`; the virtualiser passes its row-measuring ref here, a drag library can pass its node ref.",
                         },
                         {
                             name: "dndStyle",
                             type: "React.CSSProperties",
                             required: false,
+                            description: "Inline style merged over the row height, e.g. a drag library's transform.",
                         },
                         {
                             name: "dataIndex",
                             type: "number",
                             required: false,
+                            description: "Row position in the full row model, written to `data-index` so the virtualiser can find the row when measuring.",
                         },
                     ],
                 },
@@ -14786,16 +15098,19 @@ export const docsManifest = {
                             name: "cell",
                             type: "Cell<TData>",
                             required: true,
+                            description: "The TanStack cell to render; its column sets pinning, edge and `meta.cellClassName` styling.",
                         },
                         {
                             name: "dndRef",
                             type: "React.Ref<HTMLTableCellElement>",
                             required: false,
+                            description: "Ref attached to the `<td>`, for a drag library's node ref.",
                         },
                         {
                             name: "dndStyle",
                             type: "React.CSSProperties",
                             required: false,
+                            description: "Inline style merged over the pinning styles, e.g. a drag library's transform.",
                         },
                     ],
                 },
@@ -14807,6 +15122,7 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The expanded row; its `original` data is passed to the first column's `meta.expandedContent`.",
                         },
                     ],
                 },
@@ -14834,6 +15150,7 @@ export const docsManifest = {
                             name: "column",
                             type: "Column<TData>",
                             required: true,
+                            description: "The column this placeholder cell sits in; supplies pinning, edge and `meta.cellClassName` styling.",
                         },
                     ],
                 },
@@ -14866,6 +15183,7 @@ export const docsManifest = {
                             name: "headerGroup",
                             type: "HeaderGroup<TData>",
                             required: true,
+                            description: "The TanStack header group this row renders; it supplies the row's React key.",
                         },
                     ],
                 },
@@ -14882,16 +15200,19 @@ export const docsManifest = {
                             name: "header",
                             type: "Header<TData>",
                             required: true,
+                            description: "The TanStack header this `<th>` renders; its column sets size, pinning and `meta.headerClassName`.",
                         },
                         {
                             name: "dndRef",
                             type: "React.Ref<HTMLTableCellElement>",
                             required: false,
+                            description: "Ref attached to the `<th>`, for a drag library's node ref.",
                         },
                         {
                             name: "dndStyle",
                             type: "React.CSSProperties",
                             required: false,
+                            description: "Inline style merged over width and pinning styles, e.g. a drag library's transform.",
                         },
                     ],
                 },
@@ -14903,6 +15224,7 @@ export const docsManifest = {
                             name: "header",
                             type: "Header<TData>",
                             required: true,
+                            description: "The header whose column this handle resizes.",
                         },
                     ],
                 },
@@ -14919,11 +15241,13 @@ export const docsManifest = {
                             name: "row",
                             type: "Row<TData>",
                             required: true,
+                            description: "The TanStack row this checkbox selects.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: 'Mirrors the table\'s size: `"2xs"` and `"xs"` (or omitted) give the `"xs"` checkbox, anything larger the `"sm"` one.',
                         },
                     ],
                 },
@@ -14935,6 +15259,7 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            description: 'Mirrors the table\'s size: `"2xs"` and `"xs"` (or omitted) give the `"xs"` checkbox, anything larger the `"sm"` one.',
                         },
                     ],
                 },
@@ -15085,6 +15410,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"divided" | "separated" | "grouped" | null | undefined',
                             required: false,
+                            defaultValue: '"grouped"',
+                            description: 'Container treatment: `"grouped"` is one bordered, rounded card with the rows inside, `"divided"` separates rows with hairlines and no frame, `"separated"` leaves a gap between rows so each can carry its own surface.',
                         },
                     ],
                 },
@@ -15135,6 +15462,7 @@ export const docsManifest = {
                             name: "icon",
                             type: "LucideIcon | React.ComponentType<React.SVGProps<SVGSVGElement>>",
                             required: true,
+                            description: "Icon component (a Lucide icon), not a rendered element; sized from the list's `size`.",
                         },
                     ],
                 },
@@ -15296,11 +15624,13 @@ export const docsManifest = {
                             name: "subtitle",
                             type: "string",
                             required: false,
+                            description: "Small muted line above the title, such as a category or date. Omitted when empty.",
                         },
                         {
                             name: "title",
                             type: "string",
                             required: true,
+                            description: "Main line, shown larger and medium weight.",
                         },
                     ],
                 },
@@ -15517,6 +15847,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "sm" | "lg" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Scale of the whole empty state: the title, description and icon sizes, the gaps, and the vertical padding in the `card` layouts.",
                         },
                     ],
                 },
@@ -15611,6 +15943,8 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "sm" | "lg" | null | undefined',
                             required: false,
+                            defaultValue: '"base"',
+                            description: "Scale of the whole empty state: the title, description and icon sizes, the gaps, and the vertical padding in the `card` layouts.",
                         },
                     ],
                 },
@@ -15706,16 +16040,19 @@ export const docsManifest = {
                             name: "onDragLeave",
                             type: "(e: DragEvent<HTMLElement>) => void",
                             required: false,
+                            description: "Fires when a drag leaves the zone; pass `handleDragLeave` to clear the drag state.",
                         },
                         {
                             name: "onDragOver",
                             type: "(e: DragEvent<HTMLElement>) => void",
                             required: false,
+                            description: "Fires continuously while a drag is over the zone; pass `handleDragOver`, which cancels the default so the zone accepts a drop.",
                         },
                         {
                             name: "onDrop",
                             type: "(e: DragEvent<HTMLElement>) => void",
                             required: false,
+                            description: "Fires when files are dropped; pass `handleDrop` to validate and add them.",
                         },
                         {
                             name: "ref",
@@ -15905,11 +16242,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -15935,6 +16276,8 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "icon",
@@ -15946,26 +16289,35 @@ export const docsManifest = {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -16118,6 +16470,7 @@ export const docsManifest = {
                             name: "selected",
                             type: "boolean",
                             required: false,
+                            description: 'Marks the folder as chosen: selected styling and `aria-pressed="true"`. Has no effect while `showSelectedState` is false.',
                         },
                         {
                             name: "showSelectedState",
@@ -16135,6 +16488,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid` on the outer wrapper (not the button), for Playwright targeting.",
                         },
                     ],
                 },
@@ -16255,6 +16609,7 @@ export const docsManifest = {
                             name: "positionerClassName",
                             type: "string",
                             required: false,
+                            description: "Classes for the positioning layer around the content, such as a lower `z-*` for a panel that sits beneath fixed chrome. Defaults to `z-50`.",
                         },
                     ],
                 },
@@ -16501,11 +16856,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -16531,31 +16890,42 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -16725,6 +17095,7 @@ export const docsManifest = {
                             name: "displayName",
                             type: "string",
                             required: true,
+                            description: "The user's name, shown in medium weight; also the avatar image's alt text.",
                         },
                         {
                             name: "email",
@@ -16918,36 +17289,50 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
@@ -17035,6 +17420,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -17113,6 +17499,7 @@ export const docsManifest = {
                             name: "onClose",
                             type: "() => void",
                             required: true,
+                            description: "Called when the close button is pressed; set your open state to false here.",
                         },
                     ],
                 },
@@ -17124,36 +17511,50 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
@@ -17241,6 +17642,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -17299,11 +17701,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -17323,31 +17729,42 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "expandable",
@@ -17492,11 +17909,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -17515,6 +17936,8 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "icon",
@@ -17526,26 +17949,35 @@ export const docsManifest = {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -17624,6 +18056,7 @@ export const docsManifest = {
                             name: "label",
                             type: "React.ReactNode",
                             required: true,
+                            description: "Project name; truncates to one line.",
                         },
                         {
                             name: "onAction",
@@ -17635,6 +18068,7 @@ export const docsManifest = {
                             name: "actionIcon",
                             type: 'import("../../tokens/icon-component").IconComponent',
                             required: true,
+                            description: "Icon for the trailing action button, such as an ellipsis for project options.",
                         },
                         {
                             name: "actionLabel",
@@ -17668,6 +18102,7 @@ export const docsManifest = {
                             name: "onClose",
                             type: "() => void",
                             required: false,
+                            description: "Called when Escape is pressed. The overlay never unmounts itself, so set your open state to false here.",
                         },
                     ],
                 },
@@ -18110,6 +18545,7 @@ export const docsManifest = {
                             type: "string",
                             required: false,
                             defaultValue: '"Clear all"',
+                            description: "Text of the button that calls `onClear`.",
                         },
                         {
                             name: "separator",
@@ -18212,6 +18648,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"default" | "secondary" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "How a pressed toggle shows it is on: `default` greys the fill and border, `secondary` darkens the border only. Inside a `ToggleGroup` the group's value wins.",
                         },
                         {
                             name: "size",
@@ -18332,6 +18770,8 @@ export const docsManifest = {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -18357,26 +18797,35 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -18466,16 +18915,19 @@ export const docsManifest = {
                             name: "onDirectionChange",
                             type: "(direction: PageToolbarSortDirection) => void",
                             required: false,
+                            description: 'Called with `"asc"` or `"desc"` when the user picks a direction. The Ascending and Descending choices only appear when both this and `direction` are set.',
                         },
                         {
                             name: "onValueChange",
                             type: "(value: string) => void",
                             required: true,
+                            description: "Called with the chosen option's `value` when the user picks an order.",
                         },
                         {
                             name: "options",
                             type: "readonly PageToolbarSortOption[]",
                             required: true,
+                            description: "The orders to offer, each a `value` and a `label`; the label of the current one shows on the button.",
                         },
                         {
                             name: "value",
@@ -18712,6 +19164,7 @@ export const docsManifest = {
                             name: "product",
                             type: "ProductCardProduct",
                             required: true,
+                            description: 'The material to show. In `"group"` mode its `variants` become the colourway\nswatches (the card falls back to the product itself when there are none),\nand `images[0]` of the selected variant is the photograph. A product whose\nselected variant has no images renders a "no photography" placeholder.',
                         },
                         {
                             name: "productUrl",
@@ -18753,13 +19206,13 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
-                            description: "Override image URL - used for visual search to show the matched image",
+                            description: 'Image URL shown in place of the product\'s own first image, e.g. the\nmatched crop in a visual search. Honoured in `"single"` and `"swatch"`\nmodes only.',
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
-                            description: 'Prioritise loading images (sets loading="eager" and adds preload link)',
+                            description: 'Load the main image eagerly (`loading="eager"`, high fetch priority in the\ndefault renderer, and forwarded to `renderImage`). Set it on above-the-fold\ncards, not the whole grid.',
                         },
                         {
                             name: "productBrandLines",
@@ -18771,21 +19224,29 @@ export const docsManifest = {
                             name: "productNameLines",
                             type: "1 | 2 | undefined",
                             required: false,
+                            defaultValue: "1",
+                            description: "How many lines the product name may take before it clamps. Choose `2`\nwhere names differ only at the end; rows stay level because the clamp is\na maximum, not a reserved height.",
                         },
                         {
                             name: "showAddToCart",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the cart control. It only ever appears when `renderAddToCart` is also\nsupplied, and `primaryAction` can replace it with another action.",
                         },
                         {
                             name: "showProductBrand",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the brand name above the product name. Cards without a brand name\nomit the line either way.",
                         },
                         {
                             name: "showProductName",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the product name.",
                         },
                         {
                             name: "showSwatches",
@@ -18798,6 +19259,7 @@ export const docsManifest = {
                             name: "similarityScore",
                             type: "number | undefined",
                             required: false,
+                            description: 'Visual-search match from `0` to `1` (not a percentage), shown as a\nrounded percentage pill over the image: `0.87` reads `87%`. Only\n`"single"` and `"inspiration"` modes show it; omit it for no pill.',
                         },
                     ],
                 },
@@ -18979,13 +19441,13 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
-                            description: "Override image URL - used for visual search to show the matched image",
+                            description: 'Image URL shown in place of the product\'s own first image, e.g. the\nmatched crop in a visual search. Honoured in `"single"` and `"swatch"`\nmodes only.',
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
-                            description: 'Prioritise loading images (sets loading="eager" and adds preload link)',
+                            description: 'Load the main image eagerly (`loading="eager"`, high fetch priority in the\ndefault renderer, and forwarded to `renderImage`). Set it on above-the-fold\ncards, not the whole grid.',
                         },
                         {
                             name: "productBrandLines",
@@ -18997,31 +19459,41 @@ export const docsManifest = {
                             name: "productNameLines",
                             type: "1 | 2 | undefined",
                             required: false,
+                            defaultValue: "1",
+                            description: "How many lines the product name may take before it clamps. Choose `2`\nwhere names differ only at the end; rows stay level because the clamp is\na maximum, not a reserved height.",
                         },
                         {
                             name: "showAddToCart",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the cart control. It only ever appears when `renderAddToCart` is also\nsupplied, and `primaryAction` can replace it with another action.",
                         },
                         {
                             name: "showProductBrand",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the brand name above the product name. Cards without a brand name\nomit the line either way.",
                         },
                         {
                             name: "showProductName",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Show the product name.",
                         },
                         {
                             name: "similarityScore",
                             type: "number | undefined",
                             required: false,
+                            description: 'Visual-search match from `0` to `1` (not a percentage), shown as a\nrounded percentage pill over the image: `0.87` reads `87%`. Only\n`"single"` and `"inspiration"` modes show it; omit it for no pill.',
                         },
                         {
                             name: "onAddToCartSuccess",
                             type: "(() => void) | undefined",
                             required: false,
+                            description: "Called when the `renderAddToCart` slot reports a successful add, via the `onAdded` it receives.",
                         },
                     ],
                 },
@@ -19085,23 +19557,26 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
-                            description: "Override image URL - used for visual search to show the matched image",
+                            description: "Image URL shown in place of the variant's first image, e.g. the matched crop in a visual search.",
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
-                            description: 'Prioritise loading this image (sets loading="eager" and adds preload link)',
+                            description: 'Load this image eagerly (`loading="eager"`, high fetch priority in the default renderer); forwarded to `renderImage`.',
                         },
                         {
                             name: "showSimilarityScore",
                             type: "boolean | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: 'Show the `similarityScore` pill. Needs `similarityScore` too, and is\nignored outside `"single"` and `"inspiration"` modes.',
                         },
                         {
                             name: "similarityScore",
                             type: "number | undefined",
                             required: false,
+                            description: "Match from `0` to `1`, shown as a rounded percentage (`0.87` reads `87%`).",
                         },
                     ],
                 },
@@ -19227,6 +19702,7 @@ export const docsManifest = {
                             name: "display",
                             type: "ProductCardDisplayOptions | undefined",
                             required: false,
+                            description: "Which parts of the card show: brand, name, line clamps, swatches, add to\ncart. `ProductCard` takes the same switches as flat props (`showProductBrand`\nand so on) and builds this for you; pass `display` only when using\n`ProductCardProvider` directly. Each key falls back to its own default.",
                         },
                         {
                             name: "dragAdapter",
@@ -19349,6 +19825,7 @@ export const docsManifest = {
                             name: "product",
                             type: "ProductCardProduct",
                             required: true,
+                            description: 'The material to show. In `"group"` mode its `variants` become the colourway\nswatches (the card falls back to the product itself when there are none),\nand `images[0]` of the selected variant is the photograph. A product whose\nselected variant has no images renders a "no photography" placeholder.',
                         },
                         {
                             name: "productUrl",
@@ -19540,11 +20017,13 @@ export const docsManifest = {
                             name: "overrideImageUrl",
                             type: "string | undefined",
                             required: false,
+                            description: "Image URL shown in place of the variant's first image.",
                         },
                         {
                             name: "priority",
                             type: "boolean | undefined",
                             required: false,
+                            description: "Load the tile's image eagerly; forwarded to `renderImage`.",
                         },
                     ],
                 },
@@ -19625,6 +20104,8 @@ export const docsManifest = {
                             name: "active",
                             type: "boolean",
                             required: false,
+                            defaultValue: "true",
+                            description: "Whether the `renderTools` buttons are mounted. `ProductCard` sets it while\nthe pointer or keyboard focus is inside the card, so a large grid does not\nrender every hidden action.",
                         },
                         {
                             name: "className",
@@ -19657,10 +20138,17 @@ export const docsManifest = {
             bestPractices: [
                 "In Next.js apps pass `renderImage` wrapping `next/image` and\n`linkAs={Link}` - the defaults are a plain `<img>` and `<a>`.",
                 "Cart UI renders only when a `renderAddToCart` slot is\nprovided; keep `dragAdapter` referentially stable (module-level constant).",
+                "Use ProductCard for a material in a grid or list; its image is square, which is how a material is always shown. Don't rebuild the card with a landscape image.",
                 "Pass `renderImage` wrapping `next/image` in Next.js apps -\nthe default renderer is a plain `<img>` and skips Next's optimisation.",
                 "Keep `dragAdapter` referentially stable (a module-level\nconstant) - an inline factory remounts the image subtree and drops the\ndrag ref mid-drag.",
             ],
-            keywords: [],
+            keywords: [
+                "material card",
+                "material tile",
+                "sample card",
+                "catalogue card",
+                "product tile",
+            ],
             uses: [
                 "badge",
                 "box",
@@ -19698,11 +20186,13 @@ export const docsManifest = {
                             name: "filters",
                             type: "Record<string, string | null>",
                             required: true,
+                            description: 'The current selection, keyed by filter key (`"color"` for `colorName`, otherwise the\ndimension name such as `"finish"`) to the selected option\'s `value`, or `null` for none.',
                         },
                         {
                             name: "onFilterChange",
                             type: "(key: string, value: string | null) => void",
                             required: true,
+                            description: "Called when an option is picked, with the filter key and the option's `value`;\npicking the selected option again sends `null` to clear it. When `onSiblingSelect` and\n`siblingsWithAttributes` find a matching sibling, that fires instead.",
                         },
                         {
                             name: "onSiblingSelect",
@@ -19738,6 +20228,7 @@ export const docsManifest = {
                             name: "variantOptions",
                             type: 'Partial<Record<"pattern" | "length" | "width" | "size" | "colorName" | "finish" | "substrate" | "finishType", import("./product-specifications-types").VariantOption[]>>',
                             required: true,
+                            description: "The options on offer per dimension (`colorName`, `pattern`, `finish`, `size`, `width`,\n`length`, `substrate`, `finishType`). Each present dimension becomes one field, ordered\nwith colourways first; an option with `available: false` is shown as unavailable.",
                         },
                     ],
                 },
@@ -19771,6 +20262,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                     ],
                 },
@@ -20626,6 +21118,8 @@ export const docsManifest = {
                             name: "border",
                             type: "BorderStyle",
                             required: false,
+                            defaultValue: '"none"',
+                            description: "Outline: `none` draws no border, `solid` a 1px border, `dashed` a faint dashed one for placeholder or drop areas.",
                         },
                         {
                             name: "inset",
@@ -20651,11 +21145,14 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "variant",
                             type: '"muted" | "ghost" | "accent" | "card" | null | undefined',
                             required: false,
+                            defaultValue: '"card"',
+                            description: "Surface: `card` is the standard card fill, `muted` and `accent` are tinted fills, `ghost` has no fill or shadow.",
                         },
                     ],
                 },
@@ -20915,43 +21412,57 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "size",
                             type: "ButtonSizeProp",
                             required: false,
                             defaultValue: '"base"',
-                            description: 'Size token; `icon-*` variants produce a square icon-only button. Also\naccepts a responsive object keyed by viewport breakpoints and/or `@`-prefixed\ncontainer queries - e.g. `{ base: "sm", md: "base", "@sm": "lg" }`.',
+                            description: 'Size token; `icon-*` variants produce a square icon-only button. Also\naccepts a responsive object keyed by viewport breakpoints and/or `@`-prefixed\ncontainer queries - e.g. `{ base: "sm", md: "base", "@sm": "lg" }`.\nSize token, as on Button.',
                         },
                         {
                             name: "render",
@@ -21032,6 +21543,7 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "showWhenCollapsed",
@@ -21064,11 +21576,14 @@ export const docsManifest = {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"rounded"',
+                            description: "Corner shape: `rounded` is the standard 8px radius, `square` has sharp corners, `full` is a pill.",
                         },
                         {
                             name: "size",
@@ -21197,16 +21712,21 @@ export const docsManifest = {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl"',
                             required: false,
+                            defaultValue: '"base"',
+                            description: 'Row height and text size. Use `"xl"` in an icon-collapsible sidebar so the collapsed square centres on the rail.',
                         },
                         {
                             name: "variant",
                             type: '"input" | "default" | "outline"',
                             required: false,
+                            defaultValue: '"input"',
+                            description: 'Surface treatment: `"input"` uses the sidebar\'s accent fill on hover and when active, `"default"` the standard accent tint, `"outline"` adds a ring.',
                         },
                         {
                             name: "icon",
                             type: "IconComponent",
                             required: false,
+                            description: "Leading icon component. When the sidebar collapses to the rail it is the only thing shown, unless `collapsedIcon` or `collapsedContent` replaces it.",
                         },
                         {
                             name: "collapsedIcon",
@@ -21224,6 +21744,7 @@ export const docsManifest = {
                             name: "suffixIcon",
                             type: "IconComponent",
                             required: false,
+                            description: "Trailing icon component, such as a chevron for a submenu. Replaces the `kbd` hint when both are set, and hides when the sidebar collapses.",
                         },
                         {
                             name: "forceExpanded",
@@ -21235,6 +21756,7 @@ export const docsManifest = {
                             name: "kbd",
                             type: "string[]",
                             required: false,
+                            description: 'Keyboard shortcut keys shown as keycaps at the end of the row, one string per key (e.g. `["⌘", "K"]`). Hidden when collapsed or when `suffixIcon` is set.',
                         },
                         {
                             name: "children",
@@ -21311,6 +21833,8 @@ export const docsManifest = {
                             name: "variant",
                             type: '"input" | "default" | "outline" | null | undefined',
                             required: false,
+                            defaultValue: '"default"',
+                            description: "Surface treatment: `default` tints on hover, `input` uses the input fill, `outline` adds a ring.\nRow style, as on MenuItem.",
                         },
                         {
                             name: "indicator",
@@ -21322,21 +21846,29 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "`danger` marks a destructive action with red text and a red hover and active tint.",
                         },
                         {
                             name: "inset",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Pads the start so a row with no leading glyph lines up with rows that have an icon, dot or avatar. Switched on automatically when `indicator` is set.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill, `rounded` a soft rectangle, `square` has sharp corners.",
                         },
                         {
                             name: "size",
                             type: '"base" | "2xs" | "xs" | "sm" | "lg" | "xl" | "2xl" | "3xl" | null | undefined',
                             required: false,
+                            defaultValue: '"sm"',
+                            description: "Row height, padding and text size, on the shared component scale. Match the surrounding menu's `size`.\nRow size, as on MenuItem.",
                         },
                         {
                             name: "loading",
@@ -21592,11 +22124,15 @@ export const docsManifest = {
                             name: "tone",
                             type: '"neutral" | "brand" | "danger" | null | undefined',
                             required: false,
+                            defaultValue: '"neutral"',
+                            description: "Semantic colour: `brand` for the primary action, `danger` for a destructive one.",
                         },
                         {
                             name: "radius",
                             type: '"rounded" | "square" | "full" | null | undefined',
                             required: false,
+                            defaultValue: '"full"',
+                            description: "Corner shape: `full` is a pill (or circle when square), `rounded` a soft corner, `square` sharp.",
                         },
                         {
                             name: "size",
@@ -21622,31 +22158,42 @@ export const docsManifest = {
                             name: "square",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Lock width to height so an `icon-*` size draws a square or circle; ignored with `expandable`.",
                         },
                         {
                             name: "emphasis",
                             type: '"link" | "outline" | "solid" | "ghost" | "soft" | "transparent" | null | undefined',
                             required: false,
+                            defaultValue: '"solid"',
+                            description: "Visual weight, paired with `tone`: `solid` and `soft` are filled, `outline` and `ghost` lighter, `transparent` a blurred translucent fill, `link` plain text.\nVisual weight, as on Button.",
                         },
                         {
                             name: "asInput",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "false",
+                            description: "Style the button as a form field (input background and border), for a trigger that opens a picker.",
                         },
                         {
                             name: "align",
                             type: '"center" | "end" | "start" | null | undefined',
                             required: false,
+                            defaultValue: '"center"',
+                            description: "Where the content sits along the button; `start` or `end` only shows on a button wider than its content.",
                         },
                         {
                             name: "pressed",
                             type: "boolean | null | undefined",
                             required: false,
+                            defaultValue: "true",
+                            description: "Shrink slightly while held down (`:active`); `false` keeps the button still.",
                         },
                         {
                             name: "testId",
                             type: "string",
                             required: false,
+                            description: "Rendered as `data-testid`, for Playwright selectors.",
                         },
                         {
                             name: "suffixIcon",
@@ -22891,6 +23438,7 @@ export const docsManifest = {
                             name: "image",
                             type: "ReactNode",
                             required: false,
+                            description: "Picture shown inside the tile, such as an `<img>` of the variant; omit it for a plain `color` tile.",
                         },
                         {
                             name: "label",