@timbal-ai/timbal-react 1.6.1 → 1.7.0

package/dist/app.d.cts

@@ -1,7 +1,7 @@
-import { A as AppDensity, a as AppDensityClassKey, S as StatusBadgeTone } from './chart-artifact-Dpt4t5sf.cjs';
-export { b as APP_DENSITY_CHART_HEIGHT, c as APP_DENSITY_CLASSES, d as APP_KIT_AGENT_INSTRUCTIONS, e as AppChatPanel, f as AppChatPanelProps, g as AppConfirmDialog, h as AppConfirmDialogProps, i as AppCopilotContextValue, j as AppCopilotProvider, k as AppCopilotProviderProps, l as AppPageWidth, m as AppShell, n as AppShellChatControls, o as AppShellChatTrigger, p as AppShellChatTriggerProps, q as AppShellNavControls, r as AppShellProps, s as AppShellSidebarTrigger, t as AppShellSidebarTriggerProps, B as BreadcrumbEntry, u as BreadcrumbItem, v as Breadcrumbs, w as BreadcrumbsProps, C as CHART_PALETTE, x as COLOR_UTILITY_PREFIXES, y as ChartArtifactView, z as ChartLayout, D as ChartMargin, E as ChartPanel, F as ChartPanelProps, G as ChartSeries, H as ChartTooltipIndicator, I as ChartVariant, J as ConnectionRow, K as ConnectionRowList, L as ConnectionRowListProps, M as ConnectionRowProps, N as DangerZone, O as DangerZoneAction, P as DangerZoneActionProps, Q as DangerZoneProps, R as DataTable, T as DataTableColumn, U as DataTableProps, V as DataTableSort, W as DataTableSortDirection, X as DescriptionItem, Y as DescriptionList, Z as DescriptionListProps, _ as EmptyState, $ as EmptyStateProps, a0 as ExpandableSection, a1 as ExpandableSectionProps, a2 as Field, a3 as FieldInput, a4 as FieldInputProps, a5 as FieldProps, a6 as FieldRow, a7 as FieldRowProps, a8 as FieldSelect, a9 as FieldSelectProps, aa as FieldSwitch, ab as FieldSwitchProps, ac as FieldTextarea, ad as FieldTextareaProps, ae as FilterBar, af as FilterBarProps, ag as FilterDatePreset, ah as FilterDateRangeValue, ai as FilterDropdown, aj as FilterDropdownProps, ak as FilterField, al as FilterFieldDef, am as FilterFieldProps, an as FilterFieldType, ao as FilterNumericOperatorOption, ap as FilterNumericValue, aq as FilterSelectOption, ar as FilterValue, as as FilterValues, at as FloatingUnsavedChangesBar, au as FloatingUnsavedChangesBarProps, av as FormSection, aw as FormSectionProps, ax as HOUSE_RULES, ay as HouseRule, az as INTEGRATION_CATALOG_CARD_HEIGHT_CLASS, aA as InfoCard, aB as InfoCardProps, aC as InfoCardTone, aD as IntegrationCard, aE as IntegrationCardProps, aF as IntegrationCardStatus, aG as IntegrationsEmptyState, aH as IntegrationsEmptyStateProps, aI as LineAreaChart, aJ as LineAreaChartProps, aK as LintFinding, aL as LintOptions, aM as LintResult, aN as LintSeverity, aO as MetricChartCard, aP as MetricChartCardProps, aQ as MetricChartMetric, aR as MetricRow, aS as MetricRowItem, aT as MetricRowProps, aU as MetricTile, aV as MetricTileProps, aW as NumericOperator, aX as Page, aY as PageHeader, aZ as PageHeaderProps, a_ as PageProps, a$ as PieChart, b0 as PieChartProps, b1 as PlanBadge, b2 as PlanBadgeProps, b3 as PlanBadgeTone, b4 as RESERVED_GRADIENT_TOKENS, b5 as RadarChart, b6 as RadarChartProps, b7 as RadialChart, b8 as RadialChartProps, b9 as ResourceCard, ba as ResourceCardProps, bb as ReviewResult, bc as SEMANTIC_COLOR_TOKENS, bd as SLOP_BUDGETS, be as SearchInput, bf as SearchInputProps, bg as Section, bh as SectionProps, bi as SemanticColorToken, bj as SettingsSection, bk as SettingsSectionHeader, bl as SettingsSectionHeaderProps, bm as SettingsSectionProps, bn as Sparkline, bo as SparklineProps, bp as Stack, bq as StackAlign, br as StackGap, bs as StackJustify, bt as StackProps, bu as StatTile, bv as StatTileProps, bw as StatTileTone, bx as StatusBadge, by as StatusBadgeProps, bz as StatusDot, bA as StatusDotProps, bB as StatusDotTone, bC as SubNav, bD as SubNavItem, bE as SubNavProps, bF as SurfaceCard, bG as SurfaceCardProps, bH as SurfaceCardTone, bI as SurfaceCardVariant, bJ as TAILWIND_PALETTE_COLORS, bK as THEME_AGENT_INSTRUCTIONS, bL as TIMBAL_THEME_PRESETS, bM as ThemeShadow, bN as ThemeToCssOptions, bO as ThemeTokenMap, bP as TimbalThemeIntent, bQ as TimbalThemePreset, bR as TimbalThemePresetId, bS as TimbalThemeStyle, bT as TimbalThemeStyleProps, bU as TimbalThemeTokens, bV as TimbalThemeTypography, bW as UI_REVIEW_AGENT_INSTRUCTIONS, bX as UseLiveQueryOptions, bY as UseLiveQueryResult, bZ as appDensityClass, b_ as appFilterBarClass, b$ as appPageColumnClass, c0 as appSearchInputClass, c1 as appShellInsetTopClass, c2 as appShellTopbarInsetClass, c3 as appStatTileClass, c4 as appSurfaceCardClass, c5 as applyThemePreset, c6 as applyTimbalTheme, c7 as clearTimbalTheme, c8 as connectionRowListClass, c9 as createTimbalTheme, ca as ensureThemeFontLink, cb as flushBarCategoryGap, cc as flushLineAreaEdgeToEdge, cd as formatLintReport, ce as getStoredThemePreset, cf as getThemePreset, cg as lintGeneratedUi, ch as resolveChartMargin, ci as resolveTooltipCategory, cj as reviewGeneratedUi, ck as themeToCss, cl as useAppCopilotContext, cm as useAppShellChat, cn as useAppShellNav, co as useInterval, cp as useLiveQuery } from './chart-artifact-Dpt4t5sf.cjs';
+import { A as AppDensity, a as AppDensityClassKey, S as StatusBadgeTone } from './chart-artifact-CuTiCITz.cjs';
+export { b as APP_DENSITY_CHART_HEIGHT, c as APP_DENSITY_CLASSES, d as APP_KIT_AGENT_INSTRUCTIONS, e as AppChatPanel, f as AppChatPanelProps, g as AppConfirmDialog, h as AppConfirmDialogProps, i as AppCopilotContextValue, j as AppCopilotProvider, k as AppCopilotProviderProps, l as AppPageWidth, m as AppShell, n as AppShellChatControls, o as AppShellChatTrigger, p as AppShellChatTriggerProps, q as AppShellNavControls, r as AppShellProps, s as AppShellSidebarTrigger, t as AppShellSidebarTriggerProps, B as BreadcrumbEntry, u as BreadcrumbItem, v as Breadcrumbs, w as BreadcrumbsProps, C as CHART_PALETTE, x as COLOR_UTILITY_PREFIXES, y as ChartArtifactView, z as ChartLayout, D as ChartMargin, E as ChartPanel, F as ChartPanelProps, G as ChartSeries, H as ChartTooltipIndicator, I as ChartVariant, J as ConnectionRow, K as ConnectionRowList, L as ConnectionRowListProps, M as ConnectionRowProps, N as DangerZone, O as DangerZoneAction, P as DangerZoneActionProps, Q as DangerZoneProps, R as DataTable, T as DataTableColumn, U as DataTableProps, V as DataTableSort, W as DataTableSortDirection, X as DescriptionItem, Y as DescriptionList, Z as DescriptionListProps, _ as EmptyState, $ as EmptyStateProps, a0 as ExpandableSection, a1 as ExpandableSectionProps, a2 as Field, a3 as FieldInput, a4 as FieldInputProps, a5 as FieldProps, a6 as FieldRow, a7 as FieldRowProps, a8 as FieldSelect, a9 as FieldSelectProps, aa as FieldSwitch, ab as FieldSwitchProps, ac as FieldTextarea, ad as FieldTextareaProps, ae as FilterBar, af as FilterBarProps, ag as FilterDatePreset, ah as FilterDateRangeValue, ai as FilterDropdown, aj as FilterDropdownProps, ak as FilterField, al as FilterFieldDef, am as FilterFieldProps, an as FilterFieldType, ao as FilterNumericOperatorOption, ap as FilterNumericValue, aq as FilterSelectOption, ar as FilterValue, as as FilterValues, at as FloatingUnsavedChangesBar, au as FloatingUnsavedChangesBarProps, av as FormSection, aw as FormSectionProps, ax as HOUSE_RULES, ay as HouseRule, az as INTEGRATION_CATALOG_CARD_HEIGHT_CLASS, aA as InfoCard, aB as InfoCardProps, aC as InfoCardTone, aD as IntegrationCard, aE as IntegrationCardProps, aF as IntegrationCardStatus, aG as IntegrationsEmptyState, aH as IntegrationsEmptyStateProps, aI as LineAreaChart, aJ as LineAreaChartProps, aK as LintFinding, aL as LintOptions, aM as LintResult, aN as LintSeverity, aO as MetricChartCard, aP as MetricChartCardProps, aQ as MetricChartMetric, aR as MetricRow, aS as MetricRowItem, aT as MetricRowProps, aU as MetricTile, aV as MetricTileProps, aW as NumericOperator, aX as Page, aY as PageHeader, aZ as PageHeaderProps, a_ as PageProps, a$ as PieChart, b0 as PieChartProps, b1 as PlanBadge, b2 as PlanBadgeProps, b3 as PlanBadgeTone, b4 as RESERVED_GRADIENT_TOKENS, b5 as RadarChart, b6 as RadarChartProps, b7 as RadialChart, b8 as RadialChartProps, b9 as ResourceCard, ba as ResourceCardProps, bb as ReviewResult, bc as SEMANTIC_COLOR_TOKENS, bd as SLOP_BUDGETS, be as SearchInput, bf as SearchInputProps, bg as Section, bh as SectionProps, bi as SemanticColorToken, bj as SettingsSection, bk as SettingsSectionHeader, bl as SettingsSectionHeaderProps, bm as SettingsSectionProps, bn as Sparkline, bo as SparklineProps, bp as Stack, bq as StackAlign, br as StackGap, bs as StackJustify, bt as StackProps, bu as StatTile, bv as StatTileProps, bw as StatTileTone, bx as StatusBadge, by as StatusBadgeProps, bz as StatusDot, bA as StatusDotProps, bB as StatusDotTone, bC as SubNav, bD as SubNavItem, bE as SubNavProps, bF as SurfaceCard, bG as SurfaceCardProps, bH as SurfaceCardTone, bI as SurfaceCardVariant, bJ as TAILWIND_PALETTE_COLORS, bK as THEME_AGENT_INSTRUCTIONS, bL as TIMBAL_THEME_PRESETS, bM as ThemeShadow, bN as ThemeToCssOptions, bO as ThemeTokenMap, bP as TimbalThemeIntent, bQ as TimbalThemePreset, bR as TimbalThemePresetId, bS as TimbalThemeStyle, bT as TimbalThemeStyleProps, bU as TimbalThemeTokens, bV as TimbalThemeTypography, bW as UI_REVIEW_AGENT_INSTRUCTIONS, bX as UseLiveQueryOptions, bY as UseLiveQueryResult, bZ as appDensityClass, b_ as appFilterBarClass, b$ as appPageColumnClass, c0 as appSearchInputClass, c1 as appShellInsetTopClass, c2 as appShellTopbarInsetClass, c3 as appStatTileClass, c4 as appSurfaceCardClass, c5 as applyThemePreset, c6 as applyTimbalTheme, c7 as clearTimbalTheme, c8 as connectionRowListClass, c9 as createTimbalTheme, ca as ensureThemeFontLink, cb as flushBarCategoryGap, cc as flushLineAreaEdgeToEdge, cd as formatLintReport, ce as getStoredThemePreset, cf as getThemePreset, cg as lintGeneratedUi, ch as resolveChartMargin, ci as resolveTooltipCategory, cj as reviewGeneratedUi, ck as themeToCss, cl as useAppCopilotContext, cm as useAppShellChat, cn as useAppShellNav, co as useInterval, cp as useLiveQuery } from './chart-artifact-CuTiCITz.cjs';
 import { FC, ReactNode } from 'react';
