@cascivo/react 0.18.0 → 1.0.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
@@ -264,7 +370,9 @@ declare function Separator({
 }: SeparatorProps): 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,6 +538,20 @@ 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;
@@ -471,6 +593,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 +622,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 +654,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 +699,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 +723,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 +747,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 +773,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 +794,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 +844,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 +975,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 +1043,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 +1106,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 +1273,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 +1302,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 +1340,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 +1352,7 @@ declare function SideNav({
   defaultCollapsed,
   onCollapsedChange,
   ariaLabel,
+  label,
   collapseLabel,
   expandLabel,
   expandOnHover,
@@ -1150,6 +1396,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 +1426,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 +1455,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 +1537,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 +1560,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 +1583,7 @@ interface FabProps {
  */
 declare function Fab({
   children,
+  ariaLabel,
   label,
   onClick,
   actions,
@@ -1347,7 +1618,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,6 +1632,14 @@ 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';
   disabled?: boolean;
   className?: string;
@@ -1369,17 +1649,28 @@ declare function OverflowMenu({
   onSelect,
   placement,
   ariaLabel,
+  label,
   size,
   disabled,
   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 +1697,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 +1728,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;
   /**
@@ -1503,6 +1819,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
@@ -1599,7 +1920,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;
@@ -1651,6 +1981,7 @@ declare function DataTable<Row>({
   loading,
   emptyState,
   title,
+  ariaLabel,
   description,
   labels,
   className,
@@ -1735,12 +2066,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 +2121,7 @@ declare function CommandMenu({
   emptyLabel,
   hotkey,
   label,
+  ariaLabel,
   loading,
   onQueryChange,
   scopes,
@@ -1874,13 +2214,24 @@ interface ComboboxLabels {
   search?: 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.
    *
@@ -1896,6 +2247,16 @@ interface ComboboxProps {
    */
   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';
@@ -1909,17 +2270,20 @@ declare function Combobox({
   value,
   defaultValue,
   onValueChange,
-  onChange,
   clearable,
   searchable,
   label,
+  ariaLabel,
   hint,
   error,
   size,
   disabled,
   labels,
   className,
-  id
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid
 }: ComboboxProps): import("react").JSX.Element;
 interface DatePickerLabels {
   placeholder?: string;
@@ -1928,12 +2292,23 @@ interface DatePickerLabels {
   clear?: 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;
   /**
@@ -1944,6 +2319,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;
   /**
@@ -1968,18 +2353,21 @@ declare function DatePicker({
   value,
   defaultValue,
   onValueChange,
-  onChange,
   min,
   max,
   clearable,
   label,
+  ariaLabel,
   hint,
   error,
   size,
   disabled,
   labels,
   className,
-  id
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid
 }: DatePickerProps): import("react").JSX.Element;
 interface UploaderFile {
   id: string;
@@ -2017,6 +2405,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 +2435,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 +2570,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 +2594,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 +2696,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 +2710,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 +2730,7 @@ declare function Comparison({
   orientation,
   keyboardStep,
   label,
+  ariaLabel,
   className,
   ...props
 }: ComparisonProps): import("react").JSX.Element;
@@ -2419,6 +2842,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 +2873,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'> {
@@ -2569,6 +3020,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 +3041,10 @@ declare function Editable({
   submitOnBlur,
   onCancel,
   className,
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid,
   ...props
 }: EditableProps): import("react").JSX.Element;
 interface RadioCardGroupProps {
@@ -2732,17 +3199,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 +3378,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 +3393,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 +3412,7 @@ declare function Progress({
   size,
   className,
   ariaLabel,
+  label,
   ...aria
 }: ProgressProps): import("react").JSX.Element;
 interface ProgressCircleProps extends HTMLAttributes<HTMLDivElement> {
@@ -2941,6 +3435,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 +3450,7 @@ declare function ProgressCircle({
   size,
   showValue,
   label,
+  ariaLabel,
   className,
   ...props
 }: ProgressCircleProps): import("react").JSX.Element;
@@ -2972,7 +3475,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 +3485,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 +3528,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 +3706,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 +3726,7 @@ declare function QrCode({
   fill,
   background,
   label,
+  ariaLabel,
   className,
   style,
   ...props
@@ -3279,8 +3795,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 +3828,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 +3838,7 @@ interface FieldProps {
 declare function Field({
   label,
   description,
+  hint,
   error,
   required,
   disabled,
@@ -3335,8 +3863,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 +3871,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 +3894,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 +3911,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 +3925,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 +3957,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,7 +4000,8 @@ 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
@@ -3486,9 +4034,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;
   /**
@@ -3711,9 +4262,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 +4285,7 @@ declare function NavigationMenu({
   items,
   'aria-label': ariaLabelDom,
   ariaLabel,
+  label,
   orientation,
   className
 }: NavigationMenuProps): import("react").JSX.Element;
@@ -3749,6 +4310,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({
@@ -3762,7 +4331,8 @@ declare function TreeView({
   onExpandedChange,
   className,
   'aria-label': ariaLabelDom,
-  ariaLabel
+  ariaLabel,
+  label
 }: TreeViewProps): import("react").JSX.Element;
 declare const treeViewMessages: {
   loading: () => string;
@@ -3805,6 +4375,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 +4418,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 +4480,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 +4504,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
@@ -4035,6 +4621,13 @@ interface DateRange {
   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;
 }
@@ -4095,6 +4688,20 @@ interface ColorPickerLabels {
   eyedropper?: 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.
@@ -4107,6 +4714,16 @@ interface ColorPickerProps {
   presets?: string[];
   alpha?: 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;
   /**
    * When true, disables the control and removes it from the tab order.
    *
@@ -4125,10 +4742,15 @@ declare function ColorPicker({
   presets,
   alpha,
   label,
+  ariaLabel,
   disabled,
   size,
   className,
-  labels
+  labels,
+  id,
+  'aria-labelledby': ariaLabelledBy,
+  'aria-describedby': ariaDescribedBy,
+  'aria-invalid': ariaInvalid
 }: ColorPickerProps): import("react").JSX.Element;
 interface CarouselLabels {
   region?: string;
@@ -4170,7 +4792,8 @@ declare function Carousel({
 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 +4824,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 +4842,8 @@ declare function Resizable({
   maxRatio,
   onRatioChange,
   className,
-  label
+  label,
+  ariaLabel
 }: ResizableProps): import("react").JSX.Element;
 interface DockItem {
   /**
@@ -4235,12 +4867,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 +5031,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 +5057,7 @@ declare function VirtualList<Item>({
   renderItem,
   overscan,
   ariaLabel,
+  label,
   className
 }: VirtualListProps<Item>): import("react").JSX.Element;
 interface WheelPickerOption {
@@ -4433,6 +5083,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 +5111,7 @@ declare function WheelPicker({
   visibleCount,
   itemHeight,
   ariaLabel,
+  label,
   className
 }: WheelPickerProps): import("react").JSX.Element;
 interface DrawerProps {
@@ -4612,11 +5271,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 +5299,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 +5379,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 +5398,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 +5508,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 +5534,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 +5547,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 +5565,7 @@ declare function RadialProgress({
   children,
   className,
   ariaLabel,
+  label: labelProp,
   ...aria
 }: RadialProgressProps): import("react").JSX.Element;
 type SwapMode = 'rotate' | 'flip';
@@ -4870,14 +5581,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 +5603,10 @@ declare function Swap({
   off,
   checked,
   onValueChange,
-  onChange,
   mode,
   className,
   ariaLabel,
+  label,
   ...aria
 }: SwapProps): import("react").JSX.Element;
 interface SwipeAction {
@@ -5129,4 +5846,504 @@ 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,
+  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,
+  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,
+  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,
+  Toggle as Switch,
+  Toggle,
+  type ToggleProps as SwitchProps,
+  ToggleProps,
+  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,
+  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,
+};