@assure-one/design-system 1.35.0 → 1.36.0

package/dist/index.d.ts

@@ -1,21 +1,23 @@
-export { C as ColorName, R as ReferenceTokens, S as SystemTokens, c as colors, r as radii, a as reference, s as shadows, d as spacing, e as surfaces, f as systemTokens, t as typography } from './system-lyhOUTpa.js';
+export { C as ColorName, R as ReferenceTokens, S as SystemTokens, c as colors, r as radii, a as reference, s as shadows, b as spacing, d as surfaces, e as systemTokens, t as typography } from './system-BDU18fVg.js';
 import * as React$1 from 'react';
-import { ReactNode, CSSProperties } from 'react';
+import { ReactNode, InputHTMLAttributes, HTMLAttributes, RefCallback, ReactElement, FieldsetHTMLAttributes, CSSProperties } from 'react';
 import * as AccordionPrimitive from '@radix-ui/react-accordion';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
+import { V as Variant, I as Intent, C as ControlSize, S as Shape } from './index-CQwzTm0v.js';
+export { A as AlertCircleIcon, a as AlertTriangleIcon, b as AlertTriangleSolidIcon, c as ArchiveIcon, d as ArrowDownIcon, e as ArrowLeftIcon, f as ArrowRightIcon, g as ArrowRightSmallIcon, h as ArrowUpIcon, i as AtSignIcon, B as BarChartIcon, j as BellIcon, k as BoldIcon, l as BrainIcon, m as BriefcaseIcon, n as Building2Icon, o as BuildingIcon, p as CalendarIcon, q as ChatBubbleIcon, r as CheckCircle2Icon, s as CheckCircleSolidIcon, t as CheckIcon, u as ChevronDownIcon, v as ChevronLeftIcon, w as ChevronRightIcon, x as ChevronUpIcon, y as ChevronsDownUpIcon, z as ChevronsUpDownIcon, D as CircleDotIcon, E as CircleIcon, F as ClipboardCheckIcon, G as ClockIcon, H as CloseIcon, J as CommandIcon, K as CopyIcon, L as CornerDownLeftIcon, M as CreditCardIcon, N as DocumentIcon, O as DollarSignIcon, P as DownloadIcon, Q as ExternalLinkIcon, R as ExtractIcon, T as EyeIcon, U as EyeOffIcon, W as FileIcon, X as FileReturnIcon, Y as FileTextIcon, Z as FilterIcon, _ as FlagIcon, $ as FolderClosedIcon, a0 as FolderOpenIcon, a1 as FolderPlusIcon, a2 as FolderUpIcon, a3 as GlobeIcon, a4 as GoogleBrandIcon, a5 as GripVerticalIcon, a6 as HelpCircleIcon, a7 as HistoryIcon, a8 as HomeIcon, a9 as IconComponent, aa as IconDefinition, ab as IconProps, ac as IconSize, ad as InboxIcon, ae as InfoCircleSolidIcon, af as InfoIcon, ag as ItalicIcon, ah as KanbanIcon, ai as KeyIcon, aj as LandmarkIcon, ak as LayersIcon, al as LayoutDashboardIcon, am as LayoutGridIcon, an as LayoutListIcon, ao as LightningIcon, ap as Link2Icon, aq as LinkIcon, ar as ListChecksIcon, as as ListIcon, at as ListOrderedIcon, au as LoaderIcon, av as LockIcon, aw as LockKeyholeIcon, ax as LockOpenIcon, ay as LogOutIcon, az as MailIcon, aA as MapPinIcon, aB as MaximizeIcon, aC as MenuIcon, aD as MessageCircleIcon, aE as MessageCircleWarningIcon, aF as MicIcon, aG as MicrosoftBrandIcon, aH as MinimizeIcon, aI as MinusIcon, aJ as MonitorIcon, aK as MoonIcon, aL as MoreHorizontalIcon, aM as MoveIcon, aN as PaletteIcon, aO as PanelLeftCloseIcon, aP as PanelLeftIcon, aQ as PanelRightIcon, aR as PaperclipIcon, aS as PauseIcon, aT as PenSignIcon, aU as PenToolIcon, aV as PencilIcon, aW as PhoneIcon, aX as PlayIcon, aY as PlusIcon, aZ as ReceiptIcon, a_ as RefreshCwIcon, a$ as ReplyIcon, b0 as RotateCcwIcon, b1 as SaveIcon, b2 as SearchIcon, b3 as SendIcon, b4 as SettingsIcon, b5 as ShieldIcon, b6 as SigmaIcon, b7 as SlashIcon, b8 as SmartphoneIcon, b9 as SparkleIcon, ba as SparklesIcon, bb as StarIcon, bc as StopIcon, bd as StrikethroughIcon, be as SunIcon, bf as TableIcon, bg as TagIcon, bh as TeamIcon, bi as ThumbsDownIcon, bj as ThumbsUpIcon, bk as TimerIcon, bl as Trash2Icon, bm as TrashIcon, bn as TrashSolidIcon, bo as TrendingDownIcon, bp as TrendingUpIcon, bq as UnderlineIcon, br as UploadIcon, bs as UserCircleIcon, bt as UserIcon, bu as UsersIcon, bv as VideoIcon, bw as Volume2Icon, bx as VolumeXIcon, by as WorkflowIcon, bz as XCircleSolidIcon, bA as XIcon, bB as ZoomInIcon, bC as ZoomOutIcon, bD as createIcon } from './index-CQwzTm0v.js';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
 import * as AvatarPrimitive from '@radix-ui/react-avatar';
-import { V as Variant, I as Intent, C as ControlSize, S as Shape } from './index-B3OiMlQv.js';
-export { A as AlertCircleIcon, a as AlertTriangleIcon, b as AlertTriangleSolidIcon, c as ArchiveIcon, d as ArrowDownIcon, e as ArrowLeftIcon, f as ArrowRightIcon, g as ArrowRightSmallIcon, h as ArrowUpIcon, i as AtSignIcon, B as BarChartIcon, j as BellIcon, k as BoldIcon, l as BrainIcon, m as BriefcaseIcon, n as Building2Icon, o as BuildingIcon, p as CalendarIcon, q as ChatBubbleIcon, r as CheckCircle2Icon, s as CheckCircleSolidIcon, t as CheckIcon, u as ChevronDownIcon, v as ChevronLeftIcon, w as ChevronRightIcon, x as ChevronUpIcon, y as ChevronsDownUpIcon, z as ChevronsUpDownIcon, D as CircleDotIcon, E as CircleIcon, F as ClipboardCheckIcon, G as ClockIcon, H as CloseIcon, J as CommandIcon, K as CopyIcon, L as CornerDownLeftIcon, M as CreditCardIcon, N as DocumentIcon, O as DollarSignIcon, P as DownloadIcon, Q as ExternalLinkIcon, R as ExtractIcon, T as EyeIcon, U as EyeOffIcon, W as FileIcon, X as FileReturnIcon, Y as FileTextIcon, Z as FilterIcon, _ as FlagIcon, $ as FolderClosedIcon, a0 as FolderOpenIcon, a1 as FolderPlusIcon, a2 as FolderUpIcon, a3 as GlobeIcon, a4 as GoogleBrandIcon, a5 as GripVerticalIcon, a6 as HelpCircleIcon, a7 as HistoryIcon, a8 as HomeIcon, a9 as IconComponent, aa as IconDefinition, ab as IconProps, ac as IconSize, ad as InboxIcon, ae as InfoCircleSolidIcon, af as InfoIcon, ag as ItalicIcon, ah as KanbanIcon, ai as KeyIcon, aj as LandmarkIcon, ak as LayersIcon, al as LayoutDashboardIcon, am as LayoutGridIcon, an as LayoutListIcon, ao as LightningIcon, ap as Link2Icon, aq as LinkIcon, ar as ListChecksIcon, as as ListIcon, at as ListOrderedIcon, au as LoaderIcon, av as LockIcon, aw as LockKeyholeIcon, ax as LockOpenIcon, ay as LogOutIcon, az as MailIcon, aA as MapPinIcon, aB as MaximizeIcon, aC as MenuIcon, aD as MessageCircleIcon, aE as MessageCircleWarningIcon, aF as MicIcon, aG as MicrosoftBrandIcon, aH as MinimizeIcon, aI as MinusIcon, aJ as MonitorIcon, aK as MoonIcon, aL as MoreHorizontalIcon, aM as MoveIcon, aN as PaletteIcon, aO as PanelLeftCloseIcon, aP as PanelLeftIcon, aQ as PanelRightIcon, aR as PaperclipIcon, aS as PauseIcon, aT as PenSignIcon, aU as PenToolIcon, aV as PencilIcon, aW as PhoneIcon, aX as PlayIcon, aY as PlusIcon, aZ as ReceiptIcon, a_ as RefreshCwIcon, a$ as ReplyIcon, b0 as RotateCcwIcon, b1 as SaveIcon, b2 as SearchIcon, b3 as SendIcon, b4 as SettingsIcon, b5 as ShieldIcon, b6 as SigmaIcon, b7 as SlashIcon, b8 as SmartphoneIcon, b9 as SparkleIcon, ba as SparklesIcon, bb as StarIcon, bc as StopIcon, bd as StrikethroughIcon, be as SunIcon, bf as TableIcon, bg as TagIcon, bh as TeamIcon, bi as ThumbsDownIcon, bj as ThumbsUpIcon, bk as TimerIcon, bl as Trash2Icon, bm as TrashIcon, bn as TrashSolidIcon, bo as TrendingDownIcon, bp as TrendingUpIcon, bq as UnderlineIcon, br as UploadIcon, bs as UserCircleIcon, bt as UserIcon, bu as UsersIcon, bv as VideoIcon, bw as Volume2Icon, bx as VolumeXIcon, by as WorkflowIcon, bz as XCircleSolidIcon, bA as XIcon, bB as ZoomInIcon, bC as ZoomOutIcon, bD as createIcon } from './index-B3OiMlQv.js';
 import { DayPickerProps } from 'react-day-picker';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
 import * as ContextMenuPrimitive from '@radix-ui/react-context-menu';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
+import { F as FileUploadMessages, S as SearchInputMessages, a as SelectMessages, b as FieldMessages, C as ComboboxMessages } from './design-system-provider-cPUklDJv.js';
+export { c as DesignSystemProvider, D as DesignSystemProviderProps, d as DsDirection, e as DsMessageNamespace, f as DsMessages, g as DsMessagesOverride, I as ImageComponent, h as ImageComponentProps, L as LinkComponent, i as LinkComponentProps, T as TooltipDefaults, u as useDsMessages } from './design-system-provider-cPUklDJv.js';
 import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
@@ -31,6 +33,7 @@ import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
 import * as VisuallyHiddenPrimitive from '@radix-ui/react-visually-hidden';
 import { ClassValue } from 'clsx';
+import { BrandTheme } from './tokens/index.js';
 
 type AccordionProps = React$1.ComponentPropsWithoutRef<typeof AccordionPrimitive.Root>;
 declare const Accordion: React$1.ForwardRefExoticComponent<AccordionProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -91,19 +94,20 @@ type BadgeSlot = "root" | "dot" | "icon";
  * `className` lands on (`C-INPUT-CLASSNAME`). The wrappers around it are
  * private (target architecture §29.2).
  * States on the root: `data-variant`, `data-size`, `data-disabled`,
- * `data-invalid`.
+ * `data-invalid`. `description` is the `description` sugar's hint text (W4-05).
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type InputSlot = "root" | "label" | "icon-start" | "icon-end" | "password-toggle" | "error";
+type InputSlot = "root" | "label" | "icon-start" | "icon-end" | "password-toggle" | "description" | "error";
 /**
  * `Textarea` parts, stamped as `data-slot="textarea[-<part>]"` (ADR-008).
  * `root` is the `<textarea>`. States on the root: `data-variant`, `data-size`,
- * `data-disabled`, `data-invalid`.
+ * `data-disabled`, `data-invalid`. `description` is the `description` sugar's
+ * hint text (W4-06).
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type TextareaSlot = "root" | "label" | "error" | "count";
+type TextareaSlot = "root" | "label" | "description" | "error" | "count";
 /**
  * `SearchInput` parts, stamped as `data-slot="search-input[-<part>]"`
  * (ADR-008). `root` is the positioning wrapper `className` lands on;
@@ -114,18 +118,23 @@ type TextareaSlot = "root" | "label" | "error" | "count";
  */
 type SearchInputSlot = "root" | "control" | "icon" | "clear";
 /**
- * `Select` parts, stamped as `data-slot="select-<part>"` (ADR-008). There is
- * no `root`: `SelectRoot` renders no element. Radix's own `data-state`,
- * `data-disabled`, `data-placeholder` and `data-highlighted` are left as they
- * are (`P-DATA-STATE`).
+ * `Select` parts, stamped as `data-slot="select-<part>"` (ADR-008).
+ * `SelectRoot` renders no element: `root` is the wrapper the options-driven
+ * `Select clearable` renders around the trigger and the `clear` button (W4-08),
+ * and exists only then. Radix's own `data-state`, `data-disabled`,
+ * `data-placeholder` and `data-highlighted` are left as they are
+ * (`P-DATA-STATE`); the trigger adds `data-size` when a `size` is set.
  *
  * `SelectValue` and `SelectGroup` are re-exported Radix components with no
- * wrapper of ours, so they carry no slot yet; W4-08 gives them one along with
- * `classNames.value` (`C-DOM-10`).
+ * wrapper of ours, so they carry no slot of their own. `value` is the span
+ * the options-driven `Select` wraps Radix's value in when `classNames.value`
+ * or `clearable` asks for it (Radix's own span drops `className`); a legacy
+ * call renders no wrapper, so the `SelectTrigger > span` structure PRO selects
+ * on stays as frozen by `C-DOM-10`.
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type SelectSlot = "trigger" | "icon" | "content" | "viewport" | "item" | "item-indicator" | "label" | "separator" | "scroll-up-button" | "scroll-down-button";
+type SelectSlot = "root" | "trigger" | "value" | "icon" | "clear" | "content" | "viewport" | "item" | "item-indicator" | "label" | "separator" | "scroll-up-button" | "scroll-down-button";
 /**
  * `Checkbox` parts, stamped as `data-slot="checkbox[-<part>]"` (ADR-008).
  * `root` is the Radix root — the box, and the element `className` lands on.
@@ -139,11 +148,14 @@ type CheckboxSlot = "root" | "indicator" | "label";
 /**
  * `RadioGroup` / `RadioGroupItem` parts, stamped as
  * `data-slot="radio-group[-<part>]"` (ADR-008). `root` is the group,
- * `item` the radio. Radix's `data-state` is left as it is.
+ * `item` the radio. Radix's `data-state` is left as it is. With
+ * `appearance="card"` (W4-14) the root carries `data-appearance="card"` and
+ * every item is wrapped in a `card` holding the `label` (stretched over the
+ * card, so the whole box is the click target) and an optional `description`.
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type RadioGroupSlot = "root" | "item" | "indicator" | "label";
+type RadioGroupSlot = "root" | "item" | "indicator" | "label" | "card" | "description";
 /**
  * `Switch` parts, stamped as `data-slot="switch[-<part>]"` (ADR-008).
  * `root` is the Radix root — the track, and the element `className` lands on;
@@ -159,6 +171,28 @@ type SwitchSlot = "root" | "thumb" | "label";
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
 type LabelSlot = "root" | "required";
+/**
+ * `NumberInput` parts, stamped as `data-slot="number-input"` (ADR-008).
+ * `root` is the `<input>` itself — the control frame and the element
+ * `className` lands on, like `Input`. The hidden inputs `FormBridge` renders
+ * next to it are not parts. States on the root: `data-variant`, `data-size`,
+ * `data-disabled`, `data-invalid`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-21).
+ */
+type NumberInputSlot = "root";
+/**
+ * `PhoneField` parts, stamped as `data-slot="phone-field[-<part>]"` (ADR-008).
+ * `root` is the row (the element `className` lands on), `number` the `tel`
+ * `<input>` on the control chrome, `flag` a `CountryFlag` (the SVG, or its
+ * placeholder while the flag set loads). `country` is the country picker: a
+ * `Combobox`, stamped with its own anatomy and styled through
+ * `classNames.country`. States on the root: `data-variant`, `data-size`,
+ * `data-disabled`, `data-invalid`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-22).
+ */
+type PhoneFieldSlot = "root" | "country" | "number" | "flag";
 /**
  * `FileUpload` parts, stamped as `data-slot="file-upload[-<part>]"` (ADR-008).
  * `dropzone` is the `<label>` that `C-DOM-04` freezes and that
@@ -173,12 +207,13 @@ type FileUploadSlot = "root" | "dropzone" | "input" | "error";
  * `Dialog` parts, stamped as `data-slot="dialog-<part>"` (ADR-008). There is
  * no `root`: `Dialog` is Radix's non-rendering root. `close` is stamped on
  * both the built-in close button and `DialogClose`; they are the same part —
- * a control that dismisses the dialog. States: `data-size` on the content.
+ * a control that dismisses the dialog. `body` is the scroll region between
+ * header and footer (W5-05). States: `data-size` on the content.
  * Radix's `data-state` is left as it is (`P-DATA-STATE`).
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "close";
+type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "body" | "footer" | "close";
 /**
  * `AlertDialog` parts, stamped as `data-slot="alert-dialog-<part>"`
  * (ADR-008). No `root` — Radix's root renders no element.
@@ -188,13 +223,14 @@ type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "
 type AlertDialogSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "action" | "cancel";
 /**
  * `Sheet` parts, stamped as `data-slot="sheet-<part>"` (ADR-008).
- * States: `data-size` on the content, carrying today's `width` preset — the
- * prop `C-SHEET-WIDTH` renames to `size` in W5-07. The `side` is not in the
- * §29.2 vocabulary and stays a class.
+ * `body` is the scroll region between header and footer (W5-07). States:
+ * `data-size` on the content, carrying the `size` step (or the deprecated
+ * `width` preset, C-SHEET-WIDTH; `default` when neither is given). The
+ * `side` is not in the §29.2 vocabulary and stays a class.
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type SheetSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "close";
+type SheetSlot = "overlay" | "content" | "header" | "title" | "description" | "body" | "footer" | "close";
 /**
  * `SideDrawer` parts, stamped as `data-slot="side-drawer[-<part>]"`
  * (ADR-008). `root` is the panel. The screen-reader-only Radix title that the
@@ -415,275 +451,44 @@ type IconButtonSlot = "root" | "icon" | "spinner";
  * @experimental Slot names are experimental until ADR-008 is accepted (W3-15).
  */
 type ChipSlot = "root" | "icon" | "label" | "count" | "remove";
-
-declare const AlertDialog: React$1.FC<AlertDialogPrimitive.AlertDialogProps>;
-declare const AlertDialogTrigger: React$1.ForwardRefExoticComponent<AlertDialogPrimitive.AlertDialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
-declare const AlertDialogPortal: React$1.FC<AlertDialogPrimitive.AlertDialogPortalProps>;
-declare const AlertDialogOverlay: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const AlertDialogContent: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const AlertDialogHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const AlertDialogFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
-declare const AlertDialogTitle: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
-declare const AlertDialogDescription: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const AlertDialogAction: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogActionProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
-declare const AlertDialogCancel: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogCancelProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
-
 /**
- * Alert — inline banner. Variants align with the three Assure status families
- * (success, warning, danger) plus a cyan-accent `info` (per spec §3 — three
- * statuses, not five).
- */
-declare const alertVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "destructive" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface AlertProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
-}
-declare const Alert: React$1.ForwardRefExoticComponent<AlertProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const AlertTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
-declare const AlertDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-
-/**
- * AreaChart — single-series area + line trend (the "Financial overview"
- * chart). SVG `path` area under a 2.5px line, vertical gradient fill, and
- * hover points with a floating tooltip.
+ * `Field` parts, stamped as `data-slot="field[-<part>]"` (ADR-008, W4-01):
+ * the root (the layout wrapper, no chrome), the `label` (a `Label` rendered
+ * inside a field stamps this over its own `label`, the way `Card` stamps
+ * `card` over `surface`), its `required` asterisk and `optional` indicator,
+ * the `description` and the `error`. The control is not a part: it keeps its
+ * own anatomy (`input`, `select-trigger`, …) and is found by the field's id.
+ * States on the root: `data-orientation`, `data-invalid`, `data-disabled`,
+ * `data-required`.
  *
- * Width is measured with a ResizeObserver so the chart fills its column;
- * the initial width is a safe SSR default (no `window` read on the server).
- * The gradient gets a `useId`-scoped `<defs>` id so multiple instances on
- * one page don't collide.
- *
- * Stroke + gradient come from the tokenized chart line color
- * (`--color-chart-line`, `--color-chart-area-*`).
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-01).
  */
