@burdenoff/fe-libs 2026.1024.2 → 2026.1024.4

package/dist/shared/assistant/appControls/languageReply.d.ts

@@ -7,7 +7,7 @@ import { LocalCommandCopy } from '../localUiCommandCopy';
  * display parameter also translates it when late words arrive, or when history
  * is reopened in another app language; saved strings are never rewritten.
  */
-export type LanguageReplyStep = "write" | "wait" | "grace";
+export type LanguageReplyStep = 'write' | 'wait' | 'grace';
 /** How long an idle, still-untranslated language is given before displaying English. */
 export declare const LANGUAGE_REPLY_GRACE_MS = 400;
 /** The longest the reply waits for the new language at all. */

package/dist/shared/assistant/appControls/names.d.ts

@@ -1,11 +1,11 @@
 export type NameMatch<T> = {
-    kind: "one";
+    kind: 'one';
     item: T;
 } | {
-    kind: "many";
+    kind: 'many';
     items: T[];
 } | {
-    kind: "none";
+    kind: 'none';
 };
 /**
  * Which of `items` a person means by `said`, judged on the product's own

package/dist/shared/assistant/appControls/pageAdapters.d.ts

@@ -24,7 +24,7 @@ export interface EnumFilterEntry {
     apply: (value: string | null) => ControlResult;
 }
 export declare function enumFilter<V extends string>(spec: EnumFilterSpec<V>): EnumFilterEntry;
-export declare function filtersOf(entries: readonly EnumFilterEntry[]): NonNullable<PageControlsAdapter["filters"]>;
+export declare function filtersOf(entries: readonly EnumFilterEntry[]): NonNullable<PageControlsAdapter['filters']>;
 export interface SortFieldSpec<V extends string> {
     id: string;
     label: string;
@@ -38,7 +38,7 @@ export interface SortSpec<V extends string> {
     value: V;
     set: (value: V) => void;
 }
-export declare function sortOf<V extends string>(spec: SortSpec<V>): NonNullable<PageControlsAdapter["sort"]>;
+export declare function sortOf<V extends string>(spec: SortSpec<V>): NonNullable<PageControlsAdapter['sort']>;
 export interface TabsSpec<T extends string> {
     items: readonly {
         id: T;
@@ -47,12 +47,12 @@ export interface TabsSpec<T extends string> {
     value: T;
     set: (id: T) => void;
 }
-export declare function tabsOf<T extends string>(spec: TabsSpec<T>): NonNullable<PageControlsAdapter["tabs"]>;
-export declare function searchOf(set: (query: string) => void): NonNullable<PageControlsAdapter["search"]>;
+export declare function tabsOf<T extends string>(spec: TabsSpec<T>): NonNullable<PageControlsAdapter['tabs']>;
+export declare function searchOf(set: (query: string) => void): NonNullable<PageControlsAdapter['search']>;
 /** One form or dialog the page can OPEN. `open` must only open it. */
 export interface OpenerSpec {
     id: string;
     label: string;
     open: () => void;
 }
-export declare function openersOf(specs: readonly OpenerSpec[]): NonNullable<PageControlsAdapter["openers"]>;
+export declare function openersOf(specs: readonly OpenerSpec[]): NonNullable<PageControlsAdapter['openers']>;

package/dist/shared/assistant/appControls/plan.d.ts

