@viraui/react 2026.7.0-next.0 → 2026.7.0

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

@@ -8,7 +8,7 @@ type PopoverSheetContainerProps = {
      * 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 PrimitivePopover.Portal>['container'];
 };
@@ -17,7 +17,7 @@ type PopoverSheetStyledProps = PopoverSheetPositionerProps & PopoverSheetContain
      * Whether to skip the built-in Surface, header, and close chrome and render
      * only the positioning/animation shell (Portal + Positioner + Popup + Viewport).
      *
-     * @default false
+     * @defaultValue false
      */
     unstyled?: false;
     /**
@@ -27,19 +27,19 @@ type PopoverSheetStyledProps = PopoverSheetPositionerProps & PopoverSheetContain
     /**
      * Supporting copy announced with the title.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
      * Whether to show the built-in flat IconButton close control.
      *
-     * @default false
+     * @defaultValue false
      */
     showCloseButton?: boolean;
     /**
      * Aligns the header content.
      *
-     * @default `start`
+     * @defaultValue `start`
      */
     headerAlign?: Extract<StackProps['hAlign'], 'start' | 'center' | 'end'>;
 };
@@ -68,7 +68,7 @@ type PopoverSheetUnstyledProps = PopoverSheetPositionerProps & PopoverSheetConta
  * and must compose `Popover.Title` (and `Popover.Description` when needed) for
  * accessible naming.
  *
- * @default `sideOffset` is `8`; no description, no close button, styled chrome.
+ * @defaultValue `sideOffset` is `8`; no description, no close button, styled chrome.
  */
 export type PopoverSheetProps = PopoverSheetStyledProps | PopoverSheetUnstyledProps;
 export declare const PopoverSheet: React.FC<PopoverSheetProps>;

package/dist/components/popover/popover.d.ts

@@ -9,7 +9,7 @@ import type * as React from 'react';
  * and `handle` for detached/multiple triggers. `children` may be a node or a
  * `({ payload }) => ReactNode` render function for per-trigger content.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type PopoverProps = PopoverRoot.Props;
 /**
@@ -21,7 +21,7 @@ export type PopoverProps = PopoverRoot.Props;
  * `payload` for per-trigger content, `openOnHover`/`delay`/`closeDelay` for hover
  * open behavior, and `id` for controlled activation via the Root `triggerId` prop.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type PopoverTriggerProps = PopoverTriggerNamespace.Props;
 /**
@@ -33,7 +33,7 @@ export type PopoverTriggerProps = PopoverTriggerNamespace.Props;
  *
  * Compose inside `Popover.Sheet` so the control closes the open popover.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type PopoverCloseProps = PopoverCloseNamespace.Props;
 /**
@@ -44,7 +44,7 @@ export type PopoverCloseProps = PopoverCloseNamespace.Props;
  * `Popover.Sheet` so the popup keeps an accessible name; the styled sheet
  * renders it internally from its `title` prop.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type PopoverTitleProps = PopoverTitleNamespace.Props;
 /**
@@ -55,7 +55,7 @@ export type PopoverTitleProps = PopoverTitleNamespace.Props;
  * `Popover.Sheet`; the styled sheet renders it internally from its
  * `description` prop.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type PopoverDescriptionProps = PopoverDescriptionNamespace.Props;
 export declare const PopoverTrigger: PrimitivePopover.Trigger;

package/dist/components/progressive-blur/progressive-blur.d.ts

@@ -6,31 +6,31 @@ import type * as React from 'react';
  * Includes standard `div` attributes such as `id`, `className`, and event handlers,
  * plus Vira-owned progressive backdrop blur controls.
  *
- * @default Native div pass-through props keep React defaults.
+ * @defaultValue Native div pass-through props keep React defaults.
  */
 export type ProgressiveBlurProps = React.ComponentPropsWithRef<'div'> & {
     /**
      * Sets the maximum blur radius applied to the first layer at the selected edge.
      *
-     * @default '16px'
+     * @defaultValue '16px'
      */
     blur?: string;
     /**
      * Selects the edge where maximum blur starts and fades toward the opposite edge.
      *
-     * @default 'bottom'
+     * @defaultValue 'bottom'
      */
     direction?: ProgressiveBlurDirection;
     /**
      * Selects the easing curve used to distribute blur factors across internal layers.
      *
-     * @default 'exponential'
+     * @defaultValue 'exponential'
      */
     easing?: ProgressiveBlurEasing;
     /**
      * Sets the number of internal blur layers. Values are clamped to `2..16`.
      *
-     * @default Varies by easing: linear `6`, ease-in/out `8`, ease-in-out `10`, exponential `8`.
+     * @defaultValue Varies by easing: linear `6`, ease-in/out `8`, ease-in-out `10`, exponential `8`.
      */
     steps?: number;
 };

package/dist/components/prose/prose.css

@@ -1 +1 @@
-@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --vui-prose-align{syntax:"*";inherits:false;initial-value:start}@property --vui-prose-gap-blocks{syntax:"<length>";inherits:true;initial-value:2em}@property --vui-prose-gap-heading-start{syntax:"<length>";inherits:true;initial-value:1.3em}@property --vui-prose-gap-heading-end{syntax:"<length>";inherits:true;initial-value:.8em}.viraui__prose-module__Prose_8yO9h{--vui-prose-gap-blocks:2em;--vui-prose-gap-heading-start:1.3em;--vui-prose-gap-heading-end:0.8em;&[data-prose-gap=s]{--vui-prose-gap-blocks:1em;--vui-prose-gap-heading-start:0.7em;--vui-prose-gap-heading-end:0.3em}&[data-prose-gap=m]{--vui-prose-gap-blocks:1.5em;--vui-prose-gap-heading-start:1em;--vui-prose-gap-heading-end:0.6em}&[data-prose-has-align=true]{text-align:var(--vui-prose-align)}}.viraui__prose-module__Prose_8yO9h>:is(h1,h2,h3,h4,h5,h6,hgroup,ul,ol,dd,p,figure,img,pre,table,fieldset,blockquote,picture,div):not(:first-child){margin-block:var(--vui-prose-gap-blocks)}.viraui__prose-module__Prose_8yO9h>:is(h1,h2,h3,h4,h5,h6):not(:last-child)+*{margin-block-start:var(--vui-prose-gap-heading-start)}.viraui__prose-module__Prose_8yO9h>:is(h1,h2,h3,h4,h5,h6){margin-block-end:var(--vui-prose-gap-heading-end);text-box:trim-both cap alphabetic}}
+@layer viraui.preflight, viraui.components, viraui.overrides;@layer viraui.components{@property --vui-prose-align{syntax:"*";inherits:false;initial-value:start}@property --vui-prose-gap-blocks{syntax:"<length>";inherits:true;initial-value:2em}@property --vui-prose-gap-heading-start{syntax:"<length>";inherits:true;initial-value:1.3em}@property --vui-prose-gap-heading-end{syntax:"<length>";inherits:true;initial-value:.8em}.viraui__prose-module__Prose_8yO9h{--vui-prose-gap-blocks:2em;--vui-prose-gap-heading-start:1.3em;--vui-prose-gap-heading-end:0.8em;&[data-prose-gap=s]{--vui-prose-gap-blocks:1em;--vui-prose-gap-heading-start:0.7em;--vui-prose-gap-heading-end:0.3em}&[data-prose-gap=m]{--vui-prose-gap-blocks:1.5em;--vui-prose-gap-heading-start:1em;--vui-prose-gap-heading-end:0.6em}&[data-prose-has-align=true]{text-align:var(--vui-prose-align)}&>:is(h1,h2,h3,h4,h5,h6,hgroup,ul,ol,dd,p,figure,img,pre,table,fieldset,blockquote,picture,div):where(:not(:first-child)){margin-block:var(--vui-prose-gap-blocks)}&>:is(h1,h2,h3,h4,h5,h6)+*{margin-block-start:var(--vui-prose-gap-heading-start)}&>:is(h1,h2,h3,h4,h5,h6){margin-block-end:var(--vui-prose-gap-heading-end);text-box:trim-both cap alphabetic}}}

