claudius-chat-widget 1.14.0 → 1.16.0

package/dist/index.d.cts

@@ -15,6 +15,29 @@ export declare interface AnalyticsPluginOptions {
     includeContent?: boolean;
 }
 
+/**
+ * Client-side attachment limits. Pass to {@link ChatWidget} via the
+ * `attachments` prop (or `true` for the defaults). The worker enforces its own
+ * limits independently; keep the two in sync so uploads aren't rejected late.
+ */
+export declare interface AttachmentsOptions {
+    /**
+     * Largest file accepted, in bytes.
+     * @defaultValue `5 * 1024 * 1024` (5 MB)
+     */
+    maxSizeBytes?: number;
+    /**
+     * Maximum number of files per message.
+     * @defaultValue `5`
+     */
+    maxCount?: number;
+    /**
+     * Accepted MIME types.
+     * @defaultValue `["image/jpeg", "image/png", "image/gif", "image/webp", "application/pdf"]`
+     */
+    allowedTypes?: string[];
+}
+
 /**
  * Context for {@link ClaudiusPlugin.onBeforeSend}. Adds the ability to
  * short-circuit the request before it reaches the network.
@@ -74,6 +97,12 @@ export declare interface CannedRule {
  * per-attempt timeouts, and automatic retries with backoff for transient
  * failures (HTTP 429/503, network errors, timeouts).
  *
+ * Conversations without inline attachment bytes are posted as JSON. When any
+ * message carries an attachment with `data`, the request is sent as
+ * `multipart/form-data`: a `payload` field holding the JSON body (attachment
+ * refs without their bytes) plus one file part per attachment, named after
+ * the attachment id.
+ *
  * @example
  * ```ts
  * const client = new ChatApiClient("https://api.example.com");
@@ -106,6 +135,12 @@ export declare class ChatApiClient {
          * @throws {@link ChatApiError} when the request fails after all retries.
              */
          sendMessage(messages: ChatMessage[]): Promise<ChatResponse>;
+         /**
+          * Build the request body: JSON by default, multipart when any attachment
+          * still carries inline bytes. A fresh body is built per attempt so retries
+          * never reuse a consumed stream.
+          */
+         private buildRequest;
          /**
           * Send the conversation to the streaming chat endpoint and resolve with the
           * assistant's full reply once the stream completes. Text deltas are
@@ -193,6 +228,34 @@ export declare class ChatApiClient {
               retryAfter?: number | undefined);
           }
 
+          /**
+           * A file (image or PDF) attached to a user message.
+           *
+           * Bytes travel inline as base64 `data` until the worker stores them (R2
+           * backend), after which the widget keeps only the storage `key` and a signed
+           * preview `url`. Persisted history never includes `data`; an attachment with
+           * neither `data` nor `key` is shown by name only and described to the model
+           * as no longer available.
+           */
+          export declare interface ChatAttachment {
+              /** Client-generated id, unique within the conversation. */
+              id: string;
+              /** Original filename. */
+              name: string;
+              /** MIME type, e.g. `"image/png"` or `"application/pdf"`. */
+              mediaType: string;
+              /** Size in bytes. */
+              size: number;
+              /** Base64-encoded bytes without a `data:` prefix. */
+              data?: string;
+              /** Worker storage key, present once the worker's R2 backend stored the file. */
+              key?: string;
+              /** Signed preview/download URL for a stored file, valid until {@link ChatAttachment.expiresAt}. */
+              url?: string;
+              /** ISO 8601 timestamp after which the stored file and its `url` expire. */
+              expiresAt?: string;
+          }
+
           /**
            * Error response body returned by the Worker when a chat request fails.
            */
@@ -211,10 +274,12 @@ export declare class ChatApiClient {
               id: string;
               /** Who authored the message. */
               role: "user" | "assistant";
-              /** Plain-text message body. */
+              /** Plain-text message body. May be empty when the message only carries attachments. */
               content: string;
               /** Sources cited by the assistant for this message, when any. */
               sources?: Source[];
+              /** Files attached by the user to this message, when any. */
+              attachments?: ChatAttachment[];
               /** Tools the assistant called while producing this message, when any. */
               toolUses?: ToolUse[];
           }
@@ -237,6 +302,8 @@ export declare class ChatApiClient {
               sources?: Source[];
               /** Tools the assistant called while producing the reply, when any. */
               toolUses?: ToolUse[];
+              /** Attachments the worker stored while handling this request, when any. */
+              attachments?: StoredAttachment[];
           }
 
           /**
@@ -280,7 +347,7 @@ export declare class ChatApiClient {
            * <ChatWidget apiUrl="https://api.example.com" title="Support" />
            * ```
            */
