@doscientos/ui 0.1.27 → 0.1.29

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -3,11 +3,11 @@ import { RefCallback, ReactNode, ComponentPropsWithRef } from 'react';
3
3
  import * as class_variance_authority_types from 'class-variance-authority/types';
4
4
  import { ClassValue } from 'clsx';
5
5
  import * as react_aria_components from 'react-aria-components';
6
- import { DisclosureGroupProps, DisclosurePanelProps, DisclosureProps, ButtonProps as ButtonProps$1, LinkProps, Text, ModalOverlayProps, Heading, Breadcrumb as Breadcrumb$1, Link, Breadcrumbs as Breadcrumbs$1, Separator as Separator$1, CheckboxProps as CheckboxProps$1, ComboBoxProps, Key, Popover as Popover$1, InputProps as InputProps$1, ListBoxItemProps, ListBoxProps, Input as Input$1, ListBox, Dialog as Dialog$1, Menu as Menu$1, MenuSectionProps, MenuItemProps, Header, SubmenuTrigger, MenuTrigger as MenuTrigger$1, TextAreaProps, MenuProps, PopoverProps as PopoverProps$1, DialogTrigger as DialogTrigger$1, NumberFieldProps, SelectProps, SelectValue as SelectValue$1, Modal, DialogTriggerProps as DialogTriggerProps$1, SwitchProps as SwitchProps$1, TabPanelProps as TabPanelProps$1, TabProps as TabProps$1, TabsProps as TabsProps$1, TabListProps, TabPanelsProps, Tooltip as Tooltip$1, TooltipTrigger as TooltipTrigger$1 } from 'react-aria-components';
6
+ import { DisclosureGroupProps, DisclosurePanelProps, DisclosureProps, ButtonProps as ButtonProps$1, LinkProps, Text, Heading, Dialog as Dialog$1, ModalOverlayProps, Breadcrumb as Breadcrumb$1, Link, Breadcrumbs as Breadcrumbs$1, Separator as Separator$1, CheckboxProps as CheckboxProps$1, ComboBoxProps, Key, Popover as Popover$1, InputProps as InputProps$1, ListBoxItemProps, ListBoxProps, Input as Input$1, ListBox, Menu as Menu$1, MenuTrigger as MenuTrigger$1, MenuSectionProps, MenuItemProps, Header, SubmenuTrigger, TextAreaProps, MenuProps, PopoverProps as PopoverProps$1, DialogTriggerProps as DialogTriggerProps$1, DialogTrigger as DialogTrigger$1, NumberFieldProps, SelectProps, SelectValue as SelectValue$1, Modal, SwitchProps as SwitchProps$1, TabPanelProps as TabPanelProps$1, TabProps as TabProps$1, TabsProps as TabsProps$1, TabListProps, TabPanelsProps, Tooltip as Tooltip$1, TooltipTrigger as TooltipTrigger$1 } from 'react-aria-components';
7
7
  export { ComboBoxProps, ComboBoxValue as ComboboxValue, DialogTriggerProps as PopoverTriggerProps, SelectProps, DialogProps as SheetPrimitiveProps, DialogTriggerProps as SheetTriggerPrimitiveProps } from 'react-aria-components';
8
8
  import { VariantProps } from 'class-variance-authority';
9
9
 