@@ -7,124 +7,124 @@ import { ControlBlock, ControlKey, SortDirection } from './types';
  */
 /** What the panel says, as data. `appControlCopy.ts` turns it into words. */
 export type ControlReply = {
-    code: "opened";
+    code: 'opened';
     what: OpenedWhat;
 } | {
-    code: "closed";
+    code: 'closed';
     what: ClosedWhat;
 } | {
-    code: "search-opened";
+    code: 'search-opened';
     query: string | null;
 } | {
-    code: "sidebar";
+    code: 'sidebar';
     collapsed: boolean;
     already: boolean;
 } | {
-    code: "sidebar-entry";
+    code: 'sidebar-entry';
     name: string;
     expanded: boolean;
     already: boolean;
 } | {
-    code: "language";
+    code: 'language';
     label: string;
     already: boolean;
 } | {
-    code: "language-not-offered";
+    code: 'language-not-offered';
     label: string;
 } | {
-    code: "workspace-confirm";
+    code: 'workspace-confirm';
     name: string;
 } | {
-    code: "workspace-switched";
+    code: 'workspace-switched';
     name: string;
 } | {
-    code: "workspace-already";
+    code: 'workspace-already';
     name: string;
 } | {
-    code: "workspace-none";
+    code: 'workspace-none';
 } | {
-    code: "logout-confirm";
+    code: 'logout-confirm';
 } | {
-    code: "logout-done";
+    code: 'logout-done';
 } | {
-    code: "tab";
+    code: 'tab';
     name: string;
     already: boolean;
 } | {
-    code: "filter-set";
+    code: 'filter-set';
     filter: string;
     option: string;
     already: boolean;
 } | {
-    code: "filter-cleared";
+    code: 'filter-cleared';
     filter: string | null;
 } | {
-    code: "sorted";
+    code: 'sorted';
     page: string;
     field: string;
     direction: SortDirection;
     already: boolean;
 } | {
-    code: "sort-needs-field";
+    code: 'sort-needs-field';
 } | {
-    code: "searched";
+    code: 'searched';
     page: string;
     query: string;
 } | {
-    code: "search-cleared";
+    code: 'search-cleared';
 } | {
-    code: "form-opened";
+    code: 'form-opened';
     name: string;
 } | {
-    code: "not-found";
+    code: 'not-found';
     what: NotFoundKind;
     page: string;
     name: string;
     options: string[];
     filter?: string;
 } | {
-    code: "ambiguous";
+    code: 'ambiguous';
     what: AmbiguousKind;
     name: string;
     options: string[];
 } | {
-    code: "filter-choose";
+    code: 'filter-choose';
     filter: string;
     options: string[];
 } | {
-    code: "failed";
+    code: 'failed';
 } | {
-    code: "blocked";
+    code: 'blocked';
     reason: ControlBlock;
 };
-export type OpenedWhat = "notifications" | "help" | "context" | "history" | "transcript" | "preview" | "conversation";
-export type ClosedWhat = "preview";
-export type NotFoundKind = "tab" | "filter" | "filter-option" | "sort" | "form" | "workspace";
-export type AmbiguousKind = "tab" | "filter" | "menu" | "workspace" | "column" | "form";
+export type OpenedWhat = 'notifications' | 'help' | 'context' | 'history' | 'transcript' | 'preview' | 'conversation';
+export type ClosedWhat = 'preview';
+export type NotFoundKind = 'tab' | 'filter' | 'filter-option' | 'sort' | 'form' | 'workspace';
+export type AmbiguousKind = 'tab' | 'filter' | 'menu' | 'workspace' | 'column' | 'form';
 /** What is recorded on the exchange (`AssistantLocalAction`). */
-export type ControlOutcome = "done" | "already" | "failed" | "blocked" | "not-found" | "ambiguous" | "confirm";
+export type ControlOutcome = 'done' | 'already' | 'failed' | 'blocked' | 'not-found' | 'ambiguous' | 'confirm';
 export interface ControlRun {
     reply: ControlReply;
     outcome: ControlOutcome;
 }
 /** What the stronger confirmation asks about. */
 export type ConfirmPrompt = {
-    kind: "logout";
+    kind: 'logout';
 } | {
-    kind: "workspace";
+    kind: 'workspace';
     name: string;
 };
 export type ControlPlan = 
 /** Nothing to run: say it. */
 {
-    kind: "reply";
-    control: ControlKey | "page";
+    kind: 'reply';
+    control: ControlKey | 'page';
     run: ControlRun;
 }
 /** Run it now and say what happened. `silent`: record nothing (a new conversation). */
  | {
-    kind: "run";
-    control: ControlKey | "page";
+    kind: 'run';
+    control: ControlKey | 'page';
     run: () => ControlRun;
     silent?: boolean;
 }
@@ -133,7 +133,7 @@ export type ControlPlan =
  * trusted press on the dialog's button — never from anything typed or said.
  */
  | {
-    kind: "confirm";
+    kind: 'confirm';
     control: ControlKey;
     ask: ControlRun;
     prompt: ConfirmPrompt;

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

@@ -30,16 +30,16 @@
  * called), not that everything it triggers has finished. The copy says so
  * ("Switching to …", never "Switched to …") where the app's handler is async.
  */