-          export declare function ChatWidget({ apiUrl, title, subtitle, welcomeMessage, placeholder, persistMessages, storageKeyPrefix, requestTimeoutMs, theme, accentColor, position, locale, translations: translationOverrides, triggers, plugins, streaming, }: ChatWidgetProps): JSX_2.Element;
+          export declare function ChatWidget({ apiUrl, title, subtitle, welcomeMessage, placeholder, persistMessages, storageKeyPrefix, requestTimeoutMs, theme, accentColor, position, locale, translations: translationOverrides, triggers, plugins, streaming, attachments, voice, }: ChatWidgetProps): JSX_2.Element;
 
           /**
            * Props for the {@link ChatWidget} component.
@@ -339,6 +406,25 @@ export declare class ChatApiClient {
                * @defaultValue `true`
                */
               streaming?: boolean;
+              /**
+               * Let visitors attach images and PDFs (click, drag-and-drop, or paste).
+               * `true` enables the defaults (5 MB per file, 5 files per message, JPEG /
+               * PNG / GIF / WebP / PDF); pass an {@link AttachmentsOptions} to tune them.
+               * The worker must allow attachments too (it does by default).
+               * @defaultValue `false`
+               */
+              attachments?: boolean | AttachmentsOptions;
+              /**
+               * Voice features built on the browser's Web Speech API: a mic button for
+               * dictating messages and a read-aloud control on assistant replies. `true`
+               * enables both (click-to-toggle mic, no auto-submit); pass a
+               * {@link VoiceOptions} to choose hold-to-talk, auto-submit, a language, or
+               * to switch either half off. Each half renders only where the browser
+               * supports it. The widget never handles audio itself, but the browser's
+               * speech service may process it remotely; see the Voice guide.
+               * @defaultValue `false`
+               */
+              voice?: boolean | VoiceOptions;
           }
 
           /** An analytics event emitted by {@link pluginAnalytics}. */
