@viraui/react 2026.7.0-next.0 → 2026.7.0-next.1

package/dist/components/text/text.d.ts

@@ -9,19 +9,19 @@ type TextAxisPadding = TextSpace | [TextSpace | 0, TextSpace | 0];
  * Includes standard inline text attributes such as `children`, `id`, `title`, and event handlers,
  * plus Vira-owned body typography, color, and layout controls.
  *
- * @default Base HTML pass-through props keep upstream defaults.
+ * @defaultValue Base HTML pass-through props keep upstream defaults.
  */
 export type TextProps = React.ComponentPropsWithoutRef<'span'> & {
     /**
      * Replaces the default `span` root using Base UI render semantics.
      *
-     * @default The text renders a `span` root.
+     * @defaultValue The text renders a `span` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered text root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
@@ -29,19 +29,19 @@ export type TextProps = React.ComponentPropsWithoutRef<'span'> & {
      * (`4xl` | `3xl` | `2xl` | `xl` | `l` | `m` | `s` | `xs`).
      * Omit when nested in Text so font-size inherits the outer Text size.
      *
-     * @default 'm' on root Text (CSS); inherit when nested and omitted
+     * @defaultValue 'm' on root Text (CSS); inherit when nested and omitted
      */
     size?: '4xl' | '3xl' | '2xl' | 'xl' | 'l' | 'm' | 's' | 'xs';
     /**
      * Selects the semantic font family for body copy and inline code-like text.
      *
-     * @default 'body'
+     * @defaultValue 'body'
      */
     family?: 'body' | 'mono';
     /**
      * Selects a semantic weight keyword or a numeric weight (`font-weight` + `wght` axis).
      *
-     * @default 'regular'
+     * @defaultValue 'regular'
      */
     weight?: 'light' | 'regular' | 'semibold' | 'bold' | number;
     /**
@@ -50,102 +50,102 @@ export type TextProps = React.ComponentPropsWithoutRef<'span'> & {
      * `interactive` → `--global-interactive-text`; `positive` / `informative` / `danger` / `warning`
      * → `--highlight-green` / `--highlight-blue` / `--highlight-red` / `--highlight-yellow`.
      *
-     * @default No semantic tone override.
+     * @defaultValue No semantic tone override.
      */
     tone?: 'default' | 'primary' | 'muted' | 'interactive' | 'positive' | 'informative' | 'danger' | 'warning';
     /**
      * Applies a custom color as an escape hatch when semantic `tone` is not used.
      *
-     * @default No literal color override.
+     * @defaultValue No literal color override.
      */
     color?: string;
     /**
      * Controls line height through foundation leading tokens.
      * Omit when nested in Text so line-height inherits the outer Text.
      *
-     * @default 'm' on root Text (CSS); inherit when nested and omitted
+     * @defaultValue 'm' on root Text (CSS); inherit when nested and omitted
      */
     lineHeight?: 'none' | 'xs' | 's' | 'm' | 'l';
     /**
      * Aligns text using logical alignment values.
      * Omit so `text-align` inherits from the parent.
      *
-     * @default Inherits parent `text-align`.
+     * @defaultValue Inherits parent `text-align`.
      */
     align?: React.CSSProperties['textAlign'];
     /**
      * Constrains the maximum inline size of the rendered text block.
      *
-     * @default No max width constraint.
+     * @defaultValue No max width constraint.
      */
     maxWidth?: string;
     /**
      * Controls white-space preservation and wrapping behavior.
      *
-     * @default 'normal'
+     * @defaultValue 'normal'
      */
     whiteSpace?: React.CSSProperties['whiteSpace'];
     /**
      * Sets letter-spacing on the rendered copy. Prefer this prop over CSS
      * `letter-spacing` on the same Text root.
      *
-     * @default No letter-spacing override.
+     * @defaultValue No letter-spacing override.
      */
     tracking?: React.CSSProperties['letterSpacing'];
     /**
      * Applies `text-transform` on the rendered copy. Prefer this prop over CSS
      * `text-transform` on the same Text root.
      *
-     * @default No text-transform override.
+     * @defaultValue No text-transform override.
      */
     transform?: React.CSSProperties['textTransform'];
     /**
      * Enables balanced wrapping for block-like copy.
      *
-     * @default false
+     * @defaultValue false
      */
     balanced?: boolean;
     /**
      * Enables text selection on the rendered copy.
      *
-     * @default true
+     * @defaultValue true
      */
     selection?: boolean;
     /**
      * Sets inline padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No inline padding.
+     * @defaultValue No inline padding.
      */
     hPadding?: TextAxisPadding;
     /**
      * Sets block padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No block padding.
+     * @defaultValue No block padding.
      */
     vPadding?: TextAxisPadding;
     /**
      * Trims text box whitespace at the chosen edge when the browser supports `text-box`.
      * Pass `false` to disable text-box trim.
      *
-     * @default 'both'
+     * @defaultValue 'both'
      */
     trim?: 'start' | 'end' | 'both' | false;
     /**
      * Selects the `text-box` trim basis when `trim` is active.
      *
-     * @default 'cap alphabetic'
+     * @defaultValue 'cap alphabetic'
      */
     trimType?: string;
     /**
      * Overrides font width as a percentage (100 = normal); maps to `font-stretch` and `wdth`.
      *
-     * @default No width override.
+     * @defaultValue No width override.
      */
     fontWidth?: number;
     /**
      * Overrides the optical size (`opsz`) axis on variable fonts; static fonts keep `font-optical-sizing: auto`.
      *
-     * @default No optical size override.
+     * @defaultValue No optical size override.
      */
     opticalSize?: number;
     /**
@@ -153,7 +153,7 @@ export type TextProps = React.ComponentPropsWithoutRef<'span'> & {
      * Default locks at this size’s `--font-scale-body-*` token (UI chrome stays stable).
      * Pass `true` for fluid page/body copy. Theme `--effect-fluid-typography: initial` still locks all Text globally.
      *
-     * @default false
+     * @defaultValue false
      */
     fluid?: boolean;
 };

