@assure-one/design-system 1.35.0 → 1.37.0

package/dist/index.d.ts

@@ -1,18 +1,20 @@
-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-CyAVbHhM.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-vztxMSfl.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-vztxMSfl.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 { C as CommandPaletteMessages, a as ConfirmMessages, b as CopyButtonMessages, F as FileUploadMessages, K as KeyboardShortcutsMessages, P as PaginationMessages, c as PhoneFieldMessages, S as SearchInputMessages, d as SelectMessages, T as ToastMessages, e as FieldMessages, f as ComboboxMessages } from './design-system-provider-C8UlFe52.js';
+export { g as DesignSystemProvider, D as DesignSystemProviderProps, h as DsDirection, i as DsMessageNamespace, j as DsMessages, k as DsMessagesOverride, I as ImageComponent, l as ImageComponentProps, L as LinkComponent, m as LinkComponentProps, n as TooltipDefaults, u as useDsMessages } from './design-system-provider-C8UlFe52.js';
 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';
@@ -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
@@ -169,16 +203,28 @@ type LabelSlot = "root" | "required";
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
 type FileUploadSlot = "root" | "dropzone" | "input" | "error";
+/**
+ * `Command` / `CommandPalette` parts, stamped as `data-slot="command-<part>"`
+ * (ADR-008, W5-19). `overlay`, `content`, `title` and `description` are the
+ * spotlight modal (`CommandDialog`); `root`, `input`, `list`, `empty`,
+ * `group` and `item` are the command-list parts; `footer` is the
+ * keyboard-hint strip `CommandPalette` renders below the list.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
+ */
+type CommandSlot = "overlay" | "content" | "title" | "description" | "root" | "input" | "list" | "empty" | "group" | "item" | "footer";
 /**
  * `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.
- * Radix's `data-state` is left as it is (`P-DATA-STATE`).
+ * a control that dismisses the dialog. `body` is the scroll region between
+ * header and footer (W5-05). States: `data-size` on the content, and
+ * `data-variant="responsive"` when it presents as a bottom sheet below `sm`
+ * (W5-09). 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 +234,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,6 +462,229 @@ type IconButtonSlot = "root" | "icon" | "spinner";
  * @experimental Slot names are experimental until ADR-008 is accepted (W3-15).
  */
 type ChipSlot = "root" | "icon" | "label" | "count" | "remove";
