@timbal-ai/timbal-react 0.8.2 → 1.1.0

package/dist/{chart-artifact-BzcvblDe.d.cts → chart-artifact-CX-rh9nq.d.cts}

@@ -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.cjs';
+import { x as TimbalRuntimeProviderProps, r as ThreadProps, C as ChartArtifact } from './chat-DCms8pJ_.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
@@ -16,6 +16,179 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
  */
 declare const APP_KIT_AGENT_INSTRUCTIONS: string;
 
+/**
+ * The single source of truth for what generated Timbal UIs are *allowed* to
+ * look like — the anti-slop constraint, encoded as data.
+ *
+ * Both the deterministic linter (`ui-lint.ts`) and the agent prompt
+ * (`APP_KIT_AGENT_INSTRUCTIONS`) read from this module, so the rules a model is
+ * told and the rules it is checked against can never drift apart.
+ *
+ * "Slop" = the generic AI-dashboard look: a decorative icon on every tile,
+ * loud green/red trend pills, arbitrary palette colors, gratuitous dividers,
+ * card-in-card nesting, bold giant numbers. Taste lives here, not in prose.
+ *
+ * This is a **public, documented** API (exported from the package root and
+ * `/app`), in the same tier as the theme generator — not an internal class
+ * composite.
+ */
+/**
+ * Semantic color token roots the design system defines (see `styles.css`).
+ * Generated code may only reach for colors through these — `bg-background`,
+ * `text-muted-foreground`, `border-border`, `text-primary`, `bg-destructive`,
+ * the timbal chrome extensions, etc. Anything else is slop.
+ */
+declare const SEMANTIC_COLOR_TOKENS: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "destructive-foreground", "border", "input", "ring", "sidebar", "sidebar-foreground", "sidebar-primary", "sidebar-primary-foreground", "sidebar-accent", "sidebar-accent-foreground", "sidebar-border", "sidebar-ring", "elevated-from", "elevated-to", "modal-from", "modal-to", "playground-from", "playground-via", "playground-to", "composer-bg", "composer-border", "composer-border-focus", "bubble-user", "bubble-user-foreground", "code-block-bg", "code-header-bg"];
+type SemanticColorToken = (typeof SEMANTIC_COLOR_TOKENS)[number];
+/**
+ * Gradient / fill tokens reserved for **chrome only** (buttons, the elevated
+ * surface, the modal shell, the playground backdrop). They must never decorate
+ * a data card, a stat tile, or a list — that is the canonical "slop gradient".
+ */
+declare const RESERVED_GRADIENT_TOKENS: readonly ["primary-fill-from", "primary-fill-to", "primary-fill-hover-from", "primary-fill-hover-to", "primary-fill-active-from", "primary-fill-active-to", "secondary-fill-hover-from", "secondary-fill-hover-to", "secondary-fill-active-from", "secondary-fill-active-to", "destructive-fill-hover-from", "destructive-fill-hover-to", "destructive-fill-active-from", "destructive-fill-active-to", "ghost-fill-hover", "ghost-fill-active", "elevated-from", "elevated-to", "modal-from", "modal-to", "playground-from", "playground-via", "playground-to"];
+/**
+ * The Tailwind named palette. Any of these followed by a numeric shade
+ * (`-50`..`-950`) in a color utility is a hardcoded color — not a token —
+ * and is rejected by the linter.
+ */
+declare const TAILWIND_PALETTE_COLORS: readonly ["slate", "gray", "zinc", "neutral", "stone", "red", "orange", "amber", "yellow", "lime", "green", "emerald", "teal", "cyan", "sky", "blue", "indigo", "violet", "purple", "fuchsia", "pink", "rose"];
+/** Tailwind color-bearing utility prefixes the linter inspects. */
+declare const COLOR_UTILITY_PREFIXES: readonly ["bg", "text", "border", "ring", "from", "via", "to", "fill", "stroke", "decoration", "outline", "shadow", "divide", "accent", "caret"];
+/**
+ * Numeric budgets the linter enforces. Tuned for "tasteful dashboard", not
+ * "icon confetti". A view that needs more icons than this is almost always
+ * decorating instead of communicating.
+ */
+declare const SLOP_BUDGETS: {
+    /** Max decorative/standalone icons rendered in a single generated file. */
+    readonly maxIconsPerView: 6;
+    /** Max consecutive list rows separated by an explicit border/divider before
+     *  it reads as a "ruled table" — prefer spacing or zebra instead. */
+    readonly maxRowDividers: 2;
+};
+/**
+ * House-style rules in plain language. The prompt renders these verbatim and
+ * the linter maps each `id` to a check, so the model is told and tested on the
+ * exact same list.
+ */
+interface HouseRule {
+    id: string;
+    /** One-line imperative the agent reads. */
+    rule: string;
+    /** Why it matters (kept short — models follow rules with rationale better). */
+    why: string;
+    /** A wrong example (kept to a fragment). */
+    slop?: string;
+    /** The tasteful equivalent. */
+    good?: string;
+}
+declare const HOUSE_RULES: readonly HouseRule[];
+
+/**
+ * Deterministic anti-slop linter for generated Timbal UI code.
+ *
+ * Runs a dependency-free line scan over a `.tsx` string and flags the patterns
+ * that turn a clean dashboard into generic AI slop: hardcoded colors, icon
+ * spam, bold giant numbers, divider-per-row lists, gradients on data cards.
+ *
+ * It intentionally avoids a full AST/parser dependency — the checks are
+ * line/regex heuristics tuned for high precision on the patterns that actually
+ * recur in generated output. Feed `formatLintReport(findings)` back to the
+ * generating agent (see `reviewGeneratedUi`) so it can self-correct.
+ *
+ * Public, documented API — exported from the package root and `/app`.
+ */
+type LintSeverity = "error" | "warn";
+interface LintFinding {
+    /** Stable rule id (maps to a HouseRule where applicable). */
+    rule: string;
+    severity: LintSeverity;
+    /** 1-based line number in the supplied source. */
+    line: number;
+    /** Human-readable explanation + fix. */
+    message: string;
+    /** The offending source fragment (trimmed). */
+    snippet: string;
+}
+interface LintResult {
+    findings: LintFinding[];
+    errorCount: number;
+    warnCount: number;
+    /** True when there are no `error`-severity findings. */
+    ok: boolean;
+}
+interface LintOptions {
+    /** Max standalone icons before `icon-spam` fires. Defaults to the budget. */
+    maxIconsPerView?: number;
+    /** Max bordered list rows before `row-divider` fires. Defaults to the budget. */
+    maxRowDividers?: number;
+    /** Treat warnings as errors (so `ok` reflects them too). */
+    strict?: boolean;
+}
+/**
+ * Lint a single generated `.tsx` (or fragment) string for slop.
+ *
+ * @example
+ * ```ts
+ * const { ok, findings } = lintGeneratedUi(generatedTsx);
+ * if (!ok) sendBackToAgent(formatLintReport(findings));
+ * ```
+ */
+declare function lintGeneratedUi(source: string, options?: LintOptions): LintResult;
+/**
+ * Render lint findings as a compact, agent- and human-readable report.
+ * Empty string when there are no findings.
+ */
+declare function formatLintReport(findings: LintFinding[]): string;
+
+/**
+ * Layer 4 of the anti-slop system: the critique loop.
+ *
+ * `reviewGeneratedUi` runs the deterministic linter (Layer 2) and packages the
+ * result into something a generating agent can act on in one round-trip — a
+ * pass/fail verdict plus a ready-to-send revision prompt that names the exact
+ * lines and fixes. The system prompt string (`UI_REVIEW_AGENT_INSTRUCTIONS`)
+ * teaches the model to self-review *before* it returns code, so the loop is
+ * usually closed without a second model call.
+ *
+ * Public, documented API — exported from the package root and `/app`.
+ */
+
+interface ReviewResult {
+    /** Raw linter output. */
+    lint: LintResult;
+    /** True when no blocking (error-severity, or any warning in strict mode) findings remain. */
+    passed: boolean;
+    /** Compact human/agent-readable report ("" when clean). */
+    report: string;
+    /**
+     * A ready-to-send follow-up prompt instructing the agent to fix the findings,
+     * or `null` when the UI passed. Send this back to the model and re-run
+     * `reviewGeneratedUi` on its next output until `passed` is true.
+     */
+    revisionPrompt: string | null;
+}
+/**
+ * Review a generated `.tsx` string for slop and produce an actionable verdict.
+ *
+ * @example
+ * ```ts
+ * let code = await generate(userPrompt);
+ * for (let i = 0; i < 2; i++) {
+ *   const review = reviewGeneratedUi(code, { strict: true });
+ *   if (review.passed) break;
+ *   code = await generate(review.revisionPrompt!); // agent fixes named issues
+ * }
+ * ```
+ */
+declare function reviewGeneratedUi(source: string, options?: LintOptions): ReviewResult;
+/**
+ * Append to a UI-generation agent's system prompt so it self-reviews before
+ * returning code. Pairs with `APP_KIT_AGENT_INSTRUCTIONS` and
+ * `THEME_AGENT_INSTRUCTIONS`.
+ */
+declare const UI_REVIEW_AGENT_INSTRUCTIONS: string;
+
 /**
  * Theme generator — turn brand *intent* into a complete, paired light + dark
  * token set, so agents and apps never hand-author `oklch(...)` or risk a
@@ -264,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;
 }
@@ -307,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;
@@ -376,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;
@@ -664,13 +875,15 @@ interface SubNavProps {
  */
 declare const SubNav: FC<SubNavProps>;
 
