@timbal-ai/timbal-react 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -2,6 +2,38 @@
 
 All notable changes to `@timbal-ai/timbal-react` are documented here.
 
+## [0.8.0] — 2026-06-02
+
+### Added
+
+- **Headless UI primitives** (`@timbal-ai/timbal-react/ui`, also re-exported from the root) — token-styled Radix wrappers so apps stop hand-rolling raw HTML:
+  - **`DropdownMenu`** family (`DropdownMenu`, `DropdownMenuTrigger`, `DropdownMenuContent`, `DropdownMenuItem`, `DropdownMenuCheckboxItem`, `DropdownMenuRadioGroup`/`DropdownMenuRadioItem`, `DropdownMenuLabel`, `DropdownMenuSeparator`, `DropdownMenuShortcut`, `DropdownMenuGroup`, `DropdownMenuSub`/`DropdownMenuSubTrigger`/`DropdownMenuSubContent`) — row actions and overflow menus.
+  - **`Popover`** family (`Popover`, `PopoverTrigger`, `PopoverContent`, `PopoverAnchor`) — filters, pickers, lightweight floating panels.
+  - **`Select`** family (`Select`, `SelectTrigger`, `SelectValue`, `SelectContent`, `SelectItem`, `SelectGroup`, `SelectLabel`, `SelectSeparator`, scroll buttons) — rich select beyond the native `FieldSelect`.
+- **`DialogHeader`**, **`DialogFooter`**, **`DialogDescription`** added to the `Dialog` family so dialog layout no longer has to be hand-rolled.
+
+All new primitives use the package design tokens (`bg-popover`, `border-border`, `shadow-card`, `focus:bg-accent`, …), portal above dialogs (`z-[80]`), and require no extra dependencies — `radix-ui` and `tw-animate-css` are already in the stack.
+
+---
+
+## [0.7.1] — 2026-06-02
+
+### Changed
+
+- **Opaque elevated surfaces** — `--elevated-from` / `--elevated-to` no longer use alpha in light or dark themes, preserving the signature vertical gradient with no background bleed-through.
+
+### Added
+
+- **`TIMBAL_V2_ELEVATED_SURFACE`** — elevated card/list surface (gradient + border + `shadow-card`) without hover/active fill shifts, for catalog cards and connection lists.
+- **`TIMBAL_V2_LOGO_TILE`** — logo/integration mark tile pinned to the light plate in both themes so dark provider logos stay legible.
+- **`STORAGE_KEYS.theme`** — localStorage key used by `ModeToggle` in uncontrolled mode.
+
+### Fixed
+
+- **`StatTile`** typography aligned with platform metrics (normal weight, compact labels, tabular numerals).
+
+---
+
 ## [0.7.0] — 2026-05-29
 
 ### Added

package/README.md

@@ -134,6 +134,16 @@ Suggestions also accept a function (sync or async) for per-user or server-driven
 
 Each chip supports `icon`, `description`, and `prompt` (sent instead of `title` when clicked).
 
