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

package/dist/components/checkbox/checkbox.d.ts

@@ -7,43 +7,43 @@ import type * as React from 'react';
  * Self-contained option row for standalone fields or `CheckboxGroup` children.
  * Standalone usage requires an external `Field.Root` wrapper for validation and naming.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type CheckboxProps = CheckboxRoot.Props & {
     /**
      * 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` for this option.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
      * Error copy rendered in the same slot as `description` while invalid.
      *
-     * @default No static error copy is rendered.
+     * @defaultValue No static error copy is rendered.
      */
     error?: React.ReactNode;
     /**
      * Controls the visual checkbox size.
      *
-     * @default 's'
+     * @defaultValue 's'
      */
     size?: 'm' | 's';
     /**
      * Sets block padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No block padding.
+     * @defaultValue No block padding.
      */
     vPadding?: StackProps['vPadding'];
     /**
      * Sets inline padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No inline padding.
+     * @defaultValue No inline padding.
      */
     hPadding?: StackProps['hPadding'];
 };

package/dist/components/chip/chip.d.ts

@@ -8,37 +8,37 @@ import * as React from 'react';
  * Includes standard `div` attributes such as `children`, `id`, `title`, and event handlers,
  * plus Vira-owned visual variant, decorative addon, and Base UI `render` support for replacing the root element.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type ChipProps = React.ComponentPropsWithRef<'div'> & {
     /**
      * Replaces the default `div` root using Base UI render semantics.
      *
-     * @default The chip renders a `div` root.
+     * @defaultValue The chip renders a `div` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered chip root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
      * Selects the visual treatment for the chip.
      *
-     * @default 'primary'
+     * @defaultValue 'primary'
      */
     variant?: 'primary' | 'secondary' | 'outline' | ThemeTypes['highlight'];
     /**
      * Decorative addon rendered alongside the chip label.
      *
-     * @default No default; omit when the chip has no addon.
+     * @defaultValue No default; omit when the chip has no addon.
      */
     addon?: ReactNode;
     /**
      * Controls whether the addon appears before or after the label.
      *
-     * @default 'start'
+     * @defaultValue 'start'
      */
     addonPosition?: 'start' | 'end';
 };

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

@@ -6,31 +6,31 @@ import type * as React from 'react';
  * Includes standard inline text attributes such as `children`, `id`, `title`, and event handlers,
  * plus Vira-owned line-clamp controls and Base UI `render` support for replacing the root element.
  *
- * @default Native span pass-through props keep React defaults.
+ * @defaultValue Native span pass-through props keep React defaults.
  */
 export type ClampTextProps = React.ComponentPropsWithoutRef<'span'> & {
     /**
      * Replaces the default `span` root using Base UI render semantics.
      *
-     * @default The clamp text renders a `span` root.
+     * @defaultValue The clamp text renders a `span` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered clamp text root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
      * Sets how many lines of text remain visible before truncation.
      *
-     * @default 1
+     * @defaultValue 1
      */
     rows?: number;
     /**
      * Uses inline `-webkit-inline-box` display instead of block `-webkit-box`.
      *
-     * @default false
+     * @defaultValue false
      */
     inline?: boolean;
 };

package/dist/components/dialog/dialog-close.d.ts

@@ -9,7 +9,7 @@ import type * as React from 'react';
  *
  * Compose inside `Dialog.Sheet` so the control closes the open drawer.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type DialogCloseProps = DrawerClose.Props;
 export declare const DialogClose: React.FC<DialogCloseProps>;

package/dist/components/dialog/dialog-indent-background.d.ts

@@ -6,7 +6,7 @@ import type * as React from 'react';
  * Pass-through to Base UI `Drawer.IndentBackground` with Vira-owned root class applied.
  * Place before `Dialog.Indent` inside `Dialog.Provider` for the indent background layer.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type DialogIndentBackgroundProps = DrawerIndentBackground.Props;
 export declare const DialogIndentBackground: React.FC<DialogIndentBackgroundProps>;

package/dist/components/dialog/dialog-indent.d.ts

@@ -6,7 +6,7 @@ import type * as React from 'react';
  * Pass-through to Base UI `Drawer.Indent` with Vira-owned root class applied.
  * Wrap app shell content inside `Dialog.Provider` to receive `data-active` when a sheet opens.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type DialogIndentProps = DrawerIndent.Props;
 export declare const DialogIndent: React.FC<DialogIndentProps>;

package/dist/components/dialog/dialog-sheet.d.ts