-export { a as Avatar, b as AvatarFallback, c as AvatarImage, D as AvatarVariant, B as Banner, d as BannerProps, h as Button, i as ButtonColor, K as Kanban, j as KanbanCardData, k as KanbanCardVariant, l as KanbanColumnData, m as KanbanDensity, n as KanbanDragHandleProps, o as KanbanLocation, p as KanbanMoveEvent, q as KanbanProps, r as KanbanRenderCardContext, s as KanbanTone, T as Timeline, t as TimelineItem, u as TimelineProps, U as UntitledButton, w as UntitledButtonColor, x as UntitledButtonProps, y as UntitledButtonSize } from './kanban-FFBeaZPS.cjs';
+export { a as Avatar, b as AvatarFallback, c as AvatarImage, D as AvatarVariant, B as Banner, d as BannerProps, h as Button, i as ButtonColor, K as Kanban, j as KanbanCardData, k as KanbanCardVariant, l as KanbanColumnData, m as KanbanDensity, n as KanbanDragHandleProps, o as KanbanLocation, p as KanbanMoveEvent, q as KanbanProps, r as KanbanRenderCardContext, s as KanbanTone, T as Timeline, t as TimelineItem, u as TimelineProps, U as UntitledButton, w as UntitledButtonColor, x as UntitledButtonProps, y as UntitledButtonSize } from './kanban-BQxWliCS.cjs';
 export { B as ChartArtifact, D as ChartSeriesConfig, p as ThreadVariant, s as TimbalChat, t as TimbalChatProps } from './chat-DDsp-Vzz.cjs';
 import 'react/jsx-runtime';
 import 'class-variance-authority/types';

package/dist/app.d.ts

@@ -1,7 +1,7 @@
-import { A as AppDensity, a as AppDensityClassKey, S as StatusBadgeTone } from './chart-artifact-BYl5C-dk.js';
-export { b as APP_DENSITY_CHART_HEIGHT, c as APP_DENSITY_CLASSES, d as APP_KIT_AGENT_INSTRUCTIONS, e as AppChatPanel, f as AppChatPanelProps, g as AppConfirmDialog, h as AppConfirmDialogProps, i as AppCopilotContextValue, j as AppCopilotProvider, k as AppCopilotProviderProps, l as AppPageWidth, m as AppShell, n as AppShellChatControls, o as AppShellChatTrigger, p as AppShellChatTriggerProps, q as AppShellNavControls, r as AppShellProps, s as AppShellSidebarTrigger, t as AppShellSidebarTriggerProps, B as BreadcrumbEntry, u as BreadcrumbItem, v as Breadcrumbs, w as BreadcrumbsProps, C as CHART_PALETTE, x as COLOR_UTILITY_PREFIXES, y as ChartArtifactView, z as ChartLayout, D as ChartMargin, E as ChartPanel, F as ChartPanelProps, G as ChartSeries, H as ChartTooltipIndicator, I as ChartVariant, J as ConnectionRow, K as ConnectionRowList, L as ConnectionRowListProps, M as ConnectionRowProps, N as DangerZone, O as DangerZoneAction, P as DangerZoneActionProps, Q as DangerZoneProps, R as DataTable, T as DataTableColumn, U as DataTableProps, V as DataTableSort, W as DataTableSortDirection, X as DescriptionItem, Y as DescriptionList, Z as DescriptionListProps, _ as EmptyState, $ as EmptyStateProps, a0 as ExpandableSection, a1 as ExpandableSectionProps, a2 as Field, a3 as FieldInput, a4 as FieldInputProps, a5 as FieldProps, a6 as FieldRow, a7 as FieldRowProps, a8 as FieldSelect, a9 as FieldSelectProps, aa as FieldSwitch, ab as FieldSwitchProps, ac as FieldTextarea, ad as FieldTextareaProps, ae as FilterBar, af as FilterBarProps, ag as FilterDatePreset, ah as FilterDateRangeValue, ai as FilterDropdown, aj as FilterDropdownProps, ak as FilterField, al as FilterFieldDef, am as FilterFieldProps, an as FilterFieldType, ao as FilterNumericOperatorOption, ap as FilterNumericValue, aq as FilterSelectOption, ar as FilterValue, as as FilterValues, at as FloatingUnsavedChangesBar, au as FloatingUnsavedChangesBarProps, av as FormSection, aw as FormSectionProps, ax as HOUSE_RULES, ay as HouseRule, az as INTEGRATION_CATALOG_CARD_HEIGHT_CLASS, aA as InfoCard, aB as InfoCardProps, aC as InfoCardTone, aD as IntegrationCard, aE as IntegrationCardProps, aF as IntegrationCardStatus, aG as IntegrationsEmptyState, aH as IntegrationsEmptyStateProps, aI as LineAreaChart, aJ as LineAreaChartProps, aK as LintFinding, aL as LintOptions, aM as LintResult, aN as LintSeverity, aO as MetricChartCard, aP as MetricChartCardProps, aQ as MetricChartMetric, aR as MetricRow, aS as MetricRowItem, aT as MetricRowProps, aU as MetricTile, aV as MetricTileProps, aW as NumericOperator, aX as Page, aY as PageHeader, aZ as PageHeaderProps, a_ as PageProps, a$ as PieChart, b0 as PieChartProps, b1 as PlanBadge, b2 as PlanBadgeProps, b3 as PlanBadgeTone, b4 as RESERVED_GRADIENT_TOKENS, b5 as RadarChart, b6 as RadarChartProps, b7 as RadialChart, b8 as RadialChartProps, b9 as ResourceCard, ba as ResourceCardProps, bb as ReviewResult, bc as SEMANTIC_COLOR_TOKENS, bd as SLOP_BUDGETS, be as SearchInput, bf as SearchInputProps, bg as Section, bh as SectionProps, bi as SemanticColorToken, bj as SettingsSection, bk as SettingsSectionHeader, bl as SettingsSectionHeaderProps, bm as SettingsSectionProps, bn as Sparkline, bo as SparklineProps, bp as Stack, bq as StackAlign, br as StackGap, bs as StackJustify, bt as StackProps, bu as StatTile, bv as StatTileProps, bw as StatTileTone, bx as StatusBadge, by as StatusBadgeProps, bz as StatusDot, bA as StatusDotProps, bB as StatusDotTone, bC as SubNav, bD as SubNavItem, bE as SubNavProps, bF as SurfaceCard, bG as SurfaceCardProps, bH as SurfaceCardTone, bI as SurfaceCardVariant, bJ as TAILWIND_PALETTE_COLORS, bK as THEME_AGENT_INSTRUCTIONS, bL as TIMBAL_THEME_PRESETS, bM as ThemeShadow, bN as ThemeToCssOptions, bO as ThemeTokenMap, bP as TimbalThemeIntent, bQ as TimbalThemePreset, bR as TimbalThemePresetId, bS as TimbalThemeStyle, bT as TimbalThemeStyleProps, bU as TimbalThemeTokens, bV as TimbalThemeTypography, bW as UI_REVIEW_AGENT_INSTRUCTIONS, bX as UseLiveQueryOptions, bY as UseLiveQueryResult, bZ as appDensityClass, b_ as appFilterBarClass, b$ as appPageColumnClass, c0 as appSearchInputClass, c1 as appShellInsetTopClass, c2 as appShellTopbarInsetClass, c3 as appStatTileClass, c4 as appSurfaceCardClass, c5 as applyThemePreset, c6 as applyTimbalTheme, c7 as clearTimbalTheme, c8 as connectionRowListClass, c9 as createTimbalTheme, ca as ensureThemeFontLink, cb as flushBarCategoryGap, cc as flushLineAreaEdgeToEdge, cd as formatLintReport, ce as getStoredThemePreset, cf as getThemePreset, cg as lintGeneratedUi, ch as resolveChartMargin, ci as resolveTooltipCategory, cj as reviewGeneratedUi, ck as themeToCss, cl as useAppCopilotContext, cm as useAppShellChat, cn as useAppShellNav, co as useInterval, cp as useLiveQuery } from './chart-artifact-BYl5C-dk.js';
+import { A as AppDensity, a as AppDensityClassKey, S as StatusBadgeTone } from './chart-artifact-U-x0UNJm.js';
+export { b as APP_DENSITY_CHART_HEIGHT, c as APP_DENSITY_CLASSES, d as APP_KIT_AGENT_INSTRUCTIONS, e as AppChatPanel, f as AppChatPanelProps, g as AppConfirmDialog, h as AppConfirmDialogProps, i as AppCopilotContextValue, j as AppCopilotProvider, k as AppCopilotProviderProps, l as AppPageWidth, m as AppShell, n as AppShellChatControls, o as AppShellChatTrigger, p as AppShellChatTriggerProps, q as AppShellNavControls, r as AppShellProps, s as AppShellSidebarTrigger, t as AppShellSidebarTriggerProps, B as BreadcrumbEntry, u as BreadcrumbItem, v as Breadcrumbs, w as BreadcrumbsProps, C as CHART_PALETTE, x as COLOR_UTILITY_PREFIXES, y as ChartArtifactView, z as ChartLayout, D as ChartMargin, E as ChartPanel, F as ChartPanelProps, G as ChartSeries, H as ChartTooltipIndicator, I as ChartVariant, J as ConnectionRow, K as ConnectionRowList, L as ConnectionRowListProps, M as ConnectionRowProps, N as DangerZone, O as DangerZoneAction, P as DangerZoneActionProps, Q as DangerZoneProps, R as DataTable, T as DataTableColumn, U as DataTableProps, V as DataTableSort, W as DataTableSortDirection, X as DescriptionItem, Y as DescriptionList, Z as DescriptionListProps, _ as EmptyState, $ as EmptyStateProps, a0 as ExpandableSection, a1 as ExpandableSectionProps, a2 as Field, a3 as FieldInput, a4 as FieldInputProps, a5 as FieldProps, a6 as FieldRow, a7 as FieldRowProps, a8 as FieldSelect, a9 as FieldSelectProps, aa as FieldSwitch, ab as FieldSwitchProps, ac as FieldTextarea, ad as FieldTextareaProps, ae as FilterBar, af as FilterBarProps, ag as FilterDatePreset, ah as FilterDateRangeValue, ai as FilterDropdown, aj as FilterDropdownProps, ak as FilterField, al as FilterFieldDef, am as FilterFieldProps, an as FilterFieldType, ao as FilterNumericOperatorOption, ap as FilterNumericValue, aq as FilterSelectOption, ar as FilterValue, as as FilterValues, at as FloatingUnsavedChangesBar, au as FloatingUnsavedChangesBarProps, av as FormSection, aw as FormSectionProps, ax as HOUSE_RULES, ay as HouseRule, az as INTEGRATION_CATALOG_CARD_HEIGHT_CLASS, aA as InfoCard, aB as InfoCardProps, aC as InfoCardTone, aD as IntegrationCard, aE as IntegrationCardProps, aF as IntegrationCardStatus, aG as IntegrationsEmptyState, aH as IntegrationsEmptyStateProps, aI as LineAreaChart, aJ as LineAreaChartProps, aK as LintFinding, aL as LintOptions, aM as LintResult, aN as LintSeverity, aO as MetricChartCard, aP as MetricChartCardProps, aQ as MetricChartMetric, aR as MetricRow, aS as MetricRowItem, aT as MetricRowProps, aU as MetricTile, aV as MetricTileProps, aW as NumericOperator, aX as Page, aY as PageHeader, aZ as PageHeaderProps, a_ as PageProps, a$ as PieChart, b0 as PieChartProps, b1 as PlanBadge, b2 as PlanBadgeProps, b3 as PlanBadgeTone, b4 as RESERVED_GRADIENT_TOKENS, b5 as RadarChart, b6 as RadarChartProps, b7 as RadialChart, b8 as RadialChartProps, b9 as ResourceCard, ba as ResourceCardProps, bb as ReviewResult, bc as SEMANTIC_COLOR_TOKENS, bd as SLOP_BUDGETS, be as SearchInput, bf as SearchInputProps, bg as Section, bh as SectionProps, bi as SemanticColorToken, bj as SettingsSection, bk as SettingsSectionHeader, bl as SettingsSectionHeaderProps, bm as SettingsSectionProps, bn as Sparkline, bo as SparklineProps, bp as Stack, bq as StackAlign, br as StackGap, bs as StackJustify, bt as StackProps, bu as StatTile, bv as StatTileProps, bw as StatTileTone, bx as StatusBadge, by as StatusBadgeProps, bz as StatusDot, bA as StatusDotProps, bB as StatusDotTone, bC as SubNav, bD as SubNavItem, bE as SubNavProps, bF as SurfaceCard, bG as SurfaceCardProps, bH as SurfaceCardTone, bI as SurfaceCardVariant, bJ as TAILWIND_PALETTE_COLORS, bK as THEME_AGENT_INSTRUCTIONS, bL as TIMBAL_THEME_PRESETS, bM as ThemeShadow, bN as ThemeToCssOptions, bO as ThemeTokenMap, bP as TimbalThemeIntent, bQ as TimbalThemePreset, bR as TimbalThemePresetId, bS as TimbalThemeStyle, bT as TimbalThemeStyleProps, bU as TimbalThemeTokens, bV as TimbalThemeTypography, bW as UI_REVIEW_AGENT_INSTRUCTIONS, bX as UseLiveQueryOptions, bY as UseLiveQueryResult, bZ as appDensityClass, b_ as appFilterBarClass, b$ as appPageColumnClass, c0 as appSearchInputClass, c1 as appShellInsetTopClass, c2 as appShellTopbarInsetClass, c3 as appStatTileClass, c4 as appSurfaceCardClass, c5 as applyThemePreset, c6 as applyTimbalTheme, c7 as clearTimbalTheme, c8 as connectionRowListClass, c9 as createTimbalTheme, ca as ensureThemeFontLink, cb as flushBarCategoryGap, cc as flushLineAreaEdgeToEdge, cd as formatLintReport, ce as getStoredThemePreset, cf as getThemePreset, cg as lintGeneratedUi, ch as resolveChartMargin, ci as resolveTooltipCategory, cj as reviewGeneratedUi, ck as themeToCss, cl as useAppCopilotContext, cm as useAppShellChat, cn as useAppShellNav, co as useInterval, cp as useLiveQuery } from './chart-artifact-U-x0UNJm.js';
 import { FC, ReactNode } from 'react';
