@helpai/elements 0.15.0 → 0.17.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-P3CoZ-BV.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-BvNoqfIC.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" | "historyBack" | "conversationLoading" | "conversationClosed" | "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" | "tabConversations" | "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";
 }
 
 /**
@@ -139,11 +141,13 @@ interface WireMessage {
     role: "user" | "assistant" | "system";
     parts: WirePart[];
     /**
-     * Epoch milliseconds the message was created. Optional so older backends
-     * still parse; when present, the widget shows the real send time (and groups
-     * messages by day) on reload instead of falling back to "now".
+     * ISO-8601 timestamp the message was created (a serialized Mongo ISODate,
+     * e.g. `2026-06-10T07:50:55.816Z`) — every wire date uses this format.
+     * Optional so older backends still parse; when present, the widget shows
+     * the real send time (and groups messages by day) on reload instead of
+     * falling back to "now". Parse with {@link parseWireDate}.
      */
-    createdAt?: number;
+    createdAt?: string;
 }
 type WirePart = {
     type: "text";
@@ -176,6 +180,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;
+    /** ISO-8601 — same format + name as {@link WireMessage.createdAt}. */
+    createdAt?: string;
+}
 /** One-shot bot persona shown in the panel header. */
 interface ConversationAgent {
     name: string;
@@ -237,6 +256,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 +317,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 +359,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
@@ -1062,6 +1091,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;
@@ -1295,6 +1326,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;