-interface AreaPoint {
-    label: string;
-    value: number;
-}
-interface AreaChartProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
-    data: AreaPoint[];
-    /** Plot height in px (excludes the x-axis label row). */
-    height?: number;
-    /** Format a value for the hover tooltip. Defaults to a thin-space number. */
-    formatValue?: (value: number) => string;
-    /** Show the x-axis label row under the plot. Default `true`. */
-    showAxis?: boolean;
-}
-declare const AreaChart: React$1.ForwardRefExoticComponent<AreaChartProps & React$1.RefAttributes<HTMLDivElement>>;
-
-interface AspectRatioProps extends React$1.ComponentPropsWithoutRef<typeof AspectRatioPrimitive.Root> {
-    ratio?: number;
-    children: React$1.ReactNode;
-}
-declare const AspectRatio: React$1.ForwardRefExoticComponent<AspectRatioProps & React$1.RefAttributes<HTMLDivElement>>;
-
+type FieldSlot = "root" | "label" | "required" | "optional" | "description" | "error";
 /**
- * AttachmentChip — a full attachment / file row.
- *
- * Layout: FileTypeBadge + (name truncate + meta below) + trailing ghost
- * icon actions (view / download, then any `actions` the consumer adds).
- * Presentational: handlers and the file URL are passed in, so the chip
- * itself never owns state.
- *
- * Two variants:
- *
- *   default  — settled row on a page / panel (border + surface, hover bg-2),
- *              matches the v2 `.txq-ai-file` transaction-receipt row.
- *   onAccent — for outbound chat bubbles painted with the suite accent;
- *              translucent-white fill and on-accent text, matches the v2
- *              `.v2-cx-row.out .v2-cx-file` message attachment.
- */
-declare const attachmentChipVariants: (props?: ({
-    variant?: "default" | "onAccent" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface AttachmentChipProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof attachmentChipVariants> {
-    /** File name, e.g. `2023-return.pdf`. Truncates when it overflows. */
-    name: string;
-    /** Format label for the FileTypeBadge. Derived from `name` when omitted. */
-    fileType?: string;
-    /** Secondary line — size and/or date, e.g. `2.4 MB · uploaded just now`. */
-    meta?: string;
-    /** View handler — renders the eye action as a button. */
-    onView?: () => void;
-    /** Download handler — renders the download action as a button. */
-    onDownload?: () => void;
-    /** File URL — backs the view action as a real anchor when `onView` is absent. */
-    href?: string;
-    /**
-     * App-specific trailing actions, rendered in the same action group after
-     * view / download — so a third affordance reads as part of the chip rather
-     * than as a second box beside it. Pass `<Button variant="ghost"
-     * size="icon-sm">` nodes to match the built-in actions.
-     *
-     * On the `onAccent` variant, style them against the accent fill with the
-     * root's group scope: `group-data-[variant=onAccent]/attachment-chip:…`.
-     */
-    actions?: React.ReactNode;
-}
-declare const AttachmentChip: React$1.ForwardRefExoticComponent<AttachmentChipProps & React$1.RefAttributes<HTMLDivElement>>;
-
-declare const avatarVariants: (props?: ({
-    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
-    variant?: "initials" | "branded" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-declare const statusStyles: {
-    readonly online: "ds:bg-success-fg";
-    readonly away: "ds:bg-warning-fg";
-    readonly busy: "ds:bg-danger-fg";
-    readonly offline: "ds:bg-fg-4";
-};
-
-/**
- * Props of `Avatar`. Everything not listed spreads onto the frame (the Radix
- * root), as it always has.
- */
-interface AvatarProps extends Omit<React$1.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>, "children">, VariantProps<typeof avatarVariants> {
-    src?: string | null;
-    alt?: string;
-    name?: string;
-    status?: keyof typeof statusStyles;
-    /**
-     * One class per part, keyed by `AvatarSlot` (ADR-008 decision 4). `root` is
-     * the outer wrapper — where a `shrink-0` or a margin belongs; `frame` is the
-     * circle, the same element `className` lands on. Each part's class comes
-     * after the design system's own and, on the frame, before `className`, so a
-     * consumer's `className` keeps winning exactly as it does today.
-     *
-     * Spelled out as `Partial<Record<AvatarSlot, string>>` rather than through the
-     * internal `SlotClassNames` helper so the public declaration names no
-     * unexported type.
-     *
-     * @experimental
-     */
-    classNames?: Partial<Record<AvatarSlot, string>>;
-}
-declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLSpanElement>>;
-
-/** The emphasis subset a badge offers. @experimental */
-type BadgeVariant = Extract<Variant, "solid" | "soft" | "outline">;
-/** The badge's own size scale, spelled with the shared names (§17). @experimental */
-type BadgeSize = Extract<ControlSize, "xs" | "sm" | "md">;
-/** Corner treatment; omitted keeps today's corner (D1). @experimental */
-type BadgeShape = Extract<Shape, "rounded" | "pill">;
-/**
- * The one-axis words Badge accepted before W3-13. Each resolves to a
- * `{ variant, intent }` pair through `resolveBadgeAppearance` and renders the
- * same classes it always did.
- *
- * @deprecated Use `variant` (`solid | soft | outline`) with `intent` instead:
- * `default` → `solid` + `brand`, `secondary` → `soft` + `neutral`,
- * `destructive` → `soft` + `danger`, `success | warning | info` → `soft` +
- * the same word. `outline` is already an emphasis and is not deprecated.
- */
-type BadgeLegacyVariant = "default" | "secondary" | "destructive" | "success" | "warning" | "info";
-/** A resolved `{ variant, intent }` pair. @experimental */
-interface BadgeAppearance {
-    variant: BadgeVariant;
-    intent: Intent;
-}
-/** What a badge can be asked for: the two axes, either one, or a legacy word. @experimental */
-interface BadgeAppearanceInput {
-    variant?: BadgeVariant | BadgeLegacyVariant | null | undefined;
-    intent?: Intent | null | undefined;
-}
-/**
- * Resolves what a consumer asked for into the pair the class table is keyed by.
- *
- * - both axes: taken as given (a legacy `variant` word with an explicit
- *   `intent` keeps the word's emphasis and takes the intent);
- * - `variant` only: the per-variant default intent, or the legacy pair;
- * - `intent` only: the per-intent default variant;
- * - nothing: `solid` + `brand`, today's default.
+ * `Fieldset` parts, stamped as `data-slot="fieldset[-<part>]"` (ADR-008,
+ * W4-01): the `<fieldset>` root and its `<legend>`. States on the root:
+ * `data-disabled`, `data-invalid`.
  *
- * @experimental
- */
-declare function resolveBadgeAppearance({ variant, intent, }?: BadgeAppearanceInput): BadgeAppearance;
-/** The inputs `badgeVariants` accepts (the legacy `variant` words included). @experimental */
-interface BadgeVariantsProps extends BadgeAppearanceInput {
-    size?: BadgeSize | null | undefined;
-    shape?: BadgeShape | null | undefined;
-    class?: string | null | undefined;
-    className?: string | null | undefined;
-}
-/**
- * The badge's class string, for consumers that style their own element.
- * Same call shape as before W3-13 (`variant`, `size`, `class`/`className`),
- * plus `intent` and `shape`; a legacy `variant` word yields the string it
- * always did.
- */
-declare function badgeVariants({ variant, intent, size, shape, class: classValue, className, }?: BadgeVariantsProps): string;
-interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
-    /**
-     * Visual emphasis: `solid` (filled), `soft` (tinted, the status look) or
-     * `outline`. Omitted, it follows `intent` (brand is solid, the rest soft);
-     * with neither prop the badge is `solid` + `brand`, as it always was.
-     * The legacy one-axis words are accepted and deprecated (`BadgeLegacyVariant`).
-     */
-    variant?: BadgeVariant | BadgeLegacyVariant;
-    /**
-     * Semantic meaning → colour family. Omitted, it follows `variant`
-     * (`solid` is brand, `soft` and `outline` are neutral).
-     * @experimental
-     */
-    intent?: Intent;
-    /** `xs` (10px text, W3-13), `sm` (default) or `md`. */
-    size?: BadgeSize;
-    /**
-     * Corner treatment. Omitted keeps today's corner (`--radius-pill`);
-     * `rounded` is the `radius.badge` role, `pill` is `radius.full` (D1).
-     * @experimental
-     */
-    shape?: BadgeShape;
-    /** Leading status dot, drawn in the text colour. */
-    dot?: boolean;
-    /** Leading 14px glyph. */
-    icon?: React.ReactNode;
-}
-declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
-
-/**
- * Blockquote — semantic quote with optional attribution. Uses `font-display`
- * (Inter) at a comfortable reading scale; smart quotes are wrapped automatically.
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-01).
  */
-interface BlockquoteProps extends React.BlockquoteHTMLAttributes<HTMLQuoteElement> {
-    author?: string;
-    role?: string;
-}
-declare const Blockquote: React$1.ForwardRefExoticComponent<BlockquoteProps & React$1.RefAttributes<HTMLQuoteElement>>;
-
-interface BrandIconProps extends React.SVGAttributes<SVGElement> {
-    size?: number;
-}
-declare function AssureProBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
-declare function AssureAuditBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
-declare function AssureBooksBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
-declare function AssureTaxBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
-
+type FieldsetSlot = "root" | "legend";
 /**
- * Breadcrumb — semantic navigation primitive. Uses the catalog `ChevronRightIcon` as the
- * default separator. Current page (BreadcrumbPage) leans on Pro purple to
- * mirror the active-state language used elsewhere in the firm app.
+ * `Combobox` parts, stamped as `data-slot="combobox[-<part>]"` (ADR-008,
+ * W4-10): the `root` (the frame that holds the control and its form bridge),
+ * the `control` (the field-shaped box the popover anchors to), the `value`
+ * (a custom `renderValue` node over the input), the `chips` row and its
+ * `Chip`s in `multiple` mode, the `input` (the `role="combobox"` element that
+ * keeps focus), the leading `icon`, the `clear` and `toggle` buttons; then
+ * the portalled `content` with an optional `header`, the `list`
+ * (`role="listbox"`), a `group` with its `group-heading`, each `item`
+ * (`role="option"`, see `behavior/collection/item-attributes.ts`) and its
+ * `item-indicator`, the `create` row, the `empty` and `loading` states and an
+ * optional `footer`. States on the root: `data-state` (`open` · `closed`),
+ * `data-disabled`, `data-invalid`, `data-size`.
  *
- * Public API preserved: Breadcrumb / BreadcrumbList / BreadcrumbItem /
- * BreadcrumbLink / BreadcrumbPage / BreadcrumbSeparator.
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-10).
  */
-type BreadcrumbProps = React.HTMLAttributes<HTMLElement>;
-declare const Breadcrumb: React$1.ForwardRefExoticComponent<BreadcrumbProps & React$1.RefAttributes<HTMLElement>>;
-type BreadcrumbListProps = React.HTMLAttributes<HTMLOListElement>;
-declare const BreadcrumbList: React$1.ForwardRefExoticComponent<BreadcrumbListProps & React$1.RefAttributes<HTMLOListElement>>;
-type BreadcrumbItemProps = React.HTMLAttributes<HTMLLIElement>;
-declare const BreadcrumbItem: React$1.ForwardRefExoticComponent<BreadcrumbItemProps & React$1.RefAttributes<HTMLLIElement>>;
-type BreadcrumbLinkProps = React.AnchorHTMLAttributes<HTMLAnchorElement>;
-declare const BreadcrumbLink: React$1.ForwardRefExoticComponent<BreadcrumbLinkProps & React$1.RefAttributes<HTMLAnchorElement>>;
-type BreadcrumbPageProps = React.HTMLAttributes<HTMLSpanElement>;
-declare const BreadcrumbPage: React$1.ForwardRefExoticComponent<BreadcrumbPageProps & React$1.RefAttributes<HTMLSpanElement>>;
-type BreadcrumbSeparatorProps = React.HTMLAttributes<HTMLSpanElement>;
-declare const BreadcrumbSeparator: React$1.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React$1.RefAttributes<HTMLSpanElement>>;
+type ComboboxSlot = "root" | "control" | "value" | "chips" | "input" | "icon" | "clear" | "toggle" | "content" | "header" | "list" | "group" | "group-heading" | "item" | "item-indicator" | "create" | "empty" | "loading" | "footer";
 
 /**
  * L1a behaviour primitive (private). Not exported from the package.
@@ -851,24 +656,310 @@ declare function buttonVariants({ variant, intent, size, class: classProp, class
  *
  * @experimental
  */
-interface ButtonIconProps {
-    /** Icon before the label (logical start). */
-    iconStart?: ReactNode;
-    /** Icon after the label (logical end). */
-    iconEnd?: ReactNode;
+interface ButtonIconProps {
+    /** Icon before the label (logical start). */
+    iconStart?: ReactNode;
+    /** Icon after the label (logical end). */
+    iconEnd?: ReactNode;
+    /**
+     * Alias of `iconStart`. The codemod CM-05 renames it.
+     *
+     * @deprecated Use `iconStart`.
+     */
+    iconLeft?: ReactNode;
+    /**
+     * Alias of `iconEnd`. The codemod CM-05 renames it.
+     *
+     * @deprecated Use `iconEnd`.
+     */
+    iconRight?: ReactNode;
+}
+
+declare const AlertDialog: React$1.FC<AlertDialogPrimitive.AlertDialogProps>;
+declare const AlertDialogTrigger: React$1.ForwardRefExoticComponent<AlertDialogPrimitive.AlertDialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const AlertDialogPortal: React$1.FC<AlertDialogPrimitive.AlertDialogPortalProps>;
+declare const AlertDialogOverlay: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const AlertDialogContent: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+declare const AlertDialogHeader: {
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const AlertDialogFooter: {
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+declare const AlertDialogTitle: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const AlertDialogDescription: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Props of `AlertDialogAction` (W5-06): Radix's action props plus the two
+ * Button axes.
+ *
+ * @experimental
+ */
+interface AlertDialogActionProps extends React$1.ComponentPropsWithoutRef<typeof AlertDialogPrimitive.Action> {
+    /**
+     * Emphasis, as on `Button` (ADR-007): `solid · soft · outline · ghost ·
+     * link`, or a legacy word. Without `variant` and `intent` the action keeps
+     * its 1.x destructive look; naming either resolves through the Button
+     * recipe, so `intent="brand"` is a non-destructive confirm.
+     */
+    variant?: ButtonVariant;
+    /** Meaning, as on `Button`: `brand · neutral · success · danger`. */
+    intent?: ButtonIntent | ButtonIntentAlias;
+}
+declare const AlertDialogAction: React$1.ForwardRefExoticComponent<AlertDialogActionProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const AlertDialogCancel: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogCancelProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Alert — inline banner. Variants align with the three Assure status families
+ * (success, warning, danger) plus a cyan-accent `info` (per spec §3 — three
+ * statuses, not five).
+ */
+declare const alertVariants: (props?: ({
+    variant?: "info" | "success" | "warning" | "destructive" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AlertProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
+}
+declare const Alert: React$1.ForwardRefExoticComponent<AlertProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const AlertTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const AlertDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+
+/**
+ * AreaChart — single-series area + line trend (the "Financial overview"
+ * chart). SVG `path` area under a 2.5px line, vertical gradient fill, and
+ * hover points with a floating tooltip.
+ *
+ * Width is measured with a ResizeObserver so the chart fills its column;
+ * the initial width is a safe SSR default (no `window` read on the server).
+ * The gradient gets a `useId`-scoped `<defs>` id so multiple instances on
+ * one page don't collide.
+ *
+ * Stroke + gradient come from the tokenized chart line color
+ * (`--color-chart-line`, `--color-chart-area-*`).
+ */
+interface AreaPoint {
+    label: string;
+    value: number;
+}
+interface AreaChartProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    data: AreaPoint[];
+    /** Plot height in px (excludes the x-axis label row). */
+    height?: number;
+    /** Format a value for the hover tooltip. Defaults to a thin-space number. */
+    formatValue?: (value: number) => string;
+    /** Show the x-axis label row under the plot. Default `true`. */
+    showAxis?: boolean;
+}
+declare const AreaChart: React$1.ForwardRefExoticComponent<AreaChartProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface AspectRatioProps extends React$1.ComponentPropsWithoutRef<typeof AspectRatioPrimitive.Root> {
+    ratio?: number;
+    children: React$1.ReactNode;
+}
+declare const AspectRatio: React$1.ForwardRefExoticComponent<AspectRatioProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * AttachmentChip — a full attachment / file row.
+ *
+ * Layout: FileTypeBadge + (name truncate + meta below) + trailing ghost
+ * icon actions (view / download, then any `actions` the consumer adds).
+ * Presentational: handlers and the file URL are passed in, so the chip
+ * itself never owns state.
+ *
+ * Two variants:
+ *
+ *   default  — settled row on a page / panel (border + surface, hover bg-2),
+ *              matches the v2 `.txq-ai-file` transaction-receipt row.
+ *   onAccent — for outbound chat bubbles painted with the suite accent;
+ *              translucent-white fill and on-accent text, matches the v2
+ *              `.v2-cx-row.out .v2-cx-file` message attachment.
+ */
+declare const attachmentChipVariants: (props?: ({
+    variant?: "default" | "onAccent" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AttachmentChipProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof attachmentChipVariants> {
+    /** File name, e.g. `2023-return.pdf`. Truncates when it overflows. */
+    name: string;
+    /** Format label for the FileTypeBadge. Derived from `name` when omitted. */
+    fileType?: string;
+    /** Secondary line — size and/or date, e.g. `2.4 MB · uploaded just now`. */
+    meta?: string;
+    /** View handler — renders the eye action as a button. */
+    onView?: () => void;
+    /** Download handler — renders the download action as a button. */
+    onDownload?: () => void;
+    /** File URL — backs the view action as a real anchor when `onView` is absent. */
+    href?: string;
+    /**
+     * App-specific trailing actions, rendered in the same action group after
+     * view / download — so a third affordance reads as part of the chip rather
+     * than as a second box beside it. Pass `<Button variant="ghost"
+     * size="icon-sm">` nodes to match the built-in actions.
+     *
+     * On the `onAccent` variant, style them against the accent fill with the
+     * root's group scope: `group-data-[variant=onAccent]/attachment-chip:…`.
+     */
+    actions?: React.ReactNode;
+}
+declare const AttachmentChip: React$1.ForwardRefExoticComponent<AttachmentChipProps & React$1.RefAttributes<HTMLDivElement>>;
+
+declare const avatarVariants: (props?: ({
+    size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
+    variant?: "initials" | "branded" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const statusStyles: {
+    readonly online: "ds:bg-success-fg";
+    readonly away: "ds:bg-warning-fg";
+    readonly busy: "ds:bg-danger-fg";
+    readonly offline: "ds:bg-fg-4";
+};
+
+/**
+ * Props of `Avatar`. Everything not listed spreads onto the frame (the Radix
+ * root), as it always has.
+ */
+interface AvatarProps extends Omit<React$1.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>, "children">, VariantProps<typeof avatarVariants> {
+    src?: string | null;
+    alt?: string;
+    name?: string;
+    status?: keyof typeof statusStyles;
+    /**
+     * One class per part, keyed by `AvatarSlot` (ADR-008 decision 4). `root` is
+     * the outer wrapper — where a `shrink-0` or a margin belongs; `frame` is the
+     * circle, the same element `className` lands on. Each part's class comes
+     * after the design system's own and, on the frame, before `className`, so a
+     * consumer's `className` keeps winning exactly as it does today.
+     *
+     * Spelled out as `Partial<Record<AvatarSlot, string>>` rather than through the
+     * internal `SlotClassNames` helper so the public declaration names no
+     * unexported type.
+     *
+     * @experimental
+     */
+    classNames?: Partial<Record<AvatarSlot, string>>;
+}
+declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+/** The emphasis subset a badge offers. @experimental */
+type BadgeVariant = Extract<Variant, "solid" | "soft" | "outline">;
+/** The badge's own size scale, spelled with the shared names (§17). @experimental */
+type BadgeSize = Extract<ControlSize, "xs" | "sm" | "md">;
+/** Corner treatment; omitted keeps today's corner (D1). @experimental */
+type BadgeShape = Extract<Shape, "rounded" | "pill">;
+/**
+ * The one-axis words Badge accepted before W3-13. Each resolves to a
+ * `{ variant, intent }` pair through `resolveBadgeAppearance` and renders the
+ * same classes it always did.
+ *
+ * @deprecated Use `variant` (`solid | soft | outline`) with `intent` instead:
+ * `default` → `solid` + `brand`, `secondary` → `soft` + `neutral`,
+ * `destructive` → `soft` + `danger`, `success | warning | info` → `soft` +
+ * the same word. `outline` is already an emphasis and is not deprecated.
+ */
+type BadgeLegacyVariant = "default" | "secondary" | "destructive" | "success" | "warning" | "info";
+/** A resolved `{ variant, intent }` pair. @experimental */
+interface BadgeAppearance {
+    variant: BadgeVariant;
+    intent: Intent;
+}
+/** What a badge can be asked for: the two axes, either one, or a legacy word. @experimental */
+interface BadgeAppearanceInput {
+    variant?: BadgeVariant | BadgeLegacyVariant | null | undefined;
+    intent?: Intent | null | undefined;
+}
+/**
+ * Resolves what a consumer asked for into the pair the class table is keyed by.
+ *
+ * - both axes: taken as given (a legacy `variant` word with an explicit
+ *   `intent` keeps the word's emphasis and takes the intent);
+ * - `variant` only: the per-variant default intent, or the legacy pair;
+ * - `intent` only: the per-intent default variant;
+ * - nothing: `solid` + `brand`, today's default.
+ *
+ * @experimental
+ */
+declare function resolveBadgeAppearance({ variant, intent, }?: BadgeAppearanceInput): BadgeAppearance;
+/** The inputs `badgeVariants` accepts (the legacy `variant` words included). @experimental */
+interface BadgeVariantsProps extends BadgeAppearanceInput {
+    size?: BadgeSize | null | undefined;
+    shape?: BadgeShape | null | undefined;
+    class?: string | null | undefined;
+    className?: string | null | undefined;
+}
+/**
+ * The badge's class string, for consumers that style their own element.
+ * Same call shape as before W3-13 (`variant`, `size`, `class`/`className`),
+ * plus `intent` and `shape`; a legacy `variant` word yields the string it
+ * always did.
+ */
+declare function badgeVariants({ variant, intent, size, shape, class: classValue, className, }?: BadgeVariantsProps): string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
     /**
-     * Alias of `iconStart`. The codemod CM-05 renames it.
-     *
-     * @deprecated Use `iconStart`.
+     * Visual emphasis: `solid` (filled), `soft` (tinted, the status look) or
+     * `outline`. Omitted, it follows `intent` (brand is solid, the rest soft);
+     * with neither prop the badge is `solid` + `brand`, as it always was.
+     * The legacy one-axis words are accepted and deprecated (`BadgeLegacyVariant`).
      */
-    iconLeft?: ReactNode;
+    variant?: BadgeVariant | BadgeLegacyVariant;
     /**
-     * Alias of `iconEnd`. The codemod CM-05 renames it.
-     *
-     * @deprecated Use `iconEnd`.
+     * Semantic meaning → colour family. Omitted, it follows `variant`
+     * (`solid` is brand, `soft` and `outline` are neutral).
+     * @experimental
      */
-    iconRight?: ReactNode;
+    intent?: Intent;
+    /** `xs` (10px text, W3-13), `sm` (default) or `md`. */
+    size?: BadgeSize;
+    /**
+     * Corner treatment. Omitted keeps today's corner (`--radius-pill`);
+     * `rounded` is the `radius.badge` role, `pill` is `radius.full` (D1).
+     * @experimental
+     */
+    shape?: BadgeShape;
+    /** Leading status dot, drawn in the text colour. */
+    dot?: boolean;
+    /** Leading 14px glyph. */
+    icon?: React.ReactNode;
+}
+declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * Blockquote — semantic quote with optional attribution. Uses `font-display`
+ * (Inter) at a comfortable reading scale; smart quotes are wrapped automatically.
+ */
+interface BlockquoteProps extends React.BlockquoteHTMLAttributes<HTMLQuoteElement> {
+    author?: string;
+    role?: string;
+}
+declare const Blockquote: React$1.ForwardRefExoticComponent<BlockquoteProps & React$1.RefAttributes<HTMLQuoteElement>>;
+
+interface BrandIconProps extends React.SVGAttributes<SVGElement> {
+    size?: number;
 }
+declare function AssureProBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+declare function AssureAuditBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+declare function AssureBooksBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+declare function AssureTaxBrandIcon({ size, ...props }: BrandIconProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Breadcrumb — semantic navigation primitive. Uses the catalog `ChevronRightIcon` as the
+ * default separator. Current page (BreadcrumbPage) leans on Pro purple to
+ * mirror the active-state language used elsewhere in the firm app.
+ *
+ * Public API preserved: Breadcrumb / BreadcrumbList / BreadcrumbItem /
+ * BreadcrumbLink / BreadcrumbPage / BreadcrumbSeparator.
+ */
+type BreadcrumbProps = React.HTMLAttributes<HTMLElement>;
+declare const Breadcrumb: React$1.ForwardRefExoticComponent<BreadcrumbProps & React$1.RefAttributes<HTMLElement>>;
+type BreadcrumbListProps = React.HTMLAttributes<HTMLOListElement>;
+declare const BreadcrumbList: React$1.ForwardRefExoticComponent<BreadcrumbListProps & React$1.RefAttributes<HTMLOListElement>>;
+type BreadcrumbItemProps = React.HTMLAttributes<HTMLLIElement>;
+declare const BreadcrumbItem: React$1.ForwardRefExoticComponent<BreadcrumbItemProps & React$1.RefAttributes<HTMLLIElement>>;
+type BreadcrumbLinkProps = React.AnchorHTMLAttributes<HTMLAnchorElement>;
+declare const BreadcrumbLink: React$1.ForwardRefExoticComponent<BreadcrumbLinkProps & React$1.RefAttributes<HTMLAnchorElement>>;
+type BreadcrumbPageProps = React.HTMLAttributes<HTMLSpanElement>;
+declare const BreadcrumbPage: React$1.ForwardRefExoticComponent<BreadcrumbPageProps & React$1.RefAttributes<HTMLSpanElement>>;
+type BreadcrumbSeparatorProps = React.HTMLAttributes<HTMLSpanElement>;
+declare const BreadcrumbSeparator: React$1.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React$1.RefAttributes<HTMLSpanElement>>;
 
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, ButtonIconProps {
     /**
@@ -920,15 +1011,41 @@ interface CalendarHighlight {
     date: Date;
     color?: CalendarHighlightColor;
 }
-interface CalendarProps extends Omit<DayPickerProps, "mode" | "selected" | "onSelect" | "modifiers" | "modifiersClassNames"> {
-    selected?: Date | null;
-    onSelect?: (date: Date) => void;
+/** A range as `Calendar mode="range"` reports it: either edge may be missing while the user picks. */
+interface CalendarRange {
+    from?: Date;
+    to?: Date;
+}
+/** Props shared by both modes of `Calendar`. */
+interface CalendarBaseProps extends Omit<DayPickerProps, "mode" | "selected" | "onSelect" | "modifiers" | "modifiersClassNames" | "locale" | "required"> {
     highlights?: CalendarHighlight[];
     minDate?: Date;
     maxDate?: Date;
     className?: string;
+    /**
+     * A BCP 47 language tag (`"en-US"`, `"fr-FR"`), or a `date-fns` locale
+     * object as before. Default: the provider's locale, else `"en-US"` (A3).
+     */
+    locale?: string | DayPickerProps["locale"];
+}
+/** Single-date calendar (the default mode). */
+interface CalendarProps extends CalendarBaseProps {
+    mode?: "single";
+    selected?: Date | null;
+    onSelect?: (date: Date) => void;
+}
+/**
+ * Range calendar: `selected` is a `{ from, to }` pair and `onSelect` reports
+ * the pair react-day-picker produced, `undefined` when it cleared the range.
+ *
+ * @experimental
+ */
+interface CalendarRangeProps extends CalendarBaseProps {
+    mode: "range";
+    selected?: CalendarRange | null;
+    onSelect?: (range: CalendarRange | undefined) => void;
 }
-declare function Calendar({ selected, onSelect, highlights, minDate, maxDate, className, classNames, captionLayout, navLayout, startMonth, endMonth, components, ...props }: CalendarProps): react_jsx_runtime.JSX.Element;
+declare function Calendar({ mode, selected, onSelect, highlights, minDate, maxDate, className, classNames, captionLayout, navLayout, startMonth, endMonth, components, locale: localeProp, today: todayProp, formatters, labels, lang, weekStartsOn, ...props }: CalendarProps | CalendarRangeProps): react_jsx_runtime.JSX.Element;
 declare namespace Calendar {
     var displayName: string;
 }
@@ -1167,16 +1284,33 @@ interface CategoryDividerProps extends React.HTMLAttributes<HTMLDivElement>, Var
 }
 declare const CategoryDivider: React$1.ForwardRefExoticComponent<CategoryDividerProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/** The states a checkbox renders: checked, unchecked, or partly checked. */
+type CheckboxChecked = boolean | "indeterminate";
 interface CheckboxProps extends Omit<React$1.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, "checked" | "defaultChecked"> {
-    /** Optional inline label rendered to the right of the box */
+    /** Optional inline label rendered to the right of the box. Names the button through `htmlFor`. */
     label?: string;
     /** Tri-state support: true | false | "indeterminate" */
-    checked?: boolean | "indeterminate";
-    defaultChecked?: boolean | "indeterminate";
-    /** Convenience: render with indeterminate state. Mirrors legacy prop. */
+    checked?: CheckboxChecked;
+    defaultChecked?: CheckboxChecked;
+    /**
+     * Render the indeterminate state.
+     *
+     * @deprecated Pass `checked="indeterminate"` instead (C-CHECKBOX-INDET;
+     * codemod CM-11 rewrites it). Removed in 3.0.
+     */
     indeterminate?: boolean;
     /** Box shape. Defaults to "square". */
     shape?: "square" | "circle";
+    /**
+     * The value submitted with `name` while checked. Default `"on"`, like a
+     * native checkbox.
+     */
+    value?: string;
+    /**
+     * The checkbox is in error: `aria-invalid` and `data-invalid`. Implied by
+     * the surrounding `Field`'s `invalid` or a mounted `FieldError`.
+     */
+    invalid?: boolean;
 }
 declare const Checkbox: React$1.ForwardRefExoticComponent<CheckboxProps & React$1.RefAttributes<HTMLButtonElement>>;
 
@@ -1277,9 +1411,17 @@ declare const ContextMenuSubTrigger: React$1.ForwardRefExoticComponent<Omit<Cont
 declare const ContextMenuSubContent: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSubContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const ContextMenuContent: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface ContextMenuItemProps extends React$1.ComponentPropsWithoutRef<typeof ContextMenuPrimitive.Item> {
+    /** Render as a destructive (danger) action — the `intent="danger"` look of the shared Menu recipe. */
     destructive?: boolean;
+    /** Increase left padding to align with checkbox/radio items. */
     inset?: boolean;
 }
+/**
+ * A menu item. Activation fires both `onSelect` (canonical; call
+ * `event.preventDefault()` on it to keep the menu open) and `onClick`
+ * (tolerated): Radix composes `onClick` with its select handler and a
+ * keyboard activation clicks the element.
+ */
 declare const ContextMenuItem: React$1.ForwardRefExoticComponent<ContextMenuItemProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const ContextMenuCheckboxItem: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuCheckboxItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const ContextMenuRadioItem: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuRadioItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -1322,10 +1464,25 @@ declare function isoToYear(iso: string | undefined | null): string;
 declare function yearToIso(year: string): string;
 /** Apply the `YYYY` mask while the user types. */
 declare function applyYearMask(input: string): string;
+/** A display pattern: the tokens `MM`, `DD` and `YYYY`, once each, around literal separators — `"MM/DD/YYYY"`, `"DD.MM.YYYY"`, `"YYYY-MM-DD"`. */
+type DatePattern = string;
 
 interface DatePickerProps {
-    value?: string;
+    /** ISO `YYYY-MM-DD`; `""` or `null` is "controlled, empty". */
+    value?: string | null;
     defaultValue?: string;
+    /**
+     * The value callback: the ISO date, or `null` when the field is cleared.
+     * Fires before the legacy `onChange` when both are passed.
+     *
+     * @experimental
+     */
+    onValueChange?: (value: string | null) => void;
+    /**
+     * Legacy fake-event callback (C-DATE-FAKEEVENT): `{ target: { name, value } }`
+     * with the ISO string (`""` when cleared). Prefer `onValueChange`; codemod
+     * CM-10 rewrites the recognisable shapes.
+     */
     onChange?: (event: {
         target: {
             name?: string;
@@ -1333,6 +1490,22 @@ interface DatePickerProps {
         };
     }) => void;
     name?: string;
+    /** `id` of the form to submit with when the picker is rendered outside it (Dialog, Sheet). */
+    form?: string;
+    /**
+     * BCP 47 tag deciding the typed pattern, the mask and the default
+     * placeholder. Default: the provider's locale, else `"en-US"` (`MM/DD/YYYY`).
+     *
+     * @experimental
+     */
+    locale?: string;
+    /**
+     * The display pattern, overriding the locale's: `MM`, `DD` and `YYYY`
+     * once each around literal separators (`"DD.MM.YYYY"`). Ignored in year mode.
+     *
+     * @experimental
+     */
+    dateFormat?: DatePattern;
     id?: string;
     label?: string;
     error?: string;
@@ -1377,11 +1550,33 @@ interface DateRangeValue {
     from?: string;
     to?: string;
 }
+/** The two form field names of a range. */
+interface DateRangeNames {
+    from: string;
+    to: string;
+}
 interface DateRangePickerProps {
     value?: DateRangeValue;
     defaultValue?: DateRangeValue;
     onChange?: (value: DateRangeValue) => void;
+    /** Base of the two field names: `${name}_from` / `${name}_to` unless `names` says otherwise. */
     name?: string;
+    /**
+     * Explicit field names for the two edges, replacing the `${name}_from` /
+     * `${name}_to` default (C-DATERANGE-NAMES, kept through 2.x).
+     *
+     * @experimental
+     */
+    names?: DateRangeNames;
+    /** `id` of the form to submit with when the picker is rendered outside it (Dialog, Sheet). */
+    form?: string;
+    /**
+     * BCP 47 tag deciding the displayed pattern of both edges and the
+     * calendar's language. Default: the provider's locale, else `"en-US"`.
+     *
+     * @experimental
+     */
+    locale?: string;
     id?: string;
     label?: string;
     error?: string;
@@ -1404,28 +1599,92 @@ declare const Dialog: React$1.FC<DialogPrimitive.DialogProps>;
 declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
 declare const DialogOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const dialogSizeStyles: {
-    readonly sm: "ds:max-w-sm";
-    readonly md: "ds:max-w-lg";
-    readonly lg: "ds:max-w-2xl";
-    readonly full: "ds:max-w-[calc(100vw-2rem)]";
-};
+/**
+ * Width of a `DialogContent`, as a step of the dialog width scale (W5-05):
+ * `sm` 24rem · `md` 32rem (default) · `lg` 42rem · `xl` 56rem · `full` the
+ * viewport minus a 1rem gutter. `sm`/`md`/`lg`/`full` are the 1.x steps,
+ * pixel for pixel; `xl` is new. Every step yields to `--ds-dialog-width`
+ * when a consumer sets it (on the content, or on a scope above it), which
+ * is the replacement for the `!max-w-*` overrides products write today.
+ *
+ * @experimental
+ */
+type DialogSize$1 = "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * Height of a `DialogContent` (W5-05). `auto` (default) grows with the
+ * content and scrolls the whole box past `100vh - 6rem`, as it always did.
+ * A fixed step (`sm` 24rem · `md` 32rem · `lg` 44rem · `full` the viewport
+ * minus the same gutter, each capped at the viewport) turns the box into a
+ * column whose `DialogBody` is the scroll region, so header and footer stay
+ * put while long content scrolls.
+ *
+ * @experimental
+ */
+type DialogHeight = "auto" | "sm" | "md" | "lg" | "full";
+/**
+ * The copy a `Dialog` renders (target architecture §24.5). English defaults
+ * until the messages contract of the provider lands (W5-20).
+ *
+ * @experimental
+ */
+interface DialogMessages {
+    /** The accessible name of the built-in close button. Default `"Close"`. */
+    close: string;
+}
+/**
+ * Props of `DialogContent`: Radix's content props plus the sizing and
+ * dismiss options.
+ *
+ * @experimental
+ */
 interface DialogContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
-    size?: keyof typeof dialogSizeStyles;
+    /** Width step. Default `md`. See {@link DialogSize}. */
+    size?: DialogSize$1;
+    /** Height step. Default `auto`. See {@link DialogHeight}. */
+    height?: DialogHeight;
     /**
      * If false, the built-in close button is hidden. Default: true.
      * Use `<DialogClose>` inside content to render your own close UI.
      */
     showCloseButton?: boolean;
+    /**
+     * The accessible name of the built-in close button. Takes precedence over
+     * `messages.close`. Default `"Close"`.
+     */
+    closeLabel?: string;
+    /** Overrides of the copy the dialog renders (English defaults until W5-20). */
+    messages?: Partial<DialogMessages>;
 }
 declare const DialogContent: React$1.ForwardRefExoticComponent<DialogContentProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogClose: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
+/**
+ * Props of `DialogBody` (W5-05).
+ *
+ * @experimental
+ */
+interface DialogBodyProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Inner padding. Default `none`: the content box already pads itself
+     * (`p-6`), so the body only needs its own padding when the content is
+     * `height`-fixed and a scrolling region wants breathing room.
+     */
+    padding?: "none" | "sm" | "md" | "lg";
+}
+/**
+ * The scroll region of a dialog between `DialogHeader` and `DialogFooter`
+ * (W5-05). With `height="auto"` (the default) the whole content scrolls as
+ * before and the body is a plain block; with a fixed `height` it takes the
+ * remaining height and scrolls while the header and footer stay in place.
+ *
+ * @experimental
+ */
+declare const DialogBody: React$1.ForwardRefExoticComponent<DialogBodyProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 declare const DialogTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
@@ -1526,6 +1785,22 @@ interface DonutChartProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "ch
 }
 declare const DonutChart: React$1.ForwardRefExoticComponent<DonutChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * L1a behaviour primitive (private). Not exported from the package.
+ *
+ * The `width` of a menu content surface (W5-13; target architecture §14
+ * "Menus: `width: auto | trigger | sm | md`" — 62% of consumer
+ * `DropdownMenuContent` uses override the width by class today). `auto` is
+ * the default and adds nothing, so every existing menu keeps its class string
+ * byte for byte; the other values are opt-in. `trigger` reads the Popper
+ * variable Radix stamps on the content, so the menu is as wide as the element
+ * that opened it.
+ *
+ * Full literals, one per row, so Tailwind's scanner sees them.
+ */
+/** How wide a menu content surface is. */
+type MenuWidth = "auto" | "trigger" | "sm" | "md";
+
 declare const DropdownMenu: React$1.FC<DropdownMenuPrimitive.DropdownMenuProps>;
 declare const DropdownMenuTrigger: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DropdownMenuGroup: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuGroupProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -1536,13 +1811,32 @@ declare const DropdownMenuSubTrigger: React$1.ForwardRefExoticComponent<Omit<Dro
     inset?: boolean;
 } & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuSubContent: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSubContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuContent: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuContentProps extends React$1.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content> {
+    /**
+     * The width of the menu surface. `auto` (default) sizes to the items with
+     * the 10rem minimum; `trigger` matches the element that opened the menu;
+     * `sm` and `md` are fixed widths (12rem, 16rem). Replaces the `w-*` class
+     * overrides most consumers write today.
+     * @default "auto"
+     */
+    width?: MenuWidth;
+}
+declare const DropdownMenuContent: React$1.ForwardRefExoticComponent<DropdownMenuContentProps & React$1.RefAttributes<HTMLDivElement>>;
 interface DropdownMenuItemProps extends React$1.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> {
-    /** Render as a destructive (danger) action. */
+    /**
+     * Render as a destructive (danger) action — the `intent="danger"` look of
+     * the shared Menu recipe (`menu.item.destructive.*` tokens).
+     */
     destructive?: boolean;
     /** Increase left padding to align with checkbox/radio items. */
     inset?: boolean;
 }
+/**
+ * A menu item. Activation fires both `onSelect` (canonical; call
+ * `event.preventDefault()` on it to keep the menu open) and `onClick`
+ * (tolerated): Radix composes `onClick` with its select handler and a
+ * keyboard activation clicks the element.
+ */
 declare const DropdownMenuItem: React$1.ForwardRefExoticComponent<DropdownMenuItemProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuCheckboxItem: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuCheckboxItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuRadioItem: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuRadioItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -1633,21 +1927,87 @@ interface FileTypeBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>,
 }
 declare const FileTypeBadge: React$1.ForwardRefExoticComponent<FileTypeBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
+/**
+ * The looks of the dropzone: `default` stacks the icon and the copy in a
+ * padded tile; `compact` lays them out in one row for dialogs and dense
+ * forms.
+ *
+ * @experimental
+ */
+type FileUploadVariant = "default" | "compact";
+
+/**
+ * Props of `FileUpload`.
+ *
+ * @experimental The W4-24 additions (`name`, `form`, `required`, `classNames`,
+ * `variant`, `inputRef`) are experimental; the legacy props keep their contract.
+ */
 interface FileUploadProps extends React.HTMLAttributes<HTMLDivElement> {
     accept?: string;
     maxSize?: number;
     multiple?: boolean;
     onFilesSelected?: (files: File[]) => void;
     disabled?: boolean;
+    /**
+     * The form field name. With it the owned `<input type="file">` submits the
+     * selected or dropped files; a surrounding `Field` can supply it.
+     */
+    name?: string;
+    /** `id` of the form to submit with when the dropzone is rendered outside it. */
+    form?: string;
+    /** Block native submission while no file is selected. */
+    required?: boolean;
+    /** `default` (stacked tile) or `compact` (one row). */
+    variant?: FileUploadVariant;
+    /**
+     * One class per part, keyed by `FileUploadSlot` (ADR-008). `className`
+     * keeps landing on the root; `dropzone` is the `<label>` that
+     * `[&_label]` selectors reach for today (C-DOM-04), `input` the file
+     * input, `error` the message.
+     */
+    classNames?: Partial<Record<Exclude<FileUploadSlot, "root">, string>>;
+    /** A ref to the owned file input. */
+    inputRef?: React.Ref<HTMLInputElement>;
+    /** Overrides for the default dropzone copy (W5-20). @experimental */
+    messages?: Partial<FileUploadMessages>;
 }
-declare function FileUpload({ accept, maxSize, multiple, onFilesSelected, disabled, className, children, ...props }: FileUploadProps): react_jsx_runtime.JSX.Element;
+declare function FileUpload({ accept, maxSize, multiple, onFilesSelected, disabled, name, form, required, variant, classNames, inputRef: inputRefProp, messages: messagesProp, className, children, ...props }: FileUploadProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `FormError` / `FormSuccess` — the pre-Field inline messages (contract
+ * C-FORM-MSG, replaced by the Field parts in W4-25, removed in 3.0).
+ *
+ * They are deliberately **not** thin adapters over `FieldError` and
+ * `FieldDescription`: the Field parts stamp `data-slot="field-error"` /
+ * `data-slot="field-description"`, always render a part `id` (a `useId`
+ * fallback outside a `Field`), and `FieldError` renders nothing without
+ * content and chooses its `role` from the mount timing — none of which
+ * today's `<p role="alert"><svg/><span>…</span></p>` has. Rendering through
+ * the parts would therefore change the DOM every consumer freezes (C-DOM
+ * snapshots) for no visible gain, so the markup below stays byte for byte
+ * until 3.0 and the replacement is a call-site migration:
+ *
+ * ```tsx
+ * <Field invalid={!!error}>
+ *   <Label>Email</Label>
+ *   <Input />
+ *   <FieldError>{error}</FieldError>
+ * </Field>
+ * ```
+ *
+ * `FormSuccess` has no Field counterpart by design: a confirmation is a
+ * `FieldDescription` (or a toast), not a field state.
+ */
 interface FormErrorProps extends React.HTMLAttributes<HTMLParagraphElement> {
     children: React.ReactNode;
 }
 /**
  * Inline form error — paired below an input to communicate validation failure.
  * Uses architectural --color-danger-fg token.
+ *
+ * @deprecated Use `FieldError` inside a `Field` (W4-25, C-FORM-MSG): it wires
+ * `aria-describedby` and `aria-invalid` on the control and announces itself
+ * only after an interaction. Removed in 3.0.
  */
 declare function FormError({ children, className, ...props }: FormErrorProps): react_jsx_runtime.JSX.Element;
 interface FormSuccessProps extends React.HTMLAttributes<HTMLParagraphElement> {
@@ -1656,6 +2016,10 @@ interface FormSuccessProps extends React.HTMLAttributes<HTMLParagraphElement> {
 /**
  * Inline form success — paired below an input to confirm a saved value.
  * Uses architectural --color-success-fg token.
+ *
+ * @deprecated Use `FieldDescription` inside a `Field` for a per-field
+ * confirmation, or a toast for a saved form (W4-25, C-FORM-MSG). Removed in
+ * 3.0.
  */
 declare function FormSuccess({ children, className, ...props }: FormSuccessProps): react_jsx_runtime.JSX.Element;
 
@@ -1674,6 +2038,21 @@ declare function FormSuccess({ children, className, ...props }: FormSuccessProps
  * For marketing-style centered section heads, prefer `<SectionHeader>`.
  * For lower-level title+description blocks that aren't part of a form,
  * use `<SectionHead>` from `./section`.
+ *
+ * Contract C-FORM-MSG (W4-25): replaced by `Fieldset` + `FieldsetLegend`,
+ * removed in 3.0. It is deliberately **not** an adapter over them: `Fieldset`
+ * stamps `data-slot="fieldset"` and lays its children out as a
+ * `flex-col gap-3` column, `FieldsetLegend` adds `mb-1.5` — both would move
+ * the heading row and the fields this component renders today. The markup
+ * below therefore stays byte for byte until 3.0; the replacement is a
+ * call-site migration:
+ *
+ * ```tsx
+ * <Fieldset>
+ *   <FieldsetLegend>Contact</FieldsetLegend>
+ *   <Field>…</Field>
+ * </Fieldset>
+ * ```
  */
 interface FormSectionProps extends Omit<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, "title"> {
     /** The section heading (renders as `<legend>` text). */
@@ -1685,6 +2064,14 @@ interface FormSectionProps extends Omit<React.FieldsetHTMLAttributes<HTMLFieldSe
     /** Space between the heading block and the fields. Default `mt-4`. */
     headSpacing?: string;
 }
+/**
+ * A grouped block of a settings/profile form: `<fieldset>` + `<legend>` with
+ * an optional description and trailing action.
+ *
+ * @deprecated Use `Fieldset` with `FieldsetLegend` (W4-25, C-FORM-MSG); put
+ * a description in a `Text` and each control in its own `Field`. Removed in
+ * 3.0.
+ */
 declare const FormSection: React$1.ForwardRefExoticComponent<FormSectionProps & React$1.RefAttributes<HTMLFieldSetElement>>;
 
 declare const HoverCard: React$1.FC<HoverCardPrimitive.HoverCardProps>;
@@ -1747,30 +2134,101 @@ interface IconTileVariantProps {
      * @deprecated Use `intent`. `pro` → `brand`; status values keep their name;
      * `audit` / `books` / `tax` stay here (no intent).
      */
-    tone?: IconTileTone | null;
-    size?: IconTileSize | null;
-}
-/** The IconTile class string. Accepts `intent` or the deprecated `tone`. */
-declare function resolveIconTileVariants({ intent, tone, size }?: IconTileVariantProps): string;
-
-interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, IconTileVariantProps {
-    /** The icon (or any node) rendered centered inside the tile. */
-    icon: React.ReactNode;
-    /** Optional overlay pinned to the top-right corner, e.g. a count badge. */
-    badge?: React.ReactNode;
+    tone?: IconTileTone | null;
+    size?: IconTileSize | null;
+}
+/** The IconTile class string. Accepts `intent` or the deprecated `tone`. */
+declare function resolveIconTileVariants({ intent, tone, size }?: IconTileVariantProps): string;
+
+interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, IconTileVariantProps {
+    /** The icon (or any node) rendered centered inside the tile. */
+    icon: React.ReactNode;
+    /** Optional overlay pinned to the top-right corner, e.g. a count badge. */
+    badge?: React.ReactNode;
+}
+declare const IconTile: React$1.ForwardRefExoticComponent<IconTileProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * The emphases an Input offers: the shared chrome's `default` (a
+ * `--color-rule-strong` hairline) and `ghost` (no border and no background
+ * until focused). Spelled out rather than aliased to the recipe's private
+ * type so the public declaration names no unexported symbol; the
+ * `satisfies` below keeps the two in step.
+ *
+ * @experimental
+ */
+type InputVariant = "default" | "ghost";
+/**
+ * The 1.31 aliases of `sm` / `md` / `lg` (C-INPUT-SIZE). No known consumer
+ * uses them; they leave with `inputSize` in 3.0.
+ *
+ * @deprecated Use `size="sm"`, `"md"` or `"lg"`.
+ * @experimental
+ */
+type InputSizeAlias = "compact" | "default" | "comfortable";
+/**
+ * The size names an Input knows (W4-05, ADR-013): the shared control scale
+ * `xs · sm · md · lg · xl` (`ControlSize`) and the 1.31 aliases.
+ *
+ * `sm` and `md` are today's pixels *and* the scale's steps (32 / 36px), so
+ * they read `--control-height-{sm,md}` and follow the density scope. `lg` is
+ * the A1 mismatch recorded in `baselines/size-geometry.json` (44px where the
+ * scale says 40): it keeps today's pixels through the D5-gated compat token
+ * `--input-height-lg` until decision D5 (W2-05). `xs` and `xl` are new and
+ * read the shared rows in full. Padding and text of the compat rows stay on
+ * Tailwind's steps — nothing about them moves until D5.
+ *
+ * @experimental
+ */
+type InputSize = ControlSize | InputSizeAlias;
+/**
+ * What {@link inputVariants} takes: the emphasis, the size (either name — the
+ * new `size` wins when both are given) and cva's class props.
+ *
+ * @experimental
+ */
+interface InputVariantsOptions {
+    variant?: InputVariant | null;
+    size?: InputSize | null;
+    /**
+     * The legacy size prop (C-INPUT-SIZE): today's rows, byte for byte, so a
+     * call that has not moved to `size` renders the classes it always did.
+     *
+     * @deprecated Use `size`. Codemod CM-07 renames it.
+     */
+    inputSize?: InputSize | null;
+    class?: string | null;
+    className?: string | null;
 }
-declare const IconTile: React$1.ForwardRefExoticComponent<IconTileProps & React$1.RefAttributes<HTMLDivElement>>;
-
+/** The variant props of `inputVariants` (cva's `VariantProps` shape, kept for the API report). */
+type InputVariants = Omit<InputVariantsOptions, "class" | "className">;
 /**
- * Input variants. Mirrors the raw HTML `<input>` styled per the suite tokens
- * (rule-strong border, surface bg, accent focus ring).
+ * The Input class recipe (W4-05): the shared control chrome
+ * (`behavior/control-chrome.ts` — border, VN-5 focus edge + field halo,
+ * `aria-invalid`, `disabled`, `ghost`) called with the emphasis and, for the
+ * scale steps `xs` / `xl`, the shared size row; then the file-selector reset
+ * and, for the compat sizes, Input's own row (see {@link InputSize}).
+ *
+ * Emits the same *set* of classes as the cva it replaces for every legacy
+ * `variant` × `inputSize` (`src/primitives/__tests__/input-chrome-classes.test.tsx`
+ * pins the set and the browser test pins the pixels); only the position of
+ * the file reset moved, which Tailwind does not read. Server-safe.
+ *
+ * @experimental
+ */
+declare function inputVariants({ variant, size, inputSize, class: classProp, className, }?: InputVariantsOptions): string;
+/**
+ * Props of `Input` (W4-05; target architecture §24.3, §29.1).
+ *
+ * @experimental The name is exported since W4-05; the props it lists have been
+ * stable since 1.x.
  */
-declare const inputVariants: (props?: ({
-    variant?: "ghost" | "default" | null | undefined;
-    inputSize?: "sm" | "md" | "lg" | "default" | "compact" | "comfortable" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type InputVariants = VariantProps<typeof inputVariants>;
 interface InputProps$1 extends Omit<React.InputHTMLAttributes<HTMLInputElement>, "size">, InputVariants {
+    /**
+     * Sugar for the field label: renders the label above the control, bound
+     * through the field wiring (`htmlFor`/`id`), exactly as
+     * `<Field><Label>…</Label><Input/></Field>` binds it.
+     */
     label?: string;
     /**
      * Render `label` inside the field instead of stacked above it: it rests like
@@ -1782,10 +2240,50 @@ interface InputProps$1 extends Omit<React.InputHTMLAttributes<HTMLInputElement>,
      * ("e.g. 555-0100") can still sit behind the label without competing with it.
      */
     floatingLabel?: boolean;
+    /**
+     * Sugar for the hint text under the control, referenced first in the
+     * control's `aria-describedby` (before `error`).
+     */
+    description?: string;
+    /**
+     * Sugar for the error message: renders it under the control, linked through
+     * `aria-describedby`, and marks the control invalid.
+     */
     error?: string;
-    prefixIcon?: React.ReactNode;
-    suffixIcon?: React.ReactNode;
+    /**
+     * The value is invalid without a message to show: `aria-invalid`,
+     * `data-invalid` and the chrome's invalid treatment. Implied by `error`.
+     */
+    invalid?: boolean;
+    prefixIcon?: ReactNode;
+    suffixIcon?: ReactNode;
+    /**
+     * Called with the new string value on every change, next to `onChange`
+     * (which keeps receiving the event).
+     */
+    onValueChange?: (value: string) => void;
+    /**
+     * Classes per anatomy part (the `input-*` slots). The `<input>` is
+     * the root part and takes `className` (C-INPUT-CLASSNAME), so it has no
+     * entry here.
+     */
+    classNames?: Partial<Record<Exclude<InputSlot, "root">, string>>;
+    /**
+     * Classes for the outer wrapper around the control and its parts.
+     * Transitional (C-INPUT-CLASSNAME): `className` keeps landing on the
+     * `<input>` because 192 consumer overrides depend on it; this is the name
+     * for the wrapper until `className` moves there in 3.0.
+     */
+    rootClassName?: string;
 }
+/**
+ * A single-line text field (target architecture §24, §29). The control is a
+ * native `<input>` and takes part in a form on its own. Inside a `Field` it
+ * binds itself through `useFieldControl` — id, name, `aria-describedby`,
+ * invalid / required / disabled come from the field; explicit props win. The
+ * `label` / `description` / `error` sugar renders the same wiring around the
+ * control for the call sites that never adopt the compound form.
+ */
 declare const Input: React$1.ForwardRefExoticComponent<InputProps$1 & React$1.RefAttributes<HTMLInputElement>>;
 
 interface KeyboardShortcut {
@@ -1818,6 +2316,14 @@ declare const labelVariants: (props?: class_variance_authority_types.ClassProp |
 interface LabelProps extends React$1.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>, VariantProps<typeof labelVariants> {
     required?: boolean;
 }
+/**
+ * The label of a form control. On its own, a `<label>` that names the
+ * control `htmlFor` points to. Inside a `Field` (W4-01, target architecture
+ * §24) it binds itself: `htmlFor` is the field's control id, `id` is the id a
+ * non-native control references through `aria-labelledby`, `required` and
+ * `optional` come from the field, and a click focuses a control that
+ * `htmlFor` cannot reach (a `div` editor). Explicit props win.
+ */
 declare const Label: React$1.ForwardRefExoticComponent<LabelProps & React$1.RefAttributes<HTMLLabelElement>>;
 
 interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">, ButtonIconProps {
@@ -1845,7 +2351,7 @@ interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorEl
     children: React.ReactNode;
     className?: string;
     /**
-     * Render a native `<a>` instead of `next/link`. Use for:
+     * Render a native `<a>` instead of the router link. Use for:
      *   - cross-origin URLs (e.g. https://other-app.example/sign-in)
      *   - same-origin `/api/*` route handlers that 302-redirect off-app
      *     (next/link tries to client-route, which doesn't follow the 302)
@@ -1871,7 +2377,10 @@ interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorEl
  * Shares `buttonVariants` so styling stays in lock-step: the same `variant`
  * + `intent` axes and the same legacy aliases (W3-02).
  *
- * - Default: renders `next/link` (client-routed internal navigation).
+ * - Default: renders the provider's `linkComponent` (W5-21, ADR-010) when a
+ *   `DesignSystemProvider` supplies one, else `next/link` (client-routed
+ *   internal navigation). The static `next/link` import stays until 2.0
+ *   (C-NEXT-PEER), so a Next.js app without a provider is unchanged.
  * - `external`: renders a native `<a>` so the browser handles the request
  *   end-to-end. Required for cross-origin URLs and same-origin `/api/*`
  *   handlers that 302 off-app.
@@ -1918,6 +2427,11 @@ declare const LoadingRows: React$1.ForwardRefExoticComponent<LoadingRowsProps &
  *   - `productName` (the suffix text; `null` renders just "Assure")
  *   - `className`, `iconClassName`, `textClassName` (style overrides)
  *
+ * The link and the wordmark image are the provider's `linkComponent` /
+ * `imageComponent` when a `DesignSystemProvider` supplies them (W5-21,
+ * ADR-010), else `next/link` / `next/image`; the static imports stay until 2.0
+ * (C-NEXT-PEER), so a Next.js app without a provider is unchanged.
+ *
  * By default the lockup is a link (`href="/"`). Pass `href={null}` to render a
  * non-interactive `<span>` wrapper instead — required when embedding the lockup
  * inside another interactive element (a menu trigger `<button>`, a
@@ -2044,27 +2558,99 @@ declare namespace MultiSelectField {
     var displayName: string;
 }
 
+/**
+ * Props of `NumberInput`. Everything a text `<input>` takes except the
+ * value-shaped attributes the component owns (`value`, `defaultValue`,
+ * `onChange`, `type`, `min`, `max`, `step`, `size`).
+ *
+ * @experimental
+ */
+interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "type" | "min" | "max" | "step" | "size"> {
+    /** The controlled value; `null` is an empty field. */
+    value?: number | null;
+    /** The initial value while uncontrolled. */
+    defaultValue?: number | null;
+    /** Called with the new value on every change; `null` when the field is emptied. */
+    onValueChange?: (value: number | null) => void;
+    /**
+     * The BCP 47 locale the value is formatted and parsed in: this prop, else
+     * `DesignSystemProvider locale`, else `"en-US"` on the server and the client
+     * alike (A3) — never `navigator.language`.
+     */
+    locale?: string;
+    /** `Intl.NumberFormat` options: fraction digits, `style: "currency"`, `style: "percent"`, … */
+    formatOptions?: Intl.NumberFormatOptions;
+    /** The lowest committed value; ArrowDown and Home stop here. */
+    min?: number;
+    /** The highest committed value; ArrowUp and End stop here. */
+    max?: number;
+    /** The increment of the arrow keys. Default `1`. */
+    step?: number;
+    /** The control scale (`--control-*-<size>`). Default `md`. */
+    size?: ControlSize;
+    /**
+     * `default` draws the field border; `ghost` draws none until focused. The
+     * words are `ControlChromeVariant` (`behavior/control-chrome.ts`), spelled
+     * out so the public declaration names no unexported type.
+     */
+    variant?: "default" | "ghost";
+    /** Marks the control invalid (`aria-invalid`, danger chrome); a surrounding `Field` can set it too. */
+    invalid?: boolean;
+    /** One class per part, keyed by `NumberInputSlot`. `root` is the `<input>`, the element `className` lands on too. */
+    classNames?: Partial<Record<NumberInputSlot, string>>;
+}
+/**
+ * The design-system number field: a locale-formatted `number | null` that
+ * submits its canonical value and reads as a spinbutton.
+ *
+ * @experimental
+ */
+declare const NumberInput: React$1.ForwardRefExoticComponent<NumberInputProps & React$1.RefAttributes<HTMLInputElement>>;
+
+/**
+ * Props of `OTPInput`.
+ *
+ * @experimental The Field / form additions of W4-23 (`onValueChange`,
+ * `required`, `form`, `invalid`, an optional `name`) are experimental; the
+ * legacy props keep their contract.
+ */
 interface OTPInputProps {
-    name: string;
+    /** The form field name. Optional since W4-23: a surrounding `Field` can supply it. */
+    name?: string;
     length?: number;
     error?: string;
+    /**
+     * Move focus into the code on mount. Opt-in: only for a screen whose one
+     * purpose is the code (step-up auth, post-redirect verification), never in
+     * a form with other fields. Documented in the `AutoFocus` story.
+     */
     autoFocus?: boolean;
     className?: string;
     defaultValue?: string;
     /** Optional controlled value (additive). */
     value?: string;
-    /** Optional controlled onChange (additive). */
+    /** Optional controlled onChange (additive). Fires with the same string as `onValueChange`. */
     onChange?: (value: string) => void;
+    /** Called with the new code on every change (ADR-006 spelling). */
+    onValueChange?: (value: string) => void;
     /** Optional callback fired when all slots are filled (additive). */
     onComplete?: (value: string) => void;
     /** Optional id for the underlying input (additive). */
     id?: string;
     /** Optional disabled flag (additive). */
     disabled?: boolean;
-    /** Accessible label for the underlying one-time-code input. */
+    /** Block native submission while the code is empty. */
+    required?: boolean;
+    /** `id` of the form to submit with when the input is rendered outside it. */
+    form?: string;
+    /** Marks the input invalid without a message of its own; `error` and a `Field` can set it too. */
+    invalid?: boolean;
+    /** Accessible label for the underlying one-time-code input. A `Field` label takes precedence. */
     "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
 }
-declare function OTPInput({ name, length, error, autoFocus, className, defaultValue, value, onChange, onComplete, id, disabled, "aria-label": ariaLabel, }: OTPInputProps): react_jsx_runtime.JSX.Element;
+declare function OTPInput({ name, length, error, autoFocus, className, defaultValue, value: valueProp, onChange, onValueChange, onComplete, id, disabled, required, form, invalid, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, }: OTPInputProps): react_jsx_runtime.JSX.Element;
 declare namespace OTPInput {
     var displayName: string;
 }
@@ -2142,14 +2728,6 @@ interface PdfPreviewProps extends React.HTMLAttributes<HTMLDivElement>, VariantP
 }
 declare const PdfPreview: React$1.ForwardRefExoticComponent<PdfPreviewProps & React$1.RefAttributes<HTMLDivElement>>;
 
-type InputProps = React.ComponentProps<typeof Input>;
-interface PhoneInputProps extends Omit<InputProps, "type" | "onChange" | "value" | "defaultValue"> {
-    value?: string;
-    defaultValue?: string;
-    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
-}
-declare const PhoneInput: React$1.ForwardRefExoticComponent<Omit<PhoneInputProps, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
-
 interface CountryCode {
     iso: string;
     name: string;
@@ -2171,14 +2749,108 @@ declare function parsePhoneForEditing(phone: string): {
     localPhone: string;
 };
 
+/**
+ * Every string the phone field renders, so a consumer can localise it until
+ * the messages contract of the provider lands (W5-20, ADR-010).
+ * Deterministic English defaults (A3).
+ *
+ * @experimental
+ */
+interface PhoneFieldMessages {
+    /** The accessible name of the country combobox. */
+    country: string;
+    /** The placeholder of the country combobox while its list is open. */
+    searchCountries: string;
+    /** The empty state when the query matches no country. */
+    noCountries: string;
+}
+declare const DEFAULT_PHONE_FIELD_MESSAGES: PhoneFieldMessages;
+/** What `onValueChange` is told besides the E.164 value. @experimental */
+interface PhoneFieldChangeDetails {
+    /** The ISO 3166-1 alpha-2 code of the picked country. */
+    country: string;
+    /** The national digits as typed, without the dial code. */
+    nationalNumber: string;
+}
+/**
+ * Props of `PhoneField`. Everything a `tel` `<input>` takes except the
+ * value-shaped attributes the component owns.
+ *
+ * @experimental
+ */
+interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "type" | "size"> {
+    /** The controlled E.164 value; `null` (or `""`) is an empty field. */
+    value?: string | null;
+    /** The initial E.164 value while uncontrolled. */
+    defaultValue?: string | null;
+    /** Called with the E.164 value on every change; `null` when the number is emptied. */
+    onValueChange?: (value: string | null, details: PhoneFieldChangeDetails) => void;
+    /**
+     * The controlled country (ISO 3166-1 alpha-2). Without `onCountryChange`
+     * the country is fixed and the picker is not rendered.
+     */
+    country?: string;
+    /** The initial country while uncontrolled. Default `"US"`. */
+    defaultCountry?: string;
+    onCountryChange?: (country: string) => void;
+    /** The countries offered. Default: every entry of `COUNTRY_CODES`. */
+    countries?: readonly CountryCode[];
+    /** The control scale (`--control-*-<size>`). Default `md`. */
+    size?: ControlSize;
+    /**
+     * `default` draws the field border; `ghost` draws none until focused. The
+     * words are `ControlChromeVariant` (`behavior/control-chrome.ts`).
+     */
+    variant?: "default" | "ghost";
+    /** Marks the control invalid (`aria-invalid`, danger chrome); a surrounding `Field` can set it too. */
+    invalid?: boolean;
+    messages?: Partial<PhoneFieldMessages>;
+    /** One class per part, keyed by `PhoneFieldSlot`. `root` is the row, the element `className` lands on too. */
+    classNames?: Partial<Record<PhoneFieldSlot, string>>;
+}
+/**
+ * The design-system phone field: a country picker beside a national number,
+ * one E.164 value.
+ *
+ * @experimental
+ */
+declare const PhoneField: React$1.ForwardRefExoticComponent<PhoneFieldProps & React$1.RefAttributes<HTMLInputElement>>;
+
+type InputProps = React.ComponentProps<typeof Input>;
+interface PhoneInputProps extends Omit<InputProps, "type" | "onChange" | "value" | "defaultValue"> {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * @deprecated Use `PhoneField` (`country="US"` for the fixed-country mode;
+ * `value` is E.164). Removed in 3.0.
+ */
+declare const PhoneInput: React$1.ForwardRefExoticComponent<Omit<PhoneInputProps, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
+
+/**
+ * The legacy flag: the same 20×14 box and ISO fallback as before, drawn from
+ * `PhoneField`'s lazily loaded flag set (a same-size placeholder until it
+ * lands).
+ *
+ * @deprecated Use `PhoneField`'s `CountryFlag`. Removed in 3.0.
+ */
 declare function CountryFlag({ iso }: {
     iso: string;
 }): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Use `PhoneField` (its country picker is a `Combobox`). Removed
+ * in 3.0.
+ */
 declare function CountrySelect({ value, onChange, disabled, }: {
     value: string;
     onChange: (iso: string) => void;
     disabled?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Use `PhoneField`: one E.164 `value` / `onValueChange`, Field
+ * binding and form submission built in. Removed in 3.0.
+ */
 declare function PhoneCountryInput({ countryIso, localPhone, onCountryChange, onPhoneChange, placeholder, error, disabled, id, }: {
     countryIso: string;
     localPhone: string;
@@ -2365,10 +3037,27 @@ interface ProgressRingProps extends React.HTMLAttributes<HTMLDivElement>, Progre
 }
 declare const ProgressRing: React$1.ForwardRefExoticComponent<ProgressRingProps & React$1.RefAttributes<HTMLDivElement>>;
 
-declare const RadioGroup: React$1.ForwardRefExoticComponent<Omit<RadioGroupPrimitive.RadioGroupProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/** How the items render: the bare radio (`plain`, default) or a selectable card. */
+type RadioGroupAppearance = "plain" | "card";
+interface RadioGroupProps extends React$1.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Root> {
+    /** `card` renders each item as a bordered, clickable card with its label and description. */
+    appearance?: RadioGroupAppearance;
+    /**
+     * The group is in error: `aria-invalid` and `data-invalid` on the group
+     * and `aria-invalid` on every item. Implied by the surrounding `Field`'s
+     * `invalid` or a mounted `FieldError`.
+     */
+    invalid?: boolean;
+}
+declare const RadioGroup: React$1.ForwardRefExoticComponent<RadioGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 interface RadioGroupItemProps extends React$1.ComponentPropsWithoutRef<typeof RadioGroupPrimitive.Item> {
     /** Optional inline label rendered to the right of the radio */
     label?: string;
+    /**
+     * Secondary text under the label, referenced by the radio through
+     * `aria-describedby`. Rendered only with `appearance="card"` on the group.
+     */
+    description?: React$1.ReactNode;
 }
 declare const RadioGroupItem: React$1.ForwardRefExoticComponent<RadioGroupItemProps & React$1.RefAttributes<HTMLButtonElement>>;
 
@@ -2399,7 +3088,7 @@ interface RankedBarsProps extends React.HTMLAttributes<HTMLUListElement> {
 }
 declare const RankedBars: React$1.ForwardRefExoticComponent<RankedBarsProps & React$1.RefAttributes<HTMLUListElement>>;
 
-type SheetSide = "top" | "right" | "bottom" | "left";
+type SheetSide$1 = "top" | "right" | "bottom" | "left";
 type DialogSize = "sm" | "md" | "lg" | "full";
 interface ResponsiveDialogProps {
     /** Controlled open state. */
@@ -2420,7 +3109,7 @@ interface ResponsiveDialogProps {
     /** Class applied to the rendered Sheet/Dialog content surface. */
     className?: string;
     /** Sheet side on mobile. Default `"bottom"`. */
-    side?: SheetSide;
+    side?: SheetSide$1;
     /** Desktop Dialog max-width preset. Default `"md"`. */
     size?: DialogSize;
 }
@@ -2459,18 +3148,78 @@ interface ScrollAreaProps extends React$1.ComponentPropsWithoutRef<typeof Scroll
 declare const ScrollArea: React$1.ForwardRefExoticComponent<ScrollAreaProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const ScrollBar: React$1.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-declare const searchInputVariants: (props?: ({
-    inputSize?: "sm" | "md" | "lg" | "default" | "compact" | "comfortable" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type SearchInputVariants = VariantProps<typeof searchInputVariants>;
+/**
+ * The size names a SearchInput knows (W4-07): the three steps Input's compat
+ * rows cover, plus the 1.31 aliases (deprecated with `inputSize`).
+ *
+ * @experimental
+ */
+type SearchInputSize = Extract<ControlSize, "sm" | "md" | "lg"> | InputSizeAlias;
+
+/**
+ * What {@link searchInputVariants} takes: the size (either name — `size`
+ * wins when both are given) and cva's class props.
+ *
+ * @experimental
+ */
+interface SearchInputVariantsOptions {
+    size?: SearchInputSize | null;
+    /**
+     * The legacy size prop (C-INPUT-SIZE): today's rows, byte for byte.
+     *
+     * @deprecated Use `size`. Codemod CM-07 renames it.
+     */
+    inputSize?: SearchInputSize | null;
+    class?: string | null;
+    className?: string | null;
+}
+/** The variant props of `searchInputVariants` (cva's `VariantProps` shape, kept for the API report). */
+type SearchInputVariants = Omit<SearchInputVariantsOptions, "class" | "className">;
+/**
+ * The SearchInput class recipe (W4-07): the shared control chrome
+ * (`behavior/control-chrome.ts`) in its `default` emphasis and no height
+ * row, the native search-decoration reset, then the row of the size.
+ *
+ * Against the cva it replaces (W4-03 mapping, PR #199) the set of classes
+ * gains the chrome's `aria-[invalid=true]` rows — inert until a caller sets
+ * `aria-invalid` — and is otherwise identical for every legacy `inputSize`;
+ * `border-rule-strong` moved after the base, which Tailwind does not read.
+ * Server-safe.
+ *
+ * @experimental
+ */
+declare function searchInputVariants({ size, inputSize, class: classProp, className, }?: SearchInputVariantsOptions): string;
+/**
+ * Props of `SearchInput` (W4-07).
+ *
+ * @experimental The name is exported since W4-07; the props it lists have been
+ * stable since 1.x.
+ */
 interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange" | "size">, SearchInputVariants {
+    /** The current query (controlled). */
     value: string;
+    /** Called with the new query on every keystroke and with `""` when cleared or the form resets. */
     onValueChange: (value: string) => void;
+    /** Called with the query once it has been stable for `debounceMs`. */
     onSearch?: (value: string) => void;
+    /** Default 300. */
     debounceMs?: number;
+    /** Overrides of the copy the component renders (English defaults). */
+    messages?: Partial<SearchInputMessages>;
+    /**
+     * Classes per anatomy part (the `search-input-*` slots). The wrapper
+     * is the root part and takes `className`, so it has no entry here.
+     */
+    classNames?: Partial<Record<Exclude<SearchInputSlot, "root">, string>>;
 }
+/**
+ * A search field. The control is a native `<input type="search">`
+ * (`role="searchbox"`); name it with `aria-label`, or through a `Field`,
+ * which it binds to with `useFieldControl`.
+ */
 declare const SearchInput: React$1.ForwardRefExoticComponent<SearchInputProps & React$1.RefAttributes<HTMLInputElement>>;
 
+/** @deprecated Use `Combobox` with `Option` (`{ value, label }`). Removed in 3.0 (C-SEARCHSELECT, CM-08). */
 interface SearchSelectOption {
     id: string;
     label: string;
@@ -2504,6 +3253,7 @@ interface SearchSelectOption {
      */
     description?: string;
 }
+/** @deprecated Use `ComboboxProps`. Removed in 3.0 (C-SEARCHSELECT, CM-08). */
 interface SearchSelectProps {
     options: SearchSelectOption[];
     /**
@@ -2566,8 +3316,22 @@ interface SearchSelectProps {
      * reads as a tag instead of running into the label. Single-mode only.
      */
     descriptionVariant?: "inline" | "pill";
+    /** The accessible name (W4-12). Without it, `placeholder` names the input as before. */
+    "aria-label"?: string;
+    /** Names the input from another element, for example a visible label (W4-12). */
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    /** The input's id, so a `<label htmlFor>` can point at it (W4-12). */
+    id?: string;
 }
-declare function SearchSelect({ options, selected: selectedProp, onSelect: onSelectProp, onRemove: onRemoveProp, value, onValueChange, onCreate, placeholder, className, disabled, groupFilter, pinnedGroups, closeOnSelect: closeOnSelectProp, showGroupCounts, onCreateNew, createNewLabel, descriptionVariant, }: SearchSelectProps): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Use `Combobox` (single: `value` / `onValueChange` with `null` for
+ * empty; multi: `multiple` with `TValue[]`) and the `Option` shape
+ * (`{ value, label }`). `SearchSelect` is an adapter over it and is removed in
+ * 3.0 (compatibility registry C-SEARCHSELECT); codemod CM-08 rewrites call
+ * sites and flags the ones a human must look at.
+ */
+declare function SearchSelect({ options, selected: selectedProp, onSelect: onSelectProp, onRemove: onRemoveProp, value, onValueChange, onCreate, placeholder, className, disabled, groupFilter, pinnedGroups, closeOnSelect: closeOnSelectProp, showGroupCounts, onCreateNew, createNewLabel, descriptionVariant, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, id, }: SearchSelectProps): react_jsx_runtime.JSX.Element;
 declare namespace SearchSelect {
     var displayName: string;
 }
@@ -2645,10 +3409,53 @@ declare const SegmentedProgress: React$1.ForwardRefExoticComponent<SegmentedProg
 declare const SelectRoot: React$1.FC<SelectPrimitive.SelectProps>;
 declare const SelectGroup: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React$1.RefAttributes<HTMLSpanElement>>;
-declare const SelectTrigger: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+/**
+ * The Select sizes: the shared control scale, nothing else (A1, ADR-013).
+ *
+ * @experimental
+ */
+type SelectSize = ControlSize;
+/**
+ * The parts a `classNames` entry can reach on the options-driven `Select`,
+ * keyed by the anatomy (ADR-008 decision 4). `value` is a span of ours
+ * around Radix's value (Radix's own span drops `className`), rendered only
+ * when `classNames.value` or `clearable` asks for it, so a legacy call keeps
+ * the `SelectTrigger > span` structure C-DOM-10 freezes.
+ *
+ * @experimental
+ */
+type SelectClassNames = Partial<Record<SelectSlot, string>>;
+
+/**
+ * Props of `SelectTrigger`: Radix's trigger props plus the control-scale
+ * `size` and a class for the chevron.
+ *
+ * @experimental `size` and `classNames`
+ */
+interface SelectTriggerProps extends React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger> {
+    /**
+     * Height, horizontal padding, label size, gap and glyph size from the shared
+     * control scale (A1). Omitted, the trigger keeps its legacy geometry (36px,
+     * the same pixels as `md`).
+     */
+    size?: SelectSize | null;
+    /** Classes for the parts the trigger renders itself: the chevron `icon`. */
+    classNames?: Pick<SelectClassNames, "icon">;
+}
+declare const SelectTrigger: React$1.ForwardRefExoticComponent<SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const SelectScrollUpButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectScrollDownButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const SelectContent: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Props of `SelectContent`: Radix's content props plus a class for the
+ * viewport (C-DOM-19's `[data-radix-select-viewport]` selector replacement).
+ *
+ * @experimental `classNames`
+ */
+interface SelectContentProps extends React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Content> {
+    /** Classes for the parts the content renders itself: the scrolling `viewport`. */
+    classNames?: Pick<SelectClassNames, "viewport">;
+}
+declare const SelectContent: React$1.ForwardRefExoticComponent<SelectContentProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectItem: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectSeparator: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -2665,26 +3472,104 @@ interface SelectOption {
 interface SelectProps {
     /** Option list. Required to preserve legacy API. */
     options: SelectOption[];
-    /** Controlled value. */
-    value?: string;
-    /** Uncontrolled initial value. */
-    defaultValue?: string;
+    /**
+     * Controlled value. `null` is "nothing selected" (target architecture §32);
+     * `""` means the same and stays accepted through 2.x (C-SELECT-EMPTY).
+     */
+    value?: string | null;
+    /** Uncontrolled initial value; restored on form reset. `null` = nothing selected. */
+    defaultValue?: string | null;
+    /**
+     * Called with the picked option's value, and with `""` when the selection
+     * is cleared (`clearable`) — the signature every existing handler already
+     * has. Reporting `null` is a 3.0 change (C-SELECT-EMPTY).
+     */
     onValueChange?: (value: string) => void;
     placeholder?: string;
-    /** Accepted for back-compat. NO-OP — see file header for migration. */
+    /**
+     * @deprecated NO-OP: Radix Select cannot filter. Use `Combobox` (or
+     * `SearchSelect`) for filterable selection. Warns once in development;
+     * removed in 2.0 (C-SELECT-DEAD, codemod CM-11).
+     */
     searchable?: boolean;
     disabled?: boolean;
+    /**
+     * Submit the value under this name through the form the trigger sits in
+     * (or `form`). Inside a `<Field name>` the field's name applies.
+     */
     name?: string;
+    /**
+     * Block native submission while nothing is selected; the trigger carries
+     * `aria-required`. Inside a `<Field required>` the field's flag applies.
+     */
     required?: boolean;
+    /**
+     * The `id` of the form to submit with when the trigger is rendered outside
+     * it — inside a portalled Dialog or Sheet (ADR-006).
+     *
+     * @experimental
+     */
+    form?: string;
+    /**
+     * The trigger's `id`; inside a `<Field>` the field's control id applies.
+     *
+     * @experimental
+     */
+    id?: string;
+    /**
+     * The control scale (A1, ADR-013): `xs` 28 · `sm` 32 · `md` 36 · `lg` 40 ·
+     * `xl` 48. Omitted, the trigger keeps its legacy 36px row; a `<Field size>`
+     * supplies it.
+     *
+     * @experimental
+     */
+    size?: SelectSize;
+    /**
+     * Show a clear button beside the chevron while a value is selected. Clearing
+     * reports `""` through `onValueChange` and focuses the trigger. Renders the
+     * `root` part (`data-slot="select"`) around the trigger — `className` lands
+     * on that wrapper then, `classNames.trigger` on the trigger.
+     *
+     * @experimental
+     */
+    clearable?: boolean;
+    /**
+     * The outermost element's class: the trigger, or the `root` wrapper when
+     * `clearable`.
+     */
     className?: string;
-    /** Forwarded to the trigger. */
+    /**
+     * One class per part (ADR-008 decision 4): `trigger`, `value`, `icon`
+     * (chevron), `content`, `viewport`, `item`, `clear`, `root`. Each part's
+     * class comes after the design system's own and before `className`.
+     * `value` wraps Radix's value span in one of ours (see `SelectClassNames`).
+     *
+     * @experimental
+     */
+    classNames?: SelectClassNames;
+    /** Overrides of the copy the select renders (English defaults until W5-20). */
+    messages?: Partial<SelectMessages>;
+    /**
+     * @deprecated Use `classNames.trigger` (C-CLASSNAME-PROPS, codemod CM-11).
+     * Removed in 3.0.
+     */
     triggerClassName?: string;
-    /** Forwarded to the content. */
+    /**
+     * @deprecated Use `classNames.content` (C-CLASSNAME-PROPS, codemod CM-11).
+     * Removed in 3.0.
+     */
     contentClassName?: string;
-    /** aria-invalid + danger styling on trigger. */
+    /** aria-invalid + danger styling on trigger. Inside a `<Field invalid>` the field's flag applies. */
     "aria-invalid"?: boolean;
-    /** aria-label fallback when there is no visible label. */
+    /**
+     * aria-label fallback when there is no visible label. Inside a `<Field>`
+     * with a `Label` the trigger is named by the label instead.
+     */
     "aria-label"?: string;
+    /** Explicit `aria-labelledby`; wins over the surrounding `Field`. */
+    "aria-labelledby"?: string;
+    /** Explicit `aria-describedby`; appended after the field's description and error. */
+    "aria-describedby"?: string;
 }
 /**
  * Convenience `Select` — preserved options-driven API.
@@ -2700,15 +3585,48 @@ interface SelectProps {
  *     </SelectContent>
  *   </SelectRoot>
  */
-declare function Select({ options, value, defaultValue, onValueChange, placeholder, searchable, disabled, name, required, className, triggerClassName, contentClassName, "aria-invalid": ariaInvalid, "aria-label": ariaLabel, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select({ options, value: valueProp, defaultValue: defaultValueProp, onValueChange, placeholder, searchable, disabled: disabledProp, name: nameProp, required: requiredProp, form, id: idProp, size: sizeProp, clearable, className, classNames, messages, triggerClassName, contentClassName, "aria-invalid": ariaInvalid, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, }: SelectProps): react_jsx_runtime.JSX.Element;
 declare namespace Select {
     var displayName: string;
 }
 
 declare const Separator: React$1.ForwardRefExoticComponent<Omit<SeparatorPrimitive.SeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-type Side = "top" | "right" | "bottom" | "left";
-type SheetWidth = "default" | "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * The edge a `Sheet` slides in from.
+ *
+ * @experimental
+ */
+type SheetSide = "top" | "right" | "bottom" | "left";
+type Side = SheetSide;
+/**
+ * Width of a left/right `SheetContent`, as a step of the sheet width scale
+ * (W5-07): `sm` 420px · `md` 520px · `lg` 640px · `xl` 760px from the `sm`
+ * breakpoint (95vw below it) · `full` the viewport. Omitted, the panel keeps
+ * its 1.x geometry (`w-3/4 max-w-sm`). Every step and the default yield to
+ * `--ds-sheet-width` when a consumer sets it. Top/bottom sheets span the
+ * viewport and ignore it.
+ *
+ * @experimental
+ */
+type SheetSize = "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * What the deprecated `width` prop accepts: the size steps plus `default`.
+ *
+ * @deprecated Use `size` (C-SHEET-WIDTH, codemod CM-11). Removed in 3.0.
+ * @experimental
+ */
+type SheetWidth = "default" | SheetSize;
+/**
+ * The copy a `Sheet` renders (target architecture §24.5). English defaults
+ * until the messages contract of the provider lands (W5-20).
+ *
+ * @experimental
+ */
+interface SheetMessages {
+    /** The accessible name of the built-in close button. Default `"Close"`. */
+    close: string;
+}
 interface SheetProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Root> {
     /**
      * Default side for SheetContent if it doesn't specify its own.
@@ -2725,31 +3643,72 @@ declare const SheetTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.Di
 declare const SheetClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const SheetPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
 declare const SheetOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const sheetVariants: (props?: ({
-    side?: "left" | "right" | "bottom" | "top" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface SheetContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content>, VariantProps<typeof sheetVariants> {
+/**
+ * Props of `SheetContent`: Radix's content props plus the side, the sizing
+ * and the dismiss options.
+ *
+ * @experimental
+ */
+interface SheetContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
+    /** The edge the panel slides in from. Default `right` (or the `Sheet` root's `side`). */
+    side?: SheetSide | null;
+    /**
+     * Width step for left/right sheets. Omit for the 1.x geometry
+     * (`w-3/4 max-w-sm`). See {@link SheetSize}.
+     */
+    size?: SheetSize;
     /** If false, the built-in close button is hidden. Default: true. */
     showCloseButton?: boolean;
     /**
-     * Width preset for left/right sheets. Omit for the historical default
-     * (`w-3/4 max-w-sm`). Top/bottom sheets ignore this prop.
+     * The accessible name of the built-in close button. Takes precedence over
+     * `messages.close`. Default `"Close"`.
+     */
+    closeLabel?: string;
+    /** Overrides of the copy the sheet renders (English defaults until W5-20). */
+    messages?: Partial<SheetMessages>;
+    /**
+     * Width preset for left/right sheets — the same steps as `size`, plus
+     * `default`. When both are given `size` wins.
+     *
+     * @deprecated Use `size` (C-SHEET-WIDTH, codemod CM-11). Removed in 3.0.
      */
     width?: SheetWidth;
     /**
-     * Custom CSS width for left/right sheets, e.g. `"520px"` or
-     * `"min(95vw, 720px)"`. Prefer `width` presets unless a product surface
-     * has a proven one-off contract.
+     * Custom CSS width for left/right sheets, e.g. `"520px"`, rendered as an
+     * inline `width` with `max-width: 95vw`.
+     *
+     * @deprecated Set the `--ds-sheet-width` custom property instead
+     * (C-SHEET-WIDTH, codemod CM-11). Removed in 3.0.
      */
     customWidth?: string;
 }
-declare const SheetContent: React$1.ForwardRefExoticComponent<SheetContentProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const SheetHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
-    displayName: string;
-};
+declare const SheetContent: React$1.ForwardRefExoticComponent<SheetContentProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const SheetHeader: {
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+/**
+ * Props of `SheetBody` (W5-07).
+ *
+ * @experimental
+ */
+interface SheetBodyProps extends React$1.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Horizontal padding, matching the header's and footer's `p-6` at `md`
+     * (the default). The panel's own `gap-4` spaces the parts vertically.
+     */
+    padding?: "none" | "sm" | "md" | "lg";
+}
+/**
+ * The scroll region of a sheet between `SheetHeader` and `SheetFooter`
+ * (W5-07): takes the remaining height of the panel and scrolls on its own,
+ * so the header and the footer stay in place.
+ *
+ * @experimental
+ */
+declare const SheetBody: React$1.ForwardRefExoticComponent<SheetBodyProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SheetFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 declare const SheetTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
@@ -2808,11 +3767,42 @@ interface SkeletonCircleProps extends React.HTMLAttributes<HTMLDivElement> {
 }
 declare const SkeletonCircle: React$1.ForwardRefExoticComponent<SkeletonCircleProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * Slider — a Radix slider with the design system's track and thumb (W4-16,
+ * plan §16.1).
+ *
+ * **Form participation** is Radix's own (ADR-006 §1): the thumb is paired
+ * with a hidden native input carrying `name` (`name[]` for a range), the
+ * current value, `disabled` and `form`, so `FormData` holds the number as a
+ * string. Radix Slider does not follow a form `reset`; the wrapper does
+ * (`useFormReset`), restoring `defaultValue`.
+ *
+ * **Field binding** through `useFieldControl`: inside a `Field` the thumb
+ * (the focusable `role="slider"`) references the `Label` through
+ * `aria-labelledby` and the description / error through `aria-describedby`;
+ * `name`, `disabled` and `invalid` come from the field. Explicit props win.
+ * Outside a field the thumb is named by `aria-label`, the `label` sugar, or
+ * "Slider value".
+ *
+ * **Sizes** (`size`, own geometry per plan §2.1): `md` (default) is today's
+ * 6px track and 16px thumb; `sm` and `lg` read the control scale's glyph
+ * tokens for the thumb (`--control-icon-sm` 14px, `--control-icon-xl` 20px)
+ * with a 4px / 8px track.
+ */
+/** The slider sizes: the component's own geometry, `md` is today's. */
+type SliderSize = Extract<ControlSize, "sm" | "md" | "lg">;
 interface SliderProps extends React$1.ComponentPropsWithoutRef<typeof SliderPrimitive.Root> {
-    /** Optional inline label rendered above the track */
+    /** Optional inline label rendered above the track. Names the thumb. */
     label?: string;
     /** When true, renders the current value to the right of the label */
     showValue?: boolean;
+    /** Track and thumb geometry. Default `md` (today's 6px track, 16px thumb). */
+    size?: SliderSize;
+    /**
+     * The slider is in error: `aria-invalid` on the thumb and `data-invalid`
+     * on the root. Implied by the surrounding `Field`'s `invalid`.
+     */
+    invalid?: boolean;
 }
 declare const Slider: React$1.ForwardRefExoticComponent<SliderProps & React$1.RefAttributes<HTMLSpanElement>>;
 
@@ -3258,8 +4248,18 @@ declare const SuiteProgress: React$1.ForwardRefExoticComponent<SuiteProgressProp
 declare const switchVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
+/** The switch sizes: the component's own geometry (`sm` 20×36, `md` 24×44). */
+type SwitchSize = NonNullable<VariantProps<typeof switchVariants>["size"]>;
 interface SwitchProps extends Omit<React$1.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, "size">, VariantProps<typeof switchVariants> {
+    /** Optional inline label rendered to the right of the track. Names the button through `htmlFor`. */
     label?: string;
+    /** The value submitted with `name` while on. Default `"on"`, like a native checkbox. */
+    value?: string;
+    /**
+     * The switch is in error: `aria-invalid` and `data-invalid`. Implied by the
+     * surrounding `Field`'s `invalid` or a mounted `FieldError`.
+     */
+    invalid?: boolean;
 }
 declare const Switch: React$1.ForwardRefExoticComponent<SwitchProps & React$1.RefAttributes<HTMLButtonElement>>;
 
@@ -3311,17 +4311,95 @@ declare namespace TeamMemberSelect {
     var displayName: string;
 }
 
-declare const textareaVariants: (props?: ({
-    variant?: "ghost" | "default" | null | undefined;
-    inputSize?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type TextareaVariants = VariantProps<typeof textareaVariants>;
+/**
+ * The emphases a Textarea offers: the shared chrome's `default` and `ghost`
+ * (spelled out, as on Input, so the public declaration names no unexported
+ * symbol; the `satisfies` keeps it in step with the recipe).
+ *
+ * @experimental
+ */
+type TextareaVariant = "default" | "ghost";
+/**
+ * The size names a Textarea knows (W4-06): the three steps that have a
+ * `--textarea-min-height-<size>` token (64 / 80 / 96px). A textarea grows
+ * with its content, so `size` is a *minimum* height, not the outer height
+ * the shared scale promises (`baselines/size-geometry.json` keeps Textarea
+ * out of A1 on purpose). Padding and text stay on today's steps until D5.
+ *
+ * @experimental
+ */
+type TextareaSize = Extract<ControlSize, "sm" | "md" | "lg">;
+/**
+ * What {@link textareaVariants} takes: the emphasis, the size (either name —
+ * `size` wins when both are given) and cva's class props.
+ *
+ * @experimental
+ */
+interface TextareaVariantsOptions {
+    variant?: TextareaVariant | null;
+    size?: TextareaSize | null;
+    /**
+     * The legacy size prop (C-INPUT-SIZE): today's rows, byte for byte.
+     *
+     * @deprecated Use `size`. Codemod CM-07 renames it.
+     */
+    inputSize?: TextareaSize | null;
+    class?: string | null;
+    className?: string | null;
+}
+/** The variant props of `textareaVariants` (cva's `VariantProps` shape, kept for the API report). */
+type TextareaVariants = Omit<TextareaVariantsOptions, "class" | "className">;
+/**
+ * The Textarea class recipe (W4-06): the shared control chrome
+ * (`behavior/control-chrome.ts`) with the emphasis and no height row, then
+ * the `min-height` row of the size.
+ *
+ * Against the cva it replaces the set of classes differs in one place, on
+ * purpose (W4-03 mapping, PR #199): the motion string is the shared
+ * `microInteractions.control` — same transitioned properties, the feedback
+ * duration token (the same 150ms `--duration-fast` was) and the `enter`
+ * easing where the copy declared none. `tests/browser/textarea-parity.test.tsx`
+ * holds every other computed property equal under each host fixture.
+ * Server-safe.
+ *
+ * @experimental
+ */
+declare function textareaVariants({ variant, size, inputSize, class: classProp, className, }?: TextareaVariantsOptions): string;
+/**
+ * Props of `Textarea` (W4-06).
+ *
+ * @experimental The name is exported since W4-06; the props it lists have been
+ * stable since 1.x.
+ */
 interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "size">, TextareaVariants {
+    /** Sugar for the field label, bound through the field wiring (`htmlFor`/`id`). */
     label?: string;
+    /** Sugar for the hint text under the control, referenced before `error` in `aria-describedby`. */
+    description?: string;
+    /** Sugar for the error message: linked through `aria-describedby`, marks the control invalid. */
     error?: string;
+    /** The value is invalid without a message to show. Implied by `error`. */
+    invalid?: boolean;
+    /** Show `<length>/<maxLength>` under the control. Needs `maxLength`. */
     showCount?: boolean;
+    /** Grow with the content instead of scrolling. */
     autoResize?: boolean;
+    /** Called with the new string value on every change, next to `onChange`. */
+    onValueChange?: (value: string) => void;
+    /**
+     * Classes per anatomy part (the `textarea-*` slots). The `<textarea>`
+     * is the root part and takes `className` (C-INPUT-CLASSNAME), so it has no
+     * entry here.
+     */
+    classNames?: Partial<Record<Exclude<TextareaSlot, "root">, string>>;
+    /** Classes for the outer wrapper (transitional, C-INPUT-CLASSNAME — see `Input`). */
+    rootClassName?: string;
 }
+/**
+ * A multi-line text field. The control is a native `<textarea>`; inside a
+ * `Field` it binds itself through `useFieldControl`, and the
+ * `label` / `description` / `error` sugar renders the same wiring around it.
+ */
 declare const Textarea: React$1.ForwardRefExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
 
 type ToastVariant = "default" | "success" | "destructive" | "warning" | "info" | "loading";
@@ -3373,8 +4451,34 @@ declare function ToastProvider({ children }: ToastProviderProps): react_jsx_runt
 declare const itemVariants: (props?: ({
     variant?: "outline" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-type ToggleGroupRootProps = React$1.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Root> & VariantProps<typeof itemVariants>;
-declare const ToggleGroup: React$1.ForwardRefExoticComponent<ToggleGroupRootProps & React$1.RefAttributes<HTMLDivElement>>;
+/** The toggle-group sizes: the shared control scale (A1). */
+type ToggleGroupSize = ControlSize;
+/** The item's look: bare (`default`) or with a border (`outline`). */
+type ToggleGroupVariant = NonNullable<VariantProps<typeof itemVariants>["variant"]>;
+type RadixRootProps = React$1.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Root>;
+/** The props every group shares, whatever its `type`. */
+interface ToggleGroupFormProps extends VariantProps<typeof itemVariants> {
+    /** Outer height from the shared control scale (A1). Omitted: today's geometry. */
+    size?: ToggleGroupSize;
+    /** The form field name. Without it the group does not take part in a form. */
+    name?: string;
+    /** `id` of the form to submit with when the group is rendered outside it. */
+    form?: string;
+    /** Block native submission while nothing is pressed. */
+    required?: boolean;
+    /**
+     * The group is in error: `aria-invalid` and `data-invalid`. Implied by the
+     * surrounding `Field`'s `invalid` or a mounted `FieldError`.
+     */
+    invalid?: boolean;
+    /**
+     * Single groups only: submit `name=""` while nothing is pressed (`true`,
+     * the default and what a Select does) or omit the entry (`false`).
+     */
+    submitEmpty?: boolean;
+}
+type ToggleGroupProps = RadixRootProps & ToggleGroupFormProps;
+declare const ToggleGroup: React$1.ForwardRefExoticComponent<ToggleGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 interface ToggleGroupItemProps extends React$1.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Item>, VariantProps<typeof itemVariants> {
 }
 declare const ToggleGroupItem: React$1.ForwardRefExoticComponent<ToggleGroupItemProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -4007,6 +5111,440 @@ declare function resolveChipStyle({ variant, intent, pressed, }: {
  */
 declare const Chip: React$1.ForwardRefExoticComponent<ChipProps & React$1.RefAttributes<HTMLElement>>;
 
+/**
+ * How a `Field` lays out its parts: stacked (`vertical`, the default) or on
+ * one row (`horizontal`: settings rows, Switch and Checkbox rows).
+ *
+ * @experimental
+ */
+type FieldOrientation = "vertical" | "horizontal";
+
+/**
+ * Props of `Field`.
+ *
+ * @experimental
+ */
+interface FieldProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * The control's id and the base of every part id (`<id>-label`,
+     * `<id>-description`, `<id>-error`). Generated with `useId` when omitted.
+     */
+    id?: string;
+    /** The control's `name`, when the control does not set its own. */
+    name?: string;
+    /**
+     * The field is in error: the control gets `aria-invalid` and
+     * `data-invalid`. Implied by a mounted `FieldError` with content.
+     */
+    invalid?: boolean;
+    /**
+     * The value is required: a native control gets `required`, any other
+     * `aria-required`; the `Label` shows the asterisk.
+     */
+    required?: boolean;
+    /** The value is optional: the `Label` shows the `optional` message after the text. */
+    optional?: boolean;
+    /** Propagated to the control. */
+    disabled?: boolean;
+    /** Propagated to the control. */
+    readOnly?: boolean;
+    /** Stacked (`vertical`, default) or on one row (`horizontal`). */
+    orientation?: FieldOrientation;
+    /** The control size the field's controls read (from W4-05). */
+    size?: ControlSize;
+    /** Overrides of the copy the field renders (English defaults until W5-20). */
+    messages?: Partial<FieldMessages>;
+    children?: ReactNode;
+}
+/**
+ * One form control with its label, description and error (target
+ * architecture §24.1). Renders a `div` with the field anatomy and puts the
+ * wiring in context.
+ *
+ * @experimental
+ */
+declare const Field: React$1.ForwardRefExoticComponent<FieldProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Props of `FieldDescription`.
+ *
+ * @experimental
+ */
+type FieldDescriptionProps = HTMLAttributes<HTMLParagraphElement>;
+/**
+ * Hint text for the field's control, referenced first in the control's
+ * `aria-describedby`. Registers itself, so an unmounted description is not
+ * referenced.
+ *
+ * @experimental
+ */
+declare const FieldDescription: React$1.ForwardRefExoticComponent<FieldDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Props of `FieldError`.
+ *
+ * @experimental
+ */
+type FieldErrorProps = HTMLAttributes<HTMLParagraphElement>;
+/**
+ * The field's error message, referenced after the description in the
+ * control's `aria-describedby`; a mounted error with content also makes the
+ * field invalid. Renders nothing (and registers nothing) without content, so
+ * `<FieldError>{error}</FieldError>` is the whole call site.
+ *
+ * Announcement (target architecture §24.1): an error that appears after the
+ * field is on screen — after an interaction — is a `role="alert"` live
+ * region, announced once when it mounts and again when its text changes. An
+ * error rendered with the field (server-rendered validation results, the
+ * first client paint) is plain text: it is read with the control through
+ * `aria-describedby`, not shouted on page load. Pass `role` to override.
+ *
+ * @experimental
+ */
+declare const FieldError: React$1.ForwardRefExoticComponent<FieldErrorProps & React$1.RefAttributes<HTMLParagraphElement>>;
+
+/**
+ * L1b (W2-19 scaffolding, public since W4-02). The integration contract of
+ * target architecture §24.2: a control asks for its wiring and never knows
+ * about labels. Explicit props always win over the surrounding `Field`, and a
+ * control outside a field keeps working.
+ *
+ * Every design-system form control calls this hook (from W4-05 on). It is
+ * public for product-built controls — a rich-text editor, an annotation
+ * editor — that want the same binding; `FieldControl` is the same contract as
+ * a Slot for a control that is already a component.
+ */
+/**
+ * What a control tells `useFieldControl`. Every prop is optional: inside a
+ * `Field` the context supplies the rest, outside one the hook generates an id
+ * and adds nothing else.
+ *
+ * @experimental
+ */
+interface UseFieldControlProps {
+    id?: string | undefined;
+    name?: string | undefined;
+    invalid?: boolean | undefined;
+    required?: boolean | undefined;
+    disabled?: boolean | undefined;
+    readOnly?: boolean | undefined;
+    "aria-labelledby"?: string | undefined;
+    "aria-describedby"?: string | undefined;
+    /**
+     * `false` for a control that cannot be the target of `htmlFor` — a Radix
+     * trigger, a checkbox button, a slider thumb. Those are named with
+     * `aria-labelledby` and cannot carry the native `required` attribute.
+     * Default `true` (`input`, `textarea`, `select`).
+     */
+    native?: boolean | undefined;
+}
+/**
+ * The wiring `useFieldControl` returns. Spread it onto the control's element
+ * (`<input {...wiring} />`); merge `ref` with your own through a ref callback
+ * when you keep one.
+ *
+ * @experimental
+ */
+interface FieldControlWiring {
+    id: string;
+    name: string | undefined;
+    "aria-labelledby": string | undefined;
+    "aria-describedby": string | undefined;
+    "aria-invalid": true | undefined;
+    "aria-required": true | undefined;
+    required: true | undefined;
+    disabled: boolean | undefined;
+    readOnly: boolean | undefined;
+    /** State attributes per ADR-008: present when true, absent otherwise. */
+    "data-invalid": "" | undefined;
+    "data-disabled": "" | undefined;
+    /**
+     * Attach to the control's element. In development the hook checks, once the
+     * element is in the document, that it has an accessible name, and prints an
+     * error (once per control) when it has none. Nothing in production.
+     */
+    ref: RefCallback<HTMLElement>;
+}
+/**
+ * The wiring of one form control: `id`, `name`, ARIA references to the
+ * mounted `Field` parts (description before error), invalid / required /
+ * disabled / readOnly and the matching state attributes.
+ *
+ * Merge order: an explicit prop wins over the field; `aria-describedby` is
+ * merged (field ids first, then the prop). Outside a `Field` only the
+ * explicit props and a generated id remain.
+ *
+ * @experimental
+ */
+declare function useFieldControl(props?: UseFieldControlProps): FieldControlWiring;
+
+/**
+ * Props of `FieldControl`.
+ *
+ * @experimental
+ */
+interface FieldControlProps extends Pick<UseFieldControlProps, "native"> {
+    /** Exactly one element. Its own `id`, `aria-*` and state props win over the field. */
+    children: ReactElement;
+}
+/**
+ * Injects the field's wiring into its only child (see `useFieldControl`).
+ *
+ * `native` defaults to whether the child is an intrinsic `input`, `select`
+ * or `textarea`. A native child receives the full wiring, including `name`,
+ * `required`, `disabled` and `readOnly`. Any other child receives the id,
+ * the ARIA references and states (`aria-labelledby`, `aria-describedby`,
+ * `aria-invalid`, `aria-required`, `aria-disabled`, `aria-readonly`) and the
+ * `data-invalid` / `data-disabled` attributes, and reads `disabled` itself
+ * through `useFieldControl` when it needs the prop.
+ *
+ * @experimental
+ */
+declare function FieldControl({ children, native }: FieldControlProps): ReactElement;
+
+/**
+ * Props of `Fieldset`.
+ *
+ * @experimental
+ */
+interface FieldsetProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
+    /** The group is in error; `data-invalid` for styling. Each field carries its own `aria-invalid`. */
+    invalid?: boolean;
+}
+/**
+ * A group of fields under one legend. No visual chrome: the browser's
+ * fieldset border and padding are reset.
+ *
+ * @experimental
+ */
+declare const Fieldset: React$1.ForwardRefExoticComponent<FieldsetProps & React$1.RefAttributes<HTMLFieldSetElement>>;
+/**
+ * Props of `FieldsetLegend`.
+ *
+ * @experimental
+ */
+type FieldsetLegendProps = HTMLAttributes<HTMLLegendElement>;
+/**
+ * The group's name. Must be the first child of `Fieldset` for the browser to
+ * treat it as the legend. Inside a `Fieldset` it carries the id a grouped
+ * control references through `aria-labelledby`; an explicit `id` wins.
+ *
+ * @experimental
+ */
+declare const FieldsetLegend: React$1.ForwardRefExoticComponent<FieldsetLegendProps & React$1.RefAttributes<HTMLLegendElement>>;
+
+/**
+ * L1a behaviour primitive (private). Not exported from the package.
+ *
+ * The canonical option model of every list-shaped control (W4-09; target
+ * architecture §32): `Select`, the coming `Combobox` (W4-10) and its
+ * `MultiSelect` preset (W4-11), the `SearchSelect` adapter (W4-12) and the
+ * `PeoplePicker` pattern all read one shape, in place of the six that ship
+ * today (`{value,label}`, `{id,label,group…}`, `{id,label,email}`,
+ * `{id,fullName}`, `{key,label,dot}`, `string[]`).
+ *
+ * Two halves:
+ *
+ * - {@link Option} and its accessors: what a row *is*. Consumers with domain
+ *   objects pass {@link OptionAccessors} (`getOptionValue`/`getOptionLabel`)
+ *   instead of remapping, and {@link toOptions} normalises everything — a
+ *   `string[]`, domain objects, `Option`s — into one array the list renders.
+ * - The selection helpers: what a control's *value* is, discriminated by
+ *   `multiple` (single `TValue | null`, multi `TValue[]`; §32 "Value"). `""`
+ *   keeps meaning empty in 2.x (§32 "Compat"), so {@link normalizeSingleValue}
+ *   folds it to `null` at the boundary.
+ *
+ * No React, no client directive, no DOM: plain functions over plain data, so
+ * the same module serves a Server Component, a test and the keyboard helper.
+ */
+/**
+ * One row of a list-shaped control.
+ *
+ * `value` is never `""`: emptiness is `value === null` on the control, not a
+ * sentinel row (§32). `label` is the string typeahead, filtering and the
+ * accessible name read; `description` and `icon` are rendered, never searched.
+ * `keywords` widen the match without showing. `meta` carries consumer data
+ * through to `renderOption` / `onValueChange` details untouched.
+ *
+ * @experimental
+ */
+interface Option<TValue extends string = string, TMeta = unknown> {
+    value: TValue;
+    label: string;
+    description?: ReactNode;
+    /** Leading visual: icon, avatar, flag, colour swatch. */
+    icon?: ReactNode;
+    disabled?: boolean;
+    group?: string;
+    keywords?: readonly string[];
+    meta?: TMeta;
+}
+/**
+ * How a list reads a consumer's own item type. Only `getOptionValue` and
+ * `getOptionLabel` are required: an item with no `disabled`/`group`/`keywords`
+ * accessor is enabled, ungrouped and matched on its label alone.
+ *
+ * @experimental
+ */
+interface OptionAccessors<TItem, TValue extends string = string> {
+    getOptionValue: (item: TItem) => TValue;
+    getOptionLabel: (item: TItem) => string;
+    getOptionDisabled?: (item: TItem) => boolean;
+    getOptionGroup?: (item: TItem) => string | undefined;
+    getOptionKeywords?: (item: TItem) => readonly string[] | undefined;
+}
+
+/** The English defaults (the `combobox` namespace of the catalogue). */
+declare const DEFAULT_COMBOBOX_MESSAGES: ComboboxMessages;
+/** The sizes a combobox offers: the shared control scale (A1). @experimental */
+type ComboboxSize = ControlSize;
+/** What `renderOption` is told about the row it renders. @experimental */
+interface ComboboxOptionState {
+    selected: boolean;
+    highlighted: boolean;
+    disabled: boolean;
+}
+/**
+ * Class overrides per part, for the consumer who must restyle one slot
+ * without reaching into the DOM.
+ *
+ * @experimental
+ */
+interface ComboboxClassNames {
+    root?: string;
+    control?: string;
+    input?: string;
+    chip?: string;
+    content?: string;
+    list?: string;
+    item?: string;
+}
+/** @experimental */
+interface ComboboxBaseProps<TItem, TValue extends string> extends Partial<OptionAccessors<TItem, TValue>> {
+    /** The rows: `Option`s, strings, or domain objects read through the accessors. */
+    options: readonly TItem[];
+    id?: string;
+    /** The form field name. Without it nothing is submitted. */
+    name?: string;
+    /** The `id` of the form to submit with when the control is rendered outside it. */
+    form?: string;
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+    invalid?: boolean;
+    /** The accessible name of a combobox outside a `Field`. */
+    "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    placeholder?: string;
+    /** Outer height from the shared control scale. Default `md` (36px). */
+    size?: ComboboxSize;
+    /** A leading glyph inside the control, decorative. */
+    icon?: ReactNode;
+    /** Show a clear button while a value is set. Default `true`. */
+    clearable?: boolean;
+    /** Open the list when the input receives focus. Default `false`. */
+    openOnFocus?: boolean;
+    /** Whether the list surface flips to stay in the viewport. Default `true`. */
+    avoidCollisions?: boolean;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** The typed query (controlled). */
+    search?: string;
+    defaultSearch?: string;
+    /** Called with every query the user types (an async source fetches here). */
+    onSearchChange?: (query: string) => void;
+    /**
+     * Filter `options` by the query (`true`, the default). `false` when the
+     * consumer filters — the options are already the answer to the query.
+     */
+    shouldFilter?: boolean;
+    /** An async source is fetching: a spinner in the control, `loadingState` in the list. */
+    loading?: boolean;
+    emptyState?: ReactNode;
+    loadingState?: ReactNode;
+    /** Rendered above the list, inside the popover. */
+    header?: ReactNode;
+    /** Rendered below the list, inside the popover. */
+    footer?: ReactNode;
+    /** Offer a "Create …" row for a query that matches no option exactly. */
+    onCreate?: (query: string) => void;
+    /** Replaces the content of a row. */
+    renderOption?: (option: Option<TValue, unknown>, state: ComboboxOptionState) => ReactNode;
+    messages?: Partial<ComboboxMessages>;
+    className?: string;
+    classNames?: ComboboxClassNames;
+    /** The input element. */
+    ref?: React$1.Ref<HTMLInputElement>;
+}
+/** @experimental */
+interface ComboboxSingleProps<TItem, TValue extends string> extends ComboboxBaseProps<TItem, TValue> {
+    multiple?: false;
+    /** The picked value, or `null`. `""` means empty (2.x compat). */
+    value?: TValue | "" | null;
+    defaultValue?: TValue | "" | null;
+    onValueChange?: (value: TValue | null, details: {
+        option: Option<TValue, unknown> | null;
+    }) => void;
+    /** Replaces the closed control's text for the picked option. */
+    renderValue?: (option: Option<TValue, unknown>) => ReactNode;
+    /** Close the list after a pick. Default `true`. */
+    closeOnSelect?: boolean;
+}
+/** What `renderValue` receives in `multiple` mode besides the picked options. @experimental */
+interface ComboboxSelectionControls<TValue extends string> {
+    /** Removes one value from the selection. */
+    remove: (value: TValue) => void;
+}
+/** @experimental */
+interface ComboboxMultipleProps<TItem, TValue extends string> extends ComboboxBaseProps<TItem, TValue> {
+    multiple: true;
+    /** The picked values, in pick order. Empty strings are dropped. */
+    value?: readonly (TValue | "")[];
+    defaultValue?: readonly (TValue | "")[];
+    onValueChange?: (value: TValue[], details: {
+        option: Option<TValue, unknown> | null;
+    }) => void;
+    /**
+     * Replaces the chips inside the control: called with the picked options
+     * and `remove`. Return `null` to render nothing there.
+     */
+    renderValue?: (options: Option<TValue, unknown>[], controls: ComboboxSelectionControls<TValue>) => ReactNode;
+    /** Close the list after a pick. Default `false`: keep picking. */
+    closeOnSelect?: boolean;
+    /** Drop picked rows from the list (the chips already show them). Default `false`. */
+    hideSelected?: boolean;
+}
+/**
+ * The props, discriminated by `multiple` (target architecture §32 "Value"):
+ * a single pick is `TValue | null`, a multi pick is `TValue[]`.
+ *
+ * @experimental
+ */
+type ComboboxProps<TItem = Option, TValue extends string = string> = ComboboxSingleProps<TItem, TValue> | ComboboxMultipleProps<TItem, TValue>;
+/**
+ * The searchable pick: one input, a portalled listbox, the option model.
+ * See the module comment.
+ *
+ * @experimental
+ */
+declare function Combobox<TItem = Option, TValue extends string = string>(props: ComboboxProps<TItem, TValue>): react_jsx_runtime.JSX.Element;
+declare namespace Combobox {
+    var displayName: string;
+}
+
+/** @experimental */
+type MultiSelectProps<TItem = Option, TValue extends string = string> = Omit<ComboboxMultipleProps<TItem, TValue>, "multiple">;
+/**
+ * `Combobox multiple`: values as `TValue[]`, chips inside the control, one
+ * form entry per value.
+ *
+ * @experimental
+ */
+declare function MultiSelect<TItem = Option, TValue extends string = string>(props: MultiSelectProps<TItem, TValue>): react_jsx_runtime.JSX.Element;
+declare namespace MultiSelect {
+    var displayName: string;
+}
+
 /**
  * AgreementViewer — the chrome + navigation shell for a multi-step, branded
  * agreement / proposal (the "Signed Agreement Viewer"). It owns the header,
@@ -7288,4 +8826,78 @@ interface BrandScopeProps extends React.HTMLAttributes<HTMLDivElement> {
  */
 declare const BrandScope: React$1.ForwardRefExoticComponent<BrandScopeProps & React$1.RefAttributes<HTMLDivElement>>;
 
-export { AIReceiptPanel, type AIReceiptPanelProps, type AIReceiptResult, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActivityDotVariant, ActivityEventItem, type ActivityEventItemProps, ActivityItem, type ActivityItemProps, ActivityList, type ActivityListProps, type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AiDraftCard, type AiDraftCardProps, type AiDraftState, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogSlot, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppHeader, AppHeaderActions, type AppHeaderActionsProps, AppHeaderBreadcrumb, type AppHeaderBreadcrumbProps, type AppHeaderProps, AppHeaderSearch, type AppHeaderSearchProps, AppHeaderTitle, type AppHeaderTitleProps, AreaChart, type AreaChartProps, type AreaPoint, AspectRatio, Assignee, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, AttachmentChip, type AttachmentChipProps, AttentionItem, type AttentionItemProps, type AttentionUrgency, Avatar, type AvatarProps, type AvatarSlot, BRAND_PRODUCTS, Badge, type BadgeAppearance, type BadgeAppearanceInput, type BadgeLegacyVariant, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeSlot, type BadgeVariant, type BadgeVariantsProps, Blockquote, BottomNav, type BottomNavProps, type BottomNavTab, type BrandIconProps, type BrandProduct, BrandScope, type BrandScopeProps, BrandScopeProvider, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, BulkActionBar, BulkActionBarAction, type BulkActionBarActionProps, type BulkActionBarProps, BulkActionBarSeparator, type BulkActionBarVariant, Button, type ButtonEmphasis, type ButtonIconProps, type ButtonIconSize, type ButtonIntent, type ButtonIntentAlias, type ButtonLegacyVariant, type ButtonLook, type ButtonProps, type ButtonSize, type ButtonSizeAlias, type ButtonSlot, type ButtonStyle, type ButtonVariant, type ButtonVariantsProps, COUNTRY_CODES, Calendar, type CalendarCaptionLayout, type CalendarHighlight, type CalendarHighlightColor, type CalendarProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSlot, CardTitle, type CardTitleProps, type CardVariants, CategoryDivider, type CategoryDividerProps, CategoryTag, type CategoryTagProps, type CategoryTone, type CellValue, type ChannelTabItem, ChannelTabs, type ChannelTabsProps, type ChannelTone, Checkbox, type CheckboxSlot, Chip, type ChipIntent, type ChipProps, type ChipSize, type ChipSlot, type ChipStyle, type ChipVariant, ClientRailGroupHeader, type ClientRailGroupHeaderProps, ClientRailItem, type ClientRailItemProps, ClientSelect, type ClientSelectOption, Code, type CodeProps, type CodeSlot, type CodeVariant, Collapsible, CollapsibleContent, CollapsibleTrigger, ComingSoon, type ComingSoonProps, type CommandItem, CommandPalette, ConfirmActionButton, type ConfirmActionButtonProps, Content, type ContentProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, type ContextMenuSlot, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ControlSize, CopyButton, type CountryCode, CountryFlag, CountrySelect, DATE_DISPLAY_PLACEHOLDER, DangerAction, type DangerActionProps, Dash, DashGrid, type DashGridProps, type DashWidget, DataItem, DataTable, DataTableBody, type DataTableBodyProps, DataTableCell, DataTableCellDue, type DataTableCellDueProps, DataTableCellId, DataTableCellMono, DataTableCellName, type DataTableCellProps, DataTableCheckbox, type DataTableCheckboxProps, DataTableHead, type DataTableHeadProps, DataTableHeader, type DataTableHeaderProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableResultsCount, type DataTableResultsCountProps, DataTableRow, type DataTableRowProps, DataTableSearch, type DataTableSearchProps, type DataTableSlot, DataTableSpacer, type DataTableSpacerProps, DataTableToolbar, type DataTableToolbarProps, DataTableView, type DataTableViewColumn, type DataTableViewFilter, type DataTableViewProps, type DataTableViewSelection, DatePicker, DateRangePicker, type DateRangeValue, DetailGrid, type DetailGridProps, DetailMain, type DetailMainProps, DetailSpine, DetailSpineHeader, type DetailSpineHeaderProps, type DetailSpineProps, DetailSpineSection, type DetailSpineSectionProps, DetailSpineStats, type DetailSpineStatsProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogSlot, DialogTitle, DialogTrigger, DismissibleChip, DisplayMenu, type DisplayMenuOption, type DisplayMenuProps, type DisplayMenuSection, DocumentChecklist, type DocumentChecklistFile, type DocumentChecklistItem, type DocumentChecklistProps, type DocumentChecklistStatus, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentFileCard, type DocumentFileCardProps, DocumentFileLine, type DocumentFileLineProps, DocumentFileRow, type DocumentFileRowProps, type DocumentItemState, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, type DocumentRequestActivityKind, type DocumentRequestAssigneeOption, DocumentRequestCard, type DocumentRequestCardProps, DocumentRequestDetail, type DocumentRequestDetailActivityEvent, type DocumentRequestDetailComment, type DocumentRequestDetailDoc, type DocumentRequestDetailProps, type DocumentRequestDetailTab, DocumentRequestField, type DocumentRequestFieldProps, type DocumentRequestItemSummary, type DocumentRequestRequestedItem, type DocumentRequestReviewStatusOption, type DocumentRequestTone, DocumentRequestUpload, type DocumentRequestUploadFile, type DocumentRequestUploadProps, DocumentRow, type DocumentRowProps, type DocumentSource, DocumentSourceFilter, type DocumentSourceFilterProps, type DocumentSourceFilterValue, DocumentSourceTag, type DocumentSourceTagProps, DocumentsWorkspaceLayout, type DocumentsWorkspaceLayoutProps, DonutChart, type DonutChartProps, type DonutSegment, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuSlot, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmailMessageCard, type EmailMessageCardProps, EmptyState, type EmptyStateProps, EngagementCard, type EngagementCardProps, EngagementTimeline, type EngagementTimelineProps, EngagementTimelineStep, type EngagementTimelineStepProps, Eyebrow, type EyebrowProps, FileChip, type FileChipProps, type FileKind, FileTypeBadge, type FileTypeBadgeProps, type FileTypeTone, FileUpload, type FileUploadSlot, FilterChip, type FilterChipProps, type FolderNode, FolderTree, type FolderTreeProps, FormError, FormSection, FormSuccess, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, type HeadingSlot, HoverCard, HoverCardContent, HoverCardPortal, HoverCardTrigger, ICON_TILE_TONE_TO_INTENT, IconAction, type IconActionProps, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonSlot, type IconButtonTooltipSide, IconTile, type IconTileIntent, type IconTileProps, type IconTileSize, type IconTileSuiteTone, type IconTileTone, type IconTileVariantProps, Inline, type InlineProps, type InlineSlot, Input, type InputSlot, type InputVariants, Intent, IntentBadge, type IntentBadgeProps, type IntentTone, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanProps, Kbd, type KbdGlyph, KbdHint, type KbdHintProps, type KbdProps, type KbdSlot, type KbdVariant, type KeyboardShortcut, type KeyboardShortcutSection, KeyboardShortcutsDialog, type KeyboardShortcutsDialogProps, KpiCard, type KpiCardProps, type KpiDelta, Label, type LabelSlot, type LayoutAlign, type LayoutBreakpoint, type LayoutGap, type LayoutJustify, LinkAction, type LinkActionProps, LinkButton, type LinkButtonProps$1 as LinkButtonProps, type LinkButtonSlot, LoadingRows, Logo, Main, type MainProps, MasterDetailLayout, type MasterDetailLayoutProps, MessageBubble, MessageBubbleAction, type MessageBubbleActionProps, type MessageBubbleProps, MessageBubbleTombstone, type MessageBubbleTombstoneProps, MessageComposer, type MessageComposerProps, MetadataGrid, type MissingDocumentItem, MissingDocumentsPanel, type MissingDocumentsPanelProps, MoneyCell, MultiFilterPill, MultiSelectField, MutedSpec, type MutedSpecProps, NewMenu, type NewMenuAction, type NewMenuGroup, type NewMenuProps, NotificationFilter, type NotificationFilterProps, type NotificationFilterValue, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationPanel, NotificationPanelFooter, type NotificationPanelFooterProps, NotificationPanelHeader, type NotificationPanelHeaderProps, type NotificationPanelProps, Numeric, type NumericProps, OTPInput, type OnlyStatuses, PROGRESS_LEGACY_TO_INTENT, PageHeader, type PageHeaderProps, PageHeaderSep, type PageHeaderSepProps, PageHeaderSpec, type PageHeaderSpecProps, Pagination, type PaginationProps, type PaginationSlot, PdfPreview, type PdfPreviewProps, PhoneCountryInput, PhoneInput, type PillStatus, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, type PopoverSlot, PopoverTrigger, Pressable, type PressableProps, type PressableSlot, PrimaryAction, type PrimaryActionProps, type Priority, PriorityIcon, type PriorityIconProps, ProgressBar, type ProgressBarProps, type ProgressBarVariant, type ProgressBarVariantProps, type ProgressIntent, type ProgressLegacyColour, ProgressRing, type ProgressRingProps, type ProgressRingVariant, type ProgressRingVariantProps, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, QuestionnairePanel, type QuestionnairePanelGroup, type QuestionnairePanelProps, type QuestionnairePanelSection, type QuestionnairePanelStatus, Questions, type QuestionsProps, type QuickReplyChip, RadioGroup, RadioGroupItem, type RadioGroupSlot, type RankedBar, RankedBars, type RankedBarsProps, type Responsive, ResponsiveDialog, type ResponsiveDialogProps, RouteTransition, type RouteTransitionProps, SERVICE_TONES, SPINNER_TONE_TO_INTENT, STATUS_DOT_TONE_TO_INTENT, ScrollArea, ScrollBar, SearchInput, type SearchInputSlot, type SearchInputVariants, SearchSelect, type SearchSelectOption, SecondaryAction, type SecondaryActionProps, Section, SectionHead, SectionHeader, SegmentedProgress, type SegmentedProgressProps, type SegmentedServiceTone, type SegmentedTone, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, type SelectProps, SelectRoot, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSlot, SelectTrigger, SelectValue, SelectableKpiCard, type SelectableKpiCardProps, Separator, type ServiceTone, Shape, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, type SheetSlot, SheetTitle, SheetTrigger, Shell, type ShellProps, type ShellSlot, SideDrawer, type SideDrawerSlot, Sidebar, SidebarBrand, type SidebarBrandProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, type SidebarBrandSwitcherSlot, SidebarBrandSwitcherTile, SidebarBrandText, type SidebarBrandTextProps, SidebarFooter, type SidebarFooterProps, SidebarLink, SidebarLinkAction, type SidebarLinkActionProps, SidebarLinkBadge, type SidebarLinkBadgeProps, type SidebarLinkBadgeVariants, SidebarLinkGroup, type SidebarLinkGroupProps, SidebarLinkLabel, type SidebarLinkLabelProps, type SidebarLinkProps, SidebarPinButton, type SidebarPinButtonProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarSection, type SidebarSectionProps, type SidebarSlot, type SidebarState, SidebarTrigger, type SidebarTriggerProps, SidebarUser, type SidebarUserProps, SignatureEditor, type SignatureEditorProps, Skeleton, SkeletonCircle, SkeletonText, Slider, type SortDirection, Spinner, type SpinnerIntent, type SpinnerProps, type SpinnerSize, type SpinnerTone, type SpinnerVariantProps, SpreadsheetPreview, type SpreadsheetPreviewProps, Stack, type StackDirection, type StackProps, type StackSlot, StackedBarChart, type StackedBarChartProps, type StackedBarDatum, type StackedBarSeries, StagePill, StarRating, type StarRatingProps, Stat, StatusBadge, type StatusBadgeProps, type StatusBadgeSlot, StatusDot, type StatusDotIntent, type StatusDotProps, type StatusDotSize, type StatusDotTone, type StatusDotVariantProps, StatusIcon, type StatusIconProps, type StatusMap, StatusPill, type StatusPillProps, type StatusPresentation, type StatusState, type Step, Stepper, type StepperProps, StickyActionBar, type StickyActionBarProps, StickyStack, StickyStackLayer, type StickyStackLayerProps, type StickyStackProps, StickyStackSectionHeader, type StickyStackSectionHeaderProps, StickyStackSticky, type StickyStackStickyProps, SubmitButton, SuggestionPills, type SuggestionPillsProps, SuiteProgress, type SuiteProgressFillVariantProps, type SuiteProgressProps, type SuiteProgressSize, type SuiteProgressSuiteTone, type SuiteProgressTone, Surface, type SurfaceElevation, type SurfacePadding, type SurfaceProps, type SurfaceRadius, type SurfaceSlot, Switch, type SwitchSlot, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowData, type TableRowProps, type TableSlot, type TableTone, Tabs, TabsContent, TabsList, TabsTrigger, TagsCell, TeamMemberSelect, Text, type TextColor, type TextProps, type TextSize, type TextSlot, type TextWeight, Textarea, type TextareaSlot, type TextareaVariants, TimeLogger, TimeLoggerActions, type TimeLoggerActionsProps, TimeLoggerBillable, type TimeLoggerBillableProps, TimeLoggerContextRow, type TimeLoggerContextRowProps, TimeLoggerEntry, TimeLoggerEntryList, type TimeLoggerEntryListProps, type TimeLoggerEntryProps, TimeLoggerField, type TimeLoggerFieldProps, TimeLoggerFooter, type TimeLoggerFooterProps, TimeLoggerHeader, type TimeLoggerHeaderProps, TimeLoggerNotes, type TimeLoggerNotesProps, type TimeLoggerPhase, type TimeLoggerProps, type TimeLoggerTier, TimeLoggerTimer, type TimeLoggerTimerProps, type TimelineState, type ToastAction, type ToastContextValue, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, ToggleGroupItem, Toolbar, type ToolbarProps, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, type TooltipSlot, TooltipTrigger, type UseStopwatchReturn, Variant, VisuallyHidden, YEAR_DISPLAY_PLACEHOLDER, alertVariants, applyMask, applyYearMask, assetPath, attachmentChipVariants, badgeVariants, brandLabel, brandScope, buttonVariants, cardVariants, chipVariants, cn, dateToIso, defineStatusMap, displayToIso, fileTypeBadgeVariants, fileTypeFromName, filterChipVariants, formatClock, formatCurrency, formatDuration, getAssetBasePath, getFlagEmoji, iconButtonVariants, resolveIconTileVariants as iconTileVariants, inputVariants, isoToDate, isoToDisplay, isoToYear, labelVariants, parseDuration, parsePhoneForEditing, progressBarVariants, progressRingVariants, resolveBadgeAppearance, resolveButtonStyle, resolveChipStyle, searchInputVariants, serviceToneLabel, serviceToneStyle, setAssetBasePath, sidebarLinkBadgeVariants, spinnerVariants, starRatingVariants, statusDotVariants, suiteProgressFillVariants, textareaVariants, useBrandScope, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };
+/**
+ * Theme scope — the host dimensions a subtree renders with (W5-02).
+ *
+ * The design system's scopes are DOM attributes: `[data-ds-scheme]`,
+ * `[data-ds-brand]`, `[data-ds-density]`, `dir`, and the `--ds-*` style a
+ * runtime brand writes (`createBrandTheme`). Set on the document root they
+ * reach everything, portalled overlays included. Set on a *subtree* they stop
+ * at the subtree: a Dialog or Popover opened from inside it renders in
+ * `document.body`, outside the scope, and comes up in the root theme.
+ *
+ * `ThemeScope` fixes that. It stamps the attributes on its own element, as a
+ * hand-written scope would, **and** registers them in context, so the shared
+ * `Portal` (`primitives/behavior/portal.tsx`) can re-stamp the same attributes
+ * and runtime-brand style on the container wrapper it mounts portalled content
+ * into. Nested scopes merge: a `density="compact"` scope inside a `brand="tax"`
+ * one propagates both.
+ *
+ * Apps that scope the document root need none of this; the portal path is
+ * unchanged for them (no wrapper is created).
+ */
+/** The scheme a subtree renders with (`[data-ds-scheme]`). */
+type ThemeScheme = "light" | "dark";
+/** A built-in brand scope (`[data-ds-brand]`). */
+type ThemeBrand = "pro" | "audit" | "books" | "tax";
+/** The density scope (`[data-ds-density]`, W2-06). */
+type ThemeDensity = "comfortable" | "compact";
+/** Text direction (`dir`). */
+type ThemeDirection = "ltr" | "rtl";
+/**
+ * The dimensions a scope sets. Every field is optional; an unset field is
+ * inherited from the enclosing scope, then from the document.
+ *
+ * @experimental
+ */
+interface ThemeScopeValue {
+    scheme?: ThemeScheme;
+    brand?: ThemeBrand;
+    density?: ThemeDensity;
+    dir?: ThemeDirection;
+    /**
+     * A registered runtime brand: the object `createBrandTheme()` returns. It is
+     * applied as inline `--ds-*` style on the scope element and re-applied on
+     * portalled content.
+     */
+    brandTheme?: BrandTheme;
+}
+/** Props of {@link ThemeScope}. @experimental */
+interface ThemeScopeProps extends ThemeScopeValue, Omit<React.HTMLAttributes<HTMLDivElement>, "dir"> {
+    children?: ReactNode;
+}
+/**
+ * A `<div>` that scopes the host dimensions of its subtree — scheme, brand,
+ * density, direction and a runtime brand — and propagates them into every
+ * overlay opened from inside it (Dialog, Sheet, Popover, Tooltip, menus,
+ * Select, Toast …), which would otherwise render in the document's theme.
+ *
+ * ```tsx
+ * <ThemeScope brand="tax" density="compact">
+ *   <Popover>…</Popover>   // its content renders as compact Tax, too
+ * </ThemeScope>
+ *
+ * <ThemeScope brandTheme={createBrandTheme({ brand: firm.primary })}>
+ *   <Dialog>…</Dialog>     // the runtime brand follows the dialog to <body>
+ * </ThemeScope>
+ * ```
+ *
+ * Nothing changes for apps that scope `<html>` or `<body>`: no wrapper is
+ * created around portalled content when no `ThemeScope` encloses it.
+ *
+ * @experimental W5-02. The public shape follows decision D7 for the runtime
+ * brand seed.
+ */
+declare const ThemeScope: React$1.ForwardRefExoticComponent<ThemeScopeProps & React$1.RefAttributes<HTMLDivElement>>;
+
+export { AIReceiptPanel, type AIReceiptPanelProps, type AIReceiptResult, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActivityDotVariant, ActivityEventItem, type ActivityEventItemProps, ActivityItem, type ActivityItemProps, ActivityList, type ActivityListProps, type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AiDraftCard, type AiDraftCardProps, type AiDraftState, Alert, AlertDescription, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogSlot, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppHeader, AppHeaderActions, type AppHeaderActionsProps, AppHeaderBreadcrumb, type AppHeaderBreadcrumbProps, type AppHeaderProps, AppHeaderSearch, type AppHeaderSearchProps, AppHeaderTitle, type AppHeaderTitleProps, AreaChart, type AreaChartProps, type AreaPoint, AspectRatio, Assignee, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, AttachmentChip, type AttachmentChipProps, AttentionItem, type AttentionItemProps, type AttentionUrgency, Avatar, type AvatarProps, type AvatarSlot, BRAND_PRODUCTS, Badge, type BadgeAppearance, type BadgeAppearanceInput, type BadgeLegacyVariant, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeSlot, type BadgeVariant, type BadgeVariantsProps, Blockquote, BottomNav, type BottomNavProps, type BottomNavTab, type BrandIconProps, type BrandProduct, BrandScope, type BrandScopeProps, BrandScopeProvider, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, BulkActionBar, BulkActionBarAction, type BulkActionBarActionProps, type BulkActionBarProps, BulkActionBarSeparator, type BulkActionBarVariant, Button, type ButtonEmphasis, type ButtonIconProps, type ButtonIconSize, type ButtonIntent, type ButtonIntentAlias, type ButtonLegacyVariant, type ButtonLook, type ButtonProps, type ButtonSize, type ButtonSizeAlias, type ButtonSlot, type ButtonStyle, type ButtonVariant, type ButtonVariantsProps, COUNTRY_CODES, Calendar, type CalendarBaseProps, type CalendarCaptionLayout, type CalendarHighlight, type CalendarHighlightColor, type CalendarProps, type CalendarRange, type CalendarRangeProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSlot, CardTitle, type CardTitleProps, type CardVariants, CategoryDivider, type CategoryDividerProps, CategoryTag, type CategoryTagProps, type CategoryTone, type CellValue, type ChannelTabItem, ChannelTabs, type ChannelTabsProps, type ChannelTone, Checkbox, type CheckboxChecked, type CheckboxProps, type CheckboxSlot, Chip, type ChipIntent, type ChipProps, type ChipSize, type ChipSlot, type ChipStyle, type ChipVariant, ClientRailGroupHeader, type ClientRailGroupHeaderProps, ClientRailItem, type ClientRailItemProps, ClientSelect, type ClientSelectOption, Code, type CodeProps, type CodeSlot, type CodeVariant, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxBaseProps, type ComboboxClassNames, ComboboxMessages, type ComboboxMultipleProps, type ComboboxOptionState, type ComboboxProps, type ComboboxSelectionControls, type ComboboxSingleProps, type ComboboxSize, type ComboboxSlot, ComingSoon, type ComingSoonProps, type CommandItem, CommandPalette, ConfirmActionButton, type ConfirmActionButtonProps, Content, type ContentProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, type ContextMenuSlot, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ControlSize, CopyButton, type CountryCode, CountryFlag, CountrySelect, DATE_DISPLAY_PLACEHOLDER, DEFAULT_COMBOBOX_MESSAGES, DEFAULT_PHONE_FIELD_MESSAGES, DangerAction, type DangerActionProps, Dash, DashGrid, type DashGridProps, type DashWidget, DataItem, DataTable, DataTableBody, type DataTableBodyProps, DataTableCell, DataTableCellDue, type DataTableCellDueProps, DataTableCellId, DataTableCellMono, DataTableCellName, type DataTableCellProps, DataTableCheckbox, type DataTableCheckboxProps, DataTableHead, type DataTableHeadProps, DataTableHeader, type DataTableHeaderProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableResultsCount, type DataTableResultsCountProps, DataTableRow, type DataTableRowProps, DataTableSearch, type DataTableSearchProps, type DataTableSlot, DataTableSpacer, type DataTableSpacerProps, DataTableToolbar, type DataTableToolbarProps, DataTableView, type DataTableViewColumn, type DataTableViewFilter, type DataTableViewProps, type DataTableViewSelection, type DatePattern, DatePicker, type DatePickerProps, type DateRangeNames, DateRangePicker, type DateRangePickerProps, type DateRangeValue, DetailGrid, type DetailGridProps, DetailMain, type DetailMainProps, DetailSpine, DetailSpineHeader, type DetailSpineHeaderProps, type DetailSpineProps, DetailSpineSection, type DetailSpineSectionProps, DetailSpineStats, type DetailSpineStatsProps, Dialog, DialogBody, type DialogBodyProps, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, type DialogHeight, type DialogMessages, DialogOverlay, DialogPortal, type DialogSize$1 as DialogSize, type DialogSlot, DialogTitle, DialogTrigger, DismissibleChip, DisplayMenu, type DisplayMenuOption, type DisplayMenuProps, type DisplayMenuSection, DocumentChecklist, type DocumentChecklistFile, type DocumentChecklistItem, type DocumentChecklistProps, type DocumentChecklistStatus, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentFileCard, type DocumentFileCardProps, DocumentFileLine, type DocumentFileLineProps, DocumentFileRow, type DocumentFileRowProps, type DocumentItemState, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, type DocumentRequestActivityKind, type DocumentRequestAssigneeOption, DocumentRequestCard, type DocumentRequestCardProps, DocumentRequestDetail, type DocumentRequestDetailActivityEvent, type DocumentRequestDetailComment, type DocumentRequestDetailDoc, type DocumentRequestDetailProps, type DocumentRequestDetailTab, DocumentRequestField, type DocumentRequestFieldProps, type DocumentRequestItemSummary, type DocumentRequestRequestedItem, type DocumentRequestReviewStatusOption, type DocumentRequestTone, DocumentRequestUpload, type DocumentRequestUploadFile, type DocumentRequestUploadProps, DocumentRow, type DocumentRowProps, type DocumentSource, DocumentSourceFilter, type DocumentSourceFilterProps, type DocumentSourceFilterValue, DocumentSourceTag, type DocumentSourceTagProps, DocumentsWorkspaceLayout, type DocumentsWorkspaceLayoutProps, DonutChart, type DonutChartProps, type DonutSegment, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuSlot, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmailMessageCard, type EmailMessageCardProps, EmptyState, type EmptyStateProps, EngagementCard, type EngagementCardProps, EngagementTimeline, type EngagementTimelineProps, EngagementTimelineStep, type EngagementTimelineStepProps, Eyebrow, type EyebrowProps, Field, FieldControl, type FieldControlProps, type FieldControlWiring, FieldDescription, type FieldDescriptionProps, FieldError, type FieldErrorProps, FieldMessages, type FieldOrientation, type FieldProps, type FieldSlot, Fieldset, FieldsetLegend, type FieldsetLegendProps, type FieldsetProps, type FieldsetSlot, FileChip, type FileChipProps, type FileKind, FileTypeBadge, type FileTypeBadgeProps, type FileTypeTone, FileUpload, FileUploadMessages, type FileUploadProps, type FileUploadSlot, type FileUploadVariant, FilterChip, type FilterChipProps, type FolderNode, FolderTree, type FolderTreeProps, FormError, FormSection, FormSuccess, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, type HeadingSlot, HoverCard, HoverCardContent, HoverCardPortal, HoverCardTrigger, ICON_TILE_TONE_TO_INTENT, IconAction, type IconActionProps, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonSlot, type IconButtonTooltipSide, IconTile, type IconTileIntent, type IconTileProps, type IconTileSize, type IconTileSuiteTone, type IconTileTone, type IconTileVariantProps, Inline, type InlineProps, type InlineSlot, Input, type InputProps$1 as InputProps, type InputSize, type InputSizeAlias, type InputSlot, type InputVariant, type InputVariants, type InputVariantsOptions, Intent, IntentBadge, type IntentBadgeProps, type IntentTone, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanProps, Kbd, type KbdGlyph, KbdHint, type KbdHintProps, type KbdProps, type KbdSlot, type KbdVariant, type KeyboardShortcut, type KeyboardShortcutSection, KeyboardShortcutsDialog, type KeyboardShortcutsDialogProps, KpiCard, type KpiCardProps, type KpiDelta, Label, type LabelSlot, type LayoutAlign, type LayoutBreakpoint, type LayoutGap, type LayoutJustify, LinkAction, type LinkActionProps, LinkButton, type LinkButtonProps$1 as LinkButtonProps, type LinkButtonSlot, LoadingRows, Logo, Main, type MainProps, MasterDetailLayout, type MasterDetailLayoutProps, MessageBubble, MessageBubbleAction, type MessageBubbleActionProps, type MessageBubbleProps, MessageBubbleTombstone, type MessageBubbleTombstoneProps, MessageComposer, type MessageComposerProps, MetadataGrid, type MissingDocumentItem, MissingDocumentsPanel, type MissingDocumentsPanelProps, MoneyCell, MultiFilterPill, MultiSelect, MultiSelectField, type MultiSelectProps, MutedSpec, type MutedSpecProps, NewMenu, type NewMenuAction, type NewMenuGroup, type NewMenuProps, NotificationFilter, type NotificationFilterProps, type NotificationFilterValue, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationPanel, NotificationPanelFooter, type NotificationPanelFooterProps, NotificationPanelHeader, type NotificationPanelHeaderProps, type NotificationPanelProps, NumberInput, type NumberInputProps, type NumberInputSlot, Numeric, type NumericProps, OTPInput, type OTPInputProps, type OnlyStatuses, type Option, type OptionAccessors, PROGRESS_LEGACY_TO_INTENT, PageHeader, type PageHeaderProps, PageHeaderSep, type PageHeaderSepProps, PageHeaderSpec, type PageHeaderSpecProps, Pagination, type PaginationProps, type PaginationSlot, PdfPreview, type PdfPreviewProps, PhoneCountryInput, PhoneField, type PhoneFieldChangeDetails, type PhoneFieldMessages, type PhoneFieldProps, type PhoneFieldSlot, PhoneInput, type PillStatus, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, type PopoverSlot, PopoverTrigger, Pressable, type PressableProps, type PressableSlot, PrimaryAction, type PrimaryActionProps, type Priority, PriorityIcon, type PriorityIconProps, ProgressBar, type ProgressBarProps, type ProgressBarVariant, type ProgressBarVariantProps, type ProgressIntent, type ProgressLegacyColour, ProgressRing, type ProgressRingProps, type ProgressRingVariant, type ProgressRingVariantProps, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, QuestionnairePanel, type QuestionnairePanelGroup, type QuestionnairePanelProps, type QuestionnairePanelSection, type QuestionnairePanelStatus, Questions, type QuestionsProps, type QuickReplyChip, RadioGroup, type RadioGroupAppearance, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSlot, type RankedBar, RankedBars, type RankedBarsProps, type Responsive, ResponsiveDialog, type ResponsiveDialogProps, RouteTransition, type RouteTransitionProps, SERVICE_TONES, SPINNER_TONE_TO_INTENT, STATUS_DOT_TONE_TO_INTENT, ScrollArea, ScrollBar, SearchInput, SearchInputMessages, type SearchInputProps, type SearchInputSize, type SearchInputSlot, type SearchInputVariants, type SearchInputVariantsOptions, SearchSelect, type SearchSelectOption, type SearchSelectProps, SecondaryAction, type SecondaryActionProps, Section, SectionHead, SectionHeader, SegmentedProgress, type SegmentedProgressProps, type SegmentedServiceTone, type SegmentedTone, Select, type SelectClassNames, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectMessages, type SelectOption, type SelectProps, SelectRoot, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSize, type SelectSlot, SelectTrigger, type SelectTriggerProps, SelectValue, SelectableKpiCard, type SelectableKpiCardProps, Separator, type ServiceTone, Shape, Sheet, SheetBody, type SheetBodyProps, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, type SheetMessages, SheetOverlay, SheetPortal, type SheetSide, type SheetSize, type SheetSlot, SheetTitle, SheetTrigger, type SheetWidth, Shell, type ShellProps, type ShellSlot, SideDrawer, type SideDrawerSlot, Sidebar, SidebarBrand, type SidebarBrandProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, type SidebarBrandSwitcherSlot, SidebarBrandSwitcherTile, SidebarBrandText, type SidebarBrandTextProps, SidebarFooter, type SidebarFooterProps, SidebarLink, SidebarLinkAction, type SidebarLinkActionProps, SidebarLinkBadge, type SidebarLinkBadgeProps, type SidebarLinkBadgeVariants, SidebarLinkGroup, type SidebarLinkGroupProps, SidebarLinkLabel, type SidebarLinkLabelProps, type SidebarLinkProps, SidebarPinButton, type SidebarPinButtonProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarSection, type SidebarSectionProps, type SidebarSlot, type SidebarState, SidebarTrigger, type SidebarTriggerProps, SidebarUser, type SidebarUserProps, SignatureEditor, type SignatureEditorProps, Skeleton, SkeletonCircle, SkeletonText, Slider, type SliderProps, type SliderSize, type SortDirection, Spinner, type SpinnerIntent, type SpinnerProps, type SpinnerSize, type SpinnerTone, type SpinnerVariantProps, SpreadsheetPreview, type SpreadsheetPreviewProps, Stack, type StackDirection, type StackProps, type StackSlot, StackedBarChart, type StackedBarChartProps, type StackedBarDatum, type StackedBarSeries, StagePill, StarRating, type StarRatingProps, Stat, StatusBadge, type StatusBadgeProps, type StatusBadgeSlot, StatusDot, type StatusDotIntent, type StatusDotProps, type StatusDotSize, type StatusDotTone, type StatusDotVariantProps, StatusIcon, type StatusIconProps, type StatusMap, StatusPill, type StatusPillProps, type StatusPresentation, type StatusState, type Step, Stepper, type StepperProps, StickyActionBar, type StickyActionBarProps, StickyStack, StickyStackLayer, type StickyStackLayerProps, type StickyStackProps, StickyStackSectionHeader, type StickyStackSectionHeaderProps, StickyStackSticky, type StickyStackStickyProps, SubmitButton, SuggestionPills, type SuggestionPillsProps, SuiteProgress, type SuiteProgressFillVariantProps, type SuiteProgressProps, type SuiteProgressSize, type SuiteProgressSuiteTone, type SuiteProgressTone, Surface, type SurfaceElevation, type SurfacePadding, type SurfaceProps, type SurfaceRadius, type SurfaceSlot, Switch, type SwitchProps, type SwitchSize, type SwitchSlot, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowData, type TableRowProps, type TableSlot, type TableTone, Tabs, TabsContent, TabsList, TabsTrigger, TagsCell, TeamMemberSelect, Text, type TextColor, type TextProps, type TextSize, type TextSlot, type TextWeight, Textarea, type TextareaProps, type TextareaSize, type TextareaSlot, type TextareaVariant, type TextareaVariants, type TextareaVariantsOptions, type ThemeBrand, type ThemeDensity, type ThemeDirection, type ThemeScheme, ThemeScope, type ThemeScopeProps, type ThemeScopeValue, TimeLogger, TimeLoggerActions, type TimeLoggerActionsProps, TimeLoggerBillable, type TimeLoggerBillableProps, TimeLoggerContextRow, type TimeLoggerContextRowProps, TimeLoggerEntry, TimeLoggerEntryList, type TimeLoggerEntryListProps, type TimeLoggerEntryProps, TimeLoggerField, type TimeLoggerFieldProps, TimeLoggerFooter, type TimeLoggerFooterProps, TimeLoggerHeader, type TimeLoggerHeaderProps, TimeLoggerNotes, type TimeLoggerNotesProps, type TimeLoggerPhase, type TimeLoggerProps, type TimeLoggerTier, TimeLoggerTimer, type TimeLoggerTimerProps, type TimelineState, type ToastAction, type ToastContextValue, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, type ToggleGroupFormProps, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleGroupSize, type ToggleGroupVariant, Toolbar, type ToolbarProps, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, type TooltipSlot, TooltipTrigger, type UseFieldControlProps, type UseStopwatchReturn, Variant, VisuallyHidden, YEAR_DISPLAY_PLACEHOLDER, alertVariants, applyMask, applyYearMask, assetPath, attachmentChipVariants, badgeVariants, brandLabel, brandScope, buttonVariants, cardVariants, chipVariants, cn, dateToIso, defineStatusMap, displayToIso, fileTypeBadgeVariants, fileTypeFromName, filterChipVariants, formatClock, formatCurrency, formatDuration, getAssetBasePath, getFlagEmoji, iconButtonVariants, resolveIconTileVariants as iconTileVariants, inputVariants, isoToDate, isoToDisplay, isoToYear, labelVariants, parseDuration, parsePhoneForEditing, progressBarVariants, progressRingVariants, resolveBadgeAppearance, resolveButtonStyle, resolveChipStyle, searchInputVariants, serviceToneLabel, serviceToneStyle, setAssetBasePath, sidebarLinkBadgeVariants, spinnerVariants, starRatingVariants, statusDotVariants, suiteProgressFillVariants, textareaVariants, useBrandScope, useFieldControl, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };