hazo_ui 6.1.0 → 6.3.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-export { c as cn, s as safeHref } from './index.utils-DZVbQXFR.cjs';
+export { A as AnnounceOptions, a as AnnouncePriority, D as DEFAULT_ANNOUNCE_EVENT, L as LiveAnnouncement, b as announce, c as cn, h as hasUrlParam, r as readRememberedState, s as safeHref, w as writeRememberedState } from './announce-DAnQDTld.cjs';
 import * as React$1 from 'react';
-import { ReactNode, RefObject } from 'react';
+import { ReactNode, RefObject, PointerEvent, MouseEvent } from 'react';
 import { ICommand } from '@uiw/react-md-editor';
 export { ICommand as MarkdownEditorCommand } from '@uiw/react-md-editor';
 import { Node, Extension } from '@tiptap/core';
@@ -2718,4 +2718,142 @@ interface AppFooterProps {
 }
 declare function AppFooter({ variant, footer, identity, className }: AppFooterProps): React$1.JSX.Element;
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, AppFooter, type AppFooterProps, AppHeader, type AppHeaderProps, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, CanvasTextToolbar, type CanvasTextToolbarProps, 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 EtaProgressHandle, type FilterConfig, type FilterField, FunnelChart, type FunnelChartProps, type FunnelStep, HazoContextProvider, type HazoContextProviderProps, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, type HazoUiDialogKind, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiEtaProgress, type HazoUiEtaProgressProps, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiIcon, HazoUiIconPicker, type HazoUiIconPickerProps, type HazoUiIconProps, HazoUiImageCropper, HazoUiImageCropperDialog, type HazoUiImageCropperDialogProps, type HazoUiImageCropperHandle, type HazoUiImageCropperProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMemoryDropdown, type HazoUiMemoryDropdownProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiProgressBar, type HazoUiProgressBarProps, 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, InputAffix, type InputAffixProps, 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, LoadingTimeout, type LoadingTimeoutProps, type Logger, Logo, type LogoProps, MarkdownEditor, type MarkdownEditorProps, type MarkdownEmbed, type MemoryEntry, NotificationCountBadge, type NotificationCountBadgeProps, NotificationItem, type NotificationItemProps, NotificationPanel, type NotificationPanelProps, type PermissionToastOptions, 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, Slider, 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 UseEtaProgressOptions, type UseFullscreenRefResult, type UseFullscreenResult, type UseLoadingStateResult, type UseWakeLockResult, applyKanbanFilter, buttonGroupVariants, celebrate, computeEta, create_command_suggestion_extension, easeToward, errorToast, format_num, generateUUID, get_hazo_ui_config, get_logger, isLucideValue, median, parse_commands_from_text, permissionToast, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, set_logger, successToast, text_to_tiptap_content, toggleVariants, upsertEntry as upsertMemoryEntry, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };
+interface UseRememberedStateOptions<T> {
+    /** Full localStorage key. Callers own their own namespacing/prefix. */
+    key: string;
+    /** Current serialisable state to remember. */
+    snapshot: T;
+    /** Feed a remembered snapshot back into the caller. Called at most once, on mount. */
+    restore: (snapshot: T) => void;
+    /** Default `true`; when `false` the hook is entirely inert (no read, no write). */
+    enabled?: boolean;
+    /** Debounce delay (ms) before a changed snapshot is written. Default `600`. */
+    debounceMs?: number;
+    /**
+     * When set, restore-on-mount is skipped if this URL query param is present
+     * in `window.location.search` — an explicit shared-link or saved-record
+     * load should always win over remembered state. Omit to never skip.
+     */
+    skipWhenUrlParam?: string;
+}
+/**
+ * Remembers a snapshot of state in localStorage and restores it on mount.
+ *
+ * - Restore is attempted **once** per mount (a ref-based guard, independent
+ *   of prop/dependency changes — `restore`'s identity may change every
+ *   render without retriggering it).
+ * - If `skipWhenUrlParam` is set and that query param is present in the
+ *   current URL, the restore-on-mount step is skipped entirely (an explicit
+ *   link/record load wins over remembered state).
+ * - Writes are debounced by `debounceMs` and keyed off the snapshot's
+ *   serialised JSON (not object identity), so a structurally-equal-but-new
+ *   snapshot object doesn't reschedule a write.
+ *
+ * @example
+ *   useRememberedState({
+ *     key: `myapp:tool:${slug}`,
+ *     snapshot: currentSeed,
+ *     restore: (seed) => applySeed(seed),
+ *     skipWhenUrlParam: "restore",
+ *   });
+ */
+declare function useRememberedState<T>({ key, snapshot, restore, enabled, debounceMs, skipWhenUrlParam, }: UseRememberedStateOptions<T>): void;
+
+interface UseLongPressOptions {
+    onLongPress: (e: PointerEvent) => void;
+    /** ms to hold before firing. Default 500. */
+    delayMs?: number;
+    /** Pixels of movement that cancel the press. Default 8. */
+    moveThresholdPx?: number;
+    /** Vibration ms on fire. Default 10. Set 0 to disable. */
+    hapticMs?: number;
+}
+interface UseLongPressResult {
+    onPointerDown: (e: PointerEvent) => void;
+    onPointerMove: (e: PointerEvent) => void;
+    onPointerUp: (e: PointerEvent) => void;
+    onPointerCancel: (e: PointerEvent) => void;
+    /** Spread onto the same element to suppress the trailing click that
+     *  fires after the long-press triggers. Without this, the touch that
+     *  ends the press also opens the hover card or detail panel — double
+     *  action. */
+    onClick: (e: MouseEvent) => void;
+}
+/**
+ * Touch-only long-press hook. On fine-pointer devices (mouse), every
+ * returned handler is a no-op — desktop relies on `onContextMenu` for
+ * right-click instead. The returned event handlers should be spread onto
+ * the target element via `<div {...longPress}>`.
+ *
+ * @param options.onLongPress     - Fired once the press has been held for `delayMs`.
+ * @param options.delayMs         - ms to hold before firing. Default `500`.
+ * @param options.moveThresholdPx - Pixels of movement that cancel the press. Default `8`.
+ * @param options.hapticMs        - Vibration ms on fire (`navigator.vibrate`). Default `10`; `0` disables.
+ *
+ * @example
+ *   const longPress = useLongPress({ onLongPress: (e) => openContextMenu(e) });
+ *   <div {...longPress}>Hold me</div>
+ */
+declare function useLongPress({ onLongPress, delayMs, moveThresholdPx, hapticMs, }: UseLongPressOptions): UseLongPressResult;
+
+interface LiveRegionProps {
+    /** Custom-event name to listen on. Must match the `eventName` passed to `announce()`. Default `DEFAULT_ANNOUNCE_EVENT`. */
+    eventName?: string;
+    /** className applied to both region `<div>`s. Default `"sr-only"` (Tailwind's screen-reader-only utility). */
+    className?: string;
+    /** Milliseconds a message stays in the DOM before self-clearing. Default `6000`. */
+    clearAfterMs?: number;
+}
+/**
+ * Mount once per `eventName` channel (typically once, at the app root).
+ * Renders two visually-hidden `aria-live` regions (`polite` / `assertive`)
+ * that receive text pushed by `announce()` calls dispatched on the same
+ * `eventName`.
+ *
+ * @example
+ *   // root layout
+ *   <LiveRegion />
+ *   // elsewhere in the client tree
+ *   announce("Saved");
+ *
+ * @example
+ *   // namespaced channel — LiveRegion and announce() must agree on eventName
+ *   <LiveRegion eventName="myapp:announce" />
+ *   announce("Saved", "polite", { eventName: "myapp:announce" });
+ */
+declare function LiveRegion({ eventName, className, clearAfterMs, }: LiveRegionProps): React$1.JSX.Element;
+
+interface UseScrollRestoreOptions {
+    /** localStorage key prefix. Callers own their own namespacing. Default `DEFAULT_SCROLL_RESTORE_PREFIX` ("hazo_ui:scrollPos"). */
+    prefix?: string;
+}
+interface UseScrollRestoreResult {
+    /** Persist a scroll position (rounded to the nearest pixel). */
+    save: (scrollY: number) => void;
+    /** Read back the persisted scroll position, or `null` if none / unreadable. */
+    load: () => number | null;
+}
+/**
+ * localStorage-backed scroll-position save/load, keyed by
+ * `${prefix}.${treeId}.${viewName}`. SSR-safe (no-ops when `window` is
+ * undefined) and quota-safe (write failures are swallowed).
+ *
+ * @param treeId   - Identifies the scrollable subject (e.g. a document/tree id).
+ * @param viewName - Identifies which view/pane within that subject.
+ * @param options.prefix - Storage-key prefix. Default `"hazo_ui:scrollPos"`.
+ *
+ * @example
+ *   const { save, load } = useScrollRestore(treeId, "canvas");
+ *   useEffect(() => {
+ *     const y = load();
+ *     if (y !== null) containerRef.current?.scrollTo(0, y);
+ *   }, []);
+ *   const onScroll = (e: React.UIEvent<HTMLDivElement>) => save(e.currentTarget.scrollTop);
+ *
+ * @example
+ *   // namespaced prefix — avoids collisions with other apps sharing a domain
+ *   useScrollRestore(treeId, "canvas", { prefix: "myapp:scrollPos" });
+ */
+declare function useScrollRestore(treeId: string, viewName: string, options?: UseScrollRestoreOptions): UseScrollRestoreResult;
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, AppFooter, type AppFooterProps, AppHeader, type AppHeaderProps, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, CanvasTextToolbar, type CanvasTextToolbarProps, 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 EtaProgressHandle, type FilterConfig, type FilterField, FunnelChart, type FunnelChartProps, type FunnelStep, HazoContextProvider, type HazoContextProviderProps, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, type HazoUiDialogKind, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiEtaProgress, type HazoUiEtaProgressProps, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiIcon, HazoUiIconPicker, type HazoUiIconPickerProps, type HazoUiIconProps, HazoUiImageCropper, HazoUiImageCropperDialog, type HazoUiImageCropperDialogProps, type HazoUiImageCropperHandle, type HazoUiImageCropperProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMemoryDropdown, type HazoUiMemoryDropdownProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiProgressBar, type HazoUiProgressBarProps, 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, InputAffix, type InputAffixProps, 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, LiveRegion, type LiveRegionProps, LoadingTimeout, type LoadingTimeoutProps, type Logger, Logo, type LogoProps, MarkdownEditor, type MarkdownEditorProps, type MarkdownEmbed, type MemoryEntry, NotificationCountBadge, type NotificationCountBadgeProps, NotificationItem, type NotificationItemProps, NotificationPanel, type NotificationPanelProps, type PermissionToastOptions, 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, Slider, 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 UseEtaProgressOptions, type UseFullscreenRefResult, type UseFullscreenResult, type UseLoadingStateResult, type UseLongPressOptions, type UseLongPressResult, type UseRememberedStateOptions, type UseScrollRestoreOptions, type UseScrollRestoreResult, type UseWakeLockResult, applyKanbanFilter, buttonGroupVariants, celebrate, computeEta, create_command_suggestion_extension, easeToward, errorToast, format_num, generateUUID, get_hazo_ui_config, get_logger, isLucideValue, median, parse_commands_from_text, permissionToast, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, set_logger, successToast, text_to_tiptap_content, toggleVariants, upsertEntry as upsertMemoryEntry, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useLongPress, useMediaQuery, useRememberedState, useScrollRestore, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { c as cn, s as safeHref } from './index.utils-DZVbQXFR.js';
+export { A as AnnounceOptions, a as AnnouncePriority, D as DEFAULT_ANNOUNCE_EVENT, L as LiveAnnouncement, b as announce, c as cn, h as hasUrlParam, r as readRememberedState, s as safeHref, w as writeRememberedState } from './announce-DAnQDTld.js';
 import * as React$1 from 'react';
