hazo_ui 2.9.0 → 2.11.0

package/dist/index.d.cts

@@ -23,6 +23,7 @@ import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
 import * as TogglePrimitive from '@radix-ui/react-toggle';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
+export { toast as rawToast } from 'sonner';
 
 /**
  * hazo_ui_config.ts
@@ -1003,4 +1004,179 @@ declare function ButtonGroupText({ className, asChild, ...props }: React.Compone
 }): react_jsx_runtime.JSX.Element;
 declare function ButtonGroupSeparator({ className, orientation, ...props }: React.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, Label, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, type SortConfig, type SortField, Spinner, type SuggestionState, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buttonGroupVariants, create_command_suggestion_extension, get_hazo_ui_config, parse_commands_from_text, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, text_to_tiptap_content, toggleVariants, useMediaQuery };
+interface SkeletonBaseProps extends React.HTMLAttributes<HTMLDivElement> {
+    className?: string;
+}
+declare const Skeleton: React.ForwardRefExoticComponent<SkeletonBaseProps & React.RefAttributes<HTMLDivElement>>;
+interface SkeletonCircleProps {
+    /** Diameter in px. Default 40. */
+    size?: number;
+    className?: string;
+}
+declare function SkeletonCircle({ size, className }: SkeletonCircleProps): react_jsx_runtime.JSX.Element;
+interface SkeletonBarProps {
+    /** CSS width — accepts px (number) or any CSS length string. Default "100%". */
+    width?: number | string;
+    /** Height in px. Default 12. */
+    height?: number;
+    className?: string;
+}
+declare function SkeletonBar({ width, height, className }: SkeletonBarProps): react_jsx_runtime.JSX.Element;
+interface SkeletonRectProps {
+    width?: number | string;
+    height?: number | string;
+    /** CSS border-radius. Default 6 (matches rounded-md). */
+    radius?: number | string;
+    className?: string;
+}
+declare function SkeletonRect({ width, height, radius, className }: SkeletonRectProps): react_jsx_runtime.JSX.Element;
+interface SkeletonGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Optional `aria-label` for the loading region. Default "Loading content". */
+    label?: string;
+    children: React.ReactNode;
+}
+declare function SkeletonGroup({ label, children, className, ...rest }: SkeletonGroupProps): react_jsx_runtime.JSX.Element;
+
+interface EmptyStateProps {
+    /** Icon element. Recommended size 48x48. Wrap a lucide icon in a div if you want background styling. */
+    icon?: React.ReactNode;
+    /** Required main heading. */
+    title: string;
+    /** Optional secondary description. */
+    description?: React.ReactNode;
+    /** Optional CTA region — typically one or two <Button> elements. */
+    action?: React.ReactNode;
+    /** Visual size. "sm" for inline use (cards, panels), "md" default, "lg" for full-page emptiness. */
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+declare function EmptyState({ icon, title, description, action, size, className, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+type ErrorBannerSeverity = "warning" | "error";
+interface ErrorBannerProps {
+    /** Defaults to "error". */
+    severity?: ErrorBannerSeverity;
+    /** Optional bold heading shown above the message. */
+    title?: string;
+    /** Required body text or node. */
+    message: React.ReactNode;
+    /** Override the auto-selected icon. */
+    icon?: React.ReactNode;
+    /** Optional CTA region — typically one <Button>. */
+    action?: React.ReactNode;
+    /** When provided, renders a dismiss "X" button that calls this on click. */
+    onDismiss?: () => void;
+    className?: string;
+}
+declare function ErrorBanner({ severity, title, message, icon, action, onDismiss, className, }: ErrorBannerProps): react_jsx_runtime.JSX.Element;
+
+interface ErrorPageProps {
+    /** Defaults to "Something went wrong". */
+    title?: string;
+    /** Optional explanation paragraph(s). */
+    description?: React.ReactNode;
+    /** Short symbolic code (e.g., "500", "NOT_FOUND") rendered as a tag. */
+    errorCode?: string;
+    /** Correlation id from hazo_logs — rendered in a copyable mono block when present. */
+    correlationId?: string;
+    /** CTA region — typically one or two <Button> elements ("Try again", "Go home"). */
+    actions?: React.ReactNode;
+    /** Override the default OctagonAlert icon. */
+    illustration?: React.ReactNode;
+    className?: string;
+}
+declare function ErrorPage({ title, description, errorCode, correlationId, actions, illustration, className, }: ErrorPageProps): react_jsx_runtime.JSX.Element;
+
+interface LoadingTimeoutProps {
+    /** When true, the timeout runs and escalation states render. When false, renders children. */
+    active: boolean;
+    /** Children shown when not loading. */
+    children?: React.ReactNode;
+    /** Optional skeleton rendered during the "silent" phase (0–5s). */
+    skeleton?: React.ReactNode;
+    /** Called when the user clicks the retry button in the "expired" phase. */
+    onRetry?: () => void;
+    /** Customise the timeout thresholds in ms. Defaults: 5000/15000/30000. */
+    thresholds?: {
+        gentle?: number;
+        firm?: number;
+        expired?: number;
+    };
+    /** Optional label used in the gentle/firm messages. Default "content". */
+    label?: string;
+    className?: string;
+}
+declare function LoadingTimeout({ active, children, skeleton, onRetry, thresholds, label, className, }: LoadingTimeoutProps): react_jsx_runtime.JSX.Element;
+
+interface ProgressiveImageProps {
+    /** Required final image src. */
+    src: string;
+    /** Required alt text. Empty string is allowed for decorative images. */
+    alt: string;
+    /** Low-quality placeholder data URL or tiny image url. Renders blurred under the main image. */
+    lqip?: string;
+    /** Width in px or CSS length. Required for stable aspect ratio. */
+    width: number | string;
+    /** Height in px or CSS length. Required for stable aspect ratio. */
+    height: number | string;
+    /** Native loading attribute. Default "lazy". */
+    loading?: "eager" | "lazy";
+    /** Object fit for the final image. Default "cover". */
+    fit?: "cover" | "contain" | "fill" | "none" | "scale-down";
+    className?: string;
+    onLoad?: () => void;
+    onError?: () => void;
+}
+declare function ProgressiveImage({ src, alt, lqip, width, height, loading, fit, className, onLoad, onError, }: ProgressiveImageProps): react_jsx_runtime.JSX.Element;
+
+interface HazoUiToasterProps {
+    /** Position of the toast stack. Default "bottom-right". */
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center";
+    /** Whether toasts include a close (X) button. Default true. */
+    closeButton?: boolean;
+    /** Max number of toasts visible at once. Default 5. */
+    visibleToasts?: number;
+}
+declare function HazoUiToaster({ position, closeButton, visibleToasts, }?: HazoUiToasterProps): react_jsx_runtime.JSX.Element;
+interface ToastOptions {
+    title: string;
+    description?: string;
+    /** Auto-dismiss duration in ms. Default 3000 for success, 5000 for error. */
+    duration?: number;
+    /** Optional action button rendered inside the toast. */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+declare function successToast({ title, description, duration, action }: ToastOptions): string | number;
+declare function errorToast({ title, description, duration, action }: ToastOptions): string | number;
+
+interface UseLoadingStateResult {
+    /** Current loading flag. */
+    isLoading: boolean;
+    /** Set the loading flag manually. */
+    setLoading: (value: boolean) => void;
+    /**
+     * Wraps an async function: sets loading=true, awaits the function,
+     * sets loading=false in a finally block. Returns the function's result
+     * (or throws its error).
+     */
+    withLoading: <T>(fn: () => Promise<T>) => Promise<T>;
+}
+declare function useLoadingState(initial?: boolean): UseLoadingStateResult;
+
+interface UseErrorDisplayResult {
+    /** Current error message, or null when cleared. */
+    error: string | null;
+    /**
+     * Set the error. Accepts a string, an Error instance (uses .message),
+     * or null to clear. Anything else is coerced via String().
+     */
+    setError: (value: unknown) => void;
+    /** Clear the error. Same as `setError(null)`. */
+    clearError: () => void;
+}
+declare function useErrorDisplay(): UseErrorDisplayResult;
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorBannerSeverity, ErrorPage, type ErrorPageProps, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, Label, LoadingTimeout, type LoadingTimeoutProps, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, ProgressiveImage, type ProgressiveImageProps, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, Skeleton, SkeletonBar, type SkeletonBarProps, SkeletonCircle, type SkeletonCircleProps, SkeletonGroup, type SkeletonGroupProps, SkeletonRect, type SkeletonRectProps, type SortConfig, type SortField, Spinner, type SuggestionState, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, buttonGroupVariants, create_command_suggestion_extension, errorToast, get_hazo_ui_config, parse_commands_from_text, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useErrorDisplay, useLoadingState, useMediaQuery };

package/dist/index.d.ts

@@ -23,6 +23,7 @@ import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
 import * as TogglePrimitive from '@radix-ui/react-toggle';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
+export { toast as rawToast } from 'sonner';
 
 /**
  * hazo_ui_config.ts
@@ -1003,4 +1004,179 @@ declare function ButtonGroupText({ className, asChild, ...props }: React.Compone
 }): react_jsx_runtime.JSX.Element;
 declare function ButtonGroupSeparator({ className, orientation, ...props }: React.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, Label, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, type SortConfig, type SortField, Spinner, type SuggestionState, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buttonGroupVariants, create_command_suggestion_extension, get_hazo_ui_config, parse_commands_from_text, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, text_to_tiptap_content, toggleVariants, useMediaQuery };
+interface SkeletonBaseProps extends React.HTMLAttributes<HTMLDivElement> {
+    className?: string;
+}
+declare const Skeleton: React.ForwardRefExoticComponent<SkeletonBaseProps & React.RefAttributes<HTMLDivElement>>;
+interface SkeletonCircleProps {
+    /** Diameter in px. Default 40. */
+    size?: number;
+    className?: string;
+}
+declare function SkeletonCircle({ size, className }: SkeletonCircleProps): react_jsx_runtime.JSX.Element;
+interface SkeletonBarProps {
+    /** CSS width — accepts px (number) or any CSS length string. Default "100%". */
+    width?: number | string;
+    /** Height in px. Default 12. */
+    height?: number;
+    className?: string;
+}
+declare function SkeletonBar({ width, height, className }: SkeletonBarProps): react_jsx_runtime.JSX.Element;
+interface SkeletonRectProps {
+    width?: number | string;
+    height?: number | string;
+    /** CSS border-radius. Default 6 (matches rounded-md). */
+    radius?: number | string;
+    className?: string;
+}
+declare function SkeletonRect({ width, height, radius, className }: SkeletonRectProps): react_jsx_runtime.JSX.Element;
+interface SkeletonGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Optional `aria-label` for the loading region. Default "Loading content". */
+    label?: string;
+    children: React.ReactNode;
+}
+declare function SkeletonGroup({ label, children, className, ...rest }: SkeletonGroupProps): react_jsx_runtime.JSX.Element;
+
+interface EmptyStateProps {
+    /** Icon element. Recommended size 48x48. Wrap a lucide icon in a div if you want background styling. */
+    icon?: React.ReactNode;
+    /** Required main heading. */
+    title: string;
+    /** Optional secondary description. */
+    description?: React.ReactNode;
+    /** Optional CTA region — typically one or two <Button> elements. */
+    action?: React.ReactNode;
+    /** Visual size. "sm" for inline use (cards, panels), "md" default, "lg" for full-page emptiness. */
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+declare function EmptyState({ icon, title, description, action, size, className, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+type ErrorBannerSeverity = "warning" | "error";
+interface ErrorBannerProps {
+    /** Defaults to "error". */
+    severity?: ErrorBannerSeverity;
+    /** Optional bold heading shown above the message. */
+    title?: string;
+    /** Required body text or node. */
+    message: React.ReactNode;
+    /** Override the auto-selected icon. */
+    icon?: React.ReactNode;
+    /** Optional CTA region — typically one <Button>. */
+    action?: React.ReactNode;
+    /** When provided, renders a dismiss "X" button that calls this on click. */
+    onDismiss?: () => void;
+    className?: string;
+}
+declare function ErrorBanner({ severity, title, message, icon, action, onDismiss, className, }: ErrorBannerProps): react_jsx_runtime.JSX.Element;
+
+interface ErrorPageProps {
+    /** Defaults to "Something went wrong". */
+    title?: string;
+    /** Optional explanation paragraph(s). */
+    description?: React.ReactNode;
+    /** Short symbolic code (e.g., "500", "NOT_FOUND") rendered as a tag. */
+    errorCode?: string;
+    /** Correlation id from hazo_logs — rendered in a copyable mono block when present. */
+    correlationId?: string;
+    /** CTA region — typically one or two <Button> elements ("Try again", "Go home"). */
+    actions?: React.ReactNode;
+    /** Override the default OctagonAlert icon. */
+    illustration?: React.ReactNode;
+    className?: string;
+}
+declare function ErrorPage({ title, description, errorCode, correlationId, actions, illustration, className, }: ErrorPageProps): react_jsx_runtime.JSX.Element;
+
+interface LoadingTimeoutProps {
+    /** When true, the timeout runs and escalation states render. When false, renders children. */
+    active: boolean;
+    /** Children shown when not loading. */
+    children?: React.ReactNode;
+    /** Optional skeleton rendered during the "silent" phase (0–5s). */
+    skeleton?: React.ReactNode;
+    /** Called when the user clicks the retry button in the "expired" phase. */
+    onRetry?: () => void;
+    /** Customise the timeout thresholds in ms. Defaults: 5000/15000/30000. */
+    thresholds?: {
+        gentle?: number;
+        firm?: number;
+        expired?: number;
+    };
+    /** Optional label used in the gentle/firm messages. Default "content". */
+    label?: string;
+    className?: string;
+}
+declare function LoadingTimeout({ active, children, skeleton, onRetry, thresholds, label, className, }: LoadingTimeoutProps): react_jsx_runtime.JSX.Element;
+
+interface ProgressiveImageProps {
+    /** Required final image src. */
+    src: string;
+    /** Required alt text. Empty string is allowed for decorative images. */
+    alt: string;
+    /** Low-quality placeholder data URL or tiny image url. Renders blurred under the main image. */
+    lqip?: string;
+    /** Width in px or CSS length. Required for stable aspect ratio. */
+    width: number | string;
+    /** Height in px or CSS length. Required for stable aspect ratio. */
+    height: number | string;
+    /** Native loading attribute. Default "lazy". */
+    loading?: "eager" | "lazy";
+    /** Object fit for the final image. Default "cover". */
+    fit?: "cover" | "contain" | "fill" | "none" | "scale-down";
+    className?: string;
+    onLoad?: () => void;
+    onError?: () => void;
+}
+declare function ProgressiveImage({ src, alt, lqip, width, height, loading, fit, className, onLoad, onError, }: ProgressiveImageProps): react_jsx_runtime.JSX.Element;
+
+interface HazoUiToasterProps {
+    /** Position of the toast stack. Default "bottom-right". */
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center";
+    /** Whether toasts include a close (X) button. Default true. */
+    closeButton?: boolean;
+    /** Max number of toasts visible at once. Default 5. */
+    visibleToasts?: number;
+}
+declare function HazoUiToaster({ position, closeButton, visibleToasts, }?: HazoUiToasterProps): react_jsx_runtime.JSX.Element;
+interface ToastOptions {
+    title: string;
+    description?: string;
+    /** Auto-dismiss duration in ms. Default 3000 for success, 5000 for error. */
+    duration?: number;
+    /** Optional action button rendered inside the toast. */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+declare function successToast({ title, description, duration, action }: ToastOptions): string | number;
+declare function errorToast({ title, description, duration, action }: ToastOptions): string | number;
+
+interface UseLoadingStateResult {
+    /** Current loading flag. */
+    isLoading: boolean;
+    /** Set the loading flag manually. */
+    setLoading: (value: boolean) => void;
+    /**
+     * Wraps an async function: sets loading=true, awaits the function,
+     * sets loading=false in a finally block. Returns the function's result
+     * (or throws its error).
+     */
+    withLoading: <T>(fn: () => Promise<T>) => Promise<T>;
+}
+declare function useLoadingState(initial?: boolean): UseLoadingStateResult;
+
+interface UseErrorDisplayResult {
+    /** Current error message, or null when cleared. */
+    error: string | null;
+    /**
+     * Set the error. Accepts a string, an Error instance (uses .message),
+     * or null to clear. Anything else is coerced via String().
+     */
+    setError: (value: unknown) => void;
+    /** Clear the error. Same as `setError(null)`. */
+    clearError: () => void;
+}
+declare function useErrorDisplay(): UseErrorDisplayResult;
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorBannerSeverity, ErrorPage, type ErrorPageProps, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, Label, LoadingTimeout, type LoadingTimeoutProps, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, ProgressiveImage, type ProgressiveImageProps, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, Skeleton, SkeletonBar, type SkeletonBarProps, SkeletonCircle, type SkeletonCircleProps, SkeletonGroup, type SkeletonGroupProps, SkeletonRect, type SkeletonRectProps, type SortConfig, type SortField, Spinner, type SuggestionState, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, buttonGroupVariants, create_command_suggestion_extension, errorToast, get_hazo_ui_config, parse_commands_from_text, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useErrorDisplay, useLoadingState, useMediaQuery };