@belonguniverseai/react-sdk 0.1.2 → 0.1.3

package/dist/component/{mindmap-definition-RKZ34NQL-C0g8QURW.js → mindmap-definition-RKZ34NQL-4eLujZip.js}

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-CLJ9pgvn.js";
-import { s as ae } from "./chunk-2J33WTMH-iwZo17vf.js";
-import { _ as l, l as C, p as ce, r as le, G as he, K as G, c as B, i as F, b6 as de, af as ge, ag as ue, ah as pe } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { g as oe } from "./chunk-55IACEB6-Da2BRT6c.js";
+import { s as ae } from "./chunk-2J33WTMH-Dg3NXbVg.js";
+import { _ as l, l as C, p as ce, r as le, G as he, K as G, c as B, i as F, b6 as de, af as ge, ag as ue, ah as pe } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const b = [];
@@ -830,4 +830,4 @@ var _e = Y, ke = 12, N = {
 export {
   we as diagram
 };
-//# sourceMappingURL=mindmap-definition-RKZ34NQL-C0g8QURW.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-4eLujZip.js.map

package/dist/component/{pieDiagram-4H26LBE5-Mbexiv4J.js → pieDiagram-4H26LBE5-Bv3aeU7h.js}

@@ -1,7 +1,7 @@
-import { a0 as S, S as R, b5 as J, g as Q, s as Y, a as tt, b as et, t as at, q as nt, _ as g, l as W, c as rt, I as it, N as st, a7 as lt, e as ot, B as ct, K as ut } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
-import { p as gt } from "./chunk-4BX2VUAB-CKT6dptL.js";
+import { a0 as S, S as R, b5 as J, g as Q, s as Y, a as tt, b as et, t as at, q as nt, _ as g, l as W, c as rt, I as it, N as st, a7 as lt, e as ot, B as ct, K as ut } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
+import { p as gt } from "./chunk-4BX2VUAB-BDtEKe-l.js";
 import { p as dt } from "./wardley-L42UT6IY-HA1eSIS_.js";
-import { d as P } from "./arc-DPDIJagU.js";
+import { d as P } from "./arc-Dftg9hbM.js";
 import { o as pt } from "./ordinal-D0x7izaa.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -163,4 +163,4 @@ var vt = ut.pie, z = {
 export {
   Lt as diagram
 };
-//# sourceMappingURL=pieDiagram-4H26LBE5-Mbexiv4J.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-Bv3aeU7h.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-BPRDLHzc.js → quadrantDiagram-W4KKPZXB-BlpxPqAT.js}

@@ -1,5 +1,5 @@
-import { s as Se, g as _e, t as ee, q as Ae, a as ke, b as Fe, _ as r, c as Et, l as qt, d as vt, e as Pe, B as ve, K as z, i as Ce, a4 as Le } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
-import { l as te } from "./linear-COVcd8bM.js";
+import { s as Se, g as _e, t as ee, q as Ae, a as ke, b as Fe, _ as r, c as Et, l as qt, d as vt, e as Pe, B as ve, K as z, i as Ce, a4 as Le } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
+import { l as te } from "./linear-DSEm-mVJ.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var Ct = (function() {
@@ -1030,4 +1030,4 @@ var Ve = /* @__PURE__ */ r(function() {
 export {
   We as diagram
 };
-//# sourceMappingURL=quadrantDiagram-W4KKPZXB-BPRDLHzc.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-BlpxPqAT.js.map

package/dist/component/{requirementDiagram-4Y6WPE33-XjOXpLfB.js → requirementDiagram-4Y6WPE33-DGG1FxFS.js}

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-CLJ9pgvn.js";
-import { s as ze } from "./chunk-2J33WTMH-iwZo17vf.js";
-import { _ as h, G as Ye, b as Xe, a as Je, s as Ze, g as et, q as tt, t as st, c as ke, l as Ne, B as it, F as rt, p as nt, r as at, u as lt } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { g as Ge } from "./chunk-55IACEB6-Da2BRT6c.js";
+import { s as ze } from "./chunk-2J33WTMH-Dg3NXbVg.js";
+import { _ as h, G as Ye, b as Xe, a as Je, s as Ze, g as et, q as tt, t as st, c as ke, l as Ne, B as it, F as rt, p as nt, r as at, u as lt } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var qe = (function() {
@@ -885,4 +885,4 @@ var mt = /* @__PURE__ */ h(async function(e, u, o, n) {
 export {
   Rt as diagram
 };
-//# sourceMappingURL=requirementDiagram-4Y6WPE33-XjOXpLfB.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-DGG1FxFS.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-Boo0vXVH.js → sankeyDiagram-5OEKKPKP-CQ-jfvW-.js}

@@ -1,4 +1,4 @@
-import { q as kt, t as mt, s as xt, g as _t, b as vt, a as bt, _ as y, c as ot, C as St, d as G, ai as wt, B as Lt, k as Et } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { q as kt, t as mt, s as xt, g as _t, b as vt, a as bt, _ as y, c as ot, C as St, d as G, ai as wt, B as Lt, k as Et } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 import { o as Tt } from "./ordinal-D0x7izaa.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -859,4 +859,4 @@ var ge = {
 export {
   ge as diagram
 };
-//# sourceMappingURL=sankeyDiagram-5OEKKPKP-Boo0vXVH.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-CQ-jfvW-.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-CmZk5hb2.js → sequenceDiagram-3UESZ5HK-Ck-VbsGz.js}

@@ -1,6 +1,6 @@
-import { _ as g, o as tr, c as $, d as Mt, l as at, j as Ce, e as er, f as rr, k as P, b as ke, s as ar, q as sr, a as ir, g as nr, t as or, v as cr, J as lr, B as hr, i as Bt, u as Z, a5 as Q, a6 as wt, a7 as Me, a8 as dr, G as Yt, a9 as Tr, aa as Be } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-BUngsBoq.js";
-import { I as ur } from "./chunk-QZHKN3VN-CFfcj0kF.js";
+import { _ as g, o as tr, c as $, d as Mt, l as at, j as Ce, e as er, f as rr, k as P, b as ke, s as ar, q as sr, a as ir, g as nr, t as or, v as cr, J as lr, B as hr, i as Bt, u as Z, a5 as Q, a6 as wt, a7 as Me, a8 as dr, G as Yt, a9 as Tr, aa as Be } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
+import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-DbdImadK.js";
+import { I as ur } from "./chunk-QZHKN3VN-6IxJ3-HB.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var $t = (function() {
@@ -2894,4 +2894,4 @@ var ra = /* @__PURE__ */ g(async function(e, t, a) {
 export {
   Ta as diagram
 };
-//# sourceMappingURL=sequenceDiagram-3UESZ5HK-CmZk5hb2.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-Ck-VbsGz.js.map

package/dist/component/{stateDiagram-AJRCARHV-zKdC8ZqU.js → stateDiagram-AJRCARHV-KlZdFGFQ.js}

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-iLdnjZec.js";
-import { _ as f, c as t, d as M, l as S, e as P, k as z, ac as _, ad as U, a9 as C, u as F } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-D8PxFJHV.js";
+import { _ as f, c as t, d as M, l as S, e as P, k as z, ac as _, ad as U, a9 as C, u as F } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 import { G as O } from "./graph-BZLHvygk.js";
 import { l as J } from "./layout-Bu6nRdWm.js";
 globalThis.process = globalThis.process || { env: {} };
@@ -263,4 +263,4 @@ var X = /* @__PURE__ */ f((e) => e.append("circle").attr("class", "start-state")
 export {
   ot as diagram
 };
-//# sourceMappingURL=stateDiagram-AJRCARHV-zKdC8ZqU.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-KlZdFGFQ.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-C3TFxstc.js → stateDiagram-v2-BHNVJYJU-Djoz6HMn.js}

@@ -1,5 +1,5 @@
-import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-iLdnjZec.js";
-import { _ as l } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-D8PxFJHV.js";
+import { _ as l } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var b = {
@@ -16,4 +16,4 @@ var b = {
 export {
   b as diagram
 };
-//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-C3TFxstc.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-Djoz6HMn.js.map

package/dist/component/{timeline-definition-PNZ67QCA-DV17S1NP.js → timeline-definition-PNZ67QCA-C3x7MWUx.js}

@@ -1,5 +1,5 @@
-import { _ as o, G as gt, af as Rt, ag as Ct, ah as Wt, c as pt, l as E, N as Pt, a7 as Bt, ai as ft, d as U, F as Vt, aj as Ft, B as zt } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
-import { d as ot } from "./arc-DPDIJagU.js";
+import { _ as o, G as gt, af as Rt, ag as Ct, ah as Wt, c as pt, l as E, N as Pt, a7 as Bt, ai as ft, d as U, F as Vt, aj as Ft, B as zt } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
+import { d as ot } from "./arc-Dftg9hbM.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 var tt = (function() {
@@ -1055,4 +1055,4 @@ var Qt = /* @__PURE__ */ o(function(e, t, n, i, r, h = !1) {
 export {
   me as diagram
 };
-//# sourceMappingURL=timeline-definition-PNZ67QCA-DV17S1NP.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-C3x7MWUx.js.map

package/dist/component/{vennDiagram-CIIHVFJN-DtHYS_yc.js → vennDiagram-CIIHVFJN-B4SXjWyu.js}

@@ -1,4 +1,4 @@
-import { aX as Gt, s as Wt, g as Kt, t as Ht, q as Xt, a as Yt, b as Zt, _ as w, G as wt, N as Jt, d as ot, ao as Qt, af as $t, ag as te, ah as ee, e as ne, B as se, I as ie, K as oe } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { aX as Gt, s as Wt, g as Kt, t as Ht, q as Xt, a as Yt, b as Zt, _ as w, G as wt, N as Jt, d as ot, ao as Qt, af as $t, ag as te, ah as ee, e as ne, B as se, I as ie, K as oe } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 const kt = (t, n) => Gt(t, "a", -n), _t = 1e-10;
@@ -1557,4 +1557,4 @@ var qe = { draw: Ve }, Ge = {
 export {
   Ge as diagram
 };
-//# sourceMappingURL=vennDiagram-CIIHVFJN-DtHYS_yc.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-B4SXjWyu.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-BxPk1XTc.js → wardleyDiagram-YWT4CUSO-B_0Q8QFc.js}

@@ -1,5 +1,5 @@
-import { s as St, g as Mt, t as Nt, q as Tt, a as zt, b as Lt, _ as u, a4 as At, G as Xt, I as U, l as K, N as Et, e as Yt, B as It, c as j } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
-import { p as Bt } from "./chunk-4BX2VUAB-CKT6dptL.js";
+import { s as St, g as Mt, t as Nt, q as Tt, a as zt, b as Lt, _ as u, a4 as At, G as Xt, I as U, l as K, N as Et, e as Yt, B as It, c as j } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
+import { p as Bt } from "./chunk-4BX2VUAB-BDtEKe-l.js";
 import { p as Ft } from "./wardley-L42UT6IY-HA1eSIS_.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
@@ -678,4 +678,4 @@ var Dt = {
 export {
   Qt as diagram
 };
-//# sourceMappingURL=wardleyDiagram-YWT4CUSO-BxPk1XTc.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-B_0Q8QFc.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-C3o6FXYC.js → xychartDiagram-2RQKCTM6-yIfLkIZO.js}

@@ -1,7 +1,7 @@
-import { s as ei, g as si, t as Lt, q as ni, a as ai, b as oi, _ as a, l as Et, N as ri, e as hi, B as li, G as dt, i as ci, I as It, K as ui, a4 as gi, ap as xi, ac as Rt } from "./mermaid-GHXKKRXX-Bk5cDfRV.js";
+import { s as ei, g as si, t as Lt, q as ni, a as ai, b as oi, _ as a, l as Et, N as ri, e as hi, B as li, G as dt, i as ci, I as It, K as ui, a4 as gi, ap as xi, ac as Rt } from "./mermaid-GHXKKRXX-mE-t6fEG.js";
 import { i as di } from "./init-BOu0eQYQ.js";
 import { o as fi } from "./ordinal-D0x7izaa.js";
-import { l as Dt } from "./linear-COVcd8bM.js";
+import { l as Dt } from "./linear-DSEm-mVJ.js";
 globalThis.process = globalThis.process || { env: {} };
 globalThis.global = globalThis.global || globalThis;
 function pi(t, i, e) {
@@ -1372,4 +1372,4 @@ var Ti = /* @__PURE__ */ a(function() {
 export {
   Mi as diagram
 };
-//# sourceMappingURL=xychartDiagram-2RQKCTM6-C3o6FXYC.js.map
+//# sourceMappingURL=xychartDiagram-2RQKCTM6-yIfLkIZO.js.map

package/dist/components/embed/EmbedRail.d.ts

@@ -9,7 +9,7 @@ export type EmbedView = "chat" | "files";
  * expand-to-modal — then the collapse toggle. Active fill + brand colours come
  * from `palette` so a host brand push re-themes everything.
  */
-export declare function EmbedRail({ view, collapsed, user, theme, palette, sessions, activeId, planProgress, speakEnabled, ttsSupported, voiceSupported, accent, cssVars, presets, activePreset, onSelectView, onToggleCollapse, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onSessionsOpen, onToggleSpeak, onExpand, }: {
+export declare function EmbedRail({ view, collapsed, user, theme, palette, sessions, activeId, planProgress, speakEnabled, ttsSupported, voiceSupported, accent, cssVars, presets, activePreset, onSelectView, onToggleCollapse, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, onToggleSpeak, onExpand, }: {
     view: EmbedView;
     collapsed: boolean;
     user: string | null;
@@ -43,6 +43,7 @@ export declare function EmbedRail({ view, collapsed, user, theme, palette, sessi
     onNewSession: () => void;
     onSelectSession: (id: string) => void;
     onDeleteSession: (id: string) => void;
+    onRenameSession: (id: string, title: string) => void;
     onSessionsOpen?: () => void;
     onToggleSpeak: () => void;
     onExpand: () => void;

package/dist/components/embed/EmbedSessions.d.ts

@@ -5,11 +5,11 @@ export interface SessionSummary {
     readonly updatedAt: string;
 }
 /**
- * Header control to start a new chat, switch to a recent session, or delete
- * one via an inline trash → confirm flow. Supports new chat, switch, and
- * per-row delete (inline confirm).
+ * Header control to start a new chat, switch to a recent session, rename one via
+ * an inline text edit, or delete one via an inline trash → confirm flow. Rename +
+ * delete are per-row inline affordances that keep the menu open (BEL-120).
  */
-export declare function EmbedSessions({ sessions, activeId, theme, side, onNew, onSelect, onDelete, onOpen, }: {
+export declare function EmbedSessions({ sessions, activeId, theme, side, onNew, onSelect, onDelete, onRename, onOpen, }: {
     sessions: readonly SessionSummary[];
     activeId: string | null;
     theme: BelongTheme;
@@ -18,6 +18,8 @@ export declare function EmbedSessions({ sessions, activeId, theme, side, onNew,
     onNew: () => void;
     onSelect: (id: string) => void;
     onDelete: (id: string) => void;
+    /** Persist a user-chosen chat name (BEL-120). Only fired for a non-blank change. */
+    onRename: (id: string, title: string) => void;
     /** Fired when the menu opens — the dock refetches the list so it's fresh. */
     onOpen?: () => void;
 }): import("react").JSX.Element;

package/dist/components/embed/MentionInput.d.ts

@@ -1,5 +1,15 @@
 import { KeyboardEvent as ReactKeyboardEvent, Ref } from 'react';
 import { BelongThemePalette } from '../../types/public.ts';
+/**
+ * Is the editor the focused element within its OWN root? The dock mounts in a
+ * shadow root, where `el.ownerDocument.activeElement` is the shadow HOST (the dock
+ * element), never the inner editor — so a document-level focus check always reads
+ * "not focused", the caret-restore in the controlled-sync effect is skipped, and
+ * the caret collapses to offset 0 on every Shift+Enter / paste (BEL-94).
+ * `getRootNode()` returns the ShadowRoot (or Document in the light DOM); both
+ * expose `activeElement` scoped to that tree, so this holds in either mount.
+ */
+export declare const isEditorFocused: (el: HTMLElement) => boolean;
 export type MentionInputHandle = {
     focus: () => void;
     getCaret: () => number | null;

package/dist/embed/auto-embed.d.ts

@@ -4,7 +4,7 @@
  * Lets a host drop the dock in with a single tag and no glue JS:
  *
  *   <script src="https://…/belong-a3s-sdk.js" id="belong-sdk-script"
- *           data-backend="https://api.example.com"></script>
+ *           data-backend="https://api.example.com" data-locale="es"></script>
  *
  * On load we find that tag, read `data-backend`, and — for hosts that sign the
  * user in with Auth0 (e.g. Simetrik) — read the user's EXISTING access token

package/dist/embed/dock-layout.d.ts

@@ -24,6 +24,38 @@ export declare const resolveDockWidthPx: (state: DockResizeState, panelWidth: nu
  * reflow of text at every intermediate width.
  */
 export declare const resolvePanelWidthPx: (state: DockResizeState, panelWidth: number) => number;
+/** Clearance a host modal needs from the dock before we consider it clear. */
+export declare const HOST_MODAL_GUTTER_PX = 16;
+/**
+ * BEL-112: would a host modal at `rect` land under a dock reserving
+ * `reservePx` on `side` of a `viewportWidthPx` viewport? Pure geometry — the
+ * caller decides what to do about it (yield: collapse to the rail).
+ */
+export declare const hostModalOverlapsReserve: (rect: {
+    readonly left: number;
+    readonly right: number;
+}, viewportWidthPx: number, side: "left" | "right", reservePx: number) => boolean;
+/**
+ * BEL-112 "side to side": the signed `margin-left` (px) that pushes a host
+ * modal at `rect` (its UNSHIFTED position) out from under the dock — negative
+ * shifts left for a right dock, positive shifts right for a left dock. 0 when
+ * it's already clear. Margin composes with the host's own `left: 50%;
+ * translateX(-50%)` centering AND its open/close transform animations,
+ * so the push never fights either.
+ */
+export declare const resolveHostModalShiftPx: (rect: {
+    readonly left: number;
+    readonly right: number;
+}, viewportWidthPx: number, side: "left" | "right", reservePx: number) => number;
+/**
+ * Can the modal clear the dock by shifting alone — i.e. after the shift it
+ * still sits fully on-screen (a gutter from the far edge)? When false the
+ * dock must yield instead (collapse to the rail).
+ */
+export declare const canHostModalFitBesideDock: (rect: {
+    readonly left: number;
+    readonly right: number;
+}, viewportWidthPx: number, side: "left" | "right", reservePx: number) => boolean;
 /** Collapse toggle: any open state → collapsed; collapsed → expanded. */
 export declare const nextOnToggleCollapse: (state: DockResizeState) => DockResizeState;
 /** Modal toggle: expanded ↔ modal; no-op while collapsed. */

package/dist/embed/locale.d.ts

@@ -1,18 +1,37 @@
 import { BelongLocale } from '../types/public.ts';
 export type Locale = BelongLocale;
 export declare const DEFAULT_LOCALE: Locale;
-/** Set the host/tenant default locale (from `init`); user choice still wins. */
+/** Narrow an untrusted value (attribute, storage, navigator) to a Locale. */
+export declare const parseLocale: (value: unknown) => Locale | null;
+/**
+ * Declarative host/tenant default (from `init` / the React `locale` prop).
+ * The FIRST call seeds the deployment default — a stored user choice still
+ * wins. A LATER call with a different value is the host switching language
+ * at runtime (BEL-140): it drops the user override so the switch is visible.
+ * Re-applying the same value (React effect re-runs, re-`init`) is a no-op.
+ */
 export declare const configureLocale: (locale: Locale | undefined) => void;
+/**
+ * Imperative host switch (`belong.setLocale`, a `data-locale` attribute flip).
+ * Always applies and drops the user override — the host just told us the page
+ * language changed NOW.
+ */
+export declare const setHostLocale: (locale: Locale) => void;
 export declare const subscribeLocale: (listener: () => void) => (() => void);
-/** The effective locale: user choice, else host default, else English. */
+/** The effective locale: user choice ▸ host locale ▸ browser ▸ English. */
 export declare const peekLocale: () => Locale;
 /** The user's explicit choice, or null when none (host default applies). */
 export declare const peekUserLocale: () => Locale | null;
-/** Persist the user's language choice and notify subscribers. */
+/** Persist the user's in-dock language choice and notify subscribers. */
 export declare const setUserLocale: (locale: Locale) => void;
-/** Drop the user override (back to the host default / English). */
+/** Drop the user override (back to the host default / browser / English). */
 export declare const clearUserLocale: () => void;
 /** `useSyncExternalStore` hook — the effective locale, re-rendering on change. */
 export declare const useLocale: () => Locale;
-/** Test-only: clear listeners + host default and re-seed the user choice. */
+/**
+ * Test-only: reset host locale and re-seed the user choice from storage.
+ * Deliberately KEEPS the listener set — the i18next instance (`@sdk/i18n`)
+ * subscribes once at module load, and clearing it would silently detach the
+ * catalogs from the store for the rest of the test file.
+ */
 export declare const __resetLocaleForTest: () => void;

package/dist/i18n/i18n.d.ts

@@ -0,0 +1,6 @@
+import { default as i18next } from 'i18next';
+import { Locale } from '../embed/locale.ts';
+export type { Locale };
+/** The current locale (narrowed; falls back to English for any odd value). */
+export declare const getLocale: () => Locale;
+export { i18next };

package/dist/i18n/index.d.ts

@@ -0,0 +1,2 @@
+export { i18next, getLocale, type Locale } from './i18n.ts';
+export { useTranslation, I18nextProvider } from 'react-i18next';