+In `AppChatPanel` (`variant="panel"`), welcome suggestions are **off** by default. Enable them with `showWelcomeSuggestions`:
+
+```tsx
+<AppChatPanel
+  workforceId="your-workforce-id"
+  showWelcomeSuggestions
+  suggestions={[{ title: "Summarize this dashboard" }]}
+/>
+```
+
 ### Placeholder and width
 
 ```tsx
@@ -605,6 +615,7 @@ import {
 | `welcome.heading` | `string` | `"How can I help you today?"` | Welcome screen heading |
 | `welcome.subheading` | `string` | `"Send a message to start a conversation."` | Welcome screen subheading |
 | `suggestions` | `{ title: string; description?: string }[]` | — | Suggestion chips on the welcome screen |
+| `showWelcomeSuggestions` | `boolean` | `true` (`default` variant), `false` (`panel`) | Show built-in welcome suggestions when `suggestions` is set |
 | `composerPlaceholder` | `string` | `"Send a message..."` | Composer input placeholder |
 | `components` | `ThreadComponents` | — | Override individual UI slots |
 | `onArtifactEvent` | `(event: UiEventEnvelope) => void` | — | Called when a `ui` artifact fires an `emit` action |

package/dist/app.cjs

@@ -4619,6 +4619,7 @@ var Thread = ({
   maxWidth: maxWidthProp,
   welcome,
   suggestions,
+  showWelcomeSuggestions,
   composerPlaceholder,
   components,
   artifacts,
@@ -4667,6 +4668,7 @@ var Thread = ({
                   {
                     config: welcome,
                     suggestions,
+                    showWelcomeSuggestions,
                     Suggestions: SuggestionsSlot
                   }
                 ),
@@ -4747,10 +4749,12 @@ var welcomeIcon = {
 var ThreadWelcome = ({
   config,
   suggestions,
+  showWelcomeSuggestions: showWelcomeSuggestionsProp,
   Suggestions: SuggestionsSlot = Suggestions
 }) => {
   const isEmpty = (0, import_react35.useThread)((s) => s.messages.length === 0);
   const isPanel = useThreadVariant() === "panel";
+  const showWelcomeSuggestions = showWelcomeSuggestionsProp ?? !isPanel;
   if (!isEmpty) return null;
   const defaultHeading = isPanel ? "Ask about this page" : "How can I help you today?";
   const defaultSubheading = isPanel ? "The assistant can use dashboard context from your app." : "Send a message to start a conversation.";
@@ -4789,7 +4793,7 @@ var ThreadWelcome = ({
         ]
       }
     ) }),
-    suggestions && !isPanel ? /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("div", { className: "aui-thread-welcome-suggestions mx-auto w-full max-w-(--thread-max-width) px-2", children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(SuggestionsSlot, { suggestions }) }) : null
+    showWelcomeSuggestions && suggestions ? /* @__PURE__ */ (0, import_jsx_runtime36.jsx)("div", { className: "aui-thread-welcome-suggestions mx-auto w-full max-w-(--thread-max-width) px-2", children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(SuggestionsSlot, { suggestions }) }) : null
   ] });
 };
 var MessageError = () => {
@@ -4974,8 +4978,7 @@ var EditComposer = () => {
 var import_jsx_runtime37 = require("react/jsx-runtime");
 var shellClass = "aui-app-chat-panel flex h-full min-h-0 flex-col overflow-hidden";
 var chromeClass = cn(
-  "aui-app-chat-panel-chrome relative z-20 flex min-h-12 shrink-0 items-center justify-end",
-  "bg-card/90 px-2 pt-3 pb-3 backdrop-blur-sm"
+  "aui-app-chat-panel-chrome relative z-20 flex min-h-10 shrink-0 items-center justify-end px-2 pt-2"
 );
 var closeButtonClass = cn(
   "aui-app-chat-panel-close flex size-8 shrink-0 items-center justify-center rounded-md",
@@ -4992,8 +4995,9 @@ var bodyClass = cn(
   "[&_.aui-thread-viewport]:[scrollbar-gutter:stable_both-edges]",
   // Tighter symmetric horizontal inset for panel + composer
   "[&_.aui-thread-viewport]:!px-2",
-  "[&_.aui-thread-viewport]:!pt-2",
+  "[&_.aui-thread-viewport]:!pt-1",
   "[&_.aui-user-message-root]:!px-0",
+  "[&_.aui-user-message-root]:!pe-1",
   "[&_.aui-composer-input]:!px-2",
   "[&_.aui-composer-action-wrapper]:!px-2"
 );
@@ -5008,6 +5012,7 @@ var AppChatPanel = ({
   debug,
   welcome,
   suggestions,
+  showWelcomeSuggestions,
   composerPlaceholder,
   components,
   artifacts,
@@ -5043,6 +5048,7 @@ var AppChatPanel = ({
             className: "aui-app-chat-panel-thread",
             welcome,
             suggestions,
+            showWelcomeSuggestions,
             composerPlaceholder,
             components,
             artifacts,

package/dist/app.d.cts

@@ -1,6 +1,6 @@
-export { A as APP_KIT_AGENT_INSTRUCTIONS, a as AppChatPanel, b as AppChatPanelProps, c as AppConfirmDialog, d as AppConfirmDialogProps, e as AppCopilotContextValue, f as AppCopilotProvider, g as AppCopilotProviderProps, h as AppShell, i as AppShellChatControls, j as AppShellChatTrigger, k as AppShellChatTriggerProps, l as AppShellProps, m as AppShellTopbar, n as AppShellTopbarProps, B as BreadcrumbItem, o as Breadcrumbs, p as BreadcrumbsProps, C as CHART_PALETTE, q as ChartArtifactView, r as ChartLayout, s as ChartPanel, t as ChartPanelProps, u as ChartSeries, v as ChartVariant, w as ConnectionRow, x as ConnectionRowList, y as ConnectionRowListProps, z as ConnectionRowProps, D as DangerZone, E as DangerZoneAction, F as DangerZoneActionProps, G as DangerZoneProps, H as DataTable, I as DataTableColumn, J as DataTableProps, K as DataTableSort, L as DataTableSortDirection, M as DescriptionItem, N as DescriptionList, O as DescriptionListProps, P as EmptyState, Q as EmptyStateProps, R as ExpandableSection, S as ExpandableSectionProps, T as Field, U as FieldInput, V as FieldInputProps, W as FieldProps, X as FieldRow, Y as FieldRowProps, Z as FieldSelect, _ as FieldSelectProps, $ as FieldSwitch, a0 as FieldSwitchProps, a1 as FieldTextarea, a2 as FieldTextareaProps, a3 as FilterBar, a4 as FilterBarProps, a5 as FloatingUnsavedChangesBar, a6 as FloatingUnsavedChangesBarProps, a7 as FormSection, a8 as FormSectionProps, a9 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 MetricChartCard, al as MetricChartCardProps, am as MetricChartMetric, an as MetricRow, ao as MetricRowItem, ap as MetricRowProps, aq as MetricTile, ar as MetricTileProps, as as Page, at as PageHeader, au as PageHeaderProps, av as PageProps, aw as PlanBadge, ax as PlanBadgeProps, ay as PlanBadgeTone, az as ResourceCard, aA as ResourceCardProps, aB as SearchInput, aC as SearchInputProps, aD as Section, aE as SectionProps, aF as SettingsSection, aG as SettingsSectionHeader, aH as SettingsSectionHeaderProps, aI as SettingsSectionProps, aJ as Sparkline, aK as SparklineProps, aL as StatTile, aM as StatTileProps, aN as StatusBadge, aO as StatusBadgeProps, aP as StatusBadgeTone, aQ as StatusDot, aR as StatusDotProps, aS as StatusDotTone, aT as SubNav, aU as SubNavItem, aV as SubNavProps, aW as SurfaceCard, aX as SurfaceCardProps, aY as connectionRowListClass, aZ as useAppCopilotContext, a_ as useAppShellChat } from './chart-artifact-bWUa-iSG.cjs';
+export { A as APP_KIT_AGENT_INSTRUCTIONS, a as AppChatPanel, b as AppChatPanelProps, c as AppConfirmDialog, d as AppConfirmDialogProps, e as AppCopilotContextValue, f as AppCopilotProvider, g as AppCopilotProviderProps, h as AppShell, i as AppShellChatControls, j as AppShellChatTrigger, k as AppShellChatTriggerProps, l as AppShellProps, m as AppShellTopbar, n as AppShellTopbarProps, B as BreadcrumbItem, o as Breadcrumbs, p as BreadcrumbsProps, C as CHART_PALETTE, q as ChartArtifactView, r as ChartLayout, s as ChartPanel, t as ChartPanelProps, u as ChartSeries, v as ChartVariant, w as ConnectionRow, x as ConnectionRowList, y as ConnectionRowListProps, z as ConnectionRowProps, D as DangerZone, E as DangerZoneAction, F as DangerZoneActionProps, G as DangerZoneProps, H as DataTable, I as DataTableColumn, J as DataTableProps, K as DataTableSort, L as DataTableSortDirection, M as DescriptionItem, N as DescriptionList, O as DescriptionListProps, P as EmptyState, Q as EmptyStateProps, R as ExpandableSection, S as ExpandableSectionProps, T as Field, U as FieldInput, V as FieldInputProps, W as FieldProps, X as FieldRow, Y as FieldRowProps, Z as FieldSelect, _ as FieldSelectProps, $ as FieldSwitch, a0 as FieldSwitchProps, a1 as FieldTextarea, a2 as FieldTextareaProps, a3 as FilterBar, a4 as FilterBarProps, a5 as FloatingUnsavedChangesBar, a6 as FloatingUnsavedChangesBarProps, a7 as FormSection, a8 as FormSectionProps, a9 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 MetricChartCard, al as MetricChartCardProps, am as MetricChartMetric, an as MetricRow, ao as MetricRowItem, ap as MetricRowProps, aq as MetricTile, ar as MetricTileProps, as as Page, at as PageHeader, au as PageHeaderProps, av as PageProps, aw as PlanBadge, ax as PlanBadgeProps, ay as PlanBadgeTone, az as ResourceCard, aA as ResourceCardProps, aB as SearchInput, aC as SearchInputProps, aD as Section, aE as SectionProps, aF as SettingsSection, aG as SettingsSectionHeader, aH as SettingsSectionHeaderProps, aI as SettingsSectionProps, aJ as Sparkline, aK as SparklineProps, aL as StatTile, aM as StatTileProps, aN as StatusBadge, aO as StatusBadgeProps, aP as StatusBadgeTone, aQ as StatusDot, aR as StatusDotProps, aS as StatusDotTone, aT as SubNav, aU as SubNavItem, aV as SubNavProps, aW as SurfaceCard, aX as SurfaceCardProps, aY as connectionRowListClass, aZ as useAppCopilotContext, a_ as useAppShellChat } from './chart-artifact-C2m891nx.cjs';
 export { B as Button } from './button-CIKzUrJI.cjs';
-export { C as ChartArtifact, T as ThreadVariant, a as TimbalChat, b as TimbalChatProps } from './chat-CWtQWDtJ.cjs';
+export { C as ChartArtifact, T as ThreadVariant, a as TimbalChat, b as TimbalChatProps } from './chat-Bed4FQSl.cjs';
 import 'react';
 import 'react/jsx-runtime';
 import 'class-variance-authority/types';

package/dist/app.d.ts

@@ -1,6 +1,6 @@
-export { A as APP_KIT_AGENT_INSTRUCTIONS, a as AppChatPanel, b as AppChatPanelProps, c as AppConfirmDialog, d as AppConfirmDialogProps, e as AppCopilotContextValue, f as AppCopilotProvider, g as AppCopilotProviderProps, h as AppShell, i as AppShellChatControls, j as AppShellChatTrigger, k as AppShellChatTriggerProps, l as AppShellProps, m as AppShellTopbar, n as AppShellTopbarProps, B as BreadcrumbItem, o as Breadcrumbs, p as BreadcrumbsProps, C as CHART_PALETTE, q as ChartArtifactView, r as ChartLayout, s as ChartPanel, t as ChartPanelProps, u as ChartSeries, v as ChartVariant, w as ConnectionRow, x as ConnectionRowList, y as ConnectionRowListProps, z as ConnectionRowProps, D as DangerZone, E as DangerZoneAction, F as DangerZoneActionProps, G as DangerZoneProps, H as DataTable, I as DataTableColumn, J as DataTableProps, K as DataTableSort, L as DataTableSortDirection, M as DescriptionItem, N as DescriptionList, O as DescriptionListProps, P as EmptyState, Q as EmptyStateProps, R as ExpandableSection, S as ExpandableSectionProps, T as Field, U as FieldInput, V as FieldInputProps, W as FieldProps, X as FieldRow, Y as FieldRowProps, Z as FieldSelect, _ as FieldSelectProps, $ as FieldSwitch, a0 as FieldSwitchProps, a1 as FieldTextarea, a2 as FieldTextareaProps, a3 as FilterBar, a4 as FilterBarProps, a5 as FloatingUnsavedChangesBar, a6 as FloatingUnsavedChangesBarProps, a7 as FormSection, a8 as FormSectionProps, a9 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 MetricChartCard, al as MetricChartCardProps, am as MetricChartMetric, an as MetricRow, ao as MetricRowItem, ap as MetricRowProps, aq as MetricTile, ar as MetricTileProps, as as Page, at as PageHeader, au as PageHeaderProps, av as PageProps, aw as PlanBadge, ax as PlanBadgeProps, ay as PlanBadgeTone, az as ResourceCard, aA as ResourceCardProps, aB as SearchInput, aC as SearchInputProps, aD as Section, aE as SectionProps, aF as SettingsSection, aG as SettingsSectionHeader, aH as SettingsSectionHeaderProps, aI as SettingsSectionProps, aJ as Sparkline, aK as SparklineProps, aL as StatTile, aM as StatTileProps, aN as StatusBadge, aO as StatusBadgeProps, aP as StatusBadgeTone, aQ as StatusDot, aR as StatusDotProps, aS as StatusDotTone, aT as SubNav, aU as SubNavItem, aV as SubNavProps, aW as SurfaceCard, aX as SurfaceCardProps, aY as connectionRowListClass, aZ as useAppCopilotContext, a_ as useAppShellChat } from './chart-artifact-BFDz8Tf9.js';
+export { A as APP_KIT_AGENT_INSTRUCTIONS, a as AppChatPanel, b as AppChatPanelProps, c as AppConfirmDialog, d as AppConfirmDialogProps, e as AppCopilotContextValue, f as AppCopilotProvider, g as AppCopilotProviderProps, h as AppShell, i as AppShellChatControls, j as AppShellChatTrigger, k as AppShellChatTriggerProps, l as AppShellProps, m as AppShellTopbar, n as AppShellTopbarProps, B as BreadcrumbItem, o as Breadcrumbs, p as BreadcrumbsProps, C as CHART_PALETTE, q as ChartArtifactView, r as ChartLayout, s as ChartPanel, t as ChartPanelProps, u as ChartSeries, v as ChartVariant, w as ConnectionRow, x as ConnectionRowList, y as ConnectionRowListProps, z as ConnectionRowProps, D as DangerZone, E as DangerZoneAction, F as DangerZoneActionProps, G as DangerZoneProps, H as DataTable, I as DataTableColumn, J as DataTableProps, K as DataTableSort, L as DataTableSortDirection, M as DescriptionItem, N as DescriptionList, O as DescriptionListProps, P as EmptyState, Q as EmptyStateProps, R as ExpandableSection, S as ExpandableSectionProps, T as Field, U as FieldInput, V as FieldInputProps, W as FieldProps, X as FieldRow, Y as FieldRowProps, Z as FieldSelect, _ as FieldSelectProps, $ as FieldSwitch, a0 as FieldSwitchProps, a1 as FieldTextarea, a2 as FieldTextareaProps, a3 as FilterBar, a4 as FilterBarProps, a5 as FloatingUnsavedChangesBar, a6 as FloatingUnsavedChangesBarProps, a7 as FormSection, a8 as FormSectionProps, a9 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 MetricChartCard, al as MetricChartCardProps, am as MetricChartMetric, an as MetricRow, ao as MetricRowItem, ap as MetricRowProps, aq as MetricTile, ar as MetricTileProps, as as Page, at as PageHeader, au as PageHeaderProps, av as PageProps, aw as PlanBadge, ax as PlanBadgeProps, ay as PlanBadgeTone, az as ResourceCard, aA as ResourceCardProps, aB as SearchInput, aC as SearchInputProps, aD as Section, aE as SectionProps, aF as SettingsSection, aG as SettingsSectionHeader, aH as SettingsSectionHeaderProps, aI as SettingsSectionProps, aJ as Sparkline, aK as SparklineProps, aL as StatTile, aM as StatTileProps, aN as StatusBadge, aO as StatusBadgeProps, aP as StatusBadgeTone, aQ as StatusDot, aR as StatusDotProps, aS as StatusDotTone, aT as SubNav, aU as SubNavItem, aV as SubNavProps, aW as SurfaceCard, aX as SurfaceCardProps, aY as connectionRowListClass, aZ as useAppCopilotContext, a_ as useAppShellChat } from './chart-artifact-CqqhdSR9.js';
 export { B as Button } from './button-CIKzUrJI.js';
-export { C as ChartArtifact, T as ThreadVariant, a as TimbalChat, b as TimbalChatProps } from './chat-CWtQWDtJ.js';
+export { C as ChartArtifact, T as ThreadVariant, a as TimbalChat, b as TimbalChatProps } from './chat-Bed4FQSl.js';
 import 'react';
 import 'react/jsx-runtime';
 import 'class-variance-authority/types';

package/dist/app.esm.js

@@ -56,18 +56,18 @@ import {
   connectionRowListClass,
   useAppCopilotContext,
   useAppShellChat
-} from "./chunk-533MK5EA.esm.js";
+} from "./chunk-ZEDE2TWQ.esm.js";
 import "./chunk-Z27GBSOT.esm.js";
 import {
   CHART_PALETTE,
   ChartArtifactView,
   LineAreaChart,
   TimbalChat
-} from "./chunk-TLUF2RUL.esm.js";
-import "./chunk-TDIJHV4I.esm.js";
+} from "./chunk-VVTTLIGT.esm.js";
+import "./chunk-YNDXBN6C.esm.js";
 import {
   Button
-} from "./chunk-2XZ3S4OP.esm.js";
+} from "./chunk-QKO67F4V.esm.js";
 export {
   APP_KIT_AGENT_INSTRUCTIONS,
   AppChatPanel,

package/dist/{chart-artifact-bWUa-iSG.d.cts → chart-artifact-C2m891nx.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-CWtQWDtJ.cjs';
+import { w as TimbalRuntimeProviderProps, q as ThreadProps, C as ChartArtifact } from './chat-Bed4FQSl.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**

package/dist/{chart-artifact-BFDz8Tf9.d.ts → chart-artifact-CqqhdSR9.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-CWtQWDtJ.js';
+import { w as TimbalRuntimeProviderProps, q as ThreadProps, C as ChartArtifact } from './chat-Bed4FQSl.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**

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

@@ -374,6 +374,11 @@ interface ThreadWelcomeConfig {
 interface ThreadWelcomeProps {
     config?: ThreadWelcomeConfig;
     suggestions?: SuggestionsSource;
+    /**
+     * When set, controls whether the default welcome renders `suggestions`.
+     * Omitted: shown for `variant="default"`, hidden for `variant="panel"`.
+     */
+    showWelcomeSuggestions?: boolean;
     /**
      * The resolved `Suggestions` component (default or user-overridden via
      * `components.Suggestions`). Custom Welcome implementations should render
@@ -420,6 +425,11 @@ interface ThreadProps {
      * async function for per-user suggestions.
      */
     suggestions?: SuggestionsSource;
+    /**
+     * Show suggestion rows on the built-in welcome when `suggestions` is set.
+     * Default: `true` for `variant="default"`, `false` for `variant="panel"`.
+     */
+    showWelcomeSuggestions?: boolean;
     /** Composer input placeholder. Default: "Send a message...". */
     composerPlaceholder?: string;
     /** Override individual UI slots while keeping the rest as defaults. */

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

@@ -374,6 +374,11 @@ interface ThreadWelcomeConfig {
 interface ThreadWelcomeProps {
     config?: ThreadWelcomeConfig;
     suggestions?: SuggestionsSource;
+    /**
+     * When set, controls whether the default welcome renders `suggestions`.
+     * Omitted: shown for `variant="default"`, hidden for `variant="panel"`.
+     */
+    showWelcomeSuggestions?: boolean;
     /**
      * The resolved `Suggestions` component (default or user-overridden via
      * `components.Suggestions`). Custom Welcome implementations should render
@@ -420,6 +425,11 @@ interface ThreadProps {
      * async function for per-user suggestions.
      */
     suggestions?: SuggestionsSource;
+    /**
+     * Show suggestion rows on the built-in welcome when `suggestions` is set.
+     * Default: `true` for `variant="default"`, `false` for `variant="panel"`.
+     */
+    showWelcomeSuggestions?: boolean;
     /** Composer input placeholder. Default: "Send a message...". */
     composerPlaceholder?: string;
     /** Override individual UI slots while keeping the rest as defaults. */

package/dist/chat.cjs

@@ -3999,6 +3999,7 @@ var Thread = ({
   maxWidth: maxWidthProp,
   welcome,
   suggestions,
+  showWelcomeSuggestions,
   composerPlaceholder,
   components,
   artifacts,
@@ -4047,6 +4048,7 @@ var Thread = ({
                   {
                     config: welcome,
                     suggestions,
+                    showWelcomeSuggestions,
                     Suggestions: SuggestionsSlot
                   }
                 ),
@@ -4127,10 +4129,12 @@ var welcomeIcon = {
 var ThreadWelcome = ({
   config,
   suggestions,
+  showWelcomeSuggestions: showWelcomeSuggestionsProp,
   Suggestions: SuggestionsSlot = Suggestions
 }) => {
   const isEmpty = (0, import_react30.useThread)((s) => s.messages.length === 0);
   const isPanel = useThreadVariant() === "panel";
+  const showWelcomeSuggestions = showWelcomeSuggestionsProp ?? !isPanel;
   if (!isEmpty) return null;
   const defaultHeading = isPanel ? "Ask about this page" : "How can I help you today?";
   const defaultSubheading = isPanel ? "The assistant can use dashboard context from your app." : "Send a message to start a conversation.";
@@ -4169,7 +4173,7 @@ var ThreadWelcome = ({
         ]
       }
     ) }),
-    suggestions && !isPanel ? /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("div", { className: "aui-thread-welcome-suggestions mx-auto w-full max-w-(--thread-max-width) px-2", children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(SuggestionsSlot, { suggestions }) }) : null
+    showWelcomeSuggestions && suggestions ? /* @__PURE__ */ (0, import_jsx_runtime29.jsx)("div", { className: "aui-thread-welcome-suggestions mx-auto w-full max-w-(--thread-max-width) px-2", children: /* @__PURE__ */ (0, import_jsx_runtime29.jsx)(SuggestionsSlot, { suggestions }) }) : null
   ] });
 };
 var MessageError = () => {

package/dist/chat.d.cts

@@ -1,4 +1,4 @@
-export { c as ChatAttachment, d as ChatMessage, e as Composer, f as ComposerProps, g as ContentPart, S as SendOptions, h as Suggestions, i as SuggestionsComponent, j as SuggestionsSlotProps, k as SuggestionsSource, l as TextContentPart, m as ThinkingContentPart, n as Thread, o as ThreadArtifactsConfig, p as ThreadComponents, q as ThreadProps, r as ThreadSuggestion, s as ThreadSuggestionsProps, T as ThreadVariant, t as ThreadWelcomeConfig, u as ThreadWelcomeProps, a as TimbalChat, b as TimbalChatProps, v as TimbalRuntimeProvider, w as TimbalRuntimeProviderProps, x as TimbalStreamApi, y as ToolCallContentPart, U as UseTimbalStreamOptions, z as useResolvedSuggestions, A as useTimbalRuntime, B as useTimbalStream } from './chat-CWtQWDtJ.cjs';
+export { c as ChatAttachment, d as ChatMessage, e as Composer, f as ComposerProps, g as ContentPart, S as SendOptions, h as Suggestions, i as SuggestionsComponent, j as SuggestionsSlotProps, k as SuggestionsSource, l as TextContentPart, m as ThinkingContentPart, n as Thread, o as ThreadArtifactsConfig, p as ThreadComponents, q as ThreadProps, r as ThreadSuggestion, s as ThreadSuggestionsProps, T as ThreadVariant, t as ThreadWelcomeConfig, u as ThreadWelcomeProps, a as TimbalChat, b as TimbalChatProps, v as TimbalRuntimeProvider, w as TimbalRuntimeProviderProps, x as TimbalStreamApi, y as ToolCallContentPart, U as UseTimbalStreamOptions, z as useResolvedSuggestions, A as useTimbalRuntime, B as useTimbalStream } from './chat-Bed4FQSl.cjs';
 export { M as MarkdownText, T as THREAD_DEFAULT_MAX_WIDTH, a as ToolFallback, b as TooltipIconButton, c as TooltipIconButtonProps, W as WorkforceSelector, d as WorkforceSelectorProps, e as assistantMessageContentClass, f as assistantMessageRootClass, t as threadMessageColumnClass, u as useToolRunning, g as userMessageRootClass } from './layout-C2G-FcER.cjs';
 import { FC } from 'react';
 import 'react/jsx-runtime';

package/dist/chat.d.ts

@@ -1,4 +1,4 @@
-export { c as ChatAttachment, d as ChatMessage, e as Composer, f as ComposerProps, g as ContentPart, S as SendOptions, h as Suggestions, i as SuggestionsComponent, j as SuggestionsSlotProps, k as SuggestionsSource, l as TextContentPart, m as ThinkingContentPart, n as Thread, o as ThreadArtifactsConfig, p as ThreadComponents, q as ThreadProps, r as ThreadSuggestion, s as ThreadSuggestionsProps, T as ThreadVariant, t as ThreadWelcomeConfig, u as ThreadWelcomeProps, a as TimbalChat, b as TimbalChatProps, v as TimbalRuntimeProvider, w as TimbalRuntimeProviderProps, x as TimbalStreamApi, y as ToolCallContentPart, U as UseTimbalStreamOptions, z as useResolvedSuggestions, A as useTimbalRuntime, B as useTimbalStream } from './chat-CWtQWDtJ.js';
+export { c as ChatAttachment, d as ChatMessage, e as Composer, f as ComposerProps, g as ContentPart, S as SendOptions, h as Suggestions, i as SuggestionsComponent, j as SuggestionsSlotProps, k as SuggestionsSource, l as TextContentPart, m as ThinkingContentPart, n as Thread, o as ThreadArtifactsConfig, p as ThreadComponents, q as ThreadProps, r as ThreadSuggestion, s as ThreadSuggestionsProps, T as ThreadVariant, t as ThreadWelcomeConfig, u as ThreadWelcomeProps, a as TimbalChat, b as TimbalChatProps, v as TimbalRuntimeProvider, w as TimbalRuntimeProviderProps, x as TimbalStreamApi, y as ToolCallContentPart, U as UseTimbalStreamOptions, z as useResolvedSuggestions, A as useTimbalRuntime, B as useTimbalStream } from './chat-Bed4FQSl.js';
 export { M as MarkdownText, T as THREAD_DEFAULT_MAX_WIDTH, a as ToolFallback, b as TooltipIconButton, c as TooltipIconButtonProps, W as WorkforceSelector, d as WorkforceSelectorProps, e as assistantMessageContentClass, f as assistantMessageRootClass, t as threadMessageColumnClass, u as useToolRunning, g as userMessageRootClass } from './layout-BTJyU8wd.js';
 import { FC } from 'react';
 import 'react/jsx-runtime';

package/dist/chat.esm.js

@@ -7,7 +7,7 @@ import {
 } from "./chunk-KC5QLVUG.esm.js";
 import {
   WorkforceSelector
-} from "./chunk-N3PYVTY5.esm.js";
+} from "./chunk-ZG5NBHOS.esm.js";
 import {
   Composer,
   ComposerAddAttachment,
@@ -24,8 +24,8 @@ import {
   useTimbalRuntime,
   useTimbalStream,
   useToolRunning
-} from "./chunk-TLUF2RUL.esm.js";
-import "./chunk-2XZ3S4OP.esm.js";
+} from "./chunk-VVTTLIGT.esm.js";
+import "./chunk-QKO67F4V.esm.js";
 export {
   Composer,
   ComposerAddAttachment,

package/dist/{chunk-7O5VY3TP.esm.js → chunk-4AO3HCAR.esm.js}

@@ -20,7 +20,7 @@ import {
 } from "./chunk-Z27GBSOT.esm.js";
 import {
   WorkforceSelector
-} from "./chunk-N3PYVTY5.esm.js";
+} from "./chunk-ZG5NBHOS.esm.js";
 import {
   Composer,
   TimbalChat,
@@ -43,10 +43,10 @@ import {
   studioTopbarIconPillClass,
   studioTopbarPillHeightClass,
   useTimbalRuntime
-} from "./chunk-TLUF2RUL.esm.js";
+} from "./chunk-VVTTLIGT.esm.js";
 import {
   PillSegmentedTabs
-} from "./chunk-TDIJHV4I.esm.js";
+} from "./chunk-YNDXBN6C.esm.js";
 import {
   Avatar,
   AvatarFallback,
@@ -56,7 +56,7 @@ import {
   TooltipContent,
   TooltipTrigger,
   cn
-} from "./chunk-2XZ3S4OP.esm.js";
+} from "./chunk-QKO67F4V.esm.js";
 
 // src/hooks/use-workforces.ts
 import { useEffect, useMemo, useRef, useState } from "react";