hazo_ui 2.17.0 → 3.0.1

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
+import { RefObject } from 'react';
 import { Node, Extension } from '@tiptap/core';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as vaul from 'vaul';
@@ -1179,6 +1180,152 @@ interface UseErrorDisplayResult {
 }
 declare function useErrorDisplay(): UseErrorDisplayResult;
 
+/**
+ * Returns a debounced copy of `value`.
+ * The returned value only updates after `delayMs` milliseconds have elapsed
+ * with no new value. Useful for search inputs or any expensive effect that
+ * should not run on every keystroke.
+ *
+ * @param value    - The current value to debounce.
+ * @param delayMs  - Delay in milliseconds before the debounced value updates.
+ * @returns The debounced value (same type as the input).
+ *
+ * @example
+ *   const [query, setQuery] = useState("");
+ *   const debouncedQuery = useDebounce(query, 300);
+ *   useEffect(() => { fetchResults(debouncedQuery); }, [debouncedQuery]);
+ */
+declare function useDebounce<T>(value: T, delayMs: number): T;
+
+interface UseCopyToClipboardResult {
+    /** True for ~2 s after a successful copy; false otherwise. */
+    copied: boolean;
+    /**
+     * Write `text` to the clipboard. Resolves silently on success.
+     * In unsupported environments the promise resolves without throwing.
+     */
+    copy: (text: string) => Promise<void>;
+}
+/**
+ * Clipboard write wrapper with a transient `copied` flag.
+ *
+ * @returns `{ copied, copy }` — call `copy(text)` to write to the clipboard.
+ *   `copied` is `true` for 2 seconds after a successful write.
+ *
+ * @example
+ *   const { copied, copy } = useCopyToClipboard();
+ *   <button onClick={() => copy("hello")}>{copied ? "Copied!" : "Copy"}</button>
+ */
+declare function useCopyToClipboard(): UseCopyToClipboardResult;
+
+/**
+ * Returns `true` when the viewport width is narrower than `breakpointPx`.
+ * Re-renders when the match state changes. SSR-safe (returns `false` on server).
+ *
+ * @param breakpointPx - Pixel threshold for "mobile". Defaults to 768 px.
+ *
+ * @example
+ *   const isMobile = useIsMobile();
+ *   const isTablet = useIsMobile(1024);
+ */
+declare function useIsMobile(breakpointPx?: number): boolean;
+/**
+ * Alias for `useIsMobile` — accepts a breakpoint in pixels.
+ * Provided for consumers who prefer the `useViewport` name.
+ *
+ * @param breakpoint - Pixel threshold (same semantics as `useIsMobile`). Defaults to 768 px.
+ */
+declare function useViewport(breakpoint?: number): boolean;
+
+/**
+ * localStorage-backed state hook.
+ * The stored value is JSON-serialised; parse errors fall back to `initialValue`.
+ *
+ * @param key           - localStorage key.
+ * @param initialValue  - Value used when no stored entry exists or on SSR.
+ * @returns `[storedValue, setValue]` — same API as `useState`.
+ *
+ * @example
+ *   const [theme, setTheme] = useLocalStorage<"light" | "dark">("theme", "light");
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void];
+
+/**
+ * sessionStorage-backed state hook.
+ * The stored value is JSON-serialised; parse errors fall back to `initialValue`.
+ *
+ * @param key           - sessionStorage key.
+ * @param initialValue  - Value used when no stored entry exists or on SSR.
+ * @returns `[storedValue, setValue]` — same API as `useState`.
+ *
+ * @example
+ *   const [draft, setDraft] = useSessionStorage("form_draft", "");
+ */
+declare function useSessionStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void];
+
+/**
+ * Fires `handler` when the user clicks (or taps) outside the element bound to `ref`.
+ * Attaches a `mousedown` listener on `document`; cleans up on unmount or dependency change.
+ *
+ * @param ref     - React ref pointing to the element to watch.
+ * @param handler - Callback invoked when a click outside is detected.
+ *
+ * @example
+ *   const panel_ref = useRef<HTMLDivElement>(null);
+ *   useClickOutside(panel_ref, () => setOpen(false));
+ *   return <div ref={panel_ref}>...</div>;
+ */
+declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: () => void): void;
+
+interface UseWakeLockResult {
+    /** True when the Wake Lock API is available in this environment. */
+    supported: boolean;
+    /** True when a wake lock is currently held. */
+    acquired: boolean;
+    /** Request the screen wake lock. No-op if unsupported or already acquired. */
+    request: () => Promise<void>;
+    /** Release the currently held wake lock. No-op if not acquired. */
+    release: () => Promise<void>;
+}
+/**
+ * Web Wake Lock API wrapper. Prevents screen sleep while the lock is held.
+ * Automatically reacquires the lock when the page becomes visible again
+ * (e.g. after switching tabs), because the browser releases it on visibility change.
+ *
+ * Returns `supported: false` in environments that don't implement the API
+ * (SSR, older browsers) — all other operations are no-ops in that case.
+ *
+ * @example
+ *   const { supported, acquired, request, release } = useWakeLock();
+ *   <button onClick={acquired ? release : request}>
+ *     {acquired ? "Release lock" : "Keep screen on"}
+ *   </button>
+ */
+declare function useWakeLock(): UseWakeLockResult;
+
+interface UseFullscreenResult {
+    /** True when the targeted element (or document) is currently fullscreen. */
+    isFullscreen: boolean;
+    /** Request fullscreen. No-op if already fullscreen or unsupported. */
+    enter: () => Promise<void>;
+    /** Exit fullscreen. No-op if not fullscreen or unsupported. */
+    exit: () => Promise<void>;
+    /** Toggle between fullscreen and normal. */
+    toggle: () => Promise<void>;
+}
+/**
+ * Fullscreen API wrapper.
+ *
+ * @param elementRef - Optional ref to the element to fullscreen.
+ *   Defaults to `document.documentElement` when omitted.
+ *
+ * @example
+ *   const container_ref = useRef<HTMLDivElement>(null);
+ *   const { isFullscreen, toggle } = useFullscreen(container_ref);
+ *   return <div ref={container_ref}><button onClick={toggle}>Fullscreen</button></div>;
+ */
+declare function useFullscreen(elementRef?: RefObject<HTMLElement | null>): UseFullscreenResult;
+
 /**
  * Types for HazoUiKanban - Drag-Drop Kanban
  *
@@ -1735,4 +1882,54 @@ declare function format_num(n: number | null | undefined | string): string;
  */
 declare function pick_x_label_indices(length: number): [number, number, number];
 
