@viraui/react 2026.7.0-next.0 → 2026.7.0

package/dist/components/stack/stack.d.ts

@@ -10,37 +10,37 @@ type StackAxisPadding = StackSpace | [StackSpace | 0, StackSpace | 0];
  * Includes standard `div` attributes such as `id`, `role`, `title`, and event handlers,
  * plus Vira-owned flex layout controls 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 StackProps = React.ComponentPropsWithoutRef<'div'> & {
     /**
      * Replaces the default `div` root using Base UI render semantics.
      *
-     * @default The stack renders a `div` root.
+     * @defaultValue The stack renders a `div` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered stack root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
      * Renders children across rows or columns using the chosen flex direction.
      *
-     * @default 'column'
+     * @defaultValue 'column'
      */
     direction?: 'row' | 'column' | 'row-reverse' | 'column-reverse';
     /**
      * Displays the stack as `inline-flex` instead of `flex`.
      *
-     * @default false
+     * @defaultValue false
      */
     inline?: boolean;
     /**
      * Allows direct children to wrap onto additional lines when space is constrained.
      *
-     * @default false
+     * @defaultValue false
      */
     wrap?: boolean;
     /**
@@ -50,7 +50,7 @@ export type StackProps = React.ComponentPropsWithoutRef<'div'> & {
      * Does not set the stack root's own inline size — use `fullWidth` when this stack must
      * fill its parent width (e.g. centered shell with `maxWidth`, or a full-bleed Button column).
      *
-     * @default false
+     * @defaultValue false
      */
     expandChildren?: boolean;
     /**
@@ -61,55 +61,55 @@ export type StackProps = React.ComponentPropsWithoutRef<'div'> & {
      * Use with `maxWidth` under a parent `hAlign="center"` for a fluid, capped, centered shell.
      * Orthogonal to `expandChildren` (self size vs children grow).
      *
-     * @default false
+     * @defaultValue false
      */
     fullWidth?: boolean;
     /**
      * Sets the gap between flex rows using the Vira space token scale.
      *
-     * @default No row gap.
+     * @defaultValue No row gap.
      */
     rowGap?: StackSpace;
     /**
      * Sets the gap between flex columns using the Vira space token scale.
      *
-     * @default No column gap.
+     * @defaultValue No column gap.
      */
     columnGap?: StackSpace;
     /**
      * Aligns content on the horizontal axis from the consumer point of view.
      *
-     * @default 'initial'
+     * @defaultValue 'initial'
      */
     hAlign?: StackAlignment;
     /**
      * Aligns content on the vertical axis from the consumer point of view.
      *
-     * @default 'initial'
+     * @defaultValue 'initial'
      */
     vAlign?: StackAlignment;
     /**
      * Sets inline padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No inline padding.
+     * @defaultValue No inline padding.
      */
     hPadding?: StackAxisPadding;
     /**
      * Sets block padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No block padding.
+     * @defaultValue No block padding.
      */
     vPadding?: StackAxisPadding;
     /**
      * Applies a maximum width value to the stack root.
      *
-     * @default No max width constraint.
+     * @defaultValue No max width constraint.
      */
     maxWidth?: string;
     /**
      * Applies a minimum width value to the stack root.
      *
-     * @default No minimum width constraint.
+     * @defaultValue No minimum width constraint.
      */
     minWidth?: string;
     /**
@@ -121,7 +121,7 @@ export type StackProps = React.ComponentPropsWithoutRef<'div'> & {
      * Warning: inline-size containment can affect nested layout (e.g. cards inside Masonry).
      * Use only when you need container queries against this specific Stack.
      *
-     * @default false
+     * @defaultValue false
      */
     enableContainer?: boolean;
 };

package/dist/components/static-noise/static-noise.d.ts

@@ -5,31 +5,31 @@ import type * as React from 'react';
  * Includes standard `figure` attributes such as `id`, `className`, and event handlers,
  * plus Vira-owned turbulence tuning controls.
  *
- * @default Native figure pass-through props keep React defaults.
+ * @defaultValue Native figure pass-through props keep React defaults.
  */
 export type StaticNoiseProps = React.ComponentPropsWithRef<'figure'> & {
     /**
      * Sets the SVG turbulence `baseFrequency` for the internal noise filter.
      *
-     * @default 0.5
+     * @defaultValue 0.5
      */
     baseFrequency?: number | string;
     /**
      * Sets the rendered overlay opacity.
      *
-     * @default 0.2
+     * @defaultValue 0.2
      */
     opacity?: number;
     /**
      * Sets the rendered overlay mix blend mode.
      *
-     * @default 'difference'
+     * @defaultValue 'difference'
      */
     mixBlendMode?: React.CSSProperties['mixBlendMode'];
     /**
      * Animates the internal turbulence filter by cycling `feTurbulence` seed values.
      *
-     * @default false
+     * @defaultValue false
      */
     animate?: boolean;
 };

package/dist/components/surface/surface.d.ts

@@ -14,70 +14,70 @@ export type SurfaceBorder = 'all' | 'top' | 'right' | 'bottom' | 'left';
  * Includes standard `div` attributes such as `id`, `role`, `title`, and event handlers,
  * plus Vira-owned container styling controls 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 SurfaceProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'color'> & {
     /**
      * Replaces the default `div` root using Base UI render semantics.
      *
-     * @default The surface renders a `div` root.
+     * @defaultValue The surface renders a `div` root.
      */
     render?: useRender.RenderProp;
     /**
      * Ref forwarded to the rendered surface root element.
      *
-     * @default No ref is attached.
+     * @defaultValue No ref is attached.
      */
     ref?: React.Ref<HTMLElement>;
     /**
      * Sets the resting background using a base ramp layer (`1`–`3`), a literal CSS color value, or the named token
      * `primary` (`data-surface-color="primary"`; CSS owns light/dark opacity via `--global-primary`).
      *
-     * @default No background.
+     * @defaultValue No background.
      */
     color?: SurfaceColor;
     /**
      * Sets the hover background on hover-capable pointers using a base ramp layer (`1`–`3`), a literal CSS value, or the
      * named token `primary` (`data-surface-hover-color="primary"`; CSS owns light/dark opacity via `--global-primary`).
      *
-     * @default No hover color override.
+     * @defaultValue No hover color override.
      */
     hoverColor?: SurfaceColor;
     /**
      * Applies the shared contrast border on one or more sides (`'all'`, `'top'`, `'right'`, `'bottom'`, `'left'`).
      * Pass a single side or a list (e.g. `['bottom', 'left']`). Omit for no border.
      *
-     * @default No border.
+     * @defaultValue No border.
      */
     border?: SurfaceBorder | readonly SurfaceBorder[];
     /**
      * Sets the CSS border style when `border` is set.
      *
-     * @default solid
+     * @defaultValue solid
      */
     borderStyle?: 'solid' | 'dashed' | 'dotted' | 'double';
     /**
      * Sets corner radius from the Vira radius token scale, a per-corner `[top-left, top-right, bottom-right, bottom-left]` tuple (`0` for square corners), or `auto` for concentric radii from the nearest ancestor Surface.
      *
-     * @default No radius.
+     * @defaultValue No radius.
      */
     radius?: SurfaceRadiusInput;
     /**
      * Sets inline padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No inline padding.
+     * @defaultValue No inline padding.
      */
     hPadding?: SurfacePadding;
     /**
      * Sets block padding using one token for both sides or a `[start, end]` tuple.
      *
-     * @default No block padding.
+     * @defaultValue No block padding.
      */
     vPadding?: SurfacePadding;
     /**
      * Sets root overflow through the `--vui-surface-overflow` custom property.
      *
-     * @default visible
+     * @defaultValue visible
      */
     overflow?: React.CSSProperties['overflow'];
     /**
@@ -89,7 +89,7 @@ export type SurfaceProps = Omit<React.ComponentPropsWithoutRef<'div'>, 'color'>
      * Warning: inline-size containment can affect nested layout (e.g. cards inside Masonry).
      * Use only when you need container queries against this specific Surface.
      *
-     * @default false
+     * @defaultValue false
      */
     enableContainer?: boolean;
 };

package/dist/components/switch/switch.d.ts

@@ -9,44 +9,44 @@ 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 SwitchProps = SwitchRoot.Props & 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;
     /**
      * Controls the visual switch 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/tabs/tabs-list.d.ts

@@ -6,7 +6,7 @@ import type * as React from 'react';
  * Wraps Base UI `Tabs.List` in a compact `Surface`, lays out items with `Stack`,
  * and renders the active tab indicator internally.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type TabsListProps = TabsListPrimitive.Props;
 export declare const TabsList: React.FC<TabsListProps>;

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

@@ -5,7 +5,7 @@ import type * as React from 'react';
  *
  * Base UI `Tabs.Panel` with entry slide/fade animation.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type TabsPanelProps = TabsPanelPrimitive.Props;
 export declare const TabsPanel: React.FC<TabsPanelProps>;

package/dist/components/tabs/tabs-tab.d.ts

@@ -5,19 +5,19 @@ import type * as React from 'react';
  *
  * Wraps Base UI `Tabs.Tab` with optional decorative addon layout.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type TabsTabProps = TabsTabPrimitive.Props & {
     /**
      * Decorative addon rendered alongside the tab label.
      *
-     * @default No addon is rendered.
+     * @defaultValue No addon is rendered.
      */
     addon?: React.ReactNode;
     /**
      * Controls whether the addon appears before or after the label.
      *
-     * @default 'start'
+     * @defaultValue 'start'
      */
     addonPosition?: 'start' | 'end';
 };

package/dist/components/tabs/tabs.d.ts

@@ -11,13 +11,13 @@ import * as React from 'react';
  * Includes Base UI tabs root props such as `value`, `defaultValue`, `orientation`,
  * and `onValueChange`.
  *
- * @default Base UI pass-through props keep upstream defaults.
+ * @defaultValue Base UI pass-through props keep upstream defaults.
  */
 export type TabsProps = TabsRoot.Props & {
     /**
      * Horizontal alignment of tab list within root Stack.
      *
-     * @default 'start'
+     * @defaultValue 'start'
      */
     listAlignment?: Extract<StackProps['hAlign'], 'start' | 'center' | 'end' | 'stretch'>;
 };

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> & {
     /**