@timbal-ai/timbal-react 1.0.0 → 1.2.0

package/dist/{chart-artifact-CBo9x8Ch.d.ts → chart-artifact-_PEJgCpQ.d.ts}

@@ -1,5 +1,5 @@
 import { FC, ReactNode, InputHTMLAttributes, TextareaHTMLAttributes, SelectHTMLAttributes } from 'react';
-import { w as TimbalRuntimeProviderProps, q as ThreadProps, C as ChartArtifact } from './chat-Bed4FQSl.js';
+import { x as TimbalRuntimeProviderProps, r as ThreadProps, C as ChartArtifact } from './chat-ClmzWzCX.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -437,6 +437,11 @@ interface AppShellProps {
     chatTriggerLabel?: string;
     /** Hide the built-in floating trigger (use your own + `useAppShellChat`). */
     hideChatTrigger?: boolean;
+    /** Controlled mobile-nav drawer open state. */
+    navOpen?: boolean;
+    /** Uncontrolled initial mobile-nav open state. Default: `false`. */
+    defaultNavOpen?: boolean;
+    onNavOpenChange?: (open: boolean) => void;
     className?: string;
     mainClassName?: string;
 }
@@ -480,6 +485,38 @@ interface AppShellChatControls {
 }
 declare function useAppShellChat(): AppShellChatControls | null;
 