-interface BreadcrumbItem {
+interface BreadcrumbEntry {
     label: ReactNode;
     href?: string;
     onClick?: () => void;
 }
+/** @deprecated Use `BreadcrumbEntry` — avoids clashing with the UI `BreadcrumbItem` primitive. */
+type BreadcrumbItem = BreadcrumbEntry;
 interface BreadcrumbsProps {
-    items: BreadcrumbItem[];
+    items: BreadcrumbEntry[];
     className?: string;
 }
 declare const Breadcrumbs: FC<BreadcrumbsProps>;
@@ -734,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;
@@ -769,8 +991,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;
@@ -781,6 +1030,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;
 }
 /**
@@ -837,6 +1088,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;
 }
 /**
@@ -845,8 +1098,15 @@ 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";
+
+/**
+ * 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, #6366f1)", "var(--chart-2, #10b981)", "var(--chart-3, #f59e0b)", "var(--chart-4, #a855f7)", "var(--chart-5, #ef4444)", "var(--chart-6, #06b6d4)"];
 interface ChartSeries {
     dataKey: string;
     label?: string;
@@ -856,6 +1116,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. */
@@ -869,7 +1131,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;
@@ -877,6 +1151,8 @@ 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;
     className?: string;
@@ -884,9 +1160,10 @@ interface LineAreaChartProps {
     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>;
 
@@ -925,6 +1202,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;
 }
 /**
@@ -933,6 +1212,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>>;
@@ -960,10 +1375,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 { FieldSwitch as $, APP_KIT_AGENT_INSTRUCTIONS as A, type BreadcrumbItem as B, CHART_PALETTE as C, DangerZone as D, DangerZoneAction as E, type DangerZoneActionProps as F, type DangerZoneProps as G, DataTable as H, type DataTableColumn as I, type DataTableProps as J, type DataTableSort as K, type DataTableSortDirection as L, type DescriptionItem as M, DescriptionList as N, type DescriptionListProps as O, EmptyState as P, type EmptyStateProps as Q, ExpandableSection as R, type ExpandableSectionProps as S, Field as T, FieldInput as U, type FieldInputProps as V, type FieldProps as W, FieldRow as X, type FieldRowProps as Y, FieldSelect as Z, type FieldSelectProps as _, AppChatPanel as a, type ThemePresetGalleryProps as a$, type FieldSwitchProps as a0, FieldTextarea as a1, type FieldTextareaProps as a2, FilterBar as a3, type FilterBarProps as a4, FloatingUnsavedChangesBar as a5, type FloatingUnsavedChangesBarProps as a6, FormSection as a7, type FormSectionProps as a8, INTEGRATION_CATALOG_CARD_HEIGHT_CLASS as a9, type ResourceCardProps as aA, SearchInput as aB, type SearchInputProps as aC, Section as aD, type SectionProps as aE, SettingsSection as aF, SettingsSectionHeader as aG, type SettingsSectionHeaderProps as aH, type SettingsSectionProps as aI, Sparkline as aJ, type SparklineProps as aK, StatTile as aL, type StatTileProps as aM, StatusBadge as aN, type StatusBadgeProps as aO, type StatusBadgeTone as aP, StatusDot as aQ, type StatusDotProps as aR, type StatusDotTone as aS, SubNav as aT, type SubNavItem as aU, type SubNavProps as aV, SurfaceCard as aW, type SurfaceCardProps as aX, THEME_AGENT_INSTRUCTIONS as aY, TIMBAL_THEME_PRESETS as aZ, ThemePresetGallery as a_, InfoCard as aa, type InfoCardProps as ab, type InfoCardTone as ac, IntegrationCard as ad, type IntegrationCardProps as ae, type IntegrationCardStatus as af, IntegrationsEmptyState as ag, type IntegrationsEmptyStateProps as ah, LineAreaChart as ai, type LineAreaChartProps as aj, MetricChartCard as ak, type MetricChartCardProps as al, type MetricChartMetric as am, MetricRow as an, type MetricRowItem as ao, type MetricRowProps as ap, MetricTile as aq, type MetricTileProps as ar, Page as as, PageHeader as at, type PageHeaderProps as au, type PageProps as av, PlanBadge as aw, type PlanBadgeProps as ax, type PlanBadgeTone as ay, ResourceCard as az, type AppChatPanelProps as b, type ThemeShadow as b0, type ThemeToCssOptions as b1, type ThemeTokenMap as b2, type TimbalThemeIntent as b3, type TimbalThemePreset as b4, type TimbalThemePresetId as b5, TimbalThemeStyle as b6, type TimbalThemeStyleProps as b7, type TimbalThemeTokens as b8, type TimbalThemeTypography as b9, applyThemePreset as ba, applyTimbalTheme as bb, clearTimbalTheme as bc, connectionRowListClass as bd, createTimbalTheme as be, ensureThemeFontLink as bf, getStoredThemePreset as bg, getThemePreset as bh, themeToCss as bi, useAppCopilotContext as bj, useAppShellChat as bk, 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, Breadcrumbs as o, type BreadcrumbsProps as p, ChartArtifactView as q, type ChartLayout as r, ChartPanel as s, type ChartPanelProps as t, type ChartSeries as u, type ChartVariant as v, ConnectionRow as w, ConnectionRowList as x, type ConnectionRowListProps as y, type ConnectionRowProps as z };
+export { type FieldInputProps as $, APP_KIT_AGENT_INSTRUCTIONS as A, type BreadcrumbEntry as B, CHART_PALETTE as C, type ChartTooltipIndicator as D, type ChartVariant as E, ConnectionRow as F, ConnectionRowList as G, type ConnectionRowListProps as H, type ConnectionRowProps as I, DangerZone as J, DangerZoneAction as K, type DangerZoneActionProps as L, type DangerZoneProps as M, DataTable as N, type DataTableColumn as O, type DataTableProps as P, type DataTableSort as Q, type DataTableSortDirection as R, type DescriptionItem as S, DescriptionList as T, type DescriptionListProps as U, EmptyState as V, type EmptyStateProps as W, ExpandableSection as X, type ExpandableSectionProps as Y, Field as Z, FieldInput as _, AppChatPanel as a, Section as a$, type FieldProps as a0, FieldRow as a1, type FieldRowProps as a2, FieldSelect as a3, type FieldSelectProps as a4, FieldSwitch as a5, type FieldSwitchProps as a6, FieldTextarea as a7, type FieldTextareaProps as a8, FilterBar as a9, type MetricChartMetric as aA, MetricRow as aB, type MetricRowItem as aC, type MetricRowProps as aD, MetricTile as aE, type MetricTileProps as aF, Page as aG, PageHeader as aH, type PageHeaderProps as aI, type PageProps as aJ, PieChart as aK, type PieChartProps as aL, PlanBadge as aM, type PlanBadgeProps as aN, type PlanBadgeTone as aO, RESERVED_GRADIENT_TOKENS as aP, RadarChart as aQ, type RadarChartProps as aR, RadialChart as aS, type RadialChartProps as aT, ResourceCard as aU, type ResourceCardProps as aV, type ReviewResult as aW, SEMANTIC_COLOR_TOKENS as aX, SLOP_BUDGETS as aY, SearchInput as aZ, type SearchInputProps as a_, type FilterBarProps as aa, FilterField as ab, type FilterFieldProps as ac, FloatingUnsavedChangesBar as ad, type FloatingUnsavedChangesBarProps as ae, FormSection as af, type FormSectionProps as ag, HOUSE_RULES as ah, type HouseRule as ai, INTEGRATION_CATALOG_CARD_HEIGHT_CLASS as aj, InfoCard as ak, type InfoCardProps as al, type InfoCardTone as am, IntegrationCard as an, type IntegrationCardProps as ao, type IntegrationCardStatus as ap, IntegrationsEmptyState as aq, type IntegrationsEmptyStateProps as ar, LineAreaChart as as, type LineAreaChartProps as at, type LintFinding as au, type LintOptions as av, type LintResult as aw, type LintSeverity as ax, MetricChartCard as ay, type MetricChartCardProps as az, type AppChatPanelProps as b, type SectionProps as b0, type SemanticColorToken as b1, SettingsSection as b2, SettingsSectionHeader as b3, type SettingsSectionHeaderProps as b4, type SettingsSectionProps as b5, Sparkline as b6, type SparklineProps as b7, StatTile as b8, type StatTileProps as b9, UI_REVIEW_AGENT_INSTRUCTIONS as bA, type UseLiveQueryOptions as bB, type UseLiveQueryResult as bC, applyThemePreset as bD, applyTimbalTheme as bE, clearTimbalTheme as bF, connectionRowListClass as bG, createTimbalTheme as bH, ensureThemeFontLink as bI, formatLintReport as bJ, getStoredThemePreset as bK, getThemePreset as bL, lintGeneratedUi as bM, reviewGeneratedUi as bN, themeToCss as bO, useAppCopilotContext as bP, useAppShellChat as bQ, useAppShellNav as bR, useInterval as bS, useLiveQuery as bT, StatusBadge as ba, type StatusBadgeProps as bb, type StatusBadgeTone as bc, StatusDot as bd, type StatusDotProps as be, type StatusDotTone as bf, SubNav as bg, type SubNavItem as bh, type SubNavProps as bi, SurfaceCard as bj, type SurfaceCardProps as bk, TAILWIND_PALETTE_COLORS as bl, THEME_AGENT_INSTRUCTIONS as bm, TIMBAL_THEME_PRESETS as bn, ThemePresetGallery as bo, type ThemePresetGalleryProps as bp, type ThemeShadow as bq, type ThemeToCssOptions as br, type ThemeTokenMap as bs, type TimbalThemeIntent as bt, type TimbalThemePreset as bu, type TimbalThemePresetId as bv, TimbalThemeStyle as bw, type TimbalThemeStyleProps as bx, type TimbalThemeTokens as by, type TimbalThemeTypography 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, ChartPanel as x, type ChartPanelProps as y, type ChartSeries as z };

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

@@ -204,19 +204,46 @@ 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;
+    /** 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 +684,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 };