-export { a as Avatar, b as AvatarFallback, c as AvatarImage, D as AvatarVariant, B as Banner, d as BannerProps, h as Button, i as ButtonColor, K as Kanban, j as KanbanCardData, k as KanbanCardVariant, l as KanbanColumnData, m as KanbanDensity, n as KanbanDragHandleProps, o as KanbanLocation, p as KanbanMoveEvent, q as KanbanProps, r as KanbanRenderCardContext, s as KanbanTone, T as Timeline, t as TimelineItem, u as TimelineProps, U as UntitledButton, w as UntitledButtonColor, x as UntitledButtonProps, y as UntitledButtonSize } from './kanban-FFBeaZPS.js';
+export { a as Avatar, b as AvatarFallback, c as AvatarImage, D as AvatarVariant, B as Banner, d as BannerProps, h as Button, i as ButtonColor, K as Kanban, j as KanbanCardData, k as KanbanCardVariant, l as KanbanColumnData, m as KanbanDensity, n as KanbanDragHandleProps, o as KanbanLocation, p as KanbanMoveEvent, q as KanbanProps, r as KanbanRenderCardContext, s as KanbanTone, T as Timeline, t as TimelineItem, u as TimelineProps, U as UntitledButton, w as UntitledButtonColor, x as UntitledButtonProps, y as UntitledButtonSize } from './kanban-BQxWliCS.js';
 export { B as ChartArtifact, D as ChartSeriesConfig, p as ThreadVariant, s as TimbalChat, t as TimbalChatProps } from './chat-DDsp-Vzz.js';
 import 'react/jsx-runtime';
 import 'class-variance-authority/types';

