@alxxsck/ai-assistant 2.5.1 → 2.7.0

package/README.md

@@ -41,6 +41,7 @@ const widget = new ChatWidgetInstance({
     interactionSessionId: session.interactionSessionId,
     expiresAt: session.expiresAt,
   },
+  locale: productLocale,
   onRenewSession: async () => {
     const nextSession = await productApi.createLolaInteractionSession();
     widget.setCustomerInteractionSession(nextSession);
@@ -77,6 +78,7 @@ The supported instance methods are:
 
 ```ts
 widget.setOpen(true);
+widget.setLocale(productLocale);
 widget.setCustomerInteractionSession(nextSession);
 await widget.track({ event: "Game Opened", params: { gameId: "42" } });
 widget.destroy();
@@ -87,6 +89,35 @@ latest requested state is applied when the UI is ready. Session replacement upda
 authenticated HTTP, realtime, message, voice, and command dependencies without
 recreating the public widget instance.
 
+## Localization
+
+Pass the product's current locale directly to the widget. English is used when
+`locale` is omitted, empty, invalid, or unsupported:
+
+```ts
+const widget = new ChatWidgetInstance({
+  customerInteractionSession: session,
+  locale: productLocale, // for example "es-MX" or "pt-BR"
+});
+```
+
+When the product language changes, update the mounted widget in place:
+
+```ts
+widget.setLocale(nextProductLocale);
+```
+
+Regional tags are normalized to a supported base language. The widget currently
+ships `ru`, `uz`, `en`, `it`, `es`, `de`, `fr`, `pl`, `pt`, `bn`, `sw`, `so`,
+and `ar`; Arabic automatically enables right-to-left layout. Updating the locale
+preserves the open route, messages, draft, active conversation, voice state, and
+CTA state, and does not reconnect transports.
+
+The locale controls only text owned by the widget. Assistant and backend content
+is displayed as received; the assistant's response language follows the user's
+messages. See [the localization guide](docs/localization.ru.md) for the complete
+integration contract.
+
 The widget calls `onRenewSession` before expiry and after supported authentication
 failures. Refresh through the product backend and replace the session in the
 callback:
@@ -171,12 +202,12 @@ surface. Remove these constructor properties from integrations:
 
 - `mountElementId`, `agentId`, `customerId`, `configName`
 - `apiUrl`, `wsUrl`
-- `AIAvatar`, `background`, `footer`, `voiceEnabled`, `voiceConfig`, `locale`
+- `AIAvatar`, `background`, `footer`, `voiceEnabled`, `voiceConfig`
 - `manualOpen`, `avatarDebug`, `uiTargets`, `commandHandlers`
 
 Replace `manualOpen` with `hideOpenButton: true` only when the standard launcher
 must be hidden. Remove calls to `playAnimation`, `executeReaction`,
-`sendServiceMessage`, `setLocale`, `registerUiTarget`, and
+`sendServiceMessage`, `registerUiTarget`, and
 `registerCommandHandler`. Backend commands retain the supported assistant
 behaviour internally.
 

package/dist/App.d.ts

@@ -15,6 +15,7 @@ export type AppApi = {
     registerSetOpen: (fn: ((open: boolean) => void) | null) => void;
     resolveAssetPath: (path: string) => string;
     registerSetSession: (fn: ((session: CustomerInteractionSession) => void) | null) => void;
+    registerSetLocale: (fn: ((locale: string) => void) | null) => void;
     commandRuntime: CommandRuntime;
 };
 type AppProps = {

package/dist/{Avatar-DklBomzT.js → Avatar-BBTR5vL8.js}

@@ -1,4 +1,4 @@
-import { B as $s } from "./index-D9W50u8W.js";
+import { I as $s } from "./index-Cyv8CKEt.js";
 var Fr = typeof globalThis < "u" ? globalThis : typeof window < "u" ? window : typeof global < "u" ? global : typeof self < "u" ? self : {};
 const Ul = "182", Hf = 0, bc = 1, Wf = 2, js = 1, Ku = 2, Gr = 3, di = 0, jt = 1, Zn = 2, $n = 0, ur = 1, Ac = 2, Ec = 3, wc = 4, Xf = 5, Ci = 100, qf = 101, Yf = 102, Kf = 103, Zf = 104, $f = 200, jf = 201, Jf = 202, Qf = 203, wo = 204, Ro = 205, ed = 206, td = 207, nd = 208, id = 209, rd = 210, sd = 211, ad = 212, od = 213, ld = 214, Co = 0, Po = 1, Io = 2, dr = 3, Do = 4, Lo = 5, Fo = 6, Uo = 7, xa = 0, cd = 1, ud = 2, Un = 0, Zu = 1, $u = 2, ju = 3, Ju = 4, Qu = 5, eh = 6, th = 7, Rc = "attached", hd = "detached", nh = 300, Oi = 301, pr = 302, aa = 303, No = 304, ya = 306, wt = 1e3, En = 1001, Oo = 1002, Lt = 1003, fd = 1004, Ss = 1005, kt = 1006, La = 1007, Ii = 1008, sn = 1009, ih = 1010, rh = 1011, ts = 1012, Nl = 1013, Bn = 1014, wn = 1015, Jn = 1016, Ol = 1017, Bl = 1018, ns = 1020, sh = 35902, ah = 35899, oh = 1021, lh = 1022, mn = 1023, Qn = 1026, Di = 1027, ch = 1028, kl = 1029, mr = 1030, Vl = 1031, zl = 1033, Js = 33776, Qs = 33777, ea = 33778, ta = 33779, Bo = 35840, ko = 35841, Vo = 35842, zo = 35843, Go = 36196, Ho = 37492, Wo = 37496, Xo = 37488, qo = 37489, Yo = 37490, Ko = 37491, Zo = 37808, $o = 37809, jo = 37810, Jo = 37811, Qo = 37812, el = 37813, tl = 37814, nl = 37815, il = 37816, rl = 37817, sl = 37818, al = 37819, ol = 37820, ll = 37821, cl = 36492, ul = 36494, hl = 36495, fl = 36283, dl = 36284, pl = 36285, ml = 36286, uh = 2200, dd = 2201, pd = 2202, oa = 2300, _l = 2301, Fa = 2302, sr = 2400, ar = 2401, la = 2402, Gl = 2500, md = 2501, _d = 3200, Sa = 0, gd = 1, ci = "", Ue = "srgb", _r = "srgb-linear", ca = "linear", nt = "srgb", Gi = 7680, Cc = 519, vd = 512, xd = 513, yd = 514, Hl = 515, Sd = 516, Md = 517, Wl = 518, Td = 519, Pc = 35044, Ic = "300 es", Fn = 2e3, ua = 2001;
 function hh(s) {