package/dist/components/prose/prose.d.ts

@@ -7,7 +7,7 @@ type ProseGap = 's' | 'm' | 'l';
  * Grouping wrapper for document blocks. Native `div` attributes pass through.
  * Replace the root with Base UI `render` (for example `article`). No `as` prop.
  *
- * @default Native div pass-through props keep React defaults.
+ * @defaultValue Native div pass-through props keep React defaults.
  */
 export type ProseProps = React.ComponentPropsWithoutRef<'div'> & {
     /**
@@ -20,19 +20,19 @@ export type ProseProps = React.ComponentPropsWithoutRef<'div'> & {
      * Aligns the region using logical alignment values.
      * Omit so `text-align` inherits from the parent. Title/Text children that omit `align` inherit this value.
      *
-     * @default Inherits parent `text-align`.
+     * @defaultValue Inherits parent `text-align`.
      */
     align?: React.CSSProperties['textAlign'];
     /**
      * Replaces the default `div` root using Base UI render semantics.
      *
-     * @default The prose region renders a `div` root.
+     * @defaultValue The prose region renders a `div` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered prose root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
 };

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

@@ -5,7 +5,7 @@ import { RadioGroup as RadioGroupPrimitive } from '@base-ui/react';
  * Thin wrapper around Base UI `RadioGroup` with default option spacing.
  * Compose with `Field.Root` and `Fieldset` for group labels, validation, and copy.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type RadioGroupProps<Value = string> = RadioGroupPrimitive.Props<Value>;
 export declare const RadioGroup: <Value>({ children, className, ...otherProps }: RadioGroupProps<Value>) => import('react').JSX.Element;

package/dist/components/radio/radio.d.ts

@@ -7,37 +7,37 @@ import type * as React from 'react';
  * Self-contained option row for use inside `RadioGroup`. Group-level `name`,
  * `invalid`, and `error` belong on an external `Field.Root` and `Fieldset`, not on individual options.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type RadioProps = RadioRoot.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;
     /**
      * Controls the visual radio 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/select/select-indicator-slot.d.ts

@@ -5,7 +5,7 @@ export type SelectIndicatorSlotProps = {
      * When true, renders as Base UI `ItemIndicator` with `keepMounted`.
      * When false, renders an empty spacer with the same inline footprint.
      *
-     * @default false
+     * @defaultValue false
      */
     interactive?: boolean;
 };

package/dist/components/select/select-option.d.ts

@@ -4,25 +4,25 @@ import type * as React from 'react';
 /**
  * Public Select.Option props.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type SelectOptionProps = SelectItem.Props & {
     /**
      * Decorative leading node rendered before the option label.
      *
-     * @default No addon is rendered.
+     * @defaultValue No addon is rendered.
      */
     addon?: React.ReactNode;
     /**
      * Vertical alignment of the addon relative to the option label row.
      *
-     * @default 'center'
+     * @defaultValue 'center'
      */
     addonAlign?: StackProps['vAlign'];
     /**
      * Custom indicator node rendered when the option is selected.
      *
-     * @default Built-in Check chrome SVG at size 16
+     * @defaultValue Built-in Check chrome SVG at size 16
      */
     indicator?: React.ReactNode;
 };

package/dist/components/select/select-separator.d.ts

@@ -3,7 +3,7 @@ import type * as React from 'react';
 /**
  * Public Select.Separator props.
  *
- * @default `orientation` is `'horizontal'`.
+ * @defaultValue `orientation` is `'horizontal'`.
  */
 export type SelectSeparatorProps = React.ComponentProps<typeof PrimitiveSelect.Separator>;
 export declare function SelectSeparator({ className, orientation, ...separatorProps }: SelectSeparatorProps): React.JSX.Element;

package/dist/components/select/select.d.ts

@@ -11,59 +11,59 @@ import type * as React from 'react';
  * and change handlers, plus optional field copy rendered with the shared Vira
  * field label/helper pattern.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type SelectProps = SelectRoot.Props<string> & 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;
     /**
      * Error copy rendered with `Field.Error` and `Text` in the same slot as `description`.
      * Replaces description while the field is invalid and dirty.
      *
-     * @default No static error copy is rendered.
+     * @defaultValue No static error copy is rendered.
      */
     error?: React.ReactNode;
     /**
      * Placeholder text shown in the trigger when no value is selected.
      *
-     * @default No placeholder is rendered.
+     * @defaultValue No placeholder is rendered.
      */
     placeholder?: React.ReactNode;
     /**
      * Trigger addon rendered inside `Select.Icon`.
      * Pass any React node; use a named icon from `@viraui/icons/react` for content icons.
      *
-     * @default Built-in ChevronExpandY chrome SVG at size 16
+     * @defaultValue Built-in ChevronExpandY chrome SVG at size 16
      */
     addon?: React.ReactNode;
     /**
      * Ref forwarded to the select trigger button.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLButtonElement>;
     /**
      * When `true`, aligns the list popup width with the trigger via Base UI `alignItemWithTrigger`.
      * Prefer `false` when options use a leading `addon`.
      *
-     * @default true
+     * @defaultValue true
      */
     alignListWithTrigger?: boolean;
     /**
      * When `true`, open select locks page scroll and blocks outside pointer interaction
      * (Base UI modal). Vira defaults to non-modal so the page stays scrollable.
      *
-     * @default false
+     * @defaultValue false
      */
     modal?: boolean;
     /**
@@ -71,7 +71,7 @@ export type SelectProps = SelectRoot.Props<string> & Omit<FieldRoot.Props, 'ref'
      * 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 PrimitiveSelect.Portal>['container'];
 };

package/dist/components/separator/separator.d.ts

@@ -11,55 +11,55 @@ type SeparatorSize = 's' | 'm' | 'l';
  * plus Vira-owned orientation, line thickness, Stack padding, and Base UI `render` support for replacing the line root.
  * `className`, `style`, and `ref` apply to the line root only.
  *
- * @default Native pass-through props keep React defaults on the wrapper unless noted above.
+ * @defaultValue Native pass-through props keep React defaults on the wrapper unless noted above.
  */
 export type SeparatorProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'children'> & {
     /**
      * Replaces the default `hr` line root using Base UI render semantics.
      *
-     * @default The separator renders an `hr` line root.
+     * @defaultValue The separator renders an `hr` line root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered line root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
      * Sets the separator line direction.
      *
-     * @default 'horizontal'
+     * @defaultValue 'horizontal'
      */
     orientation?: 'horizontal' | 'vertical';
     /**
      * Sets inline padding on the Stack wrapper using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No inline padding.
+     * @defaultValue No inline padding.
      */
     hPadding?: SeparatorAxisPadding;
     /**
      * Sets block padding on the Stack wrapper using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No block padding.
+     * @defaultValue No block padding.
      */
     vPadding?: SeparatorAxisPadding;
     /**
      * Caps the Stack wrapper inline size.
      *
-     * @default No max width constraint.
+     * @defaultValue No max width constraint.
      */
     maxWidth?: StackProps['maxWidth'];
     /**
      * Sets the line thickness preset.
      *
-     * @default 's'
+     * @defaultValue 's'
      */
     size?: SeparatorSize;
     /**
      * Sets the separator line variant through `--vui-separator-border-style`.
      *
-     * @default 'solid'
+     * @defaultValue 'solid'
      */
     variant?: React.CSSProperties['borderStyle'];
 };