package/dist/app.esm.js

@@ -91,8 +91,8 @@ import {
   useAppShellNav,
   useInterval,
   useLiveQuery
-} from "./chunk-UVPXH4MB.esm.js";
-import "./chunk-ELEY66OH.esm.js";
+} from "./chunk-M5IBJBEY.esm.js";
+import "./chunk-XOCOZU7J.esm.js";
 import {
   CHART_PALETTE,
   ChartArtifactView,
@@ -105,20 +105,20 @@ import {
   flushLineAreaEdgeToEdge,
   resolveChartMargin,
   resolveTooltipCategory
-} from "./chunk-WQIQW7EM.esm.js";
+} from "./chunk-7AGIAQE6.esm.js";
 import {
   Banner,
   Kanban,
   Timeline,
   UntitledButton
-} from "./chunk-NO5AWNWT.esm.js";
+} from "./chunk-7WU3IKAN.esm.js";
 import "./chunk-R4RQT2XQ.esm.js";
 import {
   Avatar,
   AvatarFallback,
   AvatarImage,
   Button
-} from "./chunk-MBS7XHV2.esm.js";
+} from "./chunk-45NXD3IG.esm.js";
 import "./chunk-EDEKQYSU.esm.js";
 export {
   APP_DENSITY_CHART_HEIGHT,

package/dist/{chart-artifact-Dpt4t5sf.d.cts → chart-artifact-CuTiCITz.d.cts}

@@ -433,6 +433,20 @@ interface AppShellProps {
     /** Uncontrolled initial mobile-nav open state. Default: `false`. */
     defaultNavOpen?: boolean;
     onNavOpenChange?: (open: boolean) => void;
+    /**
+     * How the mobile hamburger that opens the `sidebar` drawer is provided.
+     * - `"auto"` (default): the shell renders a floating hamburger (top-left,
+     *   `md:hidden`) whenever there's a `sidebar` but no `topbar` — so a sidebar
+     *   dashboard works on mobile with **no topbar and no wiring**.
+     * - `"topbar"`: you place `<AppShellSidebarTrigger />` in the `topbar`
+     *   yourself; the shell renders no floating hamburger.
+     * - `"none"`: the shell renders no hamburger (you provide your own via
+     *   `useAppShellNav()`).
+     *
+     * When a `topbar` is present, `"auto"` behaves like `"topbar"` (the topbar is
+     * assumed to host the trigger) to avoid a duplicate control.
+     */
+    mobileSidebarTrigger?: "auto" | "topbar" | "none";
     className?: string;
     mainClassName?: string;
     /**
@@ -470,20 +484,28 @@ interface AppShellChatControls {
 }
 declare function useAppShellChat(): AppShellChatControls | null;
 
-interface AppShellNavControls {
+/** Mobile-nav drawer controls owned by an enclosing shell (e.g. `AppShell`). */
+interface ShellNavControls {
     /** Mobile nav drawer open state. */
     open: boolean;
     setOpen: (open: boolean) => void;
     toggle: () => void;
 }
+
+/** Mobile-nav drawer controls exposed by `AppShell`. */
+type AppShellNavControls = ShellNavControls;
 /**
- * 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:
+ * Read the `AppShell`-owned mobile nav controls. Use to wire a custom hamburger
+ * or a sidebar that doesn't auto-detect the shell.
  *
+ * Note: inside `AppShell`, `StudioSidebar` already syncs to these controls
+ * automatically (no `mobileOpen` wiring needed), and `AppShell` renders the
+ * mobile hamburger itself when there's no topbar — so most apps never call this.
+ *
+ * @example
  * ```tsx
  * const nav = useAppShellNav();
- * <StudioSidebar mobileOpen={nav.open} onMobileOpenChange={nav.setOpen} … />
+ * <button onClick={nav.toggle}>Menu</button>
  * ```
  *
  * Returns a no-op fallback when used outside `AppShell`, so it's always safe to call.
@@ -754,11 +776,26 @@ declare const statusBadgeToneClass: {
 type StatusBadgeTone = keyof typeof statusBadgeToneClass;
 interface StatusBadgeProps {
     children: ReactNode;
+    /**
+     * Tone tint. One of `default | primary | success | warn | danger | muted`.
+     * (Different vocabulary from `StatusDot`, which uses `online | busy | …`.)
+     */
     tone?: StatusBadgeTone;
     /** Render a small leading status dot in the tone color. */
     dot?: boolean;
     className?: string;
 }
+/**
+ * A labeled status **pill** (soft tint + ring) for a record's state — order
+ * status, plan tier, health. For a tiny presence/liveness indicator (online /
+ * busy / offline) use `StatusDot` instead.
+ *
+ * @example
+ * ```tsx
+ * <StatusBadge tone="success">Paid</StatusBadge>
+ * <StatusBadge tone="warn" dot>Pending</StatusBadge>
+ * ```
+ */
 declare const StatusBadge: FC<StatusBadgeProps>;
 
 interface AppConfirmDialogProps {
@@ -799,6 +836,10 @@ declare const InfoCard: FC<InfoCardProps>;
 
 type StatusDotTone = "online" | "busy" | "offline" | "error" | "neutral";
 interface StatusDotProps {
+    /**
+     * Presence/liveness tone. One of `online | busy | offline | error | neutral`.
+     * (Different vocabulary from `StatusBadge`, which uses `success | warn | …`.)
+     */
     tone?: StatusDotTone;
     /** Optional label rendered to the right of the dot. */
     label?: ReactNode;
@@ -806,7 +847,17 @@ interface StatusDotProps {
     pulse?: boolean;
     className?: string;
 }
-/** Tiny status indicator dot, optionally labeled and pulsing. */
+/**
+ * Tiny presence/liveness indicator dot, optionally labeled and pulsing — agent
+ * online, service up/down. For a labeled state pill (Paid / Pending / Failed)
+ * use `StatusBadge` instead.
+ *
+ * @example
+ * ```tsx
+ * <StatusDot tone="online" label="Online" pulse />
+ * <StatusDot tone="offline" label="Offline" />
+ * ```
+ */
 declare const StatusDot: FC<StatusDotProps>;
 
 interface DescriptionItem {
@@ -1094,6 +1145,23 @@ interface FieldSelectProps extends SelectHTMLAttributes<HTMLSelectElement> {
     fieldClassName?: string;
     children: ReactNode;
 }
+/**
+ * A labeled form select — a native `<select>` wrapped in a `Field` (label,
+ * hint, error), styled to match the kit's inputs. Children are plain `<option>`
+ * elements. Use this in forms.
+ *
+ * For a rich, searchable/custom-rendered dropdown (Radix), compose `Select` +
+ * `SelectTrigger` / `SelectContent` / `SelectItem` from `@timbal-ai/timbal-react/ui`
+ * instead.
+ *
+ * @example
+ * ```tsx
+ * <FieldSelect label="Environment" defaultValue="prod">
+ *   <option value="prod">Production</option>
+ *   <option value="staging">Staging</option>
+ * </FieldSelect>
+ * ```
+ */
 declare const FieldSelect: FC<FieldSelectProps>;
 
 interface FieldSwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type"> {
@@ -1228,8 +1296,11 @@ interface DataTableColumn<T> {
     truncate?: boolean;
 }
 interface DataTableProps<T> {
+    /** Column definitions. Each has an `id`, a `header`, and a `cell(row)` renderer. */
     columns: DataTableColumn<T>[];
+    /** The data array. Note: the prop is `rows` (not `data`). */
     rows: T[];
+    /** Stable key per row (required) — e.g. `(row) => row.id`. Drives selection + React keys. */
     getRowKey: (row: T) => string;
     emptyTitle?: ReactNode;
     emptyDescription?: ReactNode;
@@ -1274,6 +1345,22 @@ interface DataTableProps<T> {
     defaultPageIndex?: number;
     onPageChange?: (pageIndex: number) => void;
 }
+/**
+ * Sortable, optionally selectable + paginated data table. Place it **directly**
+ * on a `Page` / `Section` — never inside a `Card` (it owns its own chrome).
+ *
+ * The data prop is `rows` (not `data`), and `getRowKey` is required.
+ *
+ * @example
+ * ```tsx
+ * type Order = { id: string; customer: string; status: string };
+ * const columns: DataTableColumn<Order>[] = [
+ *   { id: "customer", header: "Customer", cell: (r) => r.customer, sortable: true, sortValue: (r) => r.customer },
+ *   { id: "status", header: "Status", cell: (r) => <StatusBadge tone={r.status === "Paid" ? "success" : "warn"}>{r.status}</StatusBadge> },
+ * ];
+ * <DataTable columns={columns} rows={orders} getRowKey={(r) => r.id} defaultSort={{ columnId: "customer", direction: "asc" }} />
+ * ```
+ */
 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 {
@@ -1290,8 +1377,20 @@ interface ChartPanelProps {
     className?: string;
 }
 /**
- * Chart shell matching `MetricChartCard` — title row with side padding, flush
- * plot edge-to-edge with only top inset on the chart region.
+ * A titled card wrapping a single chart — pass a built-in `artifact` or your
+ * own chart as `children`. Use this when you just need "a chart in a card."
+ *
+ * Choosing between the two chart cards:
+ * - `ChartPanel` — one chart in a titled shell. The simple, common case.
+ * - `MetricChartCard` — a selectable KPI row **above** a chart, where clicking a
+ *   metric swaps the series. Use only when you need that interaction.
+ *
+ * @example
+ * ```tsx
+ * <ChartPanel title="Revenue" description="Last 6 months">
+ *   <LineAreaChart data={rows} xKey="month" series={["revenue"]} />
+ * </ChartPanel>
+ * ```
  */
 declare const ChartPanel: FC<ChartPanelProps>;
 
@@ -1391,6 +1490,20 @@ interface MetricRowProps extends MetricCardHeaderProps {
  * Platform-style KPI strip in one elevated card — no chart.
  * Use for overview rows; pair with `MetricChartCard` when you need the plot below.
  * Fully supports background sparklines and rich inline trend metadata.
+ *
+ * Each metric needs a stable `id`, a `label`, and a `value`. Add `onMetricChange`
+ * (or `activeMetricId`) to make the tiles selectable.
+ *
+ * @example
+ * ```tsx
+ * <MetricRow
+ *   metrics={[
+ *     { id: "mrr", label: "MRR", value: "$48.2k", trend: "+12%" },
+ *     { id: "active", label: "Active users", value: "1,204" },
+ *     { id: "churn", label: "Churn", value: "1.8%" },
+ *   ]}
+ * />
+ * ```
  */
 declare const MetricRow: FC<MetricRowProps>;
 
@@ -1426,9 +1539,17 @@ declare function resolveTooltipCategory(label: unknown, payload: TooltipRow[] |
  */
 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 {
+    /** Key in each data row holding this series' numeric value. */
     dataKey: string;
+    /** Legend / tooltip label. Defaults to `dataKey`. */
     label?: string;
-    /** CSS color (token or literal). Defaults to the palette by index. */
+    /**
+     * CSS color for the series. Defaults to the `--chart-N` palette by index, so
+     * you usually omit it. If you set it, pass a token **directly** —
+     * `"var(--chart-3)"` or `"var(--destructive)"` — never `"hsl(var(--chart-3))"`:
+     * the tokens are already OKLCH colors, so wrapping them in `hsl()/rgb()` is
+     * invalid CSS and renders an empty chart.
+     */
     color?: string;
 }
 type ChartVariant = "area" | "line" | "bar";
@@ -1484,6 +1605,36 @@ interface LineAreaChartProps {
  * 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`.
+ *
+ * Pass `data` as an array of rows and (optionally) `series` to pick which keys
+ * to plot — both `xKey` and `series` are inferred from the data when omitted.
+ * Colors come from the `--chart-N` tokens automatically; don't hand-author them.
+ *
+ * @example
+ * ```tsx
+ * // Stacked area, colors inferred from the theme:
+ * <LineAreaChart
+ *   data={[
+ *     { month: "Jan", desktop: 186, mobile: 80 },
+ *     { month: "Feb", desktop: 305, mobile: 200 },
+ *   ]}
+ *   xKey="month"
+ *   series={["desktop", "mobile"]}
+ *   variant="area"
+ *   stacked
+ * />
+ * ```
+ * @example
+ * ```tsx
+ * // Horizontal bar with a custom token color on one series:
+ * <LineAreaChart
+ *   data={rows}
+ *   xKey="team"
+ *   series={[{ dataKey: "wins", color: "var(--chart-2)" }]}
+ *   variant="bar"
+ *   orientation="horizontal"
+ * />
+ * ```
  */
 declare const LineAreaChart: FC<LineAreaChartProps>;
 
@@ -1533,9 +1684,13 @@ interface MetricChartCardProps {
     className?: string;
 }
 /**
- * Analytics card: selectable KPI row over a flush area chart —
- * timbal-platform `MetricsRowCard` / Studio analytics pattern.
- * Fully supports background sparklines and rich inline trend metadata.
+ * Analytics card: a selectable KPI row over a flush area chart — clicking a
+ * metric tile swaps the plotted series (the timbal-platform `MetricsRowCard` /
+ * Studio analytics pattern). Supports background sparklines and rich inline
+ * trend metadata.
+ *
+ * If you only need a single chart in a titled card (no selectable KPI row), use
+ * `ChartPanel` instead.
  */
 declare const MetricChartCard: FC<MetricChartCardProps>;
 
@@ -1589,6 +1744,7 @@ interface UseLiveQueryResult<T> {
 declare function useLiveQuery<T>(fetcher: () => Promise<T>, options?: UseLiveQueryOptions): UseLiveQueryResult<T>;
 
 interface PieChartProps {
+    /** One row per slice. */
     data: Array<Record<string, unknown>>;
     /** Category / label key. Inferred from the first non-numeric field if omitted. */
     nameKey?: string;
@@ -1596,7 +1752,11 @@ interface PieChartProps {
     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. */
+    /**
+     * Per-slice colors. Defaults to the theme `--chart-N` palette (recommended).
+     * If you override, pass tokens directly (`["var(--chart-1)", "var(--chart-2)"]`)
+     * — never `"hsl(var(--chart-1))"` (the tokens are already OKLCH).
+     */
     colors?: string[];
     /** Plot height in px. Default 260. */
     height?: number;
@@ -1619,6 +1779,23 @@ interface PieChartProps {
  * 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`).
+ *
+ * @example
+ * ```tsx
+ * // Donut with a total in the hole:
+ * <PieChart
+ *   data={[
+ *     { browser: "Chrome", visitors: 275 },
+ *     { browser: "Safari", visitors: 200 },
+ *     { browser: "Firefox", visitors: 187 },
+ *   ]}
+ *   nameKey="browser"
+ *   dataKey="visitors"
+ *   innerRadius={0.6}
+ *   centerValue="662"
+ *   centerLabel="Visitors"
+ * />
+ * ```
  */
 declare const PieChart: FC<PieChartProps>;
 
@@ -1630,7 +1807,10 @@ interface RadialChartProps {
     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. */
+    /**
+     * Per-arc colors. Defaults to the theme `--chart-N` palette (recommended).
+     * Override with tokens directly (`["var(--chart-1)"]`) — never `"hsl(var(--chart-1))"`.
+     */
     colors?: string[];
     height?: number;
     /** Thickness of each ring in px. Default 16. */
@@ -1648,6 +1828,19 @@ interface RadialChartProps {
  * 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.
+ *
+ * @example
+ * ```tsx
+ * // Single progress ring (e.g. a gauge) — colors from the theme:
+ * <RadialChart
+ *   data={[{ label: "Uptime", value: 92 }]}
+ *   nameKey="label"
+ *   dataKey="value"
+ *   maxValue={100}
+ *   centerValue="92%"
+ *   centerLabel="Uptime"
+ * />
+ * ```
  */
 declare const RadialChart: FC<RadialChartProps>;
 
@@ -1671,7 +1864,20 @@ interface RadarChartProps {
 /**
  * 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.
+ * two or three entities. Needs at least 3 data rows (axes).
+ *
+ * @example
+ * ```tsx
+ * <RadarChart
+ *   data={[
+ *     { metric: "Speed", a: 120, b: 90 },
+ *     { metric: "Power", a: 98, b: 130 },
+ *     { metric: "Range", a: 86, b: 70 },
+ *   ]}
+ *   nameKey="metric"
+ *   series={["a", "b"]}
+ * />
+ * ```
  */
 declare const RadarChart: FC<RadarChartProps>;