@doscientos/ui 0.1.28 → 0.1.30

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,56 @@ 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
 
585
+ declare const columnSize: {
586
+ readonly compact: "w-56";
587
+ readonly default: "w-72";
588
+ readonly wide: "w-80";
589
+ };
590
+ type KanbanColumnSize = keyof typeof columnSize;
591
+ /** Horizontally scrollable layout for independently managed Kanban columns. */
592
+ declare function KanbanViewport({ children, className, contentClassName, ...props }: React$1.ComponentProps<'div'> & {
593
+ contentClassName?: string;
594
+ }): React$1.JSX.Element;
595
+ /** Presentational column shell. Drag-and-drop behaviour remains owned by consumers. */
596
+ declare function KanbanColumn({ className, size, ...props }: React$1.ComponentProps<'section'> & {
597
+ size?: KanbanColumnSize;
598
+ }): React$1.JSX.Element;
599
+ declare function KanbanColumnHeader({ className, ...props }: React$1.ComponentProps<'header'>): React$1.JSX.Element;
600
+ declare function KanbanColumnTitle({ className, ...props }: React$1.ComponentProps<'span'>): React$1.JSX.Element;
601
+ declare function KanbanColumnBody({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
602
+ declare function KanbanEmpty({ className, compact, ...props }: React$1.ComponentProps<'p'> & {
603
+ compact?: boolean;
604
+ }): React$1.JSX.Element;
605
+
561
606
  /** 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;
607
+ declare function Kbd({ className, ...props }: React$1.ComponentProps<'kbd'>): React$1.JSX.Element;
608
+ declare function KbdGroup({ className, ...props }: React$1.ComponentProps<'span'>): React$1.JSX.Element;
564
609
 
565
610
  /** Busy overlay that keeps the loading state available to assistive technology. */
566
- declare function LoadingOverlay({ label, className, ...props }: React$1.ComponentProps<"div"> & {
611
+ declare function LoadingOverlay({ label, className, ...props }: React$1.ComponentProps<'output'> & {
567
612
  label?: string;
568
613
  }): React$1.JSX.Element;
569
614
 
@@ -573,7 +618,7 @@ declare function MenuContent({ className, ...props }: React.ComponentProps<typeo
573
618
  declare function Menu<T extends object>({ className, ...props }: MenuProps<T>): React$1.JSX.Element;
574
619
  declare function MenuItem<T extends object>({ className, children, ...props }: MenuItemProps<T>): React$1.JSX.Element;
575
620
 
576
- type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, "children"> & {
621
+ type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, 'children'> & {
577
622
  /** Short name of the metric. */
578
623
  label: React$1.ReactNode;
579
624
  /** Primary metric value. */
@@ -583,38 +628,15 @@ type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, "children"> & {
583
628
  /** Decorative or labelled visual accompanying the metric. */
584
629
  icon?: React$1.ReactNode;
585
630
  /** Semantic emphasis without coupling the card to a product status. */
586
- tone?: "default" | "success" | "warning" | "danger" | "info";
631
+ tone?: 'default' | 'success' | 'warning' | 'danger' | 'info';
587
632
  };
588
633
  /** Compact, accessible summary of a labelled metric. */
589
634
  declare function MetricCard({ className, label, value, description, icon, tone, ...props }: MetricCardProps): React$1.JSX.Element;
590
635
 
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
636
  type CompatibleRef<T> = ((instance: T | null) => unknown) | {
615
637
  readonly current: T | null;
616
638
  } | null;
617
- type OtpInputProps = Omit<InputProps$1, "children" | "className" | "defaultValue" | "maxLength" | "onChange" | "type" | "value"> & {
639
+ type OtpInputProps = Omit<InputProps$1, 'children' | 'className' | 'defaultValue' | 'maxLength' | 'onChange' | 'type' | 'value'> & {
618
640
  /** Number of numeric characters in the code. */
619
641
  length?: number;
620
642
  value?: string;
@@ -630,11 +652,11 @@ declare const OtpInputImpl: React$1.ForwardRefExoticComponent<Omit<OtpInputProps
630
652
  declare const OtpInput: (props: OtpInputProps) => ReturnType<typeof OtpInputImpl>;
631
653
 
632
654
  /** 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;
655
+ declare function PageHeader({ className, ...props }: React$1.ComponentProps<'header'>): React$1.JSX.Element;
656
+ declare function PageHeaderHeading({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
657
+ declare function PageHeaderTitle({ className, children, ...props }: React$1.ComponentProps<'h1'>): React$1.JSX.Element;
658
+ declare function PageHeaderDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
659
+ declare function PageHeaderActions({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
638
660
 
639
661
  type PaginationProps = {
640
662
  /** Currently selected page, starting at one. */
@@ -654,17 +676,30 @@ type PaginationProps = {
654
676
  /** Navigation control for a known number of result pages. */
655
677
  declare function Pagination({ page, pageCount, onPageChange, ariaLabel, summary, siblingCount, className, }: PaginationProps): React$1.JSX.Element | null;
656
678
 
657
- type PopoverProps = Omit<PopoverProps$1, "className"> & {
679
+ type PopoverContentProps = Omit<PopoverProps$1, 'className' | 'trigger'> & {
658
680
  className?: string;
659
681
  };
660
682
 
661
683
  /** Wrap a trigger and Popover surface; React Aria handles focus and positioning. */
662
684
  declare const PopoverTrigger: typeof DialogTrigger$1;
663
- declare function Popover({ className, ...props }: PopoverProps): React$1.JSX.Element;
664
685
  /** Floating content positioned and focus-managed by {@link PopoverTrigger}. */
665
- declare const PopoverContent: typeof Popover;
686
+ declare function PopoverContent({ className, ...props }: PopoverContentProps): React$1.JSX.Element;
687
+ type PopoverTriggerStateProps = Pick<DialogTriggerProps$1, 'defaultOpen' | 'isOpen' | 'onOpenChange'>;
688
+ type SimplePopoverProps = PopoverContentProps & PopoverTriggerStateProps & {
689
+ /** Text for a default button, or an interactive element that opens the popover. */
690
+ trigger: string | React$1.ReactElement;
691
+ /** Props for the default button rendered when {@link trigger} is text. */
692
+ triggerProps?: Omit<ButtonProps, 'children'>;
693
+ children: React$1.ReactNode;
694
+ };
695
+ type PopoverProps = PopoverContentProps | SimplePopoverProps;
696
+ /**
697
+ * A contextual surface with a simple trigger API.
698
+ * Omit {@link trigger} and use {@link PopoverTrigger} plus {@link PopoverContent} for advanced composition.
699
+ */
700
+ declare function Popover(props: PopoverProps): React$1.JSX.Element;
666
701
 
667
- type QuantityInputProps = Omit<NumberFieldProps, "children" | "className"> & {
702
+ type QuantityInputProps = Omit<NumberFieldProps, 'children' | 'className'> & {
668
703
  className?: string;
669
704
  inputClassName?: string;
670
705
  decrementAriaLabel?: string;
@@ -690,42 +725,62 @@ declare function SelectItem<T extends object>({ className, children, ...props }:
690
725
  declare function SheetTrigger({ ...props }: DialogTriggerProps$1): React$1.JSX.Element;
691
726
  declare function SheetClose({ className, variant, size, ...props }: ButtonProps): React$1.JSX.Element;
692
727
  /** 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"> & {
728
+ declare function Sheet({ className, children, side, showCloseButton, ...props }: Omit<ModalOverlayProps, 'className' | 'children'> & Pick<React$1.ComponentProps<typeof Modal>, 'isDismissable'> & {
694
729
  className?: string;
695
730
  children: React$1.ReactNode;
696
- side?: "top" | "right" | "bottom" | "left";
731
+ side?: 'top' | 'right' | 'bottom' | 'left';
697
732
  showCloseButton?: boolean;
698
733
  }): React$1.JSX.Element;
699
734
  declare function SheetContent({ className, children, side, showCloseButton, ...props }: React$1.ComponentProps<typeof Sheet> & {
700
- side?: "top" | "right" | "bottom" | "left";
735
+ side?: 'top' | 'right' | 'bottom' | 'left';
701
736
  showCloseButton?: boolean;
702
737
  }): 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;
738
+ /** Props for the simple {@link Drawer} API. */
739
+ type DrawerProps = React$1.ComponentProps<typeof SheetContent> & Pick<DialogTriggerProps$1, 'defaultOpen' | 'isOpen' | 'onOpenChange'> & {
740
+ /** Text for a default button, or an interactive element that opens the drawer. */
741
+ trigger: string | React$1.ReactElement;
742
+ /** Props for the default button rendered when {@link trigger} is text. */
743
+ triggerProps?: Omit<ButtonProps, 'children'>;
712
744
  };
713
- declare function useSidebar(): SidebarContextValue;
745
+ /**
746
+ * A dismissable modal panel with a simple trigger API.
747
+ * Use {@link DrawerTrigger} plus {@link DrawerContent} for advanced composition.
748
+ */
749
+ declare function Drawer({ children, trigger, triggerProps, defaultOpen, isOpen, onOpenChange, ...contentProps }: DrawerProps): React$1.JSX.Element;
750
+ declare function SheetHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
751
+ declare function SheetFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
752
+ declare function SheetTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, 'slot'>): React$1.JSX.Element;
753
+ declare function SheetDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, 'slot'>): React$1.JSX.Element;
754
+ /** Explicit advanced-composition name for {@link SheetTrigger}. */
755
+ declare const DrawerTrigger: typeof SheetTrigger;
756
+ /** Explicit advanced-composition name for {@link Sheet}. */
757
+ declare const DrawerContent: typeof SheetContent;
758
+ /** Explicit advanced-composition name for {@link SheetClose}. */
759
+ declare const DrawerClose: typeof SheetClose;
760
+ /** Explicit advanced-composition name for {@link SheetHeader}. */
761
+ declare const DrawerHeader: typeof SheetHeader;
762
+ /** Explicit advanced-composition name for {@link SheetFooter}. */
763
+ declare const DrawerFooter: typeof SheetFooter;
764
+ /** Explicit advanced-composition name for {@link SheetTitle}. */
765
+ declare const DrawerTitle: typeof SheetTitle;
766
+ /** Explicit advanced-composition name for {@link SheetDescription}. */
767
+ declare const DrawerDescription: typeof SheetDescription;
768
+
714
769
  /** Provides the expanded or collapsed state required by sidebar components. */
715
770
  declare function SidebarProvider({ defaultCollapsed, children, }: {
716
771
  defaultCollapsed?: boolean;
717
772
  children: ReactNode;
718
773
  }): React$1.JSX.Element;
719
774
  /** 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"> & {
775
+ declare function Sidebar({ className, ...props }: React.ComponentProps<'aside'>): React$1.JSX.Element;
776
+ declare function SidebarHeader({ className, ...props }: React.ComponentProps<'div'>): React$1.JSX.Element;
777
+ declare function SidebarSearch({ label, shortcut, className, ...props }: React.ComponentProps<'button'> & {
723
778
  label?: string;
724
779
  shortcut?: string;
725
780
  }): 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"> & {
781
+ declare function SidebarContent({ className, ...props }: React.ComponentProps<'nav'>): React$1.JSX.Element;
782
+ declare function SidebarFooter({ className, ...props }: React.ComponentProps<'div'>): React$1.JSX.Element;
783
+ declare function SidebarGroup({ label, className, children, ...props }: React.ComponentProps<'section'> & {
729
784
  label?: string;
730
785
  }): React$1.JSX.Element;
731
786
  type SidebarItemProps = LinkProps & {
@@ -735,23 +790,33 @@ type SidebarItemProps = LinkProps & {
735
790
  label?: string;
736
791
  };
737
792
  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;
793
+ declare function SidebarSeparator({ className, ...props }: React.ComponentProps<'hr'>): React$1.JSX.Element;
739
794
  declare function SidebarTrigger({ className, ...props }: ButtonProps): React$1.JSX.Element;
740
- declare function SidebarRail({ className, ...props }: React.ComponentProps<"button">): React$1.JSX.Element;
795
+ declare function SidebarRail({ className, ...props }: React.ComponentProps<'button'>): React$1.JSX.Element;
741
796
  declare function SidebarMore({ className, ...props }: ButtonProps): React$1.JSX.Element;
742
797
 
798
+ type SidebarContextValue = {
799
+ collapsed: boolean;
800
+ setCollapsed: (value: boolean) => void;
801
+ toggle: () => void;
802
+ };
803
+ declare const SidebarContext: React$1.Context<SidebarContextValue | null>;
804
+ declare function useSidebar(): SidebarContextValue;
805
+
743
806
  /** Decorative placeholder displayed while content is loading. */
744
- declare function Skeleton({ className, ...props }: React$1.ComponentProps<"div">): React$1.JSX.Element;
807
+ declare function Skeleton({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
745
808
 
746
- interface SubmitButtonProps extends Omit<ButtonProps, "type"> {
809
+ interface SubmitButtonProps extends Omit<ButtonProps, 'type'> {
747
810
  /** Text displayed while the parent form is submitting or loading is set. */
811
+ loadingLabel?: string;
812
+ /** @deprecated Use `loadingLabel` instead. */
748
813
  pendingLabel?: string;
749
814
  /** Explicit loading state in addition to the parent form status. */
750
815
  loading?: boolean;
751
- children: React.ReactNode;
816
+ children: React$1.ReactNode;
752
817
  }
753
818
  /** 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;
819
+ declare function SubmitButton({ loadingLabel, pendingLabel, loading, children, isDisabled, ref: forwardedRef, size, ...props }: SubmitButtonProps): React$1.JSX.Element;
755
820
 
756
821
  declare const switchSizes: {
757
822
  readonly sm: {
@@ -779,7 +844,7 @@ declare const switchSizes: {
779
844
  readonly activeSelectedOffset: "1rem";
780
845
  };
781
846
  };
782
- type SwitchProps = Omit<SwitchProps$1, "className"> & {
847
+ type SwitchProps = Omit<SwitchProps$1, 'className'> & {
783
848
  className?: string;
784
849
  size?: keyof typeof switchSizes;
785
850
  description?: ReactNode;
@@ -790,14 +855,14 @@ type SwitchProps = Omit<SwitchProps$1, "className"> & {
790
855
  declare function Switch({ className, children, description, icon, inputRef, isDisabled, isReadOnly, selectedIcon, size, ...props }: SwitchProps): React$1.JSX.Element;
791
856
 
792
857
  /** 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;
858
+ declare function Table({ className, ...props }: React$1.ComponentProps<'table'>): React$1.JSX.Element;
859
+ declare function TableHeader({ className, ...props }: React$1.ComponentProps<'thead'>): React$1.JSX.Element;
860
+ declare function TableBody({ className, ...props }: React$1.ComponentProps<'tbody'>): React$1.JSX.Element;
861
+ declare function TableRow({ className, ...props }: React$1.ComponentProps<'tr'>): React$1.JSX.Element;
862
+ declare function TableHead({ className, ...props }: React$1.ComponentProps<'th'>): React$1.JSX.Element;
863
+ declare function TableCell({ className, ...props }: React$1.ComponentProps<'td'>): React$1.JSX.Element;
864
+ declare function TableCaption({ className, ...props }: React$1.ComponentProps<'caption'>): React$1.JSX.Element;
865
+ declare function TableFooter({ className, ...props }: React$1.ComponentProps<'tfoot'>): React$1.JSX.Element;
801
866
 
802
867
  type TabsProps = TabsProps$1;
803
868
  type TabProps = TabProps$1;
@@ -813,8 +878,8 @@ declare function TabsPanels<T extends object>({ className, ...props }: TabPanels
813
878
  /** Content panel displayed for the selected {@link TabsTrigger}. */
814
879
  declare function TabsContent({ className, ...props }: TabPanelProps$1): React$1.JSX.Element;
815
880
 
816
- type ToastVariant = "default" | "success" | "error" | "warning" | "info";
817
- type ToastPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
881
+ type ToastVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
882
+ type ToastPosition = 'top-left' | 'top-center' | 'top-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
818
883
  type ToastAction = {
819
884
  label: string;
820
885
  onPress: () => void;
@@ -829,8 +894,24 @@ type ToastOptions = {
829
894
  };
830
895
  type ToastData = ToastOptions & {
831
896
  id: string;
832
- state: "open" | "closing";
897
+ state: 'open' | 'closing';
833
898
  };
899
+ declare function ToastProvider({ children }: {
900
+ children: ReactNode;
901
+ }): React$1.JSX.Element;
902
+ /** Viewport that renders notifications created with {@link toast}. */
903
+ declare function Toaster({ position }: {
904
+ position?: ToastPosition;
905
+ }): React$1.JSX.Element;
906
+ declare function ToastViewport({ position, visiblePosition, className, }: {
907
+ position: ToastPosition;
908
+ visiblePosition?: ToastPosition;
909
+ className?: string;
910
+ }): React$1.JSX.Element | null;
911
+ declare function Toast({ id, title, description, variant, action, state, duration, position, onDismiss, }: ToastData & {
912
+ onDismiss?: () => void;
913
+ }): null;
914
+
834
915
  type ToastPromiseOptions<T> = {
835
916
  loading: string;
836
917
  success: string | ((value: T) => string);
@@ -854,36 +935,36 @@ declare function useToast(): ((options: ToastOptions) => string) & {
854
935
  dismiss: (id: string) => void;
855
936
  promise: <T>(promise: Promise<T>, options: ToastPromiseOptions<T>) => Promise<T>;
856
937
  };
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
938
 
873
939
  /** 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;
940
+ declare function Toolbar({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
941
+ declare function ToolbarGroup({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
942
+ declare function ToolbarSpacer({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
877
943
 
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;
944
+ /** Couples a focusable trigger with its {@link TooltipContent} content. */
945
+ declare function TooltipTrigger({ delay, ...props }: React$1.ComponentProps<typeof TooltipTrigger$1>): React$1.JSX.Element;
946
+ type TooltipSurfaceProps = Omit<React$1.ComponentProps<typeof Tooltip$1>, 'children' | 'className'> & {
947
+ className?: string;
948
+ };
949
+ type TooltipProps = TooltipSurfaceProps & {
950
+ /** Contextual text or rich content shown when the trigger is focused or hovered. */
951
+ label: React$1.ReactNode;
952
+ /** The single focusable element that reveals the tooltip. */
953
+ children: React$1.ReactNode;
954
+ /** Delay before revealing the tooltip. */
955
+ delay?: React$1.ComponentProps<typeof TooltipTrigger$1>['delay'];
956
+ };
957
+ /**
958
+ * Brief contextual information for a focusable child.
959
+ * Do not use it as the child's only accessible label or as essential content.
960
+ */
961
+ declare function Tooltip({ label, children, delay, ...props }: TooltipProps): React$1.JSX.Element;
880
962
  /**
881
963
  * Brief contextual information revealed from a {@link TooltipTrigger}.
882
964
  * Do not use it as the only label or as essential content.
883
965
  */
884
- declare function Tooltip({ className, placement, offset, crossOffset, children, ...props }: Omit<React$1.ComponentProps<typeof Tooltip$1>, "children" | "className"> & {
885
- className?: string;
966
+ declare function TooltipContent({ className, placement, offset, crossOffset, children, ...props }: TooltipSurfaceProps & {
886
967
  children?: React$1.ReactNode;
887
968
  }): React$1.JSX.Element;
888
969
 
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 };
970
+ 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, KanbanColumn, KanbanColumnBody, KanbanColumnHeader, type KanbanColumnSize, KanbanColumnTitle, KanbanEmpty, KanbanViewport, 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 };