+interface AppShellNavControls {
+    /** Mobile nav drawer open state. */
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    toggle: () => void;
+}
+/**
+ * Read the `AppShell`-owned mobile nav controls. Use to wire `StudioSidebar`'s
+ * `mobileOpen` / `onMobileOpenChange` (and any custom trigger) without
+ * re-implementing the open-state + resize boilerplate:
+ *
+ * ```tsx
+ * const nav = useAppShellNav();
+ * <StudioSidebar mobileOpen={nav.open} onMobileOpenChange={nav.setOpen} … />
+ * ```
+ *
+ * Returns a no-op fallback when used outside `AppShell`, so it's always safe to call.
+ */
+declare function useAppShellNav(): AppShellNavControls;
+
+interface AppShellSidebarTriggerProps {
+    /** Accessible label. Default: "Open navigation". */
+    label?: string;
+    className?: string;
+}
+/**
+ * Hamburger that opens the `AppShell` mobile nav drawer. Hidden on `md+`
+ * (the sidebar is persistent there). Drop it in `AppShellTopbar`'s `start`
+ * slot — it reads the shell nav controls, so no wiring is needed.
+ */
+declare const AppShellSidebarTrigger: FC<AppShellSidebarTriggerProps>;
+
 interface PageHeaderProps {
     title: ReactNode;
     description?: ReactNode;
@@ -549,6 +586,7 @@ declare const statusBadgeToneClass: {
     readonly primary: "bg-primary/10 text-primary";
     readonly success: "bg-emerald-500/10 text-emerald-600 dark:text-emerald-400";
     readonly warn: "bg-amber-500/10 text-amber-600 dark:text-amber-400";
+    readonly danger: "bg-destructive/10 text-destructive";
     readonly muted: "bg-muted/80 text-muted-foreground";
 };
 type StatusBadgeTone = keyof typeof statusBadgeToneClass;
@@ -909,6 +947,15 @@ interface FilterBarProps {
 }
 declare const FilterBar: FC<FilterBarProps>;
 
+interface FilterFieldProps {
+    /** Visible label above the control. Omit for unlabeled fields (e.g. search). */
+    label?: ReactNode;
+    children: ReactNode;
+    className?: string;
+}
+/** Single filter control with an optional label — use inside `FilterBar`. */
+declare const FilterField: FC<FilterFieldProps>;
+
 type DataTableSortDirection = "asc" | "desc";
 interface DataTableSort {
     columnId: string;
@@ -924,6 +971,8 @@ interface DataTableColumn<T> {
     sortable?: boolean;
     /** Value used when sorting; defaults to stringifying `cell(row)`. */
     sortValue?: (row: T) => string | number | boolean | Date | null | undefined;
+    /** Ellipsis-overflow long cell content inside the column. */
+    truncate?: boolean;
 }
 interface DataTableProps<T> {
     columns: DataTableColumn<T>[];
@@ -944,8 +993,35 @@ interface DataTableProps<T> {
     stickyHeader?: boolean;
     dense?: boolean;
     caption?: string;
+    /**
+     * Render shaped skeleton rows instead of data — for async loads. Keeps the
+     * header and chrome so the table doesn't jump when data arrives.
+     */
+    loading?: boolean;
+    /** Skeleton row count while `loading`. Default: `pageSize ?? 5`. */
+    loadingRows?: number;
+    /**
+     * Enable a leading checkbox column for multi-row selection (bulk actions).
+     * Controlled via `selectedKeys` + `onSelectionChange`, or uncontrolled with
+     * `defaultSelectedKeys`. Keys are produced by `getRowKey`.
+     */
+    selectable?: boolean;
+    selectedKeys?: string[];
+    defaultSelectedKeys?: string[];
+    onSelectionChange?: (keys: string[]) => void;
+    /** Accessible label for the select-all checkbox. Default: "Select all rows". */
+    selectAllAriaLabel?: string;
+    /**
+     * Rows per page. When set, the table paginates client-side and renders a
+     * pager in the footer. Omit for a single, unpaginated list.
+     */
+    pageSize?: number;
+    /** Controlled current page (0-based). */
+    pageIndex?: number;
+    defaultPageIndex?: number;
+    onPageChange?: (pageIndex: number) => void;
 }
-declare function DataTable<T>({ columns, rows, getRowKey, emptyTitle, emptyDescription, emptyMode, className, sort: sortProp, defaultSort, onSortChange, showRowCount, rowCountLabel, footer, onRowClick, stickyHeader, dense, caption, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
+declare function DataTable<T>({ columns, rows, getRowKey, emptyTitle, emptyDescription, emptyMode, className, sort: sortProp, defaultSort, onSortChange, showRowCount, rowCountLabel, footer, onRowClick, stickyHeader, dense, caption, loading, loadingRows, selectable, selectedKeys: selectedKeysProp, defaultSelectedKeys, onSelectionChange, selectAllAriaLabel, pageSize, pageIndex: pageIndexProp, defaultPageIndex, onPageChange, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
 
 interface ChartPanelProps {
     title?: ReactNode;
@@ -956,6 +1032,8 @@ interface ChartPanelProps {
     actions?: ReactNode;
     /** Plot height in px. Default 300 (same as `MetricChartCard`). */
     height?: number;
+    /** Render a skeleton at the plot height while data loads. */
+    loading?: boolean;
     className?: string;
 }
 /**
@@ -1012,6 +1090,8 @@ interface MetricRowProps extends MetricCardHeaderProps {
     onMetricChange?: (id: string) => void;
     /** Accessible name for the KPI tile group (when tiles are selectable). */
     metricsAriaLabel?: string;
+    /** Render skeleton tiles while metrics load. Falls back to `metrics.length || 4`. */
+    loading?: boolean;
     className?: string;
 }
 /**
@@ -1020,8 +1100,37 @@ interface MetricRowProps extends MetricCardHeaderProps {
  */
 declare const MetricRow: FC<MetricRowProps>;
 
-/** Theme-aware default series palette. Primary uses the app's `--primary` token. */
-declare const CHART_PALETTE: readonly ["var(--primary, #6366f1)", "#10b981", "#f59e0b", "#06b6d4", "#a855f7", "#ef4444"];
+/** Curve interpolation styles, mirroring recharts/shadcn `type`. */
+type CurveType = "monotone" | "linear" | "step";
+
+interface ChartMargin {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** Recharts `margin` for flush vs default layouts. */
+declare function resolveChartMargin(options: {
+    flush: boolean;
+    showXAxis: boolean;
+    showYAxis: boolean;
+}): ChartMargin;
+/** Whether flush bar charts should use zero category gap (edge labels visible). */
+declare function flushBarCategoryGap(flush: boolean, showCategoryAxis: boolean): string | undefined;
+/** Whether flush line/area should use point scale + no-gap (edge-to-edge stroke, labeled x-axis). */
+declare function flushLineAreaEdgeToEdge(flush: boolean, variant: "area" | "line" | "bar", showXAxis: boolean, showYAxis: boolean): boolean;
+type TooltipRow = {
+    payload?: Record<string, unknown>;
+};
+/** Category label for cartesian tooltips (xKey / horizontal-bar category). */
+declare function resolveTooltipCategory(label: unknown, payload: TooltipRow[] | undefined, xKey: string, data: Array<Record<string, unknown>>, formatX: (raw: unknown, index: number) => string): string;
+
+/**
+ * Theme-aware default series palette. Each entry reads a `--chart-N` token
+ * (defined in `styles.css`, overridable per host app) with a literal fallback,
+ * so charts rebrand automatically when the theme changes.
+ */
+declare const CHART_PALETTE: readonly ["var(--chart-1, #4f46e5)", "var(--chart-2, #3b82f6)", "var(--chart-3, #0ea5e9)", "var(--chart-4, #6366f1)", "var(--chart-5, #60a5fa)", "var(--chart-6, #2563eb)"];
 interface ChartSeries {
     dataKey: string;
     label?: string;
@@ -1031,6 +1140,8 @@ interface ChartSeries {
 type ChartVariant = "area" | "line" | "bar";
 /** `flush` — plot edge-to-edge (no side/bottom inset); axes/legend off by default. */
 type ChartLayout = "default" | "flush";
+/** Tooltip series marker, mirroring shadcn's `ChartTooltipContent` indicators. */
+type ChartTooltipIndicator = "dot" | "line" | "dashed";
 interface LineAreaChartProps {
     data: Array<Record<string, unknown>>;
     /** Category / x-axis key. Inferred from the first non-numeric field if omitted. */
@@ -1044,7 +1155,19 @@ interface LineAreaChartProps {
     unit?: string;
     /** Fix the y-domain max (e.g. 100 for percentages). */
     yMax?: number;
-    /** `flush` fills the container width/height except top inset (for `MetricChartCard`). */
+    /** Line / area interpolation. Default `monotone`. */
+    curve?: CurveType;
+    /** Stack series on top of each other (area + bar). Default false. */
+    stacked?: boolean;
+    /** Draw point markers on line/area series. */
+    dots?: boolean | "active";
+    /** Bar orientation. `horizontal` swaps category to the y-axis. Default `vertical`. */
+    orientation?: "vertical" | "horizontal";
+    /** Corner radius for bars. Default 4. */
+    barRadius?: number;
+    /** Grid line direction. Default `horizontal`. */
+    gridLines?: "horizontal" | "vertical" | "both" | "none";
+    /** `flush` fills the container width/height and hides axes/legend by default. */
     layout?: ChartLayout;
     showGrid?: boolean;
     showXAxis?: boolean;
@@ -1052,16 +1175,21 @@ interface LineAreaChartProps {
     /** Series legend below the plot. Default: on when `layout` is `default` and multiple series. */
     showLegend?: boolean;
     showTooltip?: boolean;
+    /** Tooltip series marker style. Default `dot`. */
+    tooltipIndicator?: ChartTooltipIndicator;
     formatValue?: (value: number) => string;
     formatX?: (raw: unknown, index: number) => string;
+    /** Truncate long category axis labels (full text in native tooltip). Default true. */
+    clipTicks?: boolean;
     className?: string;
     /** Accessible label for the chart image. */
     ariaLabel?: string;
 }
 /**
- * Polished, dependency-free chart: smooth monotone curves, gradient area fill,
- * faded dashed gridlines, hover crosshair + floating tooltip, and a cheap
- * clip-path grow-in animation. Renders crisp at the container's pixel width.
+ * shadcn-style chart built on recharts. A single component renders line, area,
+ * and bar charts (vertical or horizontal), with stacking, curve interpolation,
+ * dots, grid control, and the shared `ChartTooltipContent` / `ChartLegendContent`
+ * chrome. Series colors flow from the theme `--chart-N` tokens via `ChartConfig`.
  */
 declare const LineAreaChart: FC<LineAreaChartProps>;
 
@@ -1100,6 +1228,8 @@ interface MetricChartCardProps {
     emptyLabel?: ReactNode;
     /** Accessible name for the selectable KPI tile group. */
     metricsAriaLabel?: string;
+    /** Render skeleton tiles + chart while data loads. */
+    loading?: boolean;
     className?: string;
 }
 /**
@@ -1108,6 +1238,142 @@ interface MetricChartCardProps {
  */
 declare const MetricChartCard: FC<MetricChartCardProps>;
 
+/**
+ * Run `callback` every `delayMs`. Pass `null` to pause (the timer is torn down
+ * and restarted when the delay changes). The latest `callback` is always used,
+ * so you can pass an inline function without resetting the interval.
+ */
+declare function useInterval(callback: () => void, delayMs: number | null): void;
+interface UseLiveQueryOptions {
+    /** Poll interval in ms. Omit / `null` for a one-shot fetch (no polling). */
+    intervalMs?: number | null;
+    /** Pause fetching + polling entirely. Default: `true`. */
+    enabled?: boolean;
+    /** Fetch immediately on mount (vs. waiting one interval). Default: `true`. */
+    immediate?: boolean;
+    /**
+     * Pause polling while the tab is hidden and refetch on focus — avoids
+     * burning requests on a backgrounded dashboard. Default: `true`.
+     */
+    refetchOnFocus?: boolean;
+}
+interface UseLiveQueryResult<T> {
+    data: T | undefined;
+    error: unknown;
+    /** True until the first response settles. */
+    loading: boolean;
+    /** True during background refreshes (data already present). */
+    refreshing: boolean;
+    /** Timestamp (ms) of the last successful fetch, or null. */
+    lastUpdated: number | null;
+    /** Manually trigger a refetch (e.g. a "Refresh" button). */
+    refetch: () => void;
+}
+/**
+ * Poll an async source on an interval for live dashboards (alerts, metrics,
+ * logs). Handles loading/refreshing/error state, ignores out-of-order and
+ * post-unmount responses, pauses while the tab is hidden, and exposes a manual
+ * `refetch`. Pair with `authFetch` for `/api/*` calls.
+ *
+ * ```ts
+ * const { data, loading, refetch } = useLiveQuery(
+ *   () => authFetch("/api/alerts").then((r) => r.json()),
+ *   { intervalMs: 15_000 },
+ * );
+ * ```
+ *
+ * `fetcher` is read through a ref, so an inline arrow doesn't reset polling;
+ * change `intervalMs` / `enabled` to control the cadence.
+ */
+declare function useLiveQuery<T>(fetcher: () => Promise<T>, options?: UseLiveQueryOptions): UseLiveQueryResult<T>;
+
+interface PieChartProps {
+    data: Array<Record<string, unknown>>;
+    /** Category / label key. Inferred from the first non-numeric field if omitted. */
+    nameKey?: string;
+    /** Value key. Default "value". */
+    dataKey?: string;
+    /** Donut hole radius as a fraction of the outer radius (0 = full pie). Default 0. */
+    innerRadius?: number;
+    /** Per-slice colors. Defaults to the theme palette. */
+    colors?: string[];
+    /** Plot height in px. Default 260. */
+    height?: number;
+    /** Show the slice legend below the chart. Default true. */
+    showLegend?: boolean;
+    /** Show value labels on each slice. Default false. */
+    showLabels?: boolean;
+    showTooltip?: boolean;
+    tooltipIndicator?: ChartTooltipIndicator;
+    /** Big number drawn in the donut hole (e.g. the total). Requires `innerRadius > 0`. */
+    centerValue?: ReactNode;
+    /** Caption under `centerValue`. */
+    centerLabel?: ReactNode;
+    unit?: string;
+    formatValue?: (value: number) => string;
+    className?: string;
+    ariaLabel?: string;
+}
+/**
+ * Pie / donut chart on recharts. Pass `innerRadius` (0–1 fraction) for a donut
+ * and `centerValue` / `centerLabel` to fill the hole with a KPI. Slice colors
+ * come from the theme `--chart-N` palette (or `colors`).
+ */
+declare const PieChart: FC<PieChartProps>;
+
+interface RadialChartProps {
+    data: Array<Record<string, unknown>>;
+    /** Category / label key. Inferred from the first non-numeric field if omitted. */
+    nameKey?: string;
+    /** Value key. Default "value". */
+    dataKey?: string;
+    /** Value that maps to a full ring. Default: the data max (so the largest fills). */
+    maxValue?: number;
+    /** Per-arc colors. Defaults to the theme palette. */
+    colors?: string[];
+    height?: number;
+    /** Thickness of each ring in px. Default 16. */
+    ringWidth?: number;
+    /** Gap between rings in px. Default 4. */
+    ringGap?: number;
+    showLegend?: boolean;
+    /** Big number drawn in the center (e.g. a total or the single value). */
+    centerValue?: ReactNode;
+    centerLabel?: ReactNode;
+    className?: string;
+    ariaLabel?: string;
+}
+/**
+ * Radial (progress ring) chart on recharts — one concentric ring per data
+ * point, each filled proportional to its value against `maxValue`. Pass
+ * `centerValue` / `centerLabel` to fill the middle. Theme-driven colors.
+ */
+declare const RadialChart: FC<RadialChartProps>;
+
+interface RadarChartProps {
+    data: Array<Record<string, unknown>>;
+    /** Axis (category) key. Inferred from the first non-numeric field if omitted. */
+    nameKey?: string;
+    /** Series to plot. Strings are shorthand for `{ dataKey }`. Inferred if omitted. */
+    series?: Array<ChartSeries | string>;
+    /** Value at the outer edge. Default: the data max. */
+    maxValue?: number;
+    /** Number of concentric grid rings. Default 4. */
+    rings?: number;
+    height?: number;
+    showLegend?: boolean;
+    /** Fill the series polygons with a soft tint. Default true. */
+    fill?: boolean;
+    className?: string;
+    ariaLabel?: string;
+}
+/**
+ * Radar (spider) chart on recharts — one axis per data point, one polygon per
+ * series. Theme-driven colors. Good for comparing a handful of metrics across
+ * two or three entities.
+ */
+declare const RadarChart: FC<RadarChartProps>;
+
 interface SparklineProps {
     /** Numeric values, or objects from which `dataKey` is read. */
     data: Array<number | Record<string, unknown>>;
@@ -1135,10 +1401,11 @@ interface ChartArtifactViewProps {
     height?: number;
 }
 /**
- * Renders a `chart` artifact. Bar / line / area go through the shared
- * `LineAreaChart` engine (smooth curves, gradient fill, hover tooltip); pie
- * stays a small inline SVG.
+ * Renders a `chart` artifact. Cartesian kinds (bar / horizontalBar / line /
+ * area, including stacked) go through the shared `LineAreaChart` engine; pie,
+ * donut, radial, and radar use their dedicated recharts components. All
+ * inherit the theme `--chart-N` palette.
  */
 declare const ChartArtifactView: FC<ChartArtifactViewProps>;
 
-export { FieldSelect as $, APP_KIT_AGENT_INSTRUCTIONS as A, type BreadcrumbEntry as B, CHART_PALETTE as C, type ConnectionRowListProps as D, type ConnectionRowProps as E, DangerZone as F, DangerZoneAction as G, type DangerZoneActionProps as H, type DangerZoneProps as I, DataTable as J, type DataTableColumn as K, type DataTableProps as L, type DataTableSort as M, type DataTableSortDirection as N, type DescriptionItem as O, DescriptionList as P, type DescriptionListProps as Q, EmptyState as R, type EmptyStateProps as S, ExpandableSection as T, type ExpandableSectionProps as U, Field as V, FieldInput as W, type FieldInputProps as X, type FieldProps as Y, FieldRow as Z, type FieldRowProps as _, AppChatPanel as a, type StatusBadgeProps as a$, type FieldSelectProps as a0, FieldSwitch as a1, type FieldSwitchProps as a2, FieldTextarea as a3, type FieldTextareaProps as a4, FilterBar as a5, type FilterBarProps as a6, FloatingUnsavedChangesBar as a7, type FloatingUnsavedChangesBarProps as a8, FormSection as a9, Page as aA, PageHeader as aB, type PageHeaderProps as aC, type PageProps as aD, PlanBadge as aE, type PlanBadgeProps as aF, type PlanBadgeTone as aG, RESERVED_GRADIENT_TOKENS as aH, ResourceCard as aI, type ResourceCardProps as aJ, type ReviewResult as aK, SEMANTIC_COLOR_TOKENS as aL, SLOP_BUDGETS as aM, SearchInput as aN, type SearchInputProps as aO, Section as aP, type SectionProps as aQ, type SemanticColorToken as aR, SettingsSection as aS, SettingsSectionHeader as aT, type SettingsSectionHeaderProps as aU, type SettingsSectionProps as aV, Sparkline as aW, type SparklineProps as aX, StatTile as aY, type StatTileProps as aZ, StatusBadge as a_, type FormSectionProps as aa, HOUSE_RULES as ab, type HouseRule as ac, INTEGRATION_CATALOG_CARD_HEIGHT_CLASS as ad, InfoCard as ae, type InfoCardProps as af, type InfoCardTone as ag, IntegrationCard as ah, type IntegrationCardProps as ai, type IntegrationCardStatus as aj, IntegrationsEmptyState as ak, type IntegrationsEmptyStateProps as al, LineAreaChart as am, type LineAreaChartProps as an, type LintFinding as ao, type LintOptions as ap, type LintResult as aq, type LintSeverity as ar, MetricChartCard as as, type MetricChartCardProps as at, type MetricChartMetric as au, MetricRow as av, type MetricRowItem as aw, type MetricRowProps as ax, MetricTile as ay, type MetricTileProps as az, type AppChatPanelProps as b, type StatusBadgeTone as b0, StatusDot as b1, type StatusDotProps as b2, type StatusDotTone as b3, SubNav as b4, type SubNavItem as b5, type SubNavProps as b6, SurfaceCard as b7, type SurfaceCardProps as b8, TAILWIND_PALETTE_COLORS as b9, themeToCss as bA, useAppCopilotContext as bB, useAppShellChat as bC, THEME_AGENT_INSTRUCTIONS as ba, TIMBAL_THEME_PRESETS as bb, ThemePresetGallery as bc, type ThemePresetGalleryProps as bd, type ThemeShadow as be, type ThemeToCssOptions as bf, type ThemeTokenMap as bg, type TimbalThemeIntent as bh, type TimbalThemePreset as bi, type TimbalThemePresetId as bj, TimbalThemeStyle as bk, type TimbalThemeStyleProps as bl, type TimbalThemeTokens as bm, type TimbalThemeTypography as bn, UI_REVIEW_AGENT_INSTRUCTIONS as bo, applyThemePreset as bp, applyTimbalTheme as bq, clearTimbalTheme as br, connectionRowListClass as bs, createTimbalTheme as bt, ensureThemeFontLink as bu, formatLintReport as bv, getStoredThemePreset as bw, getThemePreset as bx, lintGeneratedUi as by, reviewGeneratedUi as bz, AppConfirmDialog as c, type AppConfirmDialogProps as d, type AppCopilotContextValue as e, AppCopilotProvider as f, type AppCopilotProviderProps as g, AppShell as h, type AppShellChatControls as i, AppShellChatTrigger as j, type AppShellChatTriggerProps as k, type AppShellProps as l, AppShellTopbar as m, type AppShellTopbarProps as n, type BreadcrumbItem as o, Breadcrumbs as p, type BreadcrumbsProps as q, COLOR_UTILITY_PREFIXES as r, ChartArtifactView as s, type ChartLayout as t, ChartPanel as u, type ChartPanelProps as v, type ChartSeries as w, type ChartVariant as x, ConnectionRow as y, ConnectionRowList as z };
+export { FieldInput as $, APP_KIT_AGENT_INSTRUCTIONS as A, type BreadcrumbEntry as B, CHART_PALETTE as C, type ChartSeries as D, type ChartTooltipIndicator as E, type ChartVariant as F, ConnectionRow as G, ConnectionRowList as H, type ConnectionRowListProps as I, type ConnectionRowProps as J, DangerZone as K, DangerZoneAction as L, type DangerZoneActionProps as M, type DangerZoneProps as N, DataTable as O, type DataTableColumn as P, type DataTableProps as Q, type DataTableSort as R, type DataTableSortDirection as S, type DescriptionItem as T, DescriptionList as U, type DescriptionListProps as V, EmptyState as W, type EmptyStateProps as X, ExpandableSection as Y, type ExpandableSectionProps as Z, Field as _, AppChatPanel as a, type SearchInputProps as a$, type FieldInputProps as a0, type FieldProps as a1, FieldRow as a2, type FieldRowProps as a3, FieldSelect as a4, type FieldSelectProps as a5, FieldSwitch as a6, type FieldSwitchProps as a7, FieldTextarea as a8, type FieldTextareaProps as a9, type MetricChartCardProps as aA, type MetricChartMetric as aB, MetricRow as aC, type MetricRowItem as aD, type MetricRowProps as aE, MetricTile as aF, type MetricTileProps as aG, Page as aH, PageHeader as aI, type PageHeaderProps as aJ, type PageProps as aK, PieChart as aL, type PieChartProps as aM, PlanBadge as aN, type PlanBadgeProps as aO, type PlanBadgeTone as aP, RESERVED_GRADIENT_TOKENS as aQ, RadarChart as aR, type RadarChartProps as aS, RadialChart as aT, type RadialChartProps as aU, ResourceCard as aV, type ResourceCardProps as aW, type ReviewResult as aX, SEMANTIC_COLOR_TOKENS as aY, SLOP_BUDGETS as aZ, SearchInput as a_, FilterBar as aa, type FilterBarProps as ab, FilterField as ac, type FilterFieldProps as ad, FloatingUnsavedChangesBar as ae, type FloatingUnsavedChangesBarProps as af, FormSection as ag, type FormSectionProps as ah, HOUSE_RULES as ai, type HouseRule as aj, INTEGRATION_CATALOG_CARD_HEIGHT_CLASS as ak, InfoCard as al, type InfoCardProps as am, type InfoCardTone as an, IntegrationCard as ao, type IntegrationCardProps as ap, type IntegrationCardStatus as aq, IntegrationsEmptyState as ar, type IntegrationsEmptyStateProps as as, LineAreaChart as at, type LineAreaChartProps as au, type LintFinding as av, type LintOptions as aw, type LintResult as ax, type LintSeverity as ay, MetricChartCard as az, type AppChatPanelProps as b, Section as b0, type SectionProps as b1, type SemanticColorToken as b2, SettingsSection as b3, SettingsSectionHeader as b4, type SettingsSectionHeaderProps as b5, type SettingsSectionProps as b6, Sparkline as b7, type SparklineProps as b8, StatTile as b9, type TimbalThemeTypography as bA, UI_REVIEW_AGENT_INSTRUCTIONS as bB, type UseLiveQueryOptions as bC, type UseLiveQueryResult as bD, applyThemePreset as bE, applyTimbalTheme as bF, clearTimbalTheme as bG, connectionRowListClass as bH, createTimbalTheme as bI, ensureThemeFontLink as bJ, flushBarCategoryGap as bK, flushLineAreaEdgeToEdge as bL, formatLintReport as bM, getStoredThemePreset as bN, getThemePreset as bO, lintGeneratedUi as bP, resolveChartMargin as bQ, resolveTooltipCategory as bR, reviewGeneratedUi as bS, themeToCss as bT, useAppCopilotContext as bU, useAppShellChat as bV, useAppShellNav as bW, useInterval as bX, useLiveQuery as bY, type StatTileProps as ba, StatusBadge as bb, type StatusBadgeProps as bc, type StatusBadgeTone as bd, StatusDot as be, type StatusDotProps as bf, type StatusDotTone as bg, SubNav as bh, type SubNavItem as bi, type SubNavProps as bj, SurfaceCard as bk, type SurfaceCardProps as bl, TAILWIND_PALETTE_COLORS as bm, THEME_AGENT_INSTRUCTIONS as bn, TIMBAL_THEME_PRESETS as bo, ThemePresetGallery as bp, type ThemePresetGalleryProps as bq, type ThemeShadow as br, type ThemeToCssOptions as bs, type ThemeTokenMap as bt, type TimbalThemeIntent as bu, type TimbalThemePreset as bv, type TimbalThemePresetId as bw, TimbalThemeStyle as bx, type TimbalThemeStyleProps as by, type TimbalThemeTokens as bz, AppConfirmDialog as c, type AppConfirmDialogProps as d, type AppCopilotContextValue as e, AppCopilotProvider as f, type AppCopilotProviderProps as g, AppShell as h, type AppShellChatControls as i, AppShellChatTrigger as j, type AppShellChatTriggerProps as k, type AppShellNavControls as l, type AppShellProps as m, AppShellSidebarTrigger as n, type AppShellSidebarTriggerProps as o, AppShellTopbar as p, type AppShellTopbarProps as q, type BreadcrumbItem as r, Breadcrumbs as s, type BreadcrumbsProps as t, COLOR_UTILITY_PREFIXES as u, ChartArtifactView as v, type ChartLayout as w, type ChartMargin as x, ChartPanel as y, type ChartPanelProps as z };

package/dist/{chat-Bed4FQSl.d.cts → chat-ClmzWzCX.d.cts}

@@ -204,19 +204,48 @@ declare function isUiBinding(value: unknown): value is {
     $bind: string;
 };
 
+/** Per-series presentation config (shadcn `ChartConfig` analog). */
+interface ChartSeriesConfig {
+    dataKey: string;
+    /** Legend / tooltip label. Defaults to `dataKey`. */
+    label?: string;
+    /** CSS color (token or literal). Defaults to the theme `--chart-N` palette. */
+    color?: string;
+}
 interface ChartArtifact {
     type: "chart";
-    /** Chart kind. Renderer maps these to the underlying lib (e.g. recharts). */
-    chartType?: "bar" | "line" | "area" | "pie";
+    /** Chart kind. Cartesian kinds share one SVG engine; pie/donut/radial/radar are radial. */
+    chartType?: "bar" | "horizontalBar" | "line" | "area" | "pie" | "donut" | "radial" | "radar";
     /** Optional title rendered above the chart. */
     title?: string;
+    /** Optional sub-title / caption rendered under the title. */
+    description?: string;
     /** Array of data points. Keys map to series via `dataKey` / `xKey`. */
     data: Array<Record<string, unknown>>;
     /** Field name on each data point used for the X axis / category. */
     xKey?: string;
     /** Field name(s) used for series. Defaults to all keys except `xKey`. */
     dataKey?: string | string[];
-    /** Optional unit label appended to numeric axis ticks. */
+    /**
+     * Rich per-series config (labels + colors). Takes precedence over `dataKey`.
+     * Mirrors shadcn's `ChartConfig`.
+     */
+    series?: ChartSeriesConfig[];
+    /** Stack bar / area series on top of each other. */
+    stacked?: boolean;
+    /** Line / area interpolation. Default `monotone`. */
+    curve?: "monotone" | "linear" | "step";
+    /** Draw point markers on line / area series. */
+    dots?: boolean;
+    /** Tooltip series marker style. Default `dot`. */
+    tooltipIndicator?: "dot" | "line" | "dashed";
+    /** Show the series legend. */
+    legend?: boolean;
+    /** Show category / value axis ticks on flush cartesian charts. Default false (tooltips carry labels). */
+    showAxes?: boolean;
+    /** Per-slice / per-ring colors for pie / donut / radial. */
+    colors?: string[];
+    /** Optional unit label appended to numeric axis ticks and tooltip values. */
     unit?: string;
 }
 interface QuestionOption {
@@ -657,4 +686,4 @@ interface TimbalChatProps extends Omit<TimbalRuntimeProviderProps, "children">,
 }
 declare function TimbalChat({ workforceId, baseUrl, fetch, attachments, attachmentsUploadUrl, attachmentsAccept, debug, ...threadProps }: TimbalChatProps): react_jsx_runtime.JSX.Element;
 
-export { UiCustomNodeRegistryProvider as $, useTimbalRuntime as A, useTimbalStream as B, type ChartArtifact as C, type UiArtifact as D, type UiNode as E, type AnyArtifact as F, type TableArtifact as G, type HtmlArtifact as H, type ArtifactRegistry as I, type JsonArtifact as J, ArtifactRegistryProvider as K, type ArtifactRenderer as L, type ArtifactRendererProps as M, ArtifactView as N, type CreateDefaultAttachmentAdapterOptions as O, type CreateUploadAttachmentAdapterOptions as P, type QuestionArtifact as Q, DEFAULT_UPLOAD_ACCEPT as R, type SendOptions as S, type ThreadVariant as T, type UseTimbalStreamOptions as U, type QuestionOption as V, type ResolveAttachmentAdapterOptions as W, type TimbalArtifact as X, type TimbalAttachmentsConfig as Y, type TimbalAttachmentsProp as Z, type UiAction as _, TimbalChat as a, type UiEventEnvelope as a0, UiEventProvider as a1, type UploadFetchFn as a2, createDefaultAttachmentAdapter as a3, createUploadAttachmentAdapter as a4, defaultArtifactRenderers as a5, getPath as a6, isArtifact as a7, isUiBinding as a8, resolveAttachmentAdapter as a9, resolveBindable as aa, setPath as ab, useArtifactRegistry as ac, useUiCustomNodeRegistry as ad, useUiDispatch as ae, useUiEventEmitter as af, useUiState as ag, type TimbalChatProps as b, type ChatAttachment as c, type ChatMessage as d, Composer as e, type ComposerProps as f, type ContentPart as g, Suggestions as h, type SuggestionsComponent as i, type SuggestionsSlotProps as j, type SuggestionsSource as k, type TextContentPart as l, type ThinkingContentPart as m, Thread as n, type ThreadArtifactsConfig as o, type ThreadComponents as p, type ThreadProps as q, type ThreadSuggestion as r, type ThreadSuggestionsProps as s, type ThreadWelcomeConfig as t, type ThreadWelcomeProps as u, TimbalRuntimeProvider as v, type TimbalRuntimeProviderProps as w, type TimbalStreamApi as x, type ToolCallContentPart as y, useResolvedSuggestions as z };
+export { type UiAction as $, useResolvedSuggestions as A, useTimbalRuntime as B, type ChartArtifact as C, useTimbalStream as D, type UiArtifact as E, type UiNode as F, type AnyArtifact as G, type HtmlArtifact as H, type TableArtifact as I, type JsonArtifact as J, type ArtifactRegistry as K, ArtifactRegistryProvider as L, type ArtifactRenderer as M, type ArtifactRendererProps as N, ArtifactView as O, type CreateDefaultAttachmentAdapterOptions as P, type QuestionArtifact as Q, type CreateUploadAttachmentAdapterOptions as R, type SendOptions as S, type ThreadVariant as T, type UseTimbalStreamOptions as U, DEFAULT_UPLOAD_ACCEPT as V, type QuestionOption as W, type ResolveAttachmentAdapterOptions as X, type TimbalArtifact as Y, type TimbalAttachmentsConfig as Z, type TimbalAttachmentsProp as _, type ChartSeriesConfig as a, UiCustomNodeRegistryProvider as a0, type UiEventEnvelope as a1, UiEventProvider as a2, type UploadFetchFn as a3, createDefaultAttachmentAdapter as a4, createUploadAttachmentAdapter as a5, defaultArtifactRenderers as a6, getPath as a7, isArtifact as a8, isUiBinding as a9, resolveAttachmentAdapter as aa, resolveBindable as ab, setPath as ac, useArtifactRegistry as ad, useUiCustomNodeRegistry as ae, useUiDispatch as af, useUiEventEmitter as ag, useUiState as ah, TimbalChat as b, type TimbalChatProps as c, type ChatAttachment as d, type ChatMessage as e, Composer as f, type ComposerProps as g, type ContentPart as h, Suggestions as i, type SuggestionsComponent as j, type SuggestionsSlotProps as k, type SuggestionsSource as l, type TextContentPart as m, type ThinkingContentPart as n, Thread as o, type ThreadArtifactsConfig as p, type ThreadComponents as q, type ThreadProps as r, type ThreadSuggestion as s, type ThreadSuggestionsProps as t, type ThreadWelcomeConfig as u, type ThreadWelcomeProps as v, TimbalRuntimeProvider as w, type TimbalRuntimeProviderProps as x, type TimbalStreamApi as y, type ToolCallContentPart as z };

package/dist/{chat-Bed4FQSl.d.ts → chat-ClmzWzCX.d.ts}

@@ -204,19 +204,48 @@ declare function isUiBinding(value: unknown): value is {
     $bind: string;
 };
 
+/** Per-series presentation config (shadcn `ChartConfig` analog). */
+interface ChartSeriesConfig {
+    dataKey: string;
+    /** Legend / tooltip label. Defaults to `dataKey`. */
+    label?: string;
+    /** CSS color (token or literal). Defaults to the theme `--chart-N` palette. */
+    color?: string;
+}
 interface ChartArtifact {
     type: "chart";
-    /** Chart kind. Renderer maps these to the underlying lib (e.g. recharts). */
-    chartType?: "bar" | "line" | "area" | "pie";
+    /** Chart kind. Cartesian kinds share one SVG engine; pie/donut/radial/radar are radial. */
+    chartType?: "bar" | "horizontalBar" | "line" | "area" | "pie" | "donut" | "radial" | "radar";
     /** Optional title rendered above the chart. */
     title?: string;
+    /** Optional sub-title / caption rendered under the title. */
+    description?: string;
     /** Array of data points. Keys map to series via `dataKey` / `xKey`. */
     data: Array<Record<string, unknown>>;
     /** Field name on each data point used for the X axis / category. */
     xKey?: string;
     /** Field name(s) used for series. Defaults to all keys except `xKey`. */
     dataKey?: string | string[];
-    /** Optional unit label appended to numeric axis ticks. */
+    /**
+     * Rich per-series config (labels + colors). Takes precedence over `dataKey`.
+     * Mirrors shadcn's `ChartConfig`.
+     */
+    series?: ChartSeriesConfig[];
+    /** Stack bar / area series on top of each other. */
+    stacked?: boolean;
+    /** Line / area interpolation. Default `monotone`. */
+    curve?: "monotone" | "linear" | "step";
+    /** Draw point markers on line / area series. */
+    dots?: boolean;
+    /** Tooltip series marker style. Default `dot`. */
+    tooltipIndicator?: "dot" | "line" | "dashed";
+    /** Show the series legend. */
+    legend?: boolean;
+    /** Show category / value axis ticks on flush cartesian charts. Default false (tooltips carry labels). */
+    showAxes?: boolean;
+    /** Per-slice / per-ring colors for pie / donut / radial. */
+    colors?: string[];
+    /** Optional unit label appended to numeric axis ticks and tooltip values. */
     unit?: string;
 }
 interface QuestionOption {
@@ -657,4 +686,4 @@ interface TimbalChatProps extends Omit<TimbalRuntimeProviderProps, "children">,
 }
 declare function TimbalChat({ workforceId, baseUrl, fetch, attachments, attachmentsUploadUrl, attachmentsAccept, debug, ...threadProps }: TimbalChatProps): react_jsx_runtime.JSX.Element;
 
-export { UiCustomNodeRegistryProvider as $, useTimbalRuntime as A, useTimbalStream as B, type ChartArtifact as C, type UiArtifact as D, type UiNode as E, type AnyArtifact as F, type TableArtifact as G, type HtmlArtifact as H, type ArtifactRegistry as I, type JsonArtifact as J, ArtifactRegistryProvider as K, type ArtifactRenderer as L, type ArtifactRendererProps as M, ArtifactView as N, type CreateDefaultAttachmentAdapterOptions as O, type CreateUploadAttachmentAdapterOptions as P, type QuestionArtifact as Q, DEFAULT_UPLOAD_ACCEPT as R, type SendOptions as S, type ThreadVariant as T, type UseTimbalStreamOptions as U, type QuestionOption as V, type ResolveAttachmentAdapterOptions as W, type TimbalArtifact as X, type TimbalAttachmentsConfig as Y, type TimbalAttachmentsProp as Z, type UiAction as _, TimbalChat as a, type UiEventEnvelope as a0, UiEventProvider as a1, type UploadFetchFn as a2, createDefaultAttachmentAdapter as a3, createUploadAttachmentAdapter as a4, defaultArtifactRenderers as a5, getPath as a6, isArtifact as a7, isUiBinding as a8, resolveAttachmentAdapter as a9, resolveBindable as aa, setPath as ab, useArtifactRegistry as ac, useUiCustomNodeRegistry as ad, useUiDispatch as ae, useUiEventEmitter as af, useUiState as ag, type TimbalChatProps as b, type ChatAttachment as c, type ChatMessage as d, Composer as e, type ComposerProps as f, type ContentPart as g, Suggestions as h, type SuggestionsComponent as i, type SuggestionsSlotProps as j, type SuggestionsSource as k, type TextContentPart as l, type ThinkingContentPart as m, Thread as n, type ThreadArtifactsConfig as o, type ThreadComponents as p, type ThreadProps as q, type ThreadSuggestion as r, type ThreadSuggestionsProps as s, type ThreadWelcomeConfig as t, type ThreadWelcomeProps as u, TimbalRuntimeProvider as v, type TimbalRuntimeProviderProps as w, type TimbalStreamApi as x, type ToolCallContentPart as y, useResolvedSuggestions as z };
+export { type UiAction as $, useResolvedSuggestions as A, useTimbalRuntime as B, type ChartArtifact as C, useTimbalStream as D, type UiArtifact as E, type UiNode as F, type AnyArtifact as G, type HtmlArtifact as H, type TableArtifact as I, type JsonArtifact as J, type ArtifactRegistry as K, ArtifactRegistryProvider as L, type ArtifactRenderer as M, type ArtifactRendererProps as N, ArtifactView as O, type CreateDefaultAttachmentAdapterOptions as P, type QuestionArtifact as Q, type CreateUploadAttachmentAdapterOptions as R, type SendOptions as S, type ThreadVariant as T, type UseTimbalStreamOptions as U, DEFAULT_UPLOAD_ACCEPT as V, type QuestionOption as W, type ResolveAttachmentAdapterOptions as X, type TimbalArtifact as Y, type TimbalAttachmentsConfig as Z, type TimbalAttachmentsProp as _, type ChartSeriesConfig as a, UiCustomNodeRegistryProvider as a0, type UiEventEnvelope as a1, UiEventProvider as a2, type UploadFetchFn as a3, createDefaultAttachmentAdapter as a4, createUploadAttachmentAdapter as a5, defaultArtifactRenderers as a6, getPath as a7, isArtifact as a8, isUiBinding as a9, resolveAttachmentAdapter as aa, resolveBindable as ab, setPath as ac, useArtifactRegistry as ad, useUiCustomNodeRegistry as ae, useUiDispatch as af, useUiEventEmitter as ag, useUiState as ah, TimbalChat as b, type TimbalChatProps as c, type ChatAttachment as d, type ChatMessage as e, Composer as f, type ComposerProps as g, type ContentPart as h, Suggestions as i, type SuggestionsComponent as j, type SuggestionsSlotProps as k, type SuggestionsSource as l, type TextContentPart as m, type ThinkingContentPart as n, Thread as o, type ThreadArtifactsConfig as p, type ThreadComponents as q, type ThreadProps as r, type ThreadSuggestion as s, type ThreadSuggestionsProps as t, type ThreadWelcomeConfig as u, type ThreadWelcomeProps as v, TimbalRuntimeProvider as w, type TimbalRuntimeProviderProps as x, type TimbalStreamApi as y, type ToolCallContentPart as z };