@belonguniverseai/react-sdk 0.2.0 → 0.3.0

package/dist/component/{mindmap-definition-RKZ34NQL-Bal8oXYU.js → mindmap-definition-RKZ34NQL-CJO5YIaF.js}

@@ -1,6 +1,6 @@
-import { g as oe } from "./chunk-55IACEB6-kiI_RN43.js";
-import { s as ae } from "./chunk-2J33WTMH-BQFG3l5m.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-BOTLFr14.js";
+import { g as oe } from "./chunk-55IACEB6-CWb5s5u5.js";
+import { s as ae } from "./chunk-2J33WTMH-Bqhv40NQ.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-Bb3nq6cF.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-Bal8oXYU.js.map
+//# sourceMappingURL=mindmap-definition-RKZ34NQL-CJO5YIaF.js.map

package/dist/component/{pieDiagram-4H26LBE5-CCy9iJeT.js → pieDiagram-4H26LBE5-fLrS62rY.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-BOTLFr14.js";
-import { p as gt } from "./chunk-4BX2VUAB-DIgdkfba.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-Bb3nq6cF.js";
+import { p as gt } from "./chunk-4BX2VUAB-DtucQWno.js";
 import { p as dt } from "./wardley-L42UT6IY-HA1eSIS_.js";
-import { d as P } from "./arc-RUGz6lZa.js";
+import { d as P } from "./arc-CMhGaHbE.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-CCy9iJeT.js.map
+//# sourceMappingURL=pieDiagram-4H26LBE5-fLrS62rY.js.map

package/dist/component/{quadrantDiagram-W4KKPZXB-CZi1MEAc.js → quadrantDiagram-W4KKPZXB-BMjq2Lu4.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-BOTLFr14.js";
-import { l as te } from "./linear-DUkCqmPt.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-Bb3nq6cF.js";
+import { l as te } from "./linear-Deqp7k-y.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-CZi1MEAc.js.map
+//# sourceMappingURL=quadrantDiagram-W4KKPZXB-BMjq2Lu4.js.map

package/dist/component/{requirementDiagram-4Y6WPE33-irn_x5lf.js → requirementDiagram-4Y6WPE33-BPUkO56k.js}

@@ -1,6 +1,6 @@
-import { g as Ge } from "./chunk-55IACEB6-kiI_RN43.js";
-import { s as ze } from "./chunk-2J33WTMH-BQFG3l5m.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-BOTLFr14.js";
+import { g as Ge } from "./chunk-55IACEB6-CWb5s5u5.js";
+import { s as ze } from "./chunk-2J33WTMH-Bqhv40NQ.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-Bb3nq6cF.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-irn_x5lf.js.map
+//# sourceMappingURL=requirementDiagram-4Y6WPE33-BPUkO56k.js.map

package/dist/component/{sankeyDiagram-5OEKKPKP-CX2rM6Rj.js → sankeyDiagram-5OEKKPKP-ekNfY75x.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-BOTLFr14.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-Bb3nq6cF.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-CX2rM6Rj.js.map
+//# sourceMappingURL=sankeyDiagram-5OEKKPKP-ekNfY75x.js.map

package/dist/component/{sequenceDiagram-3UESZ5HK-DmHw71eT.js → sequenceDiagram-3UESZ5HK-CyVmC9Rm.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-BOTLFr14.js";
-import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-BG3KaNNT.js";
-import { I as ur } from "./chunk-QZHKN3VN-BekfxLxF.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-Bb3nq6cF.js";
+import { a as pr, b as ee, g as dt, d as Er, e as re, f as ae } from "./chunk-ND2GUHAM-DUfRBvcM.js";
+import { I as ur } from "./chunk-QZHKN3VN-ZyFUERub.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-DmHw71eT.js.map
+//# sourceMappingURL=sequenceDiagram-3UESZ5HK-CyVmC9Rm.js.map

package/dist/component/{stateDiagram-AJRCARHV-3u6GXMEg.js → stateDiagram-AJRCARHV-DFkc559m.js}

@@ -1,5 +1,5 @@
-import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-nUpTDfR9.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-BOTLFr14.js";
+import { s as R, a as W, S as N } from "./chunk-AQP2D5EJ-D00bX5Fy.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-Bb3nq6cF.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-3u6GXMEg.js.map
+//# sourceMappingURL=stateDiagram-AJRCARHV-DFkc559m.js.map

package/dist/component/{stateDiagram-v2-BHNVJYJU-CbUih_UR.js → stateDiagram-v2-BHNVJYJU-DyEtRcsV.js}

@@ -1,5 +1,5 @@
-import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-nUpTDfR9.js";
-import { _ as l } from "./mermaid-GHXKKRXX-BOTLFr14.js";
+import { s as e, b as r, a as s, S as t } from "./chunk-AQP2D5EJ-D00bX5Fy.js";
+import { _ as l } from "./mermaid-GHXKKRXX-Bb3nq6cF.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-CbUih_UR.js.map
+//# sourceMappingURL=stateDiagram-v2-BHNVJYJU-DyEtRcsV.js.map

package/dist/component/{timeline-definition-PNZ67QCA-BAW-94RV.js → timeline-definition-PNZ67QCA-BDLP-x66.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-BOTLFr14.js";
-import { d as ot } from "./arc-RUGz6lZa.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-Bb3nq6cF.js";
+import { d as ot } from "./arc-CMhGaHbE.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-BAW-94RV.js.map
+//# sourceMappingURL=timeline-definition-PNZ67QCA-BDLP-x66.js.map

package/dist/component/{vennDiagram-CIIHVFJN-IF4AwJuP.js → vennDiagram-CIIHVFJN-Bvhzsn8q.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-BOTLFr14.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-Bb3nq6cF.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-IF4AwJuP.js.map
+//# sourceMappingURL=vennDiagram-CIIHVFJN-Bvhzsn8q.js.map

package/dist/component/{wardleyDiagram-YWT4CUSO-Bn-uAkHk.js → wardleyDiagram-YWT4CUSO-SKdyvNF1.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-BOTLFr14.js";
-import { p as Bt } from "./chunk-4BX2VUAB-DIgdkfba.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-Bb3nq6cF.js";
+import { p as Bt } from "./chunk-4BX2VUAB-DtucQWno.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-Bn-uAkHk.js.map
+//# sourceMappingURL=wardleyDiagram-YWT4CUSO-SKdyvNF1.js.map

package/dist/component/{xychartDiagram-2RQKCTM6-CvPY-qXp.js → xychartDiagram-2RQKCTM6-DHchnrpW.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-BOTLFr14.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-Bb3nq6cF.js";
 import { i as di } from "./init-BOu0eQYQ.js";
 import { o as fi } from "./ordinal-D0x7izaa.js";
-import { l as Dt } from "./linear-DUkCqmPt.js";
+import { l as Dt } from "./linear-Deqp7k-y.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-CvPY-qXp.js.map
+//# sourceMappingURL=xychartDiagram-2RQKCTM6-DHchnrpW.js.map

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

@@ -0,0 +1,26 @@
+import { BelongThemePalette } from '../../types/public.ts';
+/**
+ * Live-call button — shared by the desktop rail (always visible, docked or
+ * collapsed) and the mobile bottom nav bar, so the user can call their agent
+ * from either chrome. Store-connected and self-contained: idle shows a plain
+ * phone; connecting spins; in-call shows a hang-up glyph over a pulsing ring
+ * (the "live" animation). Clicking toggles dial / hang-up; errors surface on
+ * the CallScreen when the chat surface is visible (audio + state machine run
+ * regardless).
+ */
+export declare const CallButton: ({ palette, testId, className, label, callSurfaceHidden, onShowCallSurface, }: {
+    palette: BelongThemePalette;
+    /** Distinguishes the rail instance from the mobile nav bar instance. */
+    testId?: string;
+    className?: string;
+    /** Visible text under the icon (mobile nav tabs carry names; the 52px rail
+     *  has no room and stays icon-only with the aria-label/tooltip). */
+    label?: string;
+    /** True when the CallScreen cannot be on screen (chat view hidden or dock
+     *  collapsed). A live call with the surface hidden means this button
+     *  RETURNS to the call — hanging up belongs to a screen the user can see. */
+    callSurfaceHidden?: boolean;
+    /** Navigate so the CallScreen is visible (switch to chat / expand). Called
+     *  when dialing or returning from a place where the surface is hidden. */
+    onShowCallSurface?: () => void;
+}) => import("react").JSX.Element;

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

@@ -7,12 +7,15 @@ import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.
  * colour + custom CSS), then Log out. Gradient is brand-driven (Ocean → Deep
  * Sea) via the active palette.
  */
-export declare function EmbedAvatar({ user, size, theme, palette, side, sessionId, voiceSupported, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, }: {
+export declare function EmbedAvatar({ user, size, theme, palette, side, menuSide: menuSideOverride, sessionId, voiceSupported, accent, cssVars, presets, activePreset, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, }: {
     user: string | null;
     size?: number;
     theme: BelongTheme;
     palette: BelongThemePalette;
     side: "left" | "right";
+    /** Where the menu opens. Defaults to "toward the panel" from the rail edge;
+     *  the mobile bottom nav bar overrides it to open upward. */
+    menuSide?: "left" | "right" | "top";
     /** Active chat session id (null when no conversation is open yet). Shown in
      *  the menu under the build stamp and copyable for telemetry correlation. */
     sessionId: string | null;

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

@@ -9,12 +9,19 @@ export interface SessionSummary {
  * 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, onRename, onOpen, }: {
+export declare function EmbedSessions({ sessions, activeId, theme, side, triggerClassName, triggerLabel, onNew, onSelect, onDelete, onRename, onOpen, }: {
     sessions: readonly SessionSummary[];
     activeId: string | null;
     theme: BelongTheme;
-    /** Which way the menu opens — toward the panel from the rail edge. */
-    side?: "left" | "right";
+    /** Which way the menu opens — toward the panel from the rail edge, or
+     *  upward when the trigger lives in the mobile bottom nav bar. */
+    side?: "left" | "right" | "top";
+    /** Extra trigger classes — the mobile nav bar bumps the 32px rail trigger
+     *  to a ≥44px touch target. */
+    triggerClassName?: string;
+    /** Visible text under the trigger icon (mobile nav names its cells; the
+     *  rail stays icon-only). */
+    triggerLabel?: string;
     onNew: () => void;
     onSelect: (id: string) => void;
     onDelete: (id: string) => void;

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

@@ -0,0 +1,39 @@
+import { SessionSummary } from './EmbedSessions';
+import { EmbedView } from './EmbedRail';
+import { BelongTheme, BelongThemePalette, PresetName } from '../../types/public.ts';
+/**
+ * Bottom nav bar for the MOBILE fullscreen sheet — the phone-width stand-in
+ * for the 52px desktop rail (which has no room on a phone). View tabs
+ * (chat / files / scheduled), the sessions switcher, the account avatar, and
+ * a close chevron. Every cell is a ≥44px touch target; menus open upward.
+ */
+export declare function MobileNavBar({ view, user, theme, palette, sessions, activeId, voiceSupported, accent, cssVars, presets, activePreset, onSelectView, onClose, onToggleMode, onToggleSide, onAccentChange, onAccentReset, onCssVarsChange, onApplyPreset, onLogout, onNewSession, onSelectSession, onDeleteSession, onRenameSession, onSessionsOpen, }: {
+    view: EmbedView;
+    user: string | null;
+    theme: BelongTheme;
+    palette: BelongThemePalette;
+    sessions: readonly SessionSummary[];
+    activeId: string | null;
+    voiceSupported: boolean;
+    accent: string | null;
+    cssVars: Record<string, string>;
+    presets: readonly {
+        name: PresetName;
+        label: string;
+    }[];
+    activePreset: PresetName;
+    onSelectView: (v: EmbedView) => void;
+    onClose: () => void;
+    onToggleMode: () => void;
+    onToggleSide: () => void;
+    onAccentChange: (c: string) => void;
+    onAccentReset: () => void;
+    onCssVarsChange: (v: Record<string, string>) => void;
+    onApplyPreset: (name: PresetName) => void;
+    onLogout: () => void;
+    onNewSession: () => void;
+    onSelectSession: (id: string) => void;
+    onDeleteSession: (id: string) => void;
+    onRenameSession: (id: string, title: string) => void;
+    onSessionsOpen?: () => void;
+}): import("react").JSX.Element;

package/dist/components/embed/mobile-nav-bar.fixtures.d.ts

@@ -0,0 +1,3 @@
+import { ComponentProps } from 'react';
+import { MobileNavBar } from './MobileNavBar.tsx';
+export declare const mobileNavBarProps: (overrides?: Partial<ComponentProps<typeof MobileNavBar>>) => ComponentProps<typeof MobileNavBar>;

package/dist/embed/copy.d.ts

@@ -127,9 +127,13 @@ export type DockCopy = {
         readonly placeholderDefault: Readonly<Record<DockCopyVariant, string>>;
         readonly placeholderPlan: Readonly<Record<DockCopyVariant, string>>;
         readonly voiceHint: (keyLabel: string) => string;
+        /** Mobile variant — no physical keyboard, so no push-to-talk key. */
+        readonly voiceHintTouch: string;
         readonly micNotSupported: string;
         readonly micNotConfigured: string;
         readonly micTooltip: (keyLabel: string) => string;
+        /** Mobile variant of the mic tooltip — omits the keyboard fallback. */
+        readonly micTooltipTouch: string;
         readonly viewPlan: string;
         readonly hidePlan: string;
     };

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

@@ -5,6 +5,21 @@
  * uses the same resolver so the dock never overlaps host content.
  */
 export type DockResizeState = "collapsed" | "expanded" | "modal";
+/**
+ * Desktop = side-docked panel + rail with a host-body reserve. Mobile = the
+ * dock takes the whole viewport as an overlay sheet (a side dock plus reserve
+ * would squeeze the host to zero width on a phone).
+ */
+export type DockLayoutMode = "desktop" | "mobile";
+/** Viewports at or below this width get the mobile fullscreen-sheet layout. */
+export declare const MOBILE_LAYOUT_MAX_WIDTH_PX = 640;
+/** Short viewports get the mobile layout too: a rotated phone (e.g. 844×390)
+ *  is wider than the width breakpoint, but a 52px rail + side panel is
+ *  unusable at that height. */
+export declare const MOBILE_LAYOUT_MAX_HEIGHT_PX = 480;
+/** The single matchMedia source for the mode — both clauses, OR'd. */
+export declare const MOBILE_LAYOUT_MEDIA_QUERY: string;
+export declare const resolveLayoutMode: (viewportWidthPx: number, viewportHeightPx?: number) => DockLayoutMode;
 /** The always-visible rail strip. Reference spec: 52px. */
 export declare const RAIL_WIDTH_PX = 52;
 /** Fixed panel width in modal state. Reference spec: 760px panel. */
@@ -17,6 +32,14 @@ export declare const MAX_PANEL_WIDTH_PX = 720;
 export declare const clampPanelWidth: (px: number, viewportPx: number) => number;
 /** Total dock width (panel + rail) for a state, given the expanded panel width. */
 export declare const resolveDockWidthPx: (state: DockResizeState, panelWidth: number) => number;
+/**
+ * Desktop dock width clamped to the live viewport — mid-size screens (small
+ * tablets, half-snapped windows just above the mobile breakpoint) must never
+ * get a dock wider than the screen: the 760px modal alone overflows a 768px
+ * tablet, and a persisted wide panel can overflow a re-narrowed window.
+ * Cap: 90% of the viewport (same budget clampPanelWidth uses for drags).
+ */
+export declare const resolveClampedDockWidthPx: (state: DockResizeState, panelWidth: number, viewportWidthPx: number) => number;
 /**
  * The panel's OWN width for a state. While collapsed this is the width the
  * panel would reveal to (the dock container clips it), so the panel keeps a

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

@@ -0,0 +1,6 @@
+import { DockLayoutMode } from './dock-layout.ts';
+export declare const peekLayoutMode: () => DockLayoutMode;
+export declare const subscribeLayoutMode: (listener: () => void) => (() => void);
+export declare const useLayoutMode: () => DockLayoutMode;
+/** Test-only: drop the cached media query so a new stub takes effect. */
+export declare const __resetLayoutModeForTest: () => void;

package/dist/embed/voice/realtime-call.d.ts

@@ -1,9 +1,14 @@
 /**
  * WebRTC transport for live call mode (OpenAI Realtime, speech-to-speech).
  *
- * Mirrors the Deepgram pattern one file over: the browser talks to the
- * provider DIRECTLY with a short-lived secret minted by belong-cloud
- * (`POST /v1/voice/call-token`) — call audio never relays through the backend.
+ * Mirrors the Deepgram pattern one file over: the browser holds a short-lived
+ * secret minted by belong-cloud (`POST /v1/voice/call-token`) and negotiates a
+ * DIRECT WebRTC media session with the provider — call audio never relays
+ * through the backend. The one plain `fetch` in the handshake (the SDP
+ * offer/answer exchange) goes through belong-cloud (`POST /v1/voice/call-sdp`)
+ * because embedding hosts' CSP `connect-src` allowlists rarely include
+ * api.openai.com (Simetrik's doesn't) — the negotiated ICE/DTLS media leg is
+ * not governed by `connect-src`, so only the signaling needs the relay.
  *
  *   getUserMedia (mic track) ──▶ RTCPeerConnection ──▶ remote audio track
  *                                     │                    (autoplay <audio>)

package/dist/i18n/messages/en.d.ts

@@ -308,6 +308,9 @@ export declare const en: {
         readonly supportsFormats: "Supports PDF, DOC, MD, TXT, XLSX";
         readonly viewTitleFiles: "Files";
         readonly resizeChat: "Resize chat";
+        readonly openAssistant: "Open {{name}}";
+        readonly closeAssistant: "Close";
+        readonly navCall: "Call";
     };
     readonly aiElements: {
         readonly statusAwaitingApproval: "Awaiting Approval";

package/dist/i18n/messages/surfaces/app.d.ts

@@ -12,6 +12,9 @@ export declare const appEn: {
         readonly supportsFormats: "Supports PDF, DOC, MD, TXT, XLSX";
         readonly viewTitleFiles: "Files";
         readonly resizeChat: "Resize chat";
+        readonly openAssistant: "Open {{name}}";
+        readonly closeAssistant: "Close";
+        readonly navCall: "Call";
     };
 };
 export declare const appEs: {
@@ -27,6 +30,9 @@ export declare const appEs: {
         supportsFormats: string;
         viewTitleFiles: string;
         resizeChat: string;
+        openAssistant: string;
+        closeAssistant: string;
+        navCall: string;
     };
 };
 export declare const appPt: {
@@ -42,5 +48,8 @@ export declare const appPt: {
         supportsFormats: string;
         viewTitleFiles: string;
         resizeChat: string;
+        openAssistant: string;
+        closeAssistant: string;
+        navCall: string;
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@belonguniverseai/react-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Belong — embeddable React AI assistant dock. Mount <BelongWidget> in your app tree with getToken dependency-injection auth.",
   "license": "UNLICENSED",
   "type": "module",