@nexub/react 1.5.1 → 1.7.0

package/dist/index.d.ts

@@ -1,9 +1,11 @@
 import { ClassValue } from 'clsx';
 import * as React from 'react';
 import { useLayoutEffect, Ref } from 'react';
+import { Locale } from 'date-fns';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { VariantProps } from 'class-variance-authority';
-import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as RadixRadioGroup from '@radix-ui/react-radio-group';
+import * as RadixCheckbox from '@radix-ui/react-checkbox';
 export { Root as VisuallyHidden, VisuallyHiddenProps } from '@radix-ui/react-visually-hidden';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as RadixAlertDialog from '@radix-ui/react-alert-dialog';
@@ -15,8 +17,6 @@ import * as RadixContextMenu from '@radix-ui/react-context-menu';
 import * as RadixNav from '@radix-ui/react-navigation-menu';
 import * as RadixSelect from '@radix-ui/react-select';
 import * as RadixSwitch from '@radix-ui/react-switch';
-import * as RadixCheckbox from '@radix-ui/react-checkbox';
-import * as RadixRadioGroup from '@radix-ui/react-radio-group';
 import * as RadixSlider from '@radix-ui/react-slider';
 import * as RadixToggle from '@radix-ui/react-toggle';
 import * as RadixToggleGroup from '@radix-ui/react-toggle-group';