package/dist/components/shimmer/shimmer.d.ts

@@ -5,37 +5,37 @@ import type * as React from 'react';
  * Includes standard `span` attributes such as `children`, `id`, `title`, and event handlers,
  * plus Vira-owned shimmer tuning controls.
  *
- * @default Native span pass-through props keep React defaults.
+ * @defaultValue Native span pass-through props keep React defaults.
  */
 export type ShimmerProps = React.ComponentPropsWithoutRef<'span'> & {
     /**
      * Sets the shimmer sweep duration using any valid CSS time string.
      *
-     * @default The CSS duration is `var(--duration-slowest)`.
+     * @defaultValue The CSS duration is `var(--duration-slowest)`.
      */
     duration?: string;
     /**
      * Sets the shimmer highlight spread using any valid CSS length string.
      *
-     * @default The CSS spread is `calc(3ch + var(--space-2xl))`.
+     * @defaultValue The CSS spread is `calc(3ch + var(--space-2xl))`.
      */
     spread?: string;
     /**
      * Sets the shimmer gradient angle offset using any valid CSS angle string.
      *
-     * @default The CSS angle offset is `0deg`.
+     * @defaultValue The CSS angle offset is `0deg`.
      */
     angle?: string;
     /**
      * Overrides the shimmer highlight color when relative base lightness tuning is not used.
      *
-     * @default The highlight increases base `currentColor` lightness.
+     * @defaultValue The highlight increases base `currentColor` lightness.
      */
     highlightColor?: string;
     /**
      * Ref forwarded to the rendered shimmer root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLSpanElement>;
 };

package/dist/components/skeleton/skeleton-overlay.d.ts

@@ -6,31 +6,31 @@ import type * as React from 'react';
  * Zero-layout-shift shimmer wrapper sized by hidden children. Includes standard `div`
  * pass-through props plus Vira-owned shimmer controls.
  *
- * @default Native div pass-through props keep React defaults.
+ * @defaultValue Native div pass-through props keep React defaults.
  */
 export type SkeletonOverlayProps = React.ComponentPropsWithRef<'div'> & {
     /**
      * Supplies placeholder content whose layout and dimensions define the skeleton bounding box.
      *
-     * @default No default; consumer must provide children.
+     * @defaultValue No default; consumer must provide children.
      */
     children: React.ReactNode;
     /**
      * Enables or disables the shimmer animation.
      *
-     * @default true
+     * @defaultValue true
      */
     animate?: boolean;
     /**
      * Sets the corner radius from the Vira radius token scale.
      *
-     * @default 's'
+     * @defaultValue 's'
      */
     radius?: ThemeTypes['radius'];
     /**
      * Sets the shimmer sweep duration from the Vira duration token scale.
      *
-     * @default 'slow'
+     * @defaultValue 'slow'
      */
     duration?: ThemeTypes['duration'];
 };

package/dist/components/skeleton/skeleton.d.ts

@@ -7,55 +7,55 @@ import type * as React from 'react';
  * GPU shimmer block primitive. Includes standard `div` pass-through props such as `id`, `title`,
  * data attributes, and event handlers, plus Vira-owned sizing and shimmer controls.
  *
- * @default Native div pass-through props keep React defaults.
+ * @defaultValue Native div pass-through props keep React defaults.
  */
 export type SkeletonProps = React.ComponentPropsWithoutRef<'div'> & {
     /**
      * Sets the skeleton inline size using any valid CSS size string.
      *
-     * @default The skeleton sizes from context, constrained by the CSS minimum.
+     * @defaultValue The skeleton sizes from context, constrained by the CSS minimum.
      */
     width?: string;
     /**
      * Sets the skeleton block size using any valid CSS size string.
      *
-     * @default The skeleton sizes from context, constrained by the CSS minimum.
+     * @defaultValue The skeleton sizes from context, constrained by the CSS minimum.
      */
     height?: string;
     /**
      * Sets the skeleton minimum inline size using any valid CSS size string.
      *
-     * @default The CSS minimum inline size is `2rem`.
+     * @defaultValue The CSS minimum inline size is `2rem`.
      */
     minWidth?: string;
     /**
      * Sets the skeleton minimum block size using any valid CSS size string.
      *
-     * @default The CSS minimum block size is `1rem`.
+     * @defaultValue The CSS minimum block size is `1rem`.
      */
     minHeight?: string;
     /**
      * Enables or disables the shimmer animation.
      *
-     * @default true
+     * @defaultValue true
      */
     animate?: boolean;
     /**
      * Sets the corner radius from the Vira radius token scale.
      *
-     * @default 's'
+     * @defaultValue 's'
      */
     radius?: ThemeTypes['radius'];
     /**
      * Sets the shimmer sweep duration from the Vira duration token scale.
      *
-     * @default 'slow'
+     * @defaultValue 'slow'
      */
     duration?: ThemeTypes['duration'];
     /**
      * Ref forwarded to the rendered skeleton root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLDivElement>;
 };

package/dist/components/slider/slider.d.ts

@@ -7,31 +7,31 @@ import type * as React from 'react';
  * Includes Base UI slider root props such as `value`, `defaultValue`, `min`, `max`, `step`,
  * `disabled`, `orientation`, and change handlers, plus optional field copy and thumb labeling.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type SliderProps = SliderRoot.Props & FieldRoot.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` while the field is valid.
      *
-     * @default No description is rendered.
+     * @defaultValue No description is rendered.
      */
     description?: React.ReactNode;
     /**
      * Error copy rendered with `Field.Error` and `Text` in the same slot as `description`.
      *
-     * @default No static error copy is rendered.
+     * @defaultValue No static error copy is rendered.
      */
     error?: React.ReactNode;
     /**
      * Marks the slider as required and shows a required indicator on the label.
      *
-     * @default false
+     * @defaultValue false
      */
     required?: boolean;
     /**
@@ -40,7 +40,7 @@ export type SliderProps = SliderRoot.Props & FieldRoot.Props & {
      * Pass `true` for Base UI default formatting inside styled `Text`, or a
      * function matching `Slider.Value` `children` to own the value slot (no `Text`).
      *
-     * @default Value UI is hidden.
+     * @defaultValue Value UI is hidden.
      */
     renderValue?: boolean | Exclude<React.ComponentProps<typeof PrimitiveSlider.Value>['children'], null | undefined>;
     /**
@@ -50,7 +50,7 @@ export type SliderProps = SliderRoot.Props & FieldRoot.Props & {
      * Pass a two-element tuple to name each range thumb in order; on a single-thumb slider only the
      * first tuple value is applied.
      *
-     * @default No default; required when `label` is omitted and thumbs need distinct accessible names.
+     * @defaultValue No default; required when `label` is omitted and thumbs need distinct accessible names.
      */
     thumbAriaLabel?: string | readonly [string, string];
 };

package/dist/components/spinner/spinner.d.ts

@@ -4,19 +4,19 @@ export type SpinnerProps = Omit<React.ComponentProps<'svg'>, 'color'> & {
     /**
      * Sets the rendered spinner size.
      *
-     * @default 'l'
+     * @defaultValue 'l'
      */
     size?: 's' | 'm' | 'l';
     /**
      * Overrides the spinner fill color.
      *
-     * @default No default; inherits `currentColor`.
+     * @defaultValue No default; inherits `currentColor`.
      */
     color?: string;
     /**
      * Visual animation style.
      *
-     * @default 'bars'
+     * @defaultValue 'bars'
      */
     variant?: SpinnerVariant;
 };