@waniwani/sdk 0.11.27 → 0.12.0

package/dist/chat/index.d.ts

@@ -3,6 +3,29 @@ import * as ai from 'ai';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ContentBlock } from '@modelcontextprotocol/sdk/types.js';
 
+/**
+ * Built-in theme presets. `auto` follows the host's `prefers-color-scheme`
+ * and switches at runtime without re-rendering.
+ */
+type ThemePreset = "light" | "dark" | "auto";
+/**
+ * Appearance config for the chat widget. Pick a preset and (optionally) layer
+ * per-property `variables` on top.
+ *
+ * ```ts
+ * appearance: { theme: "dark", variables: { primaryColor: "#ff6b6b" } }
+ * ```
+ *
+ * The same shape is accepted by the `embed.js` script (`init({ appearance })`),
+ * `<WaniwaniChat overrides={{ appearance }} />`, and `<ChatEmbed appearance />`.
+ */
+interface ChatAppearance {
+    /** Base theme preset. Defaults to `"light"`. */
+    theme?: ThemePreset;
+    /** Per-property overrides applied on top of the preset. */
+    variables?: ChatTheme;
+}
+
 interface ChatTheme {
     /** Primary brand color (bubble, send button, user messages) */
     primaryColor?: string;
@@ -16,6 +39,10 @@ interface ChatTheme {
     mutedColor?: string;
     /** Border color */
     borderColor?: string;
+    /** Border width for the panel (px). Defaults to 0 (no border). */
+    borderWidth?: number;
+    /** Box-shadow shorthand applied to the panel. Use any valid CSS box-shadow string (e.g. `"0 10px 25px rgba(0,0,0,0.1)"`). Defaults to `none`. */
+    boxShadow?: string;
     /** Assistant message bubble background */
     assistantBubbleColor?: string;
     /** User message bubble background */
@@ -75,8 +102,11 @@ interface ChatBaseProps {
      * Takes precedence over `welcomeMessage` when provided.
      */
     welcome?: WelcomeConfig;
-    /** Theme overrides */
-    theme?: ChatTheme;
+    /**
+     * Theme preset (`light`/`dark`/`auto`) plus per-property overrides.
+     * See `ChatAppearance` for the shape.
+     */
+    appearance?: ChatAppearance;
     /** Additional headers to send with chat API requests */
     headers?: Record<string, string>;
     /** Additional body fields to send with each chat request */
@@ -140,6 +170,12 @@ interface ChatBaseProps {
     activeThreadId?: string;
     /** Fired whenever the active thread changes (new chat, switch, delete). */
     onThreadChange?: (threadId: string) => void;
+    /**
+     * AI transparency notice rendered under the input (EU AI Act compliance).
+     * Defaults to `"AI can make mistakes. Verify important information."`.
+     * Pass a string to override the wording, or `false` to hide it entirely.
+     */
+    disclaimer?: string | false;
 }
 /**
  * MCP Apps configuration for {@link ChatEmbedProps}.
@@ -194,7 +230,7 @@ type CallToolHandler = (params: {
  * <ChatEmbed
  *   api="/api/my-chat-endpoint"
  *   body={{ environmentId, sessionId }}
- *   theme={{ backgroundColor: "#fff" }}
+ *   appearance={{ theme: "dark" }}
  * />
  *
  * // Self-hosted chat endpoint with MCP App widgets
@@ -261,6 +297,8 @@ interface ChatCardProps extends ChatBaseProps {
     height?: number | string;
     /** Additional class names applied to the root element (e.g. Tailwind classes). */
     className?: string;
+    /** Theme overrides. Legacy API; new code should use the `appearance` field on `WaniwaniChat` / `ChatEmbed`. */
+    theme?: ChatTheme;
 }
 /**
  * @deprecated Use `WaniwaniChat` from `@waniwani/sdk/chat` for new code.
@@ -384,12 +422,23 @@ interface WaniwaniChatOverrides {
     showToolCalls?: boolean;
     /** Enable file attachments in the input. */
     allowAttachments?: boolean;
-    /** Theme overrides. */
-    theme?: ChatTheme;
+    /**
+     * Theme preset (`light`/`dark`/`auto`) plus per-property overrides.
+     *
+     * ```tsx
+     * appearance={{ theme: "dark", variables: { primaryColor: "#ff6b6b" } }}
+     * ```
+     */
+    appearance?: ChatAppearance;
     /** Chat API URL. Defaults to `https://app.waniwani.ai/api/mcp/chat`. */
     api?: string;
     /** Override the MCP server URL (rarely needed). */
     mcpServerUrl?: string;
+    /**
+     * AI transparency notice rendered under the input (EU AI Act compliance).
+     * String overrides the default wording; `false` hides it.
+     */
+    disclaimer?: string | false;
 }
 /**
  * Hosted-tier WaniWani chat. The React counterpart to the `<script>` embed.
@@ -451,6 +500,13 @@ declare const WaniwaniChat: react.ForwardRefExoticComponent<WaniwaniChatProps &
 declare const DEFAULT_THEME: Required<ChatTheme>;
 declare const DARK_THEME: ChatTheme;
 declare function mergeTheme(userTheme?: ChatTheme): Required<ChatTheme>;
-declare function themeToCSSProperties(theme: Required<ChatTheme>): Record<string, string>;
+/**
+ * Serialise a (partial) `ChatTheme` to inline CSS custom properties. Only
+ * keys present on the input are emitted — unspecified properties fall back
+ * to the cascade in `tailwind.css` (`var(--ww-primary, #6366f1)` chain).
+ * This lets a customer's `[data-waniwani-embed] { --ww-primary: ... }` win
+ * over the chat root's defaults when only a few keys are customised.
+ */
+declare function themeToCSSProperties(theme: ChatTheme): Record<string, string>;
 
-export { type ChatBaseProps, ChatCard, type ChatCardProps, ChatEmbed, type ChatEmbedMcpConfig, type ChatEmbedProps, type ChatHandle, type ChatTheme, DARK_THEME, DEFAULT_THEME, type McpAppDisplayMode, McpAppFrame, type McpAppFrameProps, type SuggestionsConfig, WaniwaniChat, type WaniwaniChatOverrides, type WaniwaniChatProps, type WelcomeConfig, mergeTheme, themeToCSSProperties };
+export { type ChatAppearance, type ChatBaseProps, ChatCard, type ChatCardProps, ChatEmbed, type ChatEmbedMcpConfig, type ChatEmbedProps, type ChatHandle, type ChatTheme, DARK_THEME, DEFAULT_THEME, type McpAppDisplayMode, McpAppFrame, type McpAppFrameProps, type SuggestionsConfig, type ThemePreset, WaniwaniChat, type WaniwaniChatOverrides, type WaniwaniChatProps, type WelcomeConfig, mergeTheme, themeToCSSProperties };