@telnyx/ai-chat-widget 4.0.3 → 4.1.2

package/dist/index.d.ts

@@ -11,10 +11,11 @@ declare type BaseProps = {
      */
     endpoint?: 'flow' | 'aida';
     /**
-     * The base URL for AIDA (Heavy thinking mode)
-     * @required
+     * The base URL for AIDA (Heavy thinking mode).
+     * Optional — if omitted, defaults to the internal AIDA endpoint.
+     * When only flowAPIUrl is provided, the widget runs in flow-only mode.
      */
-    chatAPIUrl: string;
+    chatAPIUrl?: string;
     /**
      * The base URL for Flow (Instant mode). If not provided, uses chatAPIUrl.
      */
@@ -56,9 +57,17 @@ declare type BaseProps = {
      * The action to be performed when the user clicks the help button
      */
     onHelpAction?: () => void;
+    /**
+     * The theme to use for the chat widget
+     * - 'light': Always use light theme
+     * - 'dark': Always use dark theme
+     * - 'system': Automatically detect system preference
+     * @default 'light'
+     */
+    theme?: WidgetTheme;
 };
 
-export declare const ChatWidget: ({ chatAPIUrl, flowAPIUrl, flowApiKey, feedbackAPIUrl, user, onHelpAction, open, setOpen, placeholders, mountPosition, mountDirection, offsetX, offsetY, icon, }: ChatWidgetProps) => JSX.Element;
+export declare const ChatWidget: ({ chatAPIUrl, flowAPIUrl, flowApiKey, feedbackAPIUrl, user, onHelpAction, open, setOpen, placeholders, mountPosition, mountDirection, offsetX, offsetY, icon, theme, }: ChatWidgetProps) => JSX.Element;
 
 declare interface ChatWidgetNoMounting extends BaseProps {
     open?: never;
@@ -175,8 +184,16 @@ declare const WIDGET_MOUNT_POSITIONS: {
     readonly LEFT: "left";
 };
 
+declare const WIDGET_THEMES: {
+    readonly LIGHT: "light";
+    readonly DARK: "dark";
+    readonly SYSTEM: "system";
+};
+
 declare type WidgetMountDirection = (typeof WIDGET_MOUNT_DIRECTION)[keyof typeof WIDGET_MOUNT_DIRECTION];
 
 declare type WidgetMountPosition = (typeof WIDGET_MOUNT_POSITIONS)[keyof typeof WIDGET_MOUNT_POSITIONS];
 
+declare type WidgetTheme = (typeof WIDGET_THEMES)[keyof typeof WIDGET_THEMES];
+
 export { }