package/dist/components/textarea/textarea.d.ts

@@ -8,19 +8,19 @@ import type * as React from 'react';
  * `rows`, and event handlers on `Field.Control` (`render={<textarea />}`), plus optional
  * `label`, `description`, and `error` copy rendered with `Text` inside a `Stack` field layout.
  *
- * @default Base UI `Field.Root` pass-through props keep upstream defaults.
+ * @defaultValue Base UI `Field.Root` pass-through props keep upstream defaults.
  */
 export type TextareaProps = React.ComponentPropsWithRef<'textarea'> & Omit<FieldRoot.Props, 'ref'> & {
     /**
      * Visible label rendered with shared internal `FieldLabel`.
      *
-     * @default No label is rendered.
+     * @defaultValue No label is rendered.
      */
     label?: React.ReactNode;
     /**
      * Helper copy rendered with `Field.Description` and `Text` while the field is valid.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
@@ -28,7 +28,7 @@ export type TextareaProps = React.ComponentPropsWithRef<'textarea'> & Omit<Field
      * Replaces description while the field is invalid and dirty. Validation messages from `validate`
      * are shown by `Field.Error` even when this prop is omitted.
      *
-     * @default No static error copy is rendered.
+     * @defaultValue No static error copy is rendered.
      */
     error?: React.ReactNode;
     /**
@@ -36,14 +36,14 @@ export type TextareaProps = React.ComponentPropsWithRef<'textarea'> & Omit<Field
      * (`none`); accepts any valid `CSSProperties['resize']` value such as `"vertical"`, `"horizontal"`,
      * or `"both"`.
      *
-     * @default undefined (no resize)
+     * @defaultValue undefined (no resize)
      */
     resize?: React.CSSProperties['resize'];
     /**
      * When `true`, sets `field-sizing: content` so the control grows with its value.
      * Still respects `min-block-size` and `resize`. Omitted / `false` keeps the browser fixed default.
      *
-     * @default undefined (browser fixed)
+     * @defaultValue undefined (browser fixed)
      */
     fitContent?: BasicInputProps['fitContent'];
 };

package/dist/components/textfield/textfield.d.ts

@@ -9,7 +9,7 @@ import type * as React from 'react';
  * `size`, and event handlers, plus optional `label`, `description`, and `error` copy rendered with
  * `Text` inside a `Stack` field layout. `controlOnly` skips Field chrome for compose inside another Field.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type TextfieldProps = PrimitiveInput.Props & Omit<FieldRoot.Props, 'render' | keyof PrimitiveInput.Props> & {
     /**

package/dist/components/title/title.d.ts

@@ -9,7 +9,7 @@ type TitleAxisPadding = TitleSpace | [TitleSpace | 0, TitleSpace | 0];
  * Includes standard text and heading HTML attributes such as `children`, `id`, `title`, and event handlers,
  * plus Vira-owned heading typography, color, and layout controls.
  *
- * @default Base HTML pass-through props keep upstream defaults.
+ * @defaultValue Base HTML pass-through props keep upstream defaults.
  */
 export type TitleProps = React.ComponentPropsWithoutRef<'span'> & {
     /**
@@ -17,13 +17,13 @@ export type TitleProps = React.ComponentPropsWithoutRef<'span'> & {
      *
      * Pair this with `size` for most headings so DOM semantics and visual preset stay intentionally aligned.
      *
-     * @default The title renders a `span` root.
+     * @defaultValue The title renders a `span` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered title root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
@@ -32,44 +32,44 @@ export type TitleProps = React.ComponentPropsWithoutRef<'span'> & {
      * This controls only the visual preset. Semantic heading choice remains owned by `render`,
      * because `Title` keeps a `span` root unless `render` replaces it.
      *
-     * @default '1'
+     * @defaultValue '1'
      */
     size?: 'display' | '1' | '2' | '3' | '4' | '5' | '6';
     /**
      * Overrides the size preset weight (`font-weight` + `wght` axis).
      *
-     * @default No weight override.
+     * @defaultValue No weight override.
      */
     weight?: number;
     /**
      * Applies a literal color escape hatch.
      *
-     * @default No literal color override.
+     * @defaultValue No literal color override.
      */
     color?: string;
     /**
      * Controls line height through foundation leading tokens.
      *
-     * @default 'm'
+     * @defaultValue 'm'
      */
     lineHeight?: 'none' | 'xs' | 's' | 'm' | 'l';
     /**
      * Aligns text using logical alignment values.
      * Omit so `text-align` inherits from the parent.
      *
-     * @default Inherits parent `text-align`.
+     * @defaultValue Inherits parent `text-align`.
      */
     align?: React.CSSProperties['textAlign'];
     /**
      * Constrains the maximum inline size of the rendered text block.
      *
-     * @default No max width constraint.
+     * @defaultValue No max width constraint.
      */
     maxWidth?: string;
     /**
      * Controls white-space preservation and wrapping behavior.
      *
-     * @default 'normal'
+     * @defaultValue 'normal'
      */
     whiteSpace?: React.CSSProperties['whiteSpace'];
     /**
@@ -78,63 +78,63 @@ export type TitleProps = React.ComponentPropsWithoutRef<'span'> & {
      *
      * Overrides size preset letter-spacing when set.
      *
-     * @default No letter-spacing override.
+     * @defaultValue No letter-spacing override.
      */
     tracking?: React.CSSProperties['letterSpacing'];
     /**
      * Applies `text-transform` on the rendered copy. Prefer this prop over CSS
      * `text-transform` on the same Title root.
      *
-     * @default No text-transform override.
+     * @defaultValue No text-transform override.
      */
     transform?: React.CSSProperties['textTransform'];
     /**
      * Enables balanced wrapping for block-like titles.
      *
-     * @default false
+     * @defaultValue false
      */
     balanced?: boolean;
     /**
      * Enables text selection on the rendered copy.
      *
-     * @default true
+     * @defaultValue true
      */
     selection?: boolean;
     /**
      * Sets inline padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No inline padding.
+     * @defaultValue No inline padding.
      */
     hPadding?: TitleAxisPadding;
     /**
      * Sets block padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No block padding.
+     * @defaultValue No block padding.
      */
     vPadding?: TitleAxisPadding;
     /**
      * Trims text box whitespace at the chosen edge when the browser supports `text-box`.
      * Pass `false` to disable text-box trim.
      *
-     * @default 'both'
+     * @defaultValue 'both'
      */
     trim?: 'start' | 'end' | 'both' | false;
     /**
      * Selects the `text-box` trim basis when `trim` is active.
      *
-     * @default 'cap alphabetic'
+     * @defaultValue 'cap alphabetic'
      */
     trimType?: string;
     /**
      * Overrides font width as a percentage (100 = normal); maps to `font-stretch` and `wdth`.
      *
-     * @default No width override.
+     * @defaultValue No width override.
      */
     fontWidth?: number;
     /**
      * Overrides the optical size (`opsz`) axis on variable fonts; static fonts keep `font-optical-sizing: auto`.
      *
-     * @default No optical size override.
+     * @defaultValue No optical size override.
      */
     opticalSize?: number;
     /**
@@ -142,7 +142,7 @@ export type TitleProps = React.ComponentPropsWithoutRef<'span'> & {
      * Pass `false` to lock at this size’s `--font-scale-display` / `--font-scale-h*` token.
      * Theme `--effect-fluid-typography: initial` still locks all Title globally.
      *
-     * @default true
+     * @defaultValue true
      */
     fluid?: boolean;
 };

package/dist/components/toast/toast-action.d.ts

@@ -3,7 +3,7 @@ import type * as React from 'react';
 /**
  * Public Toast.Action props.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type ToastActionProps = ToastActionNamespace.Props;
 export declare const ToastAction: React.FC<ToastActionProps>;

package/dist/components/toast/toast-banner.d.ts

@@ -15,43 +15,43 @@ export type ToastBannerProps = ToastRootNamespace.Props & {
     /**
      * Heading above the description. Falls back to `toast.title` from `toastManager.add`.
      *
-     * @default `toast.title` when set on the toast instance.
+     * @defaultValue `toast.title` when set on the toast instance.
      */
     title?: React.ReactNode;
     /**
      * Supporting copy below the title.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
      * Whether to render the dismiss control.
      *
-     * @default true
+     * @defaultValue true
      */
     dismissable?: boolean;
     /**
      * Label for the dismiss control.
      *
-     * @default 'Dismiss'
+     * @defaultValue 'Dismiss'
      */
     dismissLabel?: React.ReactNode;
     /**
      * Called when the dismiss control is activated, before Base UI closes the toast.
      *
-     * @default No callback is invoked.
+     * @defaultValue No callback is invoked.
      */
     onDismiss?: () => void;
     /**
      * Optional action buttons. Accepts a single `Toast.Action` or an array of them.
      *
-     * @default No actions are rendered.
+     * @defaultValue No actions are rendered.
      */
     children?: ToastBannerChildren;
     /**
      * Class name forwarded to the toast root.
      *
-     * @default No extra class name.
+     * @defaultValue No extra class name.
      */
     className?: string;
 };

