hazo_ui 4.1.1 → 4.3.0

package/dist/index.d.cts

@@ -1,7 +1,6 @@
 export { cn } from './index.utils.cjs';
 import * as React$1 from 'react';
 import { ReactNode, RefObject } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ICommand } from '@uiw/react-md-editor';
 export { ICommand as MarkdownEditorCommand } from '@uiw/react-md-editor';
 import { Node, Extension } from '@tiptap/core';
@@ -220,7 +219,7 @@ interface HazoUiMultiFilterDialogProps {
     clearButtonTextColor?: string;
     clearButtonBorderColor?: string;
 }
-declare function HazoUiMultiFilterDialog({ availableFields, onFilterChange, initialFilters, title, description, headerBackgroundColor, headerTextColor, submitButtonBackgroundColor, submitButtonTextColor, cancelButtonBackgroundColor, cancelButtonTextColor, cancelButtonBorderColor, clearButtonBackgroundColor, clearButtonTextColor, clearButtonBorderColor, }: HazoUiMultiFilterDialogProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiMultiFilterDialog({ availableFields, onFilterChange, initialFilters, title, description, headerBackgroundColor, headerTextColor, submitButtonBackgroundColor, submitButtonTextColor, cancelButtonBackgroundColor, cancelButtonTextColor, cancelButtonBorderColor, clearButtonBackgroundColor, clearButtonTextColor, clearButtonBorderColor, }: HazoUiMultiFilterDialogProps): React$1.JSX.Element;
 
 interface SortField {
     value: string;
@@ -247,7 +246,7 @@ interface HazoUiMultiSortDialogProps {
     clearButtonTextColor?: string;
     clearButtonBorderColor?: string;
 }
-declare function HazoUiMultiSortDialog({ availableFields, onSortChange, initialSortFields, title, description, headerBackgroundColor, headerTextColor, submitButtonBackgroundColor, submitButtonTextColor, cancelButtonBackgroundColor, cancelButtonTextColor, cancelButtonBorderColor, clearButtonBackgroundColor, clearButtonTextColor, clearButtonBorderColor, }: HazoUiMultiSortDialogProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiMultiSortDialog({ availableFields, onSortChange, initialSortFields, title, description, headerBackgroundColor, headerTextColor, submitButtonBackgroundColor, submitButtonTextColor, cancelButtonBackgroundColor, cancelButtonTextColor, cancelButtonBorderColor, clearButtonBackgroundColor, clearButtonTextColor, clearButtonBorderColor, }: HazoUiMultiSortDialogProps): React$1.JSX.Element;
 
 interface HazoUiFlexRadioItem {
     label: string;
@@ -273,7 +272,7 @@ interface HazoUiFlexRadioProps {
  * Hazo UI Flex Radio Component
  * Supports single and multi-selection with radio buttons or icons
  */
-declare function HazoUiFlexRadio({ layout, style, display_label, icon_set, data, selection, value, onChange, className, compressed, }: HazoUiFlexRadioProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiFlexRadio({ layout, style, display_label, icon_set, data, selection, value, onChange, className, compressed, }: HazoUiFlexRadioProps): React$1.JSX.Element;
 
 interface HazoUiPillRadioItem {
     label: string;
@@ -291,7 +290,7 @@ interface HazoUiPillRadioProps {
     pill_size?: "sm" | "md" | "lg";
     equal_width?: boolean;
 }
-declare function HazoUiPillRadio({ layout, icon_set, data, value, onChange, className, pill_size, equal_width, }: HazoUiPillRadioProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiPillRadio({ layout, icon_set, data, value, onChange, className, pill_size, equal_width, }: HazoUiPillRadioProps): React$1.JSX.Element;
 
 interface InputProps extends React$1.InputHTMLAttributes<HTMLInputElement> {
 }
@@ -424,7 +423,7 @@ interface MarkdownEditorProps {
     /** Whether the custom preview pane is visible. Default true (when renderPreview set). */
     showPreview?: boolean;
 }
-declare function MarkdownEditor({ value, onChange, height, placeholder, className, colorMode, preview, embeds, extraCommands, onImageUpload, renderPreview, showPreview, }: MarkdownEditorProps): react_jsx_runtime.JSX.Element;
+declare function MarkdownEditor({ value, onChange, height, placeholder, className, colorMode, preview, embeds, extraCommands, onImageUpload, renderPreview, showPreview, }: MarkdownEditorProps): React$1.JSX.Element;
 declare namespace MarkdownEditor {
     var displayName: string;
 }
@@ -830,6 +829,19 @@ declare const ANIMATION_PRESETS: Record<AnimationPreset, {
  */
 declare function resolve_animation_classes(open_anim?: AnimationPreset | string, close_anim?: AnimationPreset | string): string;
 
+/**
+ * hazo_ui_dialog/index.tsx
+ *
+ * Purpose: Standardized, reusable dialog component built on shadcn's Dialog primitive
+ * Features:
+ * - Standardized header and footer layout
+ * - Customizable content area
+ * - Flexible animation system (presets + custom)
+ * - Responsive sizing (viewport-relative up to limits)
+ * - Background overlay customization
+ * - CSS variable-based theming
+ */
+
 type ButtonVariant = "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
 type DialogVariant = 'default' | 'info' | 'success' | 'warning' | 'destructive';
 interface HazoUiDialogProps {
@@ -904,7 +916,21 @@ interface HazoUiDialogProps {
  *
  * A flexible dialog component with standardized layout and customizable behavior
  */
-declare function HazoUiDialog({ open, onOpenChange, children, onConfirm, onCancel, title, description, actionButtonText, actionButtonVariant, cancelButtonText, showCancelButton, actionButtonLoading, actionButtonDisabled, actionButtonIcon, footerContent, sizeWidth, sizeHeight, fixedSize, openAnimation, closeAnimation, variant, splitHeader, headerBackgroundColor, descriptionBackgroundColor, headerTextColor, bodyBackgroundColor, footerBackgroundColor, borderColor, accentColor, headerBar, headerBarColor, className, contentClassName, overlayClassName, headerClassName, footerClassName, showCloseButton, }: HazoUiDialogProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiDialog({ open, onOpenChange, children, onConfirm, onCancel, title, description, actionButtonText, actionButtonVariant, cancelButtonText, showCancelButton, actionButtonLoading, actionButtonDisabled, actionButtonIcon, footerContent, sizeWidth, sizeHeight, fixedSize, openAnimation, closeAnimation, variant, splitHeader, headerBackgroundColor, descriptionBackgroundColor, headerTextColor, bodyBackgroundColor, footerBackgroundColor, borderColor, accentColor, headerBar, headerBarColor, className, contentClassName, overlayClassName, headerClassName, footerClassName, showCloseButton, }: HazoUiDialogProps): React$1.JSX.Element;
+
+/**
+ * hazo_ui_confirm_dialog/index.tsx
+ *
+ * Purpose: Compact, opinionated confirmation dialog for confirmations,
+ * acknowledgments, and destructive action prompts.
+ * Features:
+ * - Accent top border colored by variant
+ * - Variant system (default, destructive, warning, info, success)
+ * - Async onConfirm with auto-loading state
+ * - Configurable buttons (confirm + optional cancel)
+ * - ReactNode children or simple description string
+ * - Integrates with hazo_ui_config for theming
+ */
 
 type ConfirmDialogVariant = 'default' | 'destructive' | 'warning' | 'info' | 'success';
 interface HazoUiConfirmDialogProps {
@@ -932,7 +958,89 @@ interface HazoUiConfirmDialogProps {
  * A compact, opinionated confirmation dialog with variant-driven styling,
  * accent top border, and async loading support.
  */
-declare function HazoUiConfirmDialog({ open, onOpenChange, title, description, children, variant, confirmLabel, cancelLabel, showCancelButton, onConfirm, onCancel, loading: external_loading, disabled, accentColor, confirmButtonColor, openAnimation, closeAnimation, }: HazoUiConfirmDialogProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiConfirmDialog({ open, onOpenChange, title, description, children, variant, confirmLabel, cancelLabel, showCancelButton, onConfirm, onCancel, loading: external_loading, disabled, accentColor, confirmButtonColor, openAnimation, closeAnimation, }: HazoUiConfirmDialogProps): React$1.JSX.Element;
+
+/**
+ * hazo_ui_image_cropper/index.tsx
+ *
+ * Purpose: Round profile-photo cropper with pan/zoom, outputs a 512×512 WebP Blob.
+ * Wraps react-easy-crop with a Slider for zoom control and exposes an imperative
+ * handle so parent components can trigger blob production on demand.
+ */
+
+/** Imperative handle exposed via forwardRef for on-demand blob production. */
+interface HazoUiImageCropperHandle {
+    /** Produces the cropped WebP blob using the current pan/zoom state. */
+    getCroppedBlob: () => Promise<Blob>;
+}
+interface HazoUiImageCropperProps {
+    /** URL or object URL of the source image to crop. */
+    imageSrc: string;
+    /**
+     * Optional callback invoked after the blob is produced.
+     * The dialog wrapper uses the imperative handle instead, but direct consumers
+     * can wire this for convenience.
+     */
+    onCropped?: (blob: Blob) => void | Promise<void>;
+    /** Output canvas size in pixels (width = height). Defaults to 512. */
+    outputSize?: number;
+    /** WebP quality 0–1. Defaults to 0.9. */
+    quality?: number;
+    /** Label for the zoom slider — pass a translated string. Defaults to "Zoom". */
+    zoomLabel?: string;
+    /** Additional className for the root container. */
+    className?: string;
+}
+/**
+ * HazoUiImageCropper
+ *
+ * Round profile-photo cropper with pan/zoom support.
+ * Accepts a `ref` that exposes `getCroppedBlob()` for on-demand production.
+ */
+declare const HazoUiImageCropper: React$1.ForwardRefExoticComponent<HazoUiImageCropperProps & React$1.RefAttributes<HazoUiImageCropperHandle>>;
+
+/**
+ * hazo_ui_image_cropper_dialog/index.tsx
+ *
+ * Purpose: Dialog wrapper around HazoUiImageCropper.
+ * Manages a File → object URL lifecycle, triggers crop on Confirm,
+ * and exposes all string labels as props so consuming apps can pass
+ * translated strings without requiring next-intl in this package.
+ */
+
+interface HazoUiImageCropperDialogProps {
+    /** Whether the dialog is open. */
+    open: boolean;
+    /** Called when the dialog open state should change. */
+    onOpenChange: (open: boolean) => void;
+    /** The File to crop. Pass null to close / clear the dialog. */
+    file: File | null;
+    /** Called with the resulting WebP Blob when the user confirms. */
+    onConfirm: (blob: Blob) => void | Promise<void>;
+    /** Called when the user cancels (before the dialog closes). */
+    onCancel?: () => void;
+    /** Dialog title. Defaults to "Crop photo". */
+    title?: string;
+    /** Confirm/Save button label. Defaults to "Save". */
+    confirmLabel?: string;
+    /** Cancel button label. Defaults to "Cancel". */
+    cancelLabel?: string;
+    /** Zoom slider label. Defaults to "Zoom". */
+    zoomLabel?: string;
+    /** Output canvas size in pixels (width = height). Defaults to 512. */
+    outputSize?: number;
+    /** WebP quality 0–1. Defaults to 0.9. */
+    quality?: number;
+}
+/**
+ * HazoUiImageCropperDialog
+ *
+ * Wraps HazoUiImageCropper inside HazoUiDialog. The Confirm button calls the
+ * cropper's imperative `getCroppedBlob()`, passes the blob to `onConfirm`,
+ * then closes the dialog. `actionButtonLoading` is set while the blob is being
+ * produced to prevent double-clicks.
+ */
+declare function HazoUiImageCropperDialog({ open, onOpenChange, file, onConfirm, onCancel, title, confirmLabel, cancelLabel, zoomLabel, outputSize, quality, }: HazoUiImageCropperDialogProps): React$1.JSX.Element;
 
 declare const Dialog: React$1.FC<DialogPrimitive.DialogProps>;
 declare const DialogTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -941,18 +1049,18 @@ declare const DialogClose: React$1.ForwardRefExoticComponent<DialogPrimitive.Dia
 declare const DialogOverlay: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogContent: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DialogHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
     displayName: string;
 };
 declare const DialogFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
     displayName: string;
 };
 declare const DialogTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
 declare const DialogDescription: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & React$1.RefAttributes<HTMLParagraphElement>, "ref"> & React$1.RefAttributes<HTMLParagraphElement>>;
 
 declare const Drawer: {
-    ({ shouldScaleBackground, ...props }: React$1.ComponentProps<typeof Drawer$1.Root>): react_jsx_runtime.JSX.Element;
+    ({ shouldScaleBackground, ...props }: React$1.ComponentProps<typeof Drawer$1.Root>): React$1.JSX.Element;
     displayName: string;
 };
 declare const DrawerTrigger: React$1.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
@@ -961,11 +1069,11 @@ declare const DrawerClose: React$1.ForwardRefExoticComponent<DialogPrimitive.Dia
 declare const DrawerOverlay: React$1.ForwardRefExoticComponent<Omit<Omit<DialogPrimitive.DialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DrawerContent: React$1.ForwardRefExoticComponent<Omit<Omit<DialogPrimitive.DialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DrawerHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
     displayName: string;
 };
 declare const DrawerFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
     displayName: string;
 };
 declare const DrawerTitle: React$1.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
@@ -999,7 +1107,7 @@ interface ButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement>, V
 declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
 
 type CalendarProps = React$1.ComponentProps<typeof DayPicker>;
-declare function Calendar({ className, classNames, showOutsideDays, ...props }: CalendarProps): react_jsx_runtime.JSX.Element;
+declare function Calendar({ className, classNames, showOutsideDays, ...props }: CalendarProps): React$1.JSX.Element;
 declare namespace Calendar {
     var displayName: string;
 }
@@ -1042,7 +1150,7 @@ declare const DropdownMenuLabel: React$1.ForwardRefExoticComponent<Omit<Dropdown
 } & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuSeparator: React$1.ForwardRefExoticComponent<Omit<DropdownMenuPrimitive.DropdownMenuSeparatorProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const DropdownMenuShortcut: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLSpanElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLSpanElement>): React$1.JSX.Element;
     displayName: string;
 };
 
@@ -1113,7 +1221,7 @@ interface SpinnerProps {
     className?: string;
     size?: "sm" | "md" | "lg";
 }
-declare function Spinner({ className, size }: SpinnerProps): react_jsx_runtime.JSX.Element;
+declare function Spinner({ className, size }: SpinnerProps): React$1.JSX.Element;
 
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
@@ -1139,11 +1247,11 @@ declare const AlertDialogPortal: React$1.FC<AlertDialogPrimitive.AlertDialogPort
 declare const AlertDialogOverlay: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogOverlayProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const AlertDialogContent: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogContentProps & React$1.RefAttributes<HTMLDivElement>, "ref"> & React$1.RefAttributes<HTMLDivElement>>;
 declare const AlertDialogHeader: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
     displayName: string;
 };
 declare const AlertDialogFooter: {
-    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): react_jsx_runtime.JSX.Element;
+    ({ className, ...props }: React$1.HTMLAttributes<HTMLDivElement>): React$1.JSX.Element;
     displayName: string;
 };
 declare const AlertDialogTitle: React$1.ForwardRefExoticComponent<Omit<AlertDialogPrimitive.AlertDialogTitleProps & React$1.RefAttributes<HTMLHeadingElement>, "ref"> & React$1.RefAttributes<HTMLHeadingElement>>;
@@ -1154,11 +1262,11 @@ declare const AlertDialogCancel: React$1.ForwardRefExoticComponent<Omit<AlertDia
 declare const buttonGroupVariants: (props?: ({
     orientation?: "horizontal" | "vertical" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
-declare function ButtonGroup({ className, orientation, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>): react_jsx_runtime.JSX.Element;
+declare function ButtonGroup({ className, orientation, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>): React$1.JSX.Element;
 declare function ButtonGroupText({ className, asChild, ...props }: React$1.ComponentProps<"div"> & {
     asChild?: boolean;
-}): react_jsx_runtime.JSX.Element;
-declare function ButtonGroupSeparator({ className, orientation, ...props }: React$1.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
+}): React$1.JSX.Element;
+declare function ButtonGroupSeparator({ className, orientation, ...props }: React$1.ComponentProps<typeof Separator>): React$1.JSX.Element;
 
 declare const Slider: React$1.ForwardRefExoticComponent<Omit<SliderPrimitive.SliderProps & React$1.RefAttributes<HTMLSpanElement>, "ref"> & React$1.RefAttributes<HTMLSpanElement>>;
 
@@ -1178,7 +1286,7 @@ interface SkeletonCircleProps {
     size?: number;
     className?: string;
 }
-declare function SkeletonCircle({ size, className }: SkeletonCircleProps): react_jsx_runtime.JSX.Element;
+declare function SkeletonCircle({ size, className }: SkeletonCircleProps): React$1.JSX.Element;
 interface SkeletonBarProps {
     /** CSS width — accepts px (number) or any CSS length string. Default "100%". */
     width?: number | string;
@@ -1186,7 +1294,7 @@ interface SkeletonBarProps {
     height?: number;
     className?: string;
 }
-declare function SkeletonBar({ width, height, className }: SkeletonBarProps): react_jsx_runtime.JSX.Element;
+declare function SkeletonBar({ width, height, className }: SkeletonBarProps): React$1.JSX.Element;
 interface SkeletonRectProps {
     width?: number | string;
     height?: number | string;
@@ -1194,13 +1302,13 @@ interface SkeletonRectProps {
     radius?: number | string;
     className?: string;
 }
-declare function SkeletonRect({ width, height, radius, className }: SkeletonRectProps): react_jsx_runtime.JSX.Element;
+declare function SkeletonRect({ width, height, radius, className }: SkeletonRectProps): React$1.JSX.Element;
 interface SkeletonGroupProps extends React$1.HTMLAttributes<HTMLDivElement> {
     /** Optional `aria-label` for the loading region. Default "Loading content". */
     label?: string;
     children: React$1.ReactNode;
 }
-declare function SkeletonGroup({ label, children, className, ...rest }: SkeletonGroupProps): react_jsx_runtime.JSX.Element;
+declare function SkeletonGroup({ label, children, className, ...rest }: SkeletonGroupProps): React$1.JSX.Element;
 
 interface EmptyStateProps {
     /** Icon element. Recommended size 48x48. Wrap a lucide icon in a div if you want background styling. */
@@ -1215,7 +1323,7 @@ interface EmptyStateProps {
     size?: "sm" | "md" | "lg";
     className?: string;
 }
-declare function EmptyState({ icon, title, description, action, size, className, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+declare function EmptyState({ icon, title, description, action, size, className, }: EmptyStateProps): React$1.JSX.Element;
 
 type ErrorBannerSeverity = "warning" | "error";
 interface ErrorBannerProps {
@@ -1233,7 +1341,7 @@ interface ErrorBannerProps {
     onDismiss?: () => void;
     className?: string;
 }
-declare function ErrorBanner({ severity, title, message, icon, action, onDismiss, className, }: ErrorBannerProps): react_jsx_runtime.JSX.Element;
+declare function ErrorBanner({ severity, title, message, icon, action, onDismiss, className, }: ErrorBannerProps): React$1.JSX.Element;
 
 interface ErrorPageProps {
     /** Defaults to "Something went wrong". */
@@ -1250,7 +1358,7 @@ interface ErrorPageProps {
     illustration?: React$1.ReactNode;
     className?: string;
 }
-declare function ErrorPage({ title, description, errorCode, correlationId, actions, illustration, className, }: ErrorPageProps): react_jsx_runtime.JSX.Element;
+declare function ErrorPage({ title, description, errorCode, correlationId, actions, illustration, className, }: ErrorPageProps): React$1.JSX.Element;
 
 interface LoadingTimeoutProps {
     /** When true, the timeout runs and escalation states render. When false, renders children. */
@@ -1271,7 +1379,7 @@ interface LoadingTimeoutProps {
     label?: string;
     className?: string;
 }
-declare function LoadingTimeout({ active, children, skeleton, onRetry, thresholds, label, className, }: LoadingTimeoutProps): react_jsx_runtime.JSX.Element;
+declare function LoadingTimeout({ active, children, skeleton, onRetry, thresholds, label, className, }: LoadingTimeoutProps): React$1.JSX.Element;
 
 interface ProgressiveImageProps {
     /** Required final image src. */
@@ -1292,7 +1400,47 @@ interface ProgressiveImageProps {
     onLoad?: () => void;
     onError?: () => void;
 }
-declare function ProgressiveImage({ src, alt, lqip, width, height, loading, fit, className, onLoad, onError, }: ProgressiveImageProps): react_jsx_runtime.JSX.Element;
+declare function ProgressiveImage({ src, alt, lqip, width, height, loading, fit, className, onLoad, onError, }: ProgressiveImageProps): React$1.JSX.Element;
+
+interface NotificationCountBadgeProps {
+    count: number;
+    /** Default 9. Shows "N+" when count exceeds this value. */
+    max?: number;
+    className?: string;
+}
+declare function NotificationCountBadge({ count, max, className, }: NotificationCountBadgeProps): React$1.ReactElement | null;
+
+interface NotificationItemProps {
+    isRead: boolean;
+    /** Pre-formatted relative timestamp, e.g. "2 hours ago". */
+    timestamp: string;
+    /** Message content. */
+    children: React$1.ReactNode;
+    /** Domain action buttons rendered below the message. */
+    actions?: React$1.ReactNode;
+    onClick?: () => void;
+    onContextMenu?: React$1.MouseEventHandler<HTMLDivElement>;
+    /** When provided AND !isRead, renders the "mark read" link. */
+    onMarkRead?: () => void;
+    /** Label for the mark-read button, e.g. "Mark read". */
+    markReadLabel: string;
+}
+declare function NotificationItem({ isRead, timestamp, children, actions, onClick, onContextMenu, onMarkRead, markReadLabel, }: NotificationItemProps): React$1.JSX.Element;
+
+interface NotificationPanelProps {
+    /** NotificationItem rows. */
+    children: React$1.ReactNode;
+    /** When provided, renders the "Mark all as read" footer button. */
+    onMarkAllRead?: () => void;
+    /** Label for the mark-all-read button, e.g. "Mark all as read". */
+    markAllReadLabel: string;
+    /** Rendered when there are no children and loading is false. */
+    emptyState?: React$1.ReactNode;
+    /** Shows skeleton loading rows when true. */
+    loading?: boolean;
+    className?: string;
+}
+declare function NotificationPanel({ children, onMarkAllRead, markAllReadLabel, emptyState, loading, className, }: NotificationPanelProps): React$1.JSX.Element;
 
 interface HazoUiToasterProps {
     /** Position of the toast stack. Default "bottom-right". */
@@ -1302,7 +1450,7 @@ interface HazoUiToasterProps {
     /** Max number of toasts visible at once. Default 5. */
     visibleToasts?: number;
 }
-declare function HazoUiToaster({ position, closeButton, visibleToasts, }?: HazoUiToasterProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiToaster({ position, closeButton, visibleToasts, }?: HazoUiToasterProps): React$1.JSX.Element;
 interface ToastOptions {
     title: string;
     description?: string;
@@ -1772,7 +1920,15 @@ interface KanbanSaveEvent<T extends KanbanItem = KanbanItem> {
     next: T;
 }
 
-declare function HazoUiKanbanFilter({ search, searchPlaceholder, categories, priorities, value, defaultValue, onChange, className, }: HazoUiKanbanFilterProps): react_jsx_runtime.JSX.Element;
+/**
+ * HazoUiKanbanFilter - controlled-or-uncontrolled filter bar
+ *
+ * Decoupled from HazoUiKanban. Emits KanbanFilterValue via onChange; consumer
+ * applies it to their items (typically via applyKanbanFilter) before passing
+ * to the board.
+ */
+
+declare function HazoUiKanbanFilter({ search, searchPlaceholder, categories, priorities, value, defaultValue, onChange, className, }: HazoUiKanbanFilterProps): React$1.JSX.Element;
 
 /**
  * Pure helper: filters KanbanItem[] by search / categories / priority.
@@ -1787,7 +1943,21 @@ declare function HazoUiKanbanFilter({ search, searchPlaceholder, categories, pri
 
 declare function applyKanbanFilter<T extends KanbanItem>(items: T[], filter: KanbanFilterValue): T[];
 
-declare function HazoUiKanban<T extends KanbanItem = KanbanItem>({ columns, items, renderCard, onMove, onReorder, mobileBreakpoint, announcements, emptyColumn, className, cardClassName, itemLabel, editorFields, editorPriorities, editorTitle, renderCardEditor, hideEditorFooter, onCardSave, disableEdit, }: HazoUiKanbanProps<T>): react_jsx_runtime.JSX.Element;
+/**
+ * HazoUiKanban - drag-drop kanban primitive
+ *
+ * Wraps @dnd-kit/core + @dnd-kit/sortable. Consumers see only HazoUi*
+ * types — no @dnd-kit types leak through the public surface.
+ *
+ * State model: controlled `items` + library overlay. The consumer owns
+ * the `items` array. While a drag is being committed (e.g. an async
+ * PATCH), the library tracks an "overlay" position internally so the
+ * card moves immediately. On commit, the consumer updates `items` and
+ * the overlay clears naturally. On failure, the consumer calls
+ * event.revert() and the overlay entry is dropped.
+ */
+
+declare function HazoUiKanban<T extends KanbanItem = KanbanItem>({ columns, items, renderCard, onMove, onReorder, mobileBreakpoint, announcements, emptyColumn, className, cardClassName, itemLabel, editorFields, editorPriorities, editorTitle, renderCardEditor, hideEditorFooter, onCardSave, disableEdit, }: HazoUiKanbanProps<T>): React$1.JSX.Element;
 
 declare const Table: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableElement> & React$1.RefAttributes<HTMLTableElement>>;
 declare const TableHeader: React$1.ForwardRefExoticComponent<React$1.HTMLAttributes<HTMLTableSectionElement> & React$1.RefAttributes<HTMLTableSectionElement>>;
@@ -1889,7 +2059,15 @@ interface HazoUiTableProps<TRow extends object = any> {
     caption?: string;
 }
 
-declare function HazoUiTable<TRow extends object = any>(props: HazoUiTableProps<TRow>): react_jsx_runtime.JSX.Element;
+/**
+ * HazoUiTable — column-config-driven data table.
+ *
+ * Composes the shadcn Table primitive family with the in-memory
+ * filter/sort/paginate pipeline from use_table_state, and (in later
+ * tasks) the existing HazoUiMultiSortDialog / HazoUiMultiFilterDialog.
+ */
+
+declare function HazoUiTable<TRow extends object = any>(props: HazoUiTableProps<TRow>): React$1.JSX.Element;
 
 /**
  * Public types for hazo_ui_charts. Keep dependency-free so consumers can
@@ -2070,6 +2248,19 @@ declare function format_num(n: number | null | undefined | string): string;
  */
 declare function pick_x_label_indices(length: number): [number, number, number];
 
+/**
+ * hazo_ui_celebration/index.tsx
+ *
+ * CelebrationModal: imperative confetti + modal overlay with optional shareable card.
+ * Mount <CelebrationProvider /> once at root, then call celebrate({ ... }) from anywhere.
+ *
+ * Session gating: each id is written to sessionStorage (hazo_ui_celebration_<id>) when
+ * shown. Duplicate calls with the same id within the session are no-ops.
+ * Cross-session gating is the consumer's responsibility.
+ *
+ * Queue policy: FIFO. Gating runs at call time (before enqueue), not at display time.
+ */
+
 /** Default gradient for the shareable card background. Override via shareableCard.background. */
 declare const CELEBRATION_GRADIENT = "linear-gradient(135deg, #667eea 0%, #764ba2 100%)";
 interface CelebrationShareableCard {
@@ -2118,7 +2309,7 @@ interface CelebrationProviderProps {
  * Mount once near the root of your app (e.g. (app)/layout.tsx).
  * Renders the current celebration modal and manages the FIFO queue.
  */
-declare function CelebrationProvider({ children }: CelebrationProviderProps): react_jsx_runtime.JSX.Element;
+declare function CelebrationProvider({ children }: CelebrationProviderProps): React$1.JSX.Element;
 
 /**
  * Pure ETA estimation helpers — no React, no I/O, fully unit-testable.
@@ -2188,7 +2379,7 @@ interface HazoUiProgressBarProps {
  * Zero logic — accepts a 0..1 value and renders the fill.
  * Safe to use standalone without any ETA or state machinery.
  */
-declare function HazoUiProgressBar({ value, label, showPercent, size, className, }: HazoUiProgressBarProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiProgressBar({ value, label, showPercent, size, className, }: HazoUiProgressBarProps): React$1.JSX.Element;
 /**
  * Headless hook — ETA estimation + animation core.
  *
@@ -2236,6 +2427,6 @@ interface HazoUiEtaProgressProps {
  * // In effect: handle.current?.start(); ... handle.current?.finish();
  * ```
  */
-declare function HazoUiEtaProgress({ estimateKey, unitCount, concurrency, windowSize, fallbackUnitMs, level, label, endpoint, handleRef, className, }: HazoUiEtaProgressProps): react_jsx_runtime.JSX.Element;
+declare function HazoUiEtaProgress({ estimateKey, unitCount, concurrency, windowSize, fallbackUnitMs, level, label, endpoint, handleRef, className, }: HazoUiEtaProgressProps): React$1.JSX.Element;
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CelebrationPayload, CelebrationProvider, type CelebrationProviderProps, type CelebrationShareableCard, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorBannerSeverity, ErrorPage, type ErrorPageProps, type 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, 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, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, 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, MarkdownEditor, type MarkdownEditorProps, type MarkdownEmbed, 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, 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, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CELEBRATION_GRADIENT, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type CelebrationPayload, CelebrationProvider, type CelebrationProviderProps, type CelebrationShareableCard, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorBannerSeverity, ErrorPage, type ErrorPageProps, type 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, 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, HazoUiImageCropper, HazoUiImageCropperDialog, type HazoUiImageCropperDialogProps, type HazoUiImageCropperHandle, type HazoUiImageCropperProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, 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, MarkdownEditor, type MarkdownEditorProps, type MarkdownEmbed, 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, 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, useClickOutside, useCopyToClipboard, useDebounce, useErrorDisplay, useEtaProgress, useFullscreen, useIsMobile, useLoadingState, useLocalStorage, useMediaQuery, useSessionStorage, useViewport, useWakeLock, use_fullscreen, use_wake_lock };