10
- type AutosaveStatus = "idle" | "saving" | "saved" | "error";
10
+ type AutosaveStatus = 'idle' | 'saving' | 'saved' | 'error';
11
11
  type UseAutosaveOptions<T> = {
12
12
  data: T;
13
13
  onSave: (data: T) => Promise<void>;
@@ -58,7 +58,7 @@ declare function Accordion({ className, ...props }: DisclosureGroupProps): React
58
58
  /** A single expandable section within an {@link Accordion}. */
59
59
  declare function AccordionItem({ className, ...props }: DisclosureProps): React$1.JSX.Element;
60
60
  /** Accessible heading button that expands or collapses its {@link AccordionItem}. */
61
- declare function AccordionTrigger({ className, children, ...props }: Omit<ButtonProps$1, "children"> & {
61
+ declare function AccordionTrigger({ className, children, ...props }: Omit<ButtonProps$1, 'children'> & {
62
62
  children: React$1.ReactNode;
63
63
  }): React$1.JSX.Element;
64
64
  /** Panel revealed when its parent {@link AccordionItem} is expanded. */
@@ -68,14 +68,15 @@ declare const buttonVariants: (props?: ({
68
68
  variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | null | undefined;
69
69
  size?: "default" | "xs" | "sm" | "lg" | "icon" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
70
70
  } & class_variance_authority_types.ClassProp) | undefined) => string;
71
+
71
72
  /** Props for a button that triggers an in-page action. */
72
- type ButtonProps = Omit<ButtonProps$1, "className"> & React$1.RefAttributes<HTMLButtonElement> & VariantProps<typeof buttonVariants> & {
73
+ type ButtonProps = Omit<ButtonProps$1, 'className'> & React$1.RefAttributes<HTMLButtonElement> & VariantProps<typeof buttonVariants> & {
73
74
  /** HTML-compatible alias for `isDisabled`. */
74
75
  disabled?: boolean;
75
76
  /** Visual treatment for the action's priority and intent. */
76
- variant?: VariantProps<typeof buttonVariants>["variant"];
77
+ variant?: VariantProps<typeof buttonVariants>['variant'];
77
78
  /** Preset height, spacing and icon dimensions. */
78
- size?: VariantProps<typeof buttonVariants>["size"];
79
+ size?: VariantProps<typeof buttonVariants>['size'];
79
80
  className?: string;
80
81
  };
81
82
  /**
@@ -84,11 +85,11 @@ type ButtonProps = Omit<ButtonProps$1, "className"> & React$1.RefAttributes<HTML
84
85
  */
85
86
  declare function Button({ className, variant, size, children, disabled, isDisabled, onClick, onPress, ...props }: ButtonProps): React$1.JSX.Element;
86
87
  /** Props for a link styled consistently with {@link Button}. */
87
- type LinkButtonProps = Omit<LinkProps, "className"> & VariantProps<typeof buttonVariants> & {
88
+ type LinkButtonProps = Omit<LinkProps, 'className'> & VariantProps<typeof buttonVariants> & {
88
89
  /** Visual treatment for the navigation action's priority and intent. */
89
- variant?: VariantProps<typeof buttonVariants>["variant"];
90
+ variant?: VariantProps<typeof buttonVariants>['variant'];
90
91
  /** Preset height, spacing and icon dimensions. */
91
- size?: VariantProps<typeof buttonVariants>["size"];
92
+ size?: VariantProps<typeof buttonVariants>['size'];
92
93
  className?: string;
93
94
  };
94
95
  /**
@@ -97,6 +98,73 @@ type LinkButtonProps = Omit<LinkProps, "className"> & VariantProps<typeof button
97
98
  */
98
99
  declare function LinkButton({ className, variant, size, children, onClick, onPress, ...props }: LinkButtonProps): React$1.JSX.Element;
99
100
 
101
+ /** Props for a controlled or uncontrolled dialog state container. */
102
+ type DialogRootProps = {
103
+ children: React$1.ReactNode;
104
+ /** Initial state when the dialog is uncontrolled. */
105
+ defaultOpen?: boolean;
106
+ /** Called after the open state changes. */
107
+ onOpenChange?: (open: boolean) => void;
108
+ /** Controlled open state. Use with {@link onOpenChange}. */
109
+ open?: boolean;
110
+ };
111
+ /** Coordinates the trigger, overlay and content of a modal dialog. */
112
+ declare function DialogRoot({ children, defaultOpen, onOpenChange, open: controlledOpen, }: DialogRootProps): React$1.JSX.Element;
113
+ type DialogTriggerProps = Omit<React$1.ComponentProps<typeof Button>, 'onPress'> & {
114
+ /** Renders and augments the single child instead of rendering a {@link Button}. */
115
+ asChild?: boolean;
116
+ };
117
+ /** Opens the parent {@link Dialog} or {@link DialogRoot}. */
118
+ declare function DialogTrigger({ asChild, children, onClick, ...props }: DialogTriggerProps): React$1.JSX.Element;
119
+ /** Groups dialog content rendered in the overlay layer. */
120
+ declare function DialogPortal({ children }: {
121
+ children?: React$1.ReactNode;
122
+ }): React$1.JSX.Element;
123
+ type DialogOverlayProps = Omit<ModalOverlayProps, 'children' | 'className' | 'isOpen' | 'onOpenChange'> & {
124
+ children?: React$1.ReactNode;
125
+ className?: string;
126
+ };
127
+ /** Dismissable backdrop displayed while the parent {@link Dialog} is open. */
128
+ declare function DialogOverlay({ children, className, ...props }: DialogOverlayProps): React$1.JSX.Element | null;
129
+ type DialogContentProps = Omit<React$1.ComponentProps<typeof Dialog$1>, 'children' | 'className'> & {
130
+ children?: React$1.ReactNode;
131
+ className?: string;
132
+ contentSlot?: string;
133
+ onOverlayClick?: React$1.MouseEventHandler<HTMLDivElement>;
134
+ overlaySlot?: string;
135
+ showCloseButton?: boolean;
136
+ };
137
+ type SimpleDialogProps = DialogRootProps & Omit<DialogContentProps, 'children'> & {
138
+ /** Text for a default button, or an interactive element that opens the dialog. */
139
+ trigger: string | React$1.ReactElement;
140
+ /** Props for the default button rendered when {@link trigger} is text. */
141
+ triggerProps?: Omit<DialogTriggerProps, 'asChild' | 'children'>;
142
+ };
143
+ type DialogProps = DialogRootProps | SimpleDialogProps;
144
+ /**
145
+ * A modal dialog with a simple trigger API.
146
+ * Omit {@link trigger} and compose {@link DialogRoot}, {@link DialogTrigger} and {@link DialogContent} directly.
147
+ */
148
+ declare function Dialog(props: DialogProps): React$1.JSX.Element;
149
+ /** Focus-managed modal content. Include a {@link DialogTitle} to give it an accessible name. */
150
+ declare function DialogContent({ children, className, contentSlot, onOverlayClick, overlaySlot, showCloseButton, ...props }: DialogContentProps): React$1.JSX.Element;
151
+ type DialogCloseProps = Omit<React$1.ComponentProps<typeof Button>, 'onPress'> & {
152
+ /** Renders and augments the single child instead of rendering a {@link Button}. */
153
+ asChild?: boolean;
154
+ };
155
+ /** Closes the parent {@link Dialog}. */
156
+ declare function DialogClose({ asChild, children, onClick, ...props }: DialogCloseProps): React$1.JSX.Element;
157
+ /** Groups the title and description at the top of a dialog. */
158
+ declare function DialogHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
159
+ /** Groups dialog actions and can add a secondary close action. */
160
+ declare function DialogFooter({ className, showCloseButton, children, ...props }: React$1.ComponentProps<'div'> & {
161
+ showCloseButton?: boolean;
162
+ }): React$1.JSX.Element;
163
+ /** Title used to give the parent {@link DialogContent} an accessible name. */
164
+ declare function DialogTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, 'slot'>): React$1.JSX.Element;
165
+ /** Supporting text announced alongside the parent {@link DialogTitle}. */
166
+ declare function DialogDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, 'slot'>): React$1.JSX.Element;
167
+
100
168
  type AlertDialogProps = {
101
169
  children: React$1.ReactNode;
102
170
  open: boolean;
@@ -107,49 +175,50 @@ declare function AlertDialog({ children, open, onOpenChange }: AlertDialogProps)
107
175
  declare function AlertDialogPortal({ children }: {
108
176
  children?: React$1.ReactNode;
109
177
  }): React$1.JSX.Element;
110
- declare function AlertDialogTrigger({ children, ...props }: Omit<React$1.ComponentProps<typeof Button>, "onPress">): React$1.JSX.Element;
111
- declare function AlertDialogOverlay({ className, ...props }: Omit<ModalOverlayProps, "children" | "className" | "isOpen" | "onOpenChange"> & {
178
+ declare function AlertDialogTrigger({ children, ...props }: Omit<React$1.ComponentProps<typeof Button>, 'onPress'>): React$1.JSX.Element;
179
+ declare function AlertDialogOverlay({ className, ...props }: Omit<ModalOverlayProps, 'children' | 'className' | 'isOpen' | 'onOpenChange'> & {
112
180
  className?: string;
113
- }): React$1.JSX.Element | null;
114
- declare function AlertDialogContent({ className, size, children }: {
181
+ }): React$1.JSX.Element;
182
+ declare function AlertDialogContent({ className, size, children, }: {
115
183
  children?: React$1.ReactNode;
116
184
  className?: string;
117
- size?: "default" | "sm";
118
- }): React$1.JSX.Element | null;
119
- declare function AlertDialogHeader({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
120
- declare function AlertDialogFooter({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
121
- declare function AlertDialogTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, "slot">): React$1.JSX.Element;
122
- declare function AlertDialogDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, "slot">): React$1.JSX.Element;
185
+ size?: 'default' | 'sm';
186
+ }): React$1.JSX.Element;
187
+ declare function AlertDialogHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
188
+ declare function AlertDialogFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
189
+ declare function AlertDialogTitle({ className, ...props }: React$1.ComponentProps<typeof DialogTitle>): React$1.JSX.Element;
190
+ declare function AlertDialogDescription({ className, ...props }: React$1.ComponentProps<typeof DialogDescription>): React$1.JSX.Element;
123
191
  declare function AlertDialogAction({ className, ...props }: React$1.ComponentProps<typeof Button>): React$1.JSX.Element;
124
- declare function AlertDialogCancel({ children, onClick, ...props }: Omit<React$1.ComponentProps<typeof Button>, "onPress">): React$1.JSX.Element;
192
+ declare function AlertDialogCancel({ children, onClick, ...props }: Omit<React$1.ComponentProps<typeof Button>, 'onPress'>): React$1.JSX.Element;
125
193
 
126
194
  declare const alertVariants: (props?: ({
127
195
  variant?: "default" | "destructive" | "info" | "success" | "warning" | null | undefined;
128
196
  } & class_variance_authority_types.ClassProp) | undefined) => string;
129
- type AlertProps = React$1.ComponentProps<"div"> & VariantProps<typeof alertVariants> & {
197
+
198
+ type AlertProps = React$1.ComponentProps<'div'> & VariantProps<typeof alertVariants> & {
130
199
  /** Communicates the alert's semantic intent. */
131
- variant?: VariantProps<typeof alertVariants>["variant"];
200
+ variant?: VariantProps<typeof alertVariants>['variant'];
132
201
  };
133
202
  /** Announces a concise status, warning or error message. */
134
203
  declare function Alert({ className, variant, ...props }: AlertProps): React$1.JSX.Element;
135
- declare function AlertTitle({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
136
- declare function AlertDescription({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
137
- declare function AlertAction({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
204
+ declare function AlertTitle({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
205
+ declare function AlertDescription({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
206
+ declare function AlertAction({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
138
207
 
139
- type AppShellBreakpoint = "sm" | "md" | "lg";
140
- type AppShellProps = React$1.ComponentProps<"div"> & {
208
+ type AppShellBreakpoint = 'sm' | 'md' | 'lg';
209
+ type AppShellProps = React$1.ComponentProps<'div'> & {
141
210
  /** Breakpoint at which the persistent sidebar replaces the mobile header. */
142
211
  sidebarBreakpoint?: AppShellBreakpoint;
143
212
  };
144
213
  /** Application layout foundation for a responsive sidebar, header and content area. */
145
214
  declare function AppShell({ className, sidebarBreakpoint, ...props }: AppShellProps): React$1.JSX.Element;
146
- declare function AppShellSidebar({ className, ...props }: React$1.ComponentProps<"aside">): React$1.JSX.Element;
147
- declare function AppShellMain({ className, ...props }: React$1.ComponentProps<"main">): React$1.JSX.Element;
148
- declare function AppShellHeader({ className, ...props }: React$1.ComponentProps<"header">): React$1.JSX.Element;
149
- declare function AppShellMobileHeader({ className, ...props }: React$1.ComponentProps<"header">): React$1.JSX.Element;
150
- type AppShellContentProps = React$1.ComponentProps<"div"> & {
215
+ declare function AppShellSidebar({ className, ...props }: React$1.ComponentProps<'aside'>): React$1.JSX.Element;
216
+ declare function AppShellMain({ className, ...props }: React$1.ComponentProps<'main'>): React$1.JSX.Element;
217
+ declare function AppShellHeader({ className, ...props }: React$1.ComponentProps<'header'>): React$1.JSX.Element;
218
+ declare function AppShellMobileHeader({ className, ...props }: React$1.ComponentProps<'header'>): React$1.JSX.Element;
219
+ type AppShellContentProps = React$1.ComponentProps<'div'> & {
151
220
  /** Maximum content width. Use `full` for dense application screens. */
152
- size?: "default" | "wide" | "full";
221
+ size?: 'default' | 'wide' | 'full';
153
222
  /** Adds the standard responsive content padding. */
154
223
  padded?: boolean;
155
224
  /** Lets this region scroll while the surrounding shell remains fixed. */
@@ -157,28 +226,29 @@ type AppShellContentProps = React$1.ComponentProps<"div"> & {
157
226
  };
158
227
  declare function AppShellContent({ className, size, padded, scrollable, ...props }: AppShellContentProps): React$1.JSX.Element;
159
228
 
160
- type AvatarProps = React.ComponentProps<"div"> & {
229
+ type AvatarProps = React.ComponentProps<'div'> & {
161
230
  /** Avatar dimensions and fallback text size. */
162
- size?: "xs" | "sm" | "default" | "lg";
231
+ size?: 'xs' | 'sm' | 'default' | 'lg';
163
232
  };
164
233
  /** Displays an image or fallback content for a person, organisation or entity. */
165
234
  declare function Avatar({ className, size, children, ...props }: AvatarProps): React$1.JSX.Element;
166
- declare function AvatarImage({ className, src, onError, onLoad, ...props }: React.ComponentProps<"img">): React$1.JSX.Element | null;
167
- declare function AvatarFallback({ className, ...props }: React.ComponentProps<"span">): React$1.JSX.Element | null;
168
- declare function AvatarBadge({ className, ...props }: React.ComponentProps<"span">): React$1.JSX.Element;
169
- declare function AvatarGroup({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
170
- declare function AvatarGroupCount({ className, ...props }: React.ComponentProps<"span">): React$1.JSX.Element;
235
+ declare function AvatarImage({ className, src, onError, onLoad, ...props }: React.ComponentProps<'img'>): React$1.JSX.Element | null;
236
+ declare function AvatarFallback({ className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element | null;
237
+ declare function AvatarBadge({ className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element;
238
+ declare function AvatarGroup({ className, ...props }: React.ComponentProps<'div'>): React$1.JSX.Element;
239
+ declare function AvatarGroupCount({ className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element;
171
240
 
172
241
  declare const badgeVariants: (props?: ({
173
242
  variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | "info" | "success" | "warning" | "neutral" | "danger" | null | undefined;
174
243
  } & class_variance_authority_types.ClassProp) | undefined) => string;
175
- type BadgeProps = React$1.ComponentProps<"span"> & VariantProps<typeof badgeVariants> & {
244
+
245
+ type BadgeProps = React$1.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
176
246
  /** Visual intent for a compact status or category label. */
177
- variant?: VariantProps<typeof badgeVariants>["variant"];
247
+ variant?: VariantProps<typeof badgeVariants>['variant'];
178
248
  };
179
249
  /** Compact label for statuses, categories and small counts. */
180
250
  declare function Badge({ className, variant, ...props }: BadgeProps): React$1.JSX.Element;
181
- type BadgeLinkProps = Omit<LinkProps, "className"> & VariantProps<typeof badgeVariants> & {
251
+ type BadgeLinkProps = Omit<LinkProps, 'className'> & VariantProps<typeof badgeVariants> & {
182
252
  className?: string;
183
253
  };
184
254
  declare function BadgeLink({ className, variant, ...props }: BadgeLinkProps): React$1.JSX.Element;
@@ -187,8 +257,8 @@ declare function BadgeLink({ className, variant, ...props }: BadgeLinkProps): Re
187
257
  declare function Breadcrumbs({ className, ...props }: React.ComponentProps<typeof Breadcrumbs$1>): React$1.JSX.Element;
188
258
  declare function Breadcrumb({ className, ...props }: React.ComponentProps<typeof Breadcrumb$1>): React$1.JSX.Element;
189
259
  declare function BreadcrumbLink({ className, ...props }: React.ComponentProps<typeof Link>): React$1.JSX.Element;
190
- declare function BreadcrumbPage({ className, ...props }: React.ComponentProps<"span">): React$1.JSX.Element;
191
- declare function BreadcrumbSeparator({ children, className, ...props }: React.ComponentProps<"span">): React$1.JSX.Element;
260
+ declare function BreadcrumbPage({ className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element;
261
+ declare function BreadcrumbSeparator({ children, className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element;
192
262
 
193
263
  type SeparatorProps = React.ComponentProps<typeof Separator$1>;
194
264
  /** Semantic horizontal or vertical divider between related content. */
@@ -197,35 +267,36 @@ declare function Separator({ className, orientation, ...props }: SeparatorProps)
197
267
  declare const buttonGroupVariants: (props?: ({
198
268
  orientation?: "horizontal" | "vertical" | null | undefined;
199
269
  } & class_variance_authority_types.ClassProp) | undefined) => string;
270
+
200
271
  /** Groups adjacent actions into a single connected control. */
201
- declare function ButtonGroup({ className, orientation, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>): React$1.JSX.Element;
202
- declare function ButtonGroupText({ className, render, ...props }: React$1.ComponentProps<"div"> & {
272
+ declare function ButtonGroup({ className, orientation, ...props }: React$1.ComponentProps<'div'> & VariantProps<typeof buttonGroupVariants>): React$1.JSX.Element;
273
+ declare function ButtonGroupText({ className, render, ...props }: React$1.ComponentProps<'div'> & {
203
274
  render?: (props: React$1.HTMLAttributes<HTMLElement>) => React$1.ReactNode;
204
275
  }): string | number | bigint | boolean | React$1.JSX.Element | Iterable<React$1.ReactNode> | Promise<string | number | bigint | boolean | React$1.ReactPortal | React$1.ReactElement<unknown, string | React$1.JSXElementConstructor<any>> | Iterable<React$1.ReactNode> | null | undefined> | null | undefined;
205
276
  declare function ButtonGroupSeparator({ className, orientation, ...props }: React$1.ComponentProps<typeof Separator>): React$1.JSX.Element;
206
277
 
207
- type CardProps = React$1.ComponentProps<"div"> & {
278
+ type CardProps = React$1.ComponentProps<'div'> & {
208
279
  /** Spacing preset for standard or compact content. */
209
- size?: "default" | "sm";
280
+ size?: 'default' | 'sm';
210
281
  };
211
282
  /** Surface for related content with optional header, body, action and footer regions. */
212
283
  declare function Card({ className, size, ...props }: CardProps): React$1.JSX.Element;
213
- declare function CardHeader({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
214
- declare function CardTitle({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
215
- declare function CardDescription({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
216
- declare function CardAction({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
217
- declare function CardContent({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
218
- declare function CardFooter({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
284
+ declare function CardHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
285
+ declare function CardTitle({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
286
+ declare function CardDescription({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
287
+ declare function CardAction({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
288
+ declare function CardContent({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
289
+ declare function CardFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
219
290
 
220
291
  /** Props for an accessible boolean form control. */
221
- type CheckboxProps = Omit<CheckboxProps$1, "className"> & {
292
+ type CheckboxProps = Omit<CheckboxProps$1, 'className'> & {
222
293
  className?: string;
223
294
  };
224
295
  /** Checkbox that supports controlled and uncontrolled selection. */
225
296
  declare function Checkbox({ className, children, ...props }: CheckboxProps): React$1.JSX.Element;
226
297
 
227
298
  /** Props for the collapsible state container. */
228
- type CollapsibleProps = React$1.ComponentProps<"div"> & {
299
+ type CollapsibleProps = React$1.ComponentProps<'div'> & {
229
300
  /** Initial state when the component is uncontrolled. */
230
301
  defaultOpen?: boolean;
231
302
  /** Called after the expanded state changes. */
@@ -236,13 +307,13 @@ type CollapsibleProps = React$1.ComponentProps<"div"> & {
236
307
  /** Groups a trigger and conditional content in a controlled or uncontrolled disclosure. */
237
308
  declare function Collapsible({ children, defaultOpen, onOpenChange, open: controlledOpen, ...props }: CollapsibleProps): React$1.JSX.Element;
238
309
  /** Props for the control that toggles a {@link Collapsible}. */
239
- type CollapsibleTriggerProps = React$1.ComponentProps<"button"> & {
310
+ type CollapsibleTriggerProps = React$1.ComponentProps<'button'> & {
240
311
  /** Renders and augments the single child element instead of a native button. */
241
312
  asChild?: boolean;
242
313
  };
243
314
  /** Button that toggles its parent {@link Collapsible} and exposes `aria-expanded`. */
244
315
  declare function CollapsibleTrigger({ asChild, children, onClick, ...props }: CollapsibleTriggerProps): React$1.JSX.Element;
245
- type CollapsibleContentProps = React$1.ComponentProps<"div">;
316
+ type CollapsibleContentProps = React$1.ComponentProps<'div'>;
246
317
  /** Content that is mounted only while its parent {@link Collapsible} is open. */
247
318
  declare function CollapsibleContent({ children, ...props }: CollapsibleContentProps): React$1.JSX.Element | null;
248
319
 
@@ -254,12 +325,12 @@ declare function ComboboxList<T extends object>({ className, emptyState, ...prop
254
325
  emptyState?: React.ReactNode;
255
326
  }): React$1.JSX.Element;
256
327
  declare function ComboboxItem<T extends object>({ className, children, ...props }: ListBoxItemProps<T>): React$1.JSX.Element;
257
- declare function HighlightMatch({ text, query, className }: {
328
+ declare function HighlightMatch({ text, query, className, }: {
258
329
  text: string;
259
330
  query: string;
260
331
  className?: string;
261
332
  }): React$1.JSX.Element;
262
- type AutocompleteComboboxProps<T extends object> = Omit<ComboBoxProps<T>, "children" | "items" | "inputValue" | "onInputChange" | "selectedKey" | "onSelectionChange" | "defaultFilter"> & {
333
+ type AutocompleteComboboxProps<T extends object> = Omit<ComboBoxProps<T>, 'children' | 'items' | 'inputValue' | 'onInputChange' | 'selectedKey' | 'onSelectionChange' | 'defaultFilter'> & {
263
334
  items: readonly T[];
264
335
  getItemKey: (item: T) => Key;
265
336
  getItemLabel: (item: T) => string;
@@ -309,59 +380,6 @@ type DangerZoneProps = {
309
380
  /** Collapsed-by-default container for actions that are hard to reverse. */
310
381
  declare function DangerZone({ title, description, defaultOpen, className, children, }: DangerZoneProps): React$1.JSX.Element;
311
382
 
312
- /** Props for a controlled or uncontrolled dialog state container. */
313
- type DialogProps = {
314
- children: React$1.ReactNode;
315
- /** Initial state when the dialog is uncontrolled. */
316
- defaultOpen?: boolean;
317
- /** Called after the open state changes. */
318
- onOpenChange?: (open: boolean) => void;
319
- /** Controlled open state. Use with {@link onOpenChange}. */
320
- open?: boolean;
321
- };
322
- /** Coordinates the trigger, overlay and content of a modal dialog. */
323
- declare function Dialog({ children, defaultOpen, onOpenChange, open: controlledOpen }: DialogProps): React$1.JSX.Element;
324
- type DialogTriggerProps = Omit<React$1.ComponentProps<typeof Button>, "onPress"> & {
325
- /** Renders and augments the single child instead of rendering a {@link Button}. */
326
- asChild?: boolean;
327
- };
328
- /** Opens the parent {@link Dialog}. */
329
- declare function DialogTrigger({ asChild, children, onClick, ...props }: DialogTriggerProps): React$1.JSX.Element;
330
- /** Groups dialog content rendered in the overlay layer. */
331
- declare function DialogPortal({ children }: {
332
- children?: React$1.ReactNode;
333
- }): React$1.JSX.Element;
334
- type DialogOverlayProps = Omit<ModalOverlayProps, "children" | "className" | "isOpen" | "onOpenChange"> & {
335
- children?: React$1.ReactNode;
336
- className?: string;
337
- };
338
- /** Dismissable backdrop displayed while the parent {@link Dialog} is open. */
339
- declare function DialogOverlay({ children, className, ...props }: DialogOverlayProps): React$1.JSX.Element | null;
340
- type DialogContentProps = Omit<React$1.ComponentProps<typeof Dialog$1>, "children" | "className"> & {
341
- children?: React$1.ReactNode;
342
- className?: string;
343
- onOverlayClick?: React$1.MouseEventHandler<HTMLDivElement>;
344
- showCloseButton?: boolean;
345
- };
346
- /** Focus-managed modal content. Include a {@link DialogTitle} to give it an accessible name. */
347
- declare function DialogContent({ children, className, onOverlayClick, showCloseButton, ...props }: DialogContentProps): React$1.JSX.Element;
348
- type DialogCloseProps = Omit<React$1.ComponentProps<typeof Button>, "onPress"> & {
349
- /** Renders and augments the single child instead of rendering a {@link Button}. */
350
- asChild?: boolean;
351
- };
352
- /** Closes the parent {@link Dialog}. */
353
- declare function DialogClose({ asChild, children, onClick, ...props }: DialogCloseProps): React$1.JSX.Element;
354
- /** Groups the title and description at the top of a dialog. */
355
- declare function DialogHeader({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
356
- /** Groups dialog actions and can add a secondary close action. */
357
- declare function DialogFooter({ className, showCloseButton, children, ...props }: React$1.ComponentProps<"div"> & {
358
- showCloseButton?: boolean;
359
- }): React$1.JSX.Element;
360
- /** Title used to give the parent {@link DialogContent} an accessible name. */
361
- declare function DialogTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, "slot">): React$1.JSX.Element;
362
- /** Supporting text announced alongside the parent {@link DialogTitle}. */
363
- declare function DialogDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, "slot">): React$1.JSX.Element;
364
-
365
383
  type DocPreviewProps = {
366
384
  /** Signed storage URL, generated by the consuming application. */
367
385
  mimeType: string | null;
@@ -370,27 +388,29 @@ type DocPreviewProps = {
370
388
  };
371
389
  declare function DocPreview({ url, mimeType, name }: DocPreviewProps): React$1.JSX.Element;
372
390
 
373
- interface DrawerProps extends Omit<ModalOverlayProps, "children" | "className"> {
374
- children: React.ReactNode;
375
- /** Screen edge from which the drawer enters. */
376
- side?: "left" | "right" | "bottom";
377
- className?: string;
378
- }
379
- /** Dismissable modal panel anchored to an edge of the viewport. */
380
- declare function Drawer({ children, side, className, ...props }: DrawerProps): React$1.JSX.Element;
381
- declare function DrawerHeader({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
382
- declare function DrawerFooter({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
383
- declare function DrawerTitle({ className, ...props }: Omit<React.ComponentProps<typeof Heading>, "slot">): React$1.JSX.Element;
384
- declare function DrawerDescription({ className, ...props }: React.ComponentProps<"p">): React$1.JSX.Element;
385
-
386
391
  declare function DropdownMenuTrigger({ ...props }: React$1.ComponentProps<typeof MenuTrigger$1>): React$1.JSX.Element;
387
- /** Floating menu of actions or selections opened by a {@link DropdownMenuTrigger}. */
388
- declare function DropdownMenu({ "data-slot": dataSlot, placement, offset, crossOffset, className, children, ...props }: Omit<React$1.ComponentProps<typeof Menu$1<object>>, "children" | "className"> & Pick<React$1.ComponentProps<typeof Popover$1>, "placement" | "offset" | "crossOffset"> & {
389
- "data-slot"?: string;
392
+ type DropdownMenuContentProps = Omit<React$1.ComponentProps<typeof Menu$1<object>>, 'children' | 'className'> & Pick<React$1.ComponentProps<typeof Popover$1>, 'placement' | 'offset' | 'crossOffset'> & {
393
+ 'data-slot'?: string;
390
394
  className?: string;
391
395
  children?: React$1.ReactNode;
392
- }): React$1.JSX.Element;
393
- declare function DropdownMenuGroup({ ...props }: Omit<MenuSectionProps<object>, "children"> & {
396
+ };
397
+ /** Floating menu of actions or selections opened by a {@link DropdownMenuTrigger}. */
398
+ declare function DropdownMenuContent({ 'data-slot': dataSlot, placement, offset, crossOffset, className, children, ...props }: DropdownMenuContentProps): React$1.JSX.Element;
399
+ type DropdownMenuTriggerStateProps = Pick<React$1.ComponentProps<typeof MenuTrigger$1>, 'defaultOpen' | 'isOpen' | 'onOpenChange'>;
400
+ type SimpleDropdownMenuProps = DropdownMenuContentProps & DropdownMenuTriggerStateProps & {
401
+ /** Text for a default button, or an interactive element that opens the menu. */
402
+ trigger: string | React$1.ReactElement;
403
+ /** Props for the default button rendered when {@link trigger} is text. */
404
+ triggerProps?: Omit<ButtonProps, 'children'>;
405
+ children: React$1.ReactNode;
406
+ };
407
+ type DropdownMenuProps = DropdownMenuContentProps | SimpleDropdownMenuProps;
408
+ /**
409
+ * An action menu with a simple trigger API.
410
+ * Omit {@link trigger} and use {@link DropdownMenuTrigger} plus {@link DropdownMenuContent} for advanced composition.
411
+ */
412
+ declare function DropdownMenu(props: DropdownMenuProps): React$1.JSX.Element;
413
+ declare function DropdownMenuGroup({ ...props }: Omit<MenuSectionProps<object>, 'children'> & {
394
414
  children?: React$1.ReactNode;
395
415
  }): React$1.JSX.Element;
396
416
  declare function DropdownMenuLabel({ className, inset, ...props }: React$1.ComponentProps<typeof Header> & {
@@ -398,61 +418,63 @@ declare function DropdownMenuLabel({ className, inset, ...props }: React$1.Compo
398
418
  }): React$1.JSX.Element;
399
419
  declare function DropdownMenuItem({ className, inset, variant, children, ...props }: MenuItemProps<object> & {
400
420
  inset?: boolean;
401
- variant?: "default" | "destructive";
421
+ variant?: 'default' | 'destructive';
402
422
  }): React$1.JSX.Element;
403
423
  declare function DropdownMenuSub({ ...props }: React$1.ComponentProps<typeof SubmenuTrigger>): React$1.JSX.Element;
404
424
  declare function DropdownMenuSubTrigger({ className, inset, children, ...props }: MenuItemProps<object> & {
405
425
  inset?: boolean;
406
426
  }): React$1.JSX.Element;
407
- declare function DropdownMenuSubContent({ placement, crossOffset, offset, className, ...props }: React$1.ComponentProps<typeof DropdownMenu>): React$1.JSX.Element;
427
+ declare function DropdownMenuSubContent({ placement, crossOffset, offset, className, ...props }: React$1.ComponentProps<typeof DropdownMenuContent>): React$1.JSX.Element;
408
428
  declare function DropdownMenuSeparator({ className, ...props }: React$1.ComponentProps<typeof Separator$1>): React$1.JSX.Element;
409
- declare function DropdownMenuShortcut({ className, ...props }: React$1.ComponentProps<"span">): React$1.JSX.Element;
429
+ declare function DropdownMenuShortcut({ className, ...props }: React$1.ComponentProps<'span'>): React$1.JSX.Element;
410
430
 
411
- /** Composes an informative empty result with optional media and a recovery action. */
412
- declare function EmptyState({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
413
- declare function EmptyStateHeader({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
414
431
  declare const emptyStateMediaVariants: (props?: ({
415
432
  variant?: "default" | "icon" | null | undefined;
416
433
  } & class_variance_authority_types.ClassProp) | undefined) => string;
417
- declare function EmptyStateMedia({ className, variant, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof emptyStateMediaVariants>): React$1.JSX.Element;
418
- declare function EmptyStateTitle({ className, ...props }: React$1.ComponentProps<"h3">): React$1.JSX.Element;
419
- declare function EmptyStateDescription({ className, ...props }: React$1.ComponentProps<"p">): React$1.JSX.Element;
420
- declare function EmptyStateContent({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
434
+
435
+ /** Composes an informative empty result with optional media and a recovery action. */
436
+ declare function EmptyState({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
437
+ declare function EmptyStateHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
438
+ declare function EmptyStateMedia({ className, variant, ...props }: React$1.ComponentProps<'div'> & VariantProps<typeof emptyStateMediaVariants>): React$1.JSX.Element;
439
+ declare function EmptyStateTitle({ className, children, ...props }: React$1.ComponentProps<'h3'>): React$1.JSX.Element;
440
+ declare function EmptyStateDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
441
+ declare function EmptyStateContent({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
421
442
 
422
443
  /** Accessible label associated with a React Aria form control. */
423
444
  declare const Label: React$1.ForwardRefExoticComponent<Omit<react_aria_components.LabelProps & React$1.RefAttributes<HTMLLabelElement>, "ref"> & React$1.RefAttributes<HTMLLabelElement>>;
424
445
  type LabelProps = ComponentPropsWithRef<typeof Label>;
425
446
 
447
+ declare const fieldVariants: (props?: ({
448
+ orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
449
+ } & class_variance_authority_types.ClassProp) | undefined) => string;
450
+
426
451
  /** Semantic fieldset for controls that share a {@link FieldLegend}. */
427
- declare function FieldSet({ className, ...props }: React$1.ComponentProps<"fieldset">): React$1.JSX.Element;
452
+ declare function FieldSet({ className, ...props }: React$1.ComponentProps<'fieldset'>): React$1.JSX.Element;
428
453
  /** Label for a {@link FieldSet}, with heading or label styling. */
429
- declare function FieldLegend({ className, variant, ...props }: React$1.ComponentProps<"legend"> & {
430
- variant?: "legend" | "label";
454
+ declare function FieldLegend({ className, variant, ...props }: React$1.ComponentProps<'legend'> & {
455
+ variant?: 'legend' | 'label';
431
456
  }): React$1.JSX.Element;
432
457
  /** Responsive vertical stack for related {@link Field} components. */
433
- declare function FieldGroup({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
434
- declare const fieldVariants: (props?: ({
435
- orientation?: "horizontal" | "vertical" | "responsive" | null | undefined;
436
- } & class_variance_authority_types.ClassProp) | undefined) => string;
458
+ declare function FieldGroup({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
437
459
  /** Props for the layout wrapper of a labelled form control. */
438
- type FieldProps = React$1.ComponentProps<"div"> & VariantProps<typeof fieldVariants> & {
460
+ type FieldProps = React$1.ComponentProps<'div'> & VariantProps<typeof fieldVariants> & {
439
461
  /** Layout of the label and control; `responsive` changes at the field-group container breakpoint. */
440
- orientation?: VariantProps<typeof fieldVariants>["orientation"];
462
+ orientation?: VariantProps<typeof fieldVariants>['orientation'];
441
463
  };
442
464
  /** Groups a form control, its label and descriptive or error text. */
443
465
  declare function Field({ className, orientation, ...props }: FieldProps): React$1.JSX.Element;
444
466
  /** Stacks the label, description and validation message for a {@link Field}. */
445
- declare function FieldContent({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
467
+ declare function FieldContent({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
446
468
  /** Label associated with the control inside a {@link Field}. */
447
469
  declare function FieldLabel({ className, ...props }: React$1.ComponentProps<typeof Label>): React$1.JSX.Element;
448
470
  /** Short visible title for a {@link Field} that is not a native label. */
449
- declare function FieldTitle({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
471
+ declare function FieldTitle({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
450
472
  /** Helper text that clarifies how to complete a {@link Field}. */
451
- declare function FieldDescription({ className, ...props }: React$1.ComponentProps<"p">): React$1.JSX.Element;
473
+ declare function FieldDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
452
474
  /** Visual divider between groups of fields, optionally with a text label. */
453
- declare function FieldSeparator({ className, children, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
475
+ declare function FieldSeparator({ className, children, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
454
476
  /** Props for a validation message rendered by {@link FieldError}. */
455
- type FieldErrorProps = React$1.ComponentProps<"div"> & {
477
+ type FieldErrorProps = React$1.ComponentProps<'div'> & {
456
478
  /** Validation errors whose unique messages are rendered when no children are supplied. */
457
479
  errors?: Array<{
458
480
  message?: string;
@@ -462,26 +484,16 @@ type FieldErrorProps = React$1.ComponentProps<"div"> & {
462
484
  declare function FieldError({ className, children, errors, ...props }: FieldErrorProps): React$1.JSX.Element | null;
463
485
 
464
486
  type FormFeedbackState = {
465
- status: "idle";
487
+ status: 'idle';
466
488
  } | {
467
- status: "pending";
489
+ status: 'pending';
468
490
  } | {
469
- status: "success";
491
+ status: 'success';
470
492
  message?: string;
471
493
  } | {
472
- status: "error";
494
+ status: 'error';
473
495
  message: string;
474
496
  };
475
- declare function useFormFeedback(options?: {
476
- successResetMs?: number;
477
- }): {
478
- state: FormFeedbackState;
479
- pending: boolean;
480
- setPending: () => void;
481
- setSuccess: (message?: string) => void;
482
- setError: (message: string) => void;
483
- reset: () => void;
484
- };
485
497
  interface FormFeedbackProps {
486
498
  /** Current submission state and optional user-facing result message. */
487
499
  state: FormFeedbackState;
@@ -492,7 +504,18 @@ interface FormFeedbackProps {
492
504
  successLabel?: string;
493
505
  }
494
506
  /** Live status message for pending, successful and failed form submissions. */
495
- declare function FormFeedback({ state, className, pendingLabel, successLabel }: FormFeedbackProps): React$1.JSX.Element;
507
+ declare function FormFeedback({ state, className, pendingLabel, successLabel, }: FormFeedbackProps): React$1.JSX.Element;
508
+
509
+ declare function useFormFeedback(options?: {
510
+ successResetMs?: number;
511
+ }): {
512
+ state: FormFeedbackState;
513
+ pending: boolean;
514
+ setPending: () => void;
515
+ setSuccess: (message?: string) => void;
516
+ setError: (message: string) => void;
517
+ reset: () => void;
518
+ };
496
519
 
497
520
  interface FormRowProps {
498
521
  /** Visible label associated with the form control. */
@@ -509,9 +532,9 @@ interface FormRowProps {
509
532
  children: ReactNode;
510
533
  }
511
534
  /** Labelled form-control row with optional help text and validation feedback. */
512
- declare function FormRow({ label, htmlFor, required, hint, error, className, children }: FormRowProps): React$1.JSX.Element;
535
+ declare function FormRow({ label, htmlFor, required, hint, error, className, children, }: FormRowProps): React$1.JSX.Element;
513
536
 
514
- type IconButtonProps = Omit<ButtonProps, "children"> & {
537
+ type IconButtonProps = Omit<ButtonProps, 'children'> & {
515
538
  /** Accessible name and text shown in the tooltip. */
516
539
  label: string;
517
540
  /** Optional href for rendering the action as an accessible link. */
@@ -525,7 +548,7 @@ type CompatibleRef$2<T> = ((instance: T | null) => unknown) | {
525
548
  readonly current: T | null;
526
549
  } | null;
527
550
  /** Props for a single-line text input. */
528
- type InputProps = Omit<InputProps$1, "ref"> & {
551
+ type InputProps = Omit<InputProps$1, 'ref'> & {
529
552
  /** Ref compatible with all supported React 19 type releases. */
530
553
  ref?: CompatibleRef$2<HTMLInputElement>;
531
554
  };
@@ -536,34 +559,35 @@ declare const Input: (props: InputProps) => ReturnType<typeof InputImpl>;
536
559
  type CompatibleRef$1<T> = ((instance: T | null) => unknown) | {
537
560
  readonly current: T | null;
538
561
  } | null;
539
- type TextareaProps = Omit<TextAreaProps, "ref"> & {
562
+ type TextareaProps = Omit<TextAreaProps, 'ref'> & {
540
563
  ref?: CompatibleRef$1<HTMLTextAreaElement>;
541
564
  };
542
565
  declare const TextareaImpl: React$1.ForwardRefExoticComponent<TextAreaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
543
566
  /** Forward-ref component with a ref type compatible across React 19 type releases. */
544
567
  declare const Textarea: (props: TextareaProps) => ReturnType<typeof TextareaImpl>;
545
568
 
546
- /** Visually joins an input or textarea with contextual text and actions. */
547
- declare function InputGroup({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
548
569
  declare const inputGroupAddonVariants: (props?: ({
549
570
  align?: "inline-end" | "inline-start" | "block-end" | "block-start" | null | undefined;
550
571
  } & class_variance_authority_types.ClassProp) | undefined) => string;
551
- declare function InputGroupAddon({ className, align, onClick, ...props }: React.ComponentProps<"div"> & VariantProps<typeof inputGroupAddonVariants>): React$1.JSX.Element;
572
+
573
+ /** Visually joins an input or textarea with contextual text and actions. */
574
+ declare function InputGroup({ className, ...props }: React.ComponentProps<'div'>): React$1.JSX.Element;
575
+ declare function InputGroupAddon({ className, align, onClick, ...props }: React.ComponentProps<'div'> & VariantProps<typeof inputGroupAddonVariants>): React$1.JSX.Element;
552
576
  declare const inputGroupButtonVariants: (props?: ({
553
577
  size?: "xs" | "sm" | "icon-xs" | "icon-sm" | null | undefined;
554
578
  } & class_variance_authority_types.ClassProp) | undefined) => string;
555
- type InputGroupButtonProps = Omit<ButtonProps, "size"> & VariantProps<typeof inputGroupButtonVariants>;
579
+ type InputGroupButtonProps = Omit<ButtonProps, 'size'> & VariantProps<typeof inputGroupButtonVariants>;
556
580
  declare function InputGroupButton({ className, type, variant, size, ...props }: InputGroupButtonProps): React$1.JSX.Element;
557
- declare function InputGroupText({ className, ...props }: React.ComponentProps<"span">): React$1.JSX.Element;
581
+ declare function InputGroupText({ className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element;
558
582
  declare function InputGroupInput({ className, ...props }: React.ComponentProps<typeof Input>): React$1.JSX.Element;
559
583
  declare function InputGroupTextarea({ className, ...props }: React.ComponentProps<typeof Textarea>): React$1.JSX.Element;
560
584
 
561
585
  /** Formats a keyboard key or shortcut with semantic `kbd` markup. */
562
- declare function Kbd({ className, ...props }: React$1.ComponentProps<"kbd">): React$1.JSX.Element;
563
- declare function KbdGroup({ className, ...props }: React$1.ComponentProps<"span">): React$1.JSX.Element;
586
+ declare function Kbd({ className, ...props }: React$1.ComponentProps<'kbd'>): React$1.JSX.Element;
587
+ declare function KbdGroup({ className, ...props }: React$1.ComponentProps<'span'>): React$1.JSX.Element;
564
588
 
565
589
  /** Busy overlay that keeps the loading state available to assistive technology. */
566
- declare function LoadingOverlay({ label, className, ...props }: React$1.ComponentProps<"div"> & {
590
+ declare function LoadingOverlay({ label, className, ...props }: React$1.ComponentProps<'output'> & {
567
591
  label?: string;
568
592
  }): React$1.JSX.Element;
569
593
 
@@ -573,7 +597,7 @@ declare function MenuContent({ className, ...props }: React.ComponentProps<typeo
573
597
  declare function Menu<T extends object>({ className, ...props }: MenuProps<T>): React$1.JSX.Element;
574
598
  declare function MenuItem<T extends object>({ className, children, ...props }: MenuItemProps<T>): React$1.JSX.Element;
575
599
 
576
- type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, "children"> & {
600
+ type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, 'children'> & {
577
601
  /** Short name of the metric. */
578
602
  label: React$1.ReactNode;
579
603
  /** Primary metric value. */
@@ -583,38 +607,15 @@ type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, "children"> & {
583
607
  /** Decorative or labelled visual accompanying the metric. */
584
608
  icon?: React$1.ReactNode;
585
609
  /** Semantic emphasis without coupling the card to a product status. */
586
- tone?: "default" | "success" | "warning" | "danger" | "info";
610
+ tone?: 'default' | 'success' | 'warning' | 'danger' | 'info';
587
611
  };
588
612
  /** Compact, accessible summary of a labelled metric. */
589
613
  declare function MetricCard({ className, label, value, description, icon, tone, ...props }: MetricCardProps): React$1.JSX.Element;
590
614
 
591
- declare const sizeClasses: {
592
- readonly sm: "w-[min(calc(100dvw-2rem),24rem)]";
593
- readonly md: "w-[min(calc(100dvw-2rem),28rem)]";
594
- readonly lg: "w-[min(calc(100dvw-2rem),36rem)]";
595
- };
596
- type ModalDialogProps = Omit<ModalOverlayProps, "children" | "className" | "isOpen" | "onOpenChange"> & {
597
- open: boolean;
598
- onOpenChange: (open: boolean) => void;
599
- title: React$1.ReactNode;
600
- description?: React$1.ReactNode;
601
- children?: React$1.ReactNode;
602
- footer?: React$1.ReactNode;
603
- size?: keyof typeof sizeClasses;
604
- showCloseButton?: boolean;
605
- className?: string;
606
- footerClassName?: string;
607
- };
608
- /**
609
- * Accessible modal with a consistent title, optional description, body and footer.
610
- * Its width is self-contained so consumer CSS cannot override it with max-width utilities.
611
- */
612
- declare function ModalDialog({ open, onOpenChange, title, description, children, footer, size, showCloseButton, className, footerClassName, ...props }: ModalDialogProps): React$1.JSX.Element;
613
-
614
615
  type CompatibleRef<T> = ((instance: T | null) => unknown) | {
615
616
  readonly current: T | null;
616
617
  } | null;
617
- type OtpInputProps = Omit<InputProps$1, "children" | "className" | "defaultValue" | "maxLength" | "onChange" | "type" | "value"> & {
618
+ type OtpInputProps = Omit<InputProps$1, 'children' | 'className' | 'defaultValue' | 'maxLength' | 'onChange' | 'type' | 'value'> & {
618
619
  /** Number of numeric characters in the code. */
619
620
  length?: number;
620
621
  value?: string;
@@ -630,11 +631,11 @@ declare const OtpInputImpl: React$1.ForwardRefExoticComponent<Omit<OtpInputProps
630
631
  declare const OtpInput: (props: OtpInputProps) => ReturnType<typeof OtpInputImpl>;
631
632
 
632
633
  /** Page-level heading layout with optional description and actions. */
633
- declare function PageHeader({ className, ...props }: React$1.ComponentProps<"header">): React$1.JSX.Element;
634
- declare function PageHeaderHeading({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
635
- declare function PageHeaderTitle({ className, ...props }: React$1.ComponentProps<"h1">): React$1.JSX.Element;
636
- declare function PageHeaderDescription({ className, ...props }: React$1.ComponentProps<"p">): React$1.JSX.Element;
637
- declare function PageHeaderActions({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
634
+ declare function PageHeader({ className, ...props }: React$1.ComponentProps<'header'>): React$1.JSX.Element;
635
+ declare function PageHeaderHeading({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
636
+ declare function PageHeaderTitle({ className, children, ...props }: React$1.ComponentProps<'h1'>): React$1.JSX.Element;
637
+ declare function PageHeaderDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
638
+ declare function PageHeaderActions({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
638
639
 
639
640
  type PaginationProps = {
640
641
  /** Currently selected page, starting at one. */
@@ -654,17 +655,30 @@ type PaginationProps = {
654
655
  /** Navigation control for a known number of result pages. */
655
656
  declare function Pagination({ page, pageCount, onPageChange, ariaLabel, summary, siblingCount, className, }: PaginationProps): React$1.JSX.Element | null;
656
657
 
657
- type PopoverProps = Omit<PopoverProps$1, "className"> & {
658
+ type PopoverContentProps = Omit<PopoverProps$1, 'className' | 'trigger'> & {
658
659
  className?: string;
659
660
  };
660
661
 
661
662
  /** Wrap a trigger and Popover surface; React Aria handles focus and positioning. */
662
663
  declare const PopoverTrigger: typeof DialogTrigger$1;
663
- declare function Popover({ className, ...props }: PopoverProps): React$1.JSX.Element;
664
664
  /** Floating content positioned and focus-managed by {@link PopoverTrigger}. */
665
- declare const PopoverContent: typeof Popover;
665
+ declare function PopoverContent({ className, ...props }: PopoverContentProps): React$1.JSX.Element;
666
+ type PopoverTriggerStateProps = Pick<DialogTriggerProps$1, 'defaultOpen' | 'isOpen' | 'onOpenChange'>;
667
+ type SimplePopoverProps = PopoverContentProps & PopoverTriggerStateProps & {
668
+ /** Text for a default button, or an interactive element that opens the popover. */
669
+ trigger: string | React$1.ReactElement;
670
+ /** Props for the default button rendered when {@link trigger} is text. */
671
+ triggerProps?: Omit<ButtonProps, 'children'>;
672
+ children: React$1.ReactNode;
673
+ };
674
+ type PopoverProps = PopoverContentProps | SimplePopoverProps;
675
+ /**
676
+ * A contextual surface with a simple trigger API.
677
+ * Omit {@link trigger} and use {@link PopoverTrigger} plus {@link PopoverContent} for advanced composition.
678
+ */
679
+ declare function Popover(props: PopoverProps): React$1.JSX.Element;
666
680
 
667
- type QuantityInputProps = Omit<NumberFieldProps, "children" | "className"> & {
681
+ type QuantityInputProps = Omit<NumberFieldProps, 'children' | 'className'> & {
668
682
  className?: string;
669
683
  inputClassName?: string;
670
684
  decrementAriaLabel?: string;
@@ -690,42 +704,62 @@ declare function SelectItem<T extends object>({ className, children, ...props }:
690
704
  declare function SheetTrigger({ ...props }: DialogTriggerProps$1): React$1.JSX.Element;
691
705
  declare function SheetClose({ className, variant, size, ...props }: ButtonProps): React$1.JSX.Element;
692
706
  /** Dismissable modal panel that slides in from a screen edge. */
693
- declare function Sheet({ className, children, side, showCloseButton, ...props }: Omit<ModalOverlayProps, "className" | "children"> & Pick<React$1.ComponentProps<typeof Modal>, "isDismissable"> & {
707
+ declare function Sheet({ className, children, side, showCloseButton, ...props }: Omit<ModalOverlayProps, 'className' | 'children'> & Pick<React$1.ComponentProps<typeof Modal>, 'isDismissable'> & {
694
708
  className?: string;
695
709
  children: React$1.ReactNode;
696
- side?: "top" | "right" | "bottom" | "left";
710
+ side?: 'top' | 'right' | 'bottom' | 'left';
697
711
  showCloseButton?: boolean;
698
712
  }): React$1.JSX.Element;
699
713
  declare function SheetContent({ className, children, side, showCloseButton, ...props }: React$1.ComponentProps<typeof Sheet> & {
700
- side?: "top" | "right" | "bottom" | "left";
714
+ side?: 'top' | 'right' | 'bottom' | 'left';
701
715
  showCloseButton?: boolean;
702
716
  }): React$1.JSX.Element;
703
- declare function SheetHeader({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
704
- declare function SheetFooter({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
705
- declare function SheetTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, "slot">): React$1.JSX.Element;
706
- declare function SheetDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, "slot">): React$1.JSX.Element;
707
-
708
- type SidebarContextValue = {
709
- collapsed: boolean;
710
- setCollapsed: (value: boolean) => void;
711
- toggle: () => void;
717
+ /** Props for the simple {@link Drawer} API. */
718
+ type DrawerProps = React$1.ComponentProps<typeof SheetContent> & Pick<DialogTriggerProps$1, 'defaultOpen' | 'isOpen' | 'onOpenChange'> & {
719
+ /** Text for a default button, or an interactive element that opens the drawer. */
720
+ trigger: string | React$1.ReactElement;
721
+ /** Props for the default button rendered when {@link trigger} is text. */
722
+ triggerProps?: Omit<ButtonProps, 'children'>;
712
723
  };
713
- declare function useSidebar(): SidebarContextValue;
724
+ /**
725
+ * A dismissable modal panel with a simple trigger API.
726
+ * Use {@link DrawerTrigger} plus {@link DrawerContent} for advanced composition.
727
+ */
728
+ declare function Drawer({ children, trigger, triggerProps, defaultOpen, isOpen, onOpenChange, ...contentProps }: DrawerProps): React$1.JSX.Element;
729
+ declare function SheetHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
730
+ declare function SheetFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
731
+ declare function SheetTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, 'slot'>): React$1.JSX.Element;
732
+ declare function SheetDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, 'slot'>): React$1.JSX.Element;
733
+ /** Explicit advanced-composition name for {@link SheetTrigger}. */
734
+ declare const DrawerTrigger: typeof SheetTrigger;
735
+ /** Explicit advanced-composition name for {@link Sheet}. */
736
+ declare const DrawerContent: typeof SheetContent;
737
+ /** Explicit advanced-composition name for {@link SheetClose}. */
738
+ declare const DrawerClose: typeof SheetClose;
739
+ /** Explicit advanced-composition name for {@link SheetHeader}. */
740
+ declare const DrawerHeader: typeof SheetHeader;
741
+ /** Explicit advanced-composition name for {@link SheetFooter}. */
742
+ declare const DrawerFooter: typeof SheetFooter;
743
+ /** Explicit advanced-composition name for {@link SheetTitle}. */
744
+ declare const DrawerTitle: typeof SheetTitle;
745
+ /** Explicit advanced-composition name for {@link SheetDescription}. */
746
+ declare const DrawerDescription: typeof SheetDescription;
747
+
714
748
  /** Provides the expanded or collapsed state required by sidebar components. */
715
749
  declare function SidebarProvider({ defaultCollapsed, children, }: {
716
750
  defaultCollapsed?: boolean;
717
751
  children: ReactNode;
718
752
  }): React$1.JSX.Element;
719
753
  /** Primary application navigation; render it within a {@link SidebarProvider}. */
720
- declare function Sidebar({ className, ...props }: React.ComponentProps<"aside">): React$1.JSX.Element;
721
- declare function SidebarHeader({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
722
- declare function SidebarSearch({ label, shortcut, className, ...props }: React.ComponentProps<"button"> & {
754
+ declare function Sidebar({ className, ...props }: React.ComponentProps<'aside'>): React$1.JSX.Element;
755
+ declare function SidebarHeader({ className, ...props }: React.ComponentProps<'div'>): React$1.JSX.Element;
756
+ declare function SidebarSearch({ label, shortcut, className, ...props }: React.ComponentProps<'button'> & {
723
757
  label?: string;
724
758
  shortcut?: string;
725
759
  }): React$1.JSX.Element;
726
- declare function SidebarContent({ className, ...props }: React.ComponentProps<"nav">): React$1.JSX.Element;
727
- declare function SidebarFooter({ className, ...props }: React.ComponentProps<"div">): React$1.JSX.Element;
728
- declare function SidebarGroup({ label, className, children, ...props }: React.ComponentProps<"section"> & {
760
+ declare function SidebarContent({ className, ...props }: React.ComponentProps<'nav'>): React$1.JSX.Element;
761
+ declare function SidebarFooter({ className, ...props }: React.ComponentProps<'div'>): React$1.JSX.Element;
762
+ declare function SidebarGroup({ label, className, children, ...props }: React.ComponentProps<'section'> & {
729
763
  label?: string;
730
764
  }): React$1.JSX.Element;
731
765
  type SidebarItemProps = LinkProps & {
@@ -735,23 +769,33 @@ type SidebarItemProps = LinkProps & {
735
769
  label?: string;
736
770
  };
737
771
  declare function SidebarItem({ icon, active, badge, label, children, className, ...props }: SidebarItemProps): React$1.JSX.Element;
738
- declare function SidebarSeparator({ className, ...props }: React.ComponentProps<"hr">): React$1.JSX.Element;
772
+ declare function SidebarSeparator({ className, ...props }: React.ComponentProps<'hr'>): React$1.JSX.Element;
739
773
  declare function SidebarTrigger({ className, ...props }: ButtonProps): React$1.JSX.Element;
740
- declare function SidebarRail({ className, ...props }: React.ComponentProps<"button">): React$1.JSX.Element;
774
+ declare function SidebarRail({ className, ...props }: React.ComponentProps<'button'>): React$1.JSX.Element;
741
775
  declare function SidebarMore({ className, ...props }: ButtonProps): React$1.JSX.Element;
742
776
 
777
+ type SidebarContextValue = {
778
+ collapsed: boolean;
779
+ setCollapsed: (value: boolean) => void;
780
+ toggle: () => void;
781
+ };
782
+ declare const SidebarContext: React$1.Context<SidebarContextValue | null>;
783
+ declare function useSidebar(): SidebarContextValue;
784
+
743
785
  /** Decorative placeholder displayed while content is loading. */
744
- declare function Skeleton({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
786
+ declare function Skeleton({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
745
787
 
746
- interface SubmitButtonProps extends Omit<ButtonProps, "type"> {
788
+ interface SubmitButtonProps extends Omit<ButtonProps, 'type'> {
747
789
  /** Text displayed while the parent form is submitting or loading is set. */
790
+ loadingLabel?: string;
791
+ /** @deprecated Use `loadingLabel` instead. */
748
792
  pendingLabel?: string;
749
793
  /** Explicit loading state in addition to the parent form status. */
750
794
  loading?: boolean;
751
- children: React.ReactNode;
795
+ children: React$1.ReactNode;
752
796
  }
753
797
  /** Submit button that disables itself and announces progress while a form is pending. */
754
- declare function SubmitButton({ pendingLabel, loading, children, isDisabled, size, ...props }: SubmitButtonProps): React$1.JSX.Element;
798
+ declare function SubmitButton({ loadingLabel, pendingLabel, loading, children, isDisabled, ref: forwardedRef, size, ...props }: SubmitButtonProps): React$1.JSX.Element;
755
799
 
756
800
  declare const switchSizes: {
757
801
  readonly sm: {
@@ -779,7 +823,7 @@ declare const switchSizes: {
779
823
  readonly activeSelectedOffset: "1rem";
780
824
  };
781
825
  };
782
- type SwitchProps = Omit<SwitchProps$1, "className"> & {
826
+ type SwitchProps = Omit<SwitchProps$1, 'className'> & {
783
827
  className?: string;
784
828
  size?: keyof typeof switchSizes;
785
829
  description?: ReactNode;
@@ -790,14 +834,14 @@ type SwitchProps = Omit<SwitchProps$1, "className"> & {
790
834
  declare function Switch({ className, children, description, icon, inputRef, isDisabled, isReadOnly, selectedIcon, size, ...props }: SwitchProps): React$1.JSX.Element;
791
835
 
792
836
  /** Presentational table primitives. Sorting, pagination and data state stay in the application. */
793
- declare function Table({ className, ...props }: React$1.ComponentProps<"table">): React$1.JSX.Element;
794
- declare function TableHeader({ className, ...props }: React$1.ComponentProps<"thead">): React$1.JSX.Element;
795
- declare function TableBody({ className, ...props }: React$1.ComponentProps<"tbody">): React$1.JSX.Element;
796
- declare function TableRow({ className, ...props }: React$1.ComponentProps<"tr">): React$1.JSX.Element;
797
- declare function TableHead({ className, ...props }: React$1.ComponentProps<"th">): React$1.JSX.Element;
798
- declare function TableCell({ className, ...props }: React$1.ComponentProps<"td">): React$1.JSX.Element;
799
- declare function TableCaption({ className, ...props }: React$1.ComponentProps<"caption">): React$1.JSX.Element;
800
- declare function TableFooter({ className, ...props }: React$1.ComponentProps<"tfoot">): React$1.JSX.Element;
837
+ declare function Table({ className, ...props }: React$1.ComponentProps<'table'>): React$1.JSX.Element;
838
+ declare function TableHeader({ className, ...props }: React$1.ComponentProps<'thead'>): React$1.JSX.Element;
839
+ declare function TableBody({ className, ...props }: React$1.ComponentProps<'tbody'>): React$1.JSX.Element;
840
+ declare function TableRow({ className, ...props }: React$1.ComponentProps<'tr'>): React$1.JSX.Element;
841
+ declare function TableHead({ className, ...props }: React$1.ComponentProps<'th'>): React$1.JSX.Element;
842
+ declare function TableCell({ className, ...props }: React$1.ComponentProps<'td'>): React$1.JSX.Element;
843
+ declare function TableCaption({ className, ...props }: React$1.ComponentProps<'caption'>): React$1.JSX.Element;
844
+ declare function TableFooter({ className, ...props }: React$1.ComponentProps<'tfoot'>): React$1.JSX.Element;
801
845
 
802
846
  type TabsProps = TabsProps$1;
803
847
  type TabProps = TabProps$1;
@@ -813,8 +857,8 @@ declare function TabsPanels<T extends object>({ className, ...props }: TabPanels
813
857
  /** Content panel displayed for the selected {@link TabsTrigger}. */
814
858
  declare function TabsContent({ className, ...props }: TabPanelProps$1): React$1.JSX.Element;
815
859
 
816
- type ToastVariant = "default" | "success" | "error" | "warning" | "info";
817
- type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
860
+ type ToastVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
861
+ type ToastPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
818
862
  type ToastAction = {
819
863
  label: string;
820
864
  onPress: () => void;
@@ -829,8 +873,24 @@ type ToastOptions = {
829
873
  };
830
874
  type ToastData = ToastOptions & {
831
875
  id: string;
832
- state: "open" | "closing";
876
+ state: 'open' | 'closing';
833
877
  };
878
+ declare function ToastProvider({ children }: {
879
+ children: ReactNode;
880
+ }): React$1.JSX.Element;
881
+ /** Viewport that renders notifications created with {@link toast}. */
882
+ declare function Toaster({ position }: {
883
+ position?: ToastPosition;
884
+ }): React$1.JSX.Element;
885
+ declare function ToastViewport({ position, visiblePosition, className, }: {
886
+ position: ToastPosition;
887
+ visiblePosition?: ToastPosition;
888
+ className?: string;
889
+ }): React$1.JSX.Element | null;
890
+ declare function Toast({ id, title, description, variant, action, state, duration, position, onDismiss, }: ToastData & {
891
+ onDismiss?: () => void;
892
+ }): null;
893
+
834
894
  type ToastPromiseOptions<T> = {
835
895
  loading: string;
836
896
  success: string | ((value: T) => string);
@@ -854,36 +914,36 @@ declare function useToast(): ((options: ToastOptions) => string) & {
854
914
  dismiss: (id: string) => void;
855
915
  promise: <T>(promise: Promise<T>, options: ToastPromiseOptions<T>) => Promise<T>;
856
916
  };
857
- declare function ToastProvider({ children }: {
858
- children: ReactNode;
859
- }): React$1.JSX.Element;
860
- /** Viewport that renders notifications created with {@link toast}. */
861
- declare function Toaster({ position }: {
862
- position?: ToastPosition;
863
- }): React$1.JSX.Element;
864
- declare function ToastViewport({ position, visiblePosition, className }: {
865
- position: ToastPosition;
866
- visiblePosition?: ToastPosition;
867
- className?: string;
868
- }): React$1.JSX.Element | null;
869
- declare function Toast({ id, title, description, variant, action, state, duration, position, onDismiss }: ToastData & {
870
- onDismiss?: () => void;
871
- }): null;
872
917
 
873
918
  /** Groups related actions with the toolbar semantic role. */
874
- declare function Toolbar({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
875
- declare function ToolbarGroup({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
876
- declare function ToolbarSpacer({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
919
+ declare function Toolbar({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
920
+ declare function ToolbarGroup({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
921
+ declare function ToolbarSpacer({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
877
922
 
878
- /** Couples a focusable trigger with its {@link Tooltip} content. */
879
- declare function TooltipTrigger({ delay, children, ...props }: React$1.ComponentProps<typeof TooltipTrigger$1>): React$1.JSX.Element;
923
+ /** Couples a focusable trigger with its {@link TooltipContent} content. */
924
+ declare function TooltipTrigger({ delay, ...props }: React$1.ComponentProps<typeof TooltipTrigger$1>): React$1.JSX.Element;
925
+ type TooltipSurfaceProps = Omit<React$1.ComponentProps<typeof Tooltip$1>, 'children' | 'className'> & {
926
+ className?: string;
927
+ };
928
+ type TooltipProps = TooltipSurfaceProps & {
929
+ /** Contextual text or rich content shown when the trigger is focused or hovered. */
930
+ label: React$1.ReactNode;
931
+ /** The single focusable element that reveals the tooltip. */
932
+ children: React$1.ReactNode;
933
+ /** Delay before revealing the tooltip. */
934
+ delay?: React$1.ComponentProps<typeof TooltipTrigger$1>['delay'];
935
+ };
936
+ /**
937
+ * Brief contextual information for a focusable child.
938
+ * Do not use it as the child's only accessible label or as essential content.
939
+ */
940
+ declare function Tooltip({ label, children, delay, ...props }: TooltipProps): React$1.JSX.Element;
880
941
  /**
881
942
  * Brief contextual information revealed from a {@link TooltipTrigger}.
882
943
  * Do not use it as the only label or as essential content.
883
944
  */
884
- declare function Tooltip({ className, placement, offset, crossOffset, children, ...props }: Omit<React$1.ComponentProps<typeof Tooltip$1>, "children" | "className"> & {
885
- className?: string;
945
+ declare function TooltipContent({ className, placement, offset, crossOffset, children, ...props }: TooltipSurfaceProps & {
886
946
  children?: React$1.ReactNode;
887
947
  }): React$1.JSX.Element;
888
948
 
889
- export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogProps, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppShell, type AppShellBreakpoint, AppShellContent, type AppShellContentProps, AppShellHeader, AppShellMain, AppShellMobileHeader, type AppShellProps, AppShellSidebar, AutocompleteCombobox, type AutocompleteComboboxProps, type AutosaveStatus, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, type AvatarProps, Badge, BadgeLink, type BadgeLinkProps, type BadgeProps, Breadcrumb, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, Breadcrumbs, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, Collapsible, CollapsibleContent, type CollapsibleContentProps, type CollapsibleProps, CollapsibleTrigger, type CollapsibleTriggerProps, Combobox, ComboboxContent, ComboboxInput, ComboboxItem, ComboboxList, Command, CommandContent, CommandInput, CommandItem, CommandList, ConfirmDialog, type ConfirmDialogProps, DangerZone, type DangerZoneProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DocPreview, type DocPreviewProps, Drawer, DrawerDescription, DrawerFooter, DrawerHeader, type DrawerProps, DrawerTitle, DropdownMenu, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle, Field, FieldContent, FieldDescription, FieldError, type FieldErrorProps, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FormFeedback, type FormFeedbackProps, type FormFeedbackState, FormRow, type FormRowProps, HighlightMatch, IconButton, type IconButtonProps, Input, InputGroup, InputGroupAddon, InputGroupButton, type InputGroupButtonProps, InputGroupInput, InputGroupText, InputGroupTextarea, type InputProps, Kbd, KbdGroup, Label, type LabelProps, LinkButton, type LinkButtonProps, LoadingOverlay, Menu, MenuContent, MenuItem, MenuTrigger, MetricCard, type MetricCardProps, ModalDialog, type ModalDialogProps, OtpInput, type OtpInputProps, PageHeader, PageHeaderActions, PageHeaderDescription, PageHeaderHeading, PageHeaderTitle, Pagination, type PaginationProps, Popover, PopoverContent, type PopoverProps, PopoverTrigger, QuantityInput, type QuantityInputProps, Select, SelectContent, SelectItem, SelectList, SelectTrigger, SelectValue, Separator, type SeparatorProps, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarHeader, SidebarItem, type SidebarItemProps, SidebarMore, SidebarProvider, SidebarRail, SidebarSearch, SidebarSeparator, SidebarTrigger, Skeleton, SubmitButton, type SubmitButtonProps, Switch, type SwitchProps, type TabPanelProps, type TabProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsPanels, type TabsProps, TabsTrigger, type TextMatchPart, Textarea, type TextareaProps, Toast, type ToastAction, type ToastData, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, ToastViewport, Toaster, Toolbar, ToolbarGroup, ToolbarSpacer, Tooltip, TooltipTrigger, type UseAutosaveOptions, type UseFormDirtyResult, actionRipple, alertVariants, badgeVariants, buttonGroupVariants, buttonVariants, cn, emptyStateMediaVariants, fieldVariants, formSnapshot, getTextMatchParts, inputGroupAddonVariants, toast, useAutosave, useDebouncedValue, useFormDirty, useFormFeedback, useSidebar, useToast };
949
+ export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogProps, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppShell, type AppShellBreakpoint, AppShellContent, type AppShellContentProps, AppShellHeader, AppShellMain, AppShellMobileHeader, type AppShellProps, AppShellSidebar, AutocompleteCombobox, type AutocompleteComboboxProps, type AutosaveStatus, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, type AvatarProps, Badge, BadgeLink, type BadgeLinkProps, type BadgeProps, Breadcrumb, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, Breadcrumbs, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, Collapsible, CollapsibleContent, type CollapsibleContentProps, type CollapsibleProps, CollapsibleTrigger, type CollapsibleTriggerProps, Combobox, ComboboxContent, ComboboxInput, ComboboxItem, ComboboxList, Command, CommandContent, CommandInput, CommandItem, CommandList, ConfirmDialog, type ConfirmDialogProps, DangerZone, type DangerZoneProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogProps, DialogRoot, type DialogRootProps, DialogTitle, DialogTrigger, type DialogTriggerProps, DocPreview, type DocPreviewProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, type DrawerProps, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, type DropdownMenuProps, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle, Field, FieldContent, FieldDescription, FieldError, type FieldErrorProps, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FormFeedback, type FormFeedbackProps, type FormFeedbackState, FormRow, type FormRowProps, HighlightMatch, IconButton, type IconButtonProps, Input, InputGroup, InputGroupAddon, InputGroupButton, type InputGroupButtonProps, InputGroupInput, InputGroupText, InputGroupTextarea, type InputProps, Kbd, KbdGroup, Label, type LabelProps, LinkButton, type LinkButtonProps, LoadingOverlay, Menu, MenuContent, MenuItem, MenuTrigger, MetricCard, type MetricCardProps, OtpInput, type OtpInputProps, PageHeader, PageHeaderActions, PageHeaderDescription, PageHeaderHeading, PageHeaderTitle, Pagination, type PaginationProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, QuantityInput, type QuantityInputProps, Select, SelectContent, SelectItem, SelectList, SelectTrigger, SelectValue, Separator, type SeparatorProps, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarContext, type SidebarContextValue, SidebarFooter, SidebarGroup, SidebarHeader, SidebarItem, type SidebarItemProps, SidebarMore, SidebarProvider, SidebarRail, SidebarSearch, SidebarSeparator, SidebarTrigger, Skeleton, SubmitButton, type SubmitButtonProps, Switch, type SwitchProps, type TabPanelProps, type TabProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsPanels, type TabsProps, TabsTrigger, type TextMatchPart, Textarea, type TextareaProps, Toast, type ToastAction, type ToastData, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, ToastViewport, Toaster, Toolbar, ToolbarGroup, ToolbarSpacer, Tooltip, TooltipContent, type TooltipProps, TooltipTrigger, type UseAutosaveOptions, type UseFormDirtyResult, actionRipple, alertVariants, badgeVariants, buttonGroupVariants, buttonVariants, cn, emptyStateMediaVariants, fieldVariants, formSnapshot, getTextMatchParts, inputGroupAddonVariants, toast, useAutosave, useDebouncedValue, useFormDirty, useFormFeedback, useSidebar, useToast };