-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, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, 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, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTable, type HazoUiTablePagination, type HazoUiTableProps, type HazoUiTableServerLoadArgs, type HazoUiTableServerLoadResult, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, InverseSparkline, type InverseSparklineProps, type KanbanAnnouncements, type KanbanColumn, type KanbanEditorCtx, type KanbanEditorField, type KanbanEditorFieldType, type KanbanFilterValue, type KanbanItem, type KanbanMoveEvent, type KanbanMoveHandle, type KanbanPriority, type KanbanReorderEvent, type KanbanSaveEvent, Label, LineChart, type LineChartProps, LoadingTimeout, type LoadingTimeoutProps, MultiLineChart, type MultiLineChartProps, type MultiSeries, 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, Sparkline, type SparklineProps, Spinner, type StackedBar, StackedBars, type StackedBarsProps, type SuggestionState, Switch, Table, TableBody, TableCaption, TableCell, type TableColumn, type TableFilter, TableFooter, type TableFormatter, TableHead, TableHeader, TableRow, type TableSort, type TableSortEntry, type TableSortProp, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, applyKanbanFilter, buttonGroupVariants, create_command_suggestion_extension, errorToast, format_num, get_hazo_ui_config, parse_commands_from_text, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useErrorDisplay, useLoadingState, useMediaQuery };
+/** Default gradient for the shareable card background. Override via shareableCard.background. */
+declare const CELEBRATION_GRADIENT = "linear-gradient(135deg, #667eea 0%, #764ba2 100%)";
+interface CelebrationShareableCard {
+    /**
+     * CSS background value applied to the 1080×1080 card.
+     * Default: CELEBRATION_GRADIENT.
+     */
+    background?: string;
+    /** ReactNode rendered at full 1080×1080 size (scaled down for preview). */
+    foreground: React.ReactNode;
+    /**
+     * Caption at the bottom of the card.
+     * Falls back to the top-level subtitle when omitted.
+     */
+    caption?: string;
+}
+interface CelebrationPayload {
+    /**
+     * Unique identifier. Also the sessionStorage dedup key:
+     * hazo_ui_celebration_<id> = "1" once shown.
+     */
+    id: string;
+    title: string;
+    subtitle?: string;
+    shareableCard?: CelebrationShareableCard;
+    /** Auto-dismiss the modal after autoDismissDelay ms. Default true. */
+    autoDismiss?: boolean;
+    /**
+     * Duration in ms before auto-dismiss. Default 8000.
+     * Set to a short value (e.g. 100) in tests.
+     */
+    autoDismissDelay?: number;
+    /** Play the bundled success chime when the modal opens. Default false. */
+    audioChime?: boolean;
+}
+/**
+ * Fire a celebration modal from anywhere in the tree.
+ * No-ops when <CelebrationProvider /> is not mounted or the id was already
+ * shown this session.
+ */
+declare function celebrate(payload: CelebrationPayload): void;
+interface CelebrationProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * Mount once near the root of your app (e.g. (app)/layout.tsx).
+ * Renders the current celebration modal and manages the FIFO queue.
+ */
+declare function CelebrationProvider({ children }: CelebrationProviderProps): 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, CELEBRATION_GRADIENT, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CelebrationPayload, CelebrationProvider, type CelebrationProviderProps, type CelebrationShareableCard, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, 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, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTable, type HazoUiTablePagination, type HazoUiTableProps, type HazoUiTableServerLoadArgs, type HazoUiTableServerLoadResult, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, InverseSparkline, type InverseSparklineProps, type KanbanAnnouncements, type KanbanColumn, type KanbanEditorCtx, type KanbanEditorField, type KanbanEditorFieldType, type KanbanFilterValue, type KanbanItem, type KanbanMoveEvent, type KanbanMoveHandle, type KanbanPriority, type KanbanReorderEvent, type KanbanSaveEvent, Label, LineChart, type LineChartProps, LoadingTimeout, type LoadingTimeoutProps, MultiLineChart, type MultiLineChartProps, type MultiSeries, 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, Sparkline, type SparklineProps, Spinner, type StackedBar, StackedBars, type StackedBarsProps, type SuggestionState, Switch, Table, TableBody, TableCaption, TableCell, type TableColumn, type TableFilter, TableFooter, type TableFormatter, TableHead, TableHeader, TableRow, type TableSort, type TableSortEntry, type TableSortProp, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseCopyToClipboardResult, type UseErrorDisplayResult, type UseFullscreenResult, type UseLoadingStateResult, type UseWakeLockResult, applyKanbanFilter, buttonGroupVariants, celebrate, create_command_suggestion_extension, errorToast, format_num, get_hazo_ui_config, parse_commands_from_text, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
+import { RefObject } from 'react';
 import { Node, Extension } from '@tiptap/core';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as vaul from 'vaul';