@@ -449,6 +535,9 @@ export declare class ChatApiClient {
            * Every user-facing string the widget renders. Pass a {@link ClaudiusTranslations}
            * (or a partial override) to localize the UI. English is the source of truth;
            * see {@link defaultTranslations}.
+           *
+           * Strings containing `{name}` / `{max}` placeholders are interpolated at
+           * render time.
            */
           export declare interface ClaudiusTranslations {
               /** Chat window header title. */
@@ -479,6 +568,42 @@ export declare class ChatApiClient {
               openChat: string;
               /** Accessible label for dismissing the greeting bubble. */
               dismissGreeting: string;
+              /** Accessible label for the attach-file button and file picker. */
+              attachFile: string;
+              /** Accessible label prefix for removing a pending attachment (filename is appended). */
+              removeAttachment: string;
+              /** Accessible label for the list of pending attachments. */
+              attachmentsLabel: string;
+              /** Overlay hint shown while dragging files over the composer. */
+              dropFilesHint: string;
+              /** Validation message for an oversized file; supports `{name}` and `{max}`. */
+              attachmentTooLarge: string;
+              /** Validation message for a disallowed file type; supports `{name}`. */
+              attachmentTypeNotAllowed: string;
+              /** Validation message when the per-message file limit is hit; supports `{max}`. */
+              attachmentTooMany: string;
+              /** Accessible label for the mic button in toggle mode (state is exposed via `aria-pressed`). */
+              voiceInput: string;
+              /** Accessible label for the mic button in hold mode. */
+              voiceInputHold: string;
+              /** Placeholder shown in the message input while dictation is listening. */
+              voiceListening: string;
+              /** Shown when the browser or the visitor has blocked microphone access. */
+              voicePermissionDenied: string;
+              /** Shown when dictation ended without hearing any speech. */
+              voiceNoSpeech: string;
+              /** Shown when no microphone is available. */
+              voiceNoMicrophone: string;
+              /** Shown when the browser's speech service cannot be reached or does not support the language. */
+              voiceUnavailable: string;
+              /** Accessible label for the button that reads an assistant message aloud. */
+              readAloud: string;
+              /** Accessible label for pausing read-aloud playback. */
+              pauseReading: string;
+              /** Accessible label for resuming paused read-aloud playback. */
+              resumeReading: string;
+              /** Accessible label for stopping read-aloud playback. */
+              stopReading: string;
               /** Generic fallback error message. */
               errorGeneric: string;
               /** Error shown when the network request fails. */
@@ -489,6 +614,10 @@ export declare class ChatApiClient {
               errorRateLimitMinute: string;
               /** Error shown when rate-limited (per-hour limit). */
               errorRateLimitHour: string;
+              /** Error shown when the worker rejects an attachment (type, size, count, or content). */
+              errorAttachmentRejected: string;
+              /** Error shown when the worker's daily upload quota is exhausted. */
+              errorAttachmentQuota: string;
               /** Label for the retry action on a failed message. */
               errorRetry: string;
           }
@@ -511,6 +640,9 @@ export declare class ChatApiClient {
               constructor();
           }
 
+          /** Defaults applied when attachments are enabled with `true` or a partial config. */
+          export declare const DEFAULT_ATTACHMENT_OPTIONS: ResolvedAttachmentsConfig;
+
           /**
            * Default PII patterns: email addresses, North-American-style phone numbers,
            * US Social Security numbers, and 13–16 digit card-like sequences. These are
@@ -647,6 +779,12 @@ export declare class ChatApiClient {
           /** Replace every match of every pattern in `text` with `replacement`. */
           export declare function redactText(text: string, patterns: readonly RegExp[], replacement: string): string;
 
+          /** {@link AttachmentsOptions} with every field filled in. */
+          export declare type ResolvedAttachmentsConfig = Required<AttachmentsOptions>;
+
+          /** {@link VoiceOptions} with every field filled in. */
+          export declare type ResolvedVoiceConfig = Required<VoiceOptions>;
+
           /**
            * Resolve the final translations for a locale, applying any per-string
            * overrides on top of the chosen locale's defaults.
@@ -677,6 +815,21 @@ export declare class ChatApiClient {
               type: "blog" | "page" | "external";
           }
 
+          /**
+           * Storage metadata the worker returns for each attachment it persisted while
+           * handling a request (R2 backend only).
+           */
+          export declare interface StoredAttachment {
+              /** The {@link ChatAttachment.id} this entry describes. */
+              id: string;
+              /** Worker storage key to reference the file on later turns. */
+              key: string;
+              /** Signed preview/download URL, when the worker can serve the file. */
+              url?: string;
+              /** ISO 8601 expiry of the stored file. */
+              expiresAt: string;
+          }
+
           declare const THEME_COLOR_TOKENS: readonly ["accent", "accentText", "accentSoft", "accentTextMuted", "surface", "surfaceMuted", "text", "textMuted", "border", "userBubble", "userBubbleText", "assistantBubble", "assistantBubbleText", "field", "error", "errorSurface", "errorText", "link", "scrim"];
 
           declare const THEME_FONT_TOKENS: readonly ["heading", "body"];
@@ -762,6 +915,45 @@ export declare class ChatApiClient {
           /** A URL match: a case-insensitive substring, or a regular expression. */
           export declare type UrlPattern = string | RegExp;
 
+          /**
+           * How the mic button records: `"toggle"` starts on one click and stops on the
+           * next; `"hold"` records only while the button is held down.
+           */
+          export declare type VoiceInputMode = "toggle" | "hold";
+
+          /**
+           * Voice features. Pass to {@link ChatWidget} via the `voice` prop (or `true`
+           * for the defaults). Both halves rely on the browser's Web Speech API and
+           * render nothing where it is missing.
+           */
+          export declare interface VoiceOptions {
+              /**
+               * Show the mic button for dictating messages.
+               * @defaultValue `true`
+               */
+              input?: boolean;
+              /**
+               * Show the read-aloud control on completed assistant messages.
+               * @defaultValue `true`
+               */
+              output?: boolean;
+              /**
+               * How the mic button records.
+               * @defaultValue `"toggle"`
+               */
+              mode?: VoiceInputMode;
+              /**
+               * Send the dictated message as soon as recognition ends.
+               * @defaultValue `false`
+               */
+              autoSubmit?: boolean;
+              /**
+               * BCP-47 language tag for recognition and playback (e.g. `"en-GB"`).
+               * Defaults to a tag derived from the widget locale.
+               */
+              lang?: string;
+          }
+
           /** Corner of the viewport the widget docks to. */
           export declare type WidgetPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
 

package/dist/index.d.ts

@@ -15,6 +15,29 @@ export declare interface AnalyticsPluginOptions {
     includeContent?: boolean;
 }
 
+/**
+ * Client-side attachment limits. Pass to {@link ChatWidget} via the
+ * `attachments` prop (or `true` for the defaults). The worker enforces its own
+ * limits independently; keep the two in sync so uploads aren't rejected late.
+ */
+export declare interface AttachmentsOptions {
+    /**
+     * Largest file accepted, in bytes.
+     * @defaultValue `5 * 1024 * 1024` (5 MB)
+     */
+    maxSizeBytes?: number;
+    /**
+     * Maximum number of files per message.
+     * @defaultValue `5`
+     */
+    maxCount?: number;
+    /**
+     * Accepted MIME types.
+     * @defaultValue `["image/jpeg", "image/png", "image/gif", "image/webp", "application/pdf"]`
+     */
+    allowedTypes?: string[];
+}
+
 /**
  * Context for {@link ClaudiusPlugin.onBeforeSend}. Adds the ability to
  * short-circuit the request before it reaches the network.
@@ -74,6 +97,12 @@ export declare interface CannedRule {
  * per-attempt timeouts, and automatic retries with backoff for transient
  * failures (HTTP 429/503, network errors, timeouts).
  *
+ * Conversations without inline attachment bytes are posted as JSON. When any
+ * message carries an attachment with `data`, the request is sent as
+ * `multipart/form-data`: a `payload` field holding the JSON body (attachment
+ * refs without their bytes) plus one file part per attachment, named after
+ * the attachment id.
+ *
  * @example
  * ```ts
  * const client = new ChatApiClient("https://api.example.com");
@@ -106,6 +135,12 @@ export declare class ChatApiClient {
          * @throws {@link ChatApiError} when the request fails after all retries.
              */
          sendMessage(messages: ChatMessage[]): Promise<ChatResponse>;
+         /**
+          * Build the request body: JSON by default, multipart when any attachment
+          * still carries inline bytes. A fresh body is built per attempt so retries
+          * never reuse a consumed stream.
+          */
+         private buildRequest;
          /**
           * Send the conversation to the streaming chat endpoint and resolve with the
           * assistant's full reply once the stream completes. Text deltas are
@@ -193,6 +228,34 @@ export declare class ChatApiClient {
               retryAfter?: number | undefined);
           }
 
+          /**
+           * A file (image or PDF) attached to a user message.
+           *
+           * Bytes travel inline as base64 `data` until the worker stores them (R2
+           * backend), after which the widget keeps only the storage `key` and a signed
+           * preview `url`. Persisted history never includes `data`; an attachment with
+           * neither `data` nor `key` is shown by name only and described to the model
+           * as no longer available.
+           */
+          export declare interface ChatAttachment {
+              /** Client-generated id, unique within the conversation. */
+              id: string;
+              /** Original filename. */
+              name: string;
+              /** MIME type, e.g. `"image/png"` or `"application/pdf"`. */
+              mediaType: string;
+              /** Size in bytes. */
+              size: number;
+              /** Base64-encoded bytes without a `data:` prefix. */
+              data?: string;
+              /** Worker storage key, present once the worker's R2 backend stored the file. */
+              key?: string;
+              /** Signed preview/download URL for a stored file, valid until {@link ChatAttachment.expiresAt}. */
+              url?: string;
+              /** ISO 8601 timestamp after which the stored file and its `url` expire. */
+              expiresAt?: string;
+          }
+
           /**
            * Error response body returned by the Worker when a chat request fails.
            */
@@ -211,10 +274,12 @@ export declare class ChatApiClient {
               id: string;
               /** Who authored the message. */
               role: "user" | "assistant";
-              /** Plain-text message body. */
+              /** Plain-text message body. May be empty when the message only carries attachments. */
               content: string;
               /** Sources cited by the assistant for this message, when any. */
               sources?: Source[];
+              /** Files attached by the user to this message, when any. */
+              attachments?: ChatAttachment[];
               /** Tools the assistant called while producing this message, when any. */
               toolUses?: ToolUse[];
           }
@@ -237,6 +302,8 @@ export declare class ChatApiClient {
               sources?: Source[];
               /** Tools the assistant called while producing the reply, when any. */
               toolUses?: ToolUse[];
+              /** Attachments the worker stored while handling this request, when any. */
+              attachments?: StoredAttachment[];
           }
 
           /**
@@ -280,7 +347,7 @@ export declare class ChatApiClient {
            * <ChatWidget apiUrl="https://api.example.com" title="Support" />
            * ```
            */
-          export declare function ChatWidget({ apiUrl, title, subtitle, welcomeMessage, placeholder, persistMessages, storageKeyPrefix, requestTimeoutMs, theme, accentColor, position, locale, translations: translationOverrides, triggers, plugins, streaming, }: ChatWidgetProps): JSX_2.Element;
+          export declare function ChatWidget({ apiUrl, title, subtitle, welcomeMessage, placeholder, persistMessages, storageKeyPrefix, requestTimeoutMs, theme, accentColor, position, locale, translations: translationOverrides, triggers, plugins, streaming, attachments, voice, }: ChatWidgetProps): JSX_2.Element;
 
           /**
            * Props for the {@link ChatWidget} component.
@@ -339,6 +406,25 @@ export declare class ChatApiClient {
                * @defaultValue `true`
                */
               streaming?: boolean;
+              /**
+               * Let visitors attach images and PDFs (click, drag-and-drop, or paste).
+               * `true` enables the defaults (5 MB per file, 5 files per message, JPEG /
+               * PNG / GIF / WebP / PDF); pass an {@link AttachmentsOptions} to tune them.
+               * The worker must allow attachments too (it does by default).
+               * @defaultValue `false`
+               */
+              attachments?: boolean | AttachmentsOptions;
+              /**
+               * Voice features built on the browser's Web Speech API: a mic button for
+               * dictating messages and a read-aloud control on assistant replies. `true`
+               * enables both (click-to-toggle mic, no auto-submit); pass a
+               * {@link VoiceOptions} to choose hold-to-talk, auto-submit, a language, or
+               * to switch either half off. Each half renders only where the browser
+               * supports it. The widget never handles audio itself, but the browser's
+               * speech service may process it remotely; see the Voice guide.
+               * @defaultValue `false`
+               */
+              voice?: boolean | VoiceOptions;
           }
 
           /** An analytics event emitted by {@link pluginAnalytics}. */
@@ -449,6 +535,9 @@ export declare class ChatApiClient {
            * Every user-facing string the widget renders. Pass a {@link ClaudiusTranslations}
            * (or a partial override) to localize the UI. English is the source of truth;
            * see {@link defaultTranslations}.
+           *
+           * Strings containing `{name}` / `{max}` placeholders are interpolated at
+           * render time.
            */
           export declare interface ClaudiusTranslations {
               /** Chat window header title. */
@@ -479,6 +568,42 @@ export declare class ChatApiClient {
               openChat: string;
               /** Accessible label for dismissing the greeting bubble. */
               dismissGreeting: string;
+              /** Accessible label for the attach-file button and file picker. */
+              attachFile: string;
+              /** Accessible label prefix for removing a pending attachment (filename is appended). */
+              removeAttachment: string;
+              /** Accessible label for the list of pending attachments. */
+              attachmentsLabel: string;
+              /** Overlay hint shown while dragging files over the composer. */
+              dropFilesHint: string;
+              /** Validation message for an oversized file; supports `{name}` and `{max}`. */
+              attachmentTooLarge: string;
+              /** Validation message for a disallowed file type; supports `{name}`. */
+              attachmentTypeNotAllowed: string;
+              /** Validation message when the per-message file limit is hit; supports `{max}`. */
+              attachmentTooMany: string;
+              /** Accessible label for the mic button in toggle mode (state is exposed via `aria-pressed`). */
+              voiceInput: string;
+              /** Accessible label for the mic button in hold mode. */
+              voiceInputHold: string;
+              /** Placeholder shown in the message input while dictation is listening. */
+              voiceListening: string;
+              /** Shown when the browser or the visitor has blocked microphone access. */
+              voicePermissionDenied: string;
+              /** Shown when dictation ended without hearing any speech. */
+              voiceNoSpeech: string;
+              /** Shown when no microphone is available. */
+              voiceNoMicrophone: string;
+              /** Shown when the browser's speech service cannot be reached or does not support the language. */
+              voiceUnavailable: string;
+              /** Accessible label for the button that reads an assistant message aloud. */
+              readAloud: string;
+              /** Accessible label for pausing read-aloud playback. */
+              pauseReading: string;
+              /** Accessible label for resuming paused read-aloud playback. */
+              resumeReading: string;
+              /** Accessible label for stopping read-aloud playback. */
+              stopReading: string;
               /** Generic fallback error message. */
               errorGeneric: string;
               /** Error shown when the network request fails. */
@@ -489,6 +614,10 @@ export declare class ChatApiClient {
               errorRateLimitMinute: string;
               /** Error shown when rate-limited (per-hour limit). */
               errorRateLimitHour: string;
+              /** Error shown when the worker rejects an attachment (type, size, count, or content). */
+              errorAttachmentRejected: string;
+              /** Error shown when the worker's daily upload quota is exhausted. */
+              errorAttachmentQuota: string;
               /** Label for the retry action on a failed message. */
               errorRetry: string;
           }
@@ -511,6 +640,9 @@ export declare class ChatApiClient {
               constructor();
           }
 
+          /** Defaults applied when attachments are enabled with `true` or a partial config. */
+          export declare const DEFAULT_ATTACHMENT_OPTIONS: ResolvedAttachmentsConfig;
+
           /**
            * Default PII patterns: email addresses, North-American-style phone numbers,
            * US Social Security numbers, and 13–16 digit card-like sequences. These are
@@ -647,6 +779,12 @@ export declare class ChatApiClient {
           /** Replace every match of every pattern in `text` with `replacement`. */
           export declare function redactText(text: string, patterns: readonly RegExp[], replacement: string): string;
 
+          /** {@link AttachmentsOptions} with every field filled in. */
+          export declare type ResolvedAttachmentsConfig = Required<AttachmentsOptions>;
+
+          /** {@link VoiceOptions} with every field filled in. */
+          export declare type ResolvedVoiceConfig = Required<VoiceOptions>;
+
           /**
            * Resolve the final translations for a locale, applying any per-string
            * overrides on top of the chosen locale's defaults.
@@ -677,6 +815,21 @@ export declare class ChatApiClient {
               type: "blog" | "page" | "external";
           }
 
+          /**
+           * Storage metadata the worker returns for each attachment it persisted while
+           * handling a request (R2 backend only).
+           */
+          export declare interface StoredAttachment {
+              /** The {@link ChatAttachment.id} this entry describes. */
+              id: string;
+              /** Worker storage key to reference the file on later turns. */
+              key: string;
+              /** Signed preview/download URL, when the worker can serve the file. */
+              url?: string;
+              /** ISO 8601 expiry of the stored file. */
+              expiresAt: string;
+          }
+
           declare const THEME_COLOR_TOKENS: readonly ["accent", "accentText", "accentSoft", "accentTextMuted", "surface", "surfaceMuted", "text", "textMuted", "border", "userBubble", "userBubbleText", "assistantBubble", "assistantBubbleText", "field", "error", "errorSurface", "errorText", "link", "scrim"];
 
           declare const THEME_FONT_TOKENS: readonly ["heading", "body"];
@@ -762,6 +915,45 @@ export declare class ChatApiClient {
           /** A URL match: a case-insensitive substring, or a regular expression. */
           export declare type UrlPattern = string | RegExp;
 
+          /**
+           * How the mic button records: `"toggle"` starts on one click and stops on the
+           * next; `"hold"` records only while the button is held down.
+           */
+          export declare type VoiceInputMode = "toggle" | "hold";
+
+          /**
+           * Voice features. Pass to {@link ChatWidget} via the `voice` prop (or `true`
+           * for the defaults). Both halves rely on the browser's Web Speech API and
+           * render nothing where it is missing.
+           */
+          export declare interface VoiceOptions {
+              /**
+               * Show the mic button for dictating messages.
+               * @defaultValue `true`
+               */
+              input?: boolean;
+              /**
+               * Show the read-aloud control on completed assistant messages.
+               * @defaultValue `true`
+               */
+              output?: boolean;
+              /**
+               * How the mic button records.
+               * @defaultValue `"toggle"`
+               */
+              mode?: VoiceInputMode;
+              /**
+               * Send the dictated message as soon as recognition ends.
+               * @defaultValue `false`
+               */
+              autoSubmit?: boolean;
+              /**
+               * BCP-47 language tag for recognition and playback (e.g. `"en-GB"`).
+               * Defaults to a tag derived from the widget locale.
+               */
+              lang?: string;
+          }
+
           /** Corner of the viewport the widget docks to. */
           export declare type WidgetPosition = "bottom-right" | "bottom-left" | "top-right" | "top-left";
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claudius-chat-widget",
-  "version": "1.14.0",
+  "version": "1.16.0",
   "type": "module",
   "description": "Embeddable AI chat widget powered by Claude. Drop-in React component or standalone script embed, backed by a Cloudflare Worker.",
   "keywords": [