@cascivo/react 0.18.0 → 1.1.0

package/dist/index.d.ts

@@ -4,7 +4,8 @@
  * Quickstart:
  *   pnpm add @cascivo/react @preact/signals-react
  *   // @cascivo/themes is installed with @cascivo/react. Once, in your entry file:
- *   import '@cascivo/themes/all.css'   // tokens + base + light & dark — REQUIRED for color
+ *   import '@cascivo/themes/light-dark.css'   // tokens + base + light & dark — REQUIRED for color
+ *   // all.css is all TWELVE themes (~2x the CSS) — use it only if you ship a theme picker
  *   // No-bundler / single-file alternative (themes bundled in): '@cascivo/react/styles.css'
  *   import { Button, Card } from '@cascivo/react'
  *
@@ -21,8 +22,87 @@
  * Docs: https://cascivo.com/llms.txt — or fully offline, no website needed:
  *   npx -y @cascivo/docs            (index; `npx @cascivo/docs <component>` for one doc)
  */
-import { AnchorHTMLAttributes, ButtonHTMLAttributes, FormHTMLAttributes, HTMLAttributes, ImgHTMLAttributes, InputHTMLAttributes, LabelHTMLAttributes, LiHTMLAttributes, MouseEvent, ReactElement, ReactNode, RefObject, SelectHTMLAttributes, TextareaHTMLAttributes, TimeHTMLAttributes } from "react";
-import { DismissableLayer, DismissableLayerProps, ErrorBoundary, FocusScope, LinkComponent, LinkComponentProps, Machine, MachineConfig, Portal, Presence, ProgressInput, RovingOrientation, Signal, Slot, SlotProps, SpaceStep, SuspenseBoundary, ThemeProvider, ThemeProviderProps, ToneInput, UseClipboardOptions, UseClipboardReturn, UseControllableSignalOptions, UseDisclosureOptions, UseDisclosureReturn, VisuallyHidden, VisuallyHiddenProps, applyTheme, batch, cn, composeRefs, computePosition, computed, createMachine, createScope, createStreamBuffer, effect, getLinkComponent, mergeProps, setLinkComponent, setTheme, signal, themePreloadScript, themeSignal, useAnchorPosition, useClipboard, useComputed, useControllableSignal, useDisclosure, useEffectPropSignal, useId, useMachine, useMediaQuery, useRovingFocus, useScope, useScrollLock, useSignal, useSignalEffect, useSignals, useStreamBuffer, useTheme, useTypeahead } from "@cascivo/core";
+import {
+  AnchorHTMLAttributes,
+  ButtonHTMLAttributes,
+  FormHTMLAttributes,
+  HTMLAttributes,
+  ImgHTMLAttributes,
+  InputHTMLAttributes,
+  LabelHTMLAttributes,
+  LiHTMLAttributes,
+  MouseEvent,
+  ReactElement,
+  ReactNode,
+  RefObject,
+  SelectHTMLAttributes,
+  TextareaHTMLAttributes,
+  TimeHTMLAttributes,
+} from "react";
+import {
+  DismissableLayer,
+  DismissableLayerProps,
+  ErrorBoundary,
+  FocusScope,
+  LinkComponent,
+  LinkComponentProps,
+  Machine,
+  MachineConfig,
+  Portal,
+  Presence,
+  ProgressInput,
+  RovingOrientation,
+  Signal,
+  Slot,
+  SlotProps,
+  SpaceStep,
+  SuspenseBoundary,
+  ThemeProvider,
+  ThemeProviderProps,
+  ToneInput,
+  UseClipboardOptions,
+  UseClipboardReturn,
+  UseControllableSignalOptions,
+  UseDisclosureOptions,
+  UseDisclosureReturn,
+  VisuallyHidden,
+  VisuallyHiddenProps,
+  applyTheme,
+  batch,
+  cn,
+  composeRefs,
+  computePosition,
+  computed,
+  createMachine,
+  createScope,
+  createStreamBuffer,
+  effect,
+  getLinkComponent,
+  mergeProps,
+  setLinkComponent,
+  setTheme,
+  signal,
+  themePreloadScript,
+  themeSignal,
+  useAnchorPosition,
+  useClipboard,
+  useComputed,
+  useControllableSignal,
+  useDisclosure,
+  useEffectPropSignal,
+  useId,
+  useMachine,
+  useMediaQuery,
+  useRovingFocus,
+  useScope,
+  useScrollLock,
+  useSignal,
+  useSignalEffect,
+  useSignals,
+  useStreamBuffer,
+  useTheme,
+  useTypeahead,
+} from "@cascivo/core";
 
 /**
  * Button.
@@ -36,7 +116,8 @@ import { DismissableLayer, DismissableLayerProps, ErrorBoundary, FocusScope, Lin
  */
 interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
   /**
-   * Selects the visual style variant.
+   * `primary` for the main action, `secondary` for a supporting one, `ghost` for a
+   * borderless action in dense UI, `destructive` for anything that deletes.
    *
    * @defaultValue `primary`
    * @see the component manifest
@@ -66,6 +147,20 @@ interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
  */
 declare const Button: import("react").ForwardRefExoticComponent<ButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   label?: string;
   hint?: string;
   error?: string;
@@ -81,7 +176,8 @@ interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>
 declare const Input: import("react").ForwardRefExoticComponent<InputProps & import("react").RefAttributes<HTMLInputElement>>;
 interface CardProps extends HTMLAttributes<HTMLDivElement> {
   /**
-   * Selects the visual style variant.
+   * `default` draws a 1px border, `outlined` a heavier one, `elevated` drops the border for
+   * a shadow.
    *
    * @defaultValue `default`
    * @see the component manifest
@@ -233,16 +329,26 @@ interface SpinnerProps extends HTMLAttributes<HTMLSpanElement> {
    * @see the component manifest
    */
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
 }
 declare function Spinner({
   size,
   label,
+  ariaLabel,
   className,
   ...props
 }: SpinnerProps): import("react").JSX.Element;
 interface SeparatorProps extends HTMLAttributes<HTMLElement> {
   /**
-   * Layout orientation of the component.
+   * Direction the rule runs: `horizontal` draws a full-width line, `vertical` a full-height
+   * one that stretches to its flex row.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -262,9 +368,50 @@ declare function Separator({
   className,
   ...props
 }: SeparatorProps): import("react").JSX.Element;
+type LogoVariant = 'mark' | 'mark-accent' | 'horizontal' | 'stacked' | 'nav';
+interface LogoProps extends HTMLAttributes<HTMLSpanElement> {
+  /**
+   * The logo renders the mark and, in a lockup, the wordmark — there is no slot for
+   * anything else. `never` rather than `Omit<>` because omitting a key off
+   * `HTMLAttributes` loses the `style` widening that the signals JSX augmentation
+   * applies in an adopter's project, and the spread below then fails to compile there.
+   */
+  children?: never;
+  /**
+   * `mark` and `mark-accent` render the square alone; `horizontal`, `stacked` and `nav`
+   * add the wordmark. `nav` is the only lockup permitted below 24px.
+   *
+   * @defaultValue `mark`
+   * @see the component manifest
+   */
+  variant?: LogoVariant;
+  /**
+   * Mark height in px. Clamped to a 16px floor — below that the notch closes optically.
+   *
+   * @defaultValue `18` for `nav`, `32` otherwise
+   * @see the component manifest
+   */
+  size?: number;
+}
+/**
+ * The cascivo logo: the mark on its own, or one of the three sanctioned lockups.
+ *
+ * Renders inline SVG rather than an `<img>` on purpose — `currentColor` and
+ * `--cascivo-color-accent` only resolve when the SVG is part of the document, which is
+ * what lets the logo repaint with whatever `data-theme` subtree it is dropped into.
+ */
+declare function Logo({
+  variant,
+  size,
+  className,
+  style,
+  ...props
+}: LogoProps): import("react").JSX.Element;
 interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'> {
   /**
-   * Selects the visual style variant.
+   * Severity tone: `default` (neutral), `info`, `success`, `warning` or `destructive`. Sets
+   * the icon and the accent colour. Unlike Badge/Tag/Notification this is a private union,
+   * not `ToneInput` — the canonical `danger`/`neutral` spellings are not accepted here.
    *
    * @defaultValue `default`
    * @see the component manifest
@@ -430,10 +577,34 @@ declare function Image({
   ...rest
 }: ImageProps): import("react").JSX.Element;
 interface TextareaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   label?: string;
   hint?: string;
   error?: string;
   resize?: 'none' | 'vertical' | 'both';
+  /**
+   * Grow the control with its content instead of holding the fixed rows height. rows becomes
+   * the minimum and --cascivo-textarea-max-block-size (default 20lh) the ceiling. Pure CSS
+   * (field-sizing: content) — no measurement and no listener; where unsupported the fixed
+   * rows height is kept.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  autosize?: boolean;
 }
 /**
  * `forwardRef` so `ref` reaches the underlying `<textarea>` — and so it is TYPED.
@@ -471,6 +642,20 @@ interface SelectOption {
  * `NativeSelect`, spreads onto a real element and inherits that element's event.
  */
 interface SelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'size'> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   label?: string;
   hint?: string;
   error?: string;
@@ -486,6 +671,20 @@ interface SelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>, 'siz
  */
 declare const Select: import("react").ForwardRefExoticComponent<SelectProps & import("react").RefAttributes<HTMLSelectElement>>;
 interface CheckboxProps extends InputHTMLAttributes<HTMLInputElement> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   label?: string;
   /**
    * When true, renders the mixed/indeterminate state.
@@ -504,6 +703,20 @@ interface CheckboxProps extends InputHTMLAttributes<HTMLInputElement> {
  */
 declare const Checkbox: import("react").ForwardRefExoticComponent<CheckboxProps & import("react").RefAttributes<HTMLInputElement>>;
 interface RadioProps extends InputHTMLAttributes<HTMLInputElement> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   label?: string;
   value: string;
 }
@@ -535,6 +748,20 @@ declare function RadioGroup({
   children
 }: RadioGroupProps): import("react").JSX.Element;
 interface ToggleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   checked?: boolean;
   /**
    * Whether the control is checked on first render (uncontrolled).
@@ -545,8 +772,6 @@ interface ToggleProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'onC
   defaultChecked?: boolean;
   /** Called with the new checked state when the switch is toggled. */
   onValueChange?: (checked: boolean) => void;
-  /** @deprecated Use `onValueChange` — it receives the same `checked` boolean. */
-  onChange?: (checked: boolean) => void;
   /**
    * Renders a **visible** text label beside the switch that also becomes its
    * accessible name. When a visible heading already labels the control, omit
@@ -571,6 +796,20 @@ declare const Toggle: import("react").ForwardRefExoticComponent<ToggleProps & im
  * while this one inherits the underlying element's event.
  */
 interface SliderProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   label?: string;
 }
 /**
@@ -583,7 +822,7 @@ declare const Slider: import("react").ForwardRefExoticComponent<SliderProps & im
 interface TooltipProps {
   content: ReactNode;
   /**
-   * Placement relative to the trigger.
+   * Side of the trigger the tip opens on: `top`, `right`, `bottom` or `left`.
    *
    * @defaultValue `top`
    * @see the component manifest
@@ -604,19 +843,35 @@ declare function Tooltip({
   children,
   delay
 }: TooltipProps): import("react").JSX.Element;
-interface DropdownItem {
+/** A selectable row in a `Dropdown` menu. */
+interface DropdownMenuItem {
   label: string;
   value: string;
   icon?: ReactNode;
   disabled?: boolean;
-  separator?: boolean;
 }
+/**
+ * A horizontal rule between groups of items. Carries no data, takes no `label`/`value`, and
+ * is skipped by keyboard navigation and selection.
+ */
+interface DropdownSeparatorItem {
+  kind: 'separator';
+}
+/**
+ * A `Dropdown` entry: either a selectable item or a separator.
+ *
+ * The union is tagged on `kind` (the catalog convention — `type` is reserved for HTML-ish
+ * meanings), so a separator cannot carry data that would be silently discarded.
+ */
+type DropdownItem = DropdownMenuItem | DropdownSeparatorItem;
 interface DropdownProps {
   trigger: ReactElement;
   items: DropdownItem[];
   onSelect?: (value: string) => void;
   /**
-   * Placement relative to the trigger.
+   * Which trigger edge the menu aligns to. `bottom-start` hangs it from the trigger's start
+   * edge, `bottom-end` from its end edge — use `bottom-end` for a trigger near the end of
+   * the viewport.
    *
    * @defaultValue `bottom-start`
    * @see the component manifest
@@ -638,7 +893,9 @@ interface ToastOptions {
   title: string;
   description?: string;
   /**
-   * Selects the visual style variant.
+   * Severity tone: `default` (neutral), `success`, `warning` or `destructive`. Sets the icon
+   * and the accent colour. Unlike Badge/Tag/Notification this is a private union, not
+   * `ToneInput` — the canonical `danger`/`neutral` spellings are not accepted here.
    *
    * @defaultValue `default`
    * @see the component manifest
@@ -767,6 +1024,13 @@ declare function AccordionItem({
 declare const AccordionTrigger: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLElement> & import("react").RefAttributes<HTMLElement>>;
 declare function AccordionContent(props: HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;
 interface ActionSheetAction {
+  /**
+   * Stable identity, used as the React key. Without it the array index (or a repeatable
+   * `label`) is the key, so inserting or reordering entries re-uses the wrong DOM node — the
+   * defect `link-item-id-parity` exists to prevent, extended past link-shaped items on
+   * 2026-08-22.
+   */
+  id?: string;
   label: ReactNode;
   onSelect: () => void;
   /** Render in the destructive (danger) style. */
@@ -828,8 +1092,12 @@ declare function Kbd({
 }: KbdProps): import("react").JSX.Element;
 interface LinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
   /**
-   * `standalone` (default) owns its own typography and underlines on hover;
-   * `inline` inherits the surrounding prose font and is always underlined.
+   * `standalone` uses the system's own type and underlines on hover — for a link that stands
+   * on its own. `inline` inherits the surrounding prose font and stays underlined — for a
+   * link inside a paragraph.
+   *
+   * @defaultValue `standalone`
+   * @see the component manifest
    */
   variant?: 'standalone' | 'inline';
   size?: 'sm' | 'md' | 'lg';
@@ -887,12 +1155,21 @@ interface BreadcrumbProps {
    * @see the component manifest
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
 }
 declare function Breadcrumb({
   items,
   maxVisible,
   className,
-  ariaLabel
+  ariaLabel,
+  label
 }: BreadcrumbProps): import("react").JSX.Element;
 interface TocItem {
   /** id of the heading/section this entry links to (without the leading `#`) */
@@ -1045,6 +1322,13 @@ interface SideNavItem {
   }) => ReactNode;
 }
 interface SideNavGroup {
+  /**
+   * Stable identity, used as the React key. Without it the array index (or a repeatable
+   * `label`) is the key, so inserting or reordering entries re-uses the wrong DOM node — the
+   * defect `link-item-id-parity` exists to prevent, extended past link-shaped items on
+   * 2026-08-22.
+   */
+  id?: string;
   label?: string;
   items: SideNavItem[];
 }
