@burdenoff/fe-libs 2026.1016.3 → 2026.1017.2

package/README.md

@@ -21,7 +21,7 @@ This is a **Layer 1 package** - a monolithic package with subpath exports for al
 
 ```typescript
 import { Button } from '@burdenoff/fe-libs/button';
-import { WorkflowNode, WorkflowCanvas } from '@burdenoff/fe-libs/workflow';
+import { mockProducts } from '@burdenoff/fe-libs/shared/utils/mockData';
 import { cn } from '@burdenoff/fe-libs/shared';
 ```
 
@@ -129,3 +129,27 @@ plain browser (persisted in `sessionStorage`, cleared with `off`). It is
 - TailwindCSS v4
 - Radix UI (for accessible primitives)
 - Vite 7 (for building)
+
+## Export migration (BOFF-9417)
+
+Beginning with the first CalVer release containing BOFF-9417, the already
+nonfunctional `@burdenoff/fe-libs/workflow` export metadata is explicitly retired. Both advertised
+targets (`dist/workflow.js` and `dist/workflow.d.ts`) are absent from the verified
+published 2026.1016.3 package. The former WorkflowCanvas/WorkflowNode implementation
+was deliberately removed in source commit `f0920f9a` on 2026-01-15; this change does
+not remove a working runtime implementation or restore that obsolete UI. Existing
+published releases are unchanged. Usage outside the bounded local repository
+inventory is unknown; this is not a claim that external consumers do not exist.
+
+Current workflow-builder functionality belongs to `@burdenoff/fluidgrids-fe-sdk`
+(WorkflowBuilder and WorkflowBuilderCore), not another microfrontend import. Those
+APIs differ from the deleted generic canvas/node props and require an explicit
+consumer migration; they are not a drop-in compatibility adapter. Consumers should
+review their intended workflow behavior before choosing that API.
+
+The existing `@burdenoff/fe-libs/shared/utils/mockData` subpath is retained. Its five
+fixture arrays now have an explicit runtime build entry alongside their declarations.
+The archive verifier checks literal export/bin targets in the actual npm tar before
+publication; wildcard export patterns and universal consumer compatibility are not
+certified by that existence check. Normal release automation assigns the concrete
+CalVer version; this source note does not claim publication or host adoption.

package/dist/shared/assistant/i18nManifest.d.ts

