hazo_ui 2.11.0 → 2.17.0

package/dist/index.d.cts

@@ -1179,4 +1179,560 @@ interface UseErrorDisplayResult {
 }
 declare function useErrorDisplay(): UseErrorDisplayResult;
 
-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, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, 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, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, 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 };
+/**
+ * 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;
+
+/**
+ * Public types for hazo_ui_charts. Keep dependency-free so consumers can
+ * import these without pulling in React types they don't need.
+ */
+/** One series-value. `null` is a missing point — the chart will skip it. */
+type ChartDataPoint = number | null;
+/** Ordered time-series for a single line / area / sparkline. */
+type ChartDataSeries = ChartDataPoint[];
+/** Multi-line chart series with its own color + label. */
+interface MultiSeries {
+    label: string;
+    color: string;
+    data: ChartDataSeries;
+}
+/** Single stacked bar — one column on the X-axis. */
+interface StackedBar {
+    /** Display label below the bar (date, category, etc.). */
+    label: string;
+    /** Top-to-bottom band order. `value` is the band's contribution to the bar's total height. */
+    segments: {
+        value: number;
+        color: string;
+    }[];
+}
+/** Date-range selector option. Value is opaque to the component. */
+interface DateRangeOption {
+    value: string;
+    label: string;
+}
+
+/**
+ * Sparkline — tiny single-series line for KPI cards.
+ *
+ * Intentionally axisless (per PRD §6b — sparklines are for trend *shape*,
+ * the value is shown above them in the card itself). 12% area fill makes
+ * the trajectory readable even at 40px high; a 2px dot marks the latest
+ * non-null point so "now" is obvious.
+ *
+ * SVG renders edge-to-edge with `preserveAspectRatio="none"` so the line
+ * stretches across whatever width the parent gives it.
+ */
+
+interface SparklineProps {
+    /** Time-series. `null` entries are skipped. */
+    data: ChartDataSeries;
+    /** Stroke / dot / area-fill color. */
+    color: string;
+    /** Container className passthrough. */
+    className?: string;
+    /** Override the default 40px height. */
+    height?: number;
+}
+declare function Sparkline({ data, color, className, height, }: SparklineProps): React.ReactElement;
+
+/**
+ * InverseSparkline — tiny axisless line where lower = better.
+ *
+ * Used for GSC position trends: rank 1 is best, rank 50 is bad, so the Y
+ * axis is flipped relative to a regular sparkline. No area fill, no dot —
+ * the only signal is the line's direction. 62×18 by default matches the
+ * "scrollable list of queries" layout in the GSC deep-dive mockup.
+ */
+
+interface InverseSparklineProps {
+    /** Time-series (e.g. GSC avg-position values). `null` is skipped. */
+    data: ChartDataSeries;
+    /** Stroke color. */
+    color: string;
+    /** Container className passthrough. */
+    className?: string;
+    /** Override default 62px width. */
+    width?: number;
+    /** Override default 18px height. */
+    height?: number;
+}
+declare function InverseSparkline({ data, color, className, width, height, }: InverseSparklineProps): React.ReactElement;
+
+/**
+ * LineChart — full-anatomy single-series chart (PRD §6b spec).
+ *
+ *   ┌─────────────────────────────────────────────┐
+ *   │  Y-max ─ - - - - - - - - - - - - - - - - -  │ ← three dashed gridlines
+ *   │  Y-mid ─ - - - - - - - - - - ╭──•value      │ ← marker dot + label
+ *   │  Y-min ─ - - - - - - -╭──────╯              │   + dashed guide to Y-axis
+ *   │        └─────────────────────────────────   │
+ *   │        Mar 4        Mar 10        Mar 17    │ ← three X labels
+ *   └─────────────────────────────────────────────┘
+ *
+ * Hover anywhere over the plot area to surface a cursor line + value
+ * bubble at the nearest data point. Set `showTooltip={false}` to disable
+ * — useful when the chart is small or non-interactive (print export).
+ */
+
+interface LineChartProps {
+    /** Time-series. `null` entries are gaps in the line. */
+    data: ChartDataSeries;
+    /** Labels for the X-axis. Length should match `data`. */
+    dates: string[];
+    /** Stroke / area / marker color. */
+    color: string;
+    /** Override default 360-wide viewBox. */
+    width?: number;
+    /** Override default 130-tall viewBox. */
+    height?: number;
+    /** Optional suffix shown next to the current-value label (e.g. "%"). */
+    unit?: string;
+    /** Disable hover tooltip. Defaults to enabled. */
+    showTooltip?: boolean;
+    /** Container className passthrough. */
+    className?: string;
+}
+declare function LineChart({ data, dates, color, width, height, unit, showTooltip, className, }: LineChartProps): React.ReactElement;
+
+/**
+ * MultiLineChart — multi-series chart with shared Y-axis.
+ *
+ * No area fill (PRD §6b — "multi-series uses lines only to avoid color
+ * collisions"). Each series gets a per-endpoint marker + value label so
+ * the latest value is readable without hovering. Hover surfaces a single
+ * cursor line with one bubble per series stacked vertically.
+ */
+
+interface MultiLineChartProps {
+    series: MultiSeries[];
+    dates: string[];
+    width?: number;
+    height?: number;
+    showTooltip?: boolean;
+    showLegend?: boolean;
+    className?: string;
+}
+declare function MultiLineChart({ series, dates, width, height, showTooltip, showLegend, className, }: MultiLineChartProps): React.ReactElement;
+
+/**
+ * StackedBars — one vertical bar per X position, each split into top-to-bottom
+ * colored bands.
+ *
+ * Generic enough for any distribution-over-time visual: GSC position buckets
+ * (Top 3 / 4-10 / 11-20 / 20+), traffic source mix (organic / direct / referral),
+ * etc. The component is data-driven via `bars: StackedBar[]` — the consumer
+ * picks the segment colors, the labels, and the band order.
+ */
+
+interface StackedBarsProps {
+    bars: StackedBar[];
+    width?: number;
+    height?: number;
+    /** Show Y-axis ticks (max, mid, 0). Defaults to true. */
+    showYAxis?: boolean;
+    className?: string;
+}
+declare function StackedBars({ bars, width, height, showYAxis, className, }: StackedBarsProps): React.ReactElement;
+
+/**
+ * DateRangeSelector — segmented control for picking a chart's time window.
+ *
+ * Framework-agnostic: emits the new value via `onChange`. The consumer
+ * decides whether to write it to a URL query param (Next.js router), a
+ * local state, or a global store — hazo_ui has no opinion on routing.
+ *
+ * Visually a row of pills, the active one tinted with the primary color.
+ * Designed to sit immediately above a chart on the Trends / Bing / GA4
+ * pages where users need to flip between "14d", "30d", and "since launch".
+ */
+
+interface DateRangeSelectorProps {
+    value: string;
+    onChange: (value: string) => void;
+    options: DateRangeOption[];
+    className?: string;
+    /** Aria label for the whole group. Defaults to "Date range". */
+    ariaLabel?: string;
+}
+declare function DateRangeSelector({ value, onChange, options, className, ariaLabel, }: DateRangeSelectorProps): React.ReactElement;
+
+/**
+ * Number/date formatters shared across hazo_ui_charts.
+ *
+ * Kept as pure, zero-dependency helpers so the chart primitives stay
+ * deterministic across SSR/CSR. Locale is intentionally pinned (the same
+ * lesson as v2.15.1's Intl fix on HazoUiTable).
+ */
+/**
+ * Compact number formatter used on Y-axis ticks, marker labels, and legends.
+ *
+ *   null / undefined / NaN → empty string
+ *   ≥ 1,000              → `1.0k`, `12.3k`, `1.0M`
+ *   integer              → no decimals (`14`, `0`)
+ *   fractional           → one decimal (`5.7`)
+ *
+ * Strings pass through unchanged so callers can pre-format if needed.
+ */
+declare function format_num(n: number | null | undefined | string): string;
+/**
+ * Pick three index positions for X-axis labels: start, middle, end.
+ * Returns `[0, mid, last]` for length ≥ 3; falls back gracefully below that.
+ */
+declare function pick_x_label_indices(length: number): [number, number, number];
+
+export { ANIMATION_PRESETS, Accordion, AccordionContent, AccordionItem, AccordionTrigger, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, type AnimationPreset, type BaseCommandInputProps, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, Calendar, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, type ChartDataPoint, type ChartDataSeries, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, type CommandEditContext, type CommandItem$1 as CommandItem, CommandNodeExtension, CommandPill, type CommandPillProps, CommandPopover, type CommandPopoverProps, type CommandTextOutput, type ConfirmDialogVariant, type DateRangeOption, DateRangeSelector, type DateRangeSelectorProps, type DialogVariant, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, type EmptyStateProps, ErrorBanner, type ErrorBannerProps, type ErrorBannerSeverity, ErrorPage, type ErrorPageProps, type FilterConfig, type FilterField, type HazoUiConfig, HazoUiConfirmDialog, type HazoUiConfirmDialogProps, HazoUiDialog, DialogClose as HazoUiDialogClose, DialogContent as HazoUiDialogContent, DialogDescription as HazoUiDialogDescription, DialogFooter as HazoUiDialogFooter, DialogHeader as HazoUiDialogHeader, DialogOverlay as HazoUiDialogOverlay, DialogPortal as HazoUiDialogPortal, type HazoUiDialogProps, Dialog as HazoUiDialogRoot, DialogTitle as HazoUiDialogTitle, DialogTrigger as HazoUiDialogTrigger, HazoUiFlexInput, type HazoUiFlexInputProps, HazoUiFlexRadio, type HazoUiFlexRadioItem, type HazoUiFlexRadioProps, HazoUiKanban, HazoUiKanbanFilter, type HazoUiKanbanFilterProps, type HazoUiKanbanProps, HazoUiMultiFilterDialog, HazoUiMultiSortDialog, HazoUiPillRadio, type HazoUiPillRadioItem, type HazoUiPillRadioProps, HazoUiRte, type HazoUiRteProps, HazoUiTable, type HazoUiTablePagination, type HazoUiTableProps, type HazoUiTableServerLoadArgs, type HazoUiTableServerLoadResult, HazoUiTextarea, type HazoUiTextareaProps, HazoUiTextbox, type HazoUiTextboxProps, HazoUiToaster, type HazoUiToasterProps, HoverCard, HoverCardContent, HoverCardTrigger, Input, type InsertedCommand, InverseSparkline, type InverseSparklineProps, type KanbanAnnouncements, type KanbanColumn, type KanbanEditorCtx, type KanbanEditorField, type KanbanEditorFieldType, type KanbanFilterValue, type KanbanItem, type KanbanMoveEvent, type KanbanMoveHandle, type KanbanPriority, type KanbanReorderEvent, type KanbanSaveEvent, Label, LineChart, type LineChartProps, LoadingTimeout, type LoadingTimeoutProps, MultiLineChart, type MultiLineChartProps, type MultiSeries, Popover, PopoverContent, PopoverTrigger, type PrefixColor, type PrefixConfig, ProgressiveImage, type ProgressiveImageProps, RadioGroup, RadioGroupItem, type RteAttachment, type RteOutput, type RteVariable, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Command as ShadcnCommand, CommandEmpty as ShadcnCommandEmpty, CommandGroup as ShadcnCommandGroup, CommandInput as ShadcnCommandInput, CommandItem as ShadcnCommandItem, CommandList as ShadcnCommandList, Skeleton, SkeletonBar, type SkeletonBarProps, SkeletonCircle, type SkeletonCircleProps, SkeletonGroup, type SkeletonGroupProps, SkeletonRect, type SkeletonRectProps, type SortConfig, type SortField, Sparkline, type SparklineProps, Spinner, type StackedBar, StackedBars, type StackedBarsProps, type SuggestionState, Switch, Table, TableBody, TableCaption, TableCell, type TableColumn, type TableFilter, TableFooter, type TableFormatter, TableHead, TableHeader, TableRow, type TableSort, type TableSortEntry, type TableSortProp, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type ToastOptions, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, type UseErrorDisplayResult, type UseLoadingStateResult, applyKanbanFilter, buttonGroupVariants, create_command_suggestion_extension, errorToast, format_num, get_hazo_ui_config, parse_commands_from_text, pick_x_label_indices, reset_hazo_ui_config, resolve_animation_classes, set_hazo_ui_config, successToast, text_to_tiptap_content, toggleVariants, useErrorDisplay, useLoadingState, useMediaQuery };