@assure-one/design-system 1.34.0 → 1.36.0

package/dist/index.d.ts

@@ -1,10 +1,11 @@
-import { S as SystemTokens, i as iconSizes } from './system-BDU18fVg.js';
-export { C as ColorName, R as ReferenceTokens, c as colors, r as radii, a as reference, s as shadows, b as spacing, d as surfaces, e as systemTokens, t as typography } from './system-BDU18fVg.js';
+export { C as ColorName, R as ReferenceTokens, S as SystemTokens, c as colors, r as radii, a as reference, s as shadows, b as spacing, d as surfaces, e as systemTokens, t as typography } from './system-BDU18fVg.js';
 import * as React$1 from 'react';
-import { ReactNode, CSSProperties } from 'react';
+import { ReactNode, InputHTMLAttributes, HTMLAttributes, RefCallback, ReactElement, FieldsetHTMLAttributes, CSSProperties } from 'react';
 import * as AccordionPrimitive from '@radix-ui/react-accordion';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
+import { V as Variant, I as Intent, C as ControlSize, S as Shape } from './index-CQwzTm0v.js';
+export { A as AlertCircleIcon, a as AlertTriangleIcon, b as AlertTriangleSolidIcon, c as ArchiveIcon, d as ArrowDownIcon, e as ArrowLeftIcon, f as ArrowRightIcon, g as ArrowRightSmallIcon, h as ArrowUpIcon, i as AtSignIcon, B as BarChartIcon, j as BellIcon, k as BoldIcon, l as BrainIcon, m as BriefcaseIcon, n as Building2Icon, o as BuildingIcon, p as CalendarIcon, q as ChatBubbleIcon, r as CheckCircle2Icon, s as CheckCircleSolidIcon, t as CheckIcon, u as ChevronDownIcon, v as ChevronLeftIcon, w as ChevronRightIcon, x as ChevronUpIcon, y as ChevronsDownUpIcon, z as ChevronsUpDownIcon, D as CircleDotIcon, E as CircleIcon, F as ClipboardCheckIcon, G as ClockIcon, H as CloseIcon, J as CommandIcon, K as CopyIcon, L as CornerDownLeftIcon, M as CreditCardIcon, N as DocumentIcon, O as DollarSignIcon, P as DownloadIcon, Q as ExternalLinkIcon, R as ExtractIcon, T as EyeIcon, U as EyeOffIcon, W as FileIcon, X as FileReturnIcon, Y as FileTextIcon, Z as FilterIcon, _ as FlagIcon, $ as FolderClosedIcon, a0 as FolderOpenIcon, a1 as FolderPlusIcon, a2 as FolderUpIcon, a3 as GlobeIcon, a4 as GoogleBrandIcon, a5 as GripVerticalIcon, a6 as HelpCircleIcon, a7 as HistoryIcon, a8 as HomeIcon, a9 as IconComponent, aa as IconDefinition, ab as IconProps, ac as IconSize, ad as InboxIcon, ae as InfoCircleSolidIcon, af as InfoIcon, ag as ItalicIcon, ah as KanbanIcon, ai as KeyIcon, aj as LandmarkIcon, ak as LayersIcon, al as LayoutDashboardIcon, am as LayoutGridIcon, an as LayoutListIcon, ao as LightningIcon, ap as Link2Icon, aq as LinkIcon, ar as ListChecksIcon, as as ListIcon, at as ListOrderedIcon, au as LoaderIcon, av as LockIcon, aw as LockKeyholeIcon, ax as LockOpenIcon, ay as LogOutIcon, az as MailIcon, aA as MapPinIcon, aB as MaximizeIcon, aC as MenuIcon, aD as MessageCircleIcon, aE as MessageCircleWarningIcon, aF as MicIcon, aG as MicrosoftBrandIcon, aH as MinimizeIcon, aI as MinusIcon, aJ as MonitorIcon, aK as MoonIcon, aL as MoreHorizontalIcon, aM as MoveIcon, aN as PaletteIcon, aO as PanelLeftCloseIcon, aP as PanelLeftIcon, aQ as PanelRightIcon, aR as PaperclipIcon, aS as PauseIcon, aT as PenSignIcon, aU as PenToolIcon, aV as PencilIcon, aW as PhoneIcon, aX as PlayIcon, aY as PlusIcon, aZ as ReceiptIcon, a_ as RefreshCwIcon, a$ as ReplyIcon, b0 as RotateCcwIcon, b1 as SaveIcon, b2 as SearchIcon, b3 as SendIcon, b4 as SettingsIcon, b5 as ShieldIcon, b6 as SigmaIcon, b7 as SlashIcon, b8 as SmartphoneIcon, b9 as SparkleIcon, ba as SparklesIcon, bb as StarIcon, bc as StopIcon, bd as StrikethroughIcon, be as SunIcon, bf as TableIcon, bg as TagIcon, bh as TeamIcon, bi as ThumbsDownIcon, bj as ThumbsUpIcon, bk as TimerIcon, bl as Trash2Icon, bm as TrashIcon, bn as TrashSolidIcon, bo as TrendingDownIcon, bp as TrendingUpIcon, bq as UnderlineIcon, br as UploadIcon, bs as UserCircleIcon, bt as UserIcon, bu as UsersIcon, bv as VideoIcon, bw as Volume2Icon, bx as VolumeXIcon, by as WorkflowIcon, bz as XCircleSolidIcon, bA as XIcon, bB as ZoomInIcon, bC as ZoomOutIcon, bD as createIcon } from './index-CQwzTm0v.js';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
 import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
@@ -15,6 +16,8 @@ import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
 import * as ContextMenuPrimitive from '@radix-ui/react-context-menu';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as DropdownMenuPrimitive from '@radix-ui/react-dropdown-menu';
+import { F as FileUploadMessages, S as SearchInputMessages, a as SelectMessages, b as FieldMessages, C as ComboboxMessages } from './design-system-provider-cPUklDJv.js';
+export { c as DesignSystemProvider, D as DesignSystemProviderProps, d as DsDirection, e as DsMessageNamespace, f as DsMessages, g as DsMessagesOverride, I as ImageComponent, h as ImageComponentProps, L as LinkComponent, i as LinkComponentProps, T as TooltipDefaults, u as useDsMessages } from './design-system-provider-cPUklDJv.js';
 import * as HoverCardPrimitive from '@radix-ui/react-hover-card';
 import * as LabelPrimitive from '@radix-ui/react-label';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
@@ -30,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>>;
@@ -52,6 +56,16 @@ type CodeSlot = "root" | "content";
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
 type KbdSlot = "root";
+/**
+ * `Pressable` has one part, its root, stamped as `data-slot="pressable"`
+ * (ADR-008): the element that carries the button behaviour, whether that is
+ * the `<button>` it renders or the child it wraps with `asChild`. State on the
+ * root: `data-disabled`, `data-pressed`. Components that compose it (`Button`
+ * once it adopts the behaviour, a clickable `Surface`) declare their own parts.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-03).
+ */
+type PressableSlot = "root";
 /**
  * `Button` parts, stamped as `data-slot="button[-<part>]"` (ADR-008).
  * States on the root: `data-variant`, `data-size`, `data-disabled`, and the
@@ -80,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;
@@ -103,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.
@@ -128,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;
@@ -148,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
@@ -162,12 +207,13 @@ type FileUploadSlot = "root" | "dropzone" | "input" | "error";
  * `Dialog` parts, stamped as `data-slot="dialog-<part>"` (ADR-008). There is
  * no `root`: `Dialog` is Radix's non-rendering root. `close` is stamped on
  * both the built-in close button and `DialogClose`; they are the same part —
- * a control that dismisses the dialog. States: `data-size` on the content.
+ * a control that dismisses the dialog. `body` is the scroll region between
+ * header and footer (W5-05). States: `data-size` on the content.
  * Radix's `data-state` is left as it is (`P-DATA-STATE`).
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "close";
+type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "body" | "footer" | "close";
 /**
  * `AlertDialog` parts, stamped as `data-slot="alert-dialog-<part>"`
  * (ADR-008). No `root` — Radix's root renders no element.
@@ -177,13 +223,14 @@ type DialogSlot = "overlay" | "content" | "header" | "title" | "description" | "
 type AlertDialogSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "action" | "cancel";
 /**
  * `Sheet` parts, stamped as `data-slot="sheet-<part>"` (ADR-008).
- * States: `data-size` on the content, carrying today's `width` preset — the
- * prop `C-SHEET-WIDTH` renames to `size` in W5-07. The `side` is not in the
- * §29.2 vocabulary and stays a class.
+ * `body` is the scroll region between header and footer (W5-07). States:
+ * `data-size` on the content, carrying the `size` step (or the deprecated
+ * `width` preset, C-SHEET-WIDTH; `default` when neither is given). The
+ * `side` is not in the §29.2 vocabulary and stays a class.
  *
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-18).
  */
-type SheetSlot = "overlay" | "content" | "header" | "title" | "description" | "footer" | "close";
+type SheetSlot = "overlay" | "content" | "header" | "title" | "description" | "body" | "footer" | "close";
 /**
  * `SideDrawer` parts, stamped as `data-slot="side-drawer[-<part>]"`
  * (ADR-008). `root` is the panel. The screen-reader-only Radix title that the
@@ -352,6 +399,281 @@ type InlineSlot = "root";
  * @experimental Slot names are experimental until ADR-008 is accepted (W2-16).
  */
 type SurfaceSlot = "root";
+/**
+ * `Avatar` parts, stamped as `data-slot="avatar[-<part>]"` (ADR-008, W3-16).
+ * `root` is the outer positioning wrapper — the element a consumer's
+ * `shrink-0` / `mt-0.5` overrides are aimed at and `classNames.root` reaches;
+ * `frame` is the circle (the Radix root: image and fallback clip to it), and
+ * the element `className` and `ref` keep landing on behind the compatibility
+ * entry (target architecture §29.1, ADR-008 decision 6 — the landing does not
+ * move silently). `image` and `fallback` are the Radix image and fallback;
+ * `status` is the corner dot, rendered only when `status` is set.
+ * States on the root: `data-size`, `data-variant`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-16).
+ */
+type AvatarSlot = "root" | "frame" | "image" | "fallback" | "status";
+/**
+ * `Card` parts, stamped as `data-slot="card[-<part>]"` (ADR-008, W3-17). The
+ * root is a `Surface` (W2-16) that stamps `card` over `surface`: a composite
+ * declares its own parts. Each part is a real JSX component (`CardHeader`,
+ * `CardTitle`, …) and takes `className` itself, so `Card` has no `classNames`
+ * (ADR-008 decision 4). States on the root: `data-variant`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-17).
+ */
+type CardSlot = "root" | "header" | "title" | "description" | "action" | "content" | "footer";
+/**
+ * `StatusBadge` parts, stamped as `data-slot="status-badge[-<part>]"`
+ * (ADR-008): the root, the `indicator` (dot, icon or spinner — one at a time)
+ * and the `label`. States on the root: `data-variant`, `data-intent`,
+ * `data-size`, `data-loading`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-14).
+ */
+type StatusBadgeSlot = "root" | "indicator" | "label";
+/**
+ * `IconButton` parts, stamped as `data-slot="icon-button[-<part>]"` (ADR-008):
+ * the square root, the `icon` box and the `spinner` that replaces it while
+ * loading. States on the root: `data-variant`, `data-intent`, `data-size`,
+ * `data-disabled`, `data-loading`, `data-pressed`.
+ *
+ * @experimental Slot names are experimental until ADR-008 is accepted (W3-09).
+ */
+type IconButtonSlot = "root" | "icon" | "spinner";
+/**
+ * `Chip` parts, stamped as `data-slot="chip[-<part>]"` (ADR-008): the root
+ * (the pressable itself, or the group that holds a pressable label and the
+ * `remove` button), the leading `icon`, the `label`, the `count` and the
+ * `remove` button. States on the root: `data-variant`, `data-intent`,
+ * `data-size`, `data-disabled`, `data-pressed`.
+ *
+ * @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>>;
@@ -359,16 +681,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>>;
 
 /**
@@ -474,24 +813,111 @@ declare const statusStyles: {
     readonly busy: "ds:bg-danger-fg";
     readonly offline: "ds:bg-fg-4";
 };
+
+/**
+ * Props of `Avatar`. Everything not listed spreads onto the frame (the Radix
+ * root), as it always has.
+ */
 interface AvatarProps extends Omit<React$1.ComponentPropsWithoutRef<typeof AvatarPrimitive.Root>, "children">, VariantProps<typeof avatarVariants> {
     src?: string | null;
     alt?: string;
     name?: string;
     status?: keyof typeof statusStyles;
+    /**
+     * One class per part, keyed by `AvatarSlot` (ADR-008 decision 4). `root` is
+     * the outer wrapper — where a `shrink-0` or a margin belongs; `frame` is the
+     * circle, the same element `className` lands on. Each part's class comes
+     * after the design system's own and, on the frame, before `className`, so a
+     * consumer's `className` keeps winning exactly as it does today.
+     *
+     * Spelled out as `Partial<Record<AvatarSlot, string>>` rather than through the
+     * internal `SlotClassNames` helper so the public declaration names no
+     * unexported type.
+     *
+     * @experimental
+     */
+    classNames?: Partial<Record<AvatarSlot, string>>;
 }
 declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLSpanElement>>;
 
+/** The emphasis subset a badge offers. @experimental */
+type BadgeVariant = Extract<Variant, "solid" | "soft" | "outline">;
+/** The badge's own size scale, spelled with the shared names (§17). @experimental */
+type BadgeSize = Extract<ControlSize, "xs" | "sm" | "md">;
+/** Corner treatment; omitted keeps today's corner (D1). @experimental */
+type BadgeShape = Extract<Shape, "rounded" | "pill">;
 /**
- * Badge — status atom. Pill-family variants. Default variant is the
- * neutral pill.
+ * The one-axis words Badge accepted before W3-13. Each resolves to a
+ * `{ variant, intent }` pair through `resolveBadgeAppearance` and renders the
+ * same classes it always did.
+ *
+ * @deprecated Use `variant` (`solid | soft | outline`) with `intent` instead:
+ * `default` → `solid` + `brand`, `secondary` → `soft` + `neutral`,
+ * `destructive` → `soft` + `danger`, `success | warning | info` → `soft` +
+ * the same word. `outline` is already an emphasis and is not deprecated.
  */
-declare const badgeVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "outline" | "default" | "destructive" | "secondary" | null | undefined;
-    size?: "sm" | "md" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+type BadgeLegacyVariant = "default" | "secondary" | "destructive" | "success" | "warning" | "info";
+/** A resolved `{ variant, intent }` pair. @experimental */
+interface BadgeAppearance {
+    variant: BadgeVariant;
+    intent: Intent;
+}
+/** What a badge can be asked for: the two axes, either one, or a legacy word. @experimental */
+interface BadgeAppearanceInput {
+    variant?: BadgeVariant | BadgeLegacyVariant | null | undefined;
+    intent?: Intent | null | undefined;
+}
+/**
+ * Resolves what a consumer asked for into the pair the class table is keyed by.
+ *
+ * - both axes: taken as given (a legacy `variant` word with an explicit
+ *   `intent` keeps the word's emphasis and takes the intent);
+ * - `variant` only: the per-variant default intent, or the legacy pair;
+ * - `intent` only: the per-intent default variant;
+ * - nothing: `solid` + `brand`, today's default.
+ *
+ * @experimental
+ */
+declare function resolveBadgeAppearance({ variant, intent, }?: BadgeAppearanceInput): BadgeAppearance;
+/** The inputs `badgeVariants` accepts (the legacy `variant` words included). @experimental */
+interface BadgeVariantsProps extends BadgeAppearanceInput {
+    size?: BadgeSize | null | undefined;
+    shape?: BadgeShape | null | undefined;
+    class?: string | null | undefined;
+    className?: string | null | undefined;
+}
+/**
+ * The badge's class string, for consumers that style their own element.
+ * Same call shape as before W3-13 (`variant`, `size`, `class`/`className`),
+ * plus `intent` and `shape`; a legacy `variant` word yields the string it
+ * always did.
+ */
+declare function badgeVariants({ variant, intent, size, shape, class: classValue, className, }?: BadgeVariantsProps): string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /**
+     * Visual emphasis: `solid` (filled), `soft` (tinted, the status look) or
+     * `outline`. Omitted, it follows `intent` (brand is solid, the rest soft);
+     * with neither prop the badge is `solid` + `brand`, as it always was.
+     * The legacy one-axis words are accepted and deprecated (`BadgeLegacyVariant`).
+     */
+    variant?: BadgeVariant | BadgeLegacyVariant;
+    /**
+     * Semantic meaning → colour family. Omitted, it follows `variant`
+     * (`solid` is brand, `soft` and `outline` are neutral).
+     * @experimental
+     */
+    intent?: Intent;
+    /** `xs` (10px text, W3-13), `sm` (default) or `md`. */
+    size?: BadgeSize;
+    /**
+     * Corner treatment. Omitted keeps today's corner (`--radius-pill`);
+     * `rounded` is the `radius.badge` role, `pill` is `radius.full` (D1).
+     * @experimental
+     */
+    shape?: BadgeShape;
+    /** Leading status dot, drawn in the text colour. */
     dot?: boolean;
+    /** Leading 14px glyph. */
     icon?: React.ReactNode;
 }
 declare const Badge: React$1.ForwardRefExoticComponent<BadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
@@ -535,39 +961,47 @@ declare const BreadcrumbPage: React$1.ForwardRefExoticComponent<BreadcrumbPagePr
 type BreadcrumbSeparatorProps = React.HTMLAttributes<HTMLSpanElement>;
 declare const BreadcrumbSeparator: React$1.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React$1.RefAttributes<HTMLSpanElement>>;
 
-/**
- * Button — action atom.
- *
- * Variants:
- *   - primary    → bg-brand (suite accent)
- *   - secondary  → ghost surface bg-bg-2
- *   - destructive → bg-danger-fg
- *   - success    → bg-success-fg
- *   - ghost      → transparent, hover:bg-bg-2
- *   - outline    → bordered surface
- *   - link       → text-accent (cyan) with underline-on-hover
- *   - accent     → stable suite-level cyan CTA (does not follow product scope)
- *   - dashed     → full-bleed "+ Add another" CTA, transparent fill + dashed border
- *
- * Control text scale (shared across the button-family control primitives
- * Button / MultiFilterPill / FilterChip): sm = 13px, md = 14px, lg = 16px.
- * `sm` is the dense tier used in toolbars; `md` is the default. (SearchInput
- * keeps its own one-step-denser inputSize scale, 12/13/14.)
- * Use `asChild` to render as a different element (e.g. an anchor / next/link).
- */
-declare const buttonVariants: (props?: ({
-    variant?: "accent" | "success" | "outline" | "ghost" | "link" | "dashed" | "destructive" | "primary" | "secondary" | null | undefined;
-    size?: "sm" | "md" | "lg" | "default" | "compact" | "icon" | "comfortable" | "icon-xs" | "icon-sm" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type ButtonVariant = NonNullable<VariantProps<typeof buttonVariants>["variant"]>;
-type ButtonSize = NonNullable<VariantProps<typeof buttonVariants>["size"]>;
-
-interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, ButtonIconProps {
+    /**
+     * Visual emphasis: `solid` (default) · `soft` · `outline` · `ghost` · `link`.
+     * The legacy words (`primary`, `secondary`, `destructive`, `success`,
+     * `accent`, `dashed`) are deprecated aliases — see {@link ButtonLegacyVariant}.
+     */
+    variant?: ButtonVariant;
+    /**
+     * Meaning → colour family: `brand` · `neutral` · `success` · `danger`.
+     * Defaults per variant so an omitted prop renders what it always did.
+     * `destructive` is a deprecated alias of `danger` (decision D4).
+     *
+     * @experimental
+     */
+    intent?: ButtonIntent | ButtonIntentAlias;
+    /**
+     * The shared control scale `xs · sm · md · lg · xl` (ADR-013). Default `md`
+     * (40px); `xs` and `xl` are new in W3-05. The icon-only squares `icon-xs` ·
+     * `icon-sm` · `icon` are deprecated in favour of `IconButton`
+     * ({@link ButtonIconSize}), and `compact` / `default` / `comfortable` are
+     * deprecated aliases of `sm` / `md` / `lg` ({@link ButtonSizeAlias}).
+     */
+    size?: ButtonSize;
     /** Render as the child element via Radix `Slot` (shadcn pattern). */
     asChild?: boolean;
     loading?: boolean;
-    iconLeft?: React.ReactNode;
-    iconRight?: React.ReactNode;
+    /**
+     * Stretch to the container's width (`w-full`). A prop instead of a
+     * `className`, so the codemods and the dashboard can see it.
+     *
+     * @experimental
+     */
+    fullWidth?: boolean;
+    /**
+     * Toggle state (a boolean prop, never a variant — ADR-007 §2). Reflected as
+     * `aria-pressed` and, when true, `data-pressed`. Leave undefined for an
+     * action that does not toggle.
+     *
+     * @experimental
+     */
+    pressed?: boolean;
 }
 declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
 
@@ -577,102 +1011,319 @@ interface CalendarHighlight {
     date: Date;
     color?: CalendarHighlightColor;
 }
-interface CalendarProps extends Omit<DayPickerProps, "mode" | "selected" | "onSelect" | "modifiers" | "modifiersClassNames"> {
-    selected?: Date | null;
-    onSelect?: (date: Date) => void;
+/** A range as `Calendar mode="range"` reports it: either edge may be missing while the user picks. */
+interface CalendarRange {
+    from?: Date;
+    to?: Date;
+}
+/** Props shared by both modes of `Calendar`. */
+interface CalendarBaseProps extends Omit<DayPickerProps, "mode" | "selected" | "onSelect" | "modifiers" | "modifiersClassNames" | "locale" | "required"> {
     highlights?: CalendarHighlight[];
     minDate?: Date;
     maxDate?: Date;
     className?: string;
+    /**
+     * A BCP 47 language tag (`"en-US"`, `"fr-FR"`), or a `date-fns` locale
+     * object as before. Default: the provider's locale, else `"en-US"` (A3).
+     */
+    locale?: string | DayPickerProps["locale"];
+}
+/** Single-date calendar (the default mode). */
+interface CalendarProps extends CalendarBaseProps {
+    mode?: "single";
+    selected?: Date | null;
+    onSelect?: (date: Date) => void;
+}
+/**
+ * Range calendar: `selected` is a `{ from, to }` pair and `onSelect` reports
+ * the pair react-day-picker produced, `undefined` when it cleared the range.
+ *
+ * @experimental
+ */
+interface CalendarRangeProps extends CalendarBaseProps {
+    mode: "range";
+    selected?: CalendarRange | null;
+    onSelect?: (range: CalendarRange | undefined) => void;
 }
-declare function Calendar({ selected, onSelect, highlights, minDate, maxDate, className, classNames, captionLayout, navLayout, startMonth, endMonth, components, ...props }: CalendarProps): react_jsx_runtime.JSX.Element;
+declare function Calendar({ mode, selected, onSelect, highlights, minDate, maxDate, className, classNames, captionLayout, navLayout, startMonth, endMonth, components, locale: localeProp, today: todayProp, formatters, labels, lang, weekStartsOn, ...props }: CalendarProps | CalendarRangeProps): react_jsx_runtime.JSX.Element;
 declare namespace Calendar {
     var displayName: string;
 }
 
 /**
- * Card — surface container. 12px radius, 1px rule border, surface bg.
- * Three variants:
+ * Inner padding of a `Surface`, as a `surface.padding` role (W2-02): 16 / 20 /
+ * 24px — the three card and panel paddings the library and its consumers
+ * already write — or `none` for a surface whose content pads itself (a table,
+ * an image, a list with its own row padding).
  *
- *   default     — settled card on the page (current behavior, unchanged)
- *   interactive — clickable card; hover darkens the border
- *   flat        — borderless / shadowless transparent surface, for nesting
- *                 inside Dialog/Sheet/Card without double-border
+ * @experimental
  */
-declare const cardVariants: (props?: ({
-    variant?: "flat" | "default" | "interactive" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type CardVariants = VariantProps<typeof cardVariants>;
-interface CardProps extends React.HTMLAttributes<HTMLDivElement>, CardVariants {
-}
-declare const Card: React$1.ForwardRefExoticComponent<CardProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const CardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-declare const CardTitle: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLHeadingElement> & React$1.RefAttributes<HTMLHeadingElement>>;
-declare const CardDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
-declare const CardContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-declare const CardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-declare const CardAction: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
-
+type SurfacePadding = "none" | "sm" | "md" | "lg";
 /**
- * CategoryDivider — THE category separator: a tone-tinted category pill, a
- * flex-1 hairline rule, and an optional trailing count chip. Used to group a
- * run of feed items / cards by service line. Per the ONE-brand rule, this tag
- * is the *only* place per-service color is allowed — everything else stays on
- * the single brand. Pure presentational.
+ * Corner radius of a `Surface`, as a radius role (W2-07, target architecture
+ * §18): `surface` for cards, dialogs and sheets, `surface-sm` for popovers,
+ * tooltips, toasts and small cards, or `none`. Control and badge radii are not
+ * offered: a surface is never a control.
  *
- * Tones map to the suite tints:
- *   brand → --color-brand-pro · audit → --color-brand-audit ·
- *   books → --color-brand-books · tax → --color-brand-tax ·
- *   neutral → --color-fg-3
+ * @experimental
  */
-declare const categoryTagVariants: (props?: ({
-    tone?: "brand" | "neutral" | "audit" | "books" | "tax" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type CategoryTone = NonNullable<VariantProps<typeof categoryTagVariants>["tone"]>;
-interface CategoryTagProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof categoryTagVariants> {
-    /** Tag label text. */
-    label: string;
-    /** Optional leading icon rendered inside the pill. */
-    icon?: React.ReactNode;
-}
+type SurfaceRadius = "none" | "surface-sm" | "surface";
 /**
- * CategoryTag — the standalone tone-tinted category pill, reusable in card
- * headers and feed-item rows. Same atom CategoryDivider renders on its left.
+ * Elevation of a `Surface`, as an elevation role (W2-08, target architecture
+ * §19): `flat` (resting, border-led — today's `Card`), `raised` (resting
+ * lift), `floating` (anchored transient surfaces), `overlay` (modal surfaces),
+ * or `none` for no shadow at all — which is what the hand-rolled card boxes in
+ * every product render, and the default. `flat` is kept distinct from `none`
+ * because today's `flat` role still aliases the hairline `shadow-quiet` (gated
+ * on D1); when D1 lands the two coincide and nothing here changes.
+ *
+ * @experimental
  */
-declare const CategoryTag: React$1.ForwardRefExoticComponent<CategoryTagProps & React$1.RefAttributes<HTMLSpanElement>>;
-interface CategoryDividerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof categoryTagVariants> {
-    /** Category label shown in the tone-tinted tag. */
-    label: string;
-    /** Optional leading icon rendered inside the tag. */
-    icon?: React.ReactNode;
-    /** Optional item count → trailing neutral count chip. */
-    count?: number;
-}
-declare const CategoryDivider: React$1.ForwardRefExoticComponent<CategoryDividerProps & React$1.RefAttributes<HTMLDivElement>>;
-
-interface CheckboxProps extends Omit<React$1.ComponentPropsWithoutRef<typeof CheckboxPrimitive.Root>, "checked" | "defaultChecked"> {
-    /** Optional inline label rendered to the right of the box */
-    label?: string;
-    /** Tri-state support: true | false | "indeterminate" */
-    checked?: boolean | "indeterminate";
-    defaultChecked?: boolean | "indeterminate";
-    /** Convenience: render with indeterminate state. Mirrors legacy prop. */
-    indeterminate?: boolean;
-    /** Box shape. Defaults to "square". */
-    shape?: "square" | "circle";
-}
-declare const Checkbox: React$1.ForwardRefExoticComponent<CheckboxProps & React$1.RefAttributes<HTMLButtonElement>>;
+type SurfaceElevation = "none" | "flat" | "raised" | "floating" | "overlay";
 
-type ClientSelectOption = {
-    id: string;
-    label: string;
-    email?: string;
-};
-interface ClientSelectProps {
-    clients: ClientSelectOption[];
-    value: string | null;
-    onChange: (clientId: string | null) => void;
-    name?: string;
+/**
+ * Props of `Surface`.
+ *
+ * Tokenised props for exactly the three things a surface is (padding, radius,
+ * elevation) and nothing else: no `gap`/`align`/`direction` (that is a `Stack`
+ * inside it), no `bg`, `border`, `shadow`, `rounded`, `p`/`m`/`px`/`mt`,
+ * `color`, `width`, `height`, `sx` or `css`, and no numeric or length values.
+ * `className` and `style` land on the root element (§29.1).
+ *
+ * @experimental
+ */
+interface SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
+    /**
+     * Inner padding, as a `surface.padding` role.
+     * @default "sm"
+     */
+    padding?: SurfacePadding;
+    /**
+     * Corner radius, as a radius role.
+     * @default "surface"
+     */
+    radius?: SurfaceRadius;
+    /**
+     * Shadow, as an elevation role.
+     * @default "none"
+     */
+    elevation?: SurfaceElevation;
+}
+/**
+ * Surface — the bordered box content sits on (W2-16, target architecture §23).
+ * It is the primitive behind the 367 (Pro) / 119 (Portal) / 96 (Tax)
+ * hand-rolled card boxes of the consumer usage audit (the class string is
+ * `HAND_ROLLED_CARD` in the stories; it is not spelled here because Tailwind
+ * would compile it from this comment) and the `.surface` helper class: with no
+ * props it renders that box — surface background, 1px rule border,
+ * `radius.surface`, `surface.padding.sm`, no shadow — and every knob is a
+ * role, never a value. `Card` (W3-17) is built on it and adds anatomy.
+ *
+ * Deferred, deliberately:
+ * - `interactive`: a clickable surface renders through `Pressable` (W3-03) so
+ *   it gets keyboard activation, `data-pressed` and a focus ring for free; a
+ *   `cursor-pointer` hover treatment here would be a click target with no
+ *   keyboard semantics. Until then, put a `Button asChild` or a link inside
+ *   the surface.
+ * - `asChild`: waits for the design system's own `Slot` (a11y primitives).
+ *
+ * Server-safe: no hooks, no client directive, renders a plain `div` and stamps
+ * `data-slot="surface"`.
+ *
+ * Under a consumer's shadcn theme the hand-rolled box and this primitive differ
+ * on purpose in two places the parity story makes visible: the products'
+ * `rounded-xl` is `--radius` + 4px (16px) where `radius.surface` is 12px, and
+ * their `--border` is not the design system's rule colour. Both are decision
+ * D1 (target architecture §18); `Surface` follows the roles.
+ *
+ * @experimental Shipped in Wave 2 as a new export nobody is forced to use; the
+ * prop shapes may still change before the wave's exit review.
+ */
+declare const Surface: React$1.ForwardRefExoticComponent<SurfaceProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * The document-outline level: which of `<h1>`…`<h6>` renders. Semantic only —
+ * it says where the heading sits in the outline, not how large it is.
+ *
+ * @experimental W2-13.
+ */
+type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
+/**
+ * The visual role of a heading: one of the four title roles of target
+ * architecture §15. Independent of `level`. Written out as a literal union so
+ * the public API report records the names.
+ *
+ * @experimental W2-13.
+ */
+type HeadingSize = "display" | "title-page" | "title-section" | "title-sub";
+/**
+ * Props of `Heading`. `level` is required on purpose: a heading without an
+ * outline level is the hard-coded `h3`/`h1`/`h4` this component exists to end
+ * (target architecture §15.2, current-state audit §14).
+ *
+ * @experimental W2-13.
+ */
+interface HeadingProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    /** The outline level: renders `<h{level}>`. Required. */
+    level: HeadingLevel;
+    /**
+     * The visual role, independent of `level`. Defaults from the level
+     * (`1` → `title-page`, `2` → `title-section`, `3`–`6` → `title-sub`), so an
+     * `<h3>` that must look like a section title says `size="title-section"`
+     * instead of becoming an `<h2>`.
+     */
+    size?: HeadingSize;
+}
+/**
+ * `Heading` — an `<h1>`…`<h6>` whose outline level and visual size are two
+ * separate props (W2-13, target architecture §15.2).
+ *
+ * `level` is required and picks the element; `size` picks the title role and
+ * defaults from the level. Because the two are independent, a card title can
+ * be the `<h3>` the document outline needs and still render at the section
+ * scale, and a page can keep exactly one `<h1>` without every other title
+ * shrinking. Every size is a role token; there is no pixel size.
+ *
+ * Renders in the display family (`font-display`) and the heading ink (`fg`),
+ * as the base `h1`–`h4` rules do today, so an `<h5>` at `title-sub` matches an
+ * `<h4>` at `title-sub`.
+ *
+ * Server-safe: no hooks, no client directive, no effects.
+ *
+ * Anatomy: one part, `data-slot="heading"`, which is also where `className`
+ * and `style` land.
+ *
+ * @example
+ * ```tsx
+ * <Heading level={1}>Engagements</Heading>
+ * <Heading level={3} size="title-section">Documents</Heading>
+ * ```
+ *
+ * @experimental New export (W2-13); its size vocabulary may change while
+ * decision D1 (visual source of truth) is open.
+ */
+declare const Heading: React$1.ForwardRefExoticComponent<HeadingProps & React$1.RefAttributes<HTMLHeadingElement>>;
+
+/**
+ * The full card look as one class string, for a consumer that styles its own
+ * element as a card (`KpiCard`'s `<button>` does). Unchanged by W3-17: it
+ * still spells the settled box itself, because a `Surface` cannot be applied
+ * to someone else's element. `Card` itself renders a `Surface` and layers only
+ * the variant slice on it.
+ */
+declare const cardVariants: (props?: ({
+    variant?: "flat" | "default" | "interactive" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type CardVariants = VariantProps<typeof cardVariants>;
+
+/** Props of `Card`. */
+interface CardProps extends React.HTMLAttributes<HTMLDivElement>, CardVariants {
+    /**
+     * Inner padding of the root, as a `surface.padding` role (16 / 20 / 24px) —
+     * the `p-4` / `p-5` / `p-6` override 88 % of cards carry today, as a prop.
+     * `none` is today's default: the root has no padding of its own and
+     * `CardHeader` / `CardContent` / `CardFooter` pad themselves, so set a
+     * padding only on a card whose content is bare (no parts).
+     * @default "none"
+     */
+    padding?: SurfacePadding;
+}
+declare const Card: React$1.ForwardRefExoticComponent<CardProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const CardHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+/** Props of `CardTitle`. */
+interface CardTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    /**
+     * The document-outline level: which of `<h1>`…`<h6>` the title renders. The
+     * visual size does not change with it. Defaults to `3`, the tag the title
+     * always rendered; a section card directly under a page `<h1>` wants `2`
+     * (target architecture §15: "every titled component gains `headingLevel`").
+     * @default 3
+     */
+    headingLevel?: HeadingLevel;
+}
+declare const CardTitle: React$1.ForwardRefExoticComponent<CardTitleProps & React$1.RefAttributes<HTMLHeadingElement>>;
+declare const CardDescription: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLParagraphElement> & React$1.RefAttributes<HTMLParagraphElement>>;
+declare const CardContent: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const CardFooter: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+declare const CardAction: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLDivElement> & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * CategoryDivider — THE category separator: a tone-tinted category pill, a
+ * flex-1 hairline rule, and an optional trailing count chip. Used to group a
+ * run of feed items / cards by service line. Per the ONE-brand rule, this tag
+ * is the *only* place per-service color is allowed — everything else stays on
+ * the single brand. Pure presentational.
+ *
+ * Tones map to the suite tints:
+ *   brand → --color-brand-pro · audit → --color-brand-audit ·
+ *   books → --color-brand-books · tax → --color-brand-tax ·
+ *   neutral → --color-fg-3
+ */
+declare const categoryTagVariants: (props?: ({
+    tone?: "brand" | "neutral" | "audit" | "books" | "tax" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type CategoryTone = NonNullable<VariantProps<typeof categoryTagVariants>["tone"]>;
+interface CategoryTagProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof categoryTagVariants> {
+    /** Tag label text. */
+    label: string;
+    /** Optional leading icon rendered inside the pill. */
+    icon?: React.ReactNode;
+}
+/**
+ * CategoryTag — the standalone tone-tinted category pill, reusable in card
+ * headers and feed-item rows. Same atom CategoryDivider renders on its left.
+ */
+declare const CategoryTag: React$1.ForwardRefExoticComponent<CategoryTagProps & React$1.RefAttributes<HTMLSpanElement>>;
+interface CategoryDividerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof categoryTagVariants> {
+    /** Category label shown in the tone-tinted tag. */
+    label: string;
+    /** Optional leading icon rendered inside the tag. */
+    icon?: React.ReactNode;
+    /** Optional item count → trailing neutral count chip. */
+    count?: number;
+}
+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. Names the button through `htmlFor`. */
+    label?: string;
+    /** Tri-state support: true | false | "indeterminate" */
+    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>>;
+
+type ClientSelectOption = {
+    id: string;
+    label: string;
+    email?: string;
+};
+interface ClientSelectProps {
+    clients: ClientSelectOption[];
+    value: string | null;
+    onChange: (clientId: string | null) => void;
+    name?: string;
     error?: string;
     className?: string;
     placeholder?: string;
@@ -760,9 +1411,17 @@ declare const ContextMenuSubTrigger: React$1.ForwardRefExoticComponent<Omit<Cont
 declare const ContextMenuSubContent: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuSubContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const ContextMenuContent: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 interface ContextMenuItemProps extends React$1.ComponentPropsWithoutRef<typeof ContextMenuPrimitive.Item> {
+    /** Render as a destructive (danger) action — the `intent="danger"` look of the shared Menu recipe. */
     destructive?: boolean;
+    /** Increase left padding to align with checkbox/radio items. */
     inset?: boolean;
 }
+/**
+ * A menu item. Activation fires both `onSelect` (canonical; call
+ * `event.preventDefault()` on it to keep the menu open) and `onClick`
+ * (tolerated): Radix composes `onClick` with its select handler and a
+ * keyboard activation clicks the element.
+ */
 declare const ContextMenuItem: React$1.ForwardRefExoticComponent<ContextMenuItemProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const ContextMenuCheckboxItem: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuCheckboxItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const ContextMenuRadioItem: React$1.ForwardRefExoticComponent<Omit<ContextMenuPrimitive.ContextMenuRadioItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -805,10 +1464,25 @@ declare function isoToYear(iso: string | undefined | null): string;
 declare function yearToIso(year: string): string;
 /** Apply the `YYYY` mask while the user types. */
 declare function applyYearMask(input: string): string;
+/** A display pattern: the tokens `MM`, `DD` and `YYYY`, once each, around literal separators — `"MM/DD/YYYY"`, `"DD.MM.YYYY"`, `"YYYY-MM-DD"`. */
+type DatePattern = string;
 
 interface DatePickerProps {
-    value?: string;
+    /** ISO `YYYY-MM-DD`; `""` or `null` is "controlled, empty". */
+    value?: string | null;
     defaultValue?: string;
+    /**
+     * The value callback: the ISO date, or `null` when the field is cleared.
+     * Fires before the legacy `onChange` when both are passed.
+     *
+     * @experimental
+     */
+    onValueChange?: (value: string | null) => void;
+    /**
+     * Legacy fake-event callback (C-DATE-FAKEEVENT): `{ target: { name, value } }`
+     * with the ISO string (`""` when cleared). Prefer `onValueChange`; codemod
+     * CM-10 rewrites the recognisable shapes.
+     */
     onChange?: (event: {
         target: {
             name?: string;
@@ -816,6 +1490,22 @@ interface DatePickerProps {
         };
     }) => void;
     name?: string;
+    /** `id` of the form to submit with when the picker is rendered outside it (Dialog, Sheet). */
+    form?: string;
+    /**
+     * BCP 47 tag deciding the typed pattern, the mask and the default
+     * placeholder. Default: the provider's locale, else `"en-US"` (`MM/DD/YYYY`).
+     *
+     * @experimental
+     */
+    locale?: string;
+    /**
+     * The display pattern, overriding the locale's: `MM`, `DD` and `YYYY`
+     * once each around literal separators (`"DD.MM.YYYY"`). Ignored in year mode.
+     *
+     * @experimental
+     */
+    dateFormat?: DatePattern;
     id?: string;
     label?: string;
     error?: string;
@@ -860,11 +1550,33 @@ interface DateRangeValue {
     from?: string;
     to?: string;
 }
+/** The two form field names of a range. */
+interface DateRangeNames {
+    from: string;
+    to: string;
+}
 interface DateRangePickerProps {
     value?: DateRangeValue;
     defaultValue?: DateRangeValue;
     onChange?: (value: DateRangeValue) => void;
+    /** Base of the two field names: `${name}_from` / `${name}_to` unless `names` says otherwise. */
     name?: string;
+    /**
+     * Explicit field names for the two edges, replacing the `${name}_from` /
+     * `${name}_to` default (C-DATERANGE-NAMES, kept through 2.x).
+     *
+     * @experimental
+     */
+    names?: DateRangeNames;
+    /** `id` of the form to submit with when the picker is rendered outside it (Dialog, Sheet). */
+    form?: string;
+    /**
+     * BCP 47 tag deciding the displayed pattern of both edges and the
+     * calendar's language. Default: the provider's locale, else `"en-US"`.
+     *
+     * @experimental
+     */
+    locale?: string;
     id?: string;
     label?: string;
     error?: string;
@@ -887,37 +1599,101 @@ declare const Dialog: React$1.FC<DialogPrimitive.DialogProps>;
 declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
 declare const DialogOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const dialogSizeStyles: {
-    readonly sm: "ds:max-w-sm";
-    readonly md: "ds:max-w-lg";
-    readonly lg: "ds:max-w-2xl";
-    readonly full: "ds:max-w-[calc(100vw-2rem)]";
-};
+/**
+ * Width of a `DialogContent`, as a step of the dialog width scale (W5-05):
+ * `sm` 24rem · `md` 32rem (default) · `lg` 42rem · `xl` 56rem · `full` the
+ * viewport minus a 1rem gutter. `sm`/`md`/`lg`/`full` are the 1.x steps,
+ * pixel for pixel; `xl` is new. Every step yields to `--ds-dialog-width`
+ * when a consumer sets it (on the content, or on a scope above it), which
+ * is the replacement for the `!max-w-*` overrides products write today.
+ *
+ * @experimental
+ */
+type DialogSize$1 = "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * Height of a `DialogContent` (W5-05). `auto` (default) grows with the
+ * content and scrolls the whole box past `100vh - 6rem`, as it always did.
+ * A fixed step (`sm` 24rem · `md` 32rem · `lg` 44rem · `full` the viewport
+ * minus the same gutter, each capped at the viewport) turns the box into a
+ * column whose `DialogBody` is the scroll region, so header and footer stay
+ * put while long content scrolls.
+ *
+ * @experimental
+ */
+type DialogHeight = "auto" | "sm" | "md" | "lg" | "full";
+/**
+ * The copy a `Dialog` renders (target architecture §24.5). English defaults
+ * until the messages contract of the provider lands (W5-20).
+ *
+ * @experimental
+ */
+interface DialogMessages {
+    /** The accessible name of the built-in close button. Default `"Close"`. */
+    close: string;
+}
+/**
+ * Props of `DialogContent`: Radix's content props plus the sizing and
+ * dismiss options.
+ *
+ * @experimental
+ */
 interface DialogContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
-    size?: keyof typeof dialogSizeStyles;
+    /** Width step. Default `md`. See {@link DialogSize}. */
+    size?: DialogSize$1;
+    /** Height step. Default `auto`. See {@link DialogHeight}. */
+    height?: DialogHeight;
     /**
      * If false, the built-in close button is hidden. Default: true.
      * Use `<DialogClose>` inside content to render your own close UI.
      */
     showCloseButton?: boolean;
+    /**
+     * The accessible name of the built-in close button. Takes precedence over
+     * `messages.close`. Default `"Close"`.
+     */
+    closeLabel?: string;
+    /** Overrides of the copy the dialog renders (English defaults until W5-20). */
+    messages?: Partial<DialogMessages>;
 }
 declare const DialogContent: React$1.ForwardRefExoticComponent<DialogContentProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogClose: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DialogHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    (props: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
-declare const DialogFooter: {
-    ({ className, ...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>>;
+/**
+ * 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: {
+    (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>>;
 declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
 
-declare const chipVariants: (props?: ({
+declare const chipVariants$1: (props?: ({
     variant?: "neutral" | "primary" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface DismissibleChipProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "onClick" | "children">, VariantProps<typeof chipVariants> {
+interface DismissibleChipProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "onClick" | "children">, VariantProps<typeof chipVariants$1> {
     label: React$1.ReactNode;
     onDismiss: () => void;
 }
@@ -1009,6 +1785,22 @@ interface DonutChartProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "ch
 }
 declare const DonutChart: React$1.ForwardRefExoticComponent<DonutChartProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/**
+ * L1a behaviour primitive (private). Not exported from the package.
+ *
+ * The `width` of a menu content surface (W5-13; target architecture §14
+ * "Menus: `width: auto | trigger | sm | md`" — 62% of consumer
+ * `DropdownMenuContent` uses override the width by class today). `auto` is
+ * the default and adds nothing, so every existing menu keeps its class string
+ * byte for byte; the other values are opt-in. `trigger` reads the Popper
+ * variable Radix stamps on the content, so the menu is as wide as the element
+ * that opened it.
+ *
+ * Full literals, one per row, so Tailwind's scanner sees them.
+ */
+/** How wide a menu content surface is. */
+type MenuWidth = "auto" | "trigger" | "sm" | "md";
+
 declare const DropdownMenu: React$1.FC<DropdownMenuPrimitive.DropdownMenuProps>;
 declare const DropdownMenuTrigger: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const DropdownMenuGroup: React$1.ForwardRefExoticComponent<DropdownMenuPrimitive.DropdownMenuGroupProps & React$1.RefAttributes<HTMLDivElement>>;
@@ -1019,13 +1811,32 @@ declare const DropdownMenuSubTrigger: React$1.ForwardRefExoticComponent<Omit<Dro
     inset?: boolean;
 } & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuSubContent: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSubContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const DropdownMenuContent: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+interface DropdownMenuContentProps extends React$1.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content> {
+    /**
+     * The width of the menu surface. `auto` (default) sizes to the items with
+     * the 10rem minimum; `trigger` matches the element that opened the menu;
+     * `sm` and `md` are fixed widths (12rem, 16rem). Replaces the `w-*` class
+     * overrides most consumers write today.
+     * @default "auto"
+     */
+    width?: MenuWidth;
+}
+declare const DropdownMenuContent: React$1.ForwardRefExoticComponent<DropdownMenuContentProps & React$1.RefAttributes<HTMLDivElement>>;
 interface DropdownMenuItemProps extends React$1.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> {
-    /** Render as a destructive (danger) action. */
+    /**
+     * Render as a destructive (danger) action — the `intent="danger"` look of
+     * the shared Menu recipe (`menu.item.destructive.*` tokens).
+     */
     destructive?: boolean;
     /** Increase left padding to align with checkbox/radio items. */
     inset?: boolean;
 }
+/**
+ * A menu item. Activation fires both `onSelect` (canonical; call
+ * `event.preventDefault()` on it to keep the menu open) and `onClick`
+ * (tolerated): Radix composes `onClick` with its select handler and a
+ * keyboard activation clicks the element.
+ */
 declare const DropdownMenuItem: React$1.ForwardRefExoticComponent<DropdownMenuItemProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuCheckboxItem: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuCheckboxItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuRadioItem: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuRadioItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -1116,21 +1927,87 @@ interface FileTypeBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>,
 }
 declare const FileTypeBadge: React$1.ForwardRefExoticComponent<FileTypeBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
+/**
+ * The looks of the dropzone: `default` stacks the icon and the copy in a
+ * padded tile; `compact` lays them out in one row for dialogs and dense
+ * forms.
+ *
+ * @experimental
+ */
+type FileUploadVariant = "default" | "compact";
+
+/**
+ * Props of `FileUpload`.
+ *
+ * @experimental The W4-24 additions (`name`, `form`, `required`, `classNames`,
+ * `variant`, `inputRef`) are experimental; the legacy props keep their contract.
+ */
 interface FileUploadProps extends React.HTMLAttributes<HTMLDivElement> {
     accept?: string;
     maxSize?: number;
     multiple?: boolean;
     onFilesSelected?: (files: File[]) => void;
     disabled?: boolean;
+    /**
+     * The form field name. With it the owned `<input type="file">` submits the
+     * selected or dropped files; a surrounding `Field` can supply it.
+     */
+    name?: string;
+    /** `id` of the form to submit with when the dropzone is rendered outside it. */
+    form?: string;
+    /** Block native submission while no file is selected. */
+    required?: boolean;
+    /** `default` (stacked tile) or `compact` (one row). */
+    variant?: FileUploadVariant;
+    /**
+     * One class per part, keyed by `FileUploadSlot` (ADR-008). `className`
+     * keeps landing on the root; `dropzone` is the `<label>` that
+     * `[&_label]` selectors reach for today (C-DOM-04), `input` the file
+     * input, `error` the message.
+     */
+    classNames?: Partial<Record<Exclude<FileUploadSlot, "root">, string>>;
+    /** A ref to the owned file input. */
+    inputRef?: React.Ref<HTMLInputElement>;
+    /** Overrides for the default dropzone copy (W5-20). @experimental */
+    messages?: Partial<FileUploadMessages>;
 }
-declare function FileUpload({ accept, maxSize, multiple, onFilesSelected, disabled, className, children, ...props }: FileUploadProps): react_jsx_runtime.JSX.Element;
+declare function FileUpload({ accept, maxSize, multiple, onFilesSelected, disabled, name, form, required, variant, classNames, inputRef: inputRefProp, messages: messagesProp, className, children, ...props }: FileUploadProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * `FormError` / `FormSuccess` — the pre-Field inline messages (contract
+ * C-FORM-MSG, replaced by the Field parts in W4-25, removed in 3.0).
+ *
+ * They are deliberately **not** thin adapters over `FieldError` and
+ * `FieldDescription`: the Field parts stamp `data-slot="field-error"` /
+ * `data-slot="field-description"`, always render a part `id` (a `useId`
+ * fallback outside a `Field`), and `FieldError` renders nothing without
+ * content and chooses its `role` from the mount timing — none of which
+ * today's `<p role="alert"><svg/><span>…</span></p>` has. Rendering through
+ * the parts would therefore change the DOM every consumer freezes (C-DOM
+ * snapshots) for no visible gain, so the markup below stays byte for byte
+ * until 3.0 and the replacement is a call-site migration:
+ *
+ * ```tsx
+ * <Field invalid={!!error}>
+ *   <Label>Email</Label>
+ *   <Input />
+ *   <FieldError>{error}</FieldError>
+ * </Field>
+ * ```
+ *
+ * `FormSuccess` has no Field counterpart by design: a confirmation is a
+ * `FieldDescription` (or a toast), not a field state.
+ */
 interface FormErrorProps extends React.HTMLAttributes<HTMLParagraphElement> {
     children: React.ReactNode;
 }
 /**
  * Inline form error — paired below an input to communicate validation failure.
  * Uses architectural --color-danger-fg token.
+ *
+ * @deprecated Use `FieldError` inside a `Field` (W4-25, C-FORM-MSG): it wires
+ * `aria-describedby` and `aria-invalid` on the control and announces itself
+ * only after an interaction. Removed in 3.0.
  */
 declare function FormError({ children, className, ...props }: FormErrorProps): react_jsx_runtime.JSX.Element;
 interface FormSuccessProps extends React.HTMLAttributes<HTMLParagraphElement> {
@@ -1139,6 +2016,10 @@ interface FormSuccessProps extends React.HTMLAttributes<HTMLParagraphElement> {
 /**
  * Inline form success — paired below an input to confirm a saved value.
  * Uses architectural --color-success-fg token.
+ *
+ * @deprecated Use `FieldDescription` inside a `Field` for a per-field
+ * confirmation, or a toast for a saved form (W4-25, C-FORM-MSG). Removed in
+ * 3.0.
  */
 declare function FormSuccess({ children, className, ...props }: FormSuccessProps): react_jsx_runtime.JSX.Element;
 
@@ -1157,6 +2038,21 @@ declare function FormSuccess({ children, className, ...props }: FormSuccessProps
  * For marketing-style centered section heads, prefer `<SectionHeader>`.
  * For lower-level title+description blocks that aren't part of a form,
  * use `<SectionHead>` from `./section`.
+ *
+ * Contract C-FORM-MSG (W4-25): replaced by `Fieldset` + `FieldsetLegend`,
+ * removed in 3.0. It is deliberately **not** an adapter over them: `Fieldset`
+ * stamps `data-slot="fieldset"` and lays its children out as a
+ * `flex-col gap-3` column, `FieldsetLegend` adds `mb-1.5` — both would move
+ * the heading row and the fields this component renders today. The markup
+ * below therefore stays byte for byte until 3.0; the replacement is a
+ * call-site migration:
+ *
+ * ```tsx
+ * <Fieldset>
+ *   <FieldsetLegend>Contact</FieldsetLegend>
+ *   <Field>…</Field>
+ * </Fieldset>
+ * ```
  */
 interface FormSectionProps extends Omit<React.FieldsetHTMLAttributes<HTMLFieldSetElement>, "title"> {
     /** The section heading (renders as `<legend>` text). */
@@ -1168,6 +2064,14 @@ interface FormSectionProps extends Omit<React.FieldsetHTMLAttributes<HTMLFieldSe
     /** Space between the heading block and the fields. Default `mt-4`. */
     headSpacing?: string;
 }
+/**
+ * A grouped block of a settings/profile form: `<fieldset>` + `<legend>` with
+ * an optional description and trailing action.
+ *
+ * @deprecated Use `Fieldset` with `FieldsetLegend` (W4-25, C-FORM-MSG); put
+ * a description in a `Text` and each control in its own `Field`. Removed in
+ * 3.0.
+ */
 declare const FormSection: React$1.ForwardRefExoticComponent<FormSectionProps & React$1.RefAttributes<HTMLFieldSetElement>>;
 
 declare const HoverCard: React$1.FC<HoverCardPrimitive.HoverCardProps>;
@@ -1176,21 +2080,67 @@ declare const HoverCardPortal: React$1.FC<HoverCardPrimitive.HoverCardPortalProp
 declare const HoverCardContent: React$1.ForwardRefExoticComponent<Omit<HoverCardPrimitive.HoverCardContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
- * IconTile — the recurring tinted rounded-square icon chip. A tone tint fills
- * the square and colors the icon; `grid place-items-center` keeps the glyph
- * centered. Consolidates v2's `.v2-qico` / `.v2-item-ico` / `.nr-ico` /
+ * IconTile — the recurring tinted rounded-square icon chip. An intent tint
+ * fills the square and colors the icon; `grid place-items-center` keeps the
+ * glyph centered. Consolidates v2's `.v2-qico` / `.v2-item-ico` / `.nr-ico` /
  * `.licon` / `.aico` icon-chip pattern into one primitive.
  *
- *   tone — `pro` (default), `neutral`, status (`info` | `success` | `warning`
- *          | `danger`), and suite tints (`audit` | `books` | `tax`).
- *   size — `sm` (~30px) | `md` (~38px) | `lg` (~42px). Icon scales with it.
+ *   intent — `brand` (default), `neutral`, status (`info` | `success` |
+ *            `warning` | `danger`) — the ADR-007 vocabulary. `tone` is the
+ *            deprecated spelling (`pro` → `brand`); the suite tints
+ *            (`audit` | `books` | `tax`) are only reachable through `tone`
+ *            because product names are never intents (ADR-007 §2).
+ *   size — `sm` (30px) | `md` (38px, default) | `lg` (42px) | `xl` (48px).
+ *          Each step sets `--ds-icon-size` on the tile from the W2-10 icon
+ *          scale (`--icon-size-md` / 18px / `--icon-size-lg`, the legacy
+ *          spellings of `--ds-icon-size-*`) and the icon reads it, so a
+ *          consumer that needs another glyph size sets the variable instead
+ *          of selecting the descendant `svg` (C-DOM-05).
  *   badge — optional ReactNode pinned to the top-right corner (e.g. a count).
  */
+/** Every intent of the shared vocabulary is an IconTile tint. */
+type IconTileIntent = Intent;
+/** Legacy `tone` → `intent` (ADR-007 §4) for the values that have one. */
+declare const ICON_TILE_TONE_TO_INTENT: {
+    readonly pro: "brand";
+    readonly neutral: "neutral";
+    readonly info: "info";
+    readonly success: "success";
+    readonly warning: "warning";
+    readonly danger: "danger";
+};
+/**
+ * The pre-W3-21 colour words (compat registry C-TONE).
+ *
+ * @deprecated Use `intent` — `tone="pro"` is `intent="brand"`, the status
+ * values keep their name. The suite tints (`audit`, `books`, `tax`) have no
+ * intent and stay on `tone` until the products own a service → colour
+ * mapping (target architecture §40). Removed in 3.0; CM-06 rewrites the
+ * mappable call sites and lists the rest.
+ */
+type IconTileTone = keyof typeof ICON_TILE_TONE_TO_INTENT | IconTileSuiteTone;
+type IconTileSize = "sm" | "md" | "lg" | "xl";
 declare const iconTileVariants: (props?: ({
-    tone?: "neutral" | "info" | "success" | "warning" | "danger" | "audit" | "books" | "tax" | "pro" | null | undefined;
-    size?: "sm" | "md" | "lg" | null | undefined;
+    intent?: "brand" | "neutral" | "info" | "success" | "warning" | "danger" | null | undefined;
+    suite?: "audit" | "books" | "tax" | null | undefined;
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof iconTileVariants> {
+/** Suite tints: product hues that stay on the deprecated `tone` axis. */
+type IconTileSuiteTone = NonNullable<VariantProps<typeof iconTileVariants>["suite"]>;
+interface IconTileVariantProps {
+    /** Semantic tint (ADR-007). Default `brand`. Wins over `tone`. */
+    intent?: IconTileIntent | null;
+    /**
+     * @deprecated Use `intent`. `pro` → `brand`; status values keep their name;
+     * `audit` / `books` / `tax` stay here (no intent).
+     */
+    tone?: IconTileTone | null;
+    size?: IconTileSize | null;
+}
+/** The IconTile class string. Accepts `intent` or the deprecated `tone`. */
+declare function resolveIconTileVariants({ intent, tone, size }?: IconTileVariantProps): string;
+
+interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, IconTileVariantProps {
     /** The icon (or any node) rendered centered inside the tile. */
     icon: React.ReactNode;
     /** Optional overlay pinned to the top-right corner, e.g. a count badge. */
@@ -1199,360 +2149,86 @@ interface IconTileProps extends React.HTMLAttributes<HTMLDivElement>, VariantPro
 declare const IconTile: React$1.ForwardRefExoticComponent<IconTileProps & React$1.RefAttributes<HTMLDivElement>>;
 
 /**
- * Shared component vocabulary (W3-01, ADR-007, target architecture §28).
+ * 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.
  *
- * Every component that offers one of these axes must use *this* type for it,
- * never a private union with the same words. Components that support only a
- * subset narrow with `Extract<…>`; nothing may widen a list. The lists are
- * closed: adding a word is an ADR-007 amendment, not a component change.
- *
- * Types only — this module has no runtime and adds nothing to `dist/index.js`.
- * All four names are `@experimental` until decision D4 (`danger` vs
- * `destructive`) is resolved and the Wave 3 components that adopt them are
- * marked stable (ADR-007 acceptance condition).
+ * @experimental
  */
-
+type InputVariant = "default" | "ghost";
 /**
- * Semantic meaning → colour family.
- *
- * `intent` says *what the element means*; `variant` says how loudly. A
- * `danger` action, a `danger` badge and a `danger` alert share one colour
- * family (`--ds-color-danger-*`) at three different emphases.
- *
- * `danger` is the canonical word (decision D4, default); `destructive` is
- * accepted by components as a deprecated alias for the 2.x line and is *not*
- * a member of this type.
+ * 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 Intent = "neutral" | "brand" | "info" | "success" | "warning" | "danger";
+type InputSizeAlias = "compact" | "default" | "comfortable";
 /**
- * Visual emphasis — how strongly the element asserts itself, independent of
- * what it means. Actions, badges, alerts and chips each pick the subset that
- * applies (`Extract<Variant, "solid" | "soft" | "outline">` for Badge).
- *
- * - `solid` — filled with the intent colour, contrasting foreground
- * - `soft` — tinted background, intent-coloured foreground
- * - `outline` — border only, transparent background
- * - `ghost` — no border or background until hovered
- * - `link` — inline text, underlined on hover; actions only
+ * 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.
  *
- * State (`disabled`, `loading`, `pressed`, `selected`, …) is never a variant:
- * it is a boolean prop reflected as a `data-*` or ARIA attribute.
+ * `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 Variant = "solid" | "soft" | "outline" | "ghost" | "link";
+type InputSize = ControlSize | InputSizeAlias;
 /**
- * The shared control size step (ADR-013, W2-03): one name means one outer
- * height on every control that offers it, read from
- * `--ds-control-height-{size}`. Derived from the token scale so the type and
- * the tokens cannot disagree; it resolves to `"xs" | "sm" | "md" | "lg" | "xl"`.
- *
- * The pixels behind each step are decision D5; existing components keep
- * today's geometry under these names until 2.0 (compat token per control).
+ * What {@link inputVariants} takes: the emphasis, the size (either name — the
+ * new `size` wins when both are given) and cva's class props.
  *
  * @experimental
  */
-type ControlSize = keyof SystemTokens["control"]["height"];
+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">;
 /**
- * Corner treatment, offered only where it is a real choice (W2-07 radius roles,
- * target architecture §18, §28).
- *
- * - `rounded` — the component's radius role (`--ds-radius-control`,
- *   `--ds-radius-badge`, …)
- * - `pill` — `--ds-radius-full`
- * - `square` — no rounding beyond the smallest reference step; icon tiles only
+ * 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}).
  *
- * A component's *default* shape is whatever it renders today; changing a
- * default is decision D1 and waits for 2.0.
+ * 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
  */
-type Shape = "rounded" | "pill" | "square";
-
-/**
- * Named icon boxes — the four `--ds-icon-size-*` steps of W2-10 (12 / 14 / 16 /
- * 20 px), spelled with the shared size vocabulary (ADR-007) and derived from the
- * token scale so the type and the tokens cannot disagree.
- */
-type IconSize = Extract<ControlSize, keyof typeof iconSizes>;
-interface IconProps extends React.SVGAttributes<SVGElement> {
-    /**
-     * The icon box. A size name renders `var(--ds-icon-size-<name>)` — with the
-     * legacy `--icon-size-<name>` and then the token's pixel value as fallbacks —
-     * so a theme can retune the boxes; a number is a pixel box, as before.
-     * Defaults to 24, the grid the glyphs are drawn on.
-     */
-    size?: IconSize | number;
-    /**
-     * Stroke width of every stroked element, set once on the root `<svg>` and
-     * inherited. Defaults to 1.5, the catalogue's baseline; the few glyphs drawn
-     * heavier (`XIcon`, `CheckIcon`, `BoldIcon`) default to their own weight.
-     */
-    strokeWidth?: number | string;
-    /**
-     * Accessible name. Icons are decorative (`aria-hidden`); a `title` exposes
-     * the svg as `role="img"` with a `<title>` child. (An `aria-label` alone
-     * still lands on the hidden svg, as it always has — C-DOM-15 freezes that
-     * DOM for Pro; use `title` to name an icon.)
-     */
-    title?: string;
-}
-/** What every catalogue icon and every `createIcon()` product is. */
-interface IconComponent {
-    (props: IconProps): React.JSX.Element;
-    displayName?: string;
-}
-interface IconDefinition {
-    /** Component name, e.g. `"ArchiveIcon"`; becomes the `displayName`. */
-    name: string;
-    /**
-     * What to draw. Path data strings become `currentColor` strokes with round
-     * caps and joins, the catalogue's outline style; pass elements for anything
-     * else (filled dots, rects, a mark's fixed colours). Elements must not set
-     * their own `strokeWidth` — it lives on the root so the prop works.
-     */
-    paths: string | readonly string[] | React.ReactNode;
-    /** Defaults to `"0 0 24 24"`. A product icon drawn on another grid sets its own. */
-    viewBox?: string;
-    /** This glyph's default stroke width when the caller passes none. Defaults to 1.5. */
-    strokeWidth?: number | string;
-}
+declare function inputVariants({ variant, size, inputSize, class: classProp, className, }?: InputVariantsOptions): string;
 /**
- * Builds an icon component with the catalogue's props, sizing, stroke and
- * accessibility contract from path data or SVG elements. Products use it for
- * icons that are theirs (vendor logos, annotation shapes) without inlining
- * `<svg>` at call sites; the catalogue uses it for its newer glyphs.
+ * Props of `Input` (W4-05; target architecture §24.3, §29.1).
  *
- * @example
- * const ArchiveIcon = createIcon({
- *   name: "ArchiveIcon",
- *   paths: ["M3 3h18a1 1 0 011 1v3a1 1 0 01-1 1H3a1 1 0 01-1-1V4a1 1 0 011-1z", "M4 8v11a2 2 0 002 2h12a2 2 0 002-2V8", "M10 12h4"],
- * });
+ * @experimental The name is exported since W4-05; the props it lists have been
+ * stable since 1.x.
  */
-declare function createIcon(definition: IconDefinition): IconComponent;
-declare function DocumentIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ArrowRightIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function StarIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SparkleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * ExtractIcon — gradient (Pro purple → cyan) tri-sparkle used for AI
- * "Extract" affordances. Unlike the currentColor catalog, the fill is a
- * fixed brand gradient; `size` scales it while preserving the 16:12 ratio.
- * Gradient/clip ids are per-instance (useId) so multiple icons don't clash.
- */
-declare function ExtractIcon({ size, className, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ChatBubbleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LightningIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function UsersIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FileTextIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ShieldIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MenuIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * @deprecated Use `XIcon` — the same glyph under its lucide name (the catalogue
- * drew it twice). This alias is the identical component and stays through 2.x.
- */
-declare const CloseIcon: typeof XIcon;
-declare function CheckIcon({ size, strokeWidth, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LayoutDashboardIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function BuildingIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/** Landmark / "bank" glyph (columns + pediment) — the accounting service mark. */
-declare function LandmarkIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/** Folder with an up-arrow — the "upload documents" / document-request mark. */
-declare function FolderUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/** Pen-tool / nibbed signature pen — the e-signature mark. */
-declare function PenToolIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MapPinIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FileReturnIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ClipboardCheckIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FolderOpenIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ReceiptIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CalendarIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function BarChartIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SettingsIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PanelLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PanelLeftCloseIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SunIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function TeamIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MoonIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PaletteIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MailIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function GlobeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function BellIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function WorkflowIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LinkIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function KeyIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SearchIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LogOutIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function TagIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SendIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function TrashIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function Link2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ChevronUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ChevronDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PlusIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function UserCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PencilIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PhoneIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FolderClosedIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function UploadIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function DownloadIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MoreHorizontalIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ChevronRightIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ChevronLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FileIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function RotateCcwIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function EyeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ClockIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LayoutListIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LayoutGridIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LockIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FolderPlusIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MoveIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LockKeyholeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PaperclipIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function AtSignIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ZoomInIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ZoomOutIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function XIcon({ size, strokeWidth, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MessageCircleWarningIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function FlagIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function LockOpenIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MessageCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PenSignIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CopyIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MonitorIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SmartphoneIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function AlertTriangleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * @deprecated Use `ArrowRightIcon` — it is the same path; "small" was never a
- * different drawing. This alias is the identical component and stays through 2.x.
- */
-declare const ArrowRightSmallIcon: typeof ArrowRightIcon;
-declare function ArrowLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CreditCardIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function AlertCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ArrowDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ArrowUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function BriefcaseIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function Building2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CheckCircle2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ChevronsUpDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CircleDotIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CommandIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CornerDownLeftIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function EyeOffIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function HomeIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function InboxIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ListChecksIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function MinusIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SlashIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SparklesIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function Trash2Icon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function UserIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function BoldIcon({ size, strokeWidth, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ItalicIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function UnderlineIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function StrikethroughIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ListIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ListOrderedIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function InfoIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function HelpCircleIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function DollarSignIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function ReplyIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function KanbanIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function TableIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function HistoryIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function SaveIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * LoaderIcon — animated spinner. Render with `className="animate-spin"`
- * (or `motion-safe:animate-spin` if you want to respect `prefers-reduced-
- * motion`; the catalog doesn't gate this itself because the spinner IS
- * the indicator for many flows).
- *
- * Visual contract: a dim full-circle ring + a brighter quarter-arc on top.
- * When rotated, the bright arc creates the "leading edge" of the spinner.
- */
-declare function LoaderIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * GoogleBrandIcon — Google four-color "G" mark. Brand-locked colors,
- * does NOT respond to currentColor. Use only in provider-list UIs
- * (OAuth buttons, integration chips). Standard 24-grid.
- */
-declare function GoogleBrandIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * MicrosoftBrandIcon — Microsoft four-square mark in red / green / blue /
- * yellow. Brand-locked colors, does NOT respond to currentColor. Use
- * inside Microsoft OAuth signin buttons, Outlook / Office integration
- * chips, and similar provider-list UIs. Standard 24-grid (10×10 squares
- * with 2u gaps).
- */
-declare function MicrosoftBrandIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/**
- * FilterIcon — funnel mark used for filter popover triggers across list
- * pages (clients, workflow, billing, organizers…). Renders the same
- * lucide-style polygon at any size; pair with a corner notification dot
- * to surface active filter count.
- */
-declare function FilterIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function CheckCircleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function XCircleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function AlertTriangleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function InfoCircleSolidIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function TrendingUpIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function TrendingDownIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PlayIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function PauseIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-declare function StopIcon({ size, ...props }: IconProps): react_jsx_runtime.JSX.Element;
-/** Six-dot drag handle for sortable rows and kanban cards. */
-declare const GripVerticalIcon: IconComponent;
-/** Enter full screen / expand a panel — four outward corners. */
-declare const MaximizeIcon: IconComponent;
-/** Leave full screen / shrink a panel — four inward corners. */
-declare const MinimizeIcon: IconComponent;
-declare const ArchiveIcon: IconComponent;
-declare const ThumbsUpIcon: IconComponent;
-declare const ThumbsDownIcon: IconComponent;
-declare const LayersIcon: IconComponent;
-/** Formula / sum — the Greek capital sigma. */
-declare const SigmaIcon: IconComponent;
-/** Video camera; pair with `PlayIcon` for playback. */
-declare const VideoIcon: IconComponent;
-declare const MicIcon: IconComponent;
-/** Speaker with two sound waves — audio on. */
-declare const Volume2Icon: IconComponent;
-/** Speaker with a cross — muted. */
-declare const VolumeXIcon: IconComponent;
-/** Two clockwise arrows — refresh / sync. `RotateCcwIcon` is the single-arrow undo. */
-declare const RefreshCwIcon: IconComponent;
-/** Stopwatch — elapsed time and timers; `ClockIcon` is wall-clock time. */
-declare const TimerIcon: IconComponent;
-declare const BrainIcon: IconComponent;
-/** Pop-out / opens elsewhere — box with an arrow leaving the top-right corner. */
-declare const ExternalLinkIcon: IconComponent;
-/** Dock to the right — the mirror of `PanelLeftIcon`. */
-declare const PanelRightIcon: IconComponent;
-/** Collapse — the pair of `ChevronsUpDownIcon`. */
-declare const ChevronsDownUpIcon: IconComponent;
-/**
- * Filled trash can for destructive affordances inside small round buttons,
- * where the outline `TrashIcon` reads as thin. Same family as the solid status
- * icons: the slots are knockouts.
- */
-declare const TrashSolidIcon: IconComponent;
-
-/**
- * Input variants. Mirrors the raw HTML `<input>` styled per the suite tokens
- * (rule-strong border, surface bg, accent focus ring).
- */
-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
@@ -1564,10 +2240,50 @@ interface InputProps$1 extends Omit<React.InputHTMLAttributes<HTMLInputElement>,
      * ("e.g. 555-0100") can still sit behind the label without competing with it.
      */
     floatingLabel?: boolean;
+    /**
+     * Sugar for the hint text under the control, referenced first in the
+     * control's `aria-describedby` (before `error`).
+     */
+    description?: string;
+    /**
+     * Sugar for the error message: renders it under the control, linked through
+     * `aria-describedby`, and marks the control invalid.
+     */
     error?: string;
-    prefixIcon?: React.ReactNode;
-    suffixIcon?: React.ReactNode;
+    /**
+     * The value is invalid without a message to show: `aria-invalid`,
+     * `data-invalid` and the chrome's invalid treatment. Implied by `error`.
+     */
+    invalid?: boolean;
+    prefixIcon?: ReactNode;
+    suffixIcon?: ReactNode;
+    /**
+     * Called with the new string value on every change, next to `onChange`
+     * (which keeps receiving the event).
+     */
+    onValueChange?: (value: string) => void;
+    /**
+     * Classes per anatomy part (the `input-*` slots). The `<input>` is
+     * the root part and takes `className` (C-INPUT-CLASSNAME), so it has no
+     * entry here.
+     */
+    classNames?: Partial<Record<Exclude<InputSlot, "root">, string>>;
+    /**
+     * Classes for the outer wrapper around the control and its parts.
+     * Transitional (C-INPUT-CLASSNAME): `className` keeps landing on the
+     * `<input>` because 192 consumer overrides depend on it; this is the name
+     * for the wrapper until `className` moves there in 3.0.
+     */
+    rootClassName?: string;
 }
+/**
+ * A single-line text field (target architecture §24, §29). The control is a
+ * native `<input>` and takes part in a form on its own. Inside a `Field` it
+ * binds itself through `useFieldControl` — id, name, `aria-describedby`,
+ * invalid / required / disabled come from the field; explicit props win. The
+ * `label` / `description` / `error` sugar renders the same wiring around the
+ * control for the call sites that never adopt the compound form.
+ */
 declare const Input: React$1.ForwardRefExoticComponent<InputProps$1 & React$1.RefAttributes<HTMLInputElement>>;
 
 interface KeyboardShortcut {
@@ -1600,18 +2316,42 @@ declare const labelVariants: (props?: class_variance_authority_types.ClassProp |
 interface LabelProps extends React$1.ComponentPropsWithoutRef<typeof LabelPrimitive.Root>, VariantProps<typeof labelVariants> {
     required?: boolean;
 }
+/**
+ * The label of a form control. On its own, a `<label>` that names the
+ * control `htmlFor` points to. Inside a `Field` (W4-01, target architecture
+ * §24) it binds itself: `htmlFor` is the field's control id, `id` is the id a
+ * non-native control references through `aria-labelledby`, `required` and
+ * `optional` come from the field, and a click focuses a control that
+ * `htmlFor` cannot reach (a `div` editor). Explicit props win.
+ */
 declare const Label: React$1.ForwardRefExoticComponent<LabelProps & React$1.RefAttributes<HTMLLabelElement>>;
 
-interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href">, ButtonIconProps {
     href: string;
+    /** Visual emphasis; the legacy words are deprecated aliases (see `Button`). */
     variant?: ButtonVariant;
+    /**
+     * Meaning → colour family: `brand` · `neutral` · `success` · `danger`.
+     * Defaults per variant so an omitted prop renders what it always did.
+     *
+     * @experimental
+     */
+    intent?: ButtonIntent | ButtonIntentAlias;
+    /**
+     * The shared control scale (see `Button`). The icon-only squares and the
+     * `compact` / `default` / `comfortable` aliases are deprecated.
+     */
     size?: ButtonSize;
-    iconLeft?: React.ReactNode;
-    iconRight?: React.ReactNode;
+    /**
+     * Stretch to the container's width (`w-full`).
+     *
+     * @experimental
+     */
+    fullWidth?: boolean;
     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)
@@ -1621,12 +2361,26 @@ interface LinkButtonProps$1 extends Omit<React.AnchorHTMLAttributes<HTMLAnchorEl
      * `rel="noopener noreferrer"` is applied automatically.
      */
     external?: boolean;
+    /**
+     * A disabled link (W3-08). A link has no native `disabled`, so this renders
+     * `aria-disabled="true"`, `tabIndex={-1}`, `data-disabled`, the disabled
+     * colours and `pointer-events: none`, and swallows the click and Enter /
+     * Space so nothing navigates and `onClick` is not called. `href` stays on
+     * the element: it is still a link, announced as disabled.
+     *
+     * @experimental
+     */
+    disabled?: boolean;
 }
 /**
  * LinkButton — visually identical to `<Button>` but renders a link.
- * Shares `buttonVariants` so styling stays in lock-step.
+ * 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.
@@ -1673,6 +2427,11 @@ declare const LoadingRows: React$1.ForwardRefExoticComponent<LoadingRowsProps &
  *   - `productName` (the suffix text; `null` renders just "Assure")
  *   - `className`, `iconClassName`, `textClassName` (style overrides)
  *
+ * The link and the wordmark image are the provider's `linkComponent` /
+ * `imageComponent` when a `DesignSystemProvider` supplies them (W5-21,
+ * ADR-010), else `next/link` / `next/image`; the static imports stay until 2.0
+ * (C-NEXT-PEER), so a Next.js app without a provider is unchanged.
+ *
  * By default the lockup is a link (`href="/"`). Pass `href={null}` to render a
  * non-interactive `<span>` wrapper instead — required when embedding the lockup
  * inside another interactive element (a menu trigger `<button>`, a
@@ -1799,27 +2558,99 @@ declare namespace MultiSelectField {
     var displayName: string;
 }
 
+/**
+ * Props of `NumberInput`. Everything a text `<input>` takes except the
+ * value-shaped attributes the component owns (`value`, `defaultValue`,
+ * `onChange`, `type`, `min`, `max`, `step`, `size`).
+ *
+ * @experimental
+ */
+interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "type" | "min" | "max" | "step" | "size"> {
+    /** The controlled value; `null` is an empty field. */
+    value?: number | null;
+    /** The initial value while uncontrolled. */
+    defaultValue?: number | null;
+    /** Called with the new value on every change; `null` when the field is emptied. */
+    onValueChange?: (value: number | null) => void;
+    /**
+     * The BCP 47 locale the value is formatted and parsed in: this prop, else
+     * `DesignSystemProvider locale`, else `"en-US"` on the server and the client
+     * alike (A3) — never `navigator.language`.
+     */
+    locale?: string;
+    /** `Intl.NumberFormat` options: fraction digits, `style: "currency"`, `style: "percent"`, … */
+    formatOptions?: Intl.NumberFormatOptions;
+    /** The lowest committed value; ArrowDown and Home stop here. */
+    min?: number;
+    /** The highest committed value; ArrowUp and End stop here. */
+    max?: number;
+    /** The increment of the arrow keys. Default `1`. */
+    step?: number;
+    /** The control scale (`--control-*-<size>`). Default `md`. */
+    size?: ControlSize;
+    /**
+     * `default` draws the field border; `ghost` draws none until focused. The
+     * words are `ControlChromeVariant` (`behavior/control-chrome.ts`), spelled
+     * out so the public declaration names no unexported type.
+     */
+    variant?: "default" | "ghost";
+    /** Marks the control invalid (`aria-invalid`, danger chrome); a surrounding `Field` can set it too. */
+    invalid?: boolean;
+    /** One class per part, keyed by `NumberInputSlot`. `root` is the `<input>`, the element `className` lands on too. */
+    classNames?: Partial<Record<NumberInputSlot, string>>;
+}
+/**
+ * The design-system number field: a locale-formatted `number | null` that
+ * submits its canonical value and reads as a spinbutton.
+ *
+ * @experimental
+ */
+declare const NumberInput: React$1.ForwardRefExoticComponent<NumberInputProps & React$1.RefAttributes<HTMLInputElement>>;
+
+/**
+ * Props of `OTPInput`.
+ *
+ * @experimental The Field / form additions of W4-23 (`onValueChange`,
+ * `required`, `form`, `invalid`, an optional `name`) are experimental; the
+ * legacy props keep their contract.
+ */
 interface OTPInputProps {
-    name: string;
+    /** The form field name. Optional since W4-23: a surrounding `Field` can supply it. */
+    name?: string;
     length?: number;
     error?: string;
+    /**
+     * Move focus into the code on mount. Opt-in: only for a screen whose one
+     * purpose is the code (step-up auth, post-redirect verification), never in
+     * a form with other fields. Documented in the `AutoFocus` story.
+     */
     autoFocus?: boolean;
     className?: string;
     defaultValue?: string;
     /** Optional controlled value (additive). */
     value?: string;
-    /** Optional controlled onChange (additive). */
+    /** Optional controlled onChange (additive). Fires with the same string as `onValueChange`. */
     onChange?: (value: string) => void;
+    /** Called with the new code on every change (ADR-006 spelling). */
+    onValueChange?: (value: string) => void;
     /** Optional callback fired when all slots are filled (additive). */
     onComplete?: (value: string) => void;
     /** Optional id for the underlying input (additive). */
     id?: string;
     /** Optional disabled flag (additive). */
     disabled?: boolean;
-    /** Accessible label for the underlying one-time-code input. */
+    /** Block native submission while the code is empty. */
+    required?: boolean;
+    /** `id` of the form to submit with when the input is rendered outside it. */
+    form?: string;
+    /** Marks the input invalid without a message of its own; `error` and a `Field` can set it too. */
+    invalid?: boolean;
+    /** Accessible label for the underlying one-time-code input. A `Field` label takes precedence. */
     "aria-label"?: string;
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
 }
-declare function OTPInput({ name, length, error, autoFocus, className, defaultValue, value, onChange, onComplete, id, disabled, "aria-label": ariaLabel, }: OTPInputProps): react_jsx_runtime.JSX.Element;
+declare function OTPInput({ name, length, error, autoFocus, className, defaultValue, value: valueProp, onChange, onValueChange, onComplete, id, disabled, required, form, invalid, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, }: OTPInputProps): react_jsx_runtime.JSX.Element;
 declare namespace OTPInput {
     var displayName: string;
 }
@@ -1897,14 +2728,6 @@ interface PdfPreviewProps extends React.HTMLAttributes<HTMLDivElement>, VariantP
 }
 declare const PdfPreview: React$1.ForwardRefExoticComponent<PdfPreviewProps & React$1.RefAttributes<HTMLDivElement>>;
 
-type InputProps = React.ComponentProps<typeof Input>;
-interface PhoneInputProps extends Omit<InputProps, "type" | "onChange" | "value" | "defaultValue"> {
-    value?: string;
-    defaultValue?: string;
-    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
-}
-declare const PhoneInput: React$1.ForwardRefExoticComponent<Omit<PhoneInputProps, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
-
 interface CountryCode {
     iso: string;
     name: string;
@@ -1926,14 +2749,108 @@ declare function parsePhoneForEditing(phone: string): {
     localPhone: string;
 };
 
+/**
+ * Every string the phone field renders, so a consumer can localise it until
+ * the messages contract of the provider lands (W5-20, ADR-010).
+ * Deterministic English defaults (A3).
+ *
+ * @experimental
+ */
+interface PhoneFieldMessages {
+    /** The accessible name of the country combobox. */
+    country: string;
+    /** The placeholder of the country combobox while its list is open. */
+    searchCountries: string;
+    /** The empty state when the query matches no country. */
+    noCountries: string;
+}
+declare const DEFAULT_PHONE_FIELD_MESSAGES: PhoneFieldMessages;
+/** What `onValueChange` is told besides the E.164 value. @experimental */
+interface PhoneFieldChangeDetails {
+    /** The ISO 3166-1 alpha-2 code of the picked country. */
+    country: string;
+    /** The national digits as typed, without the dial code. */
+    nationalNumber: string;
+}
+/**
+ * Props of `PhoneField`. Everything a `tel` `<input>` takes except the
+ * value-shaped attributes the component owns.
+ *
+ * @experimental
+ */
+interface PhoneFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange" | "type" | "size"> {
+    /** The controlled E.164 value; `null` (or `""`) is an empty field. */
+    value?: string | null;
+    /** The initial E.164 value while uncontrolled. */
+    defaultValue?: string | null;
+    /** Called with the E.164 value on every change; `null` when the number is emptied. */
+    onValueChange?: (value: string | null, details: PhoneFieldChangeDetails) => void;
+    /**
+     * The controlled country (ISO 3166-1 alpha-2). Without `onCountryChange`
+     * the country is fixed and the picker is not rendered.
+     */
+    country?: string;
+    /** The initial country while uncontrolled. Default `"US"`. */
+    defaultCountry?: string;
+    onCountryChange?: (country: string) => void;
+    /** The countries offered. Default: every entry of `COUNTRY_CODES`. */
+    countries?: readonly CountryCode[];
+    /** The control scale (`--control-*-<size>`). Default `md`. */
+    size?: ControlSize;
+    /**
+     * `default` draws the field border; `ghost` draws none until focused. The
+     * words are `ControlChromeVariant` (`behavior/control-chrome.ts`).
+     */
+    variant?: "default" | "ghost";
+    /** Marks the control invalid (`aria-invalid`, danger chrome); a surrounding `Field` can set it too. */
+    invalid?: boolean;
+    messages?: Partial<PhoneFieldMessages>;
+    /** One class per part, keyed by `PhoneFieldSlot`. `root` is the row, the element `className` lands on too. */
+    classNames?: Partial<Record<PhoneFieldSlot, string>>;
+}
+/**
+ * The design-system phone field: a country picker beside a national number,
+ * one E.164 value.
+ *
+ * @experimental
+ */
+declare const PhoneField: React$1.ForwardRefExoticComponent<PhoneFieldProps & React$1.RefAttributes<HTMLInputElement>>;
+
+type InputProps = React.ComponentProps<typeof Input>;
+interface PhoneInputProps extends Omit<InputProps, "type" | "onChange" | "value" | "defaultValue"> {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (e: React.ChangeEvent<HTMLInputElement>) => void;
+}
+/**
+ * @deprecated Use `PhoneField` (`country="US"` for the fixed-country mode;
+ * `value` is E.164). Removed in 3.0.
+ */
+declare const PhoneInput: React$1.ForwardRefExoticComponent<Omit<PhoneInputProps, "ref"> & React$1.RefAttributes<HTMLInputElement>>;
+
+/**
+ * The legacy flag: the same 20×14 box and ISO fallback as before, drawn from
+ * `PhoneField`'s lazily loaded flag set (a same-size placeholder until it
+ * lands).
+ *
+ * @deprecated Use `PhoneField`'s `CountryFlag`. Removed in 3.0.
+ */
 declare function CountryFlag({ iso }: {
     iso: string;
 }): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Use `PhoneField` (its country picker is a `Combobox`). Removed
+ * in 3.0.
+ */
 declare function CountrySelect({ value, onChange, disabled, }: {
     value: string;
     onChange: (iso: string) => void;
     disabled?: boolean;
 }): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Use `PhoneField`: one E.164 `value` / `onValueChange`, Field
+ * binding and form submission built in. Removed in 3.0.
+ */
 declare function PhoneCountryInput({ countryIso, localPhone, onCountryChange, onPhoneChange, placeholder, error, disabled, id, }: {
     countryIso: string;
     localPhone: string;
@@ -1952,6 +2869,50 @@ 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 PressableProps extends React.ButtonHTMLAttributes<HTMLElement> {
+    /**
+     * Render the child element instead of a `<button>` (Radix `Slot`). The
+     * child keeps its own element and role — an `<a href>` stays a link — and
+     * gains the pressable behaviour: Space activates it like a button, `disabled`
+     * becomes `aria-disabled` + `tabIndex={-1}` with the click swallowed, and
+     * `pressed` is reflected. A child that is neither a `<button>` nor a link
+     * must carry its own `role="button"` and `tabIndex`.
+     */
+    asChild?: boolean;
+    /**
+     * Toggle state (a boolean prop, never a variant — ADR-007 §2). Reflected as
+     * `aria-pressed` and, when true, `data-pressed`. Leave undefined for an
+     * action that does not toggle.
+     */
+    pressed?: boolean;
+    /**
+     * Native `disabled` on a `<button>`; on any other element (`asChild`)
+     * `aria-disabled="true"`, removal from the tab order and a prevented click,
+     * because links and generic elements have no `disabled` attribute.
+     */
+    disabled?: boolean;
+}
+/**
+ * The behaviour of a button, without its look (W3-03; target architecture
+ * §30, ADR-008). What every pressable thing in the system needs and what a
+ * `<div onClick>` never gets: keyboard activation with Enter *and* Space, a
+ * visible focus ring, disabled semantics that hold on links, and `pressed`
+ * reflected as ARIA and as a `data-*` hook for styling.
+ *
+ * Unstyled-accessible: the only classes are the cursor, the focus ring and
+ * `pointer-events-none` while disabled. Geometry and colour belong to the
+ * component that composes it (`Button`'s recipe is `buttonBase`; a clickable
+ * `Surface` renders through this).
+ *
+ * State attributes on the root: `data-slot="pressable"`, `data-disabled`,
+ * `data-pressed`. The native element defaults to `type="button"` — a new
+ * primitive has no submit-by-default legacy to keep (Button's own default is
+ * W3-10).
+ *
+ * @experimental
+ */
+declare const Pressable: React$1.ForwardRefExoticComponent<PressableProps & React$1.RefAttributes<HTMLElement>>;
+
 /**
  * PriorityIcon — priority glyph for the fixed none/low/medium/high/urgent scale.
  *
@@ -1968,11 +2929,45 @@ interface PriorityIconProps extends Omit<React.SVGAttributes<SVGSVGElement>, "co
 }
 declare function PriorityIcon({ priority, size, className, ...props }: PriorityIconProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * The colour vocabulary shared by the Progress family (W3-21, ADR-007 §4,
+ * compat registry C-PROGRESS).
+ *
+ * `ProgressBar` and `ProgressRing` spelled their colour axis `variant`,
+ * `SegmentedProgress` spelled it `tone`, and all three called the brand
+ * colour `default` and danger `destructive`. The new spelling is `intent`
+ * everywhere; the old words stay accepted as deprecated aliases that resolve
+ * through the table below, and every legacy value keeps its classes.
+ *
+ * The family also **auto-colours by value** when no colour is passed
+ * (`< 50%` brand, `≥ 50%` warning, `≥ 80%` success). That mapping is
+ * business-adjacent (Tax documents it as a gotcha) and is kept **on** until
+ * 2.0 (W9-10); an explicit `intent` switches it off, and CM-19 writes the
+ * intent the rule would have picked into every literal-valued call site.
+ *
+ * Lives in the foundation layer because the four presets (L2, one A2 group)
+ * share it and A2 allows no import between them; the unified `Progress`
+ * module (target architecture §26) folds them together later.
+ */
+/** Every intent of the shared vocabulary is a Progress colour. */
+type ProgressIntent = Intent;
+/**
+ * The pre-W3-21 colour words of `ProgressBar`/`ProgressRing` (`variant`) and
+ * `SegmentedProgress` (`tone`).
+ *
+ * @deprecated Use `intent` — `default` → `brand`, `destructive` → `danger`,
+ * the others keep their name. Removed in 3.0; CM-06 / CM-19 rewrite call sites.
+ */
+type ProgressLegacyColour = "default" | "success" | "warning" | "destructive" | "info";
+/** Legacy colour word → `intent` (ADR-007 §4). Classes are identical on both sides. */
+declare const PROGRESS_LEGACY_TO_INTENT: Readonly<Record<ProgressLegacyColour, ProgressIntent>>;
+
 /**
  * ProgressBar — Radix-driven determinate (or indeterminate) progress meter.
- * Track sits on `bg-3`; fills follow the status palette. Variants are an
- * explicit cva enum; if `variant` is omitted, it auto-resolves from value:
- *   <50%  → default (brand)
+ * Track sits on `bg-3`; the fill follows `intent` (ADR-007). When neither
+ * `intent` nor the deprecated `variant` is passed, the colour auto-resolves
+ * from the value (kept on until 2.0, W9-10):
+ *   <50%  → brand
  *   ≥50%  → warning
  *   ≥80%  → success
  *
@@ -1980,10 +2975,24 @@ declare function PriorityIcon({ priority, size, className, ...props }: PriorityI
  * Pass `value={null}` (or omit when in-doubt) to render Radix's indeterminate
  * state — but for back-compat we still accept `value: number`.
  */
-declare const progressBarVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "default" | "destructive" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface ProgressBarProps extends Omit<React.ComponentPropsWithoutRef<typeof ProgressPrimitive.Root>, "value">, VariantProps<typeof progressBarVariants> {
+/** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
+type ProgressBarVariant = ProgressLegacyColour;
+interface ProgressBarVariantProps {
+    /**
+     * Semantic fill colour (ADR-007). Passing it switches the value-driven
+     * auto-colour off. Wins over `variant`.
+     */
+    intent?: ProgressIntent | null;
+    /** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
+    variant?: ProgressBarVariant | null;
+}
+/**
+ * The indicator class string for a resolved colour. Accepts `intent` or the
+ * deprecated `variant`; with neither it renders `brand` (the component itself
+ * auto-colours by value before calling this).
+ */
+declare function progressBarVariants({ intent, variant }?: ProgressBarVariantProps): string;
+interface ProgressBarProps extends Omit<React.ComponentPropsWithoutRef<typeof ProgressPrimitive.Root>, "value">, ProgressBarVariantProps {
     /** 0..max. Set to `null` for an indeterminate track. */
     value: number | null;
     max?: number;
@@ -1994,15 +3003,31 @@ declare const ProgressBar: React$1.ForwardRefExoticComponent<ProgressBarProps &
 
 /**
  * ProgressRing — custom SVG ring meter (no Radix equivalent).
- * Track is `bg-3`, the indicator picks up the active variant. Variants and
- * value-driven auto-resolve mirror ProgressBar so consumers can mix freely.
+ * Track is `bg-3`, the indicator picks up the active `intent` (ADR-007).
+ * Colours and the value-driven auto-resolve mirror ProgressBar so consumers
+ * can mix freely; the auto-colour applies only when neither `intent` nor the
+ * deprecated `variant` is passed (kept on until 2.0, W9-10).
  *
  * Public API preserved: `value`, `max`, `size`, `strokeWidth`, `label`, `sublabel`.
  */
-declare const progressRingVariants: (props?: ({
-    variant?: "info" | "success" | "warning" | "default" | "destructive" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface ProgressRingProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof progressRingVariants> {
+/** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
+type ProgressRingVariant = ProgressLegacyColour;
+interface ProgressRingVariantProps {
+    /**
+     * Semantic indicator colour (ADR-007). Passing it switches the value-driven
+     * auto-colour off. Wins over `variant`.
+     */
+    intent?: ProgressIntent | null;
+    /** @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`. */
+    variant?: ProgressRingVariant | null;
+}
+/**
+ * The indicator class string for a resolved colour. Accepts `intent` or the
+ * deprecated `variant`; with neither it renders `brand` (the component itself
+ * auto-colours by value before calling this).
+ */
+declare function progressRingVariants({ intent, variant }?: ProgressRingVariantProps): string;
+interface ProgressRingProps extends React.HTMLAttributes<HTMLDivElement>, ProgressRingVariantProps {
     value: number;
     max?: number;
     size?: number;
@@ -2012,10 +3037,27 @@ interface ProgressRingProps extends React.HTMLAttributes<HTMLDivElement>, Varian
 }
 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>>;
 
@@ -2046,7 +3088,7 @@ interface RankedBarsProps extends React.HTMLAttributes<HTMLUListElement> {
 }
 declare const RankedBars: React$1.ForwardRefExoticComponent<RankedBarsProps & React$1.RefAttributes<HTMLUListElement>>;
 
-type SheetSide = "top" | "right" | "bottom" | "left";
+type SheetSide$1 = "top" | "right" | "bottom" | "left";
 type DialogSize = "sm" | "md" | "lg" | "full";
 interface ResponsiveDialogProps {
     /** Controlled open state. */
@@ -2067,7 +3109,7 @@ interface ResponsiveDialogProps {
     /** Class applied to the rendered Sheet/Dialog content surface. */
     className?: string;
     /** Sheet side on mobile. Default `"bottom"`. */
-    side?: SheetSide;
+    side?: SheetSide$1;
     /** Desktop Dialog max-width preset. Default `"md"`. */
     size?: DialogSize;
 }
@@ -2106,18 +3148,78 @@ interface ScrollAreaProps extends React$1.ComponentPropsWithoutRef<typeof Scroll
 declare const ScrollArea: React$1.ForwardRefExoticComponent<ScrollAreaProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const ScrollBar: React$1.ForwardRefExoticComponent<Omit<ScrollAreaPrimitive.ScrollAreaScrollbarProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-declare const searchInputVariants: (props?: ({
-    inputSize?: "sm" | "md" | "lg" | "default" | "compact" | "comfortable" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type SearchInputVariants = VariantProps<typeof searchInputVariants>;
-interface SearchInputProps extends Omit<React$1.InputHTMLAttributes<HTMLInputElement>, "type" | "onChange" | "size">, SearchInputVariants {
-    value: string;
-    onValueChange: (value: string) => void;
-    onSearch?: (value: string) => void;
-    debounceMs?: number;
-}
-declare const SearchInput: React$1.ForwardRefExoticComponent<SearchInputProps & React$1.RefAttributes<HTMLInputElement>>;
-
+/**
+ * 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;
@@ -2151,6 +3253,7 @@ interface SearchSelectOption {
      */
     description?: string;
 }
+/** @deprecated Use `ComboboxProps`. Removed in 3.0 (C-SEARCHSELECT, CM-08). */
 interface SearchSelectProps {
     options: SearchSelectOption[];
     /**
@@ -2213,8 +3316,22 @@ interface SearchSelectProps {
      * reads as a tag instead of running into the label. Single-mode only.
      */
     descriptionVariant?: "inline" | "pill";
+    /** The accessible name (W4-12). Without it, `placeholder` names the input as before. */
+    "aria-label"?: string;
+    /** Names the input from another element, for example a visible label (W4-12). */
+    "aria-labelledby"?: string;
+    "aria-describedby"?: string;
+    /** The input's id, so a `<label htmlFor>` can point at it (W4-12). */
+    id?: string;
 }
-declare function SearchSelect({ options, selected: selectedProp, onSelect: onSelectProp, onRemove: onRemoveProp, value, onValueChange, onCreate, placeholder, className, disabled, groupFilter, pinnedGroups, closeOnSelect: closeOnSelectProp, showGroupCounts, onCreateNew, createNewLabel, descriptionVariant, }: SearchSelectProps): react_jsx_runtime.JSX.Element;
+/**
+ * @deprecated Use `Combobox` (single: `value` / `onValueChange` with `null` for
+ * empty; multi: `multiple` with `TValue[]`) and the `Option` shape
+ * (`{ value, label }`). `SearchSelect` is an adapter over it and is removed in
+ * 3.0 (compatibility registry C-SEARCHSELECT); codemod CM-08 rewrites call
+ * sites and flags the ones a human must look at.
+ */
+declare function SearchSelect({ options, selected: selectedProp, onSelect: onSelectProp, onRemove: onRemoveProp, value, onValueChange, onCreate, placeholder, className, disabled, groupFilter, pinnedGroups, closeOnSelect: closeOnSelectProp, showGroupCounts, onCreateNew, createNewLabel, descriptionVariant, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, id, }: SearchSelectProps): react_jsx_runtime.JSX.Element;
 declare namespace SearchSelect {
     var displayName: string;
 }
@@ -2254,21 +3371,33 @@ interface SectionHeadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "t
 }
 declare const SectionHead: React$1.ForwardRefExoticComponent<SectionHeadProps & React$1.RefAttributes<HTMLDivElement>>;
 
+/** Service tints — product hues, never intents (ADR-007 §2); reachable through `tone` only. */
+declare const SERVICE_FILL: {
+    tax: string;
+    audit: string;
+    accounting: string;
+};
+/** Service tints: product hues that stay on the deprecated `tone` axis. */
+type SegmentedServiceTone = keyof typeof SERVICE_FILL;
 /**
- * SegmentedProgress — discrete step meter rendered as N pill segments, the
- * first `current` of which are filled. Used on engagement cards ("step 2
- * of 5") where a continuous bar would over-state precision.
+ * The pre-W3-21 colour words (compat registry C-TONE).
  *
- * `tone` colors the filled segments. Status tones map to the semantic
- * palette; service tones map to the practice ramp — both resolve to a
- * single CSS color so the segment markup stays identical.
+ * @deprecated Use `intent` — `default` → `brand`, `destructive` → `danger`,
+ * the other status words keep their name. The service tones have no intent
+ * and stay here. Removed in 3.0; CM-06 rewrites the mappable call sites.
  */
-type SegmentedTone = "default" | "success" | "warning" | "destructive" | "info" | "tax" | "audit" | "accounting";
+type SegmentedTone = ProgressLegacyColour | SegmentedServiceTone;
 interface SegmentedProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
     /** Total number of segments. */
     steps: number;
     /** How many leading segments are filled. */
     current: number;
+    /** Semantic fill colour (ADR-007). Default `brand`. Wins over `tone`. */
+    intent?: ProgressIntent;
+    /**
+     * @deprecated Use `intent`. `default` → `brand`, `destructive` → `danger`;
+     * `tax` / `audit` / `accounting` stay here (no intent).
+     */
     tone?: SegmentedTone;
     /** Segment height in px. Default 6. */
     thickness?: number;
@@ -2280,10 +3409,53 @@ declare const SegmentedProgress: React$1.ForwardRefExoticComponent<SegmentedProg
 declare const SelectRoot: React$1.FC<SelectPrimitive.SelectProps>;
 declare const SelectGroup: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectValue: React$1.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & React$1.RefAttributes<HTMLSpanElement>>;
-declare const SelectTrigger: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
+/**
+ * The Select sizes: the shared control scale, nothing else (A1, ADR-013).
+ *
+ * @experimental
+ */
+type SelectSize = ControlSize;
+/**
+ * The parts a `classNames` entry can reach on the options-driven `Select`,
+ * keyed by the anatomy (ADR-008 decision 4). `value` is a span of ours
+ * around Radix's value (Radix's own span drops `className`), rendered only
+ * when `classNames.value` or `clearable` asks for it, so a legacy call keeps
+ * the `SelectTrigger > span` structure C-DOM-10 freezes.
+ *
+ * @experimental
+ */
+type SelectClassNames = Partial<Record<SelectSlot, string>>;
+
+/**
+ * Props of `SelectTrigger`: Radix's trigger props plus the control-scale
+ * `size` and a class for the chevron.
+ *
+ * @experimental `size` and `classNames`
+ */
+interface SelectTriggerProps extends React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger> {
+    /**
+     * Height, horizontal padding, label size, gap and glyph size from the shared
+     * control scale (A1). Omitted, the trigger keeps its legacy geometry (36px,
+     * the same pixels as `md`).
+     */
+    size?: SelectSize | null;
+    /** Classes for the parts the trigger renders itself: the chevron `icon`. */
+    classNames?: Pick<SelectClassNames, "icon">;
+}
+declare const SelectTrigger: React$1.ForwardRefExoticComponent<SelectTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const SelectScrollUpButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollUpButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectScrollDownButton: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectScrollDownButtonProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const SelectContent: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Props of `SelectContent`: Radix's content props plus a class for the
+ * viewport (C-DOM-19's `[data-radix-select-viewport]` selector replacement).
+ *
+ * @experimental `classNames`
+ */
+interface SelectContentProps extends React$1.ComponentPropsWithoutRef<typeof SelectPrimitive.Content> {
+    /** Classes for the parts the content renders itself: the scrolling `viewport`. */
+    classNames?: Pick<SelectClassNames, "viewport">;
+}
+declare const SelectContent: React$1.ForwardRefExoticComponent<SelectContentProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectLabel: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectLabelProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectItem: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectItemProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const SelectSeparator: React$1.ForwardRefExoticComponent<Omit<SelectPrimitive.SelectSeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
@@ -2300,26 +3472,104 @@ interface SelectOption {
 interface SelectProps {
     /** Option list. Required to preserve legacy API. */
     options: SelectOption[];
-    /** Controlled value. */
-    value?: string;
-    /** Uncontrolled initial value. */
-    defaultValue?: string;
+    /**
+     * Controlled value. `null` is "nothing selected" (target architecture §32);
+     * `""` means the same and stays accepted through 2.x (C-SELECT-EMPTY).
+     */
+    value?: string | null;
+    /** Uncontrolled initial value; restored on form reset. `null` = nothing selected. */
+    defaultValue?: string | null;
+    /**
+     * Called with the picked option's value, and with `""` when the selection
+     * is cleared (`clearable`) — the signature every existing handler already
+     * has. Reporting `null` is a 3.0 change (C-SELECT-EMPTY).
+     */
     onValueChange?: (value: string) => void;
     placeholder?: string;
-    /** Accepted for back-compat. NO-OP — see file header for migration. */
+    /**
+     * @deprecated NO-OP: Radix Select cannot filter. Use `Combobox` (or
+     * `SearchSelect`) for filterable selection. Warns once in development;
+     * removed in 2.0 (C-SELECT-DEAD, codemod CM-11).
+     */
     searchable?: boolean;
     disabled?: boolean;
+    /**
+     * Submit the value under this name through the form the trigger sits in
+     * (or `form`). Inside a `<Field name>` the field's name applies.
+     */
     name?: string;
+    /**
+     * Block native submission while nothing is selected; the trigger carries
+     * `aria-required`. Inside a `<Field required>` the field's flag applies.
+     */
     required?: boolean;
+    /**
+     * The `id` of the form to submit with when the trigger is rendered outside
+     * it — inside a portalled Dialog or Sheet (ADR-006).
+     *
+     * @experimental
+     */
+    form?: string;
+    /**
+     * The trigger's `id`; inside a `<Field>` the field's control id applies.
+     *
+     * @experimental
+     */
+    id?: string;
+    /**
+     * The control scale (A1, ADR-013): `xs` 28 · `sm` 32 · `md` 36 · `lg` 40 ·
+     * `xl` 48. Omitted, the trigger keeps its legacy 36px row; a `<Field size>`
+     * supplies it.
+     *
+     * @experimental
+     */
+    size?: SelectSize;
+    /**
+     * Show a clear button beside the chevron while a value is selected. Clearing
+     * reports `""` through `onValueChange` and focuses the trigger. Renders the
+     * `root` part (`data-slot="select"`) around the trigger — `className` lands
+     * on that wrapper then, `classNames.trigger` on the trigger.
+     *
+     * @experimental
+     */
+    clearable?: boolean;
+    /**
+     * The outermost element's class: the trigger, or the `root` wrapper when
+     * `clearable`.
+     */
     className?: string;
-    /** Forwarded to the trigger. */
+    /**
+     * One class per part (ADR-008 decision 4): `trigger`, `value`, `icon`
+     * (chevron), `content`, `viewport`, `item`, `clear`, `root`. Each part's
+     * class comes after the design system's own and before `className`.
+     * `value` wraps Radix's value span in one of ours (see `SelectClassNames`).
+     *
+     * @experimental
+     */
+    classNames?: SelectClassNames;
+    /** Overrides of the copy the select renders (English defaults until W5-20). */
+    messages?: Partial<SelectMessages>;
+    /**
+     * @deprecated Use `classNames.trigger` (C-CLASSNAME-PROPS, codemod CM-11).
+     * Removed in 3.0.
+     */
     triggerClassName?: string;
-    /** Forwarded to the content. */
+    /**
+     * @deprecated Use `classNames.content` (C-CLASSNAME-PROPS, codemod CM-11).
+     * Removed in 3.0.
+     */
     contentClassName?: string;
-    /** aria-invalid + danger styling on trigger. */
+    /** aria-invalid + danger styling on trigger. Inside a `<Field invalid>` the field's flag applies. */
     "aria-invalid"?: boolean;
-    /** aria-label fallback when there is no visible label. */
+    /**
+     * aria-label fallback when there is no visible label. Inside a `<Field>`
+     * with a `Label` the trigger is named by the label instead.
+     */
     "aria-label"?: string;
+    /** Explicit `aria-labelledby`; wins over the surrounding `Field`. */
+    "aria-labelledby"?: string;
+    /** Explicit `aria-describedby`; appended after the field's description and error. */
+    "aria-describedby"?: string;
 }
 /**
  * Convenience `Select` — preserved options-driven API.
@@ -2335,15 +3585,48 @@ interface SelectProps {
  *     </SelectContent>
  *   </SelectRoot>
  */
-declare function Select({ options, value, defaultValue, onValueChange, placeholder, searchable, disabled, name, required, className, triggerClassName, contentClassName, "aria-invalid": ariaInvalid, "aria-label": ariaLabel, }: SelectProps): react_jsx_runtime.JSX.Element;
+declare function Select({ options, value: valueProp, defaultValue: defaultValueProp, onValueChange, placeholder, searchable, disabled: disabledProp, name: nameProp, required: requiredProp, form, id: idProp, size: sizeProp, clearable, className, classNames, messages, triggerClassName, contentClassName, "aria-invalid": ariaInvalid, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, "aria-describedby": ariaDescribedBy, }: SelectProps): react_jsx_runtime.JSX.Element;
 declare namespace Select {
     var displayName: string;
 }
 
 declare const Separator: React$1.ForwardRefExoticComponent<Omit<SeparatorPrimitive.SeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 
-type Side = "top" | "right" | "bottom" | "left";
-type SheetWidth = "default" | "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * The edge a `Sheet` slides in from.
+ *
+ * @experimental
+ */
+type SheetSide = "top" | "right" | "bottom" | "left";
+type Side = SheetSide;
+/**
+ * Width of a left/right `SheetContent`, as a step of the sheet width scale
+ * (W5-07): `sm` 420px · `md` 520px · `lg` 640px · `xl` 760px from the `sm`
+ * breakpoint (95vw below it) · `full` the viewport. Omitted, the panel keeps
+ * its 1.x geometry (`w-3/4 max-w-sm`). Every step and the default yield to
+ * `--ds-sheet-width` when a consumer sets it. Top/bottom sheets span the
+ * viewport and ignore it.
+ *
+ * @experimental
+ */
+type SheetSize = "sm" | "md" | "lg" | "xl" | "full";
+/**
+ * What the deprecated `width` prop accepts: the size steps plus `default`.
+ *
+ * @deprecated Use `size` (C-SHEET-WIDTH, codemod CM-11). Removed in 3.0.
+ * @experimental
+ */
+type SheetWidth = "default" | SheetSize;
+/**
+ * The copy a `Sheet` renders (target architecture §24.5). English defaults
+ * until the messages contract of the provider lands (W5-20).
+ *
+ * @experimental
+ */
+interface SheetMessages {
+    /** The accessible name of the built-in close button. Default `"Close"`. */
+    close: string;
+}
 interface SheetProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Root> {
     /**
      * Default side for SheetContent if it doesn't specify its own.
@@ -2360,31 +3643,72 @@ declare const SheetTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.Di
 declare const SheetClose: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & React$1.RefAttributes<HTMLButtonElement>>;
 declare const SheetPortal: React$1.FC<DialogPrimitive.DialogPortalProps>;
 declare const SheetOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
-declare const sheetVariants: (props?: ({
-    side?: "left" | "right" | "bottom" | "top" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface SheetContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content>, VariantProps<typeof sheetVariants> {
+/**
+ * Props of `SheetContent`: Radix's content props plus the side, the sizing
+ * and the dismiss options.
+ *
+ * @experimental
+ */
+interface SheetContentProps extends React$1.ComponentPropsWithoutRef<typeof DialogPrimitive.Content> {
+    /** The edge the panel slides in from. Default `right` (or the `Sheet` root's `side`). */
+    side?: SheetSide | null;
+    /**
+     * Width step for left/right sheets. Omit for the 1.x geometry
+     * (`w-3/4 max-w-sm`). See {@link SheetSize}.
+     */
+    size?: SheetSize;
     /** If false, the built-in close button is hidden. Default: true. */
     showCloseButton?: boolean;
     /**
-     * Width preset for left/right sheets. Omit for the historical default
-     * (`w-3/4 max-w-sm`). Top/bottom sheets ignore this prop.
+     * The accessible name of the built-in close button. Takes precedence over
+     * `messages.close`. Default `"Close"`.
+     */
+    closeLabel?: string;
+    /** Overrides of the copy the sheet renders (English defaults until W5-20). */
+    messages?: Partial<SheetMessages>;
+    /**
+     * Width preset for left/right sheets — the same steps as `size`, plus
+     * `default`. When both are given `size` wins.
+     *
+     * @deprecated Use `size` (C-SHEET-WIDTH, codemod CM-11). Removed in 3.0.
      */
     width?: SheetWidth;
     /**
-     * Custom CSS width for left/right sheets, e.g. `"520px"` or
-     * `"min(95vw, 720px)"`. Prefer `width` presets unless a product surface
-     * has a proven one-off contract.
+     * Custom CSS width for left/right sheets, e.g. `"520px"`, rendered as an
+     * inline `width` with `max-width: 95vw`.
+     *
+     * @deprecated Set the `--ds-sheet-width` custom property instead
+     * (C-SHEET-WIDTH, codemod CM-11). Removed in 3.0.
      */
     customWidth?: string;
 }
 declare const SheetContent: React$1.ForwardRefExoticComponent<SheetContentProps & React$1.RefAttributes<HTMLDivElement>>;
 declare const SheetHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    (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>>;
@@ -2443,19 +3767,82 @@ 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>>;
 
-declare const spinnerVariants: (props?: ({
-    size?: "xs" | "sm" | "md" | "lg" | null | undefined;
-    tone?: "accent" | "success" | "warning" | "current" | "destructive" | "muted" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof spinnerVariants> {
+/**
+ * Spinner — indeterminate activity indicator.
+ *
+ *   intent — omitted (default) inherits `currentColor`, so a Spinner inside a
+ *            Button takes the button's ink; `neutral` | `brand` | `info` |
+ *            `success` | `warning` | `danger` pick a colour (ADR-007).
+ *            `tone` is the deprecated spelling: `muted` → `neutral`,
+ *            `accent` → `info`, `destructive` → `danger`, `current` → omit.
+ *   size   — xs (12px) | sm (16px) | md (20px, default) | lg (24px)
+ */
+/** Every intent of the shared vocabulary is a Spinner colour. */
+type SpinnerIntent = Intent;
+/**
+ * The pre-W3-21 colour words (compat registry C-TONE).
+ *
+ * @deprecated Use `intent` — `muted` → `neutral`, `accent` → `info`,
+ * `destructive` → `danger`; `current` is the default and is simply omitted.
+ * Removed in 3.0; CM-06 rewrites call sites.
+ */
+type SpinnerTone = "current" | "muted" | "accent" | "success" | "warning" | "destructive";
+type SpinnerSize = "xs" | "sm" | "md" | "lg";
+/**
+ * Legacy `tone` → `intent` (ADR-007 §4). `current` maps to no intent: the
+ * spinner inherits `currentColor`, which is also what an omitted `intent`
+ * renders. Classes are identical on both sides.
+ */
+declare const SPINNER_TONE_TO_INTENT: Readonly<Record<SpinnerTone, SpinnerIntent | undefined>>;
+interface SpinnerVariantProps {
+    /** Semantic colour (ADR-007). Omitted, the spinner inherits `currentColor`. Wins over `tone`. */
+    intent?: SpinnerIntent | null;
+    /** @deprecated Use `intent`. `muted` → `neutral`, `accent` → `info`, `destructive` → `danger`. */
+    tone?: SpinnerTone | null;
+    size?: SpinnerSize | null;
+}
+/** The Spinner class string. Accepts `intent` or the deprecated `tone`. */
+declare function spinnerVariants({ intent, tone, size }?: SpinnerVariantProps): string;
+interface SpinnerProps extends React.HTMLAttributes<HTMLSpanElement>, SpinnerVariantProps {
     /**
      * Accessible status text. Omit when adjacent visible copy already names the
      * loading state, such as inside a button labelled "Saving".
@@ -2623,21 +4010,48 @@ declare const Stat: React$1.ForwardRefExoticComponent<StatProps & React$1.RefAtt
  * top-bar bells, list rows, unread markers. (Avatar already renders its own
  * corner presence dot — use that for avatar-attached dots.)
  *
- *   tone   — danger (default) | warning | info | success | pro | neutral
+ *   intent — danger (default) | warning | info | success | brand | neutral
+ *            (ADR-007 vocabulary; `tone` is the deprecated spelling)
  *   size   — sm ~7px (default) | md ~9px
  *   ring   — adds a 2px solid surface ring so the dot reads when overlaid on
  *            icons / avatars (box-shadow, so it never shifts layout)
  *   pulse  — subtle expanding ping halo; hidden under prefers-reduced-motion
  *
- * The dot fills with `currentColor`, so the ping clone inherits the same tone
- * automatically. `aria-hidden` by default — pass `aria-label` to expose it.
- */
-declare const statusDotVariants: (props?: ({
-    tone?: "neutral" | "info" | "success" | "warning" | "danger" | "pro" | null | undefined;
-    size?: "sm" | "md" | null | undefined;
-    ring?: boolean | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-interface StatusDotProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof statusDotVariants> {
+ * The dot fills with `currentColor`, so the ping clone inherits the same
+ * colour automatically. `aria-hidden` by default — pass `aria-label` to
+ * expose it.
+ */
+/** Every intent of the shared vocabulary is a StatusDot colour. */
+type StatusDotIntent = Intent;
+/** Legacy `tone` → `intent` (ADR-007 §4). Classes are identical on both sides. */
+declare const STATUS_DOT_TONE_TO_INTENT: {
+    readonly danger: "danger";
+    readonly warning: "warning";
+    readonly info: "info";
+    readonly success: "success";
+    readonly pro: "brand";
+    readonly neutral: "neutral";
+};
+/**
+ * The pre-W3-21 colour words (compat registry C-TONE). `pro` is the brand
+ * colour spelled as a product name.
+ *
+ * @deprecated Use `intent` — `tone="pro"` is `intent="brand"`, every other
+ * value keeps its name. Removed in 3.0; CM-06 rewrites call sites.
+ */
+type StatusDotTone = keyof typeof STATUS_DOT_TONE_TO_INTENT;
+type StatusDotSize = "sm" | "md";
+interface StatusDotVariantProps {
+    /** Semantic colour (ADR-007). Default `danger`. Wins over `tone`. */
+    intent?: StatusDotIntent | null;
+    /** @deprecated Use `intent`. `pro` → `brand`; other values keep their name. */
+    tone?: StatusDotTone | null;
+    size?: StatusDotSize | null;
+    ring?: boolean | null;
+}
+/** The StatusDot class string. Accepts `intent` or the deprecated `tone`. */
+declare function statusDotVariants({ intent, tone, size, ring }?: StatusDotVariantProps): string;
+interface StatusDotProps extends React.HTMLAttributes<HTMLSpanElement>, StatusDotVariantProps {
     /** Subtle expanding ping halo. Respects `prefers-reduced-motion`. */
     pulse?: boolean;
 }
@@ -2737,6 +4151,13 @@ declare const StickyActionBar: React$1.ForwardRefExoticComponent<StickyActionBar
 interface SubmitButtonProps extends Omit<ButtonProps, "type" | "loading"> {
     pendingText?: string;
     children: React.ReactNode;
+    /**
+     * A submit button fills its form row by default (what it has always
+     * rendered); pass `fullWidth={false}` for an inline one.
+     *
+     * @experimental
+     */
+    fullWidth?: boolean;
 }
 /**
  * SubmitButton — react-dom `useFormStatus`-aware Button.
@@ -2748,7 +4169,7 @@ declare const SubmitButton: React$1.ForwardRefExoticComponent<SubmitButtonProps
  * SuiteProgress — a discrete, segmented progress meter with a percent readout.
  *
  * Renders `total` equal-width segments in a flex row. Segments before `value`
- * are filled in the suite tone; the rest sit on the `surface-3` track. An
+ * are filled in the meter's colour; the rest sit on the `surface-3` track. An
  * optional numeric percent renders to the right (bold + tabular, with a
  * smaller "%").
  *
@@ -2757,11 +4178,40 @@ declare const SubmitButton: React$1.ForwardRefExoticComponent<SubmitButtonProps
  * pipeline and engagement *completion* (e.g. "3 of 5 — 60%"). Pick the step
  * meter when the count itself is the message; pick this when the percentage is.
  *
+ * `intent` colours the filled segments (ADR-007; default `brand`, which is
+ * what `tone="pro"` rendered). The suite tones (`audit` | `books` | `tax`)
+ * stay on the deprecated `tone` axis: product names are never intents.
+ *
  * Pure presentational — no client runtime required.
  */
-declare const suiteProgressFillVariants: (props?: ({
-    tone?: "audit" | "books" | "tax" | "pro" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Legacy `tone` → `intent` (ADR-007 §4): the one suite tone that is a brand colour. */
+declare const SUITE_PROGRESS_TONE_TO_INTENT: {
+    readonly pro: "brand";
+};
+/** Suite tints — product hues, never intents (ADR-007 §2); reachable through `tone` only. */
+declare const SUITE_FILL: {
+    audit: string;
+    books: string;
+    tax: string;
+};
+/** Suite tints: product hues that stay on the deprecated `tone` axis. */
+type SuiteProgressSuiteTone = keyof typeof SUITE_FILL;
+/**
+ * The pre-W3-21 colour words (compat registry C-TONE).
+ *
+ * @deprecated Use `intent` — `tone="pro"` is `intent="brand"`. The suite
+ * tones (`audit`, `books`, `tax`) have no intent and stay here. Removed in
+ * 3.0; CM-06 rewrites the mappable call sites.
+ */
+type SuiteProgressTone = keyof typeof SUITE_PROGRESS_TONE_TO_INTENT | SuiteProgressSuiteTone;
+interface SuiteProgressFillVariantProps {
+    /** Semantic fill colour (ADR-007). Default `brand`. Wins over `tone`. */
+    intent?: ProgressIntent | null;
+    /** @deprecated Use `intent`. `pro` → `brand`; `audit` / `books` / `tax` stay here. */
+    tone?: SuiteProgressTone | null;
+}
+/** The filled-segment class string. Accepts `intent` or the deprecated `tone`. */
+declare function suiteProgressFillVariants({ intent, tone }?: SuiteProgressFillVariantProps): string;
 declare const SIZE_STYLES: {
     readonly sm: {
         readonly row: "ds:gap-2";
@@ -2777,8 +4227,7 @@ declare const SIZE_STYLES: {
     };
 };
 type SuiteProgressSize = keyof typeof SIZE_STYLES;
-type SuiteProgressTone = NonNullable<VariantProps<typeof suiteProgressFillVariants>["tone"]>;
-interface SuiteProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "role"> {
+interface SuiteProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "role">, SuiteProgressFillVariantProps {
     /** Number of completed segments. */
     value: number;
     /** Total segment count. */
@@ -2787,8 +4236,6 @@ interface SuiteProgressProps extends Omit<React.HTMLAttributes<HTMLDivElement>,
     showPercent?: boolean;
     /** Override the displayed percent (0–100). Falls back to value/total. */
     percent?: number;
-    /** Suite tone for filled segments. Defaults to "pro". */
-    tone?: SuiteProgressTone;
     /** Bar height + text scale. Defaults to "md". */
     size?: SuiteProgressSize;
     /** Optional leading label, rendered before the segments. */
@@ -2801,8 +4248,18 @@ declare const SuiteProgress: React$1.ForwardRefExoticComponent<SuiteProgressProp
 declare const switchVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
+/** The switch sizes: the component's own geometry (`sm` 20×36, `md` 24×44). */
+type SwitchSize = NonNullable<VariantProps<typeof switchVariants>["size"]>;
 interface SwitchProps extends Omit<React$1.ComponentPropsWithoutRef<typeof SwitchPrimitive.Root>, "size">, VariantProps<typeof switchVariants> {
+    /** Optional inline label rendered to the right of the track. Names the button through `htmlFor`. */
     label?: string;
+    /** The value submitted with `name` while on. Default `"on"`, like a native checkbox. */
+    value?: string;
+    /**
+     * The switch is in error: `aria-invalid` and `data-invalid`. Implied by the
+     * surrounding `Field`'s `invalid` or a mounted `FieldError`.
+     */
+    invalid?: boolean;
 }
 declare const Switch: React$1.ForwardRefExoticComponent<SwitchProps & React$1.RefAttributes<HTMLButtonElement>>;
 
@@ -2854,17 +4311,95 @@ declare namespace TeamMemberSelect {
     var displayName: string;
 }
 
-declare const textareaVariants: (props?: ({
-    variant?: "ghost" | "default" | null | undefined;
-    inputSize?: "sm" | "md" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
-type TextareaVariants = VariantProps<typeof textareaVariants>;
+/**
+ * The emphases a Textarea offers: the shared chrome's `default` and `ghost`
+ * (spelled out, as on Input, so the public declaration names no unexported
+ * symbol; the `satisfies` keeps it in step with the recipe).
+ *
+ * @experimental
+ */
+type TextareaVariant = "default" | "ghost";
+/**
+ * The size names a Textarea knows (W4-06): the three steps that have a
+ * `--textarea-min-height-<size>` token (64 / 80 / 96px). A textarea grows
+ * with its content, so `size` is a *minimum* height, not the outer height
+ * the shared scale promises (`baselines/size-geometry.json` keeps Textarea
+ * out of A1 on purpose). Padding and text stay on today's steps until D5.
+ *
+ * @experimental
+ */
+type TextareaSize = Extract<ControlSize, "sm" | "md" | "lg">;
+/**
+ * What {@link textareaVariants} takes: the emphasis, the size (either name —
+ * `size` wins when both are given) and cva's class props.
+ *
+ * @experimental
+ */
+interface TextareaVariantsOptions {
+    variant?: TextareaVariant | null;
+    size?: TextareaSize | null;
+    /**
+     * The legacy size prop (C-INPUT-SIZE): today's rows, byte for byte.
+     *
+     * @deprecated Use `size`. Codemod CM-07 renames it.
+     */
+    inputSize?: TextareaSize | null;
+    class?: string | null;
+    className?: string | null;
+}
+/** The variant props of `textareaVariants` (cva's `VariantProps` shape, kept for the API report). */
+type TextareaVariants = Omit<TextareaVariantsOptions, "class" | "className">;
+/**
+ * The Textarea class recipe (W4-06): the shared control chrome
+ * (`behavior/control-chrome.ts`) with the emphasis and no height row, then
+ * the `min-height` row of the size.
+ *
+ * Against the cva it replaces the set of classes differs in one place, on
+ * purpose (W4-03 mapping, PR #199): the motion string is the shared
+ * `microInteractions.control` — same transitioned properties, the feedback
+ * duration token (the same 150ms `--duration-fast` was) and the `enter`
+ * easing where the copy declared none. `tests/browser/textarea-parity.test.tsx`
+ * holds every other computed property equal under each host fixture.
+ * Server-safe.
+ *
+ * @experimental
+ */
+declare function textareaVariants({ variant, size, inputSize, class: classProp, className, }?: TextareaVariantsOptions): string;
+/**
+ * Props of `Textarea` (W4-06).
+ *
+ * @experimental The name is exported since W4-06; the props it lists have been
+ * stable since 1.x.
+ */
 interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, "size">, TextareaVariants {
+    /** Sugar for the field label, bound through the field wiring (`htmlFor`/`id`). */
     label?: string;
+    /** Sugar for the hint text under the control, referenced before `error` in `aria-describedby`. */
+    description?: string;
+    /** Sugar for the error message: linked through `aria-describedby`, marks the control invalid. */
     error?: string;
+    /** The value is invalid without a message to show. Implied by `error`. */
+    invalid?: boolean;
+    /** Show `<length>/<maxLength>` under the control. Needs `maxLength`. */
     showCount?: boolean;
+    /** Grow with the content instead of scrolling. */
     autoResize?: boolean;
+    /** Called with the new string value on every change, next to `onChange`. */
+    onValueChange?: (value: string) => void;
+    /**
+     * Classes per anatomy part (the `textarea-*` slots). The `<textarea>`
+     * is the root part and takes `className` (C-INPUT-CLASSNAME), so it has no
+     * entry here.
+     */
+    classNames?: Partial<Record<Exclude<TextareaSlot, "root">, string>>;
+    /** Classes for the outer wrapper (transitional, C-INPUT-CLASSNAME — see `Input`). */
+    rootClassName?: string;
 }
+/**
+ * A multi-line text field. The control is a native `<textarea>`; inside a
+ * `Field` it binds itself through `useFieldControl`, and the
+ * `label` / `description` / `error` sugar renders the same wiring around it.
+ */
 declare const Textarea: React$1.ForwardRefExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
 
 type ToastVariant = "default" | "success" | "destructive" | "warning" | "info" | "loading";
@@ -2916,8 +4451,34 @@ declare function ToastProvider({ children }: ToastProviderProps): react_jsx_runt
 declare const itemVariants: (props?: ({
     variant?: "outline" | "default" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-type ToggleGroupRootProps = React$1.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Root> & VariantProps<typeof itemVariants>;
-declare const ToggleGroup: React$1.ForwardRefExoticComponent<ToggleGroupRootProps & React$1.RefAttributes<HTMLDivElement>>;
+/** The toggle-group sizes: the shared control scale (A1). */
+type ToggleGroupSize = ControlSize;
+/** The item's look: bare (`default`) or with a border (`outline`). */
+type ToggleGroupVariant = NonNullable<VariantProps<typeof itemVariants>["variant"]>;
+type RadixRootProps = React$1.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Root>;
+/** The props every group shares, whatever its `type`. */
+interface ToggleGroupFormProps extends VariantProps<typeof itemVariants> {
+    /** Outer height from the shared control scale (A1). Omitted: today's geometry. */
+    size?: ToggleGroupSize;
+    /** The form field name. Without it the group does not take part in a form. */
+    name?: string;
+    /** `id` of the form to submit with when the group is rendered outside it. */
+    form?: string;
+    /** Block native submission while nothing is pressed. */
+    required?: boolean;
+    /**
+     * The group is in error: `aria-invalid` and `data-invalid`. Implied by the
+     * surrounding `Field`'s `invalid` or a mounted `FieldError`.
+     */
+    invalid?: boolean;
+    /**
+     * Single groups only: submit `name=""` while nothing is pressed (`true`,
+     * the default and what a Select does) or omit the entry (`false`).
+     */
+    submitEmpty?: boolean;
+}
+type ToggleGroupProps = RadixRootProps & ToggleGroupFormProps;
+declare const ToggleGroup: React$1.ForwardRefExoticComponent<ToggleGroupProps & React$1.RefAttributes<HTMLDivElement>>;
 interface ToggleGroupItemProps extends React$1.ComponentPropsWithoutRef<typeof ToggleGroupPrimitive.Item>, VariantProps<typeof itemVariants> {
 }
 declare const ToggleGroupItem: React$1.ForwardRefExoticComponent<ToggleGroupItemProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -3161,319 +4722,828 @@ interface TextProps extends Omit<React.HTMLAttributes<HTMLElement>, "color"> {
 declare const Text: React$1.ForwardRefExoticComponent<TextProps & React$1.RefAttributes<HTMLElement>>;
 
 /**
- * The document-outline level: which of `<h1>`…`<h6>` renders. Semantic only —
- * it says where the heading sits in the outline, not how large it is.
+ * The shared vocabulary of the layout primitives (W2-15, target architecture
+ * §16, §22, §23): the gap scale, the alignment words, and the one responsive
+ * shape a layout prop may take.
  *
- * @experimental W2-13.
+ * Every class this module hands out is a literal in the tables below. Tailwind
+ * compiles a utility only when it can read it from source, so a class built
+ * from string pieces at render time would exist in the DOM and nowhere in
+ * `dist/styles.css`. The tables are the whole set; nothing else is generated.
+ *
+ * The gap utilities read the `stack.gap.*` tokens through the parenthesised
+ * custom-property form (`gap-(--stack-gap-md)`), which is what binds a step to
+ * the token rather than to Tailwind's numeric scale: a density scope or a
+ * consumer preset that re-points `--stack-gap-md` moves every `Stack` with it.
  */
-type HeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
 /**
- * The visual role of a heading: one of the four title roles of target
- * architecture §15. Independent of `level`. Written out as a literal union so
- * the public API report records the names.
+ * The breakpoints a responsive layout prop may name. They are Tailwind's `sm`,
+ * `md` and `lg` (40 / 48 / 64rem), the same values `breakpoints` in the
+ * `/tokens` entry publishes (W2-10). Only `Stack direction` and the `gap` of
+ * `Stack`/`Inline` are responsive (target architecture §22); nothing else on a
+ * layout primitive takes an object.
  *
- * @experimental W2-13.
+ * @experimental
  */
-type HeadingSize = "display" | "title-page" | "title-section" | "title-sub";
+type LayoutBreakpoint = "sm" | "md" | "lg";
 /**
- * Props of `Heading`. `level` is required on purpose: a heading without an
- * outline level is the hard-coded `h3`/`h1`/`h4` this component exists to end
- * (target architecture §15.2, current-state audit §14).
+ * A layout prop value that may change at a breakpoint: either one value, or an
+ * object of values by breakpoint. `base` is what applies below `sm`; when it
+ * is omitted the prop's own default applies there, so
+ * `direction={{ md: "row" }}` reads "a column, a row from `md` up".
  *
- * @experimental W2-13.
+ * @experimental
  */
-interface HeadingProps extends React.HTMLAttributes<HTMLHeadingElement> {
-    /** The outline level: renders `<h{level}>`. Required. */
-    level: HeadingLevel;
+type Responsive<T> = T | Partial<Record<"base" | LayoutBreakpoint, T>>;
+/**
+ * The five gaps the library actually writes (W2-02, `stack.gap.*`): 4 / 6 / 8 /
+ * 12 / 16px, plus `none`. `md` (8px) is the single most-written gap in the
+ * library and the default of both `Stack` and `Inline`.
+ *
+ * @experimental
+ */
+type LayoutGap = "none" | "xs" | "sm" | "md" | "lg" | "xl";
+/**
+ * Cross-axis alignment of the children (`align-items`).
+ *
+ * @experimental
+ */
+type LayoutAlign = "start" | "center" | "end" | "stretch" | "baseline";
+/**
+ * Main-axis distribution of the children (`justify-content`).
+ *
+ * @experimental
+ */
+type LayoutJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
+
+/**
+ * The axis a `Stack` lays its children along.
+ *
+ * @experimental
+ */
+type StackDirection = "column" | "row";
+
+/**
+ * Props of `Stack`.
+ *
+ * A layout primitive takes tokenised props only for the things it exists for
+ * — the gap between its children and how they line up — and never arbitrary
+ * style props (target architecture §23). There is no `padding`, `margin`,
+ * `p`/`m`/`px`/`mt`, `bg`, `color`, `width`, `height`, `sx` or `css` here, and
+ * `gap` accepts a scale step, not a number or a length. Spacing *around* a
+ * stack belongs to its parent; a box with padding is a `Surface`. `className`
+ * and `style` land on the root element (§29.1).
+ *
+ * @experimental
+ */
+interface StackProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
     /**
-     * The visual role, independent of `level`. Defaults from the level
-     * (`1` → `title-page`, `2` → `title-section`, `3`–`6` → `title-sub`), so an
-     * `<h3>` that must look like a section title says `size="title-section"`
-     * instead of becoming an `<h2>`.
+     * The axis the children follow. Responsive: `{ base?, sm?, md?, lg? }`, so
+     * a form row can be a column on a phone and a row from `sm` up.
+     * @default "column"
      */
-    size?: HeadingSize;
+    direction?: Responsive<StackDirection>;
+    /**
+     * The gap between children, as a `stack.gap` step (4 / 6 / 8 / 12 / 16px)
+     * or `none`. Responsive like `direction`.
+     * @default "md"
+     */
+    gap?: Responsive<LayoutGap>;
+    /** Cross-axis alignment (`align-items`). Not responsive. */
+    align?: LayoutAlign;
+    /** Main-axis distribution (`justify-content`). Not responsive. */
+    justify?: LayoutJustify;
+    /** Whether children may wrap onto further lines. Not responsive. */
+    wrap?: boolean;
 }
 /**
- * `Heading` — an `<h1>`…`<h6>` whose outline level and visual size are two
- * separate props (W2-13, target architecture §15.2).
+ * Stack — the one-dimensional layout primitive (W2-15, target architecture
+ * §23). A flex container that owns the spacing *between* its children through
+ * the `stack.gap` tokens, so siblings never carry outer margins of their own.
  *
- * `level` is required and picks the element; `size` picks the title role and
- * defaults from the level. Because the two are independent, a card title can
- * be the `<h3>` the document outline needs and still render at the section
- * scale, and a page can keep exactly one `<h1>` without every other title
- * shrinking. Every size is a role token; there is no pixel size.
+ * Vertical by default; `direction` may switch to a row, at a breakpoint if
+ * needed. Only `direction` and `gap` are responsive — the deliberately small
+ * exception the architecture makes for layout primitives (§22). For a
+ * horizontal, wrapping row use `Inline`.
  *
- * Renders in the display family (`font-display`) and the heading ink (`fg`),
- * as the base `h1`–`h4` rules do today, so an `<h5>` at `title-sub` matches an
- * `<h4>` at `title-sub`.
+ * Server-safe: no hooks, no client directive, renders a plain `div` and stamps
+ * `data-slot="stack"`. `asChild` is deferred until the design system has its
+ * own `Slot` in the a11y primitives (the Radix package is a behaviour import
+ * the L1b layer may not make directly).
  *
- * Server-safe: no hooks, no client directive, no effects.
+ * @experimental Shipped in Wave 2 as a new export nobody is forced to use; the
+ * prop shapes may still change before the wave's exit review.
+ */
+declare const Stack: React$1.ForwardRefExoticComponent<StackProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props of `Inline`.
  *
- * Anatomy: one part, `data-slot="heading"`, which is also where `className`
- * and `style` land.
+ * The same discipline as `StackProps`: tokenised props for gap and alignment
+ * only, no arbitrary style props (`padding`, `margin`, `p`/`m`/`px`/`mt`,
+ * `bg`, `color`, `width`, `height`, `sx`, `css`), and `gap` is a scale step.
+ * `className` and `style` land on the root element (§29.1).
  *
- * @example
- * ```tsx
- * <Heading level={1}>Engagements</Heading>
- * <Heading level={3} size="title-section">Documents</Heading>
+ * @experimental
+ */
+interface InlineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
+    /**
+     * The gap between children, as a `stack.gap` step (4 / 6 / 8 / 12 / 16px)
+     * or `none`. Responsive: `{ base?, sm?, md?, lg? }`.
+     * @default "md"
+     */
+    gap?: Responsive<LayoutGap>;
+    /**
+     * Cross-axis alignment (`align-items`). Not responsive.
+     * @default "center"
+     */
+    align?: LayoutAlign;
+    /** Main-axis distribution (`justify-content`). Not responsive. */
+    justify?: LayoutJustify;
+    /**
+     * Whether children may wrap onto further lines. Not responsive.
+     * @default true
+     */
+    wrap?: boolean;
+}
+/**
+ * Inline — the horizontal, wrapping row (W2-15, target architecture §23): a
+ * label beside a badge, a row of chips, the buttons of a toolbar. Children are
+ * centred on the cross axis and wrap by default, which is what a row of mixed
+ * heights and unknown count wants; `Stack direction="row"` is the row that
+ * does not wrap and stretches.
+ *
+ * Only `gap` is responsive (§22). Server-safe: no hooks, no client directive,
+ * renders a plain `div` and stamps `data-slot="inline"`. `asChild` is deferred
+ * with `Stack`'s.
+ *
+ * @experimental Shipped in Wave 2 as a new export nobody is forced to use; the
+ * prop shapes may still change before the wave's exit review.
+ */
+declare const Inline: React$1.ForwardRefExoticComponent<InlineProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * How one status looks, in the shared vocabulary (ADR-007). These are the
+ * presentation props of `StatusBadge`; a map entry is spread straight onto it.
+ *
+ * @experimental
+ */
+interface StatusPresentation {
+    /** Semantic meaning → colour family. Required: a status without a meaning is a `Badge`. */
+    intent: Intent;
+    /** Emphasis. `StatusBadge` defaults to `soft`, the status-chip look. */
+    variant?: Extract<Variant, "solid" | "soft" | "outline">;
+    /** Leading dot, for a state where work is in flight or attention is due. */
+    dot?: boolean;
+    /** Spinner in place of the dot or icon, for a state that is still moving. */
+    loading?: boolean;
+}
+/**
+ * A product's status map: one entry per member of its status union, nothing
+ * missing, nothing extra.
+ *
+ * @experimental
+ */
+type StatusMap<TStatus extends string, TEntry extends StatusPresentation = StatusPresentation> = Readonly<Record<TStatus, TEntry>>;
+/**
+ * Rejects keys outside the status union: a plain generic constraint would let
+ * an unknown status through. Part of `defineStatusMap`'s signature only.
+ *
+ * @experimental
+ */
+type OnlyStatuses<TMap, TStatus extends string> = {
+    readonly [K in Exclude<keyof TMap, TStatus>]: never;
+};
+/**
+ * Declares a status map that is checked for exhaustiveness against the
+ * product's own status union and keeps the literal type of every entry, key
+ * by key.
+ *
+ * Two call shapes:
+ *
+ * ```ts
+ * // The status union is known, the entries are inferred (extra fields kept):
+ * const MEETING = defineStatusMap<MeetingStatus>()({
+ *   pending:    { intent: "neutral", loading: true, labelKey: "status.pending" },
+ *   notesReady: { intent: "success", labelKey: "status.notesReady" },
+ *   //           ^ a missing or unknown status is a type error
+ * });
+ * MEETING.pending.loading; // true
+ *
+ * // Both are named, when the product already types its entries:
+ * const IMPORTS = defineStatusMap<ImportStatus, ImportMeta>({ … });
  * ```
  *
- * @experimental New export (W2-13); its size vocabulary may change while
- * decision D1 (visual source of truth) is open.
+ * Runtime: returns its argument. The value is the type check.
+ *
+ * @experimental
  */
-declare const Heading: React$1.ForwardRefExoticComponent<HeadingProps & React$1.RefAttributes<HTMLHeadingElement>>;
+declare function defineStatusMap<TStatus extends string>(): <TMap extends StatusMap<TStatus>>(map: TMap & OnlyStatuses<TMap, TStatus>) => Readonly<TMap>;
+declare function defineStatusMap<TStatus extends string, TEntry extends StatusPresentation>(map: StatusMap<TStatus, TEntry>): StatusMap<TStatus, TEntry>;
+
+interface StatusBadgeProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, "children">, StatusPresentation {
+    /** The status name, as the product spells it. Always visible. */
+    label: React.ReactNode;
+    /** Leading 14px glyph; ignored while `loading`, replaced by `dot` when both are set. */
+    icon?: React.ReactNode;
+    /** What the status means for the work, shown on hover and focus. */
+    description?: React.ReactNode;
+    /** `xs`, `sm` (default) or `md` — the Badge scale. */
+    size?: BadgeSize;
+    /** Corner treatment, as on `Badge`; omitted keeps the Badge default (D1). */
+    shape?: BadgeShape;
+}
+declare const StatusBadge: React$1.ForwardRefExoticComponent<StatusBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
 
 /**
- * The shared vocabulary of the layout primitives (W2-15, target architecture
- * §16, §22, §23): the gap scale, the alignment words, and the one responsive
- * shape a layout prop may take.
+ * The IconButton sizes: the shared control scale, nothing else (A1).
  *
- * Every class this module hands out is a literal in the tables below. Tailwind
- * compiles a utility only when it can read it from source, so a class built
- * from string pieces at render time would exist in the DOM and nowhere in
- * `dist/styles.css`. The tables are the whole set; nothing else is generated.
+ * @experimental
+ */
+type IconButtonSize = ControlSize;
+/** Where the default tooltip opens. @experimental */
+type IconButtonTooltipSide = "top" | "right" | "bottom" | "left";
+/** @experimental */
+interface IconButtonProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "aria-label" | "children"> {
+    /**
+     * The accessible name — what a screen reader says and, by default, what the
+     * tooltip shows. Required: an icon alone is not a name.
+     */
+    label: string;
+    /** The glyph. `children` is accepted as an alias for `<IconButton label="…"><Icon /></IconButton>`. */
+    icon?: ReactNode;
+    children?: ReactNode;
+    /**
+     * Visual emphasis, as on Button: `solid` (default) · `soft` · `outline` ·
+     * `ghost` · `link`. The legacy Button words resolve through the same table.
+     */
+    variant?: ButtonVariant;
+    /**
+     * Meaning → colour family: `brand` · `neutral` · `success` · `danger`.
+     * Defaults per variant, as on Button. `destructive` is a deprecated alias
+     * of `danger` (decision D4).
+     */
+    intent?: ButtonIntent | ButtonIntentAlias;
+    /**
+     * Outer size, square, from the shared control scale (A1): `xs` 28 · `sm` 32
+     * · `md` 36 (default; D5-gated token) · `lg` 40 · `xl` 48.
+     */
+    size?: IconButtonSize;
+    /**
+     * `true` (default) shows `label` in a tooltip on hover and focus; `false`
+     * renders no tooltip (the `aria-label` stays); a node replaces the text.
+     * The tooltip is never the only source of the name.
+     */
+    tooltip?: boolean | ReactNode;
+    /** Side the tooltip opens on. Default `top`. */
+    tooltipSide?: IconButtonTooltipSide;
+    /** Render the child element instead of a `<button>` (Radix `Slot`). */
+    asChild?: boolean;
+    /** Replaces the glyph with a spinner, sets `aria-busy` and disables the control. */
+    loading?: boolean;
+    /**
+     * Toggle state (a boolean prop, never a variant — ADR-007 §2). Reflected as
+     * `aria-pressed` and, when true, `data-pressed`.
+     */
+    pressed?: boolean;
+}
+/**
+ * The IconButton class recipe: `buttonBase` (look resolved from `variant` +
+ * `intent`, no text-button size row) plus the square control-scale size, so
+ * `IconButton size="sm"` and `Button size="sm"` are the same height by
+ * construction. Server-safe.
  *
- * The gap utilities read the `stack.gap.*` tokens through the parenthesised
- * custom-property form (`gap-(--stack-gap-md)`), which is what binds a step to
- * the token rather than to Tailwind's numeric scale: a density scope or a
- * consumer preset that re-points `--stack-gap-md` moves every `Stack` with it.
+ * @experimental
+ */
+declare function iconButtonVariants({ variant, intent, size, className, }?: {
+    variant?: ButtonVariant | null;
+    intent?: ButtonIntent | ButtonIntentAlias | null;
+    size?: IconButtonSize | null;
+    className?: string | null;
+}): string;
+/**
+ * An icon-only action with a required accessible name, a tooltip by default
+ * and the Button family's look on a square control-scale geometry. See the
+ * module comment.
+ *
+ * @experimental
+ */
+declare const IconButton: React$1.ForwardRefExoticComponent<IconButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+/** The emphasis subset a chip offers. @experimental */
+type ChipVariant = Extract<Variant, "solid" | "soft" | "outline">;
+/** The intents a chip offers (the Button family's). @experimental */
+type ChipIntent = ButtonIntent;
+/** The chip sizes: the shared control scale (A1). @experimental */
+type ChipSize = ControlSize;
+/** @experimental */
+interface ChipProps extends Omit<React.HTMLAttributes<HTMLElement>, "children" | "onClick"> {
+    /** The label. A string also names the remove button ("Remove {label}"). */
+    children: ReactNode;
+    /** Leading glyph, decorative. */
+    icon?: ReactNode;
+    /** Trailing number. */
+    count?: number;
+    /** Visual emphasis: `soft` (default) · `solid` · `outline`. */
+    variant?: ChipVariant;
+    /**
+     * Meaning → colour family. Default `neutral`, or `brand` while `pressed`.
+     * `destructive` is a deprecated alias of `danger` (decision D4).
+     */
+    intent?: ChipIntent | ButtonIntentAlias;
+    /** Outer height from the shared control scale (A1). Default `sm` (32px). */
+    size?: ChipSize;
+    /**
+     * Toggle state (a boolean prop, never a variant — ADR-007 §2). Controlled:
+     * pair with `onPressedChange`. Reflected as `aria-pressed` / `data-pressed`.
+     */
+    pressed?: boolean;
+    /** Called with the next state when a toggle chip is activated. */
+    onPressedChange?: (pressed: boolean) => void;
+    /** Activation of the chip itself (not of the remove button). */
+    onClick?: React.MouseEventHandler<HTMLButtonElement>;
+    /** Renders a remove button after the label and is called when it is activated. */
+    onRemove?: () => void;
+    /**
+     * The remove button's accessible name. Defaults to "Remove {label}" when
+     * `children` is a string; required otherwise (a development error).
+     */
+    removeLabel?: string;
+    /** Disables the chip and its remove button. */
+    disabled?: boolean;
+}
+/**
+ * The chip class recipe: `buttonBase` for the resolved look (no text-button
+ * size row), a pill corner, and the control-scale size. Server-safe.
+ *
+ * @experimental
+ */
+declare function chipVariants({ variant, intent, size, pressed, className, }?: {
+    variant?: ChipVariant | null;
+    intent?: ChipIntent | ButtonIntentAlias | null;
+    size?: ChipSize | null;
+    pressed?: boolean | null;
+    className?: string | null;
+}): string;
+/**
+ * The resolved appearance of a chip: the emphasis, the colour family and the
+ * row of the Button colour table they render (see the module comment on the
+ * `intent` default).
+ *
+ * @experimental
  */
+interface ChipStyle {
+    variant: ChipVariant;
+    intent: ChipIntent;
+    look: ButtonLook;
+}
+/** Resolves `variant` + `intent` (+ `pressed`) to the row a chip renders. */
+declare function resolveChipStyle({ variant, intent, pressed, }: {
+    variant?: ChipVariant | null;
+    intent?: ChipIntent | ButtonIntentAlias | null;
+    pressed?: boolean | null;
+}): ChipStyle;
+/**
+ * The removable, toggleable or clickable token, on `buttonBase` through
+ * `Pressable`. See the module comment.
+ *
+ * @experimental
+ */
+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;
+}
 /**
- * The breakpoints a responsive layout prop may name. They are Tailwind's `sm`,
- * `md` and `lg` (40 / 48 / 64rem), the same values `breakpoints` in the
- * `/tokens` entry publishes (W2-10). Only `Stack direction` and the `gap` of
- * `Stack`/`Inline` are responsive (target architecture §22); nothing else on a
- * layout primitive takes an object.
+ * 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
  */
-type LayoutBreakpoint = "sm" | "md" | "lg";
+declare const Field: React$1.ForwardRefExoticComponent<FieldProps & React$1.RefAttributes<HTMLDivElement>>;
 /**
- * A layout prop value that may change at a breakpoint: either one value, or an
- * object of values by breakpoint. `base` is what applies below `sm`; when it
- * is omitted the prop's own default applies there, so
- * `direction={{ md: "row" }}` reads "a column, a row from `md` up".
+ * Props of `FieldDescription`.
  *
  * @experimental
  */
-type Responsive<T> = T | Partial<Record<"base" | LayoutBreakpoint, T>>;
+type FieldDescriptionProps = HTMLAttributes<HTMLParagraphElement>;
 /**
- * The five gaps the library actually writes (W2-02, `stack.gap.*`): 4 / 6 / 8 /
- * 12 / 16px, plus `none`. `md` (8px) is the single most-written gap in the
- * library and the default of both `Stack` and `Inline`.
+ * 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
  */
-type LayoutGap = "none" | "xs" | "sm" | "md" | "lg" | "xl";
+declare const FieldDescription: React$1.ForwardRefExoticComponent<FieldDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>>;
 /**
- * Cross-axis alignment of the children (`align-items`).
+ * Props of `FieldError`.
  *
  * @experimental
  */
-type LayoutAlign = "start" | "center" | "end" | "stretch" | "baseline";
+type FieldErrorProps = HTMLAttributes<HTMLParagraphElement>;
 /**
- * Main-axis distribution of the children (`justify-content`).
+ * 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
  */
-type LayoutJustify = "start" | "center" | "end" | "between" | "around" | "evenly";
+declare const FieldError: React$1.ForwardRefExoticComponent<FieldErrorProps & React$1.RefAttributes<HTMLParagraphElement>>;
 
 /**
- * The axis a `Stack` lays its children along.
+ * 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.
  *
- * @experimental
+ * 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.
  */
-type StackDirection = "column" | "row";
-
 /**
- * Props of `Stack`.
- *
- * A layout primitive takes tokenised props only for the things it exists for
- * — the gap between its children and how they line up — and never arbitrary
- * style props (target architecture §23). There is no `padding`, `margin`,
- * `p`/`m`/`px`/`mt`, `bg`, `color`, `width`, `height`, `sx` or `css` here, and
- * `gap` accepts a scale step, not a number or a length. Spacing *around* a
- * stack belongs to its parent; a box with padding is a `Surface`. `className`
- * and `style` land on the root element (§29.1).
+ * 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 StackProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
+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;
     /**
-     * The axis the children follow. Responsive: `{ base?, sm?, md?, lg? }`, so
-     * a form row can be a column on a phone and a row from `sm` up.
-     * @default "column"
+     * `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`).
      */
-    direction?: Responsive<StackDirection>;
+    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;
     /**
-     * The gap between children, as a `stack.gap` step (4 / 6 / 8 / 12 / 16px)
-     * or `none`. Responsive like `direction`.
-     * @default "md"
+     * 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.
      */
-    gap?: Responsive<LayoutGap>;
-    /** Cross-axis alignment (`align-items`). Not responsive. */
-    align?: LayoutAlign;
-    /** Main-axis distribution (`justify-content`). Not responsive. */
-    justify?: LayoutJustify;
-    /** Whether children may wrap onto further lines. Not responsive. */
-    wrap?: boolean;
+    ref: RefCallback<HTMLElement>;
 }
 /**
- * Stack — the one-dimensional layout primitive (W2-15, target architecture
- * §23). A flex container that owns the spacing *between* its children through
- * the `stack.gap` tokens, so siblings never carry outer margins of their own.
- *
- * Vertical by default; `direction` may switch to a row, at a breakpoint if
- * needed. Only `direction` and `gap` are responsive — the deliberately small
- * exception the architecture makes for layout primitives (§22). For a
- * horizontal, wrapping row use `Inline`.
+ * 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.
  *
- * Server-safe: no hooks, no client directive, renders a plain `div` and stamps
- * `data-slot="stack"`. `asChild` is deferred until the design system has its
- * own `Slot` in the a11y primitives (the Radix package is a behaviour import
- * the L1b layer may not make directly).
+ * 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 Shipped in Wave 2 as a new export nobody is forced to use; the
- * prop shapes may still change before the wave's exit review.
+ * @experimental
  */
-declare const Stack: React$1.ForwardRefExoticComponent<StackProps & React$1.RefAttributes<HTMLDivElement>>;
+declare function useFieldControl(props?: UseFieldControlProps): FieldControlWiring;
 
 /**
- * Props of `Inline`.
- *
- * The same discipline as `StackProps`: tokenised props for gap and alignment
- * only, no arbitrary style props (`padding`, `margin`, `p`/`m`/`px`/`mt`,
- * `bg`, `color`, `width`, `height`, `sx`, `css`), and `gap` is a scale step.
- * `className` and `style` land on the root element (§29.1).
+ * Props of `FieldControl`.
  *
  * @experimental
  */
-interface InlineProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
-    /**
-     * The gap between children, as a `stack.gap` step (4 / 6 / 8 / 12 / 16px)
-     * or `none`. Responsive: `{ base?, sm?, md?, lg? }`.
-     * @default "md"
-     */
-    gap?: Responsive<LayoutGap>;
-    /**
-     * Cross-axis alignment (`align-items`). Not responsive.
-     * @default "center"
-     */
-    align?: LayoutAlign;
-    /** Main-axis distribution (`justify-content`). Not responsive. */
-    justify?: LayoutJustify;
-    /**
-     * Whether children may wrap onto further lines. Not responsive.
-     * @default true
-     */
-    wrap?: boolean;
+interface FieldControlProps extends Pick<UseFieldControlProps, "native"> {
+    /** Exactly one element. Its own `id`, `aria-*` and state props win over the field. */
+    children: ReactElement;
 }
 /**
- * Inline — the horizontal, wrapping row (W2-15, target architecture §23): a
- * label beside a badge, a row of chips, the buttons of a toolbar. Children are
- * centred on the cross axis and wrap by default, which is what a row of mixed
- * heights and unknown count wants; `Stack direction="row"` is the row that
- * does not wrap and stretches.
+ * Injects the field's wiring into its only child (see `useFieldControl`).
  *
- * Only `gap` is responsive (§22). Server-safe: no hooks, no client directive,
- * renders a plain `div` and stamps `data-slot="inline"`. `asChild` is deferred
- * with `Stack`'s.
+ * `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 Shipped in Wave 2 as a new export nobody is forced to use; the
- * prop shapes may still change before the wave's exit review.
+ * @experimental
  */
-declare const Inline: React$1.ForwardRefExoticComponent<InlineProps & React$1.RefAttributes<HTMLDivElement>>;
+declare function FieldControl({ children, native }: FieldControlProps): ReactElement;
 
 /**
- * Inner padding of a `Surface`, as a `surface.padding` role (W2-02): 16 / 20 /
- * 24px — the three card and panel paddings the library and its consumers
- * already write — or `none` for a surface whose content pads itself (a table,
- * an image, a list with its own row padding).
+ * Props of `Fieldset`.
  *
  * @experimental
  */
-type SurfacePadding = "none" | "sm" | "md" | "lg";
+interface FieldsetProps extends FieldsetHTMLAttributes<HTMLFieldSetElement> {
+    /** The group is in error; `data-invalid` for styling. Each field carries its own `aria-invalid`. */
+    invalid?: boolean;
+}
 /**
- * Corner radius of a `Surface`, as a radius role (W2-07, target architecture
- * §18): `surface` for cards, dialogs and sheets, `surface-sm` for popovers,
- * tooltips, toasts and small cards, or `none`. Control and badge radii are not
- * offered: a surface is never a control.
+ * A group of fields under one legend. No visual chrome: the browser's
+ * fieldset border and padding are reset.
  *
  * @experimental
  */
-type SurfaceRadius = "none" | "surface-sm" | "surface";
+declare const Fieldset: React$1.ForwardRefExoticComponent<FieldsetProps & React$1.RefAttributes<HTMLFieldSetElement>>;
 /**
- * Elevation of a `Surface`, as an elevation role (W2-08, target architecture
- * §19): `flat` (resting, border-led — today's `Card`), `raised` (resting
- * lift), `floating` (anchored transient surfaces), `overlay` (modal surfaces),
- * or `none` for no shadow at all — which is what the hand-rolled card boxes in
- * every product render, and the default. `flat` is kept distinct from `none`
- * because today's `flat` role still aliases the hairline `shadow-quiet` (gated
- * on D1); when D1 lands the two coincide and nothing here changes.
+ * Props of `FieldsetLegend`.
  *
  * @experimental
  */
-type SurfaceElevation = "none" | "flat" | "raised" | "floating" | "overlay";
+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>>;
 
 /**
- * Props of `Surface`.
+ * L1a behaviour primitive (private). Not exported from the package.
  *
- * Tokenised props for exactly the three things a surface is (padding, radius,
- * elevation) and nothing else: no `gap`/`align`/`direction` (that is a `Stack`
- * inside it), no `bg`, `border`, `shadow`, `rounded`, `p`/`m`/`px`/`mt`,
- * `color`, `width`, `height`, `sx` or `css`, and no numeric or length values.
- * `className` and `style` land on the root element (§29.1).
+ * 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 SurfaceProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "color"> {
-    /**
-     * Inner padding, as a `surface.padding` role.
-     * @default "sm"
-     */
-    padding?: SurfacePadding;
+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;
     /**
-     * Corner radius, as a radius role.
-     * @default "surface"
+     * Filter `options` by the query (`true`, the default). `false` when the
+     * consumer filters — the options are already the answer to the query.
      */
-    radius?: SurfaceRadius;
+    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;
     /**
-     * Shadow, as an elevation role.
-     * @default "none"
+     * Replaces the chips inside the control: called with the picked options
+     * and `remove`. Return `null` to render nothing there.
      */
-    elevation?: SurfaceElevation;
+    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;
 }
 /**
- * Surface — the bordered box content sits on (W2-16, target architecture §23).
- * It is the primitive behind the 367 (Pro) / 119 (Portal) / 96 (Tax)
- * hand-rolled card boxes of the consumer usage audit (the class string is
- * `HAND_ROLLED_CARD` in the stories; it is not spelled here because Tailwind
- * would compile it from this comment) and the `.surface` helper class: with no
- * props it renders that box — surface background, 1px rule border,
- * `radius.surface`, `surface.padding.sm`, no shadow — and every knob is a
- * role, never a value. `Card` (W3-17) is built on it and adds anatomy.
- *
- * Deferred, deliberately:
- * - `interactive`: a clickable surface renders through `Pressable` (W3-03) so
- *   it gets keyboard activation, `data-pressed` and a focus ring for free; a
- *   `cursor-pointer` hover treatment here would be a click target with no
- *   keyboard semantics. Until then, put a `Button asChild` or a link inside
- *   the surface.
- * - `asChild`: waits for the design system's own `Slot` (a11y primitives).
+ * The props, discriminated by `multiple` (target architecture §32 "Value"):
+ * a single pick is `TValue | null`, a multi pick is `TValue[]`.
  *
- * Server-safe: no hooks, no client directive, renders a plain `div` and stamps
- * `data-slot="surface"`.
+ * @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.
  *
- * Under a consumer's shadcn theme the hand-rolled box and this primitive differ
- * on purpose in two places the parity story makes visible: the products'
- * `rounded-xl` is `--radius` + 4px (16px) where `radius.surface` is 12px, and
- * their `--border` is not the design system's rule colour. Both are decision
- * D1 (target architecture §18); `Surface` follows the roles.
+ * @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 Shipped in Wave 2 as a new export nobody is forced to use; the
- * prop shapes may still change before the wave's exit review.
+ * @experimental
  */
-declare const Surface: React$1.ForwardRefExoticComponent<SurfaceProps & React$1.RefAttributes<HTMLDivElement>>;
+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
@@ -6756,4 +8826,78 @@ interface BrandScopeProps extends React.HTMLAttributes<HTMLDivElement> {
  */
 declare const BrandScope: React$1.ForwardRefExoticComponent<BrandScopeProps & React$1.RefAttributes<HTMLDivElement>>;
 
-export { AIReceiptPanel, type AIReceiptPanelProps, type AIReceiptResult, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActivityDotVariant, ActivityEventItem, type ActivityEventItemProps, ActivityItem, type ActivityItemProps, ActivityList, type ActivityListProps, type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AiDraftCard, type AiDraftCardProps, type AiDraftState, Alert, AlertCircleIcon, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogSlot, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AlertTriangleIcon, AlertTriangleSolidIcon, AppHeader, AppHeaderActions, type AppHeaderActionsProps, AppHeaderBreadcrumb, type AppHeaderBreadcrumbProps, type AppHeaderProps, AppHeaderSearch, type AppHeaderSearchProps, AppHeaderTitle, type AppHeaderTitleProps, ArchiveIcon, AreaChart, type AreaChartProps, type AreaPoint, ArrowDownIcon, ArrowLeftIcon, ArrowRightIcon, ArrowRightSmallIcon, ArrowUpIcon, AspectRatio, Assignee, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, AtSignIcon, AttachmentChip, type AttachmentChipProps, AttentionItem, type AttentionItemProps, type AttentionUrgency, Avatar, BRAND_PRODUCTS, Badge, type BadgeProps, type BadgeSlot, BarChartIcon, BellIcon, Blockquote, BoldIcon, BottomNav, type BottomNavProps, type BottomNavTab, BrainIcon, 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, BriefcaseIcon, Building2Icon, BuildingIcon, BulkActionBar, BulkActionBarAction, type BulkActionBarActionProps, type BulkActionBarProps, BulkActionBarSeparator, type BulkActionBarVariant, Button, type ButtonProps, type ButtonSize, type ButtonSlot, type ButtonVariant, COUNTRY_CODES, Calendar, type CalendarCaptionLayout, type CalendarHighlight, type CalendarHighlightColor, CalendarIcon, type CalendarProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CardVariants, CategoryDivider, type CategoryDividerProps, CategoryTag, type CategoryTagProps, type CategoryTone, type CellValue, type ChannelTabItem, ChannelTabs, type ChannelTabsProps, type ChannelTone, ChatBubbleIcon, CheckCircle2Icon, CheckCircleSolidIcon, CheckIcon, Checkbox, type CheckboxSlot, ChevronDownIcon, ChevronLeftIcon, ChevronRightIcon, ChevronUpIcon, ChevronsDownUpIcon, ChevronsUpDownIcon, CircleDotIcon, CircleIcon, ClientRailGroupHeader, type ClientRailGroupHeaderProps, ClientRailItem, type ClientRailItemProps, ClientSelect, type ClientSelectOption, ClipboardCheckIcon, ClockIcon, CloseIcon, Code, type CodeProps, type CodeSlot, type CodeVariant, Collapsible, CollapsibleContent, CollapsibleTrigger, ComingSoon, type ComingSoonProps, CommandIcon, 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, type ControlSize, CopyButton, CopyIcon, CornerDownLeftIcon, type CountryCode, CountryFlag, CountrySelect, CreditCardIcon, 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, DocumentIcon, 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, DollarSignIcon, DonutChart, type DonutChartProps, type DonutSegment, DownloadIcon, 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, ExternalLinkIcon, ExtractIcon, EyeIcon, EyeOffIcon, Eyebrow, type EyebrowProps, FileChip, type FileChipProps, FileIcon, type FileKind, FileReturnIcon, FileTextIcon, FileTypeBadge, type FileTypeBadgeProps, type FileTypeTone, FileUpload, type FileUploadSlot, FilterChip, type FilterChipProps, FilterIcon, FlagIcon, FolderClosedIcon, type FolderNode, FolderOpenIcon, FolderPlusIcon, FolderTree, type FolderTreeProps, FolderUpIcon, FormError, FormSection, FormSuccess, GlobeIcon, GoogleBrandIcon, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, GripVerticalIcon, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, type HeadingSlot, HelpCircleIcon, HistoryIcon, HomeIcon, HoverCard, HoverCardContent, HoverCardPortal, HoverCardTrigger, IconAction, type IconActionProps, type IconComponent, type IconDefinition, type IconProps, type IconSize, IconTile, type IconTileProps, InboxIcon, InfoCircleSolidIcon, InfoIcon, Inline, type InlineProps, type InlineSlot, Input, type InputSlot, type InputVariants, type Intent, IntentBadge, type IntentBadgeProps, type IntentTone, ItalicIcon, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, KanbanIcon, type KanbanProps, Kbd, type KbdGlyph, KbdHint, type KbdHintProps, type KbdProps, type KbdSlot, type KbdVariant, KeyIcon, type KeyboardShortcut, type KeyboardShortcutSection, KeyboardShortcutsDialog, type KeyboardShortcutsDialogProps, KpiCard, type KpiCardProps, type KpiDelta, Label, type LabelSlot, LandmarkIcon, LayersIcon, type LayoutAlign, type LayoutBreakpoint, LayoutDashboardIcon, type LayoutGap, LayoutGridIcon, type LayoutJustify, LayoutListIcon, LightningIcon, Link2Icon, LinkAction, type LinkActionProps, LinkButton, type LinkButtonProps$1 as LinkButtonProps, type LinkButtonSlot, LinkIcon, ListChecksIcon, ListIcon, ListOrderedIcon, LoaderIcon, LoadingRows, LockIcon, LockKeyholeIcon, LockOpenIcon, LogOutIcon, Logo, MailIcon, Main, type MainProps, MapPinIcon, MasterDetailLayout, type MasterDetailLayoutProps, MaximizeIcon, MenuIcon, MessageBubble, MessageBubbleAction, type MessageBubbleActionProps, type MessageBubbleProps, MessageBubbleTombstone, type MessageBubbleTombstoneProps, MessageCircleIcon, MessageCircleWarningIcon, MessageComposer, type MessageComposerProps, MetadataGrid, MicIcon, MicrosoftBrandIcon, MinimizeIcon, MinusIcon, type MissingDocumentItem, MissingDocumentsPanel, type MissingDocumentsPanelProps, MoneyCell, MonitorIcon, MoonIcon, MoreHorizontalIcon, MoveIcon, 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, PageHeader, type PageHeaderProps, PageHeaderSep, type PageHeaderSepProps, PageHeaderSpec, type PageHeaderSpecProps, Pagination, type PaginationProps, type PaginationSlot, PaletteIcon, PanelLeftCloseIcon, PanelLeftIcon, PanelRightIcon, PaperclipIcon, PauseIcon, PdfPreview, type PdfPreviewProps, PenSignIcon, PenToolIcon, PencilIcon, PhoneCountryInput, PhoneIcon, PhoneInput, type PillStatus, PlayIcon, PlusIcon, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, type PopoverSlot, PopoverTrigger, PrimaryAction, type PrimaryActionProps, type Priority, PriorityIcon, type PriorityIconProps, ProgressBar, type ProgressBarProps, ProgressRing, type ProgressRingProps, 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, ReceiptIcon, RefreshCwIcon, ReplyIcon, type Responsive, ResponsiveDialog, type ResponsiveDialogProps, RotateCcwIcon, RouteTransition, type RouteTransitionProps, SERVICE_TONES, SaveIcon, ScrollArea, ScrollBar, SearchIcon, SearchInput, type SearchInputSlot, type SearchInputVariants, SearchSelect, type SearchSelectOption, SecondaryAction, type SecondaryActionProps, Section, SectionHead, SectionHeader, SegmentedProgress, type SegmentedProgressProps, type SegmentedTone, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, type SelectOption, type SelectProps, SelectRoot, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSlot, SelectTrigger, SelectValue, SelectableKpiCard, type SelectableKpiCardProps, SendIcon, Separator, type ServiceTone, SettingsIcon, type Shape, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetPortal, type SheetSlot, SheetTitle, SheetTrigger, Shell, type ShellProps, type ShellSlot, ShieldIcon, 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, SigmaIcon, SignatureEditor, type SignatureEditorProps, Skeleton, SkeletonCircle, SkeletonText, SlashIcon, Slider, SmartphoneIcon, type SortDirection, SparkleIcon, SparklesIcon, Spinner, type SpinnerProps, SpreadsheetPreview, type SpreadsheetPreviewProps, Stack, type StackDirection, type StackProps, type StackSlot, StackedBarChart, type StackedBarChartProps, type StackedBarDatum, type StackedBarSeries, StagePill, StarIcon, StarRating, type StarRatingProps, Stat, StatusDot, type StatusDotProps, StatusIcon, type StatusIconProps, StatusPill, type StatusPillProps, type StatusState, type Step, Stepper, type StepperProps, StickyActionBar, type StickyActionBarProps, StickyStack, StickyStackLayer, type StickyStackLayerProps, type StickyStackProps, StickyStackSectionHeader, type StickyStackSectionHeaderProps, StickyStackSticky, type StickyStackStickyProps, StopIcon, StrikethroughIcon, SubmitButton, SuggestionPills, type SuggestionPillsProps, SuiteProgress, type SuiteProgressProps, type SuiteProgressSize, type SuiteProgressTone, SunIcon, Surface, type SurfaceElevation, type SurfacePadding, type SurfaceProps, type SurfaceRadius, type SurfaceSlot, Switch, type SwitchSlot, SystemTokens, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, TableIcon, type TableProps, TableRow, type TableRowData, type TableRowProps, type TableSlot, type TableTone, Tabs, TabsContent, TabsList, TabsTrigger, TagIcon, TagsCell, TeamIcon, TeamMemberSelect, Text, type TextColor, type TextProps, type TextSize, type TextSlot, type TextWeight, Textarea, type TextareaSlot, type TextareaVariants, ThumbsDownIcon, ThumbsUpIcon, 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, TimerIcon, type ToastAction, type ToastContextValue, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, ToggleGroupItem, Toolbar, type ToolbarProps, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, type TooltipSlot, TooltipTrigger, Trash2Icon, TrashIcon, TrashSolidIcon, TrendingDownIcon, TrendingUpIcon, UnderlineIcon, UploadIcon, type UseStopwatchReturn, UserCircleIcon, UserIcon, UsersIcon, type Variant, VideoIcon, VisuallyHidden, Volume2Icon, VolumeXIcon, WorkflowIcon, XCircleSolidIcon, XIcon, YEAR_DISPLAY_PLACEHOLDER, ZoomInIcon, ZoomOutIcon, alertVariants, applyMask, applyYearMask, assetPath, attachmentChipVariants, badgeVariants, brandLabel, brandScope, buttonVariants, cardVariants, cn, createIcon, dateToIso, displayToIso, fileTypeBadgeVariants, fileTypeFromName, filterChipVariants, formatClock, formatCurrency, formatDuration, getAssetBasePath, getFlagEmoji, iconTileVariants, inputVariants, isoToDate, isoToDisplay, isoToYear, labelVariants, parseDuration, parsePhoneForEditing, progressBarVariants, progressRingVariants, searchInputVariants, serviceToneLabel, serviceToneStyle, setAssetBasePath, sidebarLinkBadgeVariants, spinnerVariants, starRatingVariants, statusDotVariants, suiteProgressFillVariants, textareaVariants, useBrandScope, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };
+/**
+ * Theme scope — the host dimensions a subtree renders with (W5-02).
+ *
+ * The design system's scopes are DOM attributes: `[data-ds-scheme]`,
+ * `[data-ds-brand]`, `[data-ds-density]`, `dir`, and the `--ds-*` style a
+ * runtime brand writes (`createBrandTheme`). Set on the document root they
+ * reach everything, portalled overlays included. Set on a *subtree* they stop
+ * at the subtree: a Dialog or Popover opened from inside it renders in
+ * `document.body`, outside the scope, and comes up in the root theme.
+ *
+ * `ThemeScope` fixes that. It stamps the attributes on its own element, as a
+ * hand-written scope would, **and** registers them in context, so the shared
+ * `Portal` (`primitives/behavior/portal.tsx`) can re-stamp the same attributes
+ * and runtime-brand style on the container wrapper it mounts portalled content
+ * into. Nested scopes merge: a `density="compact"` scope inside a `brand="tax"`
+ * one propagates both.
+ *
+ * Apps that scope the document root need none of this; the portal path is
+ * unchanged for them (no wrapper is created).
+ */
+/** The scheme a subtree renders with (`[data-ds-scheme]`). */
+type ThemeScheme = "light" | "dark";
+/** A built-in brand scope (`[data-ds-brand]`). */
+type ThemeBrand = "pro" | "audit" | "books" | "tax";
+/** The density scope (`[data-ds-density]`, W2-06). */
+type ThemeDensity = "comfortable" | "compact";
+/** Text direction (`dir`). */
+type ThemeDirection = "ltr" | "rtl";
+/**
+ * The dimensions a scope sets. Every field is optional; an unset field is
+ * inherited from the enclosing scope, then from the document.
+ *
+ * @experimental
+ */
+interface ThemeScopeValue {
+    scheme?: ThemeScheme;
+    brand?: ThemeBrand;
+    density?: ThemeDensity;
+    dir?: ThemeDirection;
+    /**
+     * A registered runtime brand: the object `createBrandTheme()` returns. It is
+     * applied as inline `--ds-*` style on the scope element and re-applied on
+     * portalled content.
+     */
+    brandTheme?: BrandTheme;
+}
+/** Props of {@link ThemeScope}. @experimental */
+interface ThemeScopeProps extends ThemeScopeValue, Omit<React.HTMLAttributes<HTMLDivElement>, "dir"> {
+    children?: ReactNode;
+}
+/**
+ * A `<div>` that scopes the host dimensions of its subtree — scheme, brand,
+ * density, direction and a runtime brand — and propagates them into every
+ * overlay opened from inside it (Dialog, Sheet, Popover, Tooltip, menus,
+ * Select, Toast …), which would otherwise render in the document's theme.
+ *
+ * ```tsx
+ * <ThemeScope brand="tax" density="compact">
+ *   <Popover>…</Popover>   // its content renders as compact Tax, too
+ * </ThemeScope>
+ *
+ * <ThemeScope brandTheme={createBrandTheme({ brand: firm.primary })}>
+ *   <Dialog>…</Dialog>     // the runtime brand follows the dialog to <body>
+ * </ThemeScope>
+ * ```
+ *
+ * Nothing changes for apps that scope `<html>` or `<body>`: no wrapper is
+ * created around portalled content when no `ThemeScope` encloses it.
+ *
+ * @experimental W5-02. The public shape follows decision D7 for the runtime
+ * brand seed.
+ */
+declare const ThemeScope: React$1.ForwardRefExoticComponent<ThemeScopeProps & React$1.RefAttributes<HTMLDivElement>>;
+
+export { AIReceiptPanel, type AIReceiptPanelProps, type AIReceiptResult, Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActivityDotVariant, ActivityEventItem, type ActivityEventItemProps, ActivityItem, type ActivityItemProps, ActivityList, type ActivityListProps, type AgreementFirm, AgreementPaneHeading, type AgreementPaneHeadingProps, type AgreementStatus, type AgreementStep, AgreementViewer, type AgreementViewerProps, AiDraftCard, type AiDraftCardProps, type AiDraftState, Alert, AlertDescription, AlertDialog, AlertDialogAction, type AlertDialogActionProps, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogSlot, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppHeader, AppHeaderActions, type AppHeaderActionsProps, AppHeaderBreadcrumb, type AppHeaderBreadcrumbProps, type AppHeaderProps, AppHeaderSearch, type AppHeaderSearchProps, AppHeaderTitle, type AppHeaderTitleProps, AreaChart, type AreaChartProps, type AreaPoint, AspectRatio, Assignee, AssureAuditBrandIcon, AssureBooksBrandIcon, AssureProBrandIcon, AssureTaxBrandIcon, AttachmentChip, type AttachmentChipProps, AttentionItem, type AttentionItemProps, type AttentionUrgency, Avatar, type AvatarProps, type AvatarSlot, BRAND_PRODUCTS, Badge, type BadgeAppearance, type BadgeAppearanceInput, type BadgeLegacyVariant, type BadgeProps, type BadgeShape, type BadgeSize, type BadgeSlot, type BadgeVariant, type BadgeVariantsProps, Blockquote, BottomNav, type BottomNavProps, type BottomNavTab, type BrandIconProps, type BrandProduct, BrandScope, type BrandScopeProps, BrandScopeProvider, Breadcrumb, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, BulkActionBar, BulkActionBarAction, type BulkActionBarActionProps, type BulkActionBarProps, BulkActionBarSeparator, type BulkActionBarVariant, Button, type ButtonEmphasis, type ButtonIconProps, type ButtonIconSize, type ButtonIntent, type ButtonIntentAlias, type ButtonLegacyVariant, type ButtonLook, type ButtonProps, type ButtonSize, type ButtonSizeAlias, type ButtonSlot, type ButtonStyle, type ButtonVariant, type ButtonVariantsProps, COUNTRY_CODES, Calendar, type CalendarBaseProps, type CalendarCaptionLayout, type CalendarHighlight, type CalendarHighlightColor, type CalendarProps, type CalendarRange, type CalendarRangeProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, type CardSlot, CardTitle, type CardTitleProps, type CardVariants, CategoryDivider, type CategoryDividerProps, CategoryTag, type CategoryTagProps, type CategoryTone, type CellValue, type ChannelTabItem, ChannelTabs, type ChannelTabsProps, type ChannelTone, Checkbox, type CheckboxChecked, type CheckboxProps, type CheckboxSlot, Chip, type ChipIntent, type ChipProps, type ChipSize, type ChipSlot, type ChipStyle, type ChipVariant, ClientRailGroupHeader, type ClientRailGroupHeaderProps, ClientRailItem, type ClientRailItemProps, ClientSelect, type ClientSelectOption, Code, type CodeProps, type CodeSlot, type CodeVariant, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, type ComboboxBaseProps, type ComboboxClassNames, ComboboxMessages, type ComboboxMultipleProps, type ComboboxOptionState, type ComboboxProps, type ComboboxSelectionControls, type ComboboxSingleProps, type ComboboxSize, type ComboboxSlot, ComingSoon, type ComingSoonProps, type CommandItem, CommandPalette, ConfirmActionButton, type ConfirmActionButtonProps, Content, type ContentProps, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, type ContextMenuSlot, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ControlSize, CopyButton, type CountryCode, CountryFlag, CountrySelect, DATE_DISPLAY_PLACEHOLDER, DEFAULT_COMBOBOX_MESSAGES, DEFAULT_PHONE_FIELD_MESSAGES, DangerAction, type DangerActionProps, Dash, DashGrid, type DashGridProps, type DashWidget, DataItem, DataTable, DataTableBody, type DataTableBodyProps, DataTableCell, DataTableCellDue, type DataTableCellDueProps, DataTableCellId, DataTableCellMono, DataTableCellName, type DataTableCellProps, DataTableCheckbox, type DataTableCheckboxProps, DataTableHead, type DataTableHeadProps, DataTableHeader, type DataTableHeaderProps, DataTablePagination, type DataTablePaginationProps, type DataTableProps, DataTableResultsCount, type DataTableResultsCountProps, DataTableRow, type DataTableRowProps, DataTableSearch, type DataTableSearchProps, type DataTableSlot, DataTableSpacer, type DataTableSpacerProps, DataTableToolbar, type DataTableToolbarProps, DataTableView, type DataTableViewColumn, type DataTableViewFilter, type DataTableViewProps, type DataTableViewSelection, type DatePattern, DatePicker, type DatePickerProps, type DateRangeNames, DateRangePicker, type DateRangePickerProps, type DateRangeValue, DetailGrid, type DetailGridProps, DetailMain, type DetailMainProps, DetailSpine, DetailSpineHeader, type DetailSpineHeaderProps, type DetailSpineProps, DetailSpineSection, type DetailSpineSectionProps, DetailSpineStats, type DetailSpineStatsProps, Dialog, DialogBody, type DialogBodyProps, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, type DialogHeight, type DialogMessages, DialogOverlay, DialogPortal, type DialogSize$1 as DialogSize, type DialogSlot, DialogTitle, DialogTrigger, DismissibleChip, DisplayMenu, type DisplayMenuOption, type DisplayMenuProps, type DisplayMenuSection, DocumentChecklist, type DocumentChecklistFile, type DocumentChecklistItem, type DocumentChecklistProps, type DocumentChecklistStatus, DocumentDetailActions, type DocumentDetailActionsProps, DocumentDetailBody, type DocumentDetailBodyProps, DocumentDetailHeader, type DocumentDetailHeaderProps, DocumentDetailMetaRow, type DocumentDetailMetaRowProps, DocumentDetailPanel, type DocumentDetailPanelProps, DocumentDetailRequester, type DocumentDetailRequesterProps, DocumentDetailTitle, type DocumentDetailTitleProps, DocumentFileCard, type DocumentFileCardProps, DocumentFileLine, type DocumentFileLineProps, DocumentFileRow, type DocumentFileRowProps, type DocumentItemState, DocumentList, type DocumentListProps, DocumentListSection, type DocumentListSectionProps, type DocumentRequestActivityKind, type DocumentRequestAssigneeOption, DocumentRequestCard, type DocumentRequestCardProps, DocumentRequestDetail, type DocumentRequestDetailActivityEvent, type DocumentRequestDetailComment, type DocumentRequestDetailDoc, type DocumentRequestDetailProps, type DocumentRequestDetailTab, DocumentRequestField, type DocumentRequestFieldProps, type DocumentRequestItemSummary, type DocumentRequestRequestedItem, type DocumentRequestReviewStatusOption, type DocumentRequestTone, DocumentRequestUpload, type DocumentRequestUploadFile, type DocumentRequestUploadProps, DocumentRow, type DocumentRowProps, type DocumentSource, DocumentSourceFilter, type DocumentSourceFilterProps, type DocumentSourceFilterValue, DocumentSourceTag, type DocumentSourceTagProps, DocumentsWorkspaceLayout, type DocumentsWorkspaceLayoutProps, DonutChart, type DonutChartProps, type DonutSegment, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, type DropdownMenuSlot, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmailMessageCard, type EmailMessageCardProps, EmptyState, type EmptyStateProps, EngagementCard, type EngagementCardProps, EngagementTimeline, type EngagementTimelineProps, EngagementTimelineStep, type EngagementTimelineStepProps, Eyebrow, type EyebrowProps, Field, FieldControl, type FieldControlProps, type FieldControlWiring, FieldDescription, type FieldDescriptionProps, FieldError, type FieldErrorProps, FieldMessages, type FieldOrientation, type FieldProps, type FieldSlot, Fieldset, FieldsetLegend, type FieldsetLegendProps, type FieldsetProps, type FieldsetSlot, FileChip, type FileChipProps, type FileKind, FileTypeBadge, type FileTypeBadgeProps, type FileTypeTone, FileUpload, FileUploadMessages, type FileUploadProps, type FileUploadSlot, type FileUploadVariant, FilterChip, type FilterChipProps, type FolderNode, FolderTree, type FolderTreeProps, FormError, FormSection, FormSuccess, Grid, type GridColumn, type GridInputType, type GridProps, type GridRow, type GridValue, Heading, type HeadingLevel, type HeadingProps, type HeadingSize, type HeadingSlot, HoverCard, HoverCardContent, HoverCardPortal, HoverCardTrigger, ICON_TILE_TONE_TO_INTENT, IconAction, type IconActionProps, IconButton, type IconButtonProps, type IconButtonSize, type IconButtonSlot, type IconButtonTooltipSide, IconTile, type IconTileIntent, type IconTileProps, type IconTileSize, type IconTileSuiteTone, type IconTileTone, type IconTileVariantProps, Inline, type InlineProps, type InlineSlot, Input, type InputProps$1 as InputProps, type InputSize, type InputSizeAlias, type InputSlot, type InputVariant, type InputVariants, type InputVariantsOptions, Intent, IntentBadge, type IntentBadgeProps, type IntentTone, Kanban, KanbanCard, type KanbanCardProps, KanbanColumn, type KanbanColumnProps, type KanbanProps, Kbd, type KbdGlyph, KbdHint, type KbdHintProps, type KbdProps, type KbdSlot, type KbdVariant, type KeyboardShortcut, type KeyboardShortcutSection, KeyboardShortcutsDialog, type KeyboardShortcutsDialogProps, KpiCard, type KpiCardProps, type KpiDelta, Label, type LabelSlot, type LayoutAlign, type LayoutBreakpoint, type LayoutGap, type LayoutJustify, LinkAction, type LinkActionProps, LinkButton, type LinkButtonProps$1 as LinkButtonProps, type LinkButtonSlot, LoadingRows, Logo, Main, type MainProps, MasterDetailLayout, type MasterDetailLayoutProps, MessageBubble, MessageBubbleAction, type MessageBubbleActionProps, type MessageBubbleProps, MessageBubbleTombstone, type MessageBubbleTombstoneProps, MessageComposer, type MessageComposerProps, MetadataGrid, type MissingDocumentItem, MissingDocumentsPanel, type MissingDocumentsPanelProps, MoneyCell, MultiFilterPill, MultiSelect, MultiSelectField, type MultiSelectProps, MutedSpec, type MutedSpecProps, NewMenu, type NewMenuAction, type NewMenuGroup, type NewMenuProps, NotificationFilter, type NotificationFilterProps, type NotificationFilterValue, NotificationItem, type NotificationItemProps, NotificationList, type NotificationListProps, NotificationPanel, NotificationPanelFooter, type NotificationPanelFooterProps, NotificationPanelHeader, type NotificationPanelHeaderProps, type NotificationPanelProps, NumberInput, type NumberInputProps, type NumberInputSlot, Numeric, type NumericProps, OTPInput, type OTPInputProps, type OnlyStatuses, type Option, type OptionAccessors, PROGRESS_LEGACY_TO_INTENT, PageHeader, type PageHeaderProps, PageHeaderSep, type PageHeaderSepProps, PageHeaderSpec, type PageHeaderSpecProps, Pagination, type PaginationProps, type PaginationSlot, PdfPreview, type PdfPreviewProps, PhoneCountryInput, PhoneField, type PhoneFieldChangeDetails, type PhoneFieldMessages, type PhoneFieldProps, type PhoneFieldSlot, PhoneInput, type PillStatus, Popover, PopoverAnchor, PopoverClose, PopoverContent, PopoverPortal, type PopoverSlot, PopoverTrigger, Pressable, type PressableProps, type PressableSlot, PrimaryAction, type PrimaryActionProps, type Priority, PriorityIcon, type PriorityIconProps, ProgressBar, type ProgressBarProps, type ProgressBarVariant, type ProgressBarVariantProps, type ProgressIntent, type ProgressLegacyColour, ProgressRing, type ProgressRingProps, type ProgressRingVariant, type ProgressRingVariantProps, ProposalAddOn, type ProposalAddOnProps, type ProposalBillingMode, type ProposalBillingRow, ProposalBillingTerms, type ProposalBillingTermsProps, ProposalConsentGate, type ProposalConsentGateProps, ProposalCustomPage, type ProposalCustomPageKind, type ProposalCustomPageProps, ProposalNote, type ProposalNoteProps, ProposalPackageCard, type ProposalPackageCardProps, type ProposalPackageMode, ProposalPaymentCapture, type ProposalPaymentCaptureProps, ProposalPricingSummary, type ProposalPricingSummaryProps, ProposalServiceRow, type ProposalServiceRowProps, ProposalSignatureBlock, type ProposalSignatureBlockProps, type ProposalSigner, ProposalSignerList, type ProposalSignerListProps, type ProposalSignerStatus, type QuestionAddressValue, type QuestionFileValue, type QuestionHelp, type QuestionLabeledColumn, type QuestionLabeledRow, type QuestionLabeledValue, type QuestionNameValue, type QuestionOption, type QuestionTableColumn, type QuestionTableRow, type QuestionType, QuestionnairePanel, type QuestionnairePanelGroup, type QuestionnairePanelProps, type QuestionnairePanelSection, type QuestionnairePanelStatus, Questions, type QuestionsProps, type QuickReplyChip, RadioGroup, type RadioGroupAppearance, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, type RadioGroupSlot, type RankedBar, RankedBars, type RankedBarsProps, type Responsive, ResponsiveDialog, type ResponsiveDialogProps, RouteTransition, type RouteTransitionProps, SERVICE_TONES, SPINNER_TONE_TO_INTENT, STATUS_DOT_TONE_TO_INTENT, ScrollArea, ScrollBar, SearchInput, SearchInputMessages, type SearchInputProps, type SearchInputSize, type SearchInputSlot, type SearchInputVariants, type SearchInputVariantsOptions, SearchSelect, type SearchSelectOption, type SearchSelectProps, SecondaryAction, type SecondaryActionProps, Section, SectionHead, SectionHeader, SegmentedProgress, type SegmentedProgressProps, type SegmentedServiceTone, type SegmentedTone, Select, type SelectClassNames, SelectContent, type SelectContentProps, SelectGroup, SelectItem, SelectLabel, SelectMessages, type SelectOption, type SelectProps, SelectRoot, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, type SelectSize, type SelectSlot, SelectTrigger, type SelectTriggerProps, SelectValue, SelectableKpiCard, type SelectableKpiCardProps, Separator, type ServiceTone, Shape, Sheet, SheetBody, type SheetBodyProps, SheetClose, SheetContent, type SheetContentProps, SheetDescription, SheetFooter, SheetHeader, type SheetMessages, SheetOverlay, SheetPortal, type SheetSide, type SheetSize, type SheetSlot, SheetTitle, SheetTrigger, type SheetWidth, Shell, type ShellProps, type ShellSlot, SideDrawer, type SideDrawerSlot, Sidebar, SidebarBrand, type SidebarBrandProps, SidebarBrandSwitcher, type SidebarBrandSwitcherExtra, type SidebarBrandSwitcherItem, type SidebarBrandSwitcherProps, type SidebarBrandSwitcherSlot, SidebarBrandSwitcherTile, SidebarBrandText, type SidebarBrandTextProps, SidebarFooter, type SidebarFooterProps, SidebarLink, SidebarLinkAction, type SidebarLinkActionProps, SidebarLinkBadge, type SidebarLinkBadgeProps, type SidebarLinkBadgeVariants, SidebarLinkGroup, type SidebarLinkGroupProps, SidebarLinkLabel, type SidebarLinkLabelProps, type SidebarLinkProps, SidebarPinButton, type SidebarPinButtonProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarSection, type SidebarSectionProps, type SidebarSlot, type SidebarState, SidebarTrigger, type SidebarTriggerProps, SidebarUser, type SidebarUserProps, SignatureEditor, type SignatureEditorProps, Skeleton, SkeletonCircle, SkeletonText, Slider, type SliderProps, type SliderSize, type SortDirection, Spinner, type SpinnerIntent, type SpinnerProps, type SpinnerSize, type SpinnerTone, type SpinnerVariantProps, SpreadsheetPreview, type SpreadsheetPreviewProps, Stack, type StackDirection, type StackProps, type StackSlot, StackedBarChart, type StackedBarChartProps, type StackedBarDatum, type StackedBarSeries, StagePill, StarRating, type StarRatingProps, Stat, StatusBadge, type StatusBadgeProps, type StatusBadgeSlot, StatusDot, type StatusDotIntent, type StatusDotProps, type StatusDotSize, type StatusDotTone, type StatusDotVariantProps, StatusIcon, type StatusIconProps, type StatusMap, StatusPill, type StatusPillProps, type StatusPresentation, type StatusState, type Step, Stepper, type StepperProps, StickyActionBar, type StickyActionBarProps, StickyStack, StickyStackLayer, type StickyStackLayerProps, type StickyStackProps, StickyStackSectionHeader, type StickyStackSectionHeaderProps, StickyStackSticky, type StickyStackStickyProps, SubmitButton, SuggestionPills, type SuggestionPillsProps, SuiteProgress, type SuiteProgressFillVariantProps, type SuiteProgressProps, type SuiteProgressSize, type SuiteProgressSuiteTone, type SuiteProgressTone, Surface, type SurfaceElevation, type SurfacePadding, type SurfaceProps, type SurfaceRadius, type SurfaceSlot, Switch, type SwitchProps, type SwitchSize, type SwitchSlot, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, type TableProps, TableRow, type TableRowData, type TableRowProps, type TableSlot, type TableTone, Tabs, TabsContent, TabsList, TabsTrigger, TagsCell, TeamMemberSelect, Text, type TextColor, type TextProps, type TextSize, type TextSlot, type TextWeight, Textarea, type TextareaProps, type TextareaSize, type TextareaSlot, type TextareaVariant, type TextareaVariants, type TextareaVariantsOptions, type ThemeBrand, type ThemeDensity, type ThemeDirection, type ThemeScheme, ThemeScope, type ThemeScopeProps, type ThemeScopeValue, TimeLogger, TimeLoggerActions, type TimeLoggerActionsProps, TimeLoggerBillable, type TimeLoggerBillableProps, TimeLoggerContextRow, type TimeLoggerContextRowProps, TimeLoggerEntry, TimeLoggerEntryList, type TimeLoggerEntryListProps, type TimeLoggerEntryProps, TimeLoggerField, type TimeLoggerFieldProps, TimeLoggerFooter, type TimeLoggerFooterProps, TimeLoggerHeader, type TimeLoggerHeaderProps, TimeLoggerNotes, type TimeLoggerNotesProps, type TimeLoggerPhase, type TimeLoggerProps, type TimeLoggerTier, TimeLoggerTimer, type TimeLoggerTimerProps, type TimelineState, type ToastAction, type ToastContextValue, type ToastOptions, ToastProvider, type ToastSlot, type ToastVariant, ToggleGroup, type ToggleGroupFormProps, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleGroupSize, type ToggleGroupVariant, Toolbar, type ToolbarProps, Tooltip, TooltipContent, TooltipPortal, TooltipProvider, type TooltipSlot, TooltipTrigger, type UseFieldControlProps, type UseStopwatchReturn, Variant, VisuallyHidden, YEAR_DISPLAY_PLACEHOLDER, alertVariants, applyMask, applyYearMask, assetPath, attachmentChipVariants, badgeVariants, brandLabel, brandScope, buttonVariants, cardVariants, chipVariants, cn, dateToIso, defineStatusMap, displayToIso, fileTypeBadgeVariants, fileTypeFromName, filterChipVariants, formatClock, formatCurrency, formatDuration, getAssetBasePath, getFlagEmoji, iconButtonVariants, resolveIconTileVariants as iconTileVariants, inputVariants, isoToDate, isoToDisplay, isoToYear, labelVariants, parseDuration, parsePhoneForEditing, progressBarVariants, progressRingVariants, resolveBadgeAppearance, resolveButtonStyle, resolveChipStyle, searchInputVariants, serviceToneLabel, serviceToneStyle, setAssetBasePath, sidebarLinkBadgeVariants, spinnerVariants, starRatingVariants, statusDotVariants, suiteProgressFillVariants, textareaVariants, useBrandScope, useFieldControl, useSidebarPeekLock, useSidebarState, useStopwatch, useToast, yearToIso };