hazo_ui 2.9.0 → 2.16.0

package/dist/index.d.cts

@@ -23,6 +23,7 @@ import * as ScrollAreaPrimitive from '@radix-ui/react-scroll-area';
 import * as TogglePrimitive from '@radix-ui/react-toggle';
 import * as ToggleGroupPrimitive from '@radix-ui/react-toggle-group';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
+export { toast as rawToast } from 'sonner';
 
 /**
  * hazo_ui_config.ts
@@ -1003,4 +1004,536 @@ declare function ButtonGroupText({ className, asChild, ...props }: React.Compone
 }): react_jsx_runtime.JSX.Element;
 declare function ButtonGroupSeparator({ className, orientation, ...props }: React.ComponentProps<typeof Separator>): react_jsx_runtime.JSX.Element;
 
-export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, Label, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, type SortConfig, type SortField, Spinner, type SuggestionState, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, buttonGroupVariants, create_command_suggestion_extension, get_hazo_ui_config, parse_commands_from_text, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, text_to_tiptap_content, toggleVariants, useMediaQuery };
+interface SkeletonBaseProps extends React.HTMLAttributes<HTMLDivElement> {
+    className?: string;
+}
+declare const Skeleton: React.ForwardRefExoticComponent<SkeletonBaseProps & React.RefAttributes<HTMLDivElement>>;
+interface SkeletonCircleProps {
+    /** Diameter in px. Default 40. */
+    size?: number;
+    className?: string;
+}
+declare function SkeletonCircle({ size, className }: SkeletonCircleProps): react_jsx_runtime.JSX.Element;
+interface SkeletonBarProps {
+    /** CSS width — accepts px (number) or any CSS length string. Default "100%". */
+    width?: number | string;
+    /** Height in px. Default 12. */
+    height?: number;
+    className?: string;
+}
+declare function SkeletonBar({ width, height, className }: SkeletonBarProps): react_jsx_runtime.JSX.Element;
+interface SkeletonRectProps {
+    width?: number | string;
+    height?: number | string;
+    /** CSS border-radius. Default 6 (matches rounded-md). */
+    radius?: number | string;
+    className?: string;
+}
+declare function SkeletonRect({ width, height, radius, className }: SkeletonRectProps): react_jsx_runtime.JSX.Element;
+interface SkeletonGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Optional `aria-label` for the loading region. Default "Loading content". */
+    label?: string;
+    children: React.ReactNode;
+}
+declare function SkeletonGroup({ label, children, className, ...rest }: SkeletonGroupProps): react_jsx_runtime.JSX.Element;
+
+interface EmptyStateProps {
+    /** Icon element. Recommended size 48x48. Wrap a lucide icon in a div if you want background styling. */
+    icon?: React.ReactNode;
+    /** Required main heading. */
+    title: string;
+    /** Optional secondary description. */
+    description?: React.ReactNode;
+    /** Optional CTA region — typically one or two <Button> elements. */
+    action?: React.ReactNode;
+    /** Visual size. "sm" for inline use (cards, panels), "md" default, "lg" for full-page emptiness. */
+    size?: "sm" | "md" | "lg";
+    className?: string;
+}
+declare function EmptyState({ icon, title, description, action, size, className, }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+
+type ErrorBannerSeverity = "warning" | "error";
+interface ErrorBannerProps {
+    /** Defaults to "error". */
+    severity?: ErrorBannerSeverity;
+    /** Optional bold heading shown above the message. */
+    title?: string;
+    /** Required body text or node. */
+    message: React.ReactNode;
+    /** Override the auto-selected icon. */
+    icon?: React.ReactNode;
+    /** Optional CTA region — typically one <Button>. */
+    action?: React.ReactNode;
+    /** When provided, renders a dismiss "X" button that calls this on click. */
+    onDismiss?: () => void;
+    className?: string;
+}
+declare function ErrorBanner({ severity, title, message, icon, action, onDismiss, className, }: ErrorBannerProps): react_jsx_runtime.JSX.Element;
+
+interface ErrorPageProps {
+    /** Defaults to "Something went wrong". */
+    title?: string;
+    /** Optional explanation paragraph(s). */
+    description?: React.ReactNode;
+    /** Short symbolic code (e.g., "500", "NOT_FOUND") rendered as a tag. */
+    errorCode?: string;
+    /** Correlation id from hazo_logs — rendered in a copyable mono block when present. */
+    correlationId?: string;
+    /** CTA region — typically one or two <Button> elements ("Try again", "Go home"). */
+    actions?: React.ReactNode;
+    /** Override the default OctagonAlert icon. */
+    illustration?: React.ReactNode;
+    className?: string;
+}
+declare function ErrorPage({ title, description, errorCode, correlationId, actions, illustration, className, }: ErrorPageProps): react_jsx_runtime.JSX.Element;
+
+interface LoadingTimeoutProps {
+    /** When true, the timeout runs and escalation states render. When false, renders children. */
+    active: boolean;
+    /** Children shown when not loading. */
+    children?: React.ReactNode;
+    /** Optional skeleton rendered during the "silent" phase (0–5s). */
+    skeleton?: React.ReactNode;
+    /** Called when the user clicks the retry button in the "expired" phase. */
+    onRetry?: () => void;
+    /** Customise the timeout thresholds in ms. Defaults: 5000/15000/30000. */
+    thresholds?: {
+        gentle?: number;
+        firm?: number;
+        expired?: number;
+    };
+    /** Optional label used in the gentle/firm messages. Default "content". */
+    label?: string;
+    className?: string;
+}
+declare function LoadingTimeout({ active, children, skeleton, onRetry, thresholds, label, className, }: LoadingTimeoutProps): react_jsx_runtime.JSX.Element;
+
+interface ProgressiveImageProps {
+    /** Required final image src. */
+    src: string;
+    /** Required alt text. Empty string is allowed for decorative images. */
+    alt: string;
+    /** Low-quality placeholder data URL or tiny image url. Renders blurred under the main image. */
+    lqip?: string;
+    /** Width in px or CSS length. Required for stable aspect ratio. */
+    width: number | string;
+    /** Height in px or CSS length. Required for stable aspect ratio. */
+    height: number | string;
+    /** Native loading attribute. Default "lazy". */
+    loading?: "eager" | "lazy";
+    /** Object fit for the final image. Default "cover". */
+    fit?: "cover" | "contain" | "fill" | "none" | "scale-down";
+    className?: string;
+    onLoad?: () => void;
+    onError?: () => void;
+}
+declare function ProgressiveImage({ src, alt, lqip, width, height, loading, fit, className, onLoad, onError, }: ProgressiveImageProps): react_jsx_runtime.JSX.Element;
+
+interface HazoUiToasterProps {
+    /** Position of the toast stack. Default "bottom-right". */
+    position?: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "top-center" | "bottom-center";
+    /** Whether toasts include a close (X) button. Default true. */
+    closeButton?: boolean;
+    /** Max number of toasts visible at once. Default 5. */
+    visibleToasts?: number;
+}
+declare function HazoUiToaster({ position, closeButton, visibleToasts, }?: HazoUiToasterProps): react_jsx_runtime.JSX.Element;
+interface ToastOptions {
+    title: string;
+    description?: string;
+    /** Auto-dismiss duration in ms. Default 3000 for success, 5000 for error. */
+    duration?: number;
+    /** Optional action button rendered inside the toast. */
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+declare function successToast({ title, description, duration, action }: ToastOptions): string | number;
+declare function errorToast({ title, description, duration, action }: ToastOptions): string | number;
+
+interface UseLoadingStateResult {
+    /** Current loading flag. */
+    isLoading: boolean;
+    /** Set the loading flag manually. */
+    setLoading: (value: boolean) => void;
+    /**
+     * Wraps an async function: sets loading=true, awaits the function,
+     * sets loading=false in a finally block. Returns the function's result
+     * (or throws its error).
+     */
+    withLoading: <T>(fn: () => Promise<T>) => Promise<T>;
+}
+declare function useLoadingState(initial?: boolean): UseLoadingStateResult;
+
+interface UseErrorDisplayResult {
+    /** Current error message, or null when cleared. */
+    error: string | null;
+    /**
+     * Set the error. Accepts a string, an Error instance (uses .message),
+     * or null to clear. Anything else is coerced via String().
+     */
+    setError: (value: unknown) => void;
+    /** Clear the error. Same as `setError(null)`. */
+    clearError: () => void;
+}
+declare function useErrorDisplay(): UseErrorDisplayResult;
+
+/**
+ * Types for HazoUiKanban - Drag-Drop Kanban
+ *
+ * Public type surface for the kanban components. No @dnd-kit types leak here;
+ * consumers see only HazoUi* shapes.
+ */
+
+/**
+ * Priority levels drive the left-border tint. P0..P3 ship with default colors;
+ * any other string is allowed if the consumer defines a custom CSS variable
+ * (e.g. priority "critical" → --hazo-kanban-priority-critical).
+ */
+type KanbanPriority = "P0" | "P1" | "P2" | "P3" | string;
+/**
+ * Minimal item shape required by the board. Consumers extend this with their
+ * own payload fields (title, category, etc.).
+ */
+interface KanbanItem {
+    id: string;
+    columnKey: string;
+    priority?: KanbanPriority;
+}
+/**
+ * Column descriptor passed to the board.
+ */
+interface KanbanColumn {
+    key: string;
+    title: string;
+    /** Optional gate: returning false rejects an incoming drop. */
+    accepts?: (item: KanbanItem) => boolean;
+}
+/**
+ * Handle attached to move/reorder events. Calling revert() removes the
+ * library's optimistic overlay entry, snapping the visible state back to
+ * whatever the consumer's `items` prop currently says.
+ */
+interface KanbanMoveHandle {
+    revert: () => void;
+}
+/**
+ * Fired when a card is dropped into a different column.
+ */
+type KanbanMoveEvent<T extends KanbanItem = KanbanItem> = {
+    itemId: string;
+    item: T;
+    fromColumn: string;
+    toColumn: string;
+    newIndex: number;
+} & KanbanMoveHandle;
+/**
+ * Fired when a card is reordered within the same column.
+ */
+type KanbanReorderEvent<T extends KanbanItem = KanbanItem> = {
+    itemId: string;
+    item: T;
+    columnKey: string;
+    newIndex: number;
+} & KanbanMoveHandle;
+/**
+ * Screen-reader announcement strings produced from drag lifecycle events.
+ * Defaults are provided; consumers can pass a partial override.
+ */
+interface KanbanAnnouncements {
+    onDragStart: (ctx: {
+        item: KanbanItem;
+        fromColumn: string;
+    }) => string;
+    onDragOver: (ctx: {
+        item: KanbanItem;
+        overColumn: string | null;
+    }) => string;
+    onDragEnd: (ctx: {
+        item: KanbanItem;
+        fromColumn: string;
+        toColumn: string;
+        newIndex: number;
+    }) => string;
+    onDragCancel: (ctx: {
+        item: KanbanItem;
+        fromColumn: string;
+    }) => string;
+}
+/**
+ * Props for HazoUiKanban.
+ */
+interface HazoUiKanbanProps<T extends KanbanItem = KanbanItem> {
+    columns: KanbanColumn[];
+    items: T[];
+    renderCard: (item: T) => React.ReactNode;
+    onMove?: (event: KanbanMoveEvent<T>) => void;
+    onReorder?: (event: KanbanReorderEvent<T>) => void;
+    /** Default 640 (Tailwind sm). Below this width the board collapses to tabs. */
+    mobileBreakpoint?: number;
+    /** Override default screen-reader messages. Partial — unset keys use defaults. */
+    announcements?: Partial<KanbanAnnouncements>;
+    /** Rendered when a column has zero items. Default: muted "—" placeholder. */
+    emptyColumn?: React.ReactNode;
+    /** Class on the board root. */
+    className?: string;
+    /** Class on each card shell (the wrapper around renderCard output). */
+    cardClassName?: string;
+    /**
+     * Optional accessor for the announcement label of an item.
+     * Defaults to item.id if not provided.
+     */
+    itemLabel?: (item: T) => string;
+    /**
+     * Declarative field schema for the default editor. If omitted, the
+     * editor auto-detects all string-typed fields on the item except `id`,
+     * `columnKey`, and `priority`, rendering each as a text input.
+     */
+    editorFields?: KanbanEditorField[];
+    /**
+     * Pool of priorities used when a field has `type: 'priority'`.
+     * Defaults to ["P0","P1","P2","P3"].
+     */
+    editorPriorities?: KanbanPriority[];
+    /**
+     * Dialog title. Defaults to `Edit ${item.id}`.
+     */
+    editorTitle?: (item: T) => string;
+    /**
+     * Override the body of the editor dialog. The library still renders the
+     * Dialog wrapper, title, and (by default) the Cancel/Save footer.
+     */
+    renderCardEditor?: (item: T, ctx: KanbanEditorCtx<T>) => React.ReactNode;
+    /**
+     * Suppress the library's default Cancel/Save footer. Only honored when
+     * renderCardEditor is also provided — in default mode there is no
+     * alternate way to trigger save, so the footer always renders.
+     */
+    hideEditorFooter?: boolean;
+    /**
+     * Fired when the user clicks Save. Consumer is responsible for
+     * persisting and (on success) updating `items`. Returning a Promise
+     * gates the dialog close and shows a spinner on Save; rejecting the
+     * Promise keeps the dialog open with the error rendered.
+     */
+    onCardSave?: (event: KanbanSaveEvent<T>) => void | Promise<void>;
+    /**
+     * Hide the edit pencil entirely (read-only board). The pencil is also
+     * automatically hidden when onCardSave is not provided.
+     */
+    disableEdit?: boolean;
+}
+/**
+ * Filter shape consumed by HazoUiKanbanFilter and applyKanbanFilter.
+ */
+interface KanbanFilterValue {
+    search: string;
+    categories: string[];
+    priority: KanbanPriority | null;
+}
+/**
+ * Props for HazoUiKanbanFilter.
+ */
+interface HazoUiKanbanFilterProps {
+    /** Show the search input. Default true. */
+    search?: boolean;
+    /** Search input placeholder. Default "Search...". */
+    searchPlaceholder?: string;
+    /** Categories rendered as multi-select chips. Hidden when omitted/empty. */
+    categories?: string[];
+    /** Priority chips (single-select). Hidden when omitted/empty. */
+    priorities?: KanbanPriority[];
+    /** Controlled value. */
+    value?: KanbanFilterValue;
+    /** Default value for uncontrolled usage. */
+    defaultValue?: KanbanFilterValue;
+    /** Called whenever any filter field changes. */
+    onChange?: (value: KanbanFilterValue) => void;
+    /** Class on the filter root. */
+    className?: string;
+}
+/**
+ * Built-in field types the default editor knows how to render.
+ * `priority` renders a Select pre-populated from HazoUiKanban's
+ * `editorPriorities` prop (defaulting to ["P0","P1","P2","P3"]).
+ * `status` renders a Select pre-populated from HazoUiKanban's `columns`
+ * prop (using each column's `title` as the option label and `key` as the
+ * value). Bound to `columnKey` by convention — saving with a different
+ * status moves the card to a new column through the consumer's
+ * onCardSave handler.
+ */
+type KanbanEditorFieldType = "text" | "textarea" | "select" | "number" | "checkbox" | "priority" | "status";
+/**
+ * Declarative field config for the default editor. One per editable key.
+ */
+interface KanbanEditorField {
+    /** Top-level string key on the item being edited. */
+    key: string;
+    /** Display label. Defaults to a humanized version of `key`. */
+    label?: string;
+    type: KanbanEditorFieldType;
+    /** Options list for `type: 'select'`. Ignored otherwise. */
+    options?: string[];
+    /** Placeholder for `type: 'text' | 'textarea' | 'number' | 'select' | 'priority'`. */
+    placeholder?: string;
+    /**
+     * If true, the field shows a `*` marker on its label and Save is disabled
+     * when empty. Only honored for text / textarea / number; ignored for
+     * select / priority / checkbox (those types are never "empty").
+     */
+    required?: boolean;
+}
+/**
+ * Context passed to renderCardEditor render-prop. The library owns the
+ * dialog open/close lifecycle; the consumer reads and writes the draft
+ * through this handle and calls save()/close() to drive the lifecycle.
+ */
+interface KanbanEditorCtx<T extends KanbanItem = KanbanItem> {
+    /** Current draft. Mutated as the user types. */
+    draft: T;
+    /** Update the draft. Accepts a value or an updater function. */
+    setDraft: (next: T | ((prev: T) => T)) => void;
+    /** Trigger the save lifecycle: validates required fields, calls onCardSave. */
+    save: () => Promise<void>;
+    /** Dismiss the dialog without saving. */
+    close: () => void;
+    /** True while onCardSave's returned promise is pending. */
+    saving: boolean;
+    /** Last save error message, or null. Cleared at the start of each save attempt. */
+    error: string | null;
+    /** True when JSON.stringify(draft) !== JSON.stringify(item). */
+    isDirty: boolean;
+}
+/**
+ * Fired when the user clicks Save (or the consumer's renderCardEditor
+ * calls ctx.save()).
+ */
+interface KanbanSaveEvent<T extends KanbanItem = KanbanItem> {
+    itemId: string;
+    /** Original item before edits. */
+    item: T;
+    /** New item with the user's edits applied. */
+    next: T;
+}
+
+declare function HazoUiKanbanFilter({ search, searchPlaceholder, categories, priorities, value, defaultValue, onChange, className, }: HazoUiKanbanFilterProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Pure helper: filters KanbanItem[] by search / categories / priority.
+ *
+ * - search: case-insensitive substring against any string-typed field of the item.
+ * - categories: keep items whose item.category (string) is in the list.
+ * - priority: exact equality on item.priority.
+ *
+ * Consumers needing different filter logic should write their own — this is
+ * a convenience export, not the public contract for filtering.
+ */
+
+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;
+
+declare const Table: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableElement> & React.RefAttributes<HTMLTableElement>>;
+declare const TableHeader: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableBody: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableFooter: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableSectionElement> & React.RefAttributes<HTMLTableSectionElement>>;
+declare const TableRow: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableRowElement> & React.RefAttributes<HTMLTableRowElement>>;
+declare const TableHead: React.ForwardRefExoticComponent<React.ThHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
+declare const TableCell: React.ForwardRefExoticComponent<React.TdHTMLAttributes<HTMLTableCellElement> & React.RefAttributes<HTMLTableCellElement>>;
+declare const TableCaption: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLTableCaptionElement> & React.RefAttributes<HTMLTableCaptionElement>>;
+
+/**
+ * HazoUiTable — public types.
+ *
+ * The `TableColumn` is the single source of truth: it carries display,
+ * sort, filter, and search metadata. From it the component derives the
+ * `availableFields` arrays for the existing HazoUiMultiSortDialog and
+ * HazoUiMultiFilterDialog.
+ */
+
+type SortDir = "asc" | "desc";
+interface TableSortEntry {
+    key: string;
+    dir: SortDir;
+}
+type TableSort = TableSortEntry[];
+/** Public prop shape — accepts single entry, array, or null; normalized to array internally. */
+type TableSortProp = TableSortEntry | TableSort | null;
+interface TableFilter {
+    search?: string;
+    fields?: FilterConfig[];
+}
+type TableFormatter = "date" | "number" | "currency" | "percent";
+interface TableColumn<TRow extends object = any> {
+    key: keyof TRow & string;
+    label: string;
+    sortable?: boolean;
+    cell?: (row: TRow, index: number) => React.ReactNode;
+    formatter?: TableFormatter;
+    /** ISO-4217 currency code used when `formatter` is "currency". Defaults to "USD". */
+    currency?: string;
+    /**
+     * BCP-47 locale tag for the `number`, `currency`, and `percent`
+     * formatters. Defaults to `"en-US"` (matches across SSR + CSR).
+     * Set explicitly to override per column (e.g. `"de-DE"`, `"ja-JP"`).
+     */
+    locale?: string;
+    align?: "left" | "right" | "center";
+    className?: string;
+    headerClassName?: string;
+    filterType?: FilterField["type"];
+    filterConfig?: Pick<FilterField, "textConfig" | "numberConfig" | "comboboxOptions" | "booleanLabels">;
+    searchable?: boolean;
+}
+interface HazoUiTablePagination {
+    pageSize: number;
+}
+interface HazoUiTableServerLoadArgs {
+    page: number;
+    sort: TableSort;
+    filter: TableFilter;
+}
+interface HazoUiTableServerLoadResult<TRow> {
+    rows: TRow[];
+    total: number;
+}
+interface HazoUiTableProps<TRow extends object = any> {
+    columns: TableColumn<TRow>[];
+    rows: TRow[];
+    getRowKey?: (row: TRow, index: number) => string | number;
+    sort?: TableSortProp;
+    defaultSort?: TableSortProp;
+    onSortChange?: (sort: TableSort) => void;
+    filter?: TableFilter;
+    defaultFilter?: TableFilter;
+    onFilterChange?: (filter: TableFilter) => void;
+    page?: number;
+    defaultPage?: number;
+    onPageChange?: (page: number) => void;
+    pagination?: HazoUiTablePagination | false;
+    enableSortDialog?: boolean;
+    enableFilterDialog?: boolean;
+    enableSearch?: boolean;
+    searchPlaceholder?: string;
+    searchDebounceMs?: number;
+    loading?: boolean;
+    empty?: React.ReactNode;
+    noResults?: React.ReactNode;
+    /**
+     * Rendered when `onLoad` rejects. Receives the thrown error.
+     * If not provided (or returns null), the table falls back to the
+     * `noResults` empty-state visual. `console.warn` runs regardless.
+     */
+    error?: React.ReactNode | ((err: unknown) => React.ReactNode);
+    onRowClick?: (row: TRow, index: number) => void;
+    mobileCardFallback?: boolean;
+    mobileBreakpoint?: number;
+    onLoad?: (args: HazoUiTableServerLoadArgs) => Promise<HazoUiTableServerLoadResult<TRow>>;
+    className?: string;
+    caption?: string;
+}
+
+declare function HazoUiTable<TRow extends object = any>(props: HazoUiTableProps<TRow>): react_jsx_runtime.JSX.Element;
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorBannerSeverity, ErrorPage, type ErrorPageProps, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTable, type HazoUiTablePagination, type HazoUiTableProps, type HazoUiTableServerLoadArgs, type HazoUiTableServerLoadResult, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, 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, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, ProgressiveImage, type ProgressiveImageProps, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, Skeleton, SkeletonBar, type SkeletonBarProps, SkeletonCircle, type SkeletonCircleProps, SkeletonGroup, type SkeletonGroupProps, SkeletonRect, type SkeletonRectProps, type SortConfig, type SortField, Spinner, type SuggestionState, Switch, Table, TableBody, TableCaption, TableCell, type TableColumn, type TableFilter, TableFooter, type TableFormatter, TableHead, TableHeader, TableRow, type TableSort, type TableSortEntry, type TableSortProp, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, applyKanbanFilter, buttonGroupVariants, create_command_suggestion_extension, errorToast, get_hazo_ui_config, parse_commands_from_text, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useErrorDisplay, useLoadingState, useMediaQuery };