@waniwani/sdk 0.11.27 → 0.12.1

package/dist/legacy/index.d.ts

@@ -1123,6 +1123,29 @@ interface NextJsHandlerResult {
  */
 declare function toNextJsHandler(client: WaniWaniClient, options: NextJsHandlerOptions): NextJsHandlerResult;
 
+/**
+ * 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;
@@ -1136,6 +1159,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 */
@@ -1195,8 +1222,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 */
@@ -1260,6 +1290,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;
 }
 /** Handler signature for MCP tool calls from widgets. */
 type CallToolHandler = (params: {
@@ -1303,6 +1339,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.