@@ -8,7 +8,7 @@ import type * as React from 'react';
  * and optional body content. Compose `Dialog.Close` inside `children` when a
  * close control is needed.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type DialogSheetProps = {
     /**
@@ -18,49 +18,49 @@ export type DialogSheetProps = {
     /**
      * Supporting copy announced with the title.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
      * Optional body content rendered below the description.
      *
-     * @default No extra body content is rendered.
+     * @defaultValue No extra body content is rendered.
      */
     children?: React.ReactNode;
     /**
      * Optional maximum width of the content area.
      *
-     * @default `50ch`
+     * @defaultValue `50ch`
      */
     maxContentWidth?: StackProps['maxWidth'];
     /**
      * Aligns the header stack and title/description text (`start` | `center` | `end`).
      *
-     * @default `start`
+     * @defaultValue `start`
      */
     headerAlign?: Extract<StackProps['hAlign'], 'start' | 'center' | 'end'>;
     /**
      * Whether to show the close button.
      *
-     * @default false
+     * @defaultValue false
      */
     showCloseButton?: boolean;
     /**
      * Centers the sheet horizontally within the viewport.
      *
-     * @default false
+     * @defaultValue false
      */
     fitContent?: boolean;
     /**
      * Whether to show the drag handle above the sheet header.
      *
-     * @default true
+     * @defaultValue true
      */
     showHandle?: boolean;
     /**
      * Maximum block size of the sheet panel.
      *
-     * @default `97dvh`
+     * @defaultValue `97dvh`
      */
     maxHeight?: string;
     /**
@@ -68,7 +68,7 @@ export type DialogSheetProps = {
      * 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 PrimitiveDrawer.Portal>['container'];
 };

package/dist/components/dialog/dialog-trigger.d.ts

@@ -7,7 +7,7 @@ import type * as React from 'react';
  * (`Button`, `IconButton`, or another element) and set `nativeButton` when the
  * rendered root is not a native `<button>`.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type DialogTriggerProps = DrawerTrigger.Props;
 export declare const DialogTrigger: React.FC<DialogTriggerProps>;

package/dist/components/dialog/dialog.d.ts

@@ -13,7 +13,7 @@ import type * as React from 'react';
  * Portal, backdrop, viewport, popup, title, description, and content parts are
  * internal to `Dialog.Sheet` and are not exposed on `Dialog`.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type DialogProps = DrawerRoot.Props;
 export type DialogSnapPoint = DrawerRoot.SnapPoint;

package/dist/components/disclosure/disclosure-panel.d.ts

@@ -0,0 +1,12 @@
+import { CollapsiblePanel } from '@base-ui/react/collapsible';
+import type * as React from 'react';
+/**
+ * Public Disclosure.Panel props.
+ *
+ * Base UI Collapsible Panel pass-through (`hiddenUntilFound`, `keepMounted`, `render`, …)
+ * plus the animated height shell. No default content padding — builders own children layout.
+ *
+ * @defaultValue Base UI pass-through props keep upstream defaults.
+ */
+export type DisclosurePanelProps = CollapsiblePanel.Props;
+export declare const DisclosurePanel: React.FC<DisclosurePanelProps>;

package/dist/components/disclosure/disclosure-panel.js

@@ -0,0 +1,13 @@
+"use client";
+import { clsx } from "../../core/clsx.js";
+import disclosure_module_default from "./disclosure.module.js";
+import { jsx } from "react/jsx-runtime";
+import { Collapsible } from "@base-ui/react/collapsible";
+//#region src/components/disclosure/disclosure-panel.tsx
+var DisclosurePanel = ({ children, className, ...otherProps }) => /* @__PURE__ */ jsx(Collapsible.Panel, {
+	className: clsx(disclosure_module_default.Panel, className),
+	...otherProps,
+	children
+});
+//#endregion
+export { DisclosurePanel };

package/dist/components/disclosure/disclosure-trigger.d.ts

@@ -0,0 +1,46 @@
+import { CollapsibleTrigger } from '@base-ui/react/collapsible';
+import { SurfaceProps } from '../surface';
+import type * as React from 'react';
+/** Surface chrome on default Trigger path. Host/`render` stay on Trigger. */
+type DisclosureTriggerSurfaceProps = Omit<SurfaceProps, 'ref'>;
+/**
+ * Public Disclosure.Trigger props.
+ *
+ * Default host = `Surface` with `render` → Base UI Collapsible Trigger (Textfield/NumberField
+ * family). Icon pair follows ToggleButton naming (`restingIcon` / `openIcon` / `interpolateIcons`).
+ * Consumer `render` replaces the whole Surface + primitive compose.
+ *
+ * @defaultValue Base UI pass-through props keep upstream defaults. On the default Surface path,
+ * `hoverColor` defaults to `2`, `hPadding` defaults to `'m'`, `vPadding` defaults to `'s'`.
+ * `interpolateIcons` defaults to `false`. `iconPosition` defaults to `'end'`.
+ */
+export type DisclosureTriggerProps = CollapsibleTrigger.Props & DisclosureTriggerSurfaceProps & {
+    /**
+     * Decorative icon while the panel is closed.
+     *
+     * @defaultValue `ChromeChevronEnd` when both icon slots are omitted.
+     */
+    restingIcon?: React.ReactNode;
+    /**
+     * Decorative icon while the panel is open.
+     *
+     * @defaultValue `ChromeChevronDown` when both icon slots are omitted. When only `restingIcon`
+     * is set, that icon shows in both states.
+     */
+    openIcon?: React.ReactNode;
+    /**
+     * When dual icons are present, crossfade and light-rotate between them
+     * (`data-interpolate="true"`). When `false`, swap instantly with no transition.
+     *
+     * @defaultValue false
+     */
+    interpolateIcons?: boolean;
+    /**
+     * Logical side of the label where the icon slot sits.
+     *
+     * @defaultValue 'end'
+     */
+    iconPosition?: 'start' | 'end';
+};
+export declare const DisclosureTrigger: React.FC<DisclosureTriggerProps>;
+export {};

package/dist/components/disclosure/disclosure-trigger.js

@@ -0,0 +1,82 @@
+"use client";
+import { clsx } from "../../core/clsx.js";
+import { ChromeChevronDown, ChromeChevronEnd } from "../../internal/chrome-icons/chrome-icons.js";
+import { Stack } from "../stack/stack.js";
+import { Surface } from "../surface/surface.js";
+import disclosure_module_default from "./disclosure.module.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Collapsible } from "@base-ui/react/collapsible";
+//#region src/components/disclosure/disclosure-trigger.tsx
+var resolveIconPair = (restingIcon, openIcon) => {
+	if (restingIcon === void 0 && openIcon === void 0) return {
+		resting: /* @__PURE__ */ jsx(ChromeChevronEnd, { size: "1rem" }),
+		open: /* @__PURE__ */ jsx(ChromeChevronDown, { size: "1rem" })
+	};
+	if (restingIcon !== void 0 && openIcon === void 0) return {
+		resting: restingIcon,
+		open: null
+	};
+	if (restingIcon === void 0 && openIcon !== void 0) return {
+		resting: /* @__PURE__ */ jsx(ChromeChevronEnd, { size: "1rem" }),
+		open: openIcon
+	};
+	return {
+		resting: restingIcon,
+		open: openIcon ?? null
+	};
+};
+var DisclosureTrigger = ({ border, borderStyle, children, className, color, enableContainer, hPadding = "m", vPadding = "s", hoverColor, iconPosition = "end", interpolateIcons = false, nativeButton, openIcon, overflow, radius, render, restingIcon, style, ...otherProps }) => {
+	if (render != null) return /* @__PURE__ */ jsx(Collapsible.Trigger, {
+		className: clsx(disclosure_module_default.Trigger, className),
+		nativeButton,
+		render,
+		style,
+		...otherProps,
+		children
+	});
+	const { resting, open } = resolveIconPair(restingIcon, openIcon);
+	const iconAtStart = iconPosition === "start";
+	return /* @__PURE__ */ jsx(Surface, {
+		border,
+		borderStyle,
+		className: clsx(disclosure_module_default.Trigger, className),
+		color,
+		enableContainer,
+		hoverColor: hoverColor ?? 2,
+		hPadding,
+		vPadding,
+		overflow,
+		radius,
+		render: /* @__PURE__ */ jsx(Collapsible.Trigger, {
+			nativeButton,
+			...otherProps
+		}),
+		style,
+		children: /* @__PURE__ */ jsxs(Stack, {
+			columnGap: iconAtStart ? "s" : void 0,
+			direction: iconAtStart ? "row" : "row-reverse",
+			fullWidth: true,
+			hAlign: iconPosition === "end" ? "space-between" : "start",
+			vAlign: "center",
+			children: [open ? /* @__PURE__ */ jsxs("span", {
+				"aria-hidden": true,
+				className: disclosure_module_default.IconSlot,
+				"data-interpolate": interpolateIcons ? "true" : "false",
+				"data-shrink": "false",
+				children: [/* @__PURE__ */ jsx("span", {
+					className: disclosure_module_default.Icon,
+					children: resting
+				}), /* @__PURE__ */ jsx("span", {
+					className: disclosure_module_default.Icon,
+					children: open
+				})]
+			}) : /* @__PURE__ */ jsx("span", {
+				"aria-hidden": true,
+				"data-shrink": "false",
+				children: resting
+			}), children]
+		})
+	});
+};
+//#endregion
+export { DisclosureTrigger };

package/dist/components/disclosure/disclosure.css

@@ -0,0 +1 @@
+@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{.viraui__disclosure-module__Trigger_hTIkR{inline-size:100%;cursor:pointer;text-align:start;color:inherit;&:focus-visible{outline-offset:-4px}&[data-disabled]{cursor:not-allowed;opacity:.5}}.viraui__disclosure-module__IconSlot_8gEr5{position:relative;inline-size:1rem;block-size:1rem;.viraui__disclosure-module__Trigger_hTIkR[data-panel-open] &{.viraui__disclosure-module__Icon_w8tYN:first-of-type{opacity:0;rotate:30deg}.viraui__disclosure-module__Icon_w8tYN:last-of-type{opacity:1;rotate:0deg}}&[data-interpolate=true] .viraui__disclosure-module__Icon_w8tYN{transition:opacity var(--duration-fast) var(--easing-standard),rotate var(--duration-fast) var(--easing-standard)}@media (prefers-reduced-motion:reduce){&[data-interpolate=true] .viraui__disclosure-module__Icon_w8tYN{transition:none}}}.viraui__disclosure-module__Icon_w8tYN{position:absolute;inset:0;display:grid;place-items:center;&>svg{block-size:1rem;inline-size:1rem}&:first-of-type{opacity:1;rotate:0deg}&:last-of-type{opacity:0;rotate:-30deg}}.viraui__disclosure-module__Panel_U6Kba{block-size:var(--collapsible-panel-height);overflow:hidden;transition:block-size var(--duration-fast) var(--easing-standard);&[data-ending-style],&[data-starting-style]{block-size:0}@media (prefers-reduced-motion:reduce){transition:none}}}

package/dist/components/disclosure/disclosure.d.ts

@@ -0,0 +1,25 @@
+import { CollapsibleRoot } from '@base-ui/react/collapsible';
+import { DisclosurePanelProps } from './disclosure-panel';
+import { DisclosureTriggerProps } from './disclosure-trigger';
+import type * as React from 'react';
+/**
+ * Public Disclosure root props.
+ *
+ * Base UI Collapsible Root pass-through (`open`, `defaultOpen`, `onOpenChange`, `disabled`, …).
+ * Compose with `Disclosure.Trigger` and `Disclosure.Panel`.
+ *
+ * @defaultValue Base UI pass-through props keep upstream defaults.
+ */
+export type DisclosureProps = CollapsibleRoot.Props;
+type DisclosureComponent = React.FC<DisclosureProps> & {
+    Trigger: React.FC<DisclosureTriggerProps>;
+    Panel: React.FC<DisclosurePanelProps>;
+};
+/**
+ * Single-section expand/collapse compound wrapping Base UI Collapsible.
+ *
+ * Use Accordion for multi-item lists. Default Trigger is Surface with
+ * `render` → Collapsible Trigger; Panel is a height motion shell without padding.
+ */
+export declare const Disclosure: DisclosureComponent;
+export {};

package/dist/components/disclosure/disclosure.js

@@ -0,0 +1,30 @@
+"use client";
+import './disclosure.css';
+import { clsx } from "../../core/clsx.js";
+import { Stack } from "../stack/stack.js";
+import disclosure_module_default from "./disclosure.module.js";
+import { DisclosurePanel } from "./disclosure-panel.js";
+import { DisclosureTrigger } from "./disclosure-trigger.js";
+import { jsx } from "react/jsx-runtime";
+import { Collapsible } from "@base-ui/react/collapsible";
+//#region src/components/disclosure/disclosure.tsx
+var DisclosureRoot = ({ children, className, ...otherProps }) => /* @__PURE__ */ jsx(Collapsible.Root, {
+	render: /* @__PURE__ */ jsx(Stack, {
+		fullWidth: true,
+		className: clsx(disclosure_module_default.Disclosure, className)
+	}),
+	...otherProps,
+	children
+});
+/**
+* Single-section expand/collapse compound wrapping Base UI Collapsible.
+*
+* Use Accordion for multi-item lists. Default Trigger is Surface with
+* `render` → Collapsible Trigger; Panel is a height motion shell without padding.
+*/
+var Disclosure = Object.assign(DisclosureRoot, {
+	Trigger: DisclosureTrigger,
+	Panel: DisclosurePanel
+});
+//#endregion
+export { Disclosure };

package/dist/components/disclosure/disclosure.module.js

@@ -0,0 +1,15 @@
+//#region src/components/disclosure/disclosure.module.css
+var Disclosure = "viraui__disclosure-module__Disclosure_C0zl-";
+var Trigger = "viraui__disclosure-module__Trigger_hTIkR";
+var IconSlot = "viraui__disclosure-module__IconSlot_8gEr5";
+var Icon = "viraui__disclosure-module__Icon_w8tYN";
+var Panel = "viraui__disclosure-module__Panel_U6Kba";
+var disclosure_module_default = {
+	Disclosure,
+	Trigger,
+	IconSlot,
+	Icon,
+	Panel
+};
+//#endregion
+export { Disclosure, Icon, IconSlot, Panel, Trigger, disclosure_module_default as default };

package/dist/components/disclosure/index.d.ts

@@ -0,0 +1,4 @@
+export { Disclosure } from './disclosure';
+export type { DisclosureProps } from './disclosure';
+export type { DisclosureTriggerProps } from './disclosure-trigger';
+export type { DisclosurePanelProps } from './disclosure-panel';

package/dist/components/elevator/elevator.d.ts

@@ -8,43 +8,43 @@ export { getElevationProps } from '../../core/elevation/get-elevation-props';
  *
  * Applies preflight elevation hooks to each valid element child. Invalid nodes pass through unchanged.
  *
- * @default Native child pass-through props are preserved and merged with elevation hooks.
+ * @defaultValue Native child pass-through props are preserved and merged with elevation hooks.
  */
 export type ElevatorProps = {
     /**
      * Element or elements that receive elevation hooks on their rendered root.
      *
-     * @default No default. Consumers must provide at least one child.
+     * @defaultValue No default. Consumers must provide at least one child.
      */
     children: React.ReactNode;
     /**
      * Resting elevation level mapped to `data-elevation`.
      *
-     * @default No default. Consumers must provide a resting level.
+     * @defaultValue No default. Consumers must provide a resting level.
      */
     resting: ElevationLevel;
     /**
      * Hover elevation level mapped to `data-elevation-hover`.
      *
-     * @default No hover elevation override.
+     * @defaultValue No hover elevation override.
      */
     hover?: ElevationLevel;
     /**
      * Shadow cast direction mapped to `data-elevation-direction`.
      *
-     * @default 'bottom'
+     * @defaultValue 'bottom'
      */
     direction?: ElevationDirection;
     /**
      * Shadow color mapped to the `--shadow-color` custom property.
      *
-     * @default 'oklch(0% 0 0)'
+     * @defaultValue 'oklch(0% 0 0)'
      */
     shadowColor?: ElevationShadowColor;
     /**
      * Additional shadow layer mapped to the `--extra-shadow` custom property.
      *
-     * @default Preflight transparent hairline from `elevations.css`.
+     * @defaultValue Preflight transparent hairline from `elevations.css`.
      */
     extraShadow?: string;
 };

package/dist/components/fieldset/fieldset.d.ts

@@ -7,27 +7,27 @@ import type * as React from 'react';
  * legend typography and optional group helper copy. Pass `render` to merge the fieldset
  * root with `RadioGroup`, `CheckboxGroup`, or another compatible root.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type FieldsetProps = FieldsetRoot.Props & {
     /**
      * Visible legend copy rendered with shared internal `FieldLabel`.
      *
-     * @default No legend is rendered.
+     * @defaultValue No legend is rendered.
      */
     label?: React.ReactNode;
     /**
      * Group helper copy rendered below the legend while valid.
      * Requires a `Field.Root` ancestor for `FieldHelperCopy`.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
      * Group error copy rendered below the legend when invalid.
      * Requires a `Field.Root` ancestor.
      *
-     * @default No static error copy is rendered.
+     * @defaultValue No static error copy is rendered.
      */
     error?: React.ReactNode;
 };

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

@@ -5,13 +5,13 @@ import type * as React from 'react';
  * Includes standard `div` attributes such as `children`, `id`, `className`, and event handlers,
  * plus an optional fitted font-size cap.
  *
- * @default Native div pass-through props keep React defaults.
+ * @defaultValue Native div pass-through props keep React defaults.
  */
 export type FitTextProps = React.ComponentPropsWithRef<'div'> & {
     /**
      * Caps the fitted font size using any valid CSS length string.
      *
-     * @default No maximum — fitted size may grow without an upper bound.
+     * @defaultValue No maximum — fitted size may grow without an upper bound.
      */
     maxFontSize?: string;
 };