@@ -499,6 +499,7 @@ export declare const ASSISTANT_I18N_LITERAL_COPY: {
     readonly "sheet.collapse": "Shrink the assistant";
     readonly "sheet.expand": "Expand the assistant";
     readonly "speech.codeBlock": "Code block";
+    readonly "speech.deviceFallback": "Device voice used: the selected voice was unavailable.";
     readonly "speech.emailAt": "at";
     readonly "speech.emailDot": "dot";
     readonly "speech.image": "image";

package/dist/shared/assistant/i18nManifest.js

@@ -393,6 +393,7 @@ var m = {
 	"sheet.collapse": "Shrink the assistant",
 	"sheet.expand": "Expand the assistant",
 	"speech.codeBlock": "Code block",
+	"speech.deviceFallback": "Device voice used: the selected voice was unavailable.",
 	"speech.emailAt": "at",
 	"speech.emailDot": "dot",
 	"speech.image": "image",

package/dist/shared/assistant/speech/hostedTtsSpeechEngine.d.ts

@@ -60,4 +60,10 @@ export declare const HOSTED_OUTPUT_STALL_AUDIO_RATIO = 2;
 export declare const HOSTED_OUTPUT_MIN_AUDIO_BYTES_PER_SECOND = 1000;
 /** The watchdog's window once `bytesHanded` bytes of audio went to the output. */
 export declare function hostedOutputStallMs(bytesHanded: number): number;
+/** 44 bytes of silence: what a tap plays to unlock an engine's element. */
+export declare const SILENT_WAV_DATA_URI = "data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQAAAAA=";
+/** Unlock every hosted engine's playback element. Call inside a user gesture. */
+export declare function primeHostedPlayback(): void;
+/** Test seam: forget every engine registered so far. */
+export declare function resetHostedPlaybackForTest(): void;
 export declare function createHostedTtsEngine(options: HostedTtsOptions): HostedSpeechEngine;

package/dist/shared/assistant/speech/hostedTtsSpeechEngine.js

@@ -1,39 +1,39 @@
-import { tapPlaybackElement as e } from "../voice/handsfree/playbackReference.js";
-import { HOSTED_TTS_TIER as t, HOSTED_VOICES as n, hostedLocaleFor as r } from "./hostedVoiceCatalogue.js";
-import { buildRequest as i, classifyHttpFailure as a, decodeAudioResponse as o, disableDurationMs as s, shouldDisableEngine as c, speakableChunks as l } from "./hostedTtsProtocol.js";
-import { createPieceSink as u, isOutputRefusal as d } from "./pieceSink.js";
+import { isPlaybackReferenceAttached as e, tapPlaybackElement as t } from "../voice/handsfree/playbackReference.js";
+import { HOSTED_TTS_TIER as n, HOSTED_VOICES as r, hostedLocaleFor as i } from "./hostedVoiceCatalogue.js";
+import { buildRequest as a, classifyHttpFailure as o, decodeAudioResponse as s, disableDurationMs as c, shouldDisableEngine as l, speakableChunks as u } from "./hostedTtsProtocol.js";
+import { createPieceSink as d, isOutputRefusal as f } from "./pieceSink.js";
 //#region src/shared/assistant/speech/hostedTtsSpeechEngine.ts
-function f(e) {
+function p(e) {
 	let t = Object.entries(e).map(([e, t]) => `${e.toLowerCase()}:${t}`).sort().join("\n"), n = 5381;
 	for (let e = 0; e < t.length; e += 1) n = (n << 5) + n + t.charCodeAt(e) | 0;
 	return `${t.length}:${n >>> 0}`;
 }
-var p = new Set([
+var m = new Set([
 	429,
 	502,
 	503,
 	504
-]), m = 3, h = 400, g = 2e3;
-function _(e, t) {
+]), h = 3, g = 400, _ = 2e3;
+function v(e, t) {
 	let n = e === null ? NaN : Number(e);
-	return Math.min(Number.isFinite(n) && n >= 0 ? n * 1e3 : h * 2 ** (t - 1), g);
+	return Math.min(Number.isFinite(n) && n >= 0 ? n * 1e3 : g * 2 ** (t - 1), _);
 }
-var v = 6e4, y = 2, b = 1e3;
-function x(e) {
-	return v + e / b * 2 * 1e3;
+var y = 6e4, b = 2, x = 1e3;
+function S(e) {
+	return y + e / x * 2 * 1e3;
 }
-var S = class extends Error {
+var C = class extends Error {
 	reason = "unknown";
 	constructor() {
 		super("audio output made no progress"), this.name = "OutputStalledError";
 	}
 };
-function C(e) {
+function w(e) {
 	let t = 0, n = !1, r = null, i = () => {
 		let n = r;
 		n !== null && (n.cancel(), n.cancel = e(() => {
-			r === n && (r = null, n.fail(new S()));
-		}, x(t)));
+			r === n && (r = null, n.fail(new C()));
+		}, S(t)));
 	};
 	return {
 		handed(e) {
@@ -64,7 +64,14 @@ function C(e) {
 		}
 	};
 }
-function w(e, t) {
+var T = "data:audio/wav;base64,UklGRiQAAABXQVZFZm10IBAAAAABAAEARKwAAIhYAQACABAAZGF0YQAAAAA=", E = [], D = 4;
+function O() {
+	for (let e of [...E]) e();
+}
+function k() {
+	E.length = 0;
+}
+function A(e, t) {
 	return new Promise((n) => {
 		if (t.aborted) {
 			n();
@@ -79,183 +86,193 @@ function w(e, t) {
 		t.addEventListener("abort", i, { once: !0 });
 	});
 }
-function T(h) {
-	let g = h.fetchImpl ?? ((...e) => fetch(...e)), v = h.now ?? (() => Date.now()), y = h.setTimer ?? ((e, t) => {
+function j(g) {
+	let _ = g.fetchImpl ?? ((...e) => fetch(...e)), y = g.now ?? (() => Date.now()), b = g.setTimer ?? ((e, t) => {
 		let n = setTimeout(e, t);
 		return () => clearTimeout(n);
-	}), b = null, x = null, T = 0, E = null, D = null, O = null, k = 0, A = null, j = null, M = () => {
+	}), x = null, S = null, O = null, k = !1, j = () => {
+		if (!(k || typeof Audio != "function")) try {
+			let e = O ?? new Audio();
+			if (O = e, x === e) return;
+			e.muted = !0, e.src = T, Promise.resolve(e.play()).then(() => {
+				O === e && x !== e && e.pause();
+			}, () => {});
+		} catch {}
+	};
+	E.push(j), E.length > D && E.shift();
+	let M = 0, N = null, P = null, F = null, I = 0, L = null, R = null, z = () => {
 		try {
-			return h.getHeaders?.() ?? {};
+			return g.getHeaders?.() ?? {};
 		} catch {
 			return {};
 		}
-	}, N = () => v() >= k ? !1 : j === null ? !0 : f(M()) === j, P = /* @__PURE__ */ new Set(), F = () => {
-		for (let e of [...P]) e();
-	}, I = () => {
-		A !== null && clearTimeout(A), A = null;
-	}, L = (e) => {
-		I(), A = setTimeout(() => {
-			A = null;
-			let e = k - v();
+	}, B = () => y() >= I ? !1 : R === null ? !0 : p(z()) === R, V = /* @__PURE__ */ new Set(), H = () => {
+		for (let e of [...V]) e();
+	}, U = () => {
+		L !== null && clearTimeout(L), L = null;
+	}, W = (e) => {
+		U(), L = setTimeout(() => {
+			L = null;
+			let e = I - y();
 			if (e > 0) {
-				L(e);
+				W(e);
 				return;
 			}
-			F();
+			H();
 		}, e);
-	}, R = (e, t) => {
-		k = v() + e, j = t, L(e), F();
-	}, z = () => {
-		x &&= (URL.revokeObjectURL(x), null);
-	}, B = () => {
-		if (b) {
-			b.onended = null, b.onerror = null;
+	}, G = (e, t) => {
+		I = y() + e, R = t, W(e), H();
+	}, K = () => {
+		S &&= (URL.revokeObjectURL(S), null);
+	}, q = () => {
+		if (x) {
+			x.onended = null, x.onerror = null;
 			try {
-				b.pause();
+				x.pause();
 			} catch {}
-			b = null;
+			x = null;
 		}
-		z();
+		K();
 	};
-	async function V(e, n, s) {
-		let c = i(e, r(n.lang) ?? n.lang, t, n.voice?.name ?? null, n.rate), l = h.getHeaders?.() ?? {}, u;
-		for (let e = 1; u = await g(h.endpoint, {
+	async function J(e, t, r) {
+		let c = a(e, i(t.lang) ?? t.lang, n, t.voice?.name ?? null, t.rate), l = g.getHeaders?.() ?? {}, u;
+		for (let e = 1; u = await _(g.endpoint, {
 			method: "POST",
-			signal: s,
+			signal: r,
 			headers: {
 				"content-type": "application/json",
 				...l
 			},
 			body: JSON.stringify(c)
 		}), !u.ok; e += 1) {
-			if (!(p.has(u.status) && e < m && !s.aborted)) {
+			if (!(m.has(u.status) && e < h && !r.aborted)) {
 				let e = /* @__PURE__ */ Error(`hosted tts ${u.status}`);
-				throw e.reason = a(u.status), e.headers = f(l), e;
+				throw e.reason = o(u.status), e.headers = p(l), e;
 			}
-			await w(_(u.headers.get("retry-after"), e), s);
+			await A(v(u.headers.get("retry-after"), e), r);
 		}
-		let d = u.headers.get("content-type"), v = o(d, d?.includes("json") ? await u.json() : await u.arrayBuffer());
-		if (!v) {
+		let d = u.headers.get("content-type"), f = s(d, d?.includes("json") ? await u.json() : await u.arrayBuffer());
+		if (!f) {
 			let e = /* @__PURE__ */ Error("hosted tts returned no audio");
 			throw e.reason = "unknown", e;
 		}
-		return v;
+		return f;
 	}
-	function H(t, n, r) {
-		return new Promise((i, a) => {
-			if (n !== T) {
-				i();
+	function Y(n, r, i) {
+		return new Promise((a, o) => {
+			if (r !== M) {
+				a();
 				return;
 			}
-			let o = new Blob([t.slice().buffer], { type: "audio/mpeg" });
-			z(), x = URL.createObjectURL(o);
-			let s = new Audio(x);
-			e(s), b = s, s.onended = () => {
-				n === T && i();
-			}, s.onerror = () => {
-				if (n !== T) {
-					i();
+			let s = new Blob([n.slice().buffer], { type: "audio/mpeg" });
+			K(), S = URL.createObjectURL(s);
+			let c;
+			e() ? (c = new Audio(S), t(c)) : (c = O ?? new Audio(), O = c, c.muted = !1, c.src = S), x = c, c.onended = () => {
+				r === M && a();
+			}, c.onerror = () => {
+				if (r !== M) {
+					a();
 					return;
 				}
 				let e = /* @__PURE__ */ Error("audio playback failed");
-				e.reason = "unknown", a(e);
-			}, s.play().then(() => {
-				n === T && r?.();
+				e.reason = "unknown", o(e);
+			}, c.play().then(() => {
+				c === O && !c.muted && (k = !0), r === M && i?.();
 			}, (e) => {
-				if (n !== T) {
-					i();
+				if (r !== M) {
+					a();
 					return;
 				}
-				let t = /* @__PURE__ */ Error("audio play rejected"), r = e?.name === "NotAllowedError";
-				t.reason = r ? "not-allowed" : "unknown", t.transient = r, a(t);
+				let t = /* @__PURE__ */ Error("audio play rejected"), n = e?.name === "NotAllowedError";
+				t.reason = n ? "not-allowed" : "unknown", t.transient = n, o(t);
 			});
 		});
 	}
 	return {
 		id: "hosted-tts",
 		isSupported() {
-			return N() ? !1 : typeof window < "u" && typeof window.Audio == "function" && typeof fetch == "function";
+			return B() ? !1 : typeof window < "u" && typeof window.Audio == "function" && typeof fetch == "function";
 		},
 		listVoices() {
-			return N() ? [] : [...n];
+			return B() ? [] : [...r];
 		},
 		subscribeVoices(e) {
-			return P.add(e), () => {
-				P.delete(e);
+			return V.add(e), () => {
+				V.delete(e);
 			};
 		},
 		speak(e, t, n = {}) {
-			let r = l(e);
+			let r = u(e);
 			if (r.length === 0) {
 				n.onEnd?.();
 				return;
 			}
-			T += 1;
-			let i = T;
-			B(), D?.cancel(), O?.stop();
+			M += 1;
+			let i = M;
+			q(), P?.cancel(), F?.stop(), j();
 			let a = new AbortController();
-			E = a;
-			let o = !1, f = () => {
+			N = a;
+			let o = !1, s = () => {
 				o || (o = !0, n.onStart?.());
 			}, p = (e) => {
-				let n = V(e, t, a.signal);
+				let n = J(e, t, a.signal);
 				return n.catch(() => {}), n;
-			}, m = t.audioOutput ? C(y) : null, h = t.audioOutput ? u(t.audioOutput, {
-				play: (e) => H(e, i, f),
-				isCurrent: () => i === T,
+			}, m = t.audioOutput ? w(b) : null, h = t.audioOutput ? d(t.audioOutput, {
+				play: (e) => Y(e, i, s),
+				isCurrent: () => i === M,
 				onChunkStart: (e) => {
 					m?.progress(), n.onChunkStart?.(e);
 				},
-				onStart: f
+				onStart: s
 			}) : null;
-			D = h, O = m;
+			P = h, F = m;
 			let g = (e) => m ? m.guard(e) : e, _ = () => {
-				h && (m?.stop(), O === m && (O = null), D === h && (D = null));
+				h && (m?.stop(), F === m && (F = null), P === h && (P = null));
 			};
 			(async () => {
 				try {
 					let e = p(r[0]);
 					for (let t = 0; t < r.length; t += 1) {
-						if (i !== T) return;
+						if (i !== M) return;
 						let a = await e;
-						if (i !== T) return;
+						if (i !== M) return;
 						let o = r[t + 1];
 						if (o !== void 0 && (e = p(o)), h) {
 							m?.handed(a.byteLength), await g(h.write(a));
 							continue;
 						}
-						n.onChunkStart?.(t), await H(a, i, f);
+						n.onChunkStart?.(t), await Y(a, i, s);
 					}
 					if (h) {
 						let e = await g(h.drain());
-						if (i !== T) return;
+						if (i !== M) return;
 						if (!e) throw Object.assign(/* @__PURE__ */ Error("audio output did not finish"), { reason: "unknown" });
 					}
-					i === T && (_(), n.onEnd?.());
+					i === M && (_(), n.onEnd?.());
 				} catch (e) {
-					if (a.abort(), i !== T) return;
+					if (a.abort(), i !== M) return;
 					let t = null;
 					if (h) {
-						let n = e instanceof S ? null : await g(h.drain()).then(() => null, (e) => e);
-						if (i !== T) return;
-						h.cancel(), d(e) ? t = e : d(n) && (t = n);
+						let n = e instanceof C ? null : await g(h.drain()).then(() => null, (e) => e);
+						if (i !== M) return;
+						h.cancel(), f(e) ? t = e : f(n) && (t = n);
 					}
-					if (T += 1, B(), _(), t) {
+					if (M += 1, q(), _(), t) {
 						n.onError?.("output-not-cleared");
 						return;
 					}
 					let r = e?.reason;
-					c(r, e?.transient === !0) && R(s(r), r === "not-allowed" ? e.headers ?? null : null), n.onError?.(r === "not-allowed" || r === "unsupported" || r === "cancelled" ? r : "unknown");
+					l(r, e?.transient === !0) && G(c(r), r === "not-allowed" ? e.headers ?? null : null), n.onError?.(r === "not-allowed" || r === "unsupported" || r === "cancelled" ? r : "unknown");
 				}
 			})();
 		},
 		headersChanged() {
-			v() >= k || j === null || N() || (k = 0, j = null, I(), F());
+			y() >= I || R === null || B() || (I = 0, R = null, U(), H());
 		},
 		cancel() {
-			T += 1, E?.abort(), E = null, B(), D?.cancel(), D = null, O?.stop(), O = null;
+			M += 1, N?.abort(), N = null, q(), P?.cancel(), P = null, F?.stop(), F = null;
 		}
 	};
 }
 //#endregion
-export { b as HOSTED_OUTPUT_MIN_AUDIO_BYTES_PER_SECOND, y as HOSTED_OUTPUT_STALL_AUDIO_RATIO, v as HOSTED_OUTPUT_STALL_BASE_MS, T as createHostedTtsEngine, x as hostedOutputStallMs, _ as retryDelayMs };
+export { x as HOSTED_OUTPUT_MIN_AUDIO_BYTES_PER_SECOND, b as HOSTED_OUTPUT_STALL_AUDIO_RATIO, y as HOSTED_OUTPUT_STALL_BASE_MS, T as SILENT_WAV_DATA_URI, j as createHostedTtsEngine, S as hostedOutputStallMs, O as primeHostedPlayback, k as resetHostedPlaybackForTest, v as retryDelayMs };

package/dist/shared/assistant/speech/notifyCancellationSpeechEngine.js

@@ -25,6 +25,9 @@ function e(e) {
 					onChunkStart: (e) => {
 						t === o && a.onChunkStart?.(e);
 					},
+					onDeviceFallback: () => {
+						t === o && a.onDeviceFallback?.();
+					},
 					onEnd: () => s(),
 					onError: (e) => s(e)
 				});

package/dist/shared/assistant/speech/routingSpeechEngine.js

@@ -15,23 +15,26 @@ function r(e) {
 }
 function i({ device: i, hosted: a }) {
 	if (!a) return i;
-	let o = new Set(a.listVoices().map((e) => e.name)), s = (e) => e.source === "hosted" || o.has(e.name), c = (e, t, r) => {
+	let o = new Set(a.listVoices().map((e) => e.name)), s = (e) => e.source === "hosted" || o.has(e.name), c = (e, t, r, a = !1) => {
+		let o = () => {
+			a && r?.onDeviceFallback?.();
+		};
 		if (!t.voice || !s(t.voice)) {
-			i.speak(e, t, r);
+			o(), i.speak(e, t, r);
 			return;
 		}
 		if (t.fallback === !1) {
 			r?.onError?.("unsupported");
 			return;
 		}
-		let a = n(i.listVoices(), t.lang);
-		if (!a) {
+		let c = n(i.listVoices(), t.lang);
+		if (!c) {
 			r?.onError?.("unsupported");
 			return;
 		}
-		i.speak(e, {
+		o(), i.speak(e, {
 			...t,
-			voice: a
+			voice: c
 		}, r);
 	}, l = (t) => a.isSupported() ? t.voice ? o.has(t.voice.name) ? a : i : e(t.lang) ? a : i : i;
 	return {
@@ -68,7 +71,7 @@ function i({ device: i, hosted: a }) {
 						return;
 					}
 					if (!s) {
-						c(e, n, o);
+						c(e, n, o, !0);
 						return;
 					}
 					let a = u >= 0 ? t(e).slice(u + 1) : [];
@@ -81,7 +84,7 @@ function i({ device: i, hosted: a }) {
 						...o,
 						onStart: void 0,
 						onChunkStart: (e) => o?.onChunkStart?.(l + e)
-					});
+					}, !0);
 				}
 			});
 		},

package/dist/shared/assistant/speech/types.d.ts

@@ -191,6 +191,17 @@ export interface SpeechSpeakHandlers {
     /** The whole queue finished on its own. */
     onEnd?: () => void;
     onError?: (reason: SpeechErrorReason) => void;
+    /**
+     * ★ BOFF-9408: the hosted voice could not play this reply, so the rest of it
+     * (or all of it) is about to be spoken on the DEVICE voice.
+     *
+     * The routing engine calls it once, just before the device voice starts, so
+     * the caller can say so on screen instead of the user hearing a different
+     * voice with no explanation. The fallback changes nothing the user chose:
+     * their saved voice is untouched and the next reply tries the hosted voice
+     * again. Optional; an engine with no fallback never calls it.
+     */
+    onDeviceFallback?: () => void;
 }
 export interface SpeechEngine {
     /** Stable id, for logging and for telling engines apart in a future swap. */