package/dist/components/toast/toast-viewport.d.ts

@@ -4,13 +4,13 @@ export type ToastViewportPosition = 'bottom-right' | 'bottom-left' | 'bottom-cen
 /**
  * Public Toast.Viewport props.
  *
- * @default `position` is `bottom-right`.
+ * @defaultValue `position` is `bottom-right`.
  */
 export type ToastViewportProps = ToastViewportNamespace.Props & {
     /**
      * Controls viewport placement and stacking layout hooks.
      *
-     * @default 'bottom-right'
+     * @defaultValue 'bottom-right'
      */
     position?: ToastViewportPosition;
 };

package/dist/components/toggle-button/toggle-button.d.ts

@@ -15,38 +15,38 @@ type ToggleButtonAccessibleNameProps = {
  * Icon-only two-state control built on Base UI `Toggle` and `IconButton`.
  * Requires an accessible name via `aria-label` or `aria-labelledby`.
  *
- * @default Base UI toggle pass-through props keep upstream defaults.
+ * @defaultValue Base UI toggle pass-through props keep upstream defaults.
  */
 export type ToggleButtonProps = Omit<IconButtonProps, 'icon' | 'render' | 'variant' | 'children' | 'aria-label' | 'aria-labelledby'> & Omit<TogglePrimitive.Props, 'render' | 'children' | 'aria-label' | 'aria-labelledby'> & ToggleButtonAccessibleNameProps & {
     /**
      * Icon shown while the toggle is not pressed.
      *
-     * @default No default; required for every ToggleButton.
+     * @defaultValue No default; required for every ToggleButton.
      */
     restingIcon: ReactNode;
     /**
      * Icon shown while the toggle is pressed.
      *
-     * @default When omitted, `restingIcon` is shown in both states.
+     * @defaultValue When omitted, `restingIcon` is shown in both states.
      */
     pressedIcon?: ReactNode;
     /**
      * Visual variant while the toggle is not pressed.
      *
-     * @default 'flat'
+     * @defaultValue 'flat'
      */
     variant?: ButtonProps['variant'];
     /**
      * Visual variant while the toggle is pressed.
      *
-     * @default When omitted, `variant` is used in both states.
+     * @defaultValue When omitted, `variant` is used in both states.
      */
     pressedVariant?: ButtonProps['variant'];
     /**
      * When `pressedIcon` is set, crossfade and rotate between resting and pressed icons
      * (`data-interpolate="true"`). When `false`, swap instantly with no transition.
      *
-     * @default false
+     * @defaultValue false
      */
     interpolateIcons?: boolean;
 };

package/dist/components/toggle-group/toggle-group.d.ts

@@ -6,7 +6,7 @@ import { ToggleGroup as ToggleGroupPrimitive } from '@base-ui/react/toggle-group
  * (`row` / `column` from `orientation`) and zero gap — consumers own spacing.
  * Compose `ToggleButton` children each with `value` and an accessible name.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type ToggleGroupProps = ToggleGroupPrimitive.Props;
 export declare const ToggleGroup: React.FC<ToggleGroupProps>;

package/dist/components/tooltip/tooltip-content.d.ts

@@ -8,7 +8,7 @@ type TooltipContentPositionerProps = Omit<TooltipPositioner.Props, 'className' |
  * to the Positioner; `sideOffset` defaults to `8`. Always renders the internal
  * Viewport so multi-trigger content animations work by default.
  *
- * @default `sideOffset` is `8`.
+ * @defaultValue `sideOffset` is `8`.
  */
 export type TooltipContentProps = TooltipContentPositionerProps & {
     /**
@@ -16,7 +16,7 @@ export type TooltipContentProps = TooltipContentPositionerProps & {
      * Omit for Base UI default (`document.body` from the module window —
      * iframe hosts must pass the iframe document body explicitly).
      *
-     * @default Base UI FloatingPortal resolution
+     * @defaultValue Base UI FloatingPortal resolution
      */
     container?: React.ComponentProps<typeof PrimitiveTooltip.Portal>['container'];
 };

package/dist/components/typewriter/typewriter.d.ts

@@ -6,55 +6,55 @@ import type * as React from 'react';
  * Includes standard `span` attributes such as `id`, `className`, and event handlers,
  * plus Vira-owned typewriter animation controls.
  *
- * @default Native span pass-through props keep React defaults.
+ * @defaultValue Native span pass-through props keep React defaults.
  */
 export type TypewriterProps = React.ComponentPropsWithRef<'span'> & {
     /**
      * Cycles through multiple phrases instead of a single `children` string.
      *
-     * @default The animation uses string `children` when provided.
+     * @defaultValue The animation uses string `children` when provided.
      */
     texts?: readonly string[];
     /**
      * Selects the caret style rendered after the typed text.
      *
-     * @default 'pipe'
+     * @defaultValue 'pipe'
      */
     caret?: TypewriterCaret;
     /**
      * Overrides the caret color.
      *
-     * @default The caret inherits `currentColor`.
+     * @defaultValue The caret inherits `currentColor`.
      */
     caretColor?: string;
     /**
      * Sets the delay between typed characters in milliseconds.
      *
-     * @default 40
+     * @defaultValue 40
      */
     speed?: number;
     /**
      * Sets the delay between deleted characters in milliseconds.
      *
-     * @default 25
+     * @defaultValue 25
      */
     deleteSpeed?: number;
     /**
      * Sets the pause after a phrase completes before deletion starts, in milliseconds.
      *
-     * @default 2000
+     * @defaultValue 2000
      */
     pause?: number;
     /**
      * Sets the initial delay before typing starts, in milliseconds.
      *
-     * @default 0
+     * @defaultValue 0
      */
     delay?: number;
     /**
      * Repeats the phrase cycle after the final phrase is deleted.
      *
-     * @default true
+     * @defaultValue true
      */
     loop?: boolean;
     /**
@@ -62,7 +62,7 @@ export type TypewriterProps = React.ComponentPropsWithRef<'span'> & {
      * constraints) from first paint through delay, typing, and deletion via an
      * in-flow `visibility: hidden` phrase layer; the typed effect paints absolute on top.
      *
-     * @default false
+     * @defaultValue false
      */
     preserveSpace?: boolean;
 };

package/dist/index.js

@@ -24,6 +24,7 @@ import { DialogIndentBackground } from "./components/dialog/dialog-indent-backgr
 import { DialogSheet } from "./components/dialog/dialog-sheet.js";
 import { DialogTrigger } from "./components/dialog/dialog-trigger.js";
 import { Dialog } from "./components/dialog/dialog.js";
+import { Disclosure } from "./components/disclosure/disclosure.js";
 import { ELEVATION_DEFAULTS } from "./core/elevation/elevation-types.js";
 import { getElevationProps } from "./core/elevation/get-elevation-props.js";
 import { Elevator } from "./components/elevator/elevator.js";
@@ -46,6 +47,7 @@ import { MenuSeparator } from "./components/menu/menu-separator.js";
 import { MenuSubmenuTrigger } from "./components/menu/menu-submenu-trigger.js";
 import { Menu, MenuSubmenu, MenuTrigger } from "./components/menu/menu.js";
 import { Meter } from "./components/meter/meter.js";
+import { NumberField } from "./components/number-field/number-field.js";
 import { Textfield } from "./components/textfield/textfield.js";
 import { OTPField } from "./components/otp-field/otp-field.js";
 import { PopoverSheet } from "./components/popover/popover-sheet.js";
@@ -70,4 +72,4 @@ import { ToggleGroup } from "./components/toggle-group/toggle-group.js";
 import { Typewriter } from "./components/typewriter/typewriter.js";
 import { TooltipContent } from "./components/tooltip/tooltip-content.js";
 import { Tooltip, TooltipProvider, TooltipTrigger } from "./components/tooltip/tooltip.js";
-export { Accordion, Annotate, Autocomplete, Avatar, AvatarGroup, Badge, Beam, Bleed, BreakpointsProvider, Button, ButtonLink, Checkbox, CheckboxGroup, Chip, ClampText, Dialog, DialogClose, DialogIndent, DialogIndentBackground, DialogSheet, DialogTrigger, ELEVATION_DEFAULTS, Elevator, Fieldset, FitText, Glow, Grid, IconButton, IconButtonLink, LinearProgress, Masonry, Menu, MenuCheckboxItem, MenuGroup, MenuItem, MenuLinkItem, MenuPopup, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubmenu, MenuSubmenuTrigger, MenuTrigger, Meter, OTPField, Popover, PopoverClose, PopoverDescription, PopoverSheet, PopoverTitle, PopoverTrigger, ProgressiveBlur, Prose, Radio, RadioGroup, Select, Separator, Shimmer, Skeleton, Slider, Spinner, Stack, StaticNoise, Surface, Switch, Tabs, Text, Textarea, Textfield, Title, Toast, ToggleButton, ToggleGroup, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Typewriter, getElevationProps, useBreakpoints };
+export { Accordion, Annotate, Autocomplete, Avatar, AvatarGroup, Badge, Beam, Bleed, BreakpointsProvider, Button, ButtonLink, Checkbox, CheckboxGroup, Chip, ClampText, Dialog, DialogClose, DialogIndent, DialogIndentBackground, DialogSheet, DialogTrigger, Disclosure, ELEVATION_DEFAULTS, Elevator, Fieldset, FitText, Glow, Grid, IconButton, IconButtonLink, LinearProgress, Masonry, Menu, MenuCheckboxItem, MenuGroup, MenuItem, MenuLinkItem, MenuPopup, MenuRadioGroup, MenuRadioItem, MenuSeparator, MenuSubmenu, MenuSubmenuTrigger, MenuTrigger, Meter, NumberField, OTPField, Popover, PopoverClose, PopoverDescription, PopoverSheet, PopoverTitle, PopoverTrigger, ProgressiveBlur, Prose, Radio, RadioGroup, Select, Separator, Shimmer, Skeleton, Slider, Spinner, Stack, StaticNoise, Surface, Switch, Tabs, Text, Textarea, Textfield, Title, Toast, ToggleButton, ToggleGroup, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, Typewriter, getElevationProps, useBreakpoints };

package/dist/specs/components/accordion/usage.xml

@@ -8,5 +8,6 @@
   <do>Multiple open sections with root `multiple` (+ `defaultValue` / `value` as needed)</do>
   <dont>Trying to compose separate public `Accordion.Header`, `Accordion.Trigger`, or `Accordion.Panel` exports — those stay inside `Accordion.Item`</dont>
   <dont>Rendering an item without trigger text and without an external aria-label strategy</dont>
+  <dont>Using Accordion for a single expandable section — use Disclosure</dont>
   <dont>Using Accordion for primary navigation that should be links, Tabs, or routes</dont>
 </usage>

package/dist/specs/components/disclosure/a11y.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<a11y surface="disclosure">
+  <rule>Trigger is the disclosing control; Base UI wires expanded/controls relationship to the Panel</rule>
+  <rule>Accessible name comes from Trigger children, or explicit aria-label / aria-labelledby when icon-only</rule>
+  <rule>Trigger icons are decorative (aria-hidden); open/closed is communicated via Base UI attributes/ARIA, not icon alone</rule>
+  <rule>Disabled root ignores pointer and keyboard activation</rule>
+  <rule>prefers-reduced-motion disables Panel height and icon interpolate transitions; open/close still works</rule>
+  <rule>Do not re-apply widget role/aria that Base UI Collapsible already emits</rule>
+</a11y>