@helpai/elements 0.14.2 → 0.16.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-CWyouRob.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-DvzmRV7E.js';
 import 'zod';
 
 /**
@@ -40,7 +40,7 @@ interface ClientStorage {
  * populated {@link Strings} map. UI components then read `strings.send` as a
  * normal property access — no per-render lookup, no per-render allocation.
  */
-type StringKey = "launcherOpen" | "panelTitle" | "composerPlaceholder" | "send" | "stop" | "attach" | "micStart" | "micStop" | "micUnsupported" | "expand" | "collapse" | "fullscreen" | "exitFullscreen" | "resizeHandle" | "scrollToBottom" | "popOut" | "close" | "moreActions" | "soundOn" | "soundOff" | "language" | "theme" | "themeAuto" | "themeLight" | "themeDark" | "history" | "historyTitle" | "historyEmpty" | "historyLoading" | "historyNewChat" | "historyBack" | "messagesLoading" | "chatClosed" | "startNewConversation" | "dateToday" | "dateYesterday" | "dateLastWeek" | "dateOlder" | "newConversation" | "dropZone" | "attachmentTooLarge" | "attachmentTooMany" | "attachmentMimeRejected" | "errorRetry" | "errorGeneric" | "errorRateLimited" | "loading" | "thinking" | "thoughts" | "usedTool" | "collapseSidebar" | "expandSidebar" | "formSubmit" | "formSkip" | "formRequired" | "formInvalidEmail" | "formInvalidTel" | "formInvalidUrl" | "formInvalidNumber" | "formTooShort" | "formTooLong" | "formNumberTooSmall" | "formNumberTooLarge" | "formPatternMismatch" | "formChooseAtLeast" | "formChooseAtMost" | "formOther" | "formOtherPlaceholder" | "inputRequired" | "inputSubmit" | "inputSkip" | "inputSubmitted" | "approvalRequired" | "approve" | "reject" | "approved" | "rejected" | "approvalReason" | "stepNoLongerActive" | "tabHome" | "tabMessages" | "tabHelp" | "tabNews" | "modulesEmpty" | "moduleBack" | "contentLoading" | "homeGreeting" | "homeGreetingNamed" | "homeGreetingLead" | "homeSearchPlaceholder" | "homeContentTitle" | "helpTitle" | "helpSearchPlaceholder" | "helpEmpty" | "helpLoading" | "helpSearchEmpty" | "newsTitle" | "newsEmpty" | "newsLoading" | "newsBack" | "newsPublishedAt";
+type StringKey = "launcherOpen" | "panelTitle" | "composerPlaceholder" | "send" | "stop" | "attach" | "micStart" | "micStop" | "micUnsupported" | "expand" | "collapse" | "fullscreen" | "exitFullscreen" | "resizeHandle" | "scrollToBottom" | "popOut" | "close" | "moreActions" | "soundOn" | "soundOff" | "language" | "theme" | "themeAuto" | "themeLight" | "themeDark" | "textSize" | "textSizeSmall" | "textSizeNormal" | "textSizeLarge" | "history" | "historyTitle" | "historyEmpty" | "historyLoading" | "historyBack" | "conversationLoading" | "conversationClosed" | "startNewConversation" | "dateToday" | "dateYesterday" | "dateLastWeek" | "dateOlder" | "newConversation" | "dropZone" | "attachmentTooLarge" | "attachmentTooMany" | "attachmentMimeRejected" | "errorRetry" | "errorGeneric" | "errorRateLimited" | "loading" | "thinking" | "thoughts" | "usedTool" | "collapseSidebar" | "expandSidebar" | "formSubmit" | "formSkip" | "formSubmitted" | "formSkipped" | "formRequired" | "formInvalidEmail" | "formInvalidTel" | "formInvalidUrl" | "formInvalidNumber" | "formTooShort" | "formTooLong" | "formNumberTooSmall" | "formNumberTooLarge" | "formPatternMismatch" | "formChooseAtLeast" | "formChooseAtMost" | "formOther" | "formOtherPlaceholder" | "inputRequired" | "inputSubmit" | "inputSkip" | "inputSubmitted" | "approvalRequired" | "approve" | "reject" | "approved" | "rejected" | "approvalReason" | "stepNoLongerActive" | "tabHome" | "tabConversations" | "tabHelp" | "tabNews" | "modulesEmpty" | "moduleBack" | "contentLoading" | "homeGreeting" | "homeGreetingNamed" | "homeGreetingLead" | "homeSearchPlaceholder" | "homeContentTitle" | "helpTitle" | "helpSearchPlaceholder" | "helpEmpty" | "helpLoading" | "helpSearchEmpty" | "newsTitle" | "newsEmpty" | "newsLoading" | "newsBack" | "newsPublishedAt";
 /** A partial map for one locale — what overrides look like on the wire. */
 type LocaleStrings = Partial<Record<StringKey, string>>;
 /**
@@ -109,6 +109,8 @@ interface UserPrefs {
     soundMuted?: boolean;
     /** Theme picked from the theme switcher. */
     themeMode?: "auto" | "light" | "dark";
