@waniwani/sdk 0.19.2 → 0.19.4

package/dist/chat/index.d.ts

@@ -322,6 +322,33 @@ type MessageOverrides = DeepPartial<Messages>;
  */
 type VisitorIdInput = string | (() => string | undefined | null | Promise<string | undefined | null>);
 
+/** Source of truth; {@link SuggestionOrigin} derives from it. */
+declare const SUGGESTION_ORIGINS: readonly ["channel", "page", "flow", "followup"];
+type SuggestionOrigin = (typeof SUGGESTION_ORIGINS)[number];
+/** One pill. `id` is null unless it came from an authored per-page prompt. */
+interface Suggestion {
+    id: string | null;
+    text: string;
+}
+/**
+ * One field per origin. `null` means the origin has nothing to say — no entry
+ * on this turn, or the rung no longer applies.
+ *
+ * `flow` alone treats `[]` as authoritative: it clears the row and suppresses
+ * every weaker rung. Elsewhere `[]` and `null` are the same.
+ */
+interface SuggestionCandidates {
+    flow: Suggestion[] | null;
+    followup: Suggestion[] | null;
+    page: Suggestion[] | null;
+    channel: Suggestion[] | null;
+}
+/**
+ * The rungs an embed host reads from `/config`. Grouped because they share a
+ * source and a lifetime: both stop applying at the visitor's first message.
+ */
+type PreChatSuggestions = Pick<SuggestionCandidates, "page" | "channel">;
+
 /** Surface the widget is mounted on. */
 type WidgetMode = "inline" | "floating";
 interface WidgetEventBase {
@@ -364,6 +391,13 @@ type WidgetEventDetail = {
         /** Which provider supplied the clicked pill: `"channel"` (starter prompts), `"page"` (per-URL starter prompts), `"flow"` (an MCP flow's `interrupt({ suggestions })`), or `"followup"` (generated from the conversation). */
         origin: SuggestionOrigin;
     };
+} | {
+    name: "suggestions.shown";
+    properties: {
+        texts: string[];
+        /** Origin of the rendered set, same taxonomy as `suggestion.clicked`. */
+        origin: SuggestionOrigin;
+    };
 } | {
     name: "link.clicked";
     properties: {
@@ -465,6 +499,13 @@ interface ChatTheme {
     fontSize?: number;
     /** Base line height for message text (unitless string, e.g. `"1.5"`). Defaults to `"1.5"`. */
     lineHeight?: string;
+    /** Frosted-glass tint color for the floating bar's suggestion card, layered
+     *  over the backdrop blur. Programmatic-only via appearance.variables.
+     *  Unset = the default neutral glass (unchanged). */
+    glassTint?: string;
+    /** Strength of the glass tint, 0–1 as a unitless string (e.g. "0.5").
+     *  Unset/"0" = no tint (default rendering). */
+    glassTintStrength?: string;
 }
 interface WelcomeConfig {
     /** Icon displayed above the title. Accepts any React node (e.g. an SVG or img). */
@@ -476,32 +517,12 @@ interface WelcomeConfig {
     /** Suggestion cards shown in the welcome screen. Disappear after the first message. */
     suggestions?: string[];
 }
-/** Where a suggestion pill came from. */
-/**
- * Every place a suggestion pill can come from. The single source of truth:
- * {@link SuggestionOrigin} derives from it, and runtime validation reads it,
- * so adding an origin is a one-line change.
- */
-declare const SUGGESTION_ORIGINS: readonly ["channel", "page", "flow", "followup"];
-/** Where a suggestion pill came from. */
-type SuggestionOrigin = (typeof SUGGESTION_ORIGINS)[number];
 interface SuggestionsConfig {
     /**
-     * Initial suggestions to show before the user sends their first message.
+     * Starter prompts shown before the user sends their first message.
      * Defaults to an empty array.
      */
     initial?: string[];
-    /**
-     * Which providers may fill the pill row. Omitted, this defaults to
-     * `["channel", "page", "followup"]`: starter prompts and generated
-     * follow-ups render, flow-driven pills stay opt-in.
-     */
-    origins?: SuggestionOrigin[];
-    /**
-     * @deprecated Use `origins`. `true` maps to every origin, `false` to none.
-     * Will be removed in a future minor release.
-     */
-    dynamic?: boolean;
 }
 /**
  * Per-slot class name overrides for the chat widget. Each string is appended
@@ -581,13 +602,15 @@ interface ChatBaseProps {
     /** Callback fired when a response is received */
     onResponseReceived?: () => void;
     /**
-     * Suggestion pill configuration. Unset: no suggestions. An object sets
-     * starter prompts (`initial`) and which origins may fill the per-turn
-     * pill row (`origins`); `origins: ["flow"]` (or any list including
-     * `"flow"`) opts into flow-driven pills. `true` enables every origin with
-     * defaults; `false` hides the pill row entirely.
+     * Suggestion pills. The row obeys a fixed hierarchy — flow > followup >
+     * page > channel — and every origin is always active.
+     *
+     * `false` hides the row; `true` / unset is the default. `{ initial: [...] }`
+     * sets starter prompts. Embed hosts pass the resolved
+     * {@link PreChatSuggestions} from `useSuggestions(config)` instead, which
+     * carries the prompt ids needed for click attribution.
      */
-    suggestions?: boolean | SuggestionsConfig;
+    suggestions?: boolean | SuggestionsConfig | PreChatSuggestions;
     /**
      * Handler for MCP tool calls from widgets.
      * Called when a widget uses `callServerTool` (MCP Apps standard).
@@ -923,15 +946,6 @@ interface WaniwaniChatOverrides {
     placeholder?: string;
     /** Initial suggestion chips. */
     suggestions?: string[];
-    /**
-     * Which providers may fill the per-turn pill row. Defaults to
-     * `["channel", "page", "followup"]` when unset: starter prompts and
-     * generated follow-ups render, flow-driven pills stay opt-in — include
-     * `"flow"` to render the pills a flow drives via
-     * `interrupt({ suggestions })`. Starter prompts (`suggestions`) are
-     * unaffected by this field and show either way.
-     */
-    suggestionOrigins?: SuggestionOrigin[];
     /** Persist conversations across reloads in IndexedDB. */
     enableThreadHistory?: boolean;
     /**
@@ -1053,7 +1067,7 @@ interface WaniwaniChatProps {
     /**
      * Callback fired on chat lifecycle events (`chat.ready`, `message.sent`,
      * `message.received`, `session.started`, `thread.changed`, `chat.error`,
-     * `suggestion.clicked`, `link.clicked`; `chat.opened`/`chat.closed` are
+     * `suggestion.clicked`, `suggestions.shown`, `link.clicked`; `chat.opened`/`chat.closed` are
      * floating-embed-only and never fire here). Message events never include
      * the message text. Use it to mirror widget activity into the host page's
      * analytics. Exceptions thrown by the callback are swallowed and never