@@ -1179,6 +1180,152 @@ interface UseErrorDisplayResult {
 }
 declare function useErrorDisplay(): UseErrorDisplayResult;
 
+/**
+ * Returns a debounced copy of `value`.
+ * The returned value only updates after `delayMs` milliseconds have elapsed
+ * with no new value. Useful for search inputs or any expensive effect that
+ * should not run on every keystroke.
+ *
+ * @param value    - The current value to debounce.
+ * @param delayMs  - Delay in milliseconds before the debounced value updates.
+ * @returns The debounced value (same type as the input).
+ *
+ * @example
+ *   const [query, setQuery] = useState("");
+ *   const debouncedQuery = useDebounce(query, 300);
+ *   useEffect(() => { fetchResults(debouncedQuery); }, [debouncedQuery]);
+ */
+declare function useDebounce<T>(value: T, delayMs: number): T;
+
+interface UseCopyToClipboardResult {
+    /** True for ~2 s after a successful copy; false otherwise. */
+    copied: boolean;
+    /**
+     * Write `text` to the clipboard. Resolves silently on success.
+     * In unsupported environments the promise resolves without throwing.
+     */
+    copy: (text: string) => Promise<void>;
+}
+/**
+ * Clipboard write wrapper with a transient `copied` flag.
+ *
+ * @returns `{ copied, copy }` — call `copy(text)` to write to the clipboard.
+ *   `copied` is `true` for 2 seconds after a successful write.
+ *
+ * @example
+ *   const { copied, copy } = useCopyToClipboard();
+ *   <button onClick={() => copy("hello")}>{copied ? "Copied!" : "Copy"}</button>
+ */
+declare function useCopyToClipboard(): UseCopyToClipboardResult;
+
+/**
+ * Returns `true` when the viewport width is narrower than `breakpointPx`.
+ * Re-renders when the match state changes. SSR-safe (returns `false` on server).
+ *
+ * @param breakpointPx - Pixel threshold for "mobile". Defaults to 768 px.
+ *
+ * @example
+ *   const isMobile = useIsMobile();
+ *   const isTablet = useIsMobile(1024);
+ */
+declare function useIsMobile(breakpointPx?: number): boolean;
+/**
+ * Alias for `useIsMobile` — accepts a breakpoint in pixels.
+ * Provided for consumers who prefer the `useViewport` name.
+ *
+ * @param breakpoint - Pixel threshold (same semantics as `useIsMobile`). Defaults to 768 px.
+ */
+declare function useViewport(breakpoint?: number): boolean;
+
+/**
+ * localStorage-backed state hook.
+ * The stored value is JSON-serialised; parse errors fall back to `initialValue`.
+ *
+ * @param key           - localStorage key.
+ * @param initialValue  - Value used when no stored entry exists or on SSR.
+ * @returns `[storedValue, setValue]` — same API as `useState`.
+ *
+ * @example
+ *   const [theme, setTheme] = useLocalStorage<"light" | "dark">("theme", "light");
+ */
+declare function useLocalStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void];
+
+/**
+ * sessionStorage-backed state hook.
+ * The stored value is JSON-serialised; parse errors fall back to `initialValue`.
+ *
+ * @param key           - sessionStorage key.
+ * @param initialValue  - Value used when no stored entry exists or on SSR.
+ * @returns `[storedValue, setValue]` — same API as `useState`.
+ *
+ * @example
+ *   const [draft, setDraft] = useSessionStorage("form_draft", "");
+ */
+declare function useSessionStorage<T>(key: string, initialValue: T): [T, (value: T | ((prev: T) => T)) => void];
+
+/**
+ * Fires `handler` when the user clicks (or taps) outside the element bound to `ref`.
+ * Attaches a `mousedown` listener on `document`; cleans up on unmount or dependency change.
+ *
+ * @param ref     - React ref pointing to the element to watch.
+ * @param handler - Callback invoked when a click outside is detected.
+ *
+ * @example
+ *   const panel_ref = useRef<HTMLDivElement>(null);
+ *   useClickOutside(panel_ref, () => setOpen(false));
+ *   return <div ref={panel_ref}>...</div>;
+ */
+declare function useClickOutside<T extends HTMLElement>(ref: RefObject<T | null>, handler: () => void): void;
+
+interface UseWakeLockResult {
+    /** True when the Wake Lock API is available in this environment. */
+    supported: boolean;
+    /** True when a wake lock is currently held. */
+    acquired: boolean;
+    /** Request the screen wake lock. No-op if unsupported or already acquired. */
+    request: () => Promise<void>;
+    /** Release the currently held wake lock. No-op if not acquired. */
+    release: () => Promise<void>;
+}
+/**
+ * Web Wake Lock API wrapper. Prevents screen sleep while the lock is held.
+ * Automatically reacquires the lock when the page becomes visible again
+ * (e.g. after switching tabs), because the browser releases it on visibility change.
+ *
+ * Returns `supported: false` in environments that don't implement the API
+ * (SSR, older browsers) — all other operations are no-ops in that case.
+ *
+ * @example
+ *   const { supported, acquired, request, release } = useWakeLock();
+ *   <button onClick={acquired ? release : request}>
+ *     {acquired ? "Release lock" : "Keep screen on"}
+ *   </button>
+ */
+declare function useWakeLock(): UseWakeLockResult;
+
+interface UseFullscreenResult {
+    /** True when the targeted element (or document) is currently fullscreen. */
+    isFullscreen: boolean;
+    /** Request fullscreen. No-op if already fullscreen or unsupported. */
+    enter: () => Promise<void>;
+    /** Exit fullscreen. No-op if not fullscreen or unsupported. */
+    exit: () => Promise<void>;
+    /** Toggle between fullscreen and normal. */
+    toggle: () => Promise<void>;
+}
+/**
+ * Fullscreen API wrapper.
+ *
+ * @param elementRef - Optional ref to the element to fullscreen.
+ *   Defaults to `document.documentElement` when omitted.
+ *
+ * @example
+ *   const container_ref = useRef<HTMLDivElement>(null);
+ *   const { isFullscreen, toggle } = useFullscreen(container_ref);
+ *   return <div ref={container_ref}><button onClick={toggle}>Fullscreen</button></div>;
+ */
+declare function useFullscreen(elementRef?: RefObject<HTMLElement | null>): UseFullscreenResult;
+
 /**
  * Types for HazoUiKanban - Drag-Drop Kanban
  *
@@ -1735,4 +1882,54 @@ declare function format_num(n: number | null | undefined | string): string;
  */
 declare function pick_x_label_indices(length: number): [number, number, number];
 