@@ -1067,6 +1351,14 @@ interface SideNavProps {
    * @see the component manifest
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   /**
    * Accessible label for the collapse control.
    *
@@ -1097,6 +1389,8 @@ interface SideNavProps {
   showCollapseToggle?: boolean;
   /** Content rendered above the items, inside the item padding context. */
   header?: ReactNode;
+  /** Content rendered above the collapse toggle, inside the item padding context —
+   * it lines up with the nav items above it, exactly as `header` does. */
   footer?: ReactNode;
   className?: string;
 }
@@ -1107,6 +1401,7 @@ declare function SideNav({
   defaultCollapsed,
   onCollapsedChange,
   ariaLabel,
+  label,
   collapseLabel,
   expandLabel,
   expandOnHover,
@@ -1150,6 +1445,13 @@ declare function Pagination({
   className
 }: PaginationProps): import("react").JSX.Element;
 interface ProgressStep {
+  /**
+   * Stable identity, used as the React key. Without it the array index (or a repeatable
+   * `label`) is the key, so inserting or reordering entries re-uses the wrong DOM node — the
+   * defect `link-item-id-parity` exists to prevent, extended past link-shaped items on
+   * 2026-08-22.
+   */
+  id?: string;
   label: string;
   description?: string;
 }
@@ -1173,9 +1475,12 @@ declare function ProgressIndicator({
 }: ProgressIndicatorProps): import("react").JSX.Element;
 interface TagProps extends HTMLAttributes<HTMLSpanElement> {
   /**
-   * Severity tone. Accepts the catalog-wide `Tone` vocabulary
-   * (`neutral | info | success | warning | danger`) plus Tag's historical spellings
-   * (`default`, `error`, `destructive`).
+   * Severity tone. Accepts the catalog-wide `Tone` vocabulary (`neutral | info | success |
+   * warning | danger`) plus Tag's historical spellings (`default` → neutral,
+   * `error`/`destructive` → danger).
+   *
+   * @defaultValue `default`
+   * @see the component manifest
    */
   variant?: ToneInput;
   size?: 'sm' | 'md';
@@ -1199,7 +1504,8 @@ declare function Tag({
 }: TagProps): import("react").JSX.Element;
 interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
   /**
-   * Selects the visual style variant.
+   * Shape of the placeholder: `text` (stacked lines), `circle` (an avatar), `rect` (a
+   * block).
    *
    * @defaultValue `text`
    * @see the component manifest
@@ -1280,17 +1586,16 @@ interface FabAction {
   onSelect: () => void;
   disabled?: boolean;
 }
-interface FabProps {
+interface FabBaseProps {
   /** The main button icon. */
   children: ReactNode;
-  /** Accessible name for the main button (it is icon-only). */
-  label: string;
   /** Called on press when there is no speed-dial. Ignored when `actions` is set. */
   onClick?: () => void;
   /** Speed-dial actions revealed above the button when opened. */
   actions?: FabAction[];
   /**
-   * Position of the component.
+   * Screen corner the button is pinned to: `bottom-end` or `bottom-start`. Safe-area insets
+   * are honoured either way.
    *
    * @defaultValue `bottom-end`
    * @see the component manifest
@@ -1304,6 +1609,20 @@ interface FabProps {
   onOpenChange?: (open: boolean) => void;
   className?: string;
 }
+/**
+ * Exactly one of `label` / `ariaLabel` is required — the main button is icon-only, so a
+ * missing accessible name is a bug and stays enforced by the type rather than a dev warning.
+ * `ariaLabel` is the catalog's name for a string nothing paints; `Fab` predates the
+ * convention and shipped `label`, so both work and neither is deprecated. Same shape as
+ * `IconButton`.
+ */
+type FabProps = FabBaseProps & ({
+  label: string;
+  ariaLabel?: never;
+} | {
+  ariaLabel: string;
+  label?: never;
+});
 /**
  * Floating action button anchored to a screen corner. On its own it is a single
  * fixed button; given `actions` it becomes a speed-dial whose main button toggles a
@@ -1313,6 +1632,7 @@ interface FabProps {
  */
 declare function Fab({
   children,
+  ariaLabel,
   label,
   onClick,
   actions,
@@ -1347,7 +1667,8 @@ interface OverflowMenuProps {
   items: OverflowMenuItem[];
   onSelect?: (value: string) => void;
   /**
-   * Placement relative to the trigger.
+   * Which trigger edge the menu aligns to. `bottom-end` hangs it from the trigger's end edge
+   * (right in LTR), `bottom-start` from its start edge.
    *
    * @defaultValue `bottom-end`
    * @see the component manifest
@@ -1360,8 +1681,28 @@ interface OverflowMenuProps {
    * @see the component manifest
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   size?: 'sm' | 'md';
+  /**
+   * When true, disables the control and removes it from the tab order.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
   disabled?: boolean;
+  /**
+   * Tab-order position of the trigger. A composite widget that manages its own focus (a
+   * `DataTable` in grid keyboard mode) passes `-1` so the menu stays reachable by Enter on
+   * its cell without becoming an extra Tab stop.
+   */
+  tabIndex?: number;
   className?: string;
 }
 declare function OverflowMenu({
@@ -1369,17 +1710,29 @@ declare function OverflowMenu({
   onSelect,
   placement,
   ariaLabel,
+  label,
   size,
   disabled,
+  tabIndex,
   className
 }: OverflowMenuProps): import("react").JSX.Element;
 interface SearchProps {
+  /**
+   * Wired automatically by a wrapping `Field` — its label id. When present the control is
+   * already named from outside, so the built-in fallback name is not applied.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Wired automatically by a wrapping `Field` — the ids of its hint/error text. Forwarded to
+   * the focusable control so the supporting text is announced, not just displayed.
+   */
+  'aria-describedby'?: string;
+  /** Wired automatically by a wrapping `Field` when it is in an error state. */
+  'aria-invalid'?: boolean;
   value?: string;
   defaultValue?: string;
   /** Called with the current text on every keystroke. */
   onValueChange?: (value: string) => void;
-  /** @deprecated Use `onValueChange` — it receives the same string. */
-  onChange?: (value: string) => void;
   onSearch?: (value: string) => void;
   /**
    * Debounce delay (ms) before onSearch fires.
@@ -1406,6 +1759,16 @@ interface SearchProps {
    * @see the component manifest
    */
   label?: string;
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it and `label` would render that text a second time.
+   *
+   * `label` on this component is **visible**. `IconButton.label` and `Sparkline.label` are
+   * invisible names, so an adopter arriving with that prior writes `label` here and gets the
+   * text twice (2026-08-22 report item 13). Both props are listed side by side, each saying
+   * which it is.
+   */
+  ariaLabel?: string;
   /**
    * When true, disables the control and removes it from the tab order.
    *
@@ -1427,24 +1790,39 @@ declare function Search({
   value,
   defaultValue,
   onValueChange,
-  onChange,
   onSearch,
   debounceMs,
   placeholder,
   size,
   label,
+  ariaLabel,
   disabled,
   clearLabel,
   id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid,
   className
 }: SearchProps): import("react").JSX.Element;
 interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max' | 'step'> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   value?: number | null;
   defaultValue?: number;
   /** Called with the new numeric value (or null when cleared). */
   onValueChange?: (value: number | null) => void;
-  /** @deprecated Use `onValueChange` — it receives the same `number | null`. */
-  onChange?: (value: number | null) => void;
   min?: number;
   max?: number;
   /**
@@ -1482,12 +1860,94 @@ interface NumberInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, '
  * incomplete, which is why the rule is a guard and not a checklist.
  */
 declare const NumberInput: import("react").ForwardRefExoticComponent<NumberInputProps & import("react").RefAttributes<HTMLInputElement>>;
+/**
+ * Per-column filtering, kept pure so the table's filter pipeline is testable without a DOM
+ * and stays O(rows) per change — never per render.
+ *
+ * Three filter shapes cover what dashboards actually ask for (the same three TanStack's
+ * column-filtering guide leads with): a substring on text, a set of allowed values on an
+ * enumerated column, and a numeric range. Values arrive from the table's own inputs or from
+ * a controlled `filters` prop, so the shape is a plain serialisable object — it round-trips
+ * through a URL or storage unchanged.
+ */
+/** The kind of filter control a column offers. */
+type ColumnFilterKind = 'text' | 'select' | 'range';
+/** The current value of one column's filter. An inactive filter is simply absent. */
+type ColumnFilterValue = {
+  kind: 'text';
+  value: string;
+} | {
+  kind: 'select';
+  values: string[];
+} | {
+  kind: 'range';
+  min?: number;
+  max?: number;
+};
+/** Active filters by column key. */
+type ColumnFilters = Record<string, ColumnFilterValue>;
+/**
+ * Column layout as data: which columns show, in what order, how wide, and which stick to
+ * an edge. Every transition the header menu and the resize handle perform is a pure
+ * function here, so the table never reasons about layout in JSX and each rule is
+ * testable on its own.
+ *
+ * The shape is deliberately a plain object of keys (`ColumnState`): it round-trips through
+ * storage or a URL, and it survives the column definitions changing underneath it — a key
+ * that no longer exists is ignored, a new column simply takes its definition position.
+ */
+/** Which edge a pinned column sticks to. */
+type PinSide = 'start' | 'end';
+/** User-adjustable column layout. All fields optional; an absent field means "as defined". */
+interface ColumnState {
+  /** Keys of hidden columns. At least one column always stays visible. */
+  hidden?: string[];
+  /** Display order of column keys; keys not listed follow in definition order. */
+  order?: string[];
+  /** Explicit widths in px, by key — what the resize handle writes. */
+  widths?: Record<string, number>;
+  /** Pinned columns by key. Pinned-start columns render first, pinned-end last. */
+  pinned?: Record<string, PinSide>;
+}
+/**
+ * Row grouping, aggregation and column-group spans as data. The table's body is a flat
+ * list either way — grouping just interleaves group rows with the leaf rows they own, so
+ * paging, the virtual window and the grid keyboard model need no notion of a tree.
+ */
+/** Built-in aggregations for `Column.aggregate`. */
+type AggregateKind = 'sum' | 'avg' | 'min' | 'max' | 'count';
+/** A band of columns under one header (`columnGroups`). */
+interface ColumnGroup {
+  header: string;
+  /** Column keys in the band. Non-adjacent keys render as separate spans. */
+  columns: string[];
+}
 interface Column<Row> {
   key: string;
   header: string;
   sortable?: boolean;
   render?: (row: Row) => ReactNode;
   align?: 'start' | 'end';
+  /**
+   * Offer a per-column filter in a row under the header: `'text'` is a substring input,
+   * `'select'` a faceted checklist of the column's distinct values with counts, `'range'` a
+   * numeric min/max pair. Filters AND together and combine with the global search; the
+   * current values are readable and controllable through the `filters` props.
+   */
+  filter?: ColumnFilterKind;
+  /**
+   * Let the user edit this column's cells in place. Each cell renders an `Editable`
+   * (click, Enter or F2 to start; Enter commits, Escape cancels) and commits through the
+   * table's `onCellEdit`. Ignored when the column has a `render` — a custom cell brings its
+   * own control — or the table has no `onCellEdit`.
+   */
+  editable?: boolean;
+  /**
+   * What a group row and the `totals` row show for this column: a built-in reduction over
+   * the numeric cell values (`'count'` counts rows), or a function of the rows for anything
+   * else — a formatted currency, a distinct count, a sparkline.
+   */
+  aggregate?: AggregateKind | ((rows: Row[]) => ReactNode);
   /**
    * Preferred column width, any CSS length (`'8rem'`, `'120px'`, `'12%'`). Set it on
    * identifier-shaped columns (ids, statuses, dates) so they stop stealing space from the
@@ -1503,6 +1963,11 @@ interface Column<Row> {
    * dropped. Leave at least one free-form column unsized unless you specifically want
    * page-stable widths.
    *
+   * You do not have to get this right by arithmetic: the table **measures** its own overflow
+   * and warns in dev with the real `scrollWidth`/`clientWidth` and the sized columns to
+   * change. In production a scrolling shadow marks the cut edge. The rules of thumb below are
+   * a starting point, not something to compute against a container width you cannot see.
+   *
    * ⚠ **"Leave one unsized" is necessary, not sufficient.** The leftover width is split
    * between the unsized columns by `table-layout: auto`, which weighs them by content — so
    * if the sized columns nearly fill the table, what remains can be narrower than the
@@ -1520,10 +1985,64 @@ interface Column<Row> {
   minWidth?: string;
 }
 type SortDirection = 'asc' | 'desc';
-interface SortState {
+/** One sorted column. */
+interface SortKey {
   key: string;
   direction: SortDirection;
 }
+/**
+ * The active sort. `thenBy` lists the secondary columns that break ties, in order — set
+ * by Shift-clicking headers when `multiSort` is on, or passed directly.
+ */
+interface SortState extends SortKey {
+  thenBy?: SortKey[];
+}
+/** One entry in a row's actions menu (`rowActions`). */
+interface RowAction<Row> {
+  id: string;
+  label: string;
+  /** Activation handler; receives the row the menu belongs to. */
+  onSelect: (row: Row) => void;
+  destructive?: boolean;
+  disabled?: boolean;
+  icon?: ReactNode;
+}
+/** Everything the table needs the server to apply, when `server` is set. */
+interface TableQuery {
+  sort: SortState | undefined;
+  /** Trimmed global search text; empty when the box is blank. */
+  search: string;
+  filters: ColumnFilters;
+  /** 1-based page. */
+  page: number;
+  pageSize: number;
+}
+/**
+ * Server-driven mode: the table renders `rows` as the current page verbatim and asks the
+ * server for anything that would change them. Sort, search, per-column filters and paging
+ * all stop running on the client at once — one switch, not four.
+ */
+interface DataTableServer {
+  /** Total rows across every page; drives the pager and the range label. */
+  totalItems?: number;
+  /**
+   * Called with the full query whenever sort, search, a filter, the page or the page size
+   * changes. Not called on mount: the rows you passed for the initial render are the first
+   * page.
+   */
+  onQueryChange: (query: TableQuery) => void;
+}
+/** Which column-layout controls the table offers. All off by default. */
+interface ColumnSettings {
+  /** A "Columns" menu in the toolbar that shows and hides columns. */
+  visibility?: boolean;
+  /** A drag handle on each header's trailing edge; arrow keys nudge it, Home resets to auto. */
+  resizable?: boolean;
+  /** "Move left" / "Move right" in each column's header menu. */
+  reorderable?: boolean;
+  /** "Pin to start" / "Pin to end" in each column's header menu; pinned columns stay put while the rest scroll. */
+  pinnable?: boolean;
+}
 interface DataTableLabels {
   search?: string;
   empty?: string;
@@ -1533,6 +2052,31 @@ interface DataTableLabels {
   expandRow?: string;
   previousPage?: string;
   nextPage?: string;
+  columns?: string;
+  actions?: string;
+  noResults?: string;
+  clearFilters?: string;
+  filterColumn?: (column: string) => string;
+  min?: string;
+  max?: string;
+  all?: string;
+  columnMenu?: (column: string) => string;
+  sortAscending?: string;
+  sortDescending?: string;
+  clearSort?: string;
+  moveLeft?: string;
+  moveRight?: string;
+  pinStart?: string;
+  pinEnd?: string;
+  unpin?: string;
+  hideColumn?: string;
+  resizeColumn?: (column: string) => string;
+  /** Accessible name of an editable cell's control; receives the column header. */
+  editCell?: (column: string) => string;
+  /** Label of the `totals` row. */
+  totals?: string;
+  /** The export button. */
+  exportCsv?: string;
 }
 interface DataTableProps<Row> {
   columns: Column<Row>[];
@@ -1549,9 +2093,15 @@ interface DataTableProps<Row> {
    * @see the component manifest
    */
   searchable?: boolean;
+  /**
+   * Client-side paging, or the pager for a `server`-driven table. `page` makes the current
+   * page controlled; with `server`, `pageSize`/`page` are echoed back in every `TableQuery`.
+   */
   pagination?: {
     pageSize: number;
     pageSizeOptions?: number[];
+    page?: number;
+    onPageChange?: (page: number) => void;
   };
   selection?: {
     mode: 'single' | 'multi';
@@ -1564,6 +2114,109 @@ interface DataTableProps<Row> {
     onClick: (selectedIds: string[]) => void;
   }[];
   renderExpandedRow?: (row: Row) => ReactNode;
+  /** Per-column filter values (controlled). Columns opt in with `Column.filter`. */
+  filters?: ColumnFilters;
+  /** Initial per-column filter values (uncontrolled). */
+  defaultFilters?: ColumnFilters;
+  /** Called with the full filter map whenever any column filter changes. */
+  onFiltersChange?: (filters: ColumnFilters) => void;
+  /**
+   * Shown instead of `emptyState` when there ARE rows but the search or filters match none
+   * of them — a different message from "no data", and the moment to offer a reset.
+   */
+  noResultsState?: ReactNode;
+  /** Extra controls rendered in the toolbar, next to the search box (exports, primary actions). */
+  toolbar?: ReactNode;
+  /**
+   * Per-row actions. Returns the menu entries for a row; the table renders them as a
+   * trailing "⋯" overflow menu column, keyboard-reachable like every other cell control.
+   */
+  rowActions?: (row: Row) => RowAction<Row>[];
+  /** Column layout (controlled): hidden, order, widths, pinned. See {@link ColumnState}. */
+  columnState?: ColumnState;
+  /** Initial column layout (uncontrolled). */
+  defaultColumnState?: ColumnState;
+  /** Called with the full column layout whenever the user changes it. */
+  onColumnStateChange?: (state: ColumnState) => void;
+  /** Which column-layout controls to offer; see {@link ColumnSettings}. */
+  columnSettings?: ColumnSettings;
+  /** Hand sort, search, filters and paging to the server; see {@link DataTableServer}. */
+  server?: DataTableServer;
+  /**
+   * Allow sorting by more than one column: Shift-click a header adds it as a tie-breaker
+   * (`SortState.thenBy`); a plain click replaces the whole sort. Sorted headers show their
+   * level.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  multiSort?: boolean;
+  /**
+   * Remember the user's column layout and sort across reloads, in local storage under this
+   * key. Applies when the corresponding props are uncontrolled; a controlled `columnState`
+   * or `sort` still wins. Two tables with the same key share the preference.
+   */
+  stateKey?: string;
+  /**
+   * How the keyboard moves through the table. `'row'` keeps every control in the Tab order
+   * and lets the arrows step between them. `'grid'` is the APG data-grid pattern: the table
+   * is ONE Tab stop, the arrows move a focused cell, Home/End jump within the row,
+   * Ctrl+Home/End to the corners, PageUp/PageDown by a screenful, Enter or F2 enters the
+   * cell's control and Escape returns to the cell. Cells outside the virtualized window are
+   * scrolled to. Prefer `'grid'` for wide or editable tables, where tabbing through every
+   * control is the complaint.
+   *
+   * @defaultValue `row`
+   * @see the component manifest
+   */
+  keyboardNavigation?: 'row' | 'grid';
+  /**
+   * Commits an inline edit: the row, the edited column's key and the new text. Enables
+   * editing for every column marked `editable`; the table does not mutate `rows` itself.
+   */
+  onCellEdit?: (row: Row, key: string, value: string) => void;
+  /**
+   * Group the rows by one or more columns, in order. Each group is a collapsible row
+   * showing its value, its row count and every `aggregate` column's reduction; leaves keep
+   * the current sort inside their group. Groups appear in order of first occurrence, so
+   * sort by the grouped column to order them.
+   */
+  groupBy?: string | string[];
+  /**
+   * Show a totals row under the body with each `aggregate` column's reduction over every
+   * row that passes the search and filters (not just the page). Sticks to the bottom of
+   * the scroller.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  totals?: boolean;
+  /**
+   * Rows kept in view outside sort, search, filters, paging and the virtual window: `top`
+   * rows sit under the header (stuck there with `stickyHeader`), `bottom` rows above the
+   * totals. Rendered with the same columns as the body.
+   */
+  pinnedRows?: {
+    top?: Row[];
+    bottom?: Row[];
+  };
+  /**
+   * Bands of columns under a shared header, rendered as a row above the column headers.
+   * A band's columns should be adjacent; reordering them apart splits the band.
+   */
+  columnGroups?: ColumnGroup[];
+  /**
+   * An "Export CSV" button in the toolbar: every row passing the search and filters (all
+   * pages; with `server`, the rows given), in the current sort, visible columns as headers,
+   * raw cell values as fields (RFC 4180, UTF-8 with BOM). Pass `{ filename }` to name the
+   * file; it defaults to the `title`.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  exportable?: boolean | {
+    filename?: string;
+  };
   /**
    * Row height preset.
    *
@@ -1599,7 +2252,16 @@ interface DataTableProps<Row> {
    */
   loading?: boolean;
   emptyState?: ReactNode;
+  /** Visible caption above the table; it also becomes the table's accessible name. */
   title?: string;
+  /**
+   * Invisible accessible name for the `<table>`, used when there is no visible `title`.
+   *
+   * A table with neither is an unnamed landmark for a screen reader — a real WCAG 1.3.1 /
+   * 4.1.2 gap, and until 0.19 there was no way to fix it without rendering a caption you did
+   * not want. Dev-warns when both are absent.
+   */
+  ariaLabel?: string;
   description?: string;
   labels?: DataTableLabels;
   className?: string;
@@ -1611,17 +2273,16 @@ interface DataTableProps<Row> {
    */
   virtualized?: boolean;
   /**
-   * Fixed row height in px, used to compute the virtualized window.
+   * Row height in px for the virtualized window.
    *
-   * @defaultValue `40`
-   * @see the component manifest
+   * Measured from the first rendered row when omitted, so the density presets stay correct
+   * — the old fixed default of 40 never matched them (rows are 36/48/60 px plus a border),
+   * and a wrong value scales the whole scrollbar. Set it only for custom-sized rows.
    */
   rowHeight?: number;
   /**
-   * Number of rows rendered in the virtualized window.
-   *
-   * @defaultValue `20`
-   * @see the component manifest
+   * Rows rendered per window. Derived from the scroller's height when omitted; set it only
+   * to render a fixed count regardless of height.
    */
   windowSize?: number;
   /**
@@ -1645,12 +2306,33 @@ declare function DataTable<Row>({
   selection,
   batchActions,
   renderExpandedRow,
+  filters,
+  defaultFilters,
+  onFiltersChange,
+  noResultsState,
+  toolbar,
+  rowActions,
+  columnState,
+  defaultColumnState,
+  onColumnStateChange,
+  columnSettings,
+  server,
+  multiSort,
+  stateKey,
+  keyboardNavigation,
+  onCellEdit,
+  groupBy,
+  totals,
+  pinnedRows,
+  columnGroups,
+  exportable,
   density,
   zebra,
   stickyHeader,
   loading,
   emptyState,
   title,
+  ariaLabel,
   description,
   labels,
   className,
@@ -1719,6 +2401,12 @@ interface CommandMenuProps {
   open: boolean;
   onOpenChange: (open: boolean) => void;
   groups: CommandGroup[];
+  /**
+   * Placeholder text shown when the field is empty.
+   *
+   * @defaultValue `Type a command or search…`
+   * @see the component manifest
+   */
   placeholder?: string;
   /**
    * Text shown when no commands match the query.
@@ -1735,12 +2423,20 @@ interface CommandMenuProps {
    */
   hotkey?: boolean;
   /**
-   * Text label for the control.
+   * Accessible name for the command dialog. Not rendered — screen readers only.
    *
    * @defaultValue `Command menu`
    * @see the component manifest
    */
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
   /**
    * Shows a loading spinner in place of the empty state (for async items)
    *
@@ -1782,6 +2478,7 @@ declare function CommandMenu({
   emptyLabel,
   hotkey,
   label,
+  ariaLabel,
   loading,
   onQueryChange,
   scopes,
@@ -1856,31 +2553,69 @@ declare function Form<T extends Record<string, unknown>>({
   className,
   ...props
 }: FormProps<T>): import("react").JSX.Element;
+/**
+ * Option filtering, grouping and match highlighting for `Combobox`, kept pure so the list
+ * pipeline is testable without a DOM and runs once per query change rather than per render.
+ *
+ * Matching folds diacritics: a user typing `zurich` expects `Zürich`, and a filtered option
+ * list is exactly where that gap bites, because the user cannot see why their query returns
+ * nothing. Folding is done per code point so the folded string stays index-aligned with the
+ * original — that alignment is what lets `highlightSegments` mark the match on the label the
+ * user actually reads rather than on a normalised copy of it.
+ *
+ * `MultiSelect` carries the same four operations against its own option type. They are
+ * deliberately not shared: a registry component is copied into an adopter's project as a
+ * self-contained folder, so a cross-component import would make `cascivo add combobox`
+ * drag in a sibling component's files. The catalog already accepts this for the menu /
+ * context-menu navigation pair.
+ */
+/** One selectable option. A list mixing grouped and ungrouped options renders the ungrouped ones first. */
 interface ComboboxOption {
-  value: string;
   label: string;
+  value: string;
   /**
-   * When true, disables the control and removes it from the tab order.
+   * When true, the option cannot be selected and is skipped by keyboard navigation.
    *
    * @defaultValue `false`
    * @see the component manifest
    */
   disabled?: boolean;
+  /** Optional group heading this option belongs to. */
+  group?: string;
 }
 interface ComboboxLabels {
   placeholder?: string;
   empty?: string;
   clear?: string;
+  /**
+   * @deprecated Named the in-popup search input, which no longer exists — the field itself is
+   * the combobox. Ignored; removed in 2.0.
+   */
   search?: string;
+  /** Text shown in place of the empty message while `loading` is true. */
+  loading?: string;
+  /** Template for the "create" row; `{label}` is replaced with the typed text. */
+  create?: string;
 }
 interface ComboboxProps {
+  /**
+   * Wired automatically by a wrapping `Field` — its label id. Forwarded to the focusable
+   * control so the Field's label names it.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Wired automatically by a wrapping `Field` — the ids of its hint/error text. **Merged**
+   * with this component's own `hint`/`error` ids rather than replacing them, so both are
+   * announced.
+   */
+  'aria-describedby'?: string;
+  /** Wired automatically by a wrapping `Field` when it is in an error state. */
+  'aria-invalid'?: boolean;
   options: ComboboxOption[];
   value?: string;
   defaultValue?: string;
   /** Called with the selected option value (or undefined when cleared). */
   onValueChange?: (value: string | undefined) => void;
-  /** @deprecated Use `onValueChange` — it receives the same `string | undefined`. */
-  onChange?: (value: string | undefined) => void;
   /**
    * When true, shows a control to clear the selected value.
    *
@@ -1889,17 +2624,71 @@ interface ComboboxProps {
    */
   clearable?: boolean;
   /**
-   * When true, shows a search/filter input.
+   * When true the field is a text input that filters the list as the user types (the APG
+   * editable combobox). When false it is a button that opens the list, and type-to-select
+   * jumps to a matching option (the APG select-only combobox).
    *
    * @defaultValue `true`
    * @see the component manifest
    */
   searchable?: boolean;
   label?: string;
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it and `label` would render that text a second time.
+   *
+   * `label` on this component is **visible**. `IconButton.label` and `Sparkline.label` are
+   * invisible names, so an adopter arriving with that prior writes `label` here and gets the
+   * text twice (2026-08-22 report item 13). Both props are listed side by side, each saying
+   * which it is.
+   */
+  ariaLabel?: string;
   hint?: string;
   error?: string;
   size?: 'sm' | 'md' | 'lg';
+  /**
+   * When true, disables the control and removes it from the tab order.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
   disabled?: boolean;
+  /**
+   * When true, the list reports itself as busy and shows a loading row instead of the empty
+   * message.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  loading?: boolean;
+  /** Called with the search text on every keystroke. Pair it with `filter={() => true}` for a server-driven list. */
+  onSearchChange?: (query: string) => void;
+  /** Replaces the built-in diacritic-insensitive matcher. */
+  filter?: (option: ComboboxOption, query: string) => boolean;
+  /**
+   * When true, offers the current search text as a new option.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  creatable?: boolean;
+  /** Called with the typed label when the user picks the "create" row. */
+  onCreate?: (label: string) => void;
+  /** Submitted with a surrounding form — a hidden input carrying the selected value. */
+  name?: string;
+  /** Marks the control as required for assistive technology. */
+  required?: boolean;
+  /** Controlled open state of the listbox. */
+  open?: boolean;
+  /**
+   * The initial open state when uncontrolled.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  defaultOpen?: boolean;
+  /** Called when the listbox opens or closes. */
+  onOpenChange?: (open: boolean) => void;
   labels?: ComboboxLabels;
   className?: string;
   id?: string;
@@ -1909,33 +2698,61 @@ declare function Combobox({
   value,
   defaultValue,
   onValueChange,
-  onChange,
   clearable,
   searchable,
   label,
+  ariaLabel,
   hint,
   error,
   size,
   disabled,
+  loading,
+  onSearchChange,
+  filter,
+  creatable,
+  onCreate,
+  name,
+  required,
+  open,
+  defaultOpen,
+  onOpenChange,
   labels,
   className,
-  id
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid
 }: ComboboxProps): import("react").JSX.Element;
 interface DatePickerLabels {
   placeholder?: string;
   previousMonth?: string;
   nextMonth?: string;
   clear?: string;
+  open?: string;
+  today?: string;
 }
 interface DatePickerProps {
+  /**
+   * Wired automatically by a wrapping `Field` — its label id. Forwarded to the focusable
+   * control so the Field's label names it.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Wired automatically by a wrapping `Field` — the ids of its hint/error text. **Merged**
+   * with this component's own `hint`/`error` ids rather than replacing them, so both are
+   * announced.
+   */
+  'aria-describedby'?: string;
+  /** Wired automatically by a wrapping `Field` when it is in an error state. */
+  'aria-invalid'?: boolean;
   value?: string;
   defaultValue?: string;
   /** Called with the selected ISO date string (or undefined when cleared). */
   onValueChange?: (value: string | undefined) => void;
-  /** @deprecated Use `onValueChange` — it receives the same ISO `string | undefined`. */
-  onChange?: (value: string | undefined) => void;
   min?: string;
   max?: string;
+  /** Rejects individual dates the bounds allow — holidays, weekends, taken slots. */
+  disabledDate?: (date: Date) => boolean;
   /**
    * Shows a clear button
    *
@@ -1944,6 +2761,16 @@ interface DatePickerProps {
    */
   clearable?: boolean;
   label?: string;
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it and `label` would render that text a second time.
+   *
+   * `label` on this component is **visible**. `IconButton.label` and `Sparkline.label` are
+   * invisible names, so an adopter arriving with that prior writes `label` here and gets the
+   * text twice (2026-08-22 report item 13). Both props are listed side by side, each saying
+   * which it is.
+   */
+  ariaLabel?: string;
   hint?: string;
   error?: string;
   /**
@@ -1960,6 +2787,30 @@ interface DatePickerProps {
    * @see the component manifest
    */
   disabled?: boolean;
+  /**
+   * When true, the field accepts a typed date as well as one picked from the calendar.
+   *
+   * @defaultValue `true`
+   * @see the component manifest
+   */
+  typeable?: boolean;
+  /** Formatting options for the displayed date. Defaults to the locale's numeric form. */
+  format?: Intl.DateTimeFormatOptions;
+  /**
+   * When true, the calendar offers a button that jumps to the current month.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  showToday?: boolean;
+  /** Submitted with a surrounding form — a hidden input carrying the ISO value. */
+  name?: string;
+  /** Marks the control as required for assistive technology. */
+  required?: boolean;
+  /** Controlled open state of the calendar popup. */
+  open?: boolean;
+  /** Called when the popup opens or closes. */
+  onOpenChange?: (open: boolean) => void;
   labels?: DatePickerLabels;
   className?: string;
   id?: string;
@@ -1968,18 +2819,29 @@ declare function DatePicker({
   value,
   defaultValue,
   onValueChange,
-  onChange,
   min,
   max,
+  disabledDate,
   clearable,
   label,
+  ariaLabel,
   hint,
   error,
   size,
   disabled,
+  typeable,
+  format,
+  showToday,
+  name,
+  required,
+  open,
+  onOpenChange,
   labels,
   className,
-  id
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid
 }: DatePickerProps): import("react").JSX.Element;
 interface UploaderFile {
   id: string;
@@ -2017,6 +2879,16 @@ interface FileUploaderProps {
   maxSize?: number;
   onRejected?: (files: File[], reason: 'size' | 'type') => void;
   label?: string;
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it and `label` would render that text a second time.
+   *
+   * `label` on this component is **visible**. `IconButton.label` and `Sparkline.label` are
+   * invisible names, so an adopter arriving with that prior writes `label` here and gets the
+   * text twice (2026-08-22 report item 13). Both props are listed side by side, each saying
+   * which it is.
+   */
+  ariaLabel?: string;
   hint?: string;
   labels?: FileUploaderLabels;
   /**
@@ -2037,18 +2909,31 @@ declare function FileUploader({
   maxSize,
   onRejected,
   label,
+  ariaLabel,
   hint,
   labels,
   disabled,
   className
 }: FileUploaderProps): import("react").JSX.Element;
 interface TimePickerProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size' | 'type' | 'value' | 'defaultValue' | 'onChange' | 'min' | 'max' | 'step'> {
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it (a heading in a settings row, a table column header) and `label` would render
+   * that text a second time.
+   *
+   * `label` on this component is **visible** — it is painted next to the control. The catalog
+   * splits that way deliberately, but `IconButton.label` and `Sparkline.label` are invisible
+   * names, so an adopter arriving with that prior writes `label` here and gets the text twice
+   * (2026-08-22 report item 13). Both props are now listed side by side, each saying which it
+   * is, which is the only thing that interrupts a confident wrong guess.
+   *
+   * The raw DOM `aria-label` is still accepted and wins over this.
+   */
+  ariaLabel?: string;
   value?: string;
   defaultValue?: string;
   /** Called with the new `HH:MM` time string when the value changes. */
   onValueChange?: (value: string) => void;
-  /** @deprecated Use `onValueChange` — it receives the same time string. */
-  onChange?: (value: string) => void;
   min?: string;
   max?: string;
   step?: number;
@@ -2159,7 +3044,8 @@ interface AlertDialogProps {
   onCancel: () => void;
   labels?: AlertDialogLabels;
   /**
-   * Selects the visual style variant.
+   * `destructive` styles the confirm button as a danger action; `default` styles it as the
+   * primary action. Use `destructive` for anything that deletes.
    *
    * @defaultValue `default`
    * @see the component manifest
@@ -2182,7 +3068,8 @@ interface SheetProps {
   title?: ReactNode;
   children: ReactNode;
   /**
-   * Edge the component is anchored to.
+   * Edge the sheet slides in from: `end` (the inline end — right in LTR), `start`, `top` or
+   * `bottom`.
    *
    * @defaultValue `end`
    * @see the component manifest
@@ -2283,7 +3170,8 @@ interface ComparisonProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange
   defaultPosition?: number;
   onPositionChange?: (position: number) => void;
   /**
-   * Layout orientation of the component.
+   * Axis you drag along. `horizontal` splits the two images left and right with a vertical
+   * divider; `vertical` splits them top and bottom with a horizontal one.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -2296,8 +3184,16 @@ interface ComparisonProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange
    * @see the component manifest
    */
   keyboardStep?: number;
-  /** Accessible label for the divider slider. */
+  /** Accessible name for the divider slider — **not rendered**. */
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
 }
 declare function Comparison({
   after,
@@ -2308,6 +3204,7 @@ declare function Comparison({
   orientation,
   keyboardStep,
   label,
+  ariaLabel,
   className,
   ...props
 }: ComparisonProps): import("react").JSX.Element;
@@ -2370,40 +3267,185 @@ interface PasswordInputProps extends Omit<InputHTMLAttributes<HTMLInputElement>,
  * incomplete, which is why the rule is a guard and not a checklist.
  */
 declare const PasswordInput: import("react").ForwardRefExoticComponent<PasswordInputProps & import("react").RefAttributes<HTMLInputElement>>;
+/**
+ * Option filtering, grouping and match highlighting, kept pure so the list pipeline is
+ * testable without a DOM and runs once per query change rather than per render.
+ *
+ * Matching folds diacritics because a German user typing `zurich` expects `Zürich`, and an
+ * option list is exactly where that gap bites: the user cannot see why their query returns
+ * nothing. Folding is done per code point so the folded string stays index-aligned with the
+ * original — that alignment is what lets `highlightSegments` mark the match on the label the
+ * user actually reads rather than on a normalised copy of it.
+ */
+/** One selectable option. `group` is optional; a list mixing grouped and ungrouped options renders the ungrouped ones first. */
 interface MultiSelectOption {
   label: string;
   value: string;
   /**
-   * When true, disables the control and removes it from the tab order.
+   * When true, the option cannot be selected and is skipped by keyboard navigation.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  disabled?: boolean;
+  /** Optional group heading this option belongs to. */
+  group?: string;
+}
+interface MultiSelectLabels {
+  label?: string;
+  placeholder?: string;
+  selected?: (count: number) => string;
+  search?: string;
+  noResults?: string;
+  /** Text shown in place of the no-results message while `loading` is true. */
+  loading?: string;
+  clear?: string;
+  remove?: string;
+  /** Text on the select-all row while nothing is selected. */
+  selectAll?: string;
+  clearAll?: string;
+  create?: string;
+}
+interface MultiSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+  /**
+   * Wired automatically by a wrapping `Field` — its label id. Forwarded to the focusable
+   * control so the Field's label names it.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Wired automatically by a wrapping `Field` — the ids of its hint/error text. **Merged**
+   * with this component's own `hint`/`error` ids rather than replacing them, so both are
+   * announced.
+   */
+  'aria-describedby'?: string;
+  /** Wired automatically by a wrapping `Field` when it is in an error state. */
+  'aria-invalid'?: boolean;
+  options: MultiSelectOption[];
+  /** The controlled value. Omit it and pass `defaultValue` to let the component own the selection. */
+  value?: string[];
+  /**
+   * The initial value when uncontrolled.
+   *
+   * @defaultValue `[]`
+   * @see the component manifest
+   */
+  defaultValue?: string[];
+  /** Called with the new value when it changes. */
+  onValueChange?: (value: string[]) => void;
+  placeholder?: string;
+  /** Visible field label. */
+  label?: string;
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it and `label` would render that text a second time.
+   *
+   * `label` on this component is **visible**. `IconButton.label` and `Sparkline.label` are
+   * invisible names, so an adopter arriving with that prior writes `label` here and gets the
+   * text twice (2026-08-22 report item 13). Both props are listed side by side, each saying
+   * which it is.
+   */
+  ariaLabel?: string;
+  hint?: string;
+  error?: string;
+  /**
+   * How the trigger summarises the selection: a count, or one removable chip per value.
+   *
+   * @defaultValue `'count'`
+   * @see the component manifest
+   */
+  display?: 'count' | 'chips';
+  /**
+   * When true, disables the control and removes it from the tab order.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  disabled?: boolean;
+  /**
+   * When true, shows a control that clears every selected value.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  clearable?: boolean;
+  /**
+   * When true, shows a row that selects or clears every enabled option at once.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  selectAll?: boolean;
+  /** Maximum number of values that may be selected. Further options become unselectable once reached. */
+  max?: number;
+  /**
+   * When true, offers the current search text as a new option.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  creatable?: boolean;
+  /** Called with the typed label when the user picks the "create" row. */
+  onCreate?: (label: string) => void;
+  /**
+   * When true, the list reports itself as busy and shows a loading row instead of the
+   * no-results message.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  loading?: boolean;
+  /** Called with the search text on every keystroke. Pair it with `filter={() => true}` for a server-driven list. */
+  onSearchChange?: (query: string) => void;
+  /** Replaces the built-in diacritic-insensitive matcher. */
+  filter?: (option: MultiSelectOption, query: string) => boolean;
+  /**
+   * When true, shows the search field. The list is keyboard-navigable either way.
+   *
+   * @defaultValue `true`
+   * @see the component manifest
+   */
+  searchable?: boolean;
+  /**
+   * Field height.
    *
-   * @defaultValue `false`
+   * @defaultValue `'md'`
    * @see the component manifest
    */
-  disabled?: boolean;
-}
-interface MultiSelectLabels {
-  label?: string;
-  placeholder?: string;
-  selected?: (count: number) => string;
-  search?: string;
-  noResults?: string;
-}
-interface MultiSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
-  options: MultiSelectOption[];
-  value: string[];
-  onValueChange: (v: string[]) => void;
-  placeholder?: string;
-  disabled?: boolean;
+  size?: 'sm' | 'md' | 'lg';
+  /** Submitted with a surrounding form — one hidden input per selected value. */
+  name?: string;
   labels?: MultiSelectLabels;
+  id?: string;
 }
 declare function MultiSelect({
   options,
   value,
+  defaultValue,
   onValueChange,
   placeholder,
+  label,
+  ariaLabel,
+  hint,
+  error,
+  display,
   disabled,
+  clearable,
+  selectAll,
+  max,
+  creatable,
+  onCreate,
+  loading,
+  onSearchChange,
+  filter,
+  searchable,
+  size,
+  name,
   labels,
   className,
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid,
   ...props
 }: MultiSelectProps): import("react").JSX.Element;
 interface TagsInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
@@ -2419,6 +3461,28 @@ interface TagsInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'
    * @see the component manifest
    */
   disabled?: boolean;
+  /**
+   * Id for the **inner text input** — the focusable control, so a `<label for>` names the
+   * thing that actually takes focus. `Field` supplies this automatically.
+   *
+   * Naming is unaffected by this: the built-in name is dropped only when something actually
+   * names the control (an `ariaLabel`/`label` prop, or the `aria-labelledby` a `Field`
+   * supplies), so a standalone `<TagsInput id="x"/>` keeps its built-in name.
+   */
+  id?: string;
+  /**
+   * Invisible accessible name for the tag entry field. Use when no visible label names it.
+   *
+   * Inside a `Field` you do not need this — the Field's label is wired through automatically.
+   */
+  ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — the same invisible accessible name under the other spelling. Not
+   * rendered. `ariaLabel` is the catalog convention and stays preferred; `label` is the guess
+   * an adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing.
+   */
+  label?: string;
 }
 declare function TagsInput({
   value,
@@ -2428,6 +3492,12 @@ declare function TagsInput({
   max,
   disabled,
   className,
+  id,
+  ariaLabel,
+  label,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid,
   ...props
 }: TagsInputProps): import("react").JSX.Element;
 interface OtpInputProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'> {
@@ -2474,6 +3544,12 @@ interface SegmentedControlProps extends Omit<HTMLAttributes<HTMLDivElement>, 'on
   value: string;
   onValueChange: (v: string) => void;
   size?: 'sm' | 'md' | 'lg';
+  /**
+   * When true, disables the control and removes it from the tab order.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
   disabled?: boolean;
 }
 declare function SegmentedControl({
@@ -2569,6 +3645,18 @@ interface EditableProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChange'>
    */
   submitOnBlur?: boolean;
   onCancel?: () => void;
+  /**
+   * Id for the **focusable control** — the preview button when idle, the text input while
+   * editing — rather than the wrapper, so a `<label for>` names what actually takes focus.
+   * `Field` supplies this automatically.
+   */
+  id?: string;
+  /** Wired automatically by a wrapping `Field` — its label id. */
+  'aria-labelledby'?: string;
+  /** Wired automatically by a wrapping `Field` — the ids of its hint/error text. */
+  'aria-describedby'?: string;
+  /** Wired automatically by a wrapping `Field` when it is in an error state. */
+  'aria-invalid'?: boolean;
 }
 declare function Editable({
   value,
@@ -2578,6 +3666,12 @@ declare function Editable({
   submitOnBlur,
   onCancel,
   className,
+  id,
+  'aria-label': ariaLabel,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid,
+  tabIndex,
   ...props
 }: EditableProps): import("react").JSX.Element;
 interface RadioCardGroupProps {
@@ -2732,17 +3826,34 @@ type SwitcherEntry = SwitcherLink | {
 interface SwitcherProps {
   items: SwitcherEntry[];
   /**
-   * Text label for the control.
+   * Accessible name for the switcher list. Not rendered — screen readers only.
    *
    * @defaultValue `Switch application`
    * @see the component manifest
    */
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
   className?: string | undefined;
 }
+/**
+ * An **always-visible** list of apps/workspaces. Every entry renders at once and stays on
+ * screen — despite the name, nothing collapses and there is no trigger.
+ *
+ * For the shape most consoles want — one row showing the current workspace, a menu on click
+ * — use `Dropdown`. An adopter picked `Switcher` from its name for a Vercel-style team
+ * switcher and got both teams stacked permanently in the sidebar (2026-08-21 report item 5).
+ */
 declare function Switcher({
   items,
   label,
+  ariaLabel,
   className
 }: SwitcherProps): import("react").JSX.Element;
 interface CheckboxCardProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'title' | 'onChange'> {
@@ -2894,7 +4005,8 @@ interface ProgressProps {
   /** 0–100. Omit for indeterminate state. */
   value?: number;
   /**
-   * Selects the visual style variant.
+   * Colour of the fill: `primary` (the accent) or a severity tone — `info`, `success`,
+   * `warning`, `error`.
    *
    * @defaultValue `primary`
    * @see the component manifest
@@ -2908,6 +4020,14 @@ interface ProgressProps {
    * flip on every component.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   /** DOM-spelled alias of {@link ariaLabel}. */
   'aria-label'?: string;
   'aria-describedby'?: string;
@@ -2919,6 +4039,7 @@ declare function Progress({
   size,
   className,
   ariaLabel,
+  label,
   ...aria
 }: ProgressProps): import("react").JSX.Element;
 interface ProgressCircleProps extends HTMLAttributes<HTMLDivElement> {
@@ -2941,6 +4062,14 @@ interface ProgressCircleProps extends HTMLAttributes<HTMLDivElement> {
   showValue?: boolean;
   /** Accessible name for the progressbar. */
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
 }
 declare function ProgressCircle({
   value,
@@ -2948,6 +4077,7 @@ declare function ProgressCircle({
   size,
   showValue,
   label,
+  ariaLabel,
   className,
   ...props
 }: ProgressCircleProps): import("react").JSX.Element;
@@ -2972,7 +4102,8 @@ declare function Heading({
 }: HeadingProps): import("react").JSX.Element;
 interface TextProps extends HTMLAttributes<HTMLElement> {
   /**
-   * The HTML element to render as.
+   * `p` for a paragraph, `span` for inline text, `div` for a block that imposes no semantics
+   * of its own.
    *
    * @defaultValue `p`
    * @see the component manifest
@@ -2981,7 +4112,8 @@ interface TextProps extends HTMLAttributes<HTMLElement> {
   size?: 'sm' | 'md' | 'lg';
   weight?: 'normal' | 'medium' | 'semibold';
   /**
-   * When true, renders in a muted/subtle color.
+   * When true, renders in a muted/subtle color. `Text` has no `tone` prop: `tone` is the
+   * severity vocabulary (Status, Badge, Timeline, SideNav); text emphasis is `muted`.
    *
    * @defaultValue `false`
    * @see the component manifest
@@ -3023,7 +4155,8 @@ declare function Blockquote({
 }: BlockquoteProps): import("react").JSX.Element;
 interface ListProps extends HTMLAttributes<HTMLElement> {
   /**
-   * The HTML element to render as.
+   * `ul` for an unordered list, `ol` for a numbered one. Changes the element and its marker,
+   * not the styling.
    *
    * @defaultValue `ul`
    * @see the component manifest
@@ -3200,8 +4333,17 @@ interface QrCodeProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'> {
    * @see the component manifest
    */
   background?: string;
-  /** Accessible label. Defaults to the i18n built-in "QR code". */
+  /** Accessible name for the QR image — **not rendered**. Defaults to the i18n built-in
+   * "QR code". */
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
 }
 declare function QrCode({
   value,
@@ -3211,6 +4353,7 @@ declare function QrCode({
   fill,
   background,
   label,
+  ariaLabel,
   className,
   style,
   ...props
@@ -3279,8 +4422,18 @@ declare function Label({
 interface FieldProps {
   /** Label text for the control. */
   label?: ReactNode;
-  /** Helper text describing the control, wired via aria-describedby. */
+  /**
+   * Helper text under the control, wired via `aria-describedby`.
+   *
+   * `hint` is the same thing under the name the eight form controls use (`Input.hint`,
+   * `Select.hint`, …); `Field` predates that split and shipped `description`, which is the
+   * catalog's word for the body text of a *feedback* component (`Alert`, `Notification`).
+   * Both work here and neither is deprecated (2026-08-21 report item 4). When both are
+   * passed, `description` wins.
+   */
   description?: ReactNode;
+  /** Alias of `description` — the name the form controls use for the same text. */
+  hint?: ReactNode;
   /** Error message; sets aria-invalid on the control and is announced via role="alert". */
   error?: ReactNode;
   /**
@@ -3302,6 +4455,7 @@ interface FieldProps {
   /** The single form control element. */
   children: ReactElement<{
     id?: string;
+    'aria-labelledby'?: string;
     'aria-describedby'?: string;
     'aria-invalid'?: boolean;
     disabled?: boolean;
@@ -3311,6 +4465,7 @@ interface FieldProps {
 declare function Field({
   label,
   description,
+  hint,
   error,
   required,
   disabled,
@@ -3335,8 +4490,6 @@ interface FilterProps {
   defaultValue?: string[];
   /** Called with the selected values whenever the selection changes. */
   onValueChange?: (selected: string[]) => void;
-  /** @deprecated Use `onValueChange` — it receives the same `string[]`. */
-  onChange?: (selected: string[]) => void;
   /**
    * Allow multiple items to be selected simultaneously
    *
@@ -3345,7 +4498,17 @@ interface FilterProps {
    */
   multi?: boolean;
   /**
-   * Selects the visual style variant.
+   * Alias of `multi` — the HTML spelling, accepted because it is the guess.
+   *
+   * `multiple` is what `<select multiple>` and `<input multiple>` are called, so an adopter
+   * reaches for it first and pays a compile cycle on a prop whose doc comment they never see:
+   * you cannot read the documentation of a prop you do not know exists (2026-08-22 report
+   * item 14). `multi` stays canonical.
+   */
+  multiple?: boolean;
+  /**
+   * `pill` fills the selected chip with the accent colour; `outline` marks it with an accent
+   * border and text instead, leaving the fill transparent.
    *
    * @defaultValue `pill`
    * @see the component manifest
@@ -3358,6 +4521,14 @@ interface FilterProps {
    * flip on every component.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   /** DOM-spelled alias of {@link ariaLabel}. */
   'aria-label'?: string;
   className?: string;
@@ -3367,11 +4538,12 @@ declare function Filter({
   value,
   defaultValue,
   onValueChange,
-  onChange,
   multi,
+  multiple,
   variant,
   className,
   ariaLabel,
+  label,
   ...aria
 }: FilterProps): import("react").JSX.Element;
 interface IconButtonBaseProps extends ButtonHTMLAttributes<HTMLButtonElement> {
@@ -3380,7 +4552,8 @@ interface IconButtonBaseProps extends ButtonHTMLAttributes<HTMLButtonElement> {
   icon?: ReactNode;
   size?: 'sm' | 'md' | 'lg';
   /**
-   * Selects the visual style variant.
+   * `ghost` is transparent until hover, `outline` adds a border, `filled` gives the button a
+   * solid surface.
    *
    * @defaultValue `ghost`
    * @see the component manifest
@@ -3411,7 +4584,8 @@ type IconButtonProps = IconButtonBaseProps & ({
 declare const IconButton: import("react").ForwardRefExoticComponent<IconButtonProps & import("react").RefAttributes<HTMLButtonElement>>;
 interface ButtonGroupProps extends HTMLAttributes<HTMLDivElement> {
   /**
-   * Layout orientation of the component.
+   * Axis the buttons flow along: `horizontal` puts them in a row, `vertical` stacks them in
+   * a column. The seams between them are collapsed either way.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -3453,13 +4627,20 @@ interface ToggleGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, 'onChang
   onValueChange?: (value: string | string[]) => void;
   items: ToggleGroupItem[];
   /**
-   * Layout orientation of the component.
+   * Axis the options flow along: `horizontal` for a segmented row, `vertical` for a stacked
+   * column.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
    */
   orientation?: 'horizontal' | 'vertical';
   size?: 'sm' | 'md' | 'lg';
+  /**
+   * When true, disables the control and removes it from the tab order.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
   disabled?: boolean;
 }
 declare const ToggleGroup: import("react").ForwardRefExoticComponent<ToggleGroupProps & import("react").RefAttributes<HTMLDivElement>>;
@@ -3486,9 +4667,12 @@ interface NotificationProps extends Omit<HTMLAttributes<HTMLDivElement>, 'title'
   title: ReactNode;
   description?: ReactNode;
   /**
-   * Severity tone. Accepts the catalog-wide `Tone` vocabulary
-   * (`neutral | info | success | warning | danger`) plus Notification's historical
-   * spellings (`error`, `destructive`).
+   * Severity tone. Accepts the catalog-wide `Tone` vocabulary (`neutral | info | success |
+   * warning | danger`) plus Notification's historical spellings (`error`, `destructive` →
+   * danger).
+   *
+   * @defaultValue `info`
+   * @see the component manifest
    */
   variant?: ToneInput;
   /**
@@ -3616,6 +4800,12 @@ interface MenuButtonProps {
   items: MenuButtonItem[];
   variant?: 'primary' | 'secondary' | 'ghost';
   size?: 'sm' | 'md' | 'lg';
+  /**
+   * Disables the trigger
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
   disabled?: boolean;
   align?: 'start' | 'end';
   labels?: {
@@ -3711,9 +4901,18 @@ interface NavigationMenuProps {
    * `docs/AI-RULES.md`); `aria-label` is accepted as an alias for the DOM spelling.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   'aria-label'?: string;
   /**
-   * Layout orientation of the component.
+   * Which arrow keys move focus, and the axis the items lay out on: `horizontal`
+   * (Left/Right), `vertical` (Up/Down), or `both` (all four).
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -3725,6 +4924,7 @@ declare function NavigationMenu({
   items,
   'aria-label': ariaLabelDom,
   ariaLabel,
+  label,
   orientation,
   className
 }: NavigationMenuProps): import("react").JSX.Element;
@@ -3733,13 +4933,34 @@ interface TreeNode {
   label: ReactNode;
   icon?: ReactNode;
   children?: TreeNode[];
+  /**
+   * When true, the node cannot be selected and is skipped by keyboard navigation and
+   * type-to-select.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  disabled?: boolean;
+  /**
+   * Plain-text form of `label`, for type-to-select when the label is JSX.
+   *
+   * Typeahead matched `typeof label === 'string'`, so it silently did nothing for any node
+   * rendering an icon beside its text — the common case.
+   */
+  textValue?: string;
 }
 interface TreeViewProps {
   items: TreeNode[];
   selectionMode?: 'single' | 'multi';
   selected?: string | string[];
   defaultSelected?: string | string[];
+  /**
+   * @deprecated Use `onValueChange`. The catalog names a value-carrying handler
+   * `onValueChange`; `onSelectChange` appears on this component alone. Still honoured.
+   */
   onSelectChange?: (selected: string | string[]) => void;
+  /** Called with the new selection. */
+  onValueChange?: (selected: string | string[]) => void;
   expanded?: string[];
   defaultExpanded?: string[];
   onExpandedChange?: (expanded: string[]) => void;
@@ -3749,6 +4970,14 @@ interface TreeViewProps {
    * `docs/AI-RULES.md`); `aria-label` is accepted as an alias for the DOM spelling.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   'aria-label'?: string;
 }
 declare function TreeView({
@@ -3757,12 +4986,14 @@ declare function TreeView({
   selected,
   defaultSelected,
   onSelectChange,
+  onValueChange,
   expanded,
   defaultExpanded,
   onExpandedChange,
   className,
   'aria-label': ariaLabelDom,
-  ariaLabel
+  ariaLabel,
+  label
 }: TreeViewProps): import("react").JSX.Element;
 declare const treeViewMessages: {
   loading: () => string;
@@ -3805,6 +5036,14 @@ interface StructuredListProps {
    * flip on every component.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   /** DOM-spelled alias of {@link ariaLabel}. */
   'aria-label'?: string;
 }
@@ -3840,7 +5079,13 @@ interface DataListItem {
 interface DataListProps extends HTMLAttributes<HTMLDListElement> {
   items: DataListItem[];
   /**
-   * Layout orientation of the component.
+   * Where each **value** sits relative to its own label — not the axis of the list.
+   *
+   * `'horizontal'` puts the value beside its label; `'vertical'` puts it underneath. Items
+   * are stacked vertically either way, which is the part the name does not say: an adopter
+   * read `orientation="vertical"` as "lay the items out vertically" and got a very tall
+   * block from six rows (2026-08-21 report item 9). In a summary card, prefer
+   * `'horizontal'`.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -3896,7 +5141,8 @@ interface TimelineItem {
 interface TimelineProps extends HTMLAttributes<HTMLOListElement> {
   items: TimelineItem[];
   /**
-   * Layout orientation of the component.
+   * Axis the entries flow along: `vertical` stacks them down the page (the usual reading
+   * order), `horizontal` runs them across.
    *
    * @defaultValue `vertical`
    * @see the component manifest
@@ -3919,7 +5165,8 @@ interface ItemProps extends HTMLAttributes<HTMLDivElement> {
    */
   asChild?: boolean;
   /**
-   * Selects the visual style variant.
+   * `muted` gives the row a subtle background — for a selected or highlighted item;
+   * `default` leaves it transparent.
    *
    * @defaultValue `default`
    * @see the component manifest
@@ -3968,6 +5215,8 @@ declare function ItemActions({
 interface CalendarLabels {
   previousMonth?: string;
   nextMonth?: string;
+  today?: string;
+  weekNumber?: string;
 }
 interface CalendarProps {
   value?: Date | null;
@@ -3986,6 +5235,15 @@ interface CalendarProps {
   size?: 'sm' | 'md' | 'lg';
   labels?: CalendarLabels;
   className?: string;
+  /**
+   * Accessible name for the grid. Defaults to the visible month label.
+   *
+   * Calendar has no visible label slot — the month heading is its own — so `label` and
+   * `ariaLabel` are aliases for the same invisible name. `ariaLabel` wins if both are given.
+   */
+  ariaLabel?: string;
+  /** Alias for `ariaLabel`. See the note there. */
+  label?: string;
   /** Highlight predicate for range previews (date-range-picker). */
   isInRange?: (date: Date) => boolean;
   /** Range endpoint markers for styling. */
@@ -4009,6 +5267,20 @@ interface CalendarProps {
    * @see the component manifest
    */
   hideNav?: boolean;
+  /**
+   * When true, shows a button that jumps the view to the current month and focuses today.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  showToday?: boolean;
+  /**
+   * When true, prefixes each row with its ISO-8601 week number.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  showWeekNumbers?: boolean;
 }
 declare function Calendar({
   value,
@@ -4021,6 +5293,8 @@ declare function Calendar({
   size,
   labels,
   className,
+  ariaLabel,
+  label,
   isInRange,
   isRangeStart,
   isRangeEnd,
@@ -4028,13 +5302,22 @@ declare function Calendar({
   month,
   year,
   onViewChange,
-  hideNav
+  hideNav,
+  showToday,
+  showWeekNumbers
 }: CalendarProps): import("react").JSX.Element;
 interface DateRange {
   start: Date;
   end: Date;
 }
 interface DateRangePreset {
+  /**
+   * Stable identity, used as the React key. Without it the array index (or a repeatable
+   * `label`) is the key, so inserting or reordering entries re-uses the wrong DOM node — the
+   * defect `link-item-id-parity` exists to prevent, extended past link-shaped items on
+   * 2026-08-22.
+   */
+  id?: string;
   label: string;
   range: DateRange;
 }
@@ -4082,19 +5365,34 @@ declare function DateRangePicker({
   labels,
   className
 }: DateRangePickerProps): import("react").JSX.Element;
+/** The output formats an adopter can ask for. */
+type ColorFormat = 'hex' | 'rgb' | 'hsl';
 interface ColorPickerLabels {
   hue?: string;
-  /**
-   * When true, enables alpha (opacity) selection.
-   *
-   * @defaultValue `true`
-   * @see the component manifest
-   */
+  /** Accessible name for the alpha slider. */
   alpha?: string;
   colorArea?: string;
+  saturation?: string;
+  brightness?: string;
   eyedropper?: string;
+  presets?: string;
+  hex?: string;
 }
 interface ColorPickerProps {
+  /**
+   * Wired automatically by a wrapping `Field` — its label id. Forwarded to the text input so
+   * the Field's label names it; the built-in fallback name is then not applied.
+   */
+  'aria-labelledby'?: string;
+  /**
+   * Wired automatically by a wrapping `Field` — the ids of its hint/error text. Forwarded to
+   * the text input so the supporting text is announced, not just displayed.
+   */
+  'aria-describedby'?: string;
+  /** Wired automatically by a wrapping `Field` when it is in an error state. */
+  'aria-invalid'?: boolean;
+  /** Id for the focusable text input. `Field` supplies this automatically. */
+  id?: string;
   value?: string;
   /**
    * The initial value when uncontrolled.
@@ -4105,8 +5403,32 @@ interface ColorPickerProps {
   defaultValue?: string;
   onValueChange?: (value: string) => void;
   presets?: string[];
+  /**
+   * When true, enables alpha (opacity) selection.
+   *
+   * @defaultValue `true`
+   * @see the component manifest
+   */
   alpha?: boolean;
+  /**
+   * Notation for the emitted value. Alpha is included whenever `alpha` is on, so the width
+   * of the emitted string is stable.
+   *
+   * @defaultValue `'hex'`
+   * @see the component manifest
+   */
+  format?: ColorFormat;
   label?: string;
+  /**
+   * Invisible accessible name, for when a visible element outside this component already
+   * labels it and `label` would render that text a second time.
+   *
+   * `label` on this component is **visible**. `IconButton.label` and `Sparkline.label` are
+   * invisible names, so an adopter arriving with that prior writes `label` here and gets the
+   * text twice (2026-08-22 report item 13). Both props are listed side by side, each saying
+   * which it is.
+   */
+  ariaLabel?: string;
   /**
    * When true, disables the control and removes it from the tab order.
    *
@@ -4114,26 +5436,37 @@ interface ColorPickerProps {
    * @see the component manifest
    */
   disabled?: boolean;
+  /** Submitted with a surrounding form — a hidden input carrying the current value. */
+  name?: string;
   size?: 'sm' | 'md' | 'lg';
   className?: string;
   labels?: ColorPickerLabels;
 }
 declare function ColorPicker({
+  id,
   value,
   defaultValue,
   onValueChange,
   presets,
   alpha,
+  format,
   label,
+  ariaLabel,
   disabled,
+  name,
   size,
   className,
-  labels
+  labels,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid
 }: ColorPickerProps): import("react").JSX.Element;
 interface CarouselLabels {
   region?: string;
   previous?: string;
   next?: string;
+  play?: string;
+  pause?: string;
 }
 interface CarouselProps {
   children?: ReactNode;
@@ -4154,6 +5487,14 @@ interface CarouselProps {
    * @see the component manifest
    */
   loop?: boolean;
+  /**
+   * Milliseconds between automatic advances. Omit or set 0 to leave rotation off.
+   *
+   * Auto-rotation pauses on hover, on focus within the carousel, while the tab is hidden and
+   * under `prefers-reduced-motion`, and always renders a play/pause control — APG requires
+   * one for any carousel that rotates on its own.
+   */
+  autoplay?: number;
   className?: string;
   labels?: CarouselLabels;
 }
@@ -4164,13 +5505,15 @@ declare function Carousel({
   defaultIndex,
   onIndexChange,
   loop,
+  autoplay,
   className,
   labels
 }: CarouselProps): import("react").JSX.Element;
 interface ResizableProps {
   children: ReactNode;
   /**
-   * Layout orientation of the component.
+   * Axis the panes are split along. `horizontal` puts them side by side with a handle you
+   * drag left and right; `vertical` stacks them with a handle you drag up and down.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -4201,6 +5544,14 @@ interface ResizableProps {
   onRatioChange?: (ratio: number) => void;
   className?: string;
   label?: string;
+  /**
+   * Alias of `label` — the same invisible accessible name under the catalog's own spelling.
+   *
+   * `ariaLabel` is what the catalog calls a name nothing paints, so it is the guess an agent
+   * makes after reading one other component (2026-08-21 report item 1). This component
+   * predates the convention and shipped `label`; both work and neither is deprecated.
+   */
+  ariaLabel?: string;
 }
 declare function Resizable({
   children,
@@ -4211,7 +5562,8 @@ declare function Resizable({
   maxRatio,
   onRatioChange,
   className,
-  label
+  label,
+  ariaLabel
 }: ResizableProps): import("react").JSX.Element;
 interface DockItem {
   /**
@@ -4235,12 +5587,21 @@ interface DockProps {
   className?: string;
   /** Accessible label for the nav landmark */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
 }
 declare function Dock({
   items,
   activeIndex,
   className,
-  ariaLabel
+  ariaLabel,
+  label
 }: DockProps): import("react").JSX.Element;
 interface LargeTitleHeaderProps {
   /** The page title. Rendered as the large heading and mirrored in the collapsed bar. */
@@ -4390,6 +5751,14 @@ interface VirtualListProps<Item> {
   overscan?: number;
   /** Accessible label for the list; defaults to none, so label it when standalone. */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   className?: string;
 }
 /**
@@ -4408,6 +5777,7 @@ declare function VirtualList<Item>({
   renderItem,
   overscan,
   ariaLabel,
+  label,
   className
 }: VirtualListProps<Item>): import("react").JSX.Element;
 interface WheelPickerOption {
@@ -4433,6 +5803,14 @@ interface WheelPickerProps {
    */
   itemHeight?: number;
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   className?: string;
 }
 /**
@@ -4453,6 +5831,7 @@ declare function WheelPicker({
   visibleCount,
   itemHeight,
   ariaLabel,
+  label,
   className
 }: WheelPickerProps): import("react").JSX.Element;
 interface DrawerProps {
@@ -4527,6 +5906,10 @@ interface NativeSelectProps extends Omit<SelectHTMLAttributes<HTMLSelectElement>
  * A styled native `<select>` — keeps the platform's open/close, keyboard, and form behavior, and
  * layers on a custom chevron and focus/invalid rings via CSS only. No JS interactivity, so no
  * signals: the browser owns all state. Distinct from the custom-rendered `Select` listbox.
+ *
+ * Where `appearance: base-select` is supported the dropdown surface is themed from
+ * `[data-theme]` too, matching `Dropdown` — see the `@supports` block in the stylesheet. It is
+ * progressive enhancement: elsewhere the OS draws the option list, exactly as before.
  */
 /**
  * `forwardRef` so `ref` reaches the underlying `<select>` — and so it is TYPED. See
@@ -4612,11 +5995,23 @@ declare function CodeSnippet({
 type StepState = 'pending' | 'active' | 'complete' | 'error';
 interface Step {
   label: string;
-  /** Accepts `StepState` plus Timeline's `current` / `upcoming` aliases. */
-  state?: ProgressInput;
+  /**
+   * Stable identity for the step, used as its React key.
+   *
+   * Every other config-item type in the catalog (`TimelineItem`, `SideNavItem`,
+   * `DataListItem`, `BreadcrumbItem`) carries one; `Step` was missed because the sweep that
+   * added them looked for a `label` **and an `href`** (2026-08-22 report item 10). Without it
+   * the index is the key, so reordering or inserting a step re-uses the wrong DOM node.
+   */
+  id?: string;
+  /**
+   * Step status. `StepState` is the canonical enum; `ProgressInput` additionally accepts
+   * Timeline's `current` / `upcoming` aliases so one status value drives both components.
+   */
+  state?: StepState | ProgressInput;
 }
-interface StepsProps {
-  steps: Step[];
+/** Props shared by both spellings of the collection. */
+interface StepsBaseProps {
   /**
    * Index of the currently active step (0-based)
    *
@@ -4628,13 +6023,40 @@ interface StepsProps {
   className?: string;
   /** Accessible label for the steps list */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
 }
+/**
+ * The collection, under either spelling — exactly one is required.
+ *
+ * `steps` is the domain word and stays canonical. `items` is accepted because the catalog's
+ * published data-prop vocabulary says a config-driven collection is `items`, and an adopter
+ * who followed that rule hit a type error on the one component the rule named wrongly
+ * (2026-08-22 report item 10). The XOR keeps "pass neither" and "pass both" compile errors
+ * rather than silent no-ops, the same shape `Menubar` uses for its name props.
+ */
+type StepsCollection = {
+  steps: Step[];
+  items?: never;
+} | {
+  items: Step[];
+  steps?: never;
+};
+type StepsProps = StepsBaseProps & StepsCollection;
 declare function Steps({
   steps,
+  items,
   activeStep: controlledActiveStep,
   orientation,
   className,
-  ariaLabel
+  ariaLabel,
+  label
 }: StepsProps): import("react").JSX.Element;
 interface TileProps {
   /** Identifies this tile within a group. */
@@ -4681,7 +6103,8 @@ interface IndicatorProps {
   children: React.ReactNode;
   overlay: React.ReactNode;
   /**
-   * Placement relative to the trigger.
+   * Corner of the wrapped element the dot or count sits on: `top-end`, `top-start`,
+   * `bottom-start` or `bottom-end`.
    *
    * @defaultValue `top-end`
    * @see the component manifest
@@ -4699,7 +6122,8 @@ type JoinOrientation = 'horizontal' | 'vertical';
 interface JoinProps {
   children: React.ReactNode;
   /**
-   * Layout orientation of the component.
+   * Axis the joined children flow along: `horizontal` for a row, `vertical` for a column.
+   * Inner corners are squared off either way.
    *
    * @defaultValue `horizontal`
    * @see the component manifest
@@ -4808,7 +6232,8 @@ type ChatBubbleSide = 'start' | 'end';
 interface ChatBubbleProps {
   children: React.ReactNode;
   /**
-   * Edge the component is anchored to.
+   * Which side of the thread the bubble sits on: `start` for an incoming message (avatar
+   * first), `end` for an outgoing one (right-aligned, avatar last).
    *
    * @defaultValue `start`
    * @see the component manifest
@@ -4833,7 +6258,8 @@ interface RadialProgressProps {
   value: number;
   size?: RadialProgressSize;
   /**
-   * Selects the visual style variant.
+   * Colour of the ring: `primary` (the accent) or a severity tone — `info`, `success`,
+   * `warning`, `error`.
    *
    * @defaultValue `primary`
    * @see the component manifest
@@ -4845,6 +6271,14 @@ interface RadialProgressProps {
    * `docs/AI-RULES.md`); `aria-label` is accepted as an alias for the DOM spelling.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   'aria-label'?: string;
   className?: string;
 }
@@ -4855,6 +6289,7 @@ declare function RadialProgress({
   children,
   className,
   ariaLabel,
+  label: labelProp,
   ...aria
 }: RadialProgressProps): import("react").JSX.Element;
 type SwapMode = 'rotate' | 'flip';
@@ -4870,14 +6305,20 @@ interface SwapProps {
   checked?: boolean;
   /** Called with the new checked state when the swap is toggled. */
   onValueChange?: (checked: boolean) => void;
-  /** @deprecated Use `onValueChange` — it receives the same `checked` boolean. */
-  onChange?: (checked: boolean) => void;
   mode?: SwapMode;
   /**
    * Invisible accessible name. The catalog convention (see the item-identity table in
    * `docs/AI-RULES.md`); `aria-label` is accepted as an alias for the DOM spelling.
    */
   ariaLabel?: string;
+  /**
+   * Alias of `ariaLabel` — same invisible accessible name, the other spelling. Not rendered.
+   *
+   * `ariaLabel` is the catalog convention and stays preferred, but `label` is the guess an
+   * adopter makes when they have not read the convention, and an unaccepted guess costs a
+   * compile cycle for nothing (2026-08-21 report item 1). Pass either.
+   */
+  label?: string;
   'aria-label'?: string;
   className?: string;
 }
@@ -4886,10 +6327,10 @@ declare function Swap({
   off,
   checked,
   onValueChange,
-  onChange,
   mode,
   className,
   ariaLabel,
+  label,
   ...aria
 }: SwapProps): import("react").JSX.Element;
 interface SwipeAction {
@@ -4959,12 +6400,22 @@ interface GridProps extends HTMLAttributes<HTMLDivElement> {
   align?: GridAlign;
   /** Inline-axis alignment of items within their cells (`justify-items`). Defaults to `stretch`. */
   justify?: GridAlign;
+  /**
+   * Align the internal bands of adjacent children via CSS subgrid — every CardHeader in a
+   * row shares one row track, every CardContent the next, every CardFooter the last. Where
+   * subgrid is unsupported the grid renders as it does without this prop.
+   *
+   * @defaultValue `false`
+   * @see the component manifest
+   */
+  alignRows?: boolean;
 }
 declare function Grid({
   cols,
   gap,
   align,
   justify,
+  alignRows,
   className,
   style,
   children,
@@ -5129,4 +6580,517 @@ declare function PageHeader({
   actions,
   className
 }: PageHeaderProps): import("react").JSX.Element;
-export { Accordion, AccordionContent, AccordionItem, AccordionItemProps, AccordionProps, AccordionTrigger, ActionSheet, ActionSheetAction, ActionSheetProps, Alert, AlertDialog, AlertDialogLabels, AlertDialogProps, AlertProps, AppShell, AppShellProps, AspectRatio, AspectRatioProps, AutoGrid, AutoGridProps, Avatar, AvatarGroup, AvatarGroupLabels, AvatarGroupProps, AvatarProps, Badge, BadgeProps, Blockquote, BlockquoteProps, BottomSheet, BottomSheetProps, Breadcrumb, BreadcrumbItem, BreadcrumbProps, Button, ButtonGroup, ButtonGroupProps, ButtonProps, Calendar, CalendarLabels, CalendarProps, Card, CardContent, CardContentProps, CardFooter, CardFooterProps, CardHeader, CardHeaderProps, CardProps, CardTitle, CardTitleProps, Carousel, CarouselLabels, CarouselProps, Center, CenterProps, ChatBubble, ChatBubbleProps, ChatBubbleSide, Checkbox, CheckboxCard, CheckboxCardProps, CheckboxProps, Code, type CodeLang, CodeProps, CodeSnippet, CodeSnippetProps, Collapsible, CollapsibleProps, ColorPicker, ColorPickerLabels, ColorPickerProps, Column, Columns, ColumnsProps, Combobox, ComboboxLabels, ComboboxOption, ComboboxProps, CommandAction, CommandGroup, CommandItem, CommandMenu, CommandMenuProps, CommandPage, CommandScope, CommandStatus, Comparison, ComparisonProps, ContainedList, ContainedListItem, ContainedListItemProps, ContainedListProps, ContextMenu, ContextMenuItem, ContextMenuItemProps, ContextMenuProps, CopyButton, CopyButtonProps, DataList, DataListItem, DataListProps, DataTable, DataTableLabels, DataTableProps, DatePicker, DatePickerLabels, DatePickerProps, DateRange, DateRangePicker, DateRangePickerLabels, DateRangePickerProps, DateRangePreset, DismissableLayer, type DismissableLayerProps, Dock, DockItem, DockProps, Drawer, DrawerProps, Dropdown, DropdownItem, DropdownProps, Editable, EditableProps, EmptyState, EmptyStateProps, ErrorBoundary, Fab, FabAction, FabProps, Field, FieldProps, FileUploader, FileUploaderLabels, FileUploaderProps, Filter, FilterOption, FilterProps, FilterVariant, Flex, FlexProps, FocusScope, Form, FormConfig, FormProps, FormStore, FuzzyMatch, Grid, GridAlign, GridItem, GridItemProps, GridProps, Header, HeaderLabels, HeaderLink, HeaderPanel, HeaderPanelLabels, HeaderPanelProps, HeaderProps, Heading, HeadingLevel, HeadingProps, HeadingSize, HoverCard, HoverCardContent, HoverCardContentProps, HoverCardProps, HoverCardTrigger, HoverCardTriggerProps, IconButton, IconButtonProps, Image, ImageProps, Indicator, IndicatorPlacement, IndicatorProps, InfiniteScroll, InfiniteScrollProps, InlineLoading, InlineLoadingProps, InlineLoadingStatus, Input, InputGroup, InputGroupAddon, type InputGroupAddonProps, type InputGroupProps, InputProps, Item, ItemActions, ItemActionsProps, ItemContent, ItemContentProps, ItemDescription, ItemDescriptionProps, ItemMedia, ItemMediaProps, ItemProps, ItemTitle, ItemTitleProps, Join, JoinOrientation, JoinProps, Kbd, KbdProps, Label, LabelProps, LargeTitleHeader, LargeTitleHeaderProps, Link, type LinkComponent, type LinkComponentProps, LinkProps, List, ListItem, ListItemProps, ListProps, LogLevel, LogLine, LogViewer, LogViewerLabels, LogViewerProps, type Machine, type MachineConfig, Menu, MenuButton, MenuButtonItem, MenuButtonProps, MenuItem, MenuItemProps, MenuProps, MenuSeparator, MenuTrigger, MenuTriggerProps, Menubar, MenubarBaseProps, MenubarItem, MenubarMenu, MenubarProps, Modal, ModalProps, MultiSelect, MultiSelectLabels, MultiSelectOption, MultiSelectProps, NativeSelect, NativeSelectOption, NativeSelectProps, NavigationMenu, NavigationMenuItem, NavigationMenuProps, Notification, NotificationProps, NotificationVariant, NumberInput, NumberInputProps, OtpInput, OtpInputProps, OverflowMenu, OverflowMenuItem, OverflowMenuProps, PageHeader, PageHeaderProps, Pagination, PaginationLabels, PaginationProps, PasswordInput, PasswordInputLabels, PasswordInputProps, Popover, PopoverContent, PopoverContentProps, PopoverProps, PopoverTrigger, PopoverTriggerProps, Portal, Presence, Progress, ProgressBar, ProgressBarProps, ProgressCircle, ProgressCircleProps, ProgressIndicator, ProgressIndicatorProps, ProgressProps, ProgressSize, ProgressStep, ProgressVariant, Prose, ProseProps, PullToRefresh, PullToRefreshProps, QrCode, QrCodeProps, RadialProgress, RadialProgressProps, RadialProgressSize, RadialProgressVariant, Radio, RadioCard, RadioCardGroup, RadioCardGroupProps, RadioCardProps, RadioGroup, RadioGroupProps, RadioProps, RatingGroup, RatingGroupLabels, RatingGroupProps, RelativeTime, RelativeTimeProps, ReorderItem, ReorderList, ReorderListProps, Resizable, ResizableProps, Responsive, ScrollArea, ScrollAreaProps, Search, SearchProps, SegmentedControl, SegmentedControlOption, SegmentedControlProps, Select, SelectOption, SelectProps, Separator, SeparatorProps, Sheet, SheetProps, ShellHeader, ShellHeaderAction, ShellHeaderBrand, ShellHeaderLabels, ShellHeaderNavItem, ShellHeaderNavLink, ShellHeaderNavMenu, ShellHeaderNavMenuItem, ShellHeaderProps, SideNav, SideNavGroup, SideNavItem, SideNavLinkProps, SideNavLinkSubItem, SideNavProps, SideNavSubItem, SideNavTone, Skeleton, SkeletonProps, SkipNavLink, SkipNavLinkProps, SkipNavTarget, SkipNavTargetProps, Slider, SliderProps, Slot, type SlotProps, SortDirection, SortState, Spacer, SpacerProps, Spinner, SpinnerProps, Stack, StackProps, type StandardSchemaV1, Stat, StatProps, Status, StatusProps, Step, StepState, Steps, StepsProps, StructuredList, StructuredListItem, StructuredListProps, SuspenseBoundary, Swap, SwapMode, SwapProps, SwipeAction, SwipeItem, SwipeItemProps, Switcher, SwitcherEntry, SwitcherLink, SwitcherProps, Tabs, TabsContent, TabsContentProps, TabsList, TabsProps, TabsTrigger, TabsTriggerProps, Tag, TagProps, TagsInput, TagsInputProps, Text, TextProps, Textarea, TextareaProps, ThemeProvider, type ThemeProviderProps, Tile, TileProps, TimePicker, TimePickerProps, Timeline, TimelineItem, TimelineProps, ToastOptions, ToastProvider, ToastVariant, Toc, TocItem, TocProps, Toggle, ToggleGroup, ToggleGroupItem, ToggleGroupProps, ToggleProps, Toggletip, ToggletipPlacement, ToggletipProps, Tooltip, TooltipProps, TreeNode, TreeView, TreeViewProps, UploaderFile, type UseClipboardOptions, type UseClipboardReturn, type UseControllableSignalOptions, type UseDisclosureOptions, type UseDisclosureReturn, type UsePopoverOptions, type UsePopoverReturn, type UseTocFromRegionOptions, User, UserProps, VirtualList, VirtualListProps, VisuallyHidden, VisuallyHiddenProps, WheelPicker, WheelPickerOption, WheelPickerProps, applyTheme, batch, cn, composeRefs, computePosition, computed, createForm, createMachine, createScope, createStreamBuffer, dismissAllToasts, effect, fuzzyMatch, fuzzyScore, getLinkComponent, mergeProps, setLinkComponent, setTheme, signal, themePreloadScript, themeSignal, treeViewMessages, useAnchorPosition, useClipboard, useComputed, useControllableSignal, useDisclosure, useEffectPropSignal, useForm, useId, useMachine, useMediaQuery, usePopover, useRovingFocus, useScope, useScrollLock, useSignal, useSignalEffect, useSignals, useStreamBuffer, useTheme, useToast, useTocFromRegion, useTypeahead };
+export {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionItemProps,
+  AccordionProps,
+  AccordionTrigger,
+  ActionSheet,
+  ActionSheetAction,
+  ActionSheetProps,
+  type AggregateKind,
+  Alert,
+  AlertDialog,
+  AlertDialogLabels,
+  AlertDialogProps,
+  AlertProps,
+  AppShell,
+  AppShellProps,
+  AspectRatio,
+  AspectRatioProps,
+  AutoGrid,
+  AutoGridProps,
+  Avatar,
+  AvatarGroup,
+  AvatarGroupLabels,
+  AvatarGroupProps,
+  AvatarProps,
+  Badge,
+  BadgeProps,
+  Blockquote,
+  BlockquoteProps,
+  BottomSheet,
+  BottomSheetProps,
+  Breadcrumb,
+  BreadcrumbItem,
+  BreadcrumbProps,
+  Button,
+  ButtonGroup,
+  ButtonGroupProps,
+  ButtonProps,
+  Calendar,
+  CalendarLabels,
+  CalendarProps,
+  Card,
+  CardContent,
+  CardContentProps,
+  CardFooter,
+  CardFooterProps,
+  CardHeader,
+  CardHeaderProps,
+  CardProps,
+  CardTitle,
+  CardTitleProps,
+  Carousel,
+  CarouselLabels,
+  CarouselProps,
+  Center,
+  CenterProps,
+  ChatBubble,
+  ChatBubbleProps,
+  ChatBubbleSide,
+  Checkbox,
+  CheckboxCard,
+  CheckboxCardProps,
+  CheckboxProps,
+  Code,
+  type CodeLang,
+  CodeProps,
+  CodeSnippet,
+  CodeSnippetProps,
+  Collapsible,
+  CollapsibleProps,
+  type ColorFormat,
+  ColorPicker,
+  ColorPickerLabels,
+  ColorPickerProps,
+  Column,
+  type ColumnGroup,
+  ColumnSettings,
+  type ColumnState,
+  Columns,
+  ColumnsProps,
+  Combobox,
+  ComboboxLabels,
+  type ComboboxOption,
+  ComboboxProps,
+  CommandAction,
+  CommandGroup,
+  CommandItem,
+  CommandMenu,
+  CommandMenuProps,
+  CommandPage,
+  CommandScope,
+  CommandStatus,
+  Comparison,
+  ComparisonProps,
+  ContainedList,
+  ContainedListItem,
+  ContainedListItemProps,
+  ContainedListProps,
+  ContextMenu,
+  ContextMenuItem,
+  ContextMenuItemProps,
+  ContextMenuProps,
+  CopyButton,
+  CopyButtonProps,
+  DataList,
+  DataListItem,
+  DataListProps,
+  DataTable,
+  DataTableLabels,
+  DataTableProps,
+  DataTableServer,
+  DatePicker,
+  DatePickerLabels,
+  DatePickerProps,
+  DateRange,
+  DateRangePicker,
+  DateRangePickerLabels,
+  DateRangePickerProps,
+  DateRangePreset,
+  DismissableLayer,
+  type DismissableLayerProps,
+  Dock,
+  DockItem,
+  DockProps,
+  Drawer,
+  DrawerProps,
+  Dropdown,
+  DropdownItem,
+  DropdownMenuItem,
+  DropdownProps,
+  DropdownSeparatorItem,
+  Editable,
+  EditableProps,
+  EmptyState,
+  EmptyStateProps,
+  ErrorBoundary,
+  Fab,
+  FabAction,
+  FabProps,
+  Field,
+  FieldProps,
+  FileUploader,
+  FileUploaderLabels,
+  FileUploaderProps,
+  Filter,
+  FilterOption,
+  FilterProps,
+  FilterVariant,
+  Flex,
+  FlexProps,
+  FocusScope,
+  Form,
+  FormConfig,
+  FormProps,
+  FormStore,
+  FuzzyMatch,
+  Grid,
+  GridAlign,
+  GridItem,
+  GridItemProps,
+  GridProps,
+  Header,
+  HeaderLabels,
+  HeaderLink,
+  HeaderPanel,
+  HeaderPanelLabels,
+  HeaderPanelProps,
+  HeaderProps,
+  Heading,
+  HeadingLevel,
+  HeadingProps,
+  HeadingSize,
+  HoverCard,
+  HoverCardContent,
+  HoverCardContentProps,
+  HoverCardProps,
+  HoverCardTrigger,
+  HoverCardTriggerProps,
+  IconButton,
+  IconButtonProps,
+  Image,
+  ImageProps,
+  Indicator,
+  IndicatorPlacement,
+  IndicatorProps,
+  InfiniteScroll,
+  InfiniteScrollProps,
+  InlineLoading,
+  InlineLoadingProps,
+  InlineLoadingStatus,
+  Input,
+  InputGroup,
+  InputGroupAddon,
+  type InputGroupAddonProps,
+  type InputGroupProps,
+  InputProps,
+  Item,
+  ItemActions,
+  ItemActionsProps,
+  ItemContent,
+  ItemContentProps,
+  ItemDescription,
+  ItemDescriptionProps,
+  ItemMedia,
+  ItemMediaProps,
+  ItemProps,
+  ItemTitle,
+  ItemTitleProps,
+  Join,
+  JoinOrientation,
+  JoinProps,
+  Kbd,
+  KbdProps,
+  Label,
+  LabelProps,
+  LargeTitleHeader,
+  LargeTitleHeaderProps,
+  Link,
+  type LinkComponent,
+  type LinkComponentProps,
+  LinkProps,
+  List,
+  ListItem,
+  ListItemProps,
+  ListProps,
+  LogLevel,
+  LogLine,
+  LogViewer,
+  LogViewerLabels,
+  LogViewerProps,
+  Logo,
+  LogoProps,
+  LogoVariant,
+  type Machine,
+  type MachineConfig,
+  Menu,
+  MenuButton,
+  MenuButtonItem,
+  MenuButtonProps,
+  MenuItem,
+  MenuItemProps,
+  MenuProps,
+  MenuSeparator,
+  MenuTrigger,
+  MenuTriggerProps,
+  Menubar,
+  MenubarBaseProps,
+  MenubarItem,
+  MenubarMenu,
+  MenubarProps,
+  Modal,
+  ModalProps,
+  MultiSelect,
+  MultiSelectLabels,
+  type MultiSelectOption,
+  MultiSelectProps,
+  NativeSelect,
+  NativeSelectOption,
+  NativeSelectProps,
+  NavigationMenu,
+  NavigationMenuItem,
+  NavigationMenuProps,
+  Notification,
+  NotificationProps,
+  NotificationVariant,
+  NumberInput,
+  NumberInputProps,
+  OtpInput,
+  OtpInputProps,
+  OverflowMenu,
+  OverflowMenuItem,
+  OverflowMenuProps,
+  PageHeader,
+  PageHeaderProps,
+  Pagination,
+  PaginationLabels,
+  PaginationProps,
+  PasswordInput,
+  PasswordInputLabels,
+  PasswordInputProps,
+  type PinSide,
+  Popover,
+  PopoverContent,
+  PopoverContentProps,
+  PopoverProps,
+  PopoverTrigger,
+  PopoverTriggerProps,
+  Portal,
+  Presence,
+  Progress,
+  ProgressBar,
+  ProgressBarProps,
+  ProgressCircle,
+  ProgressCircleProps,
+  ProgressIndicator,
+  ProgressIndicatorProps,
+  ProgressProps,
+  ProgressSize,
+  ProgressStep,
+  ProgressVariant,
+  Prose,
+  ProseProps,
+  PullToRefresh,
+  PullToRefreshProps,
+  QrCode,
+  QrCodeProps,
+  RadialProgress,
+  RadialProgressProps,
+  RadialProgressSize,
+  RadialProgressVariant,
+  Radio,
+  RadioCard,
+  RadioCardGroup,
+  RadioCardGroupProps,
+  RadioCardProps,
+  RadioGroup,
+  RadioGroupProps,
+  RadioProps,
+  RatingGroup,
+  RatingGroupLabels,
+  RatingGroupProps,
+  RelativeTime,
+  RelativeTimeProps,
+  ReorderItem,
+  ReorderList,
+  ReorderListProps,
+  Resizable,
+  ResizableProps,
+  Responsive,
+  RowAction,
+  ScrollArea,
+  ScrollAreaProps,
+  Search,
+  SearchProps,
+  SegmentedControl,
+  SegmentedControlOption,
+  SegmentedControlProps,
+  Select,
+  SelectOption,
+  SelectProps,
+  Separator,
+  SeparatorProps,
+  Sheet,
+  SheetProps,
+  ShellHeader,
+  ShellHeaderAction,
+  ShellHeaderBrand,
+  ShellHeaderLabels,
+  ShellHeaderNavItem,
+  ShellHeaderNavLink,
+  ShellHeaderNavMenu,
+  ShellHeaderNavMenuItem,
+  ShellHeaderProps,
+  SideNav,
+  SideNavGroup,
+  SideNavItem,
+  SideNavLinkProps,
+  SideNavLinkSubItem,
+  SideNavProps,
+  SideNavSubItem,
+  SideNavTone,
+  Skeleton,
+  SkeletonProps,
+  SkipNavLink,
+  SkipNavLinkProps,
+  SkipNavTarget,
+  SkipNavTargetProps,
+  Slider,
+  SliderProps,
+  Slot,
+  type SlotProps,
+  SortDirection,
+  SortKey,
+  SortState,
+  Spacer,
+  SpacerProps,
+  Spinner,
+  SpinnerProps,
+  Stack,
+  StackProps,
+  type StandardSchemaV1,
+  Stat,
+  StatProps,
+  Status,
+  StatusProps,
+  Step,
+  StepState,
+  Steps,
+  StepsProps,
+  StructuredList,
+  StructuredListItem,
+  StructuredListProps,
+  SuspenseBoundary,
+  Swap,
+  SwapMode,
+  SwapProps,
+  SwipeAction,
+  SwipeItem,
+  SwipeItemProps,
+  Toggle as Switch,
+  Toggle,
+  type ToggleProps as SwitchProps,
+  ToggleProps,
+  Switcher,
+  SwitcherEntry,
+  SwitcherLink,
+  SwitcherProps,
+  TableQuery,
+  Tabs,
+  TabsContent,
+  TabsContentProps,
+  TabsList,
+  TabsProps,
+  TabsTrigger,
+  TabsTriggerProps,
+  Tag,
+  TagProps,
+  TagsInput,
+  TagsInputProps,
+  Text,
+  TextProps,
+  Textarea,
+  TextareaProps,
+  ThemeProvider,
+  type ThemeProviderProps,
+  Tile,
+  TileProps,
+  TimePicker,
+  TimePickerProps,
+  Timeline,
+  TimelineItem,
+  TimelineProps,
+  ToastOptions,
+  ToastProvider,
+  ToastVariant,
+  Toc,
+  TocItem,
+  TocProps,
+  ToggleGroup,
+  ToggleGroupItem,
+  ToggleGroupProps,
+  Toggletip,
+  ToggletipPlacement,
+  ToggletipProps,
+  Tooltip,
+  TooltipProps,
+  TreeNode,
+  TreeView,
+  TreeViewProps,
+  UploaderFile,
+  type UseClipboardOptions,
+  type UseClipboardReturn,
+  type UseControllableSignalOptions,
+  type UseDisclosureOptions,
+  type UseDisclosureReturn,
+  type UsePopoverOptions,
+  type UsePopoverReturn,
+  type UseTocFromRegionOptions,
+  User,
+  UserProps,
+  VirtualList,
+  VirtualListProps,
+  VisuallyHidden,
+  VisuallyHiddenProps,
+  WheelPicker,
+  WheelPickerOption,
+  WheelPickerProps,
+  applyTheme,
+  batch,
+  cn,
+  composeRefs,
+  computePosition,
+  computed,
+  createForm,
+  createMachine,
+  createScope,
+  createStreamBuffer,
+  dismissAllToasts,
+  effect,
+  fuzzyMatch,
+  fuzzyScore,
+  getLinkComponent,
+  mergeProps,
+  setLinkComponent,
+  setTheme,
+  signal,
+  themePreloadScript,
+  themeSignal,
+  treeViewMessages,
+  useAnchorPosition,
+  useClipboard,
+  useComputed,
+  useControllableSignal,
+  useDisclosure,
+  useEffectPropSignal,
+  useForm,
+  useId,
+  useMachine,
+  useMediaQuery,
+  usePopover,
+  useRovingFocus,
+  useScope,
+  useScrollLock,
+  useSignal,
+  useSignalEffect,
+  useSignals,
+  useStreamBuffer,
+  useTheme,
+  useToast,
+  useTocFromRegion,
+  useTypeahead,
+};