feat(chatwoot,#79): expose typed config fields on ChatwootLoadOptions

Eleven Chatwoot settings (type, widgetStyle, darkMode, position, locale,
useBrowserLanguage, hideMessageBubble, showPopoutButton,
showUnreadMessagesDialog, launcherTitle, baseDomain) were previously
only reachable via the opaque settings blob. Promote them to first-class,
typed fields and merge them into window.chatwootSettings before boot,
keeping `settings` as an escape hatch for anything not yet typed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: productdevbook

src/providers/chatwoot.ts

@@ -93,9 +93,46 @@ function normalizeBaseUrl(url: string): string {
   return u
 }
 
+const TYPED_SETTINGS_KEYS = [
+  "type",
+  "widgetStyle",
+  "darkMode",
+  "position",
+  "locale",
+  "useBrowserLanguage",
+  "hideMessageBubble",
+  "showPopoutButton",
+  "showUnreadMessagesDialog",
+  "launcherTitle",
+  "baseDomain",
+] as const satisfies ReadonlyArray<keyof ChatwootLoadOptions>
+
 export interface ChatwootLoadOptions extends LoadOptions {
   websiteToken: string
   baseUrl?: string
+  /** Bubble design. */
+  type?: "standard" | "expanded_bubble"
+  /** Widget chrome variant. */
+  widgetStyle?: "standard" | "flat"
+  /** Initial color scheme; runtime override available via setColorScheme(). */
+  darkMode?: "light" | "auto"
+  /** Bubble alignment. */
+  position?: "left" | "right"
+  /** Initial locale; runtime override available via setLocale(). */
+  locale?: string
+  /** When true, Chatwoot picks the locale from the visitor's browser. */
+  useBrowserLanguage?: boolean
+  /** Hide the floating message bubble. */
+  hideMessageBubble?: boolean
+  /** Show a popout button inside the widget header. */
+  showPopoutButton?: boolean
+  /** Show the unread-messages dialog. */
+  showUnreadMessagesDialog?: boolean
+  /** Custom launcher button title. */
+  launcherTitle?: string
+  /** Cookie domain (typically used for cross-subdomain identity). */
+  baseDomain?: string
+  /** Escape hatch for any setting not yet typed; merged before typed fields. */
   settings?: Record<string, unknown>
 }
 
@@ -112,7 +149,12 @@ export async function load(options: ChatwootLoadOptions): Promise<void> {
   currentToken = options.websiteToken
   currentBaseUrl = baseUrl
   await waitForDefer(options.defer ?? "immediate")
-  if (options.settings) w().chatwootSettings = options.settings
+  const settings: Record<string, unknown> = { ...options.settings }
+  for (const key of TYPED_SETTINGS_KEYS) {
+    const v = options[key]
+    if (v !== undefined) settings[key] = v
+  }
+  if (Object.keys(settings).length > 0) w().chatwootSettings = settings
 
   readyPromise = new Promise((r) => {
     readyResolve = r

test/chatwoot.browser.test.ts

@@ -116,6 +116,60 @@ describe("chatwoot (browser) — vendor-doc audit fixes (#79)", () => {
     await chatwoot.destroy()
   })
 
+  it("typed config fields populate window.chatwootSettings", async () => {
+    const rec: Recorded = {
+      setColorScheme: [],
+      deleteCustomAttribute: [],
+      deleteConversationCustomAttribute: [],
+      popoutChatWindow: 0,
+    }
+    const chatwoot = await import("../src/providers/chatwoot.ts")
+    const loadPromise = chatwoot.load({
+      websiteToken: "tok_typed",
+      type: "expanded_bubble",
+      widgetStyle: "flat",
+      darkMode: "auto",
+      position: "left",
+      locale: "tr",
+      useBrowserLanguage: false,
+      hideMessageBubble: true,
+      showPopoutButton: true,
+      showUnreadMessagesDialog: false,
+      launcherTitle: "Yardım",
+      baseDomain: ".example.com",
+      settings: { customField: "kept" },
+    })
+    await new Promise((r) => setTimeout(r, 0))
+
+    // biome-ignore lint/suspicious/noExplicitAny: test shim
+    const settings = (globalThis as any).chatwootSettings as Record<string, unknown>
+    expect(settings).toMatchObject({
+      type: "expanded_bubble",
+      widgetStyle: "flat",
+      darkMode: "auto",
+      position: "left",
+      locale: "tr",
+      useBrowserLanguage: false,
+      hideMessageBubble: true,
+      showPopoutButton: true,
+      showUnreadMessagesDialog: false,
+      launcherTitle: "Yardım",
+      baseDomain: ".example.com",
+      customField: "kept",
+    })
+
+    // Finish boot so destroy() doesn't race.
+    const script = document.getElementById("ahize-chatwoot") as HTMLScriptElement
+    // biome-ignore lint/suspicious/noExplicitAny: test shim
+    ;(globalThis as any).chatwootSDK = { run: () => {} }
+    // biome-ignore lint/suspicious/noExplicitAny: test shim
+    ;(globalThis as any).$chatwoot = fakeChatwoot(rec)
+    script.dispatchEvent(new Event("load"))
+    window.dispatchEvent(new CustomEvent("chatwoot:ready"))
+    await loadPromise
+    await chatwoot.destroy()
+  })
+
   it("bridges chatwoot:opened / closed / on-start-conversation / postback", async () => {
     const rec: Recorded = {
       setColorScheme: [],