-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, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, 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, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTable, type HazoUiTablePagination, type HazoUiTableProps, type HazoUiTableServerLoadArgs, type HazoUiTableServerLoadResult, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, InverseSparkline, type InverseSparklineProps, type KanbanAnnouncements, type KanbanColumn, type KanbanEditorCtx, type KanbanEditorField, type KanbanEditorFieldType, type KanbanFilterValue, type KanbanItem, type KanbanMoveEvent, type KanbanMoveHandle, type KanbanPriority, type KanbanReorderEvent, type KanbanSaveEvent, Label, LineChart, type LineChartProps, LoadingTimeout, type LoadingTimeoutProps, MultiLineChart, type MultiLineChartProps, type MultiSeries, 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, Sparkline, type SparklineProps, Spinner, type StackedBar, StackedBars, type StackedBarsProps, type SuggestionState, Switch, Table, TableBody, TableCaption, TableCell, type TableColumn, type TableFilter, TableFooter, type TableFormatter, TableHead, TableHeader, TableRow, type TableSort, type TableSortEntry, type TableSortProp, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, applyKanbanFilter, buttonGroupVariants, create_command_suggestion_extension, errorToast, format_num, get_hazo_ui_config, parse_commands_from_text, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useErrorDisplay, useLoadingState, useMediaQuery };
+/** Default gradient for the shareable card background. Override via shareableCard.background. */
+declare const CELEBRATION_GRADIENT = "linear-gradient(135deg, #667eea 0%, #764ba2 100%)";
+interface CelebrationShareableCard {
+    /**
+     * CSS background value applied to the 1080×1080 card.
+     * Default: CELEBRATION_GRADIENT.
+     */
+    background?: string;
+    /** ReactNode rendered at full 1080×1080 size (scaled down for preview). */
+    foreground: React.ReactNode;
+    /**
+     * Caption at the bottom of the card.
+     * Falls back to the top-level subtitle when omitted.
+     */
+    caption?: string;
+}
+interface CelebrationPayload {
+    /**
+     * Unique identifier. Also the sessionStorage dedup key:
+     * hazo_ui_celebration_<id> = "1" once shown.
+     */
+    id: string;
+    title: string;
+    subtitle?: string;
+    shareableCard?: CelebrationShareableCard;
+    /** Auto-dismiss the modal after autoDismissDelay ms. Default true. */
+    autoDismiss?: boolean;
+    /**
+     * Duration in ms before auto-dismiss. Default 8000.
+     * Set to a short value (e.g. 100) in tests.
+     */
+    autoDismissDelay?: number;
+    /** Play the bundled success chime when the modal opens. Default false. */
+    audioChime?: boolean;
+}
+/**
+ * Fire a celebration modal from anywhere in the tree.
+ * No-ops when <CelebrationProvider /> is not mounted or the id was already
+ * shown this session.
+ */
+declare function celebrate(payload: CelebrationPayload): void;
+interface CelebrationProviderProps {
+    children: React.ReactNode;
+}
+/**
+ * Mount once near the root of your app (e.g. (app)/layout.tsx).
+ * Renders the current celebration modal and manages the FIFO queue.
+ */
+declare function CelebrationProvider({ children }: CelebrationProviderProps): 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, CELEBRATION_GRADIENT, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CelebrationPayload, CelebrationProvider, type CelebrationProviderProps, type CelebrationShareableCard, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, 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, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTable, type HazoUiTablePagination, type HazoUiTableProps, type HazoUiTableServerLoadArgs, type HazoUiTableServerLoadResult, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, InverseSparkline, type InverseSparklineProps, type KanbanAnnouncements, type KanbanColumn, type KanbanEditorCtx, type KanbanEditorField, type KanbanEditorFieldType, type KanbanFilterValue, type KanbanItem, type KanbanMoveEvent, type KanbanMoveHandle, type KanbanPriority, type KanbanReorderEvent, type KanbanSaveEvent, Label, LineChart, type LineChartProps, LoadingTimeout, type LoadingTimeoutProps, MultiLineChart, type MultiLineChartProps, type MultiSeries, 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, Sparkline, type SparklineProps, Spinner, type StackedBar, StackedBars, type StackedBarsProps, type SuggestionState, Switch, Table, TableBody, TableCaption, TableCell, type TableColumn, type TableFilter, TableFooter, type TableFormatter, TableHead, TableHeader, TableRow, type TableSort, type TableSortEntry, type TableSortProp, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseCopyToClipboardResult, type UseErrorDisplayResult, type UseFullscreenResult, type UseLoadingStateResult, type UseWakeLockResult, applyKanbanFilter, buttonGroupVariants, celebrate, create_command_suggestion_extension, errorToast, format_num, get_hazo_ui_config, parse_commands_from_text, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock };