hazo_ui 2.16.0 → 2.17.0

package/dist/index.d.cts

@@ -1536,4 +1536,203 @@ interface HazoUiTableProps<TRow extends object = any> {
 
 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 };
+/**
+ * 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 };

package/dist/index.d.ts

@@ -1536,4 +1536,203 @@ interface HazoUiTableProps<TRow extends object = any> {
 
 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 };
+/**
+ * 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 };