+/**
+ * `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`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-01).
+ */
+type FieldSlot = "root" | "label" | "required" | "optional" | "description" | "error";
+/**
+ * `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 Slot names are experimental until ADR-008 is accepted (W4-01).
+ */
+type FieldsetSlot = "root" | "legend";
+/**
+ * `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`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W4-10).
+ */
+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.
+ *
+ * `buttonBase` — the one class recipe every button-shaped control renders
+ * (W3-03; target architecture §4 L1a, §30), and the `variant` + `intent`
+ * resolver in front of it (W3-02; ADR-007). `Button`, `LinkButton` and
+ * `SubmitButton` read both through the public `buttonVariants`;
+ * `IconButton` (W3-09) and `Chip` (W3-15) read them next, so the geometry,
+ * the focus ring, the disabled treatment, the press feedback and the colour
+ * table of an action are written once.
+ *
+ * Two axes, one table: `variant` says how loudly (`solid · soft · outline ·
+ * ghost · link`), `intent` says what it means (`brand · neutral · success ·
+ * danger`), and every pair has one row in {@link BUTTON_LOOKS}. The legacy
+ * single-axis words (`primary`, `secondary`, `destructive`, `success`,
+ * `accent`, `dashed`) resolve to a pair through {@link LEGACY_BUTTON_VARIANTS}
+ * and produce the class string they always did:
+ * `src/primitives/__tests__/button-legacy-classes.test.tsx` pins every legacy
+ * `variant` × `size` to the output recorded from `main` before W3-02.
+ *
+ * No React, no client directive: plain functions of props to a string, so a
+ * Server Component can call them once the root entry is server-safe (S3).
+ */
+/**
+ * The emphases a Button offers: all five of the shared vocabulary.
+ *
+ * @experimental
+ */
+type ButtonEmphasis = Variant;
+/**
+ * The intents a Button offers (ADR-007 §1; `info` and `warning` are not actions).
+ *
+ * @experimental
+ */
+type ButtonIntent = Extract<Intent, "brand" | "neutral" | "success" | "danger">;
+/**
+ * `destructive` is accepted where an intent is expected, as an alias of
+ * `danger`, until decision D4 settles the canonical word (ADR-007 §5).
+ *
+ * @deprecated Use `intent="danger"`.
+ * @experimental
+ */
+type ButtonIntentAlias = "destructive";
+/**
+ * The single-axis words Button accepted before W3-02, each a fixed
+ * `{ variant, intent }` pair (ADR-007 §4, target architecture §28):
+ *
+ * - `primary` → `solid` + `brand` (the default; nothing to migrate)
+ * - `secondary` → `soft` + `neutral`
+ * - `destructive` → `solid` + `danger`
+ * - `success` → `solid` + `success`
+ * - `accent` → `solid` + `brand` in the suite-action colour; folds into
+ *   `intent="brand"` and is dropped in 2.0 (decision D13)
+ * - `dashed` → `outline` + `neutral` with a dashed 2px border; kept for the
+ *   2.x line
+ *
+ * `ghost`, `outline` and `link` are not legacy: they already are emphases.
+ *
+ * @deprecated Pass `variant` (emphasis) and `intent` (meaning) instead. The
+ * codemod CM-04 rewrites call sites mechanically.
+ * @experimental
+ */
+type ButtonLegacyVariant = "primary" | "secondary" | "destructive" | "success" | "accent" | "dashed";
+/** What `variant` accepts on the Button family: the vocabulary plus the deprecated aliases. */
+type ButtonVariant = ButtonEmphasis | ButtonLegacyVariant;
+/**
+ * A row of the colour table: a `variant`/`intent` pair or one of the two
+ * legacy-only looks. The separator is `/`, not `-`: the keys of the table are
+ * text Tailwind scans, and an `outline` emphasis joined to an intent with a
+ * hyphen would compile to an outline-colour utility nobody asked for.
+ *
+ * @experimental
+ */
+type ButtonLook = `${ButtonEmphasis}/${ButtonIntent}` | "accent" | "dashed";
+/**
+ * The resolved appearance of a Button.
+ *
+ * @experimental
+ */
+interface ButtonStyle {
+    variant: ButtonEmphasis;
+    intent: ButtonIntent;
+    /** The row of the colour table the pair renders. */
+    look: ButtonLook;
+}
+/**
+ * Resolve what a Button renders from the two-axis props, accepting every
+ * legacy word (W3-02, ADR-007 §4).
+ *
+ * - No `variant`: `solid` + `brand` (what `primary` always rendered).
+ * - A legacy `variant` alone: its fixed pair; `accent` and `dashed` keep
+ *   their own look.
+ * - A legacy `variant` with an explicit `intent`: the alias contributes its
+ *   emphasis, the intent is the caller's (`variant="primary" intent="danger"`
+ *   is a solid danger button). `accent`'s and `dashed`'s own looks apply only
+ *   without a competing intent.
+ * - `intent="destructive"` is `danger` (deprecated alias, D4).
+ *
+ * @experimental
+ */
+declare function resolveButtonStyle({ variant, intent, }: {
+    variant?: ButtonVariant | null;
+    intent?: ButtonIntent | ButtonIntentAlias | null;
+}): ButtonStyle;
+/**
+ * The size names the recipe knows (W3-05, ADR-013): the shared control scale
+ * `xs · sm · md · lg · xl` (`ControlSize`), the 1.31 aliases
+ * `compact` / `default` / `comfortable` of `sm` / `md` / `lg`, and the square
+ * icon-only steps `icon-xs` / `icon-sm` / `icon` (C-BTN-SIZE-ICON).
+ *
+ * `xs` and `xl` are new in W3-05 and read the shared scale
+ * (`--control-*-{xs,xl}`: 28px and 48px tall), so they follow the density
+ * scope. `md` (40px) and `lg` (48px) are the two A1 mismatches recorded in
+ * `baselines/size-geometry.json`: they keep today's pixels through the
+ * D5-gated compat tokens `--button-height-md` / `--button-height-lg` and
+ * their padding, gap and label size stay on Tailwind's scale — nothing about
+ * them moves until decision D5 (W2-05, CM-03). `sm` (32px) already agrees
+ * with the scale's `sm` step, so it reads the shared row like `xs`/`xl`.
+ */
+type ButtonSize = ControlSize | ButtonSizeAlias | ButtonIconSize;
+/**
+ * The 1.31 aliases of `sm` / `md` / `lg` (C-BTN-SIZE-ALIAS). No known consumer
+ * uses them; they leave in 2.0.
+ *
+ * @deprecated Use `size="sm"`, `"md"` or `"lg"`.
+ * @experimental
+ */
+type ButtonSizeAlias = "compact" | "default" | "comfortable";
+/**
+ * The icon-only squares (C-BTN-SIZE-ICON): 24 / 28 / 40px. `IconButton`
+ * (W3-09) owns icon-only geometry; the codemod CM-03 rewrites the call sites.
+ * Removed in 3.0.
+ *
+ * @deprecated Use `IconButton`.
+ * @experimental
+ */
+type ButtonIconSize = "icon-xs" | "icon-sm" | "icon";
+/**
+ * What {@link buttonVariants} takes: the two axes, the size and cva's class
+ * pass-through.
+ *
+ * @experimental
+ */
+interface ButtonVariantsProps {
+    variant?: ButtonVariant | null;
+    intent?: ButtonIntent | ButtonIntentAlias | null;
+    size?: ButtonSize | null;
+    class?: string | null;
+    className?: string | null;
+}
+/**
+ * The public recipe of the Button family: resolves `variant` + `intent`
+ * (legacy words included) and renders the row with the size. Same name and
+ * output as before W3-02 for every call that existed; `intent` is the one
+ * addition. Server-safe.
+ */
+declare function buttonVariants({ variant, intent, size, class: classProp, className, }?: ButtonVariantsProps): string;
+/**
+ * The icon slots of the Button family (W3-07). `iconStart` / `iconEnd` are
+ * logical — start is the left in LTR and the right in RTL, because the button
+ * is a flex row and the slot follows the writing direction. `iconLeft` /
+ * `iconRight` are the names consumers use today (140 call sites) and stay as
+ * aliases of the same slots.
+ *
+ * @experimental
+ */
+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>>;
@@ -422,16 +692,33 @@ declare const AlertDialogPortal: React$1.FC<AlertDialogPrimitive.AlertDialogPort
 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;