@@ -32,6 +32,12 @@ export { DateRange } from 'react-day-picker';
 
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * Run a DOM update as a view transition (styles: @nexub/themes/view-transitions).
+ * Where the API is missing, or on the server, the update just runs.
+ */
+declare function startViewTransition(update: () => void | Promise<void>): void;
+
 interface UseControllableStateOptions<T> {
     value?: T;
     defaultValue?: T;
@@ -52,15 +58,285 @@ declare function useMediaQuery(query: string): boolean;
 
 declare function useMergedRefs<T>(...refs: Array<Ref<T> | undefined>): (node: T) => void;
 
+/**
+ * Pointer position for the `nx-sheen` effect (themes/base.css). Returns a
+ * pointermove handler that writes --nx-mx / --nx-my (px, relative to the
+ * element) through the CSSOM — no style attribute, so strict-CSP safe — at
+ * most once per frame. Touch is ignored: there is no hover to light.
+ */
+declare function usePointerSheen<T extends HTMLElement>(enabled: boolean, onPointerMove?: React.PointerEventHandler<T>): React.PointerEventHandler<T> | undefined;
+
+interface PromptInputMessages {
+    promptLabel: string;
+    sendMessage: string;
+    stopGenerating: string;
+    promptHint: string;
+}
+type PromptInputStatus = 'idle' | 'submitting' | 'streaming';
+interface PromptInputProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaElement>, 'value' | 'defaultValue' | 'onChange' | 'onSubmit' | 'rows'> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    /** Called with the current text on Enter or Send. Uncontrolled input clears itself after. */
+    onSubmit?: (value: string) => void;
+    /** Called by Stop (or Escape) while `status="streaming"`. */
+    onStop?: () => void;
+    /** `streaming` turns Send into Stop; `submitting` holds Send. @default 'idle' */
+    status?: PromptInputStatus;
+    /** Rows before the field scrolls. @default 8 */
+    maxRows?: number;
+    /** Rendered above the text, e.g. removable Chips. */
+    attachments?: React.ReactNode;
+    /** Rendered bottom-start, e.g. an attach IconButton or a model picker. */
+    actions?: React.ReactNode;
+    surface?: 'solid' | 'glass';
+    /** Accessible name of the text field. @default messages.promptLabel ('Message') */
+    label?: string;
+    /** Local overrides for this component's strings. */
+    messages?: Partial<PromptInputMessages>;
+    /** Class for the outer container (`className` goes to it too); this one targets the textarea. */
+    textareaClassName?: string;
+}
+declare const PromptInput: React.ForwardRefExoticComponent<PromptInputProps & React.RefAttributes<HTMLTextAreaElement>>;
+
+interface ThinkingIndicatorMessages {
+    thinking: string;
+}
+interface ThinkingIndicatorProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Visible text. Pass `null` to hide it (it is still announced). @default messages.thinking */
+    label?: React.ReactNode;
+    /** @default 'md' */
+    size?: 'sm' | 'md';
+    /** Local overrides for this component's strings. */
+    messages?: Partial<ThinkingIndicatorMessages>;
+}
+/**
+ * Shows the assistant is working before tokens arrive: a primary-tinted shape
+ * morphing between a circle and a soft four-lobed squircle (.nx-morph), and a
+ * label with a decorative shimmer (.nx-shimmer). Reduced motion: both static.
+ */
+declare const ThinkingIndicator: React.ForwardRefExoticComponent<ThinkingIndicatorProps & React.RefAttributes<HTMLDivElement>>;
+
+interface StreamingTextProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
+    /** The full text received so far; grows as tokens arrive. */
+    text: string;
+    /** True while more text is expected: shows the caret and sets aria-busy. */
+    streaming?: boolean;
+    as?: 'div' | 'p' | 'span';
+    /**
+     * Opt-in live announcements. Off by default: screen readers re-read the
+     * whole region on every token; announce the finished message instead.
+     */
+    'aria-live'?: 'off' | 'polite';
+}
+/**
+ * Assistant text as it streams in. Text already shown stays static; each newly
+ * appended tail fades in (nx-reveal), and only the last few tails keep their
+ * own span, so the DOM stays flat however long the answer gets.
+ */
+declare const StreamingText: React.ForwardRefExoticComponent<StreamingTextProps & React.RefAttributes<HTMLElement>>;
+
+interface MessageStrings {
+    youSaid: string;
+    assistantSaid: string;
+    failedToSend: string;
+    retry: string;
+    copy: string;
+    copied: string;
+    goodResponse: string;
+    badResponse: string;
+    regenerate: string;
+}
+declare const defaultMessageStrings: MessageStrings;
+type MessageFrom = 'user' | 'assistant' | 'system';
+interface MessageBubbleProps extends React.HTMLAttributes<HTMLElement> {
+    /** Who sent it. (Not `role`, which is the ARIA attribute.) */
+    from: MessageFrom;
+    /** Assistant only: shown at the inline-start. */
+    avatar?: React.ReactNode;
+    /** Accessible label for the message; defaults to "You said" / "Assistant said". */
+    name?: string;
+    status?: 'sending' | 'error';
+    /** With status="error": renders a Retry text button. */
+    onRetry?: () => void;
+    messages?: Partial<MessageStrings>;
+}
+declare const MessageBubble: React.ForwardRefExoticComponent<MessageBubbleProps & React.RefAttributes<HTMLElement>>;
+type Feedback = 'up' | 'down' | null;
+interface MessageActionsProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Text placed on the clipboard by Copy. */
+    text?: string;
+    /** Set false to hide Copy. @default true */
+    copy?: boolean;
+    feedback?: Feedback;
+    defaultFeedback?: Feedback;
+    /** Shows thumbs up/down when provided. */
+    onFeedback?: (feedback: Feedback) => void;
+    /** Shows Regenerate when provided. */
+    onRegenerate?: () => void;
+    messages?: Partial<MessageStrings>;
+}
+/** Copy / feedback / regenerate row. Fades in on hover or focus of the parent MessageBubble on pointer devices. */
+declare const MessageActions: React.ForwardRefExoticComponent<MessageActionsProps & React.RefAttributes<HTMLDivElement>>;
+
+interface CitationSource {
+    title: string;
+    url: string;
+    /** Shown instead of the URL's hostname. */
+    domain?: string;
+    snippet?: string;
+    /** Favicon URL (http/https only; anything else falls back to a letter). */
+    favicon?: string;
+}
+interface CitationMessages {
+    /** SourceList heading. */
+    sources: string;
+    /** Prefix of a citation's accessible name ("Source 1: <title>"). */
+    source: (index: number) => string;
+}
+/** Returns the normalised href for http(s) URLs, otherwise undefined (javascript:, data:, relative…). */
+declare function safeUrl(url: string | undefined): string | undefined;
+interface CitationProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
+    /** 1-based number shown in the marker. */
+    index: number;
+    source: CitationSource;
+    messages?: Partial<CitationMessages>;
+}
+/**
+ * Inline numbered source marker for running text. Links to the source (http/https
+ * only — anything else renders as plain text) and previews it in a HoverCard on
+ * hover or focus.
+ */
+declare const Citation: React.ForwardRefExoticComponent<CitationProps & React.RefAttributes<HTMLElement>>;
+interface SourceChipProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
+    source: CitationSource;
+}
+/** Compact source row item: favicon, domain and a truncated title, linking to the source. */
+declare const SourceChip: React.ForwardRefExoticComponent<SourceChipProps & React.RefAttributes<HTMLElement>>;
+interface SourceListProps extends Omit<React.HTMLAttributes<HTMLElement>, 'children'> {
+    sources: CitationSource[];
+    messages?: Partial<CitationMessages>;
+}
+/**
+ * "Sources" heading plus a row of SourceChips: a horizontal scroll-snap row when
+ * narrow, a wrapping grid once its own container is 480px or wider.
+ */
+declare const SourceList: React.ForwardRefExoticComponent<SourceListProps & React.RefAttributes<HTMLElement>>;
+
+/** Every user-facing default string in @nexub/react. Explicit component props still win. */
+interface NexubMessages {
+    close: string;
+    dismissAlert: string;
+    dismissBanner: string;
+    remove: string;
+    removeFilter: string;
+    removeFile: (fileName: string) => string;
+    uploadFiles: string;
+    clickToUpload: string;
+    orDragAndDrop: string;
+    clearSearch: string;
+    showPassword: string;
+    hidePassword: string;
+    increment: string;
+    decrement: string;
+    loading: string;
+    pagination: string;
+    previousPage: string;
+    nextPage: string;
+    goToPage: (page: number) => string;
+    breadcrumb: string;
+    breadcrumbMore: string;
+    moreCount: (count: number) => string;
+    rating: string;
+    ratingStars: (stars: number) => string;
+    mainNavigation: string;
+    sidebar: string;
+    searchPlaceholder: string;
+    noResults: string;
+    pickDate: string;
+    pickDateRange: string;
+    /** Calendar nav and day labels (DatePicker, DateRangePicker). */
+    previousMonth: string;
+    nextMonth: string;
+    calendarNavigation: string;
+    /** Wraps a day's formatted date when it is today. */
+    todayDate: (date: string) => string;
+    /** Wraps a day's (possibly today-wrapped) label when it is selected. */
+    selectedDate: (label: string) => string;
+    commandPalette: string;
+    /** Toaster region label; Radix replaces `{hotkey}`. */
+    notifications: string;
+    undo: string;
+    promptLabel: string;
+    sendMessage: string;
+    stopGenerating: string;
+    promptHint: string;
+    thinking: string;
+    youSaid: string;
+    assistantSaid: string;
+    failedToSend: string;
+    retry: string;
+    copy: string;
+    copied: string;
+    goodResponse: string;
+    badResponse: string;
+    regenerate: string;
+    sources: string;
+    source: (index: number) => string;
+    jumpToLatest: string;
+    conversation: string;
+}
+declare const defaultMessages: NexubMessages;
+type Direction = 'ltr' | 'rtl';
+interface NexubProviderProps {
+    /** BCP 47 locale for Intl formatting. @default 'en' */
+    locale?: string;
+    /** Text direction for Radix primitives. @default derived from `locale` */
+    dir?: Direction;
+    /**
+     * date-fns Locale for calendars (month/weekday names, week start, trigger text).
+     * Import only the one you need, e.g. `import { fr } from 'date-fns/locale/fr'`.
+     */
+    dateLocale?: Locale;
+    /** Overrides for the default English strings. */
+    messages?: Partial<NexubMessages>;
+    children?: React.ReactNode;
+}
+/**
+ * Locale, direction and translated strings for every @nexub/react component.
+ * It does not set `dir`/`lang` on <html> — the app does that (as it renders
+ * <html>), so the page and CSS `rtl:` variants agree with this provider.
+ */
+declare function NexubProvider({ locale, dir, dateLocale, messages, children }: NexubProviderProps): React.JSX.Element;
+/** The active strings: defaults merged with the nearest NexubProvider's overrides. */
+declare function useNexubMessages(): NexubMessages;
+/** The active locale (default 'en'), direction and optional date-fns Locale. */
+declare function useLocale(): {
+    locale: string;
+    dir: Direction;
+    dateLocale?: Locale;
+};
+
 type ToneValue = 'neutral' | 'info' | 'success' | 'warning' | 'danger' | 'leap' | 'bookub' | 'payub' | 'founderub';
 declare const buttonVariants: (props?: ({
-    variant?: "accent" | "text" | "link" | "glass" | "filled" | "tonal" | "outlined" | "primary" | "secondary" | "subtle" | "outline" | "ghost" | "destructive" | null | undefined;
+    variant?: "accent" | "text" | "link" | "glass" | "ghost" | "outline" | "subtle" | "filled" | "tonal" | "outlined" | "primary" | "secondary" | "destructive" | null | undefined;
     size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
     fullWidth?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
+type ButtonStatus = 'idle' | 'loading' | 'success' | 'error';
 interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
     tone?: ToneValue;
+    /** Async feedback. `loading` blocks clicks (aria-disabled, focus kept),
+     *  `success` draws a check, `error` shakes once. Not applied with `asChild`. */
+    status?: ButtonStatus;
+    /** Alias for `status="loading"`. */
     loading?: boolean;
+    /** Announced while loading. @default 'Loading' */
+    loadingLabel?: string;
+    /** Announced on success; when given it also replaces the visible label. @default 'Done' */
+    successLabel?: string;
+    /** Announced on error. @default 'Something went wrong' */
+    errorLabel?: string;
     fullWidth?: boolean;
     leadingIcon?: React.ReactNode;
     trailingIcon?: React.ReactNode;
@@ -89,7 +365,7 @@ interface SplitButtonProps extends Omit<ButtonProps, 'asChild' | 'trailingIcon'
 declare const SplitButton: React.ForwardRefExoticComponent<SplitButtonProps & React.RefAttributes<HTMLButtonElement>>;
 
 declare const iconButtonVariants: (props?: ({
-    variant?: "solid" | "subtle" | "outline" | "ghost" | null | undefined;
+    variant?: "solid" | "ghost" | "outline" | "subtle" | null | undefined;
     size?: "xs" | "sm" | "md" | "lg" | "xl" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface IconButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof iconButtonVariants> {
@@ -174,6 +450,8 @@ interface AmountProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'child
     tone?: 'neutral' | 'auto';
     /** e.g. 'exceptZero' to show "+" on gains. */
     signDisplay?: Intl.NumberFormatOptions['signDisplay'];
+    /** Roll digits to new values (NumberTicker). The first render never animates. */
+    animate?: boolean;
 }
 /**
  * A money figure, honest by default (Calm Depth §3.5): tabular numerals, the
@@ -181,6 +459,27 @@ interface AmountProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'child
  */
 declare const Amount: React.ForwardRefExoticComponent<AmountProps & React.RefAttributes<HTMLSpanElement>>;
 
+/** A run of already-formatted text with its own class (Amount's muted symbol and minor units). */
+interface NumberTickerPart {
+    value: string;
+    className?: string;
+}
+interface NumberTickerProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'children'> {
+    /** A number (formatted with `format`/`locale`), an already-formatted string, or styled parts. */
+    value: number | string | readonly NumberTickerPart[];
+    format?: Intl.NumberFormatOptions;
+    /** BCP 47 locale. Defaults to the user's. */
+    locale?: string;
+    /** Announce changes to screen readers. */
+    'aria-live'?: 'off' | 'polite';
+}
+/**
+ * A rolling number: each digit is a 0–9 strip that slides to its value on the
+ * spatial spring; separators, symbols and signs stay static. The first render
+ * shows the value as-is; only later changes animate.
+ */
+declare const NumberTicker: React.ForwardRefExoticComponent<NumberTickerProps & React.RefAttributes<HTMLSpanElement>>;
+
 interface SearchInputProps extends Omit<InputProps, 'leadingIcon' | 'trailingIcon'> {
     onClear?: () => void;
 }
@@ -225,7 +524,7 @@ interface FormFieldRootProps extends React.HTMLAttributes<HTMLDivElement> {
     required?: boolean;
     disabled?: boolean;
 }
-declare function FieldLabel({ className, children, ...props }: React.ComponentProps<typeof Label>): react_jsx_runtime.JSX.Element;
+declare function FieldLabel({ className, children, ...props }: React.ComponentProps<typeof Label>): React.JSX.Element;
 declare namespace FieldLabel {
     var displayName: string;
 }
@@ -235,11 +534,11 @@ declare function Control({ children }: {
 declare namespace Control {
     var displayName: string;
 }
-declare function Description({ className, children, ...props }: React.ComponentProps<typeof HelperText>): react_jsx_runtime.JSX.Element;
+declare function Description({ className, children, ...props }: React.ComponentProps<typeof HelperText>): React.JSX.Element;
 declare namespace Description {
     var displayName: string;
 }
-declare function FieldError({ className, children, ...props }: React.ComponentProps<typeof FormError>): react_jsx_runtime.JSX.Element | null;
+declare function FieldError({ className, children, ...props }: React.ComponentProps<typeof FormError>): React.JSX.Element | null;
 declare namespace FieldError {
     var displayName: string;
 }
@@ -297,7 +596,14 @@ declare const tagVariants: (props?: ({
 interface TagProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof tagVariants> {
     tone?: ToneValue;
 }
-/** @deprecated Use `Badge` instead: `<Badge size="sm">` covers it. Will be removed in 1.0. */
+/**
+ * Static metadata label (status, category, version). Shape: `rounded-shape-min`,
+ * a squared label, so it never reads as tappable. It has no state layer or
+ * hover/press affordance on purpose; anything a user toggles, filters by or
+ * removes is a `Chip` (control-shaped, `nx-state-layer`, optional remove button).
+ *
+ * @deprecated Use `Badge` instead: `<Badge size="sm">` covers it. Will be removed in 1.0.
+ */
 declare const Tag: React.ForwardRefExoticComponent<TagProps & React.RefAttributes<HTMLSpanElement>>;
 
 interface EyebrowChipProps extends React.HTMLAttributes<HTMLSpanElement> {
@@ -335,9 +641,72 @@ declare const cardVariants: (props?: ({
 interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
     tone?: ToneValue;
     surface?: 'solid' | 'glass';
+    /** `sheen`: a soft light follows the pointer (opt-in; off for touch and reduced motion). */
+    effect?: 'none' | 'sheen';
     asChild?: boolean;
 }
 declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
+interface CardLinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    asChild?: boolean;
+}
+/**
+ * Makes the whole card one link (the "stretched link" pattern): put it around
+ * the card's title. Its ::after covers the card, so the link has one
+ * accessible name and the focus ring shows on the card. Give other
+ * interactive elements inside the card `relative z-[1]` to keep them clickable.
+ */
+declare const CardLink: React.ForwardRefExoticComponent<CardLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+
+interface SelectableCardContentProps {
+    /** Leading icon. */
+    icon?: React.ReactNode;
+    /** The card's accessible name. */
+    title: React.ReactNode;
+    /** Secondary text, exposed as the accessible description. */
+    description?: React.ReactNode;
+    /** Extra content under the description. Keep it non-interactive: the whole card is the control. */
+    children?: React.ReactNode;
+}
+
+interface RadioCardGroupProps extends RadixRadioGroup.RadioGroupProps {
+    /** Grid columns (collapses to one column on narrow screens). */
+    columns?: 1 | 2 | 3 | 4;
+}
+declare const RadioCardGroup: React.ForwardRefExoticComponent<RadioCardGroupProps & React.RefAttributes<HTMLDivElement>>;
+interface RadioCardProps extends Omit<RadixRadioGroup.RadioGroupItemProps, 'title' | 'children'>, SelectableCardContentProps {
+}
+declare const RadioCard: React.ForwardRefExoticComponent<RadioCardProps & React.RefAttributes<HTMLButtonElement>>;
+
+interface CheckboxCardProps extends Omit<RadixCheckbox.CheckboxProps, 'title' | 'children' | 'checked' | 'defaultChecked' | 'onCheckedChange'>, SelectableCardContentProps {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+}
+declare const CheckboxCard: React.ForwardRefExoticComponent<CheckboxCardProps & React.RefAttributes<HTMLButtonElement>>;
+
+type MediaCardRatio = '16/9' | '4/3' | '1/1' | '3/4';
+interface MediaCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title'> {
+    src: string;
+    /** Required. Pass '' when the image is decorative. */
+    alt: string;
+    /** @default '16/9' */
+    ratio?: MediaCardRatio;
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    eyebrow?: React.ReactNode;
+    /** Makes the whole card one link, stretched from the title (so needs `title`). */
+    href?: string;
+    /** Actions; they stay clickable above the stretched link. */
+    children?: React.ReactNode;
+}
+/**
+ * An image card with a glass caption over a soft bottom scrim.
+ *
+ * Layers stack in one grid cell rather than with absolute positioning: the
+ * glass panel's backdrop-filter would otherwise become the containing block of
+ * the stretched link's ::after, shrinking the hit area to the caption.
+ */
+declare const MediaCard: React.ForwardRefExoticComponent<MediaCardProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const alertVariants: (props?: ({
     tone?: "neutral" | "info" | "success" | "warning" | "danger" | "leap" | "bookub" | "payub" | "founderub" | null | undefined;
@@ -380,6 +749,7 @@ declare const skeletonVariants: (props?: ({
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface SkeletonProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof skeletonVariants> {
     shape?: 'line' | 'rect' | 'circle';
+    /** Arbitrary size; rendered as inline style. Omit to use the shape's default classes. */
     width?: string | number;
     height?: string | number;
     animated?: boolean;
@@ -531,7 +901,7 @@ interface AspectRatioProps extends React.HTMLAttributes<HTMLDivElement> {
 declare const AspectRatio: React.ForwardRefExoticComponent<AspectRatioProps & React.RefAttributes<HTMLDivElement>>;
 
 declare const headingVariants: (props?: ({
-    size?: "display" | "h2" | "h3" | "h1" | "h4" | "h5" | "h6" | null | undefined;
+    size?: "display" | "h1" | "h2" | "h3" | "h4" | "h5" | "h6" | null | undefined;
     weight?: "bold" | "regular" | "medium" | "semibold" | "extrabold" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 type HeadingSize = 'display' | 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
@@ -547,7 +917,7 @@ declare const Heading: React.ForwardRefExoticComponent<HeadingProps & React.RefA
 
 declare const textVariants: (props?: ({
     size?: "body" | "label" | "caption" | "body-lg" | "body-sm" | null | undefined;
-    tone?: "default" | "secondary" | "subtle" | "muted" | "inverse" | null | undefined;
+    tone?: "default" | "subtle" | "secondary" | "muted" | "inverse" | null | undefined;
     weight?: "bold" | "regular" | "medium" | "semibold" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface TextProps extends React.HTMLAttributes<HTMLParagraphElement>, VariantProps<typeof textVariants> {
@@ -633,17 +1003,18 @@ declare const Popover: {
     Close: React.ForwardRefExoticComponent<RadixPopover.PopoverCloseProps & React.RefAttributes<HTMLButtonElement>>;
 };
 
-declare const Provider: React.FC<RadixTooltip.TooltipProviderProps>;
+declare function Provider$1({ delayDuration, skipDelayDuration, ...props }: RadixTooltip.TooltipProviderProps): React.JSX.Element;
 interface TooltipProps {
     label: string;
     side?: 'top' | 'right' | 'bottom' | 'left';
     delayDuration?: number;
     children: React.ReactElement;
 }
-declare function Tooltip({ label, side, delayDuration, children }: TooltipProps): react_jsx_runtime.JSX.Element;
+declare function Tooltip({ label, side, delayDuration, children }: TooltipProps): React.JSX.Element;
 
+declare function Root$1({ openDelay, closeDelay, ...props }: RadixHoverCard.HoverCardProps): React.JSX.Element;
 declare const HoverCard: {
-    Root: React.FC<RadixHoverCard.HoverCardProps>;
+    Root: typeof Root$1;
     Trigger: React.ForwardRefExoticComponent<RadixHoverCard.HoverCardTriggerProps & React.RefAttributes<HTMLAnchorElement>>;
     Content: React.ForwardRefExoticComponent<RadixHoverCard.HoverCardContentProps & React.RefAttributes<HTMLDivElement>>;
     Arrow: React.ForwardRefExoticComponent<RadixHoverCard.HoverCardArrowProps & React.RefAttributes<SVGSVGElement>>;
@@ -771,7 +1142,7 @@ interface DrawerRootProps {
     container?: HTMLElement | null;
     autoFocus?: boolean;
 }
-declare function Root({ scrollLock, onOpenChange, ...props }: DrawerRootProps): react_jsx_runtime.JSX.Element;
+declare function Root({ scrollLock, onOpenChange, ...props }: DrawerRootProps): React.JSX.Element;
 declare namespace Root {
     var displayName: string;
 }
@@ -909,7 +1280,7 @@ interface AutocompleteProps {
     loading?: boolean;
     className?: string;
 }
-declare function Autocomplete({ options, value, onValueChange, placeholder, emptyText, loading, className, }: AutocompleteProps): react_jsx_runtime.JSX.Element;
+declare function Autocomplete({ options, value, onValueChange, placeholder, emptyText, loading, className, }: AutocompleteProps): React.JSX.Element;
 declare namespace Autocomplete {
     var displayName: string;
 }
@@ -1009,8 +1380,13 @@ declare const Toolbar: {
     ToggleItem: React.ForwardRefExoticComponent<RadixToolbar.ToolbarToggleItemProps & React.RefAttributes<HTMLButtonElement>>;
 };
 
+/** Swipe to dismiss toward the viewport's inline-end edge: right, or left in RTL. */
+declare function Provider({ swipeDirection, ...props }: RadixToast.ToastProviderProps): React.JSX.Element;
+declare namespace Provider {
+    var displayName: string;
+}
 declare const Toast: {
-    Provider: React.FC<RadixToast.ToastProviderProps>;
+    Provider: typeof Provider;
     Viewport: React.ForwardRefExoticComponent<RadixToast.ToastViewportProps & React.RefAttributes<HTMLOListElement>>;
     Root: React.ForwardRefExoticComponent<RadixToast.ToastProps & React.RefAttributes<HTMLLIElement>>;
     Title: React.ForwardRefExoticComponent<RadixToast.ToastTitleProps & React.RefAttributes<HTMLDivElement>>;
@@ -1019,7 +1395,23 @@ declare const Toast: {
     Close: React.ForwardRefExoticComponent<RadixToast.ToastCloseProps & React.RefAttributes<HTMLButtonElement>>;
 };
 
-declare function Toaster(): react_jsx_runtime.JSX.Element;
+interface ToasterProps {
+    /** Always show the toasts as a list instead of a collapsed stack. */
+    expand?: boolean;
+    /** How many toasts are visible at once; older ones are visually hidden. Default 3. */
+    visibleToasts?: number;
+}
+/**
+ * Sonner-style stack. Collapsed: the newest toast in front, older ones peek
+ * out below it, scaled down. Hovering or focusing the viewport fans them out
+ * into a list. Radix pauses every toast's timer while the viewport is hovered
+ * or focused — the same condition that expands the stack.
+ *
+ * Measured heights reach CSS as custom properties set through the CSSOM
+ * (--nx-toast-index / --nx-toast-offset per toast, --nx-front-height and
+ * --nx-stack-height on the viewport), never a style attribute (strict CSP).
+ */
+declare function Toaster({ expand, visibleToasts }: ToasterProps): React.JSX.Element;
 declare namespace Toaster {
     var displayName: string;
 }
@@ -1035,15 +1427,35 @@ interface ToastItem {
         label: string;
         onClick: () => void;
     };
+    /** An Undo action; its label defaults to the `undo` message. Set by `toast.undoable`. */
+    undo?: {
+        label?: string;
+        onUndo: () => void;
+    };
+    /** Called once when the toast closes, however it closes (timer, swipe, close, action, dismiss). */
+    onClose?: () => void;
+}
+interface UndoableToastOptions {
+    /** Called when Undo is clicked; the toast then closes. */
+    onUndo: () => void;
+    /** Called once when the toast closes any other way — the change is final. */
+    onCommit?: () => void;
+    /** @default the `undo` message ('Undo') */
+    undoLabel?: string;
+    description?: string;
+    duration?: number;
 }
 declare function useToastStore(): ToastItem[];
 declare function dismiss(id?: string): void;
+declare function undoable(title: string, { onUndo, onCommit, undoLabel, description, duration }: UndoableToastOptions): string;
 declare const toast: {
     success: (title: string, opts?: Partial<Omit<ToastItem, "id" | "title" | "tone">>) => string;
     error: (title: string, opts?: Partial<Omit<ToastItem, "id" | "title" | "tone">>) => string;
     info: (title: string, opts?: Partial<Omit<ToastItem, "id" | "title" | "tone">>) => string;
     warning: (title: string, opts?: Partial<Omit<ToastItem, "id" | "title" | "tone">>) => string;
     custom: (title: string, opts?: Partial<Omit<ToastItem, "id" | "title" | "tone">>) => string;
+    /** A toast with an Undo action: Undo calls `onUndo`; any other close calls `onCommit`, once. */
+    undoable: typeof undoable;
     dismiss: typeof dismiss;
 };
 
@@ -1119,11 +1531,11 @@ declare const Breadcrumb: {
         ({ children, className, }: {
             children?: React.ReactNode;
             className?: string;
-        }): react_jsx_runtime.JSX.Element;
+        }): React.JSX.Element;
         displayName: string;
     };
     Ellipsis: {
-        ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): react_jsx_runtime.JSX.Element;
+        ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): React.JSX.Element;
         displayName: string;
     };
 };
@@ -1229,7 +1641,7 @@ interface DataTableProps<TData> extends React.HTMLAttributes<HTMLDivElement> {
         pageSize?: number;
     };
 }
-declare function DataTable<TData>({ columns, data, enableSorting, enableRowSelection, pagination, className, ...props }: DataTableProps<TData>): react_jsx_runtime.JSX.Element;
+declare function DataTable<TData>({ columns, data, enableSorting, enableRowSelection, pagination, className, ...props }: DataTableProps<TData>): React.JSX.Element;
 
 declare const EmptyState: {
     Root: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
@@ -1274,6 +1686,8 @@ interface DatePickerProps {
     id?: string;
     /** Field name for screen readers; the current value is appended. */
     'aria-label'?: string;
+    /** date-fns Locale for the calendar and trigger text; wins over NexubProvider's `dateLocale`. */
+    locale?: Locale;
 }
 declare const DatePicker: React.ForwardRefExoticComponent<DatePickerProps & React.RefAttributes<HTMLButtonElement>>;
 
@@ -1289,6 +1703,8 @@ interface DateRangePickerProps {
     id?: string;
     /** Field name for screen readers; the current value is appended. */
     'aria-label'?: string;
+    /** date-fns Locale for the calendar and trigger text; wins over NexubProvider's `dateLocale`. */
+    locale?: Locale;
 }
 declare const DateRangePicker: React.ForwardRefExoticComponent<DateRangePickerProps & React.RefAttributes<HTMLButtonElement>>;
 
@@ -1324,7 +1740,7 @@ interface ThemeProviderProps {
     /** localStorage key for the glass intensity. Defaults to 'nexub-glass'. */
     glassStorageKey?: string;
 }
-declare function ThemeProvider({ children, defaultTheme, storageKey, defaultGlass, glassStorageKey, }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare function ThemeProvider({ children, defaultTheme, storageKey, defaultGlass, glassStorageKey, }: ThemeProviderProps): React.JSX.Element;
 declare function useTheme(): ThemeContextValue;
 interface ThemeScriptProps {
     /** Must match ThemeProvider's `storageKey`. Defaults to 'nexub-theme'. */
@@ -1340,7 +1756,7 @@ interface ThemeScriptProps {
  * Applies the stored theme before first paint, so there is no light/dark flash.
  * Render it in `<head>` (or at the top of `<body>`) on server-rendered pages.
  */
-declare function ThemeScript({ storageKey, productStorageKey, glassStorageKey, nonce }: ThemeScriptProps): react_jsx_runtime.JSX.Element;
+declare function ThemeScript({ storageKey, productStorageKey, glassStorageKey, nonce }: ThemeScriptProps): React.JSX.Element;
 
 type MotionDuration = 'instant' | 'fast' | 'normal' | 'slow' | 'slower';
 type MotionEasing = 'linear' | 'in' | 'out' | 'in-out' | 'out-expo' | 'spring';
@@ -1448,4 +1864,4 @@ interface CollapseProps extends Omit<MotionBaseProps, 'easing'>, React.HTMLAttri
  */
 declare const Collapse: React.ForwardRefExoticComponent<CollapseProps & React.RefAttributes<HTMLDivElement>>;
 
-export { Accordion, Alert, AlertDialog, type AlertProps, Amount, type AmountProps, AppShell, AspectRatio, type AspectRatioProps, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Badge, type BadgeProps, Banner, type BannerProps, Box, type BoxProps, Breadcrumb, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, Callout, type CalloutProps, Card, type CardProps, CheckList, CheckListItem, type CheckListItemProps, type CheckListProps, Checkbox, type CheckboxProps, Chip, type ChipProps, Code, type CodeProps, Collapse, type CollapseProps, Collapsible, Combobox, CommandPalette, type CommandPaletteRootProps, Container, type ContainerProps, ContextMenu, CountryBadge, type CountryBadgeProps, DataTable, type DataTableProps, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, Dialog, Drawer, type DrawerRootProps, DropdownMenu, EmptyState, ErrorState, type ErrorStateProps, EyebrowChip, type EyebrowChipProps, Fade, type FadeProps, FileUpload, type FileUploadRootProps, FilterChip, type FilterChipProps, Flag, type FlagProps, Flex, type FlexProps, FormError, type FormErrorProps, FormField, type FormFieldContextValue, type FormFieldRootProps, type GlassMode, GradientDivider, type GradientDividerProps, Grid, type GridProps, Heading, type HeadingProps, HelperText, type HelperTextProps, HoverCard, IconButton, type IconButtonProps, Input, type InputProps, Kbd, type KbdProps, KeyboardShortcut, type KeyboardShortcutProps, Label, type LabelProps, Link, type LinkProps, Logo, type LogoProps, Menubar, MoneyInput, type MoneyInputProps, type MotionBaseProps, type MotionDuration, type MotionEasing, NavigationMenu, NavigationRail, type NavigationRailItemProps, type NavigationRailRootProps, NumberInput, type NumberInputProps, PageHeader, type PageHeaderProps, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, Popover, Progress, type ProgressProps, RadioGroup, Rating, type RatingProps, Scale, type ScaleProps, ScrollArea, type ScrollAreaProps, SearchInput, type SearchInputProps, Section, type SectionProps, SegmentedControl, type SegmentedControlItemProps, type SegmentedControlProps, Select, Separator, type SeparatorProps, Sheet, Sidebar, type SidebarGroupProps, type SidebarHeaderProps, type SidebarItemProps, type SidebarRootProps, Skeleton, type SkeletonProps, Slide, type SlideDirection, type SlideProps, Slider, type SliderProps, Spinner, type SpinnerProps, SplitButton, type SplitButtonProps, Stack, type StackProps, StatusPill, type StatusPillProps, Switch, type SwitchProps, Table, Tabs, Tag, type TagProps, Text, TextGradient, type TextGradientProps, type TextProps, Textarea, type TextareaProps, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, ThemeScript, type ThemeScriptProps, Toast, type ToastItem, Toaster, Toggle, ToggleGroup, type ToggleProps, type ToneValue, Toolbar, type ToolbarRootProps, Tooltip, Provider as TooltipProvider, TopNav, type TopNavItemProps, type TopNavRootProps, addonVariants, alertVariants, avatarGroupVariants, avatarVariants, badgeVariants, bannerVariants, buttonVariants, calloutVariants, cardVariants, chipVariants, cn, containerVariants, headingVariants, iconButtonVariants, inputVariants, inputWrapperVariants, labelVariants, linkVariants, logoVariants, progressFillVariants, progressTrackVariants, ratingVariants, sectionVariants, separatorVariants, skeletonVariants, spinnerVariants, statusPillVariants, tagVariants, textVariants, textareaVariants, toast, toggleVariants, useControllableState, useDisclosure, useIsomorphicLayoutEffect, useMediaQuery, useMergedRefs, useTheme, useToastStore };
+export { Accordion, Alert, AlertDialog, type AlertProps, Amount, type AmountProps, AppShell, AspectRatio, type AspectRatioProps, Autocomplete, type AutocompleteOption, type AutocompleteProps, Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Badge, type BadgeProps, Banner, type BannerProps, Box, type BoxProps, Breadcrumb, Button, ButtonGroup, type ButtonGroupProps, type ButtonProps, type ButtonStatus, Callout, type CalloutProps, Card, CardLink, type CardLinkProps, type CardProps, CheckList, CheckListItem, type CheckListItemProps, type CheckListProps, Checkbox, CheckboxCard, type CheckboxCardProps, type CheckboxProps, Chip, type ChipProps, Citation, type CitationMessages, type CitationProps, type CitationSource, Code, type CodeProps, Collapse, type CollapseProps, Collapsible, Combobox, CommandPalette, type CommandPaletteRootProps, Container, type ContainerProps, ContextMenu, CountryBadge, type CountryBadgeProps, DataTable, type DataTableProps, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, Dialog, Drawer, type DrawerRootProps, DropdownMenu, EmptyState, ErrorState, type ErrorStateProps, EyebrowChip, type EyebrowChipProps, Fade, type FadeProps, type Feedback, FileUpload, type FileUploadRootProps, FilterChip, type FilterChipProps, Flag, type FlagProps, Flex, type FlexProps, FormError, type FormErrorProps, FormField, type FormFieldContextValue, type FormFieldRootProps, type GlassMode, GradientDivider, type GradientDividerProps, Grid, type GridProps, Heading, type HeadingProps, HelperText, type HelperTextProps, HoverCard, IconButton, type IconButtonProps, Input, type InputProps, Kbd, type KbdProps, KeyboardShortcut, type KeyboardShortcutProps, Label, type LabelProps, Link, type LinkProps, Logo, type LogoProps, MediaCard, type MediaCardProps, type MediaCardRatio, Menubar, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, type MessageFrom, type MessageStrings, MoneyInput, type MoneyInputProps, type MotionBaseProps, type MotionDuration, type MotionEasing, NavigationMenu, NavigationRail, type NavigationRailItemProps, type NavigationRailRootProps, type NexubMessages, NexubProvider, type NexubProviderProps, NumberInput, type NumberInputProps, NumberTicker, type NumberTickerPart, type NumberTickerProps, PageHeader, type PageHeaderProps, Pagination, type PaginationProps, PasswordInput, type PasswordInputProps, Popover, Progress, type ProgressProps, PromptInput, type PromptInputMessages, type PromptInputProps, type PromptInputStatus, RadioCard, RadioCardGroup, type RadioCardGroupProps, type RadioCardProps, RadioGroup, Rating, type RatingProps, Scale, type ScaleProps, ScrollArea, type ScrollAreaProps, SearchInput, type SearchInputProps, Section, type SectionProps, SegmentedControl, type SegmentedControlItemProps, type SegmentedControlProps, Select, Separator, type SeparatorProps, Sheet, Sidebar, type SidebarGroupProps, type SidebarHeaderProps, type SidebarItemProps, type SidebarRootProps, Skeleton, type SkeletonProps, Slide, type SlideDirection, type SlideProps, Slider, type SliderProps, SourceChip, type SourceChipProps, SourceList, type SourceListProps, Spinner, type SpinnerProps, SplitButton, type SplitButtonProps, Stack, type StackProps, StatusPill, type StatusPillProps, StreamingText, type StreamingTextProps, Switch, type SwitchProps, Table, Tabs, Tag, type TagProps, Text, type Direction as TextDirection, TextGradient, type TextGradientProps, type TextProps, Textarea, type TextareaProps, type ThemeContextValue, type ThemeMode, ThemeProvider, type ThemeProviderProps, ThemeScript, type ThemeScriptProps, ThinkingIndicator, type ThinkingIndicatorMessages, type ThinkingIndicatorProps, Toast, type ToastItem, Toaster, type ToasterProps, Toggle, ToggleGroup, type ToggleProps, type ToneValue, Toolbar, type ToolbarRootProps, Tooltip, Provider$1 as TooltipProvider, TopNav, type TopNavItemProps, type TopNavRootProps, type UndoableToastOptions, addonVariants, alertVariants, avatarGroupVariants, avatarVariants, badgeVariants, bannerVariants, buttonVariants, calloutVariants, cardVariants, chipVariants, cn, containerVariants, defaultMessageStrings, defaultMessages, headingVariants, iconButtonVariants, inputVariants, inputWrapperVariants, labelVariants, linkVariants, logoVariants, progressFillVariants, progressTrackVariants, ratingVariants, safeUrl, sectionVariants, separatorVariants, skeletonVariants, spinnerVariants, startViewTransition, statusPillVariants, tagVariants, textVariants, textareaVariants, toast, toggleVariants, useControllableState, useDisclosure, useIsomorphicLayoutEffect, useLocale, useMediaQuery, useMergedRefs, useNexubMessages, usePointerSheen, useTheme, useToastStore };