@viraui/react 2026.6.5 → 2026.7.0-next.1

package/dist/components/textfield/textfield.js

@@ -10,46 +10,50 @@ import { jsx, jsxs } from "react/jsx-runtime";
 import { Field } from "@base-ui/react/field";
 import { Input } from "@base-ui/react/input";
 //#region src/components/textfield/textfield.tsx
-var Textfield = ({ className, description, dirty, disabled, endAddon, error, fitContent, fullWidth = false, invalid, label, name, ref, startAddon, touched, validate, validationDebounceTime, validationMode, ...inputProps }) => /* @__PURE__ */ jsxs(Field.Root, {
-	className: clsx(textfield_module_default.Textfield, className),
-	dirty,
-	disabled,
-	invalid,
-	name,
-	touched,
-	validate,
-	validationDebounceTime,
-	validationMode,
-	"data-fullwidth": fullWidth,
-	render: /* @__PURE__ */ jsx(Stack, {
-		expandChildren: true,
-		rowGap: "s"
-	}),
-	children: [
-		label && /* @__PURE__ */ jsx(Field.Label, {
-			className: textfield_module_default.Label,
-			children: /* @__PURE__ */ jsx(FieldLabel, { children: label })
+var Textfield = ({ className, controlOnly = false, description, dirty, disabled, endAddon, error, fitContent, fullWidth = false, invalid, label, name, ref, render, startAddon, touched, validate, validationDebounceTime, validationMode, ...inputProps }) => {
+	const control = /* @__PURE__ */ jsx(InputControlGroup, {
+		addonClassName: textfield_module_default.Addon,
+		controlGroupClassName: clsx(textfield_module_default.ControlGroup, controlOnly && textfield_module_default.ControlOnly),
+		endAddon,
+		startAddon,
+		children: /* @__PURE__ */ jsx(BasicInput, {
+			...inputProps,
+			ref,
+			className: clsx(textfield_module_default.CustomBasicInput, controlOnly && className),
+			disabled,
+			fitContent,
+			render: render ?? /* @__PURE__ */ jsx(Input, {})
+		})
+	});
+	if (controlOnly) return control;
+	return /* @__PURE__ */ jsxs(Field.Root, {
+		className: clsx(textfield_module_default.Textfield, className),
+		"data-fullwidth": fullWidth,
+		dirty,
+		disabled,
+		invalid,
+		name,
+		render: /* @__PURE__ */ jsx(Stack, {
+			expandChildren: true,
+			rowGap: "s"
 		}),
-		/* @__PURE__ */ jsx(InputControlGroup, {
-			addonClassName: textfield_module_default.Addon,
-			controlGroupClassName: textfield_module_default.ControlGroup,
-			endAddon,
-			startAddon,
-			children: /* @__PURE__ */ jsx(BasicInput, {
-				...inputProps,
-				ref,
-				className: textfield_module_default.CustomBasicInput,
-				disabled,
-				fitContent,
-				render: /* @__PURE__ */ jsx(Input, {})
+		touched,
+		validate,
+		validationDebounceTime,
+		validationMode,
+		children: [
+			label && /* @__PURE__ */ jsx(Field.Label, {
+				className: textfield_module_default.Label,
+				children: /* @__PURE__ */ jsx(FieldLabel, { children: label })
+			}),
+			control,
+			/* @__PURE__ */ jsx(FieldHelperCopy, {
+				className: textfield_module_default.Description,
+				description,
+				error
 			})
-		}),
-		/* @__PURE__ */ jsx(FieldHelperCopy, {
-			className: textfield_module_default.Description,
-			description,
-			error
-		})
-	]
-});
+		]
+	});
+};
 //#endregion
 export { Textfield };

package/dist/components/textfield/textfield.module.js

@@ -1,5 +1,6 @@
 //#region src/components/textfield/textfield.module.css
 var Textfield = "viraui__textfield-module__Textfield_o-70A";
+var ControlOnly = "viraui__textfield-module__ControlOnly_22bXm";
 var Label = "viraui__textfield-module__Label_5rjr0";
 var ControlGroup = "viraui__textfield-module__ControlGroup_2W-OC";
 var CustomBasicInput = "viraui__textfield-module__CustomBasicInput_oHgtd";
@@ -7,6 +8,7 @@ var Addon = "viraui__textfield-module__Addon_kK1ef";
 var Description = "viraui__textfield-module__Description_8Qxot";
 var textfield_module_default = {
 	Textfield,
+	ControlOnly,
 	Label,
 	ControlGroup,
 	CustomBasicInput,
@@ -14,4 +16,4 @@ var textfield_module_default = {
 	Description
 };
 //#endregion
-export { Addon, ControlGroup, CustomBasicInput, Description, Label, Textfield, textfield_module_default as default };
+export { Addon, ControlGroup, ControlOnly, CustomBasicInput, Description, Label, Textfield, textfield_module_default as default };

package/dist/components/title/title.css

@@ -2,4 +2,4 @@
     var(--__title-size-min),
     calc(var(--__title-size-min) + (var(--__title-size-max) - var(--__title-size-min)) * var(--__title-fluid)),
     var(--__title-size-max)
-  );--vui-title-font-family:var(--font-family-heading);--vui-title-line-height:var(--font-leading-m);--__title-letter-spacing:-0.03em;margin:0;max-inline-size:var(--vui-title-max-width);font-family:var(--vui-title-font-family);font-size:var(--vui-title-font-size);line-height:var(--vui-title-line-height);letter-spacing:var(--__title-letter-spacing);text-transform:var(--vui-title-text-transform);text-align:var(--vui-title-align);white-space:var(--vui-title-white-space);word-break:break-word;font-weight:var(--vui-title-font-weight);font-stretch:calc(var(--vui-title-font-width) * 1%);font-optical-sizing:auto;font-variation-settings:"wght" var(--vui-title-font-weight),"wdth" var(--vui-title-font-width),"opsz" var(--vui-title-font-opsz);text-box:var(--vui-title-trim) var(--vui-title-trim-type);display:inline-flex;&[data-title-has-tracking=true]{letter-spacing:var(--vui-title-letter-spacing)}&[data-title-balanced=true]{text-wrap:balance}&[data-title-selection=false]{-webkit-user-select:none;user-select:none}&[data-title-has-padding=true]{padding:var(--vui-title-padding-block-start) var(--vui-title-padding-inline-end) var(--vui-title-padding-block-end) var(--vui-title-padding-inline-start)}&[data-title-size=display]{--__title-size-min:var(--font-scale-h1);--__title-size-max:var(--font-scale-display)}&[data-title-size="2"]{--__title-size-min:var(--font-scale-h3);--__title-size-max:var(--font-scale-h2)}&[data-title-size="3"]{--__title-size-min:var(--font-scale-h4);--__title-size-max:var(--font-scale-h3)}&[data-title-size="4"]{--__title-size-min:var(--font-scale-h5);--__title-size-max:var(--font-scale-h4)}&[data-title-size="5"]{--__title-size-min:var(--font-scale-h6);--__title-size-max:var(--font-scale-h5);--__title-letter-spacing:-0.02em}&[data-title-size="6"]{--__title-size-min:var(--font-scale-body-m);--__title-size-max:var(--font-scale-h6);--__title-letter-spacing:-0.02em}&[data-title-fluid=false]{--vui-title-font-size:var(--__title-size-max)}@container root style(--effect-fluid-typography: initial){--vui-title-font-size:var(--__title-size-max)}&[data-title-has-literal-color=true]{color:var(--vui-title-literal-color)}&[data-title-line-height=none]{--vui-title-line-height:0}&[data-title-line-height=xs]{--vui-title-line-height:var(--font-leading-xs)}&[data-title-line-height=s]{--vui-title-line-height:var(--font-leading-s)}&[data-title-line-height=m]{--vui-title-line-height:var(--font-leading-m)}&[data-title-line-height=l]{--vui-title-line-height:var(--font-leading-l)}}}
+  );--vui-title-font-family:var(--font-family-heading);--vui-title-line-height:var(--font-leading-m);--__title-letter-spacing:-0.03em;margin:0;max-inline-size:var(--vui-title-max-width);font-family:var(--vui-title-font-family);font-size:var(--vui-title-font-size);line-height:var(--vui-title-line-height);letter-spacing:var(--__title-letter-spacing);text-transform:var(--vui-title-text-transform);white-space:var(--vui-title-white-space);word-break:break-word;font-weight:var(--vui-title-font-weight);font-stretch:calc(var(--vui-title-font-width) * 1%);font-optical-sizing:auto;font-variation-settings:"wght" var(--vui-title-font-weight),"wdth" var(--vui-title-font-width),"opsz" var(--vui-title-font-opsz);text-box:var(--vui-title-trim) var(--vui-title-trim-type);display:inline-flex;&[data-title-has-align=true]{text-align:var(--vui-title-align)}&[data-title-has-tracking=true]{letter-spacing:var(--vui-title-letter-spacing)}&[data-title-balanced=true]{text-wrap:balance}&[data-title-selection=false]{-webkit-user-select:none;user-select:none}&[data-title-has-padding=true]{padding:var(--vui-title-padding-block-start) var(--vui-title-padding-inline-end) var(--vui-title-padding-block-end) var(--vui-title-padding-inline-start)}&[data-title-size=display]{--__title-size-min:var(--font-scale-h1);--__title-size-max:var(--font-scale-display)}&[data-title-size="2"]{--__title-size-min:var(--font-scale-h3);--__title-size-max:var(--font-scale-h2)}&[data-title-size="3"]{--__title-size-min:var(--font-scale-h4);--__title-size-max:var(--font-scale-h3)}&[data-title-size="4"]{--__title-size-min:var(--font-scale-h5);--__title-size-max:var(--font-scale-h4)}&[data-title-size="5"]{--__title-size-min:var(--font-scale-h6);--__title-size-max:var(--font-scale-h5);--__title-letter-spacing:-0.02em}&[data-title-size="6"]{--__title-size-min:var(--font-scale-body-m);--__title-size-max:var(--font-scale-h6);--__title-letter-spacing:-0.02em}&[data-title-fluid=false]{--vui-title-font-size:var(--__title-size-max)}@container root style(--effect-fluid-typography: initial){--vui-title-font-size:var(--__title-size-max)}&[data-title-has-literal-color=true]{color:var(--vui-title-literal-color)}&[data-title-line-height=none]{--vui-title-line-height:0}&[data-title-line-height=xs]{--vui-title-line-height:var(--font-leading-xs)}&[data-title-line-height=s]{--vui-title-line-height:var(--font-leading-s)}&[data-title-line-height=m]{--vui-title-line-height:var(--font-leading-m)}&[data-title-line-height=l]{--vui-title-line-height:var(--font-leading-l)}}}

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,43 +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 'start'
+     * @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'];
     /**
@@ -77,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;
     /**
@@ -141,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/title/title.js

@@ -4,11 +4,12 @@ import { resolveAxisPadding } from "../../core/styles/resolve-axis-padding.js";
 import title_module_default from "./title.module.js";
 import { useRender } from "@base-ui/react/use-render";
 //#region src/components/title/title.tsx
-var Title = ({ align = "start", balanced = false, selection = true, className, color, fluid = true, fontWidth, hPadding, size = "1", lineHeight = "m", maxWidth, opticalSize, ref, render, style, tracking, transform, trim = "both", trimType = "cap alphabetic", vPadding, weight, whiteSpace = "normal", ...otherProps }) => {
+var Title = ({ align, balanced = false, selection = true, className, color, fluid = true, fontWidth, hPadding, size = "1", lineHeight = "m", maxWidth, opticalSize, ref, render, style, tracking, transform, trim = "both", trimType = "cap alphabetic", vPadding, weight, whiteSpace = "normal", ...otherProps }) => {
+	const hasAlign = align !== void 0;
 	const hasPadding = Boolean(hPadding || vPadding);
 	const hasTracking = tracking !== void 0;
 	const dynamicStyle = {
-		"--vui-title-align": align,
+		...hasAlign && { "--vui-title-align": align },
 		"--vui-title-max-width": maxWidth ?? "none",
 		"--vui-title-literal-color": color,
 		"--vui-title-white-space": whiteSpace,
@@ -34,6 +35,7 @@ var Title = ({ align = "start", balanced = false, selection = true, className, c
 			"data-title-balanced": balanced ? "true" : "false",
 			"data-title-selection": selection ? "true" : "false",
 			"data-title-fluid": fluid ? "true" : "false",
+			"data-title-has-align": hasAlign ? "true" : "false",
 			"data-title-has-padding": hasPadding ? "true" : "false",
 			"data-title-has-literal-color": color ? "true" : "false",
 			"data-title-has-tracking": hasTracking ? "true" : "false",

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-banner.js

@@ -1,8 +1,8 @@
 import { clsx } from "../../core/clsx.js";
 import { Text } from "../text/text.js";
 import { Stack } from "../stack/stack.js";
-import { Button } from "../button/button.js";
 import { Surface } from "../surface/surface.js";
+import { Button } from "../button/button.js";
 import toast_module_default from "./toast.module.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Toast } from "@base-ui/react/toast";

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

@@ -6,6 +6,7 @@ import { Autocomplete } from "./components/autocomplete/autocomplete.js";
 import { Avatar } from "./components/avatar/avatar.js";
 import { AvatarGroup } from "./components/avatar-group/avatar-group.js";
 import { Badge } from "./components/badge/badge.js";
+import { Surface } from "./components/surface/surface.js";
 import { Beam } from "./components/beam/beam.js";
 import { Bleed } from "./components/bleed/bleed.js";
 import { BreakpointsProvider } from "./components/breakpoints/breakpoints-provider.js";
@@ -23,12 +24,12 @@ 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";
 import { Fieldset } from "./components/fieldset/fieldset.js";
 import { FitText } from "./components/fit-text/fit-text.js";
-import { Surface } from "./components/surface/surface.js";
 import { Glow } from "./components/glow/glow.js";
 import { Grid } from "./components/grid/grid.js";
 import { IconButton } from "./components/icon-button/icon-button.js";
@@ -46,9 +47,13 @@ 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";
 import { Popover, PopoverClose, PopoverDescription, PopoverTitle, PopoverTrigger } from "./components/popover/popover.js";
 import { ProgressiveBlur } from "./components/progressive-blur/progressive-blur.js";
+import { Prose } from "./components/prose/prose.js";
 import { Radio } from "./components/radio/radio.js";
 import { RadioGroup } from "./components/radio/radio-group.js";
 import { Select } from "./components/select/select.js";
@@ -60,7 +65,6 @@ import { StaticNoise } from "./components/static-noise/static-noise.js";
 import { Switch } from "./components/switch/switch.js";
 import { Tabs } from "./components/tabs/tabs.js";
 import { Textarea } from "./components/textarea/textarea.js";
-import { Textfield } from "./components/textfield/textfield.js";
 import { Title } from "./components/title/title.js";
 import { Toast } from "./components/toast/toast.js";
 import { ToggleButton } from "./components/toggle-button/toggle-button.js";
@@ -68,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, Popover, PopoverClose, PopoverDescription, PopoverSheet, PopoverTitle, PopoverTrigger, ProgressiveBlur, 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/beam/a11y.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <a11y surface="beam">
-  <rule>Root stays in the accessibility tree; bloom layer is empty div</rule>
+  <rule>Root stays in the accessibility tree; bloom layer is an empty decorative div with aria-hidden</rule>
   <rule>Beam is not a focus or status indicator — consumer owns accessible names and state</rule>
-  <rule>Offscreen instances pause animations without firing activate/deactivate</rule>
-  <rule>prefers-reduced-motion disables motion and leaves a static resting look</rule>
+  <rule>Offscreen instances set data-paused="true" and pause motion without firing activate/deactivate</rule>
+  <rule>prefers-reduced-motion keeps a static visible rest (no looping motion); animate=false still fades the effect away</rule>
 </a11y>