@burdenoff/fe-libs 2026.912.6 → 2026.913.2

package/dist/shared/assistant/ui/voice/VoiceStage.js

@@ -1,59 +1,60 @@
 import { showsAssistantCaption as e, showsUserCaption as t, waveformIsActive as n, waveformIsSettled as r } from "../../voice/voiceStageState.js";
 import { VoiceCaption as i } from "./VoiceCaption.js";
 import { VoiceWaveform as a } from "./VoiceWaveform.js";
-import { Fragment as o, jsx as s, jsxs as c } from "react/jsx-runtime";
+import { VoiceStatusText as o } from "./VoiceStatusText.js";
+import { Fragment as s, jsx as c, jsxs as l } from "react/jsx-runtime";
 //#region src/shared/assistant/ui/voice/VoiceStage.tsx
-var l = ({ state: l, userCaption: u, assistantCaption: d, expanded: f, statusText: p, control: m, errorText: h = null, spokenChunks: g = null }) => {
-	let _ = e(l) ? d : t(l) ? u : null;
-	return /* @__PURE__ */ c("div", {
+var u = ({ state: u, userCaption: d, assistantCaption: f, expanded: p, statusText: m, statusSuffix: h, rotateStatus: g, control: _, errorText: v = null, spokenChunks: y = null }) => {
+	let b = e(u) ? f : t(u) ? d : null;
+	return /* @__PURE__ */ l("div", {
 		className: [
 			"flex min-h-0 w-full flex-1 flex-col items-center",
-			f ? "px-8" : "px-14",
-			f ? "justify-start pt-[16vh]" : "justify-center"
+			p ? "px-8" : "px-14",
+			p ? "justify-start pt-[16vh]" : "justify-center"
 		].join(" "),
 		"data-testid": "assistant-voice-stage",
-		"data-state": l,
+		"data-state": u,
 		children: [
-			/* @__PURE__ */ s("p", {
+			/* @__PURE__ */ c(o, {
 				className: [
 					"text-center text-text-muted",
-					f ? "text-base" : "text-sm",
-					f ? "mb-3" : "mb-2"
+					p ? "text-base" : "text-sm",
+					p ? "mb-3" : "mb-2"
 				].join(" "),
-				"aria-live": "polite",
-				"data-testid": "assistant-voice-status",
-				children: p
+				status: m,
+				suffix: h,
+				rotating: g
 			}),
-			l === "mic-error" ? /* @__PURE__ */ s("p", {
-				className: `max-w-md text-center text-status-warning ${f ? "text-lg" : "text-sm"}`,
+			u === "mic-error" ? /* @__PURE__ */ c("p", {
+				className: `max-w-md text-center text-status-warning ${p ? "text-lg" : "text-sm"}`,
 				role: "alert",
 				"data-testid": "assistant-voice-stage-error",
-				children: h
-			}) : /* @__PURE__ */ c(o, { children: [/* @__PURE__ */ s("div", {
-				className: f ? "mb-10" : "mb-5",
-				children: /* @__PURE__ */ s(a, {
-					active: n(l),
-					settled: r(l),
-					tone: l === "speaking" ? "speaking" : "listening",
-					expanded: f
+				children: v
+			}) : /* @__PURE__ */ l(s, { children: [/* @__PURE__ */ c("div", {
+				className: p ? "mb-10" : "mb-5",
+				children: /* @__PURE__ */ c(a, {
+					active: n(u),
+					settled: r(u),
+					tone: u === "speaking" ? "speaking" : "listening",
+					expanded: p
 				})
-			}), _ ? /* @__PURE__ */ s("div", {
-				className: f ? "mb-12 max-h-[46vh] w-full overflow-y-auto" : "mb-6 max-h-[38vh] w-full overflow-y-auto",
+			}), b ? /* @__PURE__ */ c("div", {
+				className: p ? "mb-12 max-h-[46vh] w-full overflow-y-auto" : "mb-6 max-h-[38vh] w-full overflow-y-auto",
 				"data-caption-scroll": "",
-				children: /* @__PURE__ */ s(i, {
-					text: _,
-					role: e(l) ? "assistant" : "user",
-					spokenChunks: g,
-					expanded: f,
+				children: /* @__PURE__ */ c(i, {
+					text: b,
+					role: e(u) ? "assistant" : "user",
+					spokenChunks: y,
+					expanded: p,
 					testId: "assistant-voice-caption"
 				})
-			}) : /* @__PURE__ */ s("div", {
-				className: f ? "mb-12 h-[4.875rem]" : "mb-6 h-12",
+			}) : /* @__PURE__ */ c("div", {
+				className: p ? "mb-12 h-[4.875rem]" : "mb-6 h-12",
 				"aria-hidden": "true"
 			})] }),
-			m
+			_
 		]
 	});
 };
 //#endregion
-export { l as VoiceStage };
+export { u as VoiceStage };

package/dist/shared/assistant/ui/voice/VoiceStatusText.d.ts

@@ -0,0 +1,51 @@
+import { FC } from 'react';
+/**
+ * The voice status line's markup: one live region that announces the STATUS,
+ * beside visual copy that may differ from it.
+ *
+ * ★★ Both spans are mounted in EVERY state, and nothing here is keyed. Many
+ * screen readers ignore a live region that is inserted at the moment its
+ * content changes, so remounting the region — a structure that only split
+ * while thinking, or a `key` that changes with the text — would silence the
+ * very announcements it exists for. The region stays put; only its text
+ * changes, and only when the status does.
+ *
+ * ★ The shown copy is `aria-hidden`, so a rotation is never read aloud —
+ * neither through the live region nor when the line is read with a virtual
+ * cursor, where the announced span supplies the text exactly once.
+ *
+ * ★★ `relative` + `left-0 top-0` CONTAIN the announced span. `sr-only` is
+ * `position: absolute`; without a positioned line its containing block is the
+ * voice dialog, so it sat after the full untruncated text and pushed scrollable
+ * overflow into the chat area. A screen reader scrolling the status into view
+ * then shifted the whole docked strip sideways (measured: 34px at 320px wide
+ * for a long Spanish status with the microphone off). `left-0`, not the
+ * logical `start-0`: the latter is absent from at least one consumer's
+ * generated stylesheet, and for a 1px clipped box the side does not matter.
+ *
+ * ★ `data-testid="assistant-voice-status"` is on the ANNOUNCED span, so reading
+ * that id still yields exactly the status, as it always has. The visible copy is
+ * `assistant-voice-status-shown`; the line itself is `assistant-voice-status-line`.
+ */
+export declare const VoiceStatusLine: FC<{
+    announced: string;
+    shown: string;
+    className: string;
+}>;
+/**
+ * The voice session's status line, rotating the SHOWN text while the assistant
+ * thinks. What is announced is always `status` — see `voiceStatusParts`.
+ *
+ * ★ The clock lives HERE, not in `AssistantVoiceSession`: a tick re-renders only
+ * this line, and the orchestrators stay free of timers.
+ */
+export declare const VoiceStatusText: FC<{
+    /** The meaningful status. This is what is announced. */
+    status: string;
+    /** Kept visible while the shown phrase rotates, e.g. "Microphone off". */
+    suffix?: string | null;
+    /** Rotate the SHOWN text through the thinking phrases. */
+    rotating?: boolean;
+    className: string;
+}>;
+//# sourceMappingURL=VoiceStatusText.d.ts.map

package/dist/shared/assistant/ui/voice/VoiceStatusText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VoiceStatusText.d.ts","sourceRoot":"","sources":["../../../../../src/shared/assistant/ui/voice/VoiceStatusText.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,EAAE,EAAE,MAAM,OAAO,CAAC;AAYrD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAiBA,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,EAAE,EAAE,CAAC;IAC/B,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAiBA,CAAC"}

package/dist/shared/assistant/ui/voice/VoiceStatusText.js

@@ -0,0 +1,42 @@
+import { useAssistantTr as e } from "../../i18n.js";
+import { voiceStatusParts as t } from "../../voice/voiceStatus.js";
+import { IDLE_ROTATION_CLOCK as n, advanceRotationClock as r, rotationElapsedMs as i, startRotationTicker as a, syncRotationClock as o } from "../../voice/rotationClock.js";
+import { useEffect as s, useState as c } from "react";
+import { jsx as l, jsxs as u } from "react/jsx-runtime";
+//#region src/shared/assistant/ui/voice/VoiceStatusText.tsx
+var d = ({ announced: e, shown: t, className: n }) => /* @__PURE__ */ u("p", {
+	className: `relative ${n}`,
+	"data-testid": "assistant-voice-status-line",
+	children: [/* @__PURE__ */ l("span", {
+		"aria-hidden": "true",
+		"data-testid": "assistant-voice-status-shown",
+		children: t
+	}), /* @__PURE__ */ l("span", {
+		className: "sr-only left-0 top-0",
+		"aria-live": "polite",
+		"aria-atomic": "true",
+		"data-testid": "assistant-voice-status",
+		children: e
+	})]
+}), f = ({ status: n, suffix: r = null, rotating: i = !1, className: a }) => {
+	let { announced: o, shown: s } = t({
+		tr: e(),
+		status: n,
+		suffix: r,
+		rotating: i,
+		elapsedMs: p(i)
+	});
+	return /* @__PURE__ */ l(d, {
+		className: a,
+		announced: o,
+		shown: s
+	});
+};
+function p(e) {
+	let [t, l] = c(() => o(n, e)), u = o(t, e);
+	return u !== t && l(u), s(() => {
+		if (e) return a(() => l((e) => r(e)));
+	}, [e]), i(u);
+}
+//#endregion
+export { d as VoiceStatusLine, f as VoiceStatusText };

package/dist/shared/assistant/ui/voice/VoiceWaveform.js

@@ -17,7 +17,7 @@ var t = [
 			"inline-block rounded-full transition-[height,opacity] duration-300",
 			a ? "w-1.5" : "w-1",
 			r === "speaking" ? "bg-brand-primary" : "bg-text-muted",
-			n ? i ? "animate-pulse [animation-duration:2.4s] opacity-70" : "animate-pulse" : "opacity-40"
+			n ? i ? "motion-safe:animate-pulse [animation-duration:2.4s] opacity-70" : "motion-safe:animate-pulse" : "opacity-40"
 		].join(" "),
 		style: {
 			height: n ? `${(i ? [

package/dist/shared/assistant/voice/rotationClock.d.ts

@@ -0,0 +1,31 @@
+/**
+ * The clock behind the voice status line's rotating phrase, as plain functions.
+ *
+ * ★★ Why this is not simply a hook. fe-libs tests run with no DOM and no React
+ * renderer, and static rendering runs no effects. A clock written inline in a
+ * component is exercised by nothing, so every way of breaking it — never
+ * starting, never resetting, never clearing — passes the whole suite (measured:
+ * seven such mutations survived before this split). Here the state rules are
+ * pure and the ticker runs under fake timers; the hook that joins them is a few
+ * lines, pinned by `voiceStatusWiring.test.ts`.
+ */
+export interface RotationClock {
+    /** Whole rotation steps since the clock last became active. */
+    readonly steps: number;
+    readonly active: boolean;
+}
+export declare const IDLE_ROTATION_CLOCK: RotationClock;
+/**
+ * Follow `active`, restarting from step 0 whenever it changes.
+ *
+ * ★ Returns the SAME object when nothing changed. The hook adjusts state during
+ * render only on a change of identity, so a fresh object here every call would
+ * be an infinite render loop.
+ */
+export declare function syncRotationClock(clock: RotationClock, active: boolean): RotationClock;
+/** One tick. A tick that lands after the clock went inactive is ignored. */
+export declare function advanceRotationClock(clock: RotationClock): RotationClock;
+export declare function rotationElapsedMs(clock: RotationClock): number;
+/** Call `onTick` every `intervalMs` until the returned stop function runs. */
+export declare function startRotationTicker(onTick: () => void, intervalMs?: number): () => void;
+//# sourceMappingURL=rotationClock.d.ts.map

package/dist/shared/assistant/voice/rotationClock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rotationClock.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/rotationClock.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,mBAAmB,EAAE,aAA2C,CAAC;AAE9E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,OAAO,GACd,aAAa,CAEf;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,aAAa,GAAG,aAAa,CAExE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAE9D;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,IAAI,EAClB,UAAU,GAAE,MAAyB,GACpC,MAAM,IAAI,CAGZ"}

package/dist/shared/assistant/voice/rotationClock.js

@@ -0,0 +1,27 @@
+import { PHRASE_ROTATE_MS as e } from "../stageCopy.js";
+//#region src/shared/assistant/voice/rotationClock.ts
+var t = {
+	steps: 0,
+	active: !1
+};
+function n(e, t) {
+	return e.active === t ? e : {
+		steps: 0,
+		active: t
+	};
+}
+function r(e) {
+	return e.active ? {
+		steps: e.steps + 1,
+		active: !0
+	} : e;
+}
+function i(t) {
+	return t.active ? t.steps * e : 0;
+}
+function a(t, n = e) {
+	let r = setInterval(t, n);
+	return () => clearInterval(r);
+}
+//#endregion
+export { t as IDLE_ROTATION_CLOCK, r as advanceRotationClock, i as rotationElapsedMs, a as startRotationTicker, n as syncRotationClock };

package/dist/shared/assistant/voice/voiceStatus.d.ts

@@ -0,0 +1,81 @@
+import { AssistantTr } from '../i18n';
+import { StageCopyEntry } from '../stageCopy';
+import { VoiceStageState } from './voiceStageState';
+/** The voice session's own label for `thinking` — one definition for the session and the status line. */
+export declare const VOICE_THINKING_LABEL: StageCopyEntry;
+/** Reported alongside a stage while the microphone is off. */
+export declare const VOICE_MUTED_LABEL: StageCopyEntry;
+/**
+ * The muted suffix for the status line, or null.
+ *
+ * Muted is reported ALONGSIDE the stage, not instead of it: the assistant may
+ * still be speaking with the microphone off, and saying only "Microphone off"
+ * would misreport that.
+ *
+ * ★ Gated on the STAGE, not the phase. `connecting`, `endpoint-grace` and
+ * `interrupting` are all `phase === 'listening'` underneath, so a phase test
+ * dropped the suffix on exactly those three stages — leaving "Stopped — go
+ * ahead" inviting someone to speak into a muted microphone.
+ *
+ * ★ Not while `listening`: that stage's own label already IS "Microphone off"
+ * when muted, and a suffix would read "Microphone off · Microphone off".
+ *
+ * ★ Not for an empty label (ended, mic-error), which would otherwise render a
+ * bare " · Microphone off". And no `error !== null` arm: the error belongs to
+ * the stage's alert element, and testing it here once printed the whole
+ * sentence TWICE — truncated in the status line, repeated below it, and
+ * announced twice by a screen reader.
+ */
+export declare function voiceStatusSuffix(args: {
+    tr: AssistantTr;
+    stage: VoiceStageState;
+    muted: boolean;
+    /** The stage's label, already localised. */
+    label: string;
+}): string | null;
+/** The full status: the stage label, then the suffix when there is one. */
+export declare function composeVoiceStatus(label: string, suffix: string | null): string;
+/**
+ * The status line, split into what is SHOWN and what is ANNOUNCED.
+ *
+ * ★★ Why two strings. The status line is a live region: a screen reader reads
+ * it aloud whenever its text changes. While the model is thinking, a sighted
+ * user is better served by a phrase that moves — a single frozen "Thinking…"
+ * for the length of a turn reads as a hang (see `THINKING_PHRASES`). Putting
+ * that rotation into the live region would announce a new filler word every
+ * `PHRASE_ROTATE_MS`. So the rotation is visual only, and the announced text
+ * changes only when the status genuinely does.
+ *
+ * ★ The first shown phrase is the voice session's OWN label, not the pool's
+ * opening entry: on entering `thinking`, sighted and screen-reader users get
+ * the same words.
+ *
+ * ★★ A pool phrase is shown only when it is in the SAME translation state as
+ * the voice label. The label (`voiceSession.*`) and the pool (`stage.*`) are
+ * separately seeded key families. With the label translated and the pool not,
+ * rotating would alternate the user's language with English — so the line holds
+ * on the translated label instead. When neither is translated, it rotates in
+ * English, like the rest of the untranslated interface.
+ *
+ * ★ A muted microphone stays on screen through the rotation.
+ *
+ * Pure in `elapsedMs` — the caller owns the clock — like `thinkingPhrase`.
+ */
+export interface VoiceStatusParts {
+    /** For the live region. Changes only when the status does. */
+    readonly announced: string;
+    /** For the eye. Rotates while thinking; otherwise identical to `announced`. */
+    readonly shown: string;
+}
+export declare function voiceStatusParts(args: {
+    tr: AssistantTr;
+    /** The meaningful status, exactly as it should be announced. */
+    status: string;
+    /** Kept on the shown text while it rotates, e.g. "Microphone off". */
+    suffix: string | null;
+    /** True only while the assistant is thinking. */
+    rotating: boolean;
+    /** Time since rotation began. */
+    elapsedMs: number;
+}): VoiceStatusParts;
+//# sourceMappingURL=voiceStatus.d.ts.map

package/dist/shared/assistant/voice/voiceStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voiceStatus.d.ts","sourceRoot":"","sources":["../../../../src/shared/assistant/voice/voiceStatus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,EAAE,cAGlC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,iBAAiB,EAAE,cAG/B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,EAAE,EAAE,WAAW,CAAC;IAChB,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,MAAM,GAAG,IAAI,CAKhB;AAED,2EAA2E;AAC3E,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,GACpB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAKD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,EAAE,EAAE,WAAW,CAAC;IAChB,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;IAClB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,gBAAgB,CAmBnB"}

package/dist/shared/assistant/voice/voiceStatus.js

@@ -0,0 +1,33 @@
+import { THINKING_PHRASES as e, stageText as t, thinkingPhrase as n } from "../stageCopy.js";
+//#region src/shared/assistant/voice/voiceStatus.ts
+var r = {
+	key: "voiceSession.thinking",
+	fallback: "Thinking…"
+}, i = {
+	key: "voiceSession.muted",
+	fallback: "Microphone off"
+};
+function a(e) {
+	let { tr: n, stage: r, muted: a, label: o } = e;
+	return a && r !== "listening" && o !== "" ? t(n, i) : null;
+}
+function o(e, t) {
+	return t ? `${e} · ${t}` : e;
+}
+var s = (e, t) => e(t.key, t.fallback) !== t.fallback;
+function c(i) {
+	let { tr: a, status: c, suffix: l, rotating: u, elapsedMs: d } = i, f = {
+		announced: c,
+		shown: c
+	};
+	if (!u || c === "") return f;
+	let p = n(a, d);
+	if (p === n(a, 0)) return f;
+	let m = e.find((e) => t(a, e) === p);
+	return !m || s(a, m) !== s(a, r) ? f : {
+		announced: c,
+		shown: o(p, l)
+	};
+}
+//#endregion
+export { i as VOICE_MUTED_LABEL, r as VOICE_THINKING_LABEL, o as composeVoiceStatus, c as voiceStatusParts, a as voiceStatusSuffix };