+    (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;
+    (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>>;
+/**
+ * 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>>;
 
 /**
@@ -685,191 +972,6 @@ declare const BreadcrumbPage: React$1.ForwardRefExoticComponent<BreadcrumbPagePr
 type BreadcrumbSeparatorProps = React.HTMLAttributes<HTMLSpanElement>;
 declare const BreadcrumbSeparator: React$1.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React$1.RefAttributes<HTMLSpanElement>>;
 
-/**
- * L1a behaviour primitive (private). Not exported from the package.
- *
- * `buttonBase` — the one class recipe every button-shaped control renders
- * (W3-03; target architecture §4 L1a, §30), and the `variant` + `intent`
- * resolver in front of it (W3-02; ADR-007). `Button`, `LinkButton` and
- * `SubmitButton` read both through the public `buttonVariants`;
- * `IconButton` (W3-09) and `Chip` (W3-15) read them next, so the geometry,
- * the focus ring, the disabled treatment, the press feedback and the colour
- * table of an action are written once.
- *
- * Two axes, one table: `variant` says how loudly (`solid · soft · outline ·
- * ghost · link`), `intent` says what it means (`brand · neutral · success ·
- * danger`), and every pair has one row in {@link BUTTON_LOOKS}. The legacy
- * single-axis words (`primary`, `secondary`, `destructive`, `success`,
- * `accent`, `dashed`) resolve to a pair through {@link LEGACY_BUTTON_VARIANTS}
- * and produce the class string they always did:
- * `src/primitives/__tests__/button-legacy-classes.test.tsx` pins every legacy
- * `variant` × `size` to the output recorded from `main` before W3-02.
- *
- * No React, no client directive: plain functions of props to a string, so a
- * Server Component can call them once the root entry is server-safe (S3).
- */
-/**
- * The emphases a Button offers: all five of the shared vocabulary.
- *
- * @experimental
- */
-type ButtonEmphasis = Variant;
-/**
- * The intents a Button offers (ADR-007 §1; `info` and `warning` are not actions).
- *
- * @experimental
- */
-type ButtonIntent = Extract<Intent, "brand" | "neutral" | "success" | "danger">;
-/**
- * `destructive` is accepted where an intent is expected, as an alias of
- * `danger`, until decision D4 settles the canonical word (ADR-007 §5).
- *
- * @deprecated Use `intent="danger"`.
- * @experimental
- */
-type ButtonIntentAlias = "destructive";
-/**
- * The single-axis words Button accepted before W3-02, each a fixed
- * `{ variant, intent }` pair (ADR-007 §4, target architecture §28):
- *
- * - `primary` → `solid` + `brand` (the default; nothing to migrate)
- * - `secondary` → `soft` + `neutral`
- * - `destructive` → `solid` + `danger`
- * - `success` → `solid` + `success`
- * - `accent` → `solid` + `brand` in the suite-action colour; folds into
- *   `intent="brand"` and is dropped in 2.0 (decision D13)
- * - `dashed` → `outline` + `neutral` with a dashed 2px border; kept for the
- *   2.x line
- *
- * `ghost`, `outline` and `link` are not legacy: they already are emphases.
- *
- * @deprecated Pass `variant` (emphasis) and `intent` (meaning) instead. The
- * codemod CM-04 rewrites call sites mechanically.
- * @experimental
- */
-type ButtonLegacyVariant = "primary" | "secondary" | "destructive" | "success" | "accent" | "dashed";
-/** What `variant` accepts on the Button family: the vocabulary plus the deprecated aliases. */
-type ButtonVariant = ButtonEmphasis | ButtonLegacyVariant;
-/**
- * A row of the colour table: a `variant`/`intent` pair or one of the two
- * legacy-only looks. The separator is `/`, not `-`: the keys of the table are
- * text Tailwind scans, and an `outline` emphasis joined to an intent with a
- * hyphen would compile to an outline-colour utility nobody asked for.
- *
- * @experimental
- */
-type ButtonLook = `${ButtonEmphasis}/${ButtonIntent}` | "accent" | "dashed";
-/**
- * The resolved appearance of a Button.
- *
- * @experimental
- */
-interface ButtonStyle {
-    variant: ButtonEmphasis;
-    intent: ButtonIntent;
-    /** The row of the colour table the pair renders. */
-    look: ButtonLook;
-}
-/**
- * Resolve what a Button renders from the two-axis props, accepting every
- * legacy word (W3-02, ADR-007 §4).
- *
- * - No `variant`: `solid` + `brand` (what `primary` always rendered).
- * - A legacy `variant` alone: its fixed pair; `accent` and `dashed` keep
- *   their own look.
- * - A legacy `variant` with an explicit `intent`: the alias contributes its
- *   emphasis, the intent is the caller's (`variant="primary" intent="danger"`
- *   is a solid danger button). `accent`'s and `dashed`'s own looks apply only
- *   without a competing intent.
- * - `intent="destructive"` is `danger` (deprecated alias, D4).
- *
- * @experimental
- */
-declare function resolveButtonStyle({ variant, intent, }: {
-    variant?: ButtonVariant | null;
-    intent?: ButtonIntent | ButtonIntentAlias | null;
-}): ButtonStyle;
-/**
- * The size names the recipe knows (W3-05, ADR-013): the shared control scale
- * `xs · sm · md · lg · xl` (`ControlSize`), the 1.31 aliases
- * `compact` / `default` / `comfortable` of `sm` / `md` / `lg`, and the square
- * icon-only steps `icon-xs` / `icon-sm` / `icon` (C-BTN-SIZE-ICON).
- *
- * `xs` and `xl` are new in W3-05 and read the shared scale
- * (`--control-*-{xs,xl}`: 28px and 48px tall), so they follow the density
- * scope. `md` (40px) and `lg` (48px) are the two A1 mismatches recorded in
- * `baselines/size-geometry.json`: they keep today's pixels through the
- * D5-gated compat tokens `--button-height-md` / `--button-height-lg` and
- * their padding, gap and label size stay on Tailwind's scale — nothing about
- * them moves until decision D5 (W2-05, CM-03). `sm` (32px) already agrees
- * with the scale's `sm` step, so it reads the shared row like `xs`/`xl`.
- */
-type ButtonSize = ControlSize | ButtonSizeAlias | ButtonIconSize;
-/**
- * The 1.31 aliases of `sm` / `md` / `lg` (C-BTN-SIZE-ALIAS). No known consumer
- * uses them; they leave in 2.0.
- *
- * @deprecated Use `size="sm"`, `"md"` or `"lg"`.
- * @experimental
- */
-type ButtonSizeAlias = "compact" | "default" | "comfortable";
-/**
- * The icon-only squares (C-BTN-SIZE-ICON): 24 / 28 / 40px. `IconButton`
- * (W3-09) owns icon-only geometry; the codemod CM-03 rewrites the call sites.
- * Removed in 3.0.
- *
- * @deprecated Use `IconButton`.
- * @experimental
- */
-type ButtonIconSize = "icon-xs" | "icon-sm" | "icon";
-/**
- * What {@link buttonVariants} takes: the two axes, the size and cva's class
- * pass-through.
- *
- * @experimental
- */
-interface ButtonVariantsProps {
-    variant?: ButtonVariant | null;
-    intent?: ButtonIntent | ButtonIntentAlias | null;
-    size?: ButtonSize | null;
-    class?: string | null;
-    className?: string | null;
-}
-/**
- * The public recipe of the Button family: resolves `variant` + `intent`
- * (legacy words included) and renders the row with the size. Same name and
- * output as before W3-02 for every call that existed; `intent` is the one
- * addition. Server-safe.
- */
-declare function buttonVariants({ variant, intent, size, class: classProp, className, }?: ButtonVariantsProps): string;
-/**
- * The icon slots of the Button family (W3-07). `iconStart` / `iconEnd` are
- * logical — start is the left in LTR and the right in RTL, because the button
- * is a flex row and the slot follows the writing direction. `iconLeft` /
- * `iconRight` are the names consumers use today (140 call sites) and stay as
- * aliases of the same slots.
- *
- * @experimental
- */
-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;
-}
-
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, ButtonIconProps {
     /**
      * Visual emphasis: `solid` (default) · `soft` · `outline` · `ghost` · `link`.
@@ -920,15 +1022,41 @@ interface CalendarHighlight {
     date: Date;
     color?: CalendarHighlightColor;
 }
-interface CalendarProps extends Omit<DayPickerProps, "mode" | "selected" | "onSelect" | "modifiers" | "modifiersClassNames"> {
+/** 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;
-    highlights?: CalendarHighlight[];
-    minDate?: Date;
-    maxDate?: Date;
-    className?: string;
 }
-declare function Calendar({ selected, onSelect, highlights, minDate, maxDate, className, classNames, captionLayout, navLayout, startMonth, endMonth, components, ...props }: CalendarProps): react_jsx_runtime.JSX.Element;
+/**
+ * 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({ 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 +1295,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>>;
 
@@ -1229,12 +1374,111 @@ interface CommandItem {
 }
 interface CommandPaletteProps {
     items: CommandItem[];
+    /** Controlled open state. Omit for the uncontrolled palette (Cmd/Ctrl+K toggles it). */
     open?: boolean;
+    /** The initial open state of an uncontrolled palette. Default `false`. */
+    defaultOpen?: boolean;
     onOpenChange?: (open: boolean) => void;
+    /** The search input's placeholder. Default `messages.search` (`"Type a command or search..."`). */
     placeholder?: string;
+    /** Overrides of the copy the palette renders (W5-22). */
+    messages?: Partial<CommandPaletteMessages>;
 }
 
-declare function CommandPalette({ items, open: controlledOpen, onOpenChange, placeholder, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
+declare function CommandPalette({ items, open: controlledOpen, defaultOpen, onOpenChange, placeholder: placeholderProp, messages: messagesProp, }: CommandPaletteProps): react_jsx_runtime.JSX.Element;
+
+/** The meaning of a confirmation, as on `Button`. @experimental */
+type ConfirmIntent = Extract<Intent, "brand" | "neutral" | "success" | "danger">;
+/**
+ * How the dialog presents (W5-09). `dialog` (default) is the centred box;
+ * `responsive` renders the same content as a bottom sheet below the `sm`
+ * breakpoint once the overlay primitives support it. Forwarded as is.
+ *
+ * @experimental
+ */
+type ConfirmPresentation = "dialog" | "responsive";
+/** Where focus starts when a `ConfirmDialog` opens. @experimental */
+type ConfirmInitialFocus = "cancel" | "confirm" | "none";
+/** The result of `onConfirm`: `false` keeps the dialog open. @experimental */
+type ConfirmResult = void | boolean;
+/**
+ * Props of `ConfirmDialog`.
+ *
+ * @experimental
+ */
+interface ConfirmDialogProps {
+    /** Controlled open state. */
+    open?: boolean;
+    /** Initial open state for uncontrolled usage. */
+    defaultOpen?: boolean;
+    /** Called when the dialog requests an open-state change. */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Element rendered as the dialog trigger (`<AlertDialogTrigger asChild>`).
+     * Omit it when the dialog is driven entirely by `open` / `onOpenChange`.
+     */
+    trigger?: React$1.ReactNode;
+    /** The question. Required: an alert dialog needs a name. */
+    title: React$1.ReactNode;
+    /** The explanation under the title (inline content — it renders in a paragraph). */
+    description?: React$1.ReactNode;
+    /**
+     * Block content between the description and the actions: a form field, a
+     * list of what will be affected, a fee notice. Not read as the dialog's
+     * description; label it on its own.
+     */
+    children?: React$1.ReactNode;
+    /** The confirm button's label. Default: `messages.confirm` (`"Confirm"`). */
+    confirmLabel?: React$1.ReactNode;
+    /** The confirm button's label while `onConfirm` is pending. Default: `confirmLabel`. */
+    pendingLabel?: React$1.ReactNode;
+    /** The cancel button's label. Default: `messages.cancel` (`"Cancel"`). */
+    cancelLabel?: React$1.ReactNode;
+    /** Overrides of the copy the dialog renders; the provider's `messages.confirm` sits below. */
+    messages?: Partial<ConfirmMessages>;
+    /**
+     * Awaited. The dialog closes when it resolves (to anything but `false`)
+     * and stays open when it rejects or resolves `false`.
+     */
+    onConfirm: () => ConfirmResult | Promise<ConfirmResult>;
+    /** Called when the user cancels (button, Escape, backdrop). */
+    onCancel?: () => void;
+    /**
+     * Called when `onConfirm` rejects, with the rejection. The dialog stays
+     * open either way; see `inlineError` for what renders.
+     */
+    onError?: (error: unknown) => void;
+    /**
+     * Whether a rejection renders inline (a `FieldError`-style alert under the
+     * content: the `Error`'s message, or `messages.failed`). Default `true`.
+     * `false` leaves the surfacing to `onError` (a toast, for example).
+     */
+    inlineError?: boolean;
+    /** Meaning. Default `danger`. See {@link ConfirmIntent}. */
+    intent?: ConfirmIntent;
+    /**
+     * Where focus starts when the dialog opens. Default: `cancel` for `danger`
+     * (a destructive confirmation must not proceed on a reflex Enter), `confirm`
+     * for every other intent. `none` leaves it to the content — the element
+     * with `autoFocus` inside `children`, as `usePrompt` does for its input.
+     */
+    initialFocus?: ConfirmInitialFocus;
+    /** Disables the confirm button (a type-to-confirm or required field that is not satisfied yet). */
+    confirmDisabled?: boolean;
+    /** Presentation. Default `dialog`. See {@link ConfirmPresentation}. */
+    presentation?: ConfirmPresentation;
+    /** Forwarded to the content for one-off layout overrides. */
+    className?: string;
+}
+/**
+ * The confirmation pattern (W5-16). See the file comment.
+ *
+ * @experimental
+ */
+declare function ConfirmDialog({ open, defaultOpen, onOpenChange, trigger, title, description, children, confirmLabel, pendingLabel, cancelLabel, messages: messagesOverride, onConfirm, onCancel, onError, inlineError, intent, initialFocus, confirmDisabled, presentation, className, }: ConfirmDialogProps): react_jsx_runtime.JSX.Element;
+declare namespace ConfirmDialog {
+    var displayName: string;
+}
 
 interface ConfirmActionButtonProps {
     /** Element rendered as the dialog trigger via `<AlertDialogTrigger asChild>`.
@@ -1244,16 +1488,45 @@ interface ConfirmActionButtonProps {
     trigger?: React$1.ReactNode;
     title: React$1.ReactNode;
     description?: React$1.ReactNode;
+    /** Default `"Confirm"` (the provider's `messages.confirm.confirm`). */
     confirmLabel?: React$1.ReactNode;
     /** Shown on the confirm button while `onConfirm` is awaiting. Falls back to
      *  `confirmLabel` when omitted, so existing callers are unaffected. */
     pendingLabel?: React$1.ReactNode;
+    /** Default `"Cancel"` (the provider's `messages.confirm.cancel`). */
     cancelLabel?: React$1.ReactNode;
-    /** Awaited; dialog closes after resolve, stays open on reject. */
-    onConfirm: () => void | Promise<void>;
-    /** When true (default) the Action button uses the destructive palette;
-     *  when false it uses the brand primary palette (bg-brand). */
+    /** Awaited; dialog closes after resolve, stays open on reject (or a resolved `false`). */
+    onConfirm: () => void | boolean | Promise<void | boolean>;
+    /** Called with the rejection of `onConfirm` (the dialog stays open). @experimental */
+    onError?: (error: unknown) => void;
+    /**
+     * When true (default) the Action button uses the destructive palette;
+     * when false it uses the brand primary palette.
+     *
+     * Alias of `intent` (W5-17): `true` is `intent="danger"`, `false` is
+     * `intent="brand"`. `intent`, when passed, wins.
+     */
     destructive?: boolean;
+    /**
+     * Meaning of the confirmation, as on `ConfirmDialog`: `danger` (default)
+     * keeps the destructive action and starts focus on Cancel; `brand`,
+     * `neutral` and `success` render the action through the Button recipe and
+     * start focus on the confirm button.
+     *
+     * @experimental
+     */
+    intent?: ConfirmIntent;
+    /**
+     * Render the rejection of `onConfirm` inline under the description instead
+     * of leaving it to the consumer. Default `false` (the 1.x behaviour).
+     *
+     * @experimental
+     */
+    inlineError?: boolean;
+    /** Presentation of the dialog (W5-09). Default `dialog`. @experimental */
+    presentation?: ConfirmPresentation;
+    /** Block content between the description and the actions (a form field). @experimental */
+    children?: React$1.ReactNode;
     /** Forwarded to AlertDialogContent for one-off layout overrides. */
     contentClassName?: string;
     /** Controlled open state for menu-hoisted or externally triggered dialogs. */
@@ -1263,7 +1536,7 @@ interface ConfirmActionButtonProps {
     /** Called when the dialog requests an open-state change. */
     onOpenChange?: (open: boolean) => void;
 }
-declare function ConfirmActionButton({ trigger, title, description, confirmLabel, pendingLabel, cancelLabel, onConfirm, destructive, contentClassName, open, defaultOpen, onOpenChange, }: ConfirmActionButtonProps): react_jsx_runtime.JSX.Element;
+declare function ConfirmActionButton({ trigger, title, description, confirmLabel, pendingLabel, cancelLabel, onConfirm, onError, destructive, intent, inlineError, presentation, children, contentClassName, open, defaultOpen, onOpenChange, }: ConfirmActionButtonProps): react_jsx_runtime.JSX.Element;
 
 declare const ContextMenu: React$1.FC<ContextMenuPrimitive.ContextMenuProps>;
 declare const ContextMenuTrigger: React$1.ForwardRefExoticComponent<ContextMenuPrimitive.ContextMenuTriggerProps & React$1.RefAttributes<HTMLSpanElement>>;
@@ -1277,9 +1550,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>>;
@@ -1295,6 +1576,8 @@ declare const ContextMenuShortcut: {
 interface CopyButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     value: string;
     feedbackDuration?: number;
+    /** Overrides of the two accessible names (W5-22): prop > provider `messages.copyButton` > English. */
+    messages?: Partial<CopyButtonMessages>;
 }
 /**
  * CopyButton — single-click clipboard copy with check-mark feedback.
@@ -1322,10 +1605,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 +1631,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 +1691,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 +1740,106 @@ 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 = "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";
+/**
+ * How a `DialogContent` presents (W5-09). `dialog` (default) is the centred
+ * box. `responsive` renders the same content as a bottom sheet below the `sm`
+ * breakpoint (full width, top corners rounded, safe-area padding, `85vh`
+ * cap) and as the centred box from it — one Radix root and one content node
+ * whose surface CSS switches at the breakpoint, so focus, form state and
+ * scroll position survive a resize or rotation. `size` and `--ds-dialog-width`
+ * apply to the centred form only.
+ *
+ * @experimental
+ */
+type DialogPresentation = "dialog" | "responsive";
+/**
+ * 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;
+    /** Height step. Default `auto`. See {@link DialogHeight}. */
+    height?: DialogHeight;
+    /** Centred box, or a bottom sheet below `sm`. Default `dialog`. See {@link DialogPresentation}. */
+    presentation?: DialogPresentation;
     /**
      * 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 +1940,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 +1966,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>>;
@@ -1556,7 +2005,8 @@ declare const DropdownMenuShortcut: {
 };
 
 /**
- * EmptyState — display headline (Inter), fg-3 description, neutral icon halo on bg-2.
+ * EmptyState — display headline (Inter), fg-3 description, icon tile on surface-2 with a
+ * hairline ring (Polish 2 §3.10: the tile reads as a surface, the icon as content).
  *
  * Public API preserved: `icon`, `title`, `description`, `action`.
  */
@@ -1633,21 +2083,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 +2172,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 +2194,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,12 +2220,53 @@ 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>>;
 
+/**
+ * How wide a floating surface is (W5-11; target architecture §14 "Popover /
+ * HoverCard: `width: auto | trigger | sm | md | lg`" — 100% of consumer
+ * `PopoverContent` uses override width or padding by class today). `auto`
+ * adds nothing (the content sizes the box); `trigger` reads the popper
+ * variable Radix stamps on the content; `sm`/`md`/`lg` are 16/18/24rem —
+ * `md` is the `w-72` Popover always wrote, `sm` the `w-64` of HoverCard.
+ */
+type FloatingWidth = "auto" | "trigger" | "sm" | "md" | "lg";
+/** Inner padding of a floating surface; `md` is the `p-4` both adopters wrote. */
+type FloatingPadding = "none" | "sm" | "md";
+
+/** How wide a `HoverCardContent` is. @experimental */
+type HoverCardWidth = FloatingWidth;
+/** Inner padding of a `HoverCardContent`. @experimental */
+type HoverCardPadding = FloatingPadding;
 declare const HoverCard: React$1.FC<HoverCardPrimitive.HoverCardProps>;
 declare const HoverCardTrigger: React$1.ForwardRefExoticComponent<HoverCardPrimitive.HoverCardTriggerProps & React$1.RefAttributes<HTMLAnchorElement>>;
 declare const HoverCardPortal: React$1.FC<HoverCardPrimitive.HoverCardPortalProps>;
-declare const HoverCardContent: React$1.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface HoverCardContentProps extends React$1.ComponentPropsWithoutRef<typeof HoverCardPrimitive.Content> {
+    /**
+     * The width of the surface. `sm` (default, 16rem) is what the hover card
+     * always rendered; `auto` sizes to the content, `trigger` matches the
+     * element that opened it, `md` and `lg` are 18rem and 24rem.
+     *
+     * @experimental
+     */
+    width?: HoverCardWidth;
+    /**
+     * Inner padding of the surface. `md` (default) is the `p-4` the hover card
+     * always rendered; `sm` is `p-3`; `none` lets the content pad itself.
+     *
+     * @experimental
+     */
+    padding?: HoverCardPadding;
+}
+declare const HoverCardContent: React$1.ForwardRefExoticComponent<HoverCardContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
  * IconTile — the recurring tinted rounded-square icon chip. An intent tint
@@ -1762,15 +2338,86 @@ interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, IconTileVa
 declare const IconTile: React$1.ForwardRefExoticComponent<IconTileProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
- * Input variants. Mirrors the raw HTML `<input>` styled per the suite tokens
- * (rule-strong border, surface bg, accent focus ring).
+ * 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;
+}
+/** The variant props of `inputVariants` (cva's `VariantProps` shape, kept for the API report). */
+type InputVariants = Omit<InputVariantsOptions, "class" | "className">;
+/**
+ * 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 +2429,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 {
@@ -1811,13 +2498,29 @@ interface KeyboardShortcutsDialogProps {
      * keydown handling.
      */
     hotkey?: string | null;
+    /** Controlled open state (W5-19). Omit for the uncontrolled dialog. */
+    open?: boolean;
+    /** The initial open state of an uncontrolled dialog. Default `false`. */
+    defaultOpen?: boolean;
+    /** Called with the next open state — on the hotkey, the close button, Escape and the backdrop. */
+    onOpenChange?: (open: boolean) => void;
+    /** Overrides of the copy the dialog renders (W5-22). */
+    messages?: Partial<KeyboardShortcutsMessages>;
 }
-declare function KeyboardShortcutsDialog({ sections, hotkey, }?: KeyboardShortcutsDialogProps): react_jsx_runtime.JSX.Element;
+declare function KeyboardShortcutsDialog({ sections, hotkey, open: controlledOpen, defaultOpen, onOpenChange, messages: messagesProp, }?: KeyboardShortcutsDialogProps): react_jsx_runtime.JSX.Element;
 
 declare const labelVariants: (props?: class_variance_authority_types.ClassProp | undefined) => string;
 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 +2548,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 +2574,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.
@@ -1900,7 +2606,7 @@ interface LoadingRowsProps extends React.HTMLAttributes<HTMLDivElement> {
     gap?: string;
     /** Override the row Skeleton className (radius, width, etc). */
     rowClassName?: string;
-    /** Accessible label announced to screen readers. */
+    /** Accessible label announced to screen readers. Default `messages.loadingRows.loading` (`"Loading"`). */
     label?: string;
 }
 declare const LoadingRows: React$1.ForwardRefExoticComponent<LoadingRowsProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -1918,6 +2624,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 +2755,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;
 }
@@ -2078,6 +2861,8 @@ interface PaginationProps extends React.HTMLAttributes<HTMLElement> {
     totalItems?: number;
     /** Items per page — used with totalItems for range display */
     pageSize?: number;
+    /** Overrides of the copy the pager renders (W5-22): prop > provider `messages.pagination` > English. */
+    messages?: Partial<PaginationMessages>;
 }
 declare const Pagination: React$1.ForwardRefExoticComponent<PaginationProps & React$1.RefAttributes<HTMLElement>>;
 
@@ -2142,14 +2927,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 +2948,93 @@ declare function parsePhoneForEditing(phone: string): {
     localPhone: 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;
@@ -2190,12 +3046,35 @@ declare function PhoneCountryInput({ countryIso, localPhone, onCountryChange, on
     id?: string;
 }): react_jsx_runtime.JSX.Element;
 
+/** How wide a `PopoverContent` is. @experimental */
+type PopoverWidth = FloatingWidth;
+/** Inner padding of a `PopoverContent`. @experimental */
+type PopoverPadding = FloatingPadding;
 declare const Popover: React$1.FC<PopoverPrimitive.PopoverProps>;
 declare const PopoverTrigger: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const PopoverAnchor: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const PopoverPortal: React$1.FC<PopoverPrimitive.PopoverPortalProps>;
 declare const PopoverClose: React$1.ForwardRefExoticComponent<PopoverPrimitive.PopoverCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
-declare const PopoverContent: React$1.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface PopoverContentProps extends React$1.ComponentPropsWithoutRef<typeof PopoverPrimitive.Content> {
+    /**
+     * The width of the surface. `md` (default, 18rem) is what the popover
+     * always rendered; `auto` sizes to the content, `trigger` matches the
+     * element that opened it, `sm` and `lg` are 16rem and 24rem. Replaces the
+     * `w-*` class consumers wrote on `className`.
+     *
+     * @experimental
+     */
+    width?: PopoverWidth;
+    /**
+     * Inner padding of the surface. `md` (default) is the `p-4` the popover
+     * always rendered; `sm` is `p-3`; `none` lets the content pad itself (a
+     * list, a form). Replaces the `p-*` class consumers wrote on `className`.
+     *
+     * @experimental
+     */
+    padding?: PopoverPadding;
+}
+declare const PopoverContent: React$1.ForwardRefExoticComponent<PopoverContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
 interface PressableProps extends React.ButtonHTMLAttributes<HTMLElement> {
     /**
@@ -2365,10 +3244,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,16 +3295,29 @@ interface RankedBarsProps extends React.HTMLAttributes<HTMLUListElement> {
 }
 declare const RankedBars: React$1.ForwardRefExoticComponent<RankedBarsProps & React$1.RefAttributes<HTMLUListElement>>;
 
-type SheetSide = "top" | "right" | "bottom" | "left";
-type DialogSize = "sm" | "md" | "lg" | "full";
+/**
+ * Props of `ResponsiveDialog`.
+ *
+ * @experimental
+ */
 interface ResponsiveDialogProps {
-    /** Controlled open state. */
-    open: boolean;
-    /** Open-state change handler (fires on overlay/esc/close as well). */
-    onOpenChange: (open: boolean) => void;
-    /** Accessible title. When omitted, a visually-hidden label is supplied. */
-    title?: React$1.ReactNode;
-    /** Supporting description rendered under the title. */
+    /** Controlled open state. Omit it (with `defaultOpen` / `trigger`) for uncontrolled mode. */
+    open?: boolean;
+    /** Initial open state in uncontrolled mode. Default `false`. */
+    defaultOpen?: boolean;
+    /** Open-state change handler (fires on backdrop, Escape and close as well). */
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * The element that opens the dialog, rendered as the Radix trigger
+     * (`asChild`), so focus returns to it on close. Useful in uncontrolled mode.
+     */
+    trigger?: React$1.ReactNode;
+    /**
+     * The accessible name and visible heading. Required: a dialog without a
+     * title is announced as "dialog" only (development error when missing).
+     */
+    title: React$1.ReactNode;
+    /** Supporting copy rendered under the title. */
     description?: React$1.ReactNode;
     /** Body content. */
     children?: React$1.ReactNode;
@@ -2417,18 +3326,28 @@ interface ResponsiveDialogProps {
      * callback (`() => onOpenChange(false)`) for self-dismissing buttons.
      */
     footer?: React$1.ReactNode | ((close: () => void) => React$1.ReactNode);
-    /** Class applied to the rendered Sheet/Dialog content surface. */
+    /** Class applied to the content surface (both presentations). */
     className?: string;
-    /** Sheet side on mobile. Default `"bottom"`. */
-    side?: SheetSide;
-    /** Desktop Dialog max-width preset. Default `"md"`. */
+    /**
+     * The edge the small-viewport sheet slides in from. Only `bottom` is
+     * rendered: the responsive presentation is a bottom sheet.
+     *
+     * @deprecated Ignored (development warning for a value other than
+     * `bottom`). Removed in 3.0.
+     */
+    side?: "top" | "right" | "bottom" | "left";
+    /** Width step of the centred dialog. Default `md`. See `DialogSize`. */
     size?: DialogSize;
 }
 /**
- * Renders a bottom Sheet on mobile and a centered Dialog on desktop from one
- * controlled API. Composes the existing Sheet and Dialog primitives.
+ * A bottom sheet on small viewports and a centred dialog from the `sm`
+ * breakpoint, from one API: a thin wrapper over
+ * `<Dialog><DialogContent presentation="responsive">` with the header and
+ * footer parts filled from props.
+ *
+ * @experimental
  */
-declare function ResponsiveDialog({ open, onOpenChange, title, description, children, footer, className, side, size, }: ResponsiveDialogProps): react_jsx_runtime.JSX.Element;
+declare function ResponsiveDialog({ open, defaultOpen, onOpenChange, trigger, title, description, children, footer, className, side, size, }: ResponsiveDialogProps): react_jsx_runtime.JSX.Element;
 declare namespace ResponsiveDialog {
     var displayName: string;
 }
@@ -2459,18 +3378,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 +3483,7 @@ interface SearchSelectOption {
      */
     description?: string;
 }
+/** @deprecated Use `ComboboxProps`. Removed in 3.0 (C-SEARCHSELECT, CM-08). */
 interface SearchSelectProps {
     options: SearchSelectOption[];
     /**
@@ -2566,8 +3546,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: placeholderProp, className, disabled, groupFilter, pinnedGroups, closeOnSelect: closeOnSelectProp, showGroupCounts, onCreateNew, createNewLabel: createNewLabelProp, 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 +3639,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 +3702,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 +3815,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: placeholderProp, 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,47 +3873,95 @@ 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;
+    (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>>;
 declare const SheetDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
 
-declare const sideDrawerVariants: (props?: ({
-    side?: "left" | "right" | null | undefined;
-    width?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface SideDrawerProps extends VariantProps<typeof sideDrawerVariants> {
+type SideDrawerWidth = "sm" | "md" | "lg";
+type SideDrawerSide = "right" | "left";
+/**
+ * Props of `SideDrawer`.
+ *
+ * @deprecated Use `Sheet` (`SheetContent side size`, `SheetHeader`,
+ * `SheetBody`, `SheetFooter`, `onOpenChange`); codemod CM-09. Removed in 3.0.
+ */
+interface SideDrawerProps {
     open: boolean;
     onClose: () => void;
-    width?: "sm" | "md" | "lg";
-    side?: "right" | "left";
+    width?: SideDrawerWidth;
+    side?: SideDrawerSide;
     children: React$1.ReactNode;
 }
+/**
+ * @deprecated Use `Sheet` (C-SIDEDRAWER, codemod CM-09). Removed in 3.0.
+ */
 declare function SideDrawer({ open, onClose, width, side, children, }: SideDrawerProps): react_jsx_runtime.JSX.Element;
 declare namespace SideDrawer {
     var Header: typeof SideDrawerHeader;
@@ -2790,11 +3986,6 @@ interface SideDrawerFooterProps {
 }
 declare function SideDrawerFooter({ children, className }: SideDrawerFooterProps): react_jsx_runtime.JSX.Element;
 
-/**
- * Skeleton — animated placeholder. The `.skeleton` global class supplies
- * the shimmer animation (defined in tokens.css). All three primitives are
- * `aria-hidden` because they're decorative loading affordances.
- */
 interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
     className?: string;
 }
@@ -2808,11 +3999,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 +4480,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>>;
 
@@ -3310,18 +4542,96 @@ declare function TeamMemberSelect({ teamMembers, currentUserId, value, onValueCh
 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";
@@ -3365,16 +4675,49 @@ interface ToastContextValue {
     }) => Promise<T>;
 }
 declare function useToast(): ToastContextValue;
+
 interface ToastProviderProps {
     children: React.ReactNode;
+    /**
+     * Overrides of the copy the region and its toasts render (the region's
+     * accessible name, the dismiss button). Default English; the provider's
+     * `messages.toast` applies below it.
+     */
+    messages?: Partial<ToastMessages>;
 }
-declare function ToastProvider({ children }: ToastProviderProps): react_jsx_runtime.JSX.Element;
+declare function ToastProvider({ children, messages: messagesProp }: ToastProviderProps): react_jsx_runtime.JSX.Element;
 
 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>>;
@@ -3418,13 +4761,16 @@ declare const TooltipTrigger: React$1.ForwardRefExoticComponent<TooltipPrimitive
 declare const TooltipPortal: React$1.FC<TooltipPrimitive.TooltipPortalProps>;
 interface TooltipProps extends React$1.ComponentPropsWithoutRef<typeof TooltipPrimitive.Root> {
     /**
-     * Backwards-compat alias for Radix's `delayDuration`. Kept so existing
-     * call sites that passed `delayMs={…}` keep working unchanged.
+     * Alias of Radix's `delayDuration`. `delayDuration` wins when both are
+     * given. Contract C-TOOLTIP-DELAY, removed in 3.0; codemod CM-13 renames it.
+     *
+     * @deprecated Use `delayDuration`.
      */
     delayMs?: number;
     /**
-     * Optional delayDuration applied to the implicit Provider. Forwarded
-     * here when no surrounding `<TooltipProvider>` is present.
+     * How long the pointer rests on the trigger before the tooltip opens, in
+     * milliseconds. Default: the surrounding provider's (`DesignSystemProvider
+     * tooltip.delayDuration`), or 300 without one.
      */
     delayDuration?: number;
 }
@@ -3432,7 +4778,20 @@ declare const Tooltip: {
     ({ delayMs, delayDuration, children, ...props }: TooltipProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
-declare const TooltipContent: React$1.ForwardRefExoticComponent<Omit<TooltipPrimitive.TooltipContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * How wide a `TooltipContent` may grow before its text wraps. `xs` (20rem)
+ * is what the tooltip always rendered; `sm` and `md` are 24rem and 28rem for
+ * multi-line help; `none` lets the text set the width. Replaces the `max-w-*`
+ * class consumers wrote on `className` (a third of them today).
+ *
+ * @experimental
+ */
+type TooltipMaxWidth = "xs" | "sm" | "md" | "none";
+interface TooltipContentProps extends React$1.ComponentPropsWithoutRef<typeof TooltipPrimitive.Content> {
+    /** See {@link TooltipMaxWidth}. Default `xs`. @experimental */
+    maxWidth?: TooltipMaxWidth;
+}
+declare const TooltipContent: React$1.ForwardRefExoticComponent<TooltipContentProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
  * VisuallyHidden — hides content from sighted users while keeping it
@@ -4007,6 +5366,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,
@@ -6836,7 +8629,7 @@ declare const BulkActionBarAction: React$1.ForwardRefExoticComponent<BulkActionB
 declare function BulkActionBarSeparator({ className }: {
     className?: string;
 }): react_jsx_runtime.JSX.Element;
-declare function BulkActionBar({ variant, selectedCount, label, children, onClear, clearLabel, clearDisabled, footer, className, ...props }: BulkActionBarProps): react_jsx_runtime.JSX.Element | null;
+declare function BulkActionBar({ variant, selectedCount, label, children, onClear, clearLabel: clearLabelProp, clearDisabled, footer, className, ...props }: BulkActionBarProps): react_jsx_runtime.JSX.Element | null;
 
 /**
  * Intent-named action wrappers (Phase 4).
@@ -7209,6 +9002,53 @@ type StickyStackSectionHeaderProps = StickyStackStickyProps;
  */
 declare const StickyStackSectionHeader: React$1.ForwardRefExoticComponent<StickyStackStickyProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/** What `useConfirm()` asks with: the copy and the meaning of one confirmation. @experimental */
+interface ConfirmOptions {
+    title: React$1.ReactNode;
+    description?: React$1.ReactNode;
+    confirmLabel?: React$1.ReactNode;
+    cancelLabel?: React$1.ReactNode;
+    intent?: ConfirmIntent;
+    presentation?: ConfirmPresentation;
+    /** Block content under the description (see `ConfirmDialog children`). */
+    content?: React$1.ReactNode;
+}
+/** What `usePrompt()` asks with: a confirmation around one text input. @experimental */
+interface PromptOptions extends ConfirmOptions {
+    /** The input's label. Falls back to the title as the accessible name when it is a string. */
+    label?: string;
+    defaultValue?: string;
+    placeholder?: string;
+    /** The confirm button stays disabled while the value is empty. Default `false`. */
+    required?: boolean;
+    /** The input type. Default `"text"`. */
+    inputType?: "text" | "email" | "number" | "password" | "tel" | "url";
+}
+/** The function `useConfirm()` returns. @experimental */
+type ConfirmFn = (options: ConfirmOptions) => Promise<boolean>;
+/** The function `usePrompt()` returns. @experimental */
+type PromptFn = (options: PromptOptions) => Promise<string | null>;
+/** The design system's imperative confirm. See the file comment. @experimental */
+declare function useConfirm(): ConfirmFn;
+/** The design system's imperative prompt. See the file comment. @experimental */
+declare function usePrompt(): PromptFn;
+/** Props of `ConfirmHost`. @experimental */
+interface ConfirmHostProps {
+    children?: React$1.ReactNode;
+}
+/**
+ * Where `useConfirm` / `usePrompt` render (W5-18). Mount it once, high in the
+ * tree — `DesignSystemProvider confirm` does — and every hook below it shares
+ * the queue. Renders no DOM of its own while nothing is asked. On the server
+ * a request resolves as cancelled at once (nothing can answer it).
+ *
+ * @experimental
+ */
+declare function ConfirmHost({ children }: ConfirmHostProps): react_jsx_runtime.JSX.Element;
+declare namespace ConfirmHost {
+    var displayName: string;
+}
+
 declare function cn(...inputs: ClassValue[]): string;
 
 /**
@@ -7288,4 +9128,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, CommandPaletteMessages, type CommandSlot, ConfirmActionButton, type ConfirmActionButtonProps, ConfirmDialog, type ConfirmDialogProps, type ConfirmFn, ConfirmHost, type ConfirmHostProps, type ConfirmInitialFocus, type ConfirmIntent, ConfirmMessages, type ConfirmOptions, type ConfirmPresentation, type ConfirmResult, 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 DialogPresentation, type 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, type HoverCardContentProps, type HoverCardPadding, HoverCardPortal, HoverCardTrigger, type HoverCardWidth, 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, KeyboardShortcutsMessages, 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, PhoneFieldMessages, type PhoneFieldProps, type PhoneFieldSlot, PhoneInput, type PillStatus, Popover, PopoverAnchor, PopoverClose, PopoverContent, type PopoverContentProps, type PopoverPadding, PopoverPortal, type PopoverSlot, PopoverTrigger, type PopoverWidth, 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, type PromptFn, type PromptOptions, 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, ToastMessages, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, type ToggleGroupFormProps, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleGroupSize, type ToggleGroupVariant, Toolbar, type ToolbarProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipMaxWidth, TooltipPortal, type TooltipProps, 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, useConfirm, useFieldControl, usePrompt, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };