hazo_ui 6.0.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';
@@ -1618,6 +1618,25 @@ interface ToastOptions {
 }
 declare function successToast({ title, description, duration, action }: ToastOptions): string | number;
 declare function errorToast({ title, description, duration, action }: ToastOptions): string | number;
+interface PermissionToastOptions {
+    /** The permission keys that were missing, e.g. ["env.migrate"]. */
+    missingPermissions: string[];
+    /** Optional human descriptions keyed by permission key, e.g. { "env.migrate": "Migrate environments" }. */
+    descriptions?: Record<string, string>;
+    /** Optional action button (e.g. "Request access"). */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Auto-dismiss duration in ms. Default 5000 (matches errorToast). */
+    duration?: number;
+}
+/**
+ * Standardized permission-failure toast. Renders a fixed "Permission required"
+ * title and composes a description listing the missing permission key(s),
+ * with an optional human description per key. Delegates to `errorToast`.
+ */
+declare function permissionToast({ missingPermissions, descriptions, action, duration, }: PermissionToastOptions): string | number;
 
 interface UseLoadingStateResult {
     /** Current loading flag. */
@@ -2699,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, 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, 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';
@@ -1618,6 +1618,25 @@ interface ToastOptions {
 }
 declare function successToast({ title, description, duration, action }: ToastOptions): string | number;
 declare function errorToast({ title, description, duration, action }: ToastOptions): string | number;
+interface PermissionToastOptions {
+    /** The permission keys that were missing, e.g. ["env.migrate"]. */
+    missingPermissions: string[];
+    /** Optional human descriptions keyed by permission key, e.g. { "env.migrate": "Migrate environments" }. */
+    descriptions?: Record<string, string>;
+    /** Optional action button (e.g. "Request access"). */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+    /** Auto-dismiss duration in ms. Default 5000 (matches errorToast). */
+    duration?: number;
+}
+/**
+ * Standardized permission-failure toast. Renders a fixed "Permission required"
+ * title and composes a description listing the missing permission key(s),
+ * with an optional human description per key. Delegates to `errorToast`.
+ */
+declare function permissionToast({ missingPermissions, descriptions, action, duration, }: PermissionToastOptions): string | number;
 
 interface UseLoadingStateResult {
     /** Current loading flag. */
@@ -2699,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, 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, 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 };