-export type ControlStatus = "done" | "already" | "failed";
+export type ControlStatus = 'done' | 'already' | 'failed';
 export interface ControlResult {
     status: ControlStatus;
 }
 /** Why a registered control cannot run for this person, right now. */
 export type ControlBlock = 
 /** RBAC or a feature gate: the person is not allowed to use it here. */
-"permission"
+'permission'
 /** Needs the live voice screen out of the way first (History, Preview, new conversation). */
- | "voice-session";
+ | 'voice-session';
 export interface ControlBase {
     /**
      * Null: it can run. Otherwise why not. Read at match time AND at run time —
@@ -111,7 +111,7 @@ export interface PageFilter {
     /** The option now applied, or null for none. */
     current?: () => string | null;
 }
-export type SortDirection = "asc" | "desc";
+export type SortDirection = 'asc' | 'desc';
 export interface PageControlsAdapter extends ControlBase {
     /**
      * Which page this is, in the product's words ("Crops"). Said back to the
@@ -180,22 +180,22 @@ export interface PreviewControl extends OpenControl {
      * assistant panel, which the live voice screen covers. "page": drawn on the
      * product's own page beside the assistant, so Voice may open it.
      */
-    surface?: "panel" | "page";
+    surface?: 'panel' | 'page';
 }
 /** Every control key, and the handler shape it takes. */
 export interface ControlMap {
-    "header.notifications": OpenControl;
-    "header.search": SearchControl;
-    "header.help": OpenControl;
-    "header.context": OpenControl;
-    "header.workspace": WorkspaceControl;
-    "account.logout": LogoutControl;
+    'header.notifications': OpenControl;
+    'header.search': SearchControl;
+    'header.help': OpenControl;
+    'header.context': OpenControl;
+    'header.workspace': WorkspaceControl;
+    'account.logout': LogoutControl;
     sidebar: SidebarControl;
     language: LanguageControl;
-    "assistant.history": OpenControl;
-    "assistant.transcript": OpenControl;
-    "assistant.preview": PreviewControl;
-    "assistant.conversation.new": OpenControl;
+    'assistant.history': OpenControl;
+    'assistant.transcript': OpenControl;
+    'assistant.preview': PreviewControl;
+    'assistant.conversation.new': OpenControl;
     page: PageControlsAdapter;
 }
 export type ControlKey = keyof ControlMap;

package/dist/shared/assistant/appControls/useAssistantControl.d.ts

@@ -20,4 +20,4 @@ export declare function useAssistantControl<K extends ControlKey>(key: K, impl:
  * its handlers call the page's own setters. The vocabulary has no submit, save,
  * create or delete — see `types.ts`.
  */
-export declare function useAssistantPageControls(adapter: ControlMap["page"] | null): void;
+export declare function useAssistantPageControls(adapter: ControlMap['page'] | null): void;

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

@@ -19,7 +19,7 @@
  * through Documents or Files here; anything else is a file it would have to
  * refuse after the user had already chosen it.
  */
-export type AttachmentSourceId = "camera" | "gallery" | "documents" | "files";
+export type AttachmentSourceId = 'camera' | 'gallery' | 'documents' | 'files';
 export interface AttachmentSource {
     id: AttachmentSourceId;
     /** i18n key and the English fallback, resolved by the caller. */
@@ -33,7 +33,7 @@ export interface AttachmentSource {
      * ignored on desktop, which falls back to the file picker rather than
      * breaking.
      */
-    capture?: "environment" | "user";
+    capture?: 'environment' | 'user';
     /** Multi-select. A camera capture is one shot at a time. */
     multiple: boolean;
     /**

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

@@ -61,14 +61,14 @@ export interface AssistantInlineLimitsConfig {
     readonly maxInlineCharsPerFile?: number;
     readonly maxInlineCharsTotal?: number;
 }
-export type AssistantAttachmentKind = "image" | "text" | "document";
-export type AssistantAttachmentStatus = "pending" | "uploading" | "ready" | "error";
-export type AttachmentRejection = "too-many" | "too-large" | "empty" | "unreadable" | "unsupported-image"
+export type AssistantAttachmentKind = 'image' | 'text' | 'document';
+export type AssistantAttachmentStatus = 'pending' | 'uploading' | 'ready' | 'error';
+export type AttachmentRejection = 'too-many' | 'too-large' | 'empty' | 'unreadable' | 'unsupported-image'
 /**
  * Over the 5 MiB the browser can upload directly, and with no text to send inline instead: it
  * could be neither saved to Files nor read, so it is refused at attach rather than failing at Send.
  */
- | "too-large-to-save";
+ | 'too-large-to-save';
 /**
  * Thrown while PREPARING a file (after it passed `validateFile`) to reject it
  * with a specific reason rather than the generic 'unreadable'.
@@ -234,7 +234,7 @@ export declare function hasAttachmentWorkInFlight(preparingCount: number, attach
  */
 export declare function getSendableAttachments(attachments: AssistantAttachment[]): AssistantAttachment[];
 /** Why a draft cannot be sent yet, as far as its attachments are concerned. */
-export type AttachmentSendBlocker = "in-flight" | "failed";
+export type AttachmentSendBlocker = 'in-flight' | 'failed';
 /**
  * Whether the attachments block sending, and why — `null` when they do not.
  *

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

@@ -11,13 +11,13 @@ export declare const AUTO_READ_MODE = "assistant";
  */
 export declare const AUTO_WRITE_MODE = "api-calls";
 /** What a message asks for: a change to be made, or anything else. */
-export type AssistantIntent = "act" | "read";
+export type AssistantIntent = 'act' | 'read';
 /**
  * Auto is offered only where there is something to route between: the product
  * offers BOTH the read mode and the write mode to this person. `modes` must be
  * the role-filtered list the selector shows, not the product's full list.
  */
-export declare function isAutoRoutingOffered(modes: readonly Pick<AssistantModeConfig, "id">[]): boolean;
+export declare function isAutoRoutingOffered(modes: readonly Pick<AssistantModeConfig, 'id'>[]): boolean;
 /**
  * Does this message ask for a change to be made?
  *
@@ -62,16 +62,16 @@ export interface AutoRouteConversation {
  *   place, with a fresh backend session.
  */
 export type AutoRoute = {
-    action: "new";
+    action: 'new';
     mode: AssistantMode;
 } | {
-    action: "adopt";
+    action: 'adopt';
     mode: AssistantMode;
 } | {
-    action: "continue";
+    action: 'continue';
     mode: AssistantMode;
 } | {
-    action: "escalate";
+    action: 'escalate';
     mode: AssistantMode;
 };
 export interface AutoRouteInput {

package/dist/shared/assistant/avatar/live/LiveAvatarMinutes.d.ts

@@ -0,0 +1,24 @@
+import { FC, RefObject } from 'react';
+import { AssistantNavigate } from '../../ui/AssistantMarkdownRenderer';
+import { LiveAvatarController, LiveAvatarSnapshot } from './liveAvatarController';
+import { LiveAvatarMinutesPurchase } from './liveAvatarMinutesView';
+/** How often the session's time left is redrawn while it runs (DESIGN 3.10: every 15 s). */
+export declare const LIVE_AVATAR_MINUTES_REDRAW_MS = 15000;
+export interface LiveAvatarMinutesProps {
+    readonly controller: LiveAvatarController;
+    /** The snapshot the tab read (one subscription per view). */
+    readonly snapshot: LiveAvatarSnapshot;
+    /** The host's purchase access (`LiveAvatarSeamOptions.minutesPurchase`). Absent: nobody is offered a purchase here. */
+    readonly minutesPurchase?: LiveAvatarMinutesPurchase | undefined;
+    /** The panel's navigator. Absent or null: nothing opens billing. */
+    readonly navigate?: AssistantNavigate | null | undefined;
+    /** Wall-clock milliseconds. */
+    readonly now: () => number;
+    /** The id of the region's words: a Turn on the minutes hold back is described by them. */
+    readonly textId: string;
+    /** The tab's view, focusable: it takes the focus when a control here goes while it holds it. A ref the tab keeps (stable). */
+    readonly viewRef: RefObject<HTMLElement | null>;
+    /** How often the session's time left is redrawn. Tests pass their own. */
+    readonly redrawMs?: number;
+}
+export declare const LiveAvatarMinutes: FC<LiveAvatarMinutesProps>;

package/dist/shared/assistant/avatar/live/LiveAvatarMinutes.js

@@ -0,0 +1,161 @@
+import { useAvatarCopy as e } from "../useAvatarCopy.js";
+import { LIVE_AVATAR_MINUTES_REFRESH_MS as t, LIVE_AVATAR_REQUEST_TIMEOUT_MS as n } from "./liveAvatarController.js";
+import { LIVE_AVATAR_MINUTES_PLANS_PATH as r, liveAvatarMinutesView as i } from "./liveAvatarMinutesView.js";
+import { useCallback as a, useEffect as o, useId as ee, useRef as s, useState as c } from "react";
+import { ChevronDown as l } from "lucide-react";
+import { jsx as u, jsxs as d } from "react/jsx-runtime";
+//#region src/shared/assistant/avatar/live/LiveAvatarMinutes.tsx
+var f = 15e3, p = t + n, m = "text-xs text-text-muted", h = "focus:outline-none focus-visible:ring-2 focus-visible:ring-border-strong", g = `inline-flex min-h-11 w-full items-center justify-center gap-2 rounded-xl border border-border-default bg-bg-elevated px-4 text-sm font-medium text-text-primary transition-colors hover:bg-bg-raised aria-disabled:cursor-default aria-disabled:opacity-60 aria-disabled:hover:bg-bg-elevated ${h}`, _ = `inline-flex min-h-11 items-center gap-1 self-start rounded-lg text-xs font-medium text-text-secondary transition-colors hover:text-text-primary ${h}`, te = { status: "absent" }, v = { status: "asking" }, y = { status: "failed" };
+function b(e) {
+	if (typeof e != "object" || !e || !("canPurchase" in e)) return y;
+	let { canPurchase: t } = e;
+	return typeof t == "boolean" ? {
+		status: "answered",
+		access: { canPurchase: t }
+	} : y;
+}
+var x = { status: "idle" }, S = ({ controller: t, snapshot: n, minutesPurchase: h, navigate: S, now: C, textId: w, viewRef: T, redrawMs: E = f }) => {
+	let D = e(), O = ee(), [k, A] = c(!1), j = s(!0);
+	o(() => (j.current = !0, () => {
+		j.current = !1;
+	}), []);
+	let M = a((e) => {
+		if (e !== null) return () => {
+			e.contains(e.ownerDocument.activeElement) && T.current?.focus();
+		};
+	}, [T]), N = h !== void 0 && S != null, [P, F] = c(x), I = s(null), L = n.minutes === null;
+	o(() => {
+		L && (I.current = null, F(x));
+	}, [L]);
+	let [R, z] = c(null), B = s(n.minutes?.balance?.availableMinutes ?? 0), V = s(n.purchase);
+	o(() => {
+		let e = V.current;
+		V.current = n.purchase, n.purchase === "checking" && e !== "checking" ? (B.current = n.minutes?.balance?.availableMinutes ?? 0, z(null)) : n.purchase === "idle" && e === "checking" && z({
+			kind: (n.minutes?.balance?.availableMinutes ?? 0) > B.current ? "seen" : "not-seen",
+			minutes: n.minutes
+		});
+	}, [n.purchase, n.minutes]);
+	let H = R !== null && R.minutes === n.minutes ? R.kind : null, [U, W] = c(null), [G, K] = c(null), q = U !== null && U.minutes === n.minutes, J = G !== null && G.minutes === n.minutes;
+	o(() => {
+		if (U === null) return;
+		if (!q) {
+			W(null), K({ minutes: n.minutes });
+			return;
+		}
+		let e = setTimeout(() => W(null), p);
+		return () => clearTimeout(e);
+	}, [
+		U,
+		q,
+		n.minutes
+	]);
+	let Y = n.phase === "ready" && !n.closing && n.sessionEndsAt !== null, [, X] = c(0);
+	o(() => {
+		if (!Y) return;
+		let e = setInterval(() => X((e) => e + 1), E);
+		return () => clearInterval(e);
+	}, [Y, E]);
+	let Z = i({
+		snapshot: n,
+		access: N ? P.status === "idle" ? v : P : te,
+		purchaseOutcome: H,
+		rechecked: J,
+		now: C()
+	}, D), Q = N && Z !== null && Z.wantsAccess, $ = Z?.action ?? null;
+	o(() => {
+		if (!Q || P.status !== "idle" || I.current !== null || h === void 0) return;
+		let e = Symbol("access");
+		I.current = e, F(v);
+		let t = (t) => {
+			!j.current || I.current !== e || (I.current = null, F(t));
+		};
+		Promise.resolve().then(() => h.access()).then((e) => t(b(e)), () => t(y));
+	}, [
+		Q,
+		P.status,
+		h
+	]);
+	let ne = a((e) => {
+		S && (z(null), Promise.resolve(S(e, "person", { surface: "avatar-minutes" })).catch(() => void 0));
+	}, [S]);
+	if (Z === null) return null;
+	let re = (e) => {
+		switch (e) {
+			case "see-plans":
+				ne(r);
+				return;
+			case "check-again":
+				if (q) return;
+				W({ minutes: n.minutes }), K(null), t.refreshMinutes();
+				return;
+			case "check-purchase-again":
+				t.checkMinutesPurchase();
+				return;
+		}
+	}, ie = (e) => {
+		switch (e) {
+			case "see-plans": return D.minutes.seePlans;
+			case "check-again": return q ? D.minutes.checking : D.minutes.checkAgain;
+			case "check-purchase-again": return D.minutes.checkAgain;
+		}
+	}, ae = D.minutes.howCounted(Z.staleSeconds);
+	return /* @__PURE__ */ d("div", {
+		ref: M,
+		className: "flex flex-col gap-1.5",
+		"data-testid": "assistant-avatar-tab-minutes",
+		"data-state": Z.state,
+		children: [
+			/* @__PURE__ */ d("div", {
+				id: w,
+				className: "flex flex-col gap-0.5",
+				children: [Z.headline === null ? null : /* @__PURE__ */ u("p", {
+					className: "text-sm text-text-primary",
+					"data-testid": "assistant-avatar-tab-minutes-headline",
+					children: Z.headline
+				}), Z.details.map((e) => /* @__PURE__ */ u("p", {
+					className: m,
+					"data-testid": "assistant-avatar-tab-minutes-detail",
+					children: e
+				}, e))]
+			}),
+			$ === null ? null : /* @__PURE__ */ u("button", {
+				ref: M,
+				type: "button",
+				onClick: () => re($),
+				"aria-disabled": $ === "check-again" && q,
+				className: g,
+				"data-testid": "assistant-avatar-tab-minutes-action",
+				"data-action": $,
+				children: ie($)
+			}),
+			/* @__PURE__ */ d("button", {
+				type: "button",
+				onClick: () => A((e) => !e),
+				"aria-expanded": k,
+				"aria-controls": O,
+				className: _,
+				"data-testid": "assistant-avatar-tab-minutes-how",
+				children: [/* @__PURE__ */ u("span", { children: D.minutes.howCountedTitle }), /* @__PURE__ */ u(l, {
+					className: `size-4 shrink-0 transition-transform ${k ? "rotate-180" : ""}`,
+					"aria-hidden": "true"
+				})]
+			}),
+			/* @__PURE__ */ u("ul", {
+				id: O,
+				hidden: !k,
+				className: "flex list-disc flex-col gap-1 ps-5 text-xs text-text-secondary",
+				"data-testid": "assistant-avatar-tab-minutes-how-text",
+				children: ae.map((e) => /* @__PURE__ */ u("li", { children: e }, e))
+			}),
+			/* @__PURE__ */ u("p", {
+				className: "sr-only",
+				"aria-live": "polite",
+				"aria-atomic": "true",
+				"data-testid": "assistant-avatar-tab-minutes-live",
+				children: Z.announcement ?? ""
+			})
+		]
+	});
+};
+//#endregion
+export { f as LIVE_AVATAR_MINUTES_REDRAW_MS, S as LiveAvatarMinutes };