+    /** Text size picked from the text-size switcher. */
+    textSize?: "small" | "normal" | "large";
 }
 
 /**
@@ -176,6 +178,21 @@ type WirePart = {
     errorText?: string;
     approval?: ToolApproval;
 };
+/**
+ * One recorded form submission, returned on `/ai/agent/start-conversation`
+ * (alongside `messages`) so the widget can re-place the collapsed
+ * "form submitted" marker at its chronological spot in the timeline.
+ * Values are NOT echoed back — the marker is pure indication.
+ */
+interface FormSubmissionRecord {
+    formId: string;
+    /** The trigger kind that surfaced the form. */
+    trigger: string;
+    /** True when the visitor skipped instead of answering. */
+    skipped?: boolean;
+    /** Epoch ms — same clock + name as {@link WireMessage.createdAt}. */
+    createdAt?: number;
+}
 /** One-shot bot persona shown in the panel header. */
 interface ConversationAgent {
     name: string;
@@ -237,6 +254,13 @@ interface StartConversationResponse {
     /** Page-mode sidebar blocks (navigation, link cards). Backend ships it whenever the deployment renders the page-shell sidebar. */
     blocks?: Record<string, unknown>;
     messages?: WireMessage[];
+    /**
+     * Form submissions recorded for this conversation (via
+     * `/ai/agent/submit-form`), returned like `messages` so the widget can
+     * reconstruct the timeline on resume — each renders as a collapsed
+     * "form submitted" marker at its chronological position.
+     */
+    formSubmissions?: FormSubmissionRecord[];
     /**
      * Server's authoritative copy of the visitor's preferences. When present,
      * client adopts it (overrides local cache) and re-applies it to the UI
@@ -291,6 +315,8 @@ type Position = "bottom-right" | "bottom-left" | "top-right" | "top-left";
  * Page mode reads `site` and `blocks` from the start-conversation response.
  */
 type Mode = "floating" | "inline" | "standalone" | "page" | "modal" | "drawer";
+/** End-user text-size preference — scales the whole type ramp. */
+type TextSize = "small" | "normal" | "large";
 /** Theme preference. `auto` follows `prefers-color-scheme`. */
 type ThemePreference = "auto" | "light" | "dark";
 /**
@@ -331,9 +357,10 @@ interface WelcomeOptions {
  * - `sound`       — Toggle notification sounds + haptics on/off (switch-style).
  * - `language`    — Switch the UI locale at runtime.
  * - `theme`       — Cycle `auto` / `light` / `dark`.
+ * - `textSize`    — Cycle `normal` / `large` / `small`.
  * - `close`       — Close the floating panel.
  */
-type ActionName = "clear" | "expand" | "fullscreen" | "popOut" | "sound" | "history" | "language" | "theme" | "close";
+type ActionName = "clear" | "expand" | "fullscreen" | "popOut" | "sound" | "history" | "language" | "theme" | "textSize" | "close";
 /**
  * The header's enabled actions. Unlisted actions are hidden; order is
  * irrelevant. Per-mode defaults (`DEFAULT_ACTIONS_BY_MODE`) pick a sensible
@@ -683,7 +710,7 @@ interface ModuleStatus {
 }
 /**
  * `home` layout config — flat feature flags (no block authoring). The Home tab
- * is assembled from these in a fixed order: greeting → search → recent message
+ * is assembled from these in a fixed order: greeting → search → recent conversation
  * → status → a content list (from the tab's `contentTags`, titled `contentBlockTitle`).
  */
 interface HomeConfig {
@@ -692,7 +719,7 @@ interface HomeConfig {
     greetingText?: string;
     userAvatars?: ModuleAvatar[];
     showSearchBar?: boolean;
-    showRecentMessages?: boolean;
+    showRecentConversations?: boolean;
     status?: ModuleStatus;
     contentBlockTitle?: string;
 }
@@ -837,7 +864,7 @@ interface BehaviorOptions {
     showToolCalls?: boolean;
     /**
      * Override the URL the `popOut` action opens (carries
-     * `?chat=<id>&widgetId=<id>`). Falls back to the brand's
+     * `?conversation=<id>&widgetId=<id>`). Falls back to the brand's
      * `BRAND.standaloneUrl` baked at build time. Server-pushable.
      */
     popOutUrl?: string;
@@ -1062,6 +1089,8 @@ interface ResolvedOptions {
     pageContext?: PageContext;
     position: Position;
     themeMode: ThemePreference;
+    /** Active text size. Default `normal`; the end-user's pick overrides at runtime. */
+    textSize: TextSize;
     themeOverrides: ThemeOverrides;
     mode: Mode;
     iframe: boolean;
@@ -1248,7 +1277,7 @@ interface EventMap {
     /** Clear / new-conversation requested. */
     clear: void;
     /** User picked a chat from the history pane / sidebar. */
-    selectChat: {
+    selectConversation: {
         conversationId: string;
     };
     /** User clicked a suggested-message chip. */
@@ -1295,6 +1324,8 @@ interface EventMap {
     localeChange: string;
     /** End-user picked a different theme mode (`auto` / `light` / `dark`). */
     themeChange: ThemePreference;
+    /** End-user picked a different text size (`small` / `normal` / `large`). */
+    textSizeChange: TextSize;
     /** End-user toggled the global sound mute. */
     soundToggle: {
         muted: boolean;