@paramms/chat-widget 1.6.3 → 1.9.0

package/dist/i18n.d.ts

@@ -0,0 +1,41 @@
+export type WidgetLocale = 'en' | 'ko';
+/** The auto-localized string set (everything except the two special keys above). */
+export interface WidgetStrings {
+    placeholder: string;
+    offline: string;
+    online: string;
+    away: string;
+    aiAssistant: string;
+    resolved: string;
+    reopen: string;
+    sources: string;
+    helpful: string;
+    notHelpful: string;
+    title: string;
+    newChat: string;
+    startChat: string;
+    all: string;
+    empty: string;
+    error: string;
+    retry: string;
+    search: string;
+    unread: string;
+    close: string;
+}
+/** Host overrides: any built-in string, plus the two special override-only keys. */
+export type WidgetI18nOverrides = Partial<WidgetStrings> & {
+    poweredBy?: string;
+    send?: string;
+};
+/** Resolve a supported locale from an explicit option or the browser. KO⇄EN
+ *  only — anything that isn't Korean resolves to English. Accepts full BCP-47
+ *  tags ('ko-KR'), bare codes ('ko'), or names ('korean'/'한국어'). */
+export declare function resolveLocale(explicit?: string): WidgetLocale;
+/** The full string set for the resolved locale, with host per-key overrides
+ *  applied on top (overrides win; blank/undefined override values are ignored so
+ *  a partial override object never blanks a built-in string). The result may
+ *  also carry `poweredBy`/`send` when the host provided them. */
+export declare function resolveStrings(locale?: string, overrides?: WidgetI18nOverrides): WidgetStrings & {
+    poweredBy?: string;
+    send?: string;
+};

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { asConversationId } from './protocol/index.js';
 import { type WidgetConfig } from './renderer.js';
+import { type WidgetI18nOverrides } from './i18n.js';
 export interface UserInfo {
     /** Display name shown in the conversation (e.g. "Sarah Chen"). */
     name?: string;
@@ -65,9 +66,10 @@ export interface MountOptions {
     /** Inbox scope: 'tenant' (default) lists the user's threads across ALL your
      *  chatrooms; 'profile' limits to this chatroom. */
     inboxScope?: 'tenant' | 'profile';
-    /** If set, shows a 🌐 translate button on incoming messages that translates
-     *  them into this language (ISO code or language name) via the server's
-     *  /translate endpoint. Omit to disable the feature. */
+    /** Target language for the 🌐 translate button shown under every incoming
+     *  message (via the server's /translate endpoint). Defaults to the guest's
+     *  own language (from `locale`/navigator.language) — translation is ON by
+     *  default. Set a specific ISO code to force it, or '' to disable. */
     translateLang?: string;
     /** If true, mount as a floating launcher button that opens/closes the chat */
     launcher?: boolean;
@@ -98,19 +100,13 @@ export interface MountOptions {
         csat?: boolean;
         deflection?: boolean;
     };
-    /** i18n: override UI strings. All keys are optional — omitted keys fall
-     *  back to English defaults. */
-    i18n?: {
-        placeholder?: string;
-        send?: string;
-        offline?: string;
-        poweredBy?: string;
-        online?: string;
-        away?: string;
-        aiAssistant?: string;
-        resolved?: string;
-        reopen?: string;
-    };
+    /** UI language for built-in strings. A BCP-47 tag ('ko', 'ko-KR'), bare code,
+     *  or name. Omit to auto-detect from the visitor's browser (navigator.language).
+     *  Currently Korean ⇄ English; anything non-Korean resolves to English. */
+    locale?: string;
+    /** i18n: override UI strings. All keys are optional — omitted keys use the
+     *  built-in dictionary for the resolved `locale` (English by default). */
+    i18n?: WidgetI18nOverrides;
 }
 export interface WidgetHandle {
     close(): void;