-import { ReactNode, RefObject } from 'react';
+import { ReactNode, RefObject, PointerEvent, MouseEvent } from 'react';
 import { ICommand } from '@uiw/react-md-editor';
 export { ICommand as MarkdownEditorCommand } from '@uiw/react-md-editor';
 import { Node, Extension } from '@tiptap/core';
@@ -2718,4 +2718,142 @@ interface AppFooterProps {
 }
 declare function AppFooter({ variant, footer, identity, className }: AppFooterProps): React$1.JSX.Element;
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, AppFooter, type AppFooterProps, AppHeader, type AppHeaderProps, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, CanvasTextToolbar, type CanvasTextToolbarProps, 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 EtaProgressHandle, type FilterConfig, type FilterField, FunnelChart, type FunnelChartProps, type FunnelStep, HazoContextProvider, type HazoContextProviderProps, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, type HazoUiDialogKind, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiEtaProgress, type HazoUiEtaProgressProps, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiIcon, HazoUiIconPicker, type HazoUiIconPickerProps, type HazoUiIconProps, HazoUiImageCropper, HazoUiImageCropperDialog, type HazoUiImageCropperDialogProps, type HazoUiImageCropperHandle, type HazoUiImageCropperProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMemoryDropdown, type HazoUiMemoryDropdownProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiProgressBar, type HazoUiProgressBarProps, 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, InputAffix, type InputAffixProps, 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, LoadingTimeout, type LoadingTimeoutProps, type Logger, Logo, type LogoProps, MarkdownEditor, type MarkdownEditorProps, type MarkdownEmbed, type MemoryEntry, NotificationCountBadge, type NotificationCountBadgeProps, NotificationItem, type NotificationItemProps, NotificationPanel, type NotificationPanelProps, type PermissionToastOptions, 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, Slider, 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 UseEtaProgressOptions, type UseFullscreenRefResult, type UseFullscreenResult, type UseLoadingStateResult, type UseWakeLockResult, applyKanbanFilter, buttonGroupVariants, celebrate, computeEta, create_command_suggestion_extension, easeToward, errorToast, format_num, generateUUID, get_hazo_ui_config, get_logger, isLucideValue, median, parse_commands_from_text, permissionToast, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, set_logger, successToast, text_to_tiptap_content, toggleVariants, upsertEntry as upsertMemoryEntry, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };
+interface UseRememberedStateOptions<T> {
+    /** Full localStorage key. Callers own their own namespacing/prefix. */
+    key: string;
+    /** Current serialisable state to remember. */
+    snapshot: T;
+    /** Feed a remembered snapshot back into the caller. Called at most once, on mount. */
+    restore: (snapshot: T) => void;
+    /** Default `true`; when `false` the hook is entirely inert (no read, no write). */
+    enabled?: boolean;
+    /** Debounce delay (ms) before a changed snapshot is written. Default `600`. */
+    debounceMs?: number;
+    /**
+     * When set, restore-on-mount is skipped if this URL query param is present
+     * in `window.location.search` — an explicit shared-link or saved-record
+     * load should always win over remembered state. Omit to never skip.
+     */
+    skipWhenUrlParam?: string;
+}
+/**
+ * Remembers a snapshot of state in localStorage and restores it on mount.
+ *
+ * - Restore is attempted **once** per mount (a ref-based guard, independent
+ *   of prop/dependency changes — `restore`'s identity may change every
+ *   render without retriggering it).
+ * - If `skipWhenUrlParam` is set and that query param is present in the
+ *   current URL, the restore-on-mount step is skipped entirely (an explicit
+ *   link/record load wins over remembered state).
+ * - Writes are debounced by `debounceMs` and keyed off the snapshot's
+ *   serialised JSON (not object identity), so a structurally-equal-but-new
+ *   snapshot object doesn't reschedule a write.
+ *
+ * @example
+ *   useRememberedState({
+ *     key: `myapp:tool:${slug}`,
+ *     snapshot: currentSeed,
+ *     restore: (seed) => applySeed(seed),
+ *     skipWhenUrlParam: "restore",
+ *   });
+ */
+declare function useRememberedState<T>({ key, snapshot, restore, enabled, debounceMs, skipWhenUrlParam, }: UseRememberedStateOptions<T>): void;
+
+interface UseLongPressOptions {
+    onLongPress: (e: PointerEvent) => void;
+    /** ms to hold before firing. Default 500. */
+    delayMs?: number;
+    /** Pixels of movement that cancel the press. Default 8. */
+    moveThresholdPx?: number;
+    /** Vibration ms on fire. Default 10. Set 0 to disable. */
+    hapticMs?: number;
+}
+interface UseLongPressResult {
+    onPointerDown: (e: PointerEvent) => void;
+    onPointerMove: (e: PointerEvent) => void;
+    onPointerUp: (e: PointerEvent) => void;
+    onPointerCancel: (e: PointerEvent) => void;
+    /** Spread onto the same element to suppress the trailing click that
+     *  fires after the long-press triggers. Without this, the touch that
+     *  ends the press also opens the hover card or detail panel — double
+     *  action. */
+    onClick: (e: MouseEvent) => void;
+}
+/**
+ * Touch-only long-press hook. On fine-pointer devices (mouse), every
+ * returned handler is a no-op — desktop relies on `onContextMenu` for
+ * right-click instead. The returned event handlers should be spread onto
+ * the target element via `<div {...longPress}>`.
+ *
+ * @param options.onLongPress     - Fired once the press has been held for `delayMs`.
+ * @param options.delayMs         - ms to hold before firing. Default `500`.
+ * @param options.moveThresholdPx - Pixels of movement that cancel the press. Default `8`.
+ * @param options.hapticMs        - Vibration ms on fire (`navigator.vibrate`). Default `10`; `0` disables.
+ *
+ * @example
+ *   const longPress = useLongPress({ onLongPress: (e) => openContextMenu(e) });
+ *   <div {...longPress}>Hold me</div>
+ */
+declare function useLongPress({ onLongPress, delayMs, moveThresholdPx, hapticMs, }: UseLongPressOptions): UseLongPressResult;
+
+interface LiveRegionProps {
+    /** Custom-event name to listen on. Must match the `eventName` passed to `announce()`. Default `DEFAULT_ANNOUNCE_EVENT`. */
+    eventName?: string;
+    /** className applied to both region `<div>`s. Default `"sr-only"` (Tailwind's screen-reader-only utility). */
+    className?: string;
+    /** Milliseconds a message stays in the DOM before self-clearing. Default `6000`. */
+    clearAfterMs?: number;
+}
+/**
+ * Mount once per `eventName` channel (typically once, at the app root).
+ * Renders two visually-hidden `aria-live` regions (`polite` / `assertive`)
+ * that receive text pushed by `announce()` calls dispatched on the same
+ * `eventName`.
+ *
+ * @example
+ *   // root layout
+ *   <LiveRegion />
+ *   // elsewhere in the client tree
+ *   announce("Saved");
+ *
+ * @example
+ *   // namespaced channel — LiveRegion and announce() must agree on eventName
+ *   <LiveRegion eventName="myapp:announce" />
+ *   announce("Saved", "polite", { eventName: "myapp:announce" });
+ */
+declare function LiveRegion({ eventName, className, clearAfterMs, }: LiveRegionProps): React$1.JSX.Element;
+
+interface UseScrollRestoreOptions {
+    /** localStorage key prefix. Callers own their own namespacing. Default `DEFAULT_SCROLL_RESTORE_PREFIX` ("hazo_ui:scrollPos"). */
+    prefix?: string;
+}
+interface UseScrollRestoreResult {
+    /** Persist a scroll position (rounded to the nearest pixel). */
+    save: (scrollY: number) => void;
+    /** Read back the persisted scroll position, or `null` if none / unreadable. */
+    load: () => number | null;
+}
+/**
+ * localStorage-backed scroll-position save/load, keyed by
+ * `${prefix}.${treeId}.${viewName}`. SSR-safe (no-ops when `window` is
+ * undefined) and quota-safe (write failures are swallowed).
+ *
+ * @param treeId   - Identifies the scrollable subject (e.g. a document/tree id).
+ * @param viewName - Identifies which view/pane within that subject.
+ * @param options.prefix - Storage-key prefix. Default `"hazo_ui:scrollPos"`.
+ *
+ * @example
+ *   const { save, load } = useScrollRestore(treeId, "canvas");
+ *   useEffect(() => {
+ *     const y = load();
+ *     if (y !== null) containerRef.current?.scrollTo(0, y);
+ *   }, []);
+ *   const onScroll = (e: React.UIEvent<HTMLDivElement>) => save(e.currentTarget.scrollTop);
+ *
+ * @example
+ *   // namespaced prefix — avoids collisions with other apps sharing a domain
+ *   useScrollRestore(treeId, "canvas", { prefix: "myapp:scrollPos" });
+ */
+declare function useScrollRestore(treeId: string, viewName: string, options?: UseScrollRestoreOptions): UseScrollRestoreResult;
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, AppFooter, type AppFooterProps, AppHeader, type AppHeaderProps, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, CanvasTextToolbar, type CanvasTextToolbarProps, 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 EtaProgressHandle, type FilterConfig, type FilterField, FunnelChart, type FunnelChartProps, type FunnelStep, HazoContextProvider, type HazoContextProviderProps, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, type HazoUiDialogKind, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiEtaProgress, type HazoUiEtaProgressProps, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiIcon, HazoUiIconPicker, type HazoUiIconPickerProps, type HazoUiIconProps, HazoUiImageCropper, HazoUiImageCropperDialog, type HazoUiImageCropperDialogProps, type HazoUiImageCropperHandle, type HazoUiImageCropperProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMemoryDropdown, type HazoUiMemoryDropdownProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiProgressBar, type HazoUiProgressBarProps, 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, InputAffix, type InputAffixProps, 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, LiveRegion, type LiveRegionProps, LoadingTimeout, type LoadingTimeoutProps, type Logger, Logo, type LogoProps, MarkdownEditor, type MarkdownEditorProps, type MarkdownEmbed, type MemoryEntry, NotificationCountBadge, type NotificationCountBadgeProps, NotificationItem, type NotificationItemProps, NotificationPanel, type NotificationPanelProps, type PermissionToastOptions, 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, Slider, 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 UseEtaProgressOptions, type UseFullscreenRefResult, type UseFullscreenResult, type UseLoadingStateResult, type UseLongPressOptions, type UseLongPressResult, type UseRememberedStateOptions, type UseScrollRestoreOptions, type UseScrollRestoreResult, type UseWakeLockResult, applyKanbanFilter, buttonGroupVariants, celebrate, computeEta, create_command_suggestion_extension, easeToward, errorToast, format_num, generateUUID, get_hazo_ui_config, get_logger, isLucideValue, median, parse_commands_from_text, permissionToast, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, set_logger, successToast, text_to_tiptap_content, toggleVariants, upsertEntry as upsertMemoryEntry, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useLongPress, useMediaQuery, useRememberedState, useScrollRestore, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };

package/dist/index.js

@@ -2,7 +2,7 @@
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import * as React27 from 'react';
-import React27__default, { lazy, useRef, useState, useCallback, useEffect, useMemo, Fragment, Suspense } from 'react';
+import React27__default, { lazy, useRef, useState, useCallback, useEffect, useMemo, Fragment, Suspense, useSyncExternalStore } from 'react';
 import { generateRequestId } from 'hazo_core';
 import { withContext, setBrowserCorrelationId } from 'hazo_core/client';
 import { jsx, jsxs, Fragment as Fragment$1 } from 'react/jsx-runtime';
@@ -11874,6 +11874,253 @@ function AppFooter({ variant, footer, identity, className }) {
   );
 }
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AppFooter, AppHeader, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, CanvasTextToolbar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CelebrationProvider, Checkbox, Collapsible, CollapsibleContent2 as CollapsibleContent, CollapsibleTrigger2 as CollapsibleTrigger, CommandNodeExtension, CommandPill, CommandPopover, DateRangeSelector, 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, ErrorBanner, ErrorPage, FunnelChart, HazoContextProvider, HazoUiConfirmDialog, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiEtaProgress, HazoUiFlexInput, HazoUiFlexRadio, HazoUiIcon, HazoUiIconPicker, HazoUiImageCropper, HazoUiImageCropperDialog, HazoUiKanban, HazoUiKanbanFilter, HazoUiMemoryDropdown, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, HazoUiProgressBar, HazoUiRte, HazoUiTable, HazoUiTextarea, HazoUiTextbox, HazoUiToaster, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputAffix, InverseSparkline, Label3 as Label, LoadingTimeout, Logo, MarkdownEditor, NotificationCountBadge, NotificationItem, NotificationPanel, Popover, PopoverContent, PopoverTrigger, ProgressiveImage, RadioGroup, RadioGroupItem, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator3 as Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, Skeleton, SkeletonBar, SkeletonCircle, SkeletonGroup, SkeletonRect, Slider, Sparkline, Spinner, StackedBars, Switch, Table2 as Table, TableBody, TableCaption, TableCell2 as TableCell, TableFooter, TableHead, TableHeader2 as TableHeader, TableRow2 as TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, applyKanbanFilter, buttonGroupVariants, celebrate, cn, computeEta, create_command_suggestion_extension, easeToward, errorToast, format_num, generateUUID, get_hazo_ui_config, get_logger, isLucideValue, median, parse_commands_from_text, permissionToast, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, safeHref, set_hazo_ui_config, set_logger, successToast, text_to_tiptap_content, toggleVariants, upsertEntry as upsertMemoryEntry, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };
+// src/lib/remembered_state.ts
+function readRememberedState(key) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.localStorage.getItem(key);
+    return raw ? JSON.parse(raw) : null;
+  } catch {
+    return null;
+  }
+}
+function writeRememberedState(key, snapshot) {
+  if (typeof window === "undefined") return;
+  try {
+    window.localStorage.setItem(key, JSON.stringify(snapshot));
+  } catch {
+  }
+}
+function hasUrlParam(search, paramName) {
+  try {
+    return new URLSearchParams(search).has(paramName);
+  } catch {
+    return false;
+  }
+}
+
+// src/hooks/use_remembered_state.ts
+function useRememberedState({
+  key,
+  snapshot,
+  restore,
+  enabled = true,
+  debounceMs = 600,
+  skipWhenUrlParam
+}) {
+  const restoreRef = useRef(restore);
+  useEffect(() => {
+    restoreRef.current = restore;
+  });
+  const didRestore = useRef(false);
+  useEffect(() => {
+    if (didRestore.current) return;
+    didRestore.current = true;
+    if (!enabled) return;
+    if (typeof window === "undefined") return;
+    if (skipWhenUrlParam && hasUrlParam(window.location.search, skipWhenUrlParam)) return;
+    const remembered = readRememberedState(key);
+    if (remembered === null) return;
+    try {
+      restoreRef.current(remembered);
+    } catch {
+    }
+  }, [key, enabled, skipWhenUrlParam]);
+  const snapshotJson = JSON.stringify(snapshot);
+  const writeTimer = useRef(null);
+  useEffect(() => {
+    if (!enabled) return;
+    if (writeTimer.current) clearTimeout(writeTimer.current);
+    writeTimer.current = setTimeout(() => {
+      writeRememberedState(key, snapshot);
+    }, debounceMs);
+    return () => {
+      if (writeTimer.current) clearTimeout(writeTimer.current);
+    };
+  }, [key, snapshotJson, enabled, debounceMs]);
+}
+var COARSE_QUERY = "(pointer: coarse)";
+function subscribe_coarse(notify) {
+  if (typeof window === "undefined") return () => {
+  };
+  const mql = window.matchMedia(COARSE_QUERY);
+  mql.addEventListener("change", notify);
+  return () => mql.removeEventListener("change", notify);
+}
+function get_coarse_snapshot() {
+  return window.matchMedia(COARSE_QUERY).matches;
+}
+function get_coarse_server_snapshot() {
+  return false;
+}
+function useLongPress({
+  onLongPress,
+  delayMs = 500,
+  moveThresholdPx = 8,
+  hapticMs = 10
+}) {
+  const isCoarse = useSyncExternalStore(
+    subscribe_coarse,
+    get_coarse_snapshot,
+    get_coarse_server_snapshot
+  );
+  const timerRef = useRef(null);
+  const originRef = useRef(null);
+  const firedRef = useRef(false);
+  const eventRef = useRef(null);
+  const cancel = useCallback(() => {
+    if (timerRef.current !== null) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    originRef.current = null;
+    eventRef.current = null;
+  }, []);
+  useEffect(() => () => cancel(), [cancel]);
+  const noop = useCallback(() => {
+  }, []);
+  const handlePointerDown = useCallback(
+    (e) => {
+      if (originRef.current && originRef.current.pointerId !== e.pointerId) {
+        cancel();
+        return;
+      }
+      firedRef.current = false;
+      originRef.current = { x: e.clientX, y: e.clientY, pointerId: e.pointerId };
+      eventRef.current = e;
+      timerRef.current = setTimeout(() => {
+        timerRef.current = null;
+        firedRef.current = true;
+        if (hapticMs > 0 && typeof navigator !== "undefined" && "vibrate" in navigator) {
+          try {
+            navigator.vibrate?.(hapticMs);
+          } catch {
+          }
+        }
+        const evt = eventRef.current;
+        if (evt) onLongPress(evt);
+      }, delayMs);
+    },
+    [delayMs, hapticMs, cancel, onLongPress]
+  );
+  const handlePointerMove = useCallback(
+    (e) => {
+      if (!originRef.current) return;
+      const dx = e.clientX - originRef.current.x;
+      const dy = e.clientY - originRef.current.y;
+      if (Math.hypot(dx, dy) > moveThresholdPx) cancel();
+    },
+    [moveThresholdPx, cancel]
+  );
+  const handlePointerUpOrCancel = useCallback(() => {
+    cancel();
+  }, [cancel]);
+  const handleClick = useCallback((e) => {
+    if (firedRef.current) {
+      e.preventDefault();
+      e.stopPropagation();
+      firedRef.current = false;
+    }
+  }, []);
+  if (!isCoarse) {
+    return {
+      onPointerDown: noop,
+      onPointerMove: noop,
+      onPointerUp: noop,
+      onPointerCancel: noop,
+      onClick: noop
+    };
+  }
+  return {
+    onPointerDown: handlePointerDown,
+    onPointerMove: handlePointerMove,
+    onPointerUp: handlePointerUpOrCancel,
+    onPointerCancel: handlePointerUpOrCancel,
+    onClick: handleClick
+  };
+}
+
+// src/lib/announce.ts
+var DEFAULT_ANNOUNCE_EVENT = "hazo_ui:announce";
+function announce(message, priority = "polite", options) {
+  if (typeof window === "undefined") return;
+  const trimmed = message.trim();
+  if (!trimmed) return;
+  const eventName = options?.eventName ?? DEFAULT_ANNOUNCE_EVENT;
+  window.dispatchEvent(
+    new CustomEvent(eventName, {
+      detail: { message: trimmed, priority }
+    })
+  );
+}
+function LiveRegion({
+  eventName = DEFAULT_ANNOUNCE_EVENT,
+  className = "sr-only",
+  clearAfterMs = 6e3
+}) {
+  const [polite, set_polite] = useState("");
+  const [assertive, set_assertive] = useState("");
+  const polite_timer = useRef(null);
+  const assertive_timer = useRef(null);
+  useEffect(() => {
+    const handler = (e) => {
+      const detail = e.detail;
+      if (!detail?.message) return;
+      if (detail.priority === "assertive") {
+        if (assertive_timer.current) clearTimeout(assertive_timer.current);
+        set_assertive((prev) => prev === detail.message ? `${detail.message} ` : detail.message);
+        assertive_timer.current = setTimeout(() => set_assertive(""), clearAfterMs);
+      } else {
+        if (polite_timer.current) clearTimeout(polite_timer.current);
+        set_polite((prev) => prev === detail.message ? `${detail.message} ` : detail.message);
+        polite_timer.current = setTimeout(() => set_polite(""), clearAfterMs);
+      }
+    };
+    window.addEventListener(eventName, handler);
+    return () => {
+      window.removeEventListener(eventName, handler);
+      if (polite_timer.current) clearTimeout(polite_timer.current);
+      if (assertive_timer.current) clearTimeout(assertive_timer.current);
+    };
+  }, [eventName, clearAfterMs]);
+  return /* @__PURE__ */ jsxs(Fragment$1, { children: [
+    /* @__PURE__ */ jsx("div", { role: "status", "aria-live": "polite", "aria-atomic": "true", className, children: polite }),
+    /* @__PURE__ */ jsx("div", { role: "alert", "aria-live": "assertive", "aria-atomic": "true", className, children: assertive })
+  ] });
+}
+
+// src/lib/scroll_restore.ts
+var DEFAULT_SCROLL_RESTORE_PREFIX = "hazo_ui:scrollPos";
+function buildScrollRestoreKey(prefix, treeId, viewName) {
+  return `${prefix}.${treeId}.${viewName}`;
+}
+function saveScrollPos(key, scrollY) {
+  if (typeof window === "undefined") return;
+  try {
+    window.localStorage.setItem(key, String(Math.round(scrollY)));
+  } catch {
+  }
+}
+function loadScrollPos(key) {
+  if (typeof window === "undefined") return null;
+  try {
+    const raw = window.localStorage.getItem(key);
+    if (!raw) return null;
+    const n = Number.parseInt(raw, 10);
+    return Number.isFinite(n) ? n : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/hooks/use_scroll_restore.ts
+function useScrollRestore(treeId, viewName, options) {
+  const key = buildScrollRestoreKey(options?.prefix ?? DEFAULT_SCROLL_RESTORE_PREFIX, treeId, viewName);
+  const save = useCallback((scrollY) => saveScrollPos(key, scrollY), [key]);
+  const load = useCallback(() => loadScrollPos(key), [key]);
+  return { save, load };
+}
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AppFooter, AppHeader, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, CanvasTextToolbar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, CelebrationProvider, Checkbox, Collapsible, CollapsibleContent2 as CollapsibleContent, CollapsibleTrigger2 as CollapsibleTrigger, CommandNodeExtension, CommandPill, CommandPopover, DEFAULT_ANNOUNCE_EVENT, DateRangeSelector, 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, ErrorBanner, ErrorPage, FunnelChart, HazoContextProvider, HazoUiConfirmDialog, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiEtaProgress, HazoUiFlexInput, HazoUiFlexRadio, HazoUiIcon, HazoUiIconPicker, HazoUiImageCropper, HazoUiImageCropperDialog, HazoUiKanban, HazoUiKanbanFilter, HazoUiMemoryDropdown, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, HazoUiProgressBar, HazoUiRte, HazoUiTable, HazoUiTextarea, HazoUiTextbox, HazoUiToaster, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputAffix, InverseSparkline, Label3 as Label, LiveRegion, LoadingTimeout, Logo, MarkdownEditor, NotificationCountBadge, NotificationItem, NotificationPanel, Popover, PopoverContent, PopoverTrigger, ProgressiveImage, RadioGroup, RadioGroupItem, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator3 as Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, Skeleton, SkeletonBar, SkeletonCircle, SkeletonGroup, SkeletonRect, Slider, Sparkline, Spinner, StackedBars, Switch, Table2 as Table, TableBody, TableCaption, TableCell2 as TableCell, TableFooter, TableHead, TableHeader2 as TableHeader, TableRow2 as TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, announce, applyKanbanFilter, buttonGroupVariants, celebrate, cn, computeEta, create_command_suggestion_extension, easeToward, errorToast, format_num, generateUUID, get_hazo_ui_config, get_logger, hasUrlParam, isLucideValue, median, parse_commands_from_text, permissionToast, pick_x_label_indices, readRememberedState, reset_hazo_ui_config, resolve_animation_classes, safeHref, set_hazo_ui_config, set_logger, successToast, text_to_tiptap_content, toggleVariants, upsertEntry as upsertMemoryEntry, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useLongPress, useMediaQuery, useRememberedState, useScrollRestore, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock, writeRememberedState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map