@peasant-labs/fairtrade 0.0.39 → 0.0.41

package/dist/lib/time-CpVBzcqQ.js

@@ -0,0 +1,157 @@
+import { Harness as e, isHarness as t } from "@peasant-labs/schema";
+//#region src/ui/brand-geometry.js
+var n = {
+	github: "M12 .297c-6.63 0-12 5.373-12 12 0 5.303 3.438 9.8 8.205 11.385.6.113.82-.258.82-.577 0-.285-.01-1.04-.015-2.04-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729 1.205.084 1.838 1.236 1.838 1.236 1.07 1.835 2.807 1.305 3.492.998.108-.776.417-1.305.76-1.605-2.665-.3-5.466-1.332-5.466-5.93 0-1.31.465-2.38 1.235-3.22-.135-.303-.54-1.523.105-3.176 0 0 1.005-.322 3.3 1.23.96-.267 1.98-.4 3-.405 1.02.005 2.04.138 3 .405 2.28-1.552 3.285-1.23 3.285-1.23.645 1.653.24 2.873.12 3.176.765.84 1.23 1.91 1.23 3.22 0 4.61-2.805 5.625-5.475 5.92.42.36.81 1.096.81 2.22 0 1.606-.015 2.896-.015 3.286 0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12",
+	claude: "m4.7144 15.9555 4.7174-2.6471.079-.2307-.079-.1275h-.2307l-.7893-.0486-2.6956-.0729-2.3375-.0971-2.2646-.1214-.5707-.1215-.5343-.7042.0546-.3522.4797-.3218.686.0608 1.5179.1032 2.2767.1578 1.6514.0972 2.4468.255h.3886l.0546-.1579-.1336-.0971-.1032-.0972L6.973 9.8356l-2.55-1.6879-1.3356-.9714-.7225-.4918-.3643-.4614-.1578-1.0078.6557-.7225.8803.0607.2246.0607.8925.686 1.9064 1.4754 2.4893 1.8336.3643.3035.1457-.1032.0182-.0728-.164-.2733-1.3539-2.4467-1.445-2.4893-.6435-1.032-.17-.6194c-.0607-.255-.1032-.4674-.1032-.7285L6.287.1335 6.6997 0l.9957.1336.419.3642.6192 1.4147 1.0018 2.2282 1.5543 3.0296.4553.8985.2429.8318.091.255h.1579v-.1457l.1275-1.706.2368-2.0947.2307-2.6957.0789-.7589.3764-.9107.7468-.4918.5828.2793.4797.686-.0668.4433-.2853 1.8517-.5586 2.9021-.3643 1.9429h.2125l.2429-.2429.9835-1.3053 1.6514-2.0643.7286-.8196.85-.9046.5464-.4311h1.0321l.759 1.1293-.34 1.1657-1.0625 1.3478-.8804 1.1414-1.2628 1.7-.7893 1.36.0729.1093.1882-.0183 2.8535-.607 1.5421-.2794 1.8396-.3157.8318.3886.091.3946-.3278.8075-1.967.4857-2.3072.4614-3.4364.8136-.0425.0304.0486.0607 1.5482.1457.6618.0364h1.621l3.0175.2247.7892.522.4736.6376-.079.4857-1.2142.6193-1.6393-.3886-3.825-.9107-1.3113-.3279h-.1822v.1093l1.0929 1.0686 2.0035 1.8092 2.5075 2.3314.1275.5768-.3218.4554-.34-.0486-2.2039-1.6575-.85-.7468-1.9246-1.621h-.1275v.17l.4432.6496 2.3436 3.5214.1214 1.0807-.17.3521-.6071.2125-.6679-.1214-1.3721-1.9246L14.38 17.959l-1.1414-1.9428-.1397.079-.674 7.2552-.3156.3703-.7286.2793-.6071-.4614-.3218-.7468.3218-1.4753.3886-1.9246.3157-1.53.2853-1.9004.17-.6314-.0121-.0425-.1397.0182-1.4328 1.9672-2.1796 2.9446-1.7243 1.8456-.4128.164-.7164-.3704.0667-.6618.4008-.5889 2.386-3.0357 1.4389-1.882.929-1.0868-.0062-.1579h-.0546l-6.3385 4.1164-1.1293.1457-.4857-.4554.0608-.7467.2307-.2429 1.9064-1.3114Z",
+	gemini: "M11.04 19.32Q12 21.51 12 24q0-2.49.93-4.68.96-2.19 2.58-3.81t3.81-2.55Q21.51 12 24 12q-2.49 0-4.68-.93a12.3 12.3 0 0 1-3.81-2.58 12.3 12.3 0 0 1-2.58-3.81Q12 2.49 12 0q0 2.49-.96 4.68-.93 2.19-2.55 3.81a12.3 12.3 0 0 1-3.81 2.58Q2.49 12 0 12q2.49 0 4.68.96 2.19.93 3.81 2.55t2.55 3.81",
+	openai: "M22.2819 9.8211a5.9847 5.9847 0 0 0-.5157-4.9108 6.0462 6.0462 0 0 0-6.5098-2.9A6.0651 6.0651 0 0 0 4.9807 4.1818a5.9847 5.9847 0 0 0-3.9977 2.9 6.0462 6.0462 0 0 0 .7427 7.0966 5.98 5.98 0 0 0 .511 4.9107 6.051 6.051 0 0 0 6.5146 2.9001A5.9847 5.9847 0 0 0 13.2599 24a6.0557 6.0557 0 0 0 5.7718-4.2058 5.9894 5.9894 0 0 0 3.9977-2.9001 6.0557 6.0557 0 0 0-.7475-7.0729zm-9.022 12.6081a4.4755 4.4755 0 0 1-2.8764-1.0408l.1419-.0804 4.7783-2.7582a.7948.7948 0 0 0 .3927-.6813v-6.7369l2.02 1.1686a.071.071 0 0 1 .038.052v5.5826a4.504 4.504 0 0 1-4.4945 4.4944zm-9.6607-4.1254a4.4708 4.4708 0 0 1-.5346-3.0137l.142.0852 4.783 2.7582a.7712.7712 0 0 0 .7806 0l5.8428-3.3685v2.3324a.0804.0804 0 0 1-.0332.0615L9.74 19.9502a4.4992 4.4992 0 0 1-6.1408-1.6464zM2.3408 7.8956a4.485 4.485 0 0 1 2.3655-1.9728V11.6a.7664.7664 0 0 0 .3879.6765l5.8144 3.3543-2.0201 1.1685a.0757.0757 0 0 1-.071 0l-4.8303-2.7865A4.504 4.504 0 0 1 2.3408 7.872zm16.5963 3.8558L13.1038 8.364 15.1192 7.2a.0757.0757 0 0 1 .071 0l4.8303 2.7913a4.4944 4.4944 0 0 1-.6765 8.1042v-5.6772a.79.79 0 0 0-.407-.667zm2.0107-3.0231l-.142-.0852-4.7735-2.7818a.7759.7759 0 0 0-.7854 0L9.409 9.2297V6.8974a.0662.0662 0 0 1 .0284-.0615l4.8303-2.7866a4.4992 4.4992 0 0 1 6.6802 4.66zM8.3065 12.863l-2.02-1.1638a.0804.0804 0 0 1-.038-.0567V6.0742a4.4992 4.4992 0 0 1 7.3757-3.4537l-.142.0805L8.704 5.459a.7948.7948 0 0 0-.3927.6813zm1.0976-2.3654l2.602-1.4998 2.6069 1.4998v2.9994l-2.5974 1.4997-2.6067-1.4997Z",
+	opencode: "M22 24H2V0h20zM17 4.8H7v14.4h10z",
+	cursor: "M11.503.131 1.891 5.678a.84.84 0 0 0-.42.726v11.188c0 .3.162.575.42.724l9.609 5.55a1 1 0 0 0 .998 0l9.61-5.55a.84.84 0 0 0 .42-.724V6.404a.84.84 0 0 0-.42-.726L12.497.131a1.01 1.01 0 0 0-.996 0M2.657 6.338h18.55c.263 0 .43.287.297.515L12.23 22.918c-.062.107-.229.064-.229-.06V12.335a.59.59 0 0 0-.295-.51l-9.11-5.257c-.109-.063-.064-.23.061-.23",
+	strike: "M18.5 6L11 17.5h5.2L13.5 26 21 14.5h-5.2L18.5 6z",
+	pi: "M165.29 165.29 H517.36 V400 H400 V517.36 H282.65 V634.72 H165.29 Z M282.65 282.65 V400 H400 V282.65 Z M517.36 400 H634.72 V634.72 H517.36 Z"
+}, r = {
+	strike: "6 6 20 20",
+	pi: "0 0 800 800"
+}, i = { pi: "evenodd" }, a = {
+	anthropic: "claude",
+	"claude-code": "claude",
+	google: "gemini",
+	googlegemini: "gemini",
+	"gemini-cli": "gemini",
+	codex: "openai",
+	"codex-cli": "openai",
+	chatgpt: "openai",
+	gpt: "openai"
+};
+function o(e) {
+	if (!e) return null;
+	let t = String(e).toLowerCase().trim(), r = a[t] || t;
+	return n[r] ? r : null;
+}
+function s(e) {
+	return r[e] ?? "0 0 24 24";
+}
+var c = Object.freeze({
+	viewBox: "0 0 32 32",
+	strokeWidth: 2.1,
+	paths: Object.freeze([
+		"M16 27V8",
+		"M16 21l-5.5-6",
+		"M16 21l5.5-6",
+		"M16 15l-5-5.5",
+		"M16 15l5-5.5"
+	])
+}), l = Object.freeze(Object.values(e)), u = Object.freeze({
+	"claude-code": "Claude Code",
+	"gemini-cli": "Gemini CLI",
+	codex: "Codex",
+	opencode: "opencode",
+	cursor: "Cursor",
+	antigravity: "Google Antigravity",
+	strike: "Strike",
+	pi: "Pi"
+}), d = Object.freeze({
+	"claude-code": "claude",
+	"gemini-cli": "gemini",
+	codex: "openai",
+	opencode: "opencode",
+	cursor: "cursor",
+	antigravity: "gemini",
+	strike: "strike",
+	pi: "pi"
+}), f = Object.freeze({
+	"claude-code": "amber",
+	"gemini-cli": "teal",
+	codex: "olive",
+	opencode: "mauve",
+	cursor: "clay",
+	antigravity: "teal",
+	strike: "clay",
+	pi: "mauve"
+});
+function p(e, n) {
+	if (t(e)) return;
+	let r;
+	try {
+		r = JSON.stringify(e);
+	} catch {
+		r = String(e);
+	}
+	throw TypeError(`Provider harness validation failed for ${r} at src/ui/provider-policy.js during ${n}: the value is outside the canonical @peasant-labs/schema Harness, so Fairtrade cannot select a trustworthy provider identity; the caller must validate its wire boundary and pass one of ${l.join(", ")}.`);
+}
+function m(e) {
+	return p(e, "provider display-name resolution"), u[e];
+}
+function h(e) {
+	return p(e, "provider brand resolution"), d[e];
+}
+function g(e) {
+	return p(e, "provider accent resolution"), f[e];
+}
+//#endregion
+//#region src/ui/transcript/time.js
+function _(e) {
+	if (!e) return !1;
+	let t = new Date(e).getTime();
+	return Number.isFinite(t) && t > 0;
+}
+var v = [
+	"jan",
+	"feb",
+	"mar",
+	"apr",
+	"may",
+	"jun",
+	"jul",
+	"aug",
+	"sep",
+	"oct",
+	"nov",
+	"dec"
+];
+function y(e, t) {
+	let n = new Date(e), r = `${v[n.getMonth()]} ${n.getDate()}`;
+	return n.getFullYear() === new Date(t).getFullYear() ? r : `${r}, ${n.getFullYear()}`;
+}
+function b(e, t = Date.now()) {
+	if (!_(e)) return "";
+	let n = new Date(e).getTime(), r = Math.max(0, Math.round((t - n) / 1e3));
+	if (r < 45) return "just now";
+	if (r < 90) return "1m ago";
+	let i = Math.round(r / 60);
+	if (i < 45) return `${i}m ago`;
+	if (i < 90) return "1h ago";
+	let a = Math.round(i / 60);
+	if (a < 24) return `${a}h ago`;
+	if (a < 36) return "1d ago";
+	let o = Math.round(a / 24);
+	return o <= 7 ? `${o}d ago` : y(n, t);
+}
+function x(e) {
+	if (e == null || !Number.isFinite(e) || e <= 0) return "";
+	if (e < 1) return "<1s";
+	let t = Math.round(e);
+	if (t < 60) return `${t}s`;
+	let n = Math.floor(t / 60), r = t % 60;
+	if (n < 60) return r ? `${n}m ${r}s` : `${n}m`;
+	let i = Math.floor(n / 60), a = n % 60;
+	return a ? `${i}h ${a}m` : `${i}h`;
+}
+function S(e) {
+	return e == null || !Number.isFinite(e) ? "" : x(e * 60);
+}
+function C(e) {
+	return e == null || !Number.isFinite(e) || e <= 0 ? "" : e < 1e3 ? `${Math.round(e)}ms` : e < 1e4 ? `${(e / 1e3).toFixed(1).replace(/\.0$/, "")}s` : x(e / 1e3);
+}
+function w(e) {
+	if (!e) return "";
+	let t = new Date(e);
+	return isFinite(t.getTime()) ? t.getTime() <= 0 ? "" : t.toLocaleString(void 0, {
+		month: "short",
+		day: "numeric",
+		hour: "numeric",
+		minute: "2-digit"
+	}) : e;
+}
+//#endregion
+export { s as _, b as a, d as c, g as d, h as f, c as g, n as h, x as i, l, i as m, S as n, _ as o, m as p, C as r, f as s, w as t, p as u, o as v };

package/dist/lib/types/BrandMark.d.ts

@@ -1,9 +1,3 @@
-/**
- * resolve any accepted name/alias to a canonical mark key, or null when unknown.
- * @param {string} name
- * @returns {('claude'|'gemini'|'openai'|'cursor'|'opencode'|'strike'|'pi'|'github')|null}
- */
-export function resolveBrand(name: string): ("claude" | "gemini" | "openai" | "cursor" | "opencode" | "strike" | "pi" | "github") | null;
 /**
  * BrandMark - a single-color, currentColor-tinted company/provider logo.
  *
@@ -23,3 +17,5 @@ export default function BrandMark({ name, size, label, className, ...rest }: {
     label?: string;
     className?: string;
 }): JSX.Element | null;
+export { resolveBrand };
+import { resolveBrand } from './brand-geometry.js';

package/dist/lib/types/CliOnboard.d.ts

@@ -1,3 +1,14 @@
+/**
+ * The words of a wrapped command and the spaces between them, as the line breaks them: a lone "|"
+ * keeps to the word after it, so a pipe never starts or ends a line on its own.
+ * @param {string} command
+ * @returns {Array<{ word: string } | { space: string }>}
+ */
+export function commandWords(command: string): Array<{
+    word: string;
+} | {
+    space: string;
+}>;
 /**
  * CommandBlock — a square `$ command` block: a mono command line with a leading dim `$`, and a copy
  * button that flips to an olive check + the word "copied" for ~1.5s.

package/dist/lib/types/DiffView.d.ts

@@ -6,12 +6,14 @@
  *
  *  redaction:  variant="redaction", pass `matches` = [{ category, confidence, original,
  *              replacement, oldNo, newNo }]. each match is a del→add pair with a category/
- *              confidence badge and a per-match keep/revert button.
+ *              confidence badge and a per-match keep/revert button. `category` is the engine's
+ *              (RedactionCategory: secrets, pii, paths, project) and shows as the engine's label;
+ *              an unknown category (a rule name, a display label) shows an alert and no match.
  *
  * @param {object} props
  * @param {string} props.file - the file path shown in the header (mono, not lowercased)
  * @param {Array<{header?:string, lines:Array<{type:'add'|'del'|'ctx', oldNo?:number|string, newNo?:number|string, text:string}>}>} [props.hunks] - structured hunks (default variant)
- * @param {Array<{category:string, confidence:number, original:string, replacement:string, oldNo?:number|string, newNo?:number|string}>} [props.matches] - redaction matches (redaction variant)
+ * @param {Array<{category:import('@peasant-labs/schema').RedactionCategory, confidence:number, original:string, replacement:string, oldNo?:number|string, newNo?:number|string}>} [props.matches] - redaction matches (redaction variant)
  * @param {'default'|'redaction'} [props.variant='default']
  * @param {string} [props.className]
  */
@@ -27,7 +29,7 @@ export default function DiffView({ file, hunks, matches, variant, className, ...
         }>;
     }>;
     matches?: Array<{
-        category: string;
+        category: import("@peasant-labs/schema").RedactionCategory;
         confidence: number;
         original: string;
         replacement: string;

package/dist/lib/types/Publish.d.ts

@@ -4,15 +4,19 @@
  * @param {object} props
  * @param {PublishState} props.state
  * @param {number} [props.collectives] - how many collectives can read it (published, new-turns, publishing); left out of the words when omitted.
- * @param {number} [props.newTurns] - turns recorded since the last publish (new-turns).
+ * @param {number} [props.newTurns] - turns recorded since the last publish (new-turns); the label says "needs update".
  * @param {string} [props.collective] - the collective(s) the project's auto-publish rule targets (auto-publish).
+ * @param {'public'|'private'} [props.visibility] - published: who can find it beyond its collectives, as the host knows
+ *        it. "published, public" and "published, private" are said only from this; without it a transcript no
+ *        collective reads is just "published".
  * @param {string} [props.className]
  */
-export function PublishStateLabel({ state, collectives, newTurns, collective, className, ...rest }: {
+export function PublishStateLabel({ state, collectives, newTurns, collective, visibility, className, ...rest }: {
     state: PublishState;
     collectives?: number;
     newTurns?: number;
     collective?: string;
+    visibility?: "public" | "private";
     className?: string;
 }): import("react").JSX.Element;
 /**
@@ -25,16 +29,18 @@ export function PublishStateLabel({ state, collectives, newTurns, collective, cl
  * @param {number} [props.collectives]
  * @param {number} [props.newTurns]
  * @param {string} [props.collective]
+ * @param {'public'|'private'} [props.visibility]
  * @param {() => void} [props.onAction] - the one button. omit it and no button renders.
  * @param {string} [props.actionLabel] - replaces the state's default label.
  * @param {import('./Menu.jsx').MenuItem[]} [props.moreItems] - an optional overflow menu after the button.
  * @param {string} [props.className]
  */
-export function PublishBar({ state, collectives, newTurns, collective, onAction, actionLabel, moreItems, className, ...rest }: {
+export function PublishBar({ state, collectives, newTurns, collective, visibility, onAction, actionLabel, moreItems, className, ...rest }: {
     state: PublishState;
     collectives?: number;
     newTurns?: number;
     collective?: string;
+    visibility?: "public" | "private";
     onAction?: () => void;
     actionLabel?: string;
     moreItems?: import("./Menu.jsx").MenuItem[];
@@ -96,7 +102,7 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * checkbox, then the done state with the village link. The host drives `state`; the popup never
  * advances on its own.
  *
- * States: `connect` (this computer is not signed in to village), `waiting-github` (after continue
+ * States: `connect` (this computer is not signed in to peasant online), `waiting-github` (after continue
  * with github), `checking` (the redaction check is running), `scan-failed` (publish is off,
  * re-scan stays on), `no-collective` (signed in, in no collective), `ready`, `publishing`,
  * `stopped` (a named step failed; the host names any changes already applied), `done`, `waits-approval` (done, and
@@ -108,7 +114,7 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {string} props.title - the session title, kept in its case.
  * @param {'publish'|'update'} [props.mode='publish']
  * @param {PublishDialogState} props.state - one of PUBLISH_DIALOG_STATES.
- * @param {{ matches?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string, failureDetail?: string, failureAction?: { label: string, onSelect: () => void, busy?: boolean } }} [props.scan] - the host's scan result. `failure` is one plain line; `failureAction` is a button in the failure box (the one action that fixes it); `failureDetail`, the actionable detail (what, why, where, the fix), shows as pre-wrapped mono text behind a "details" disclosure in the failure box. `matchCount` is the full occurrence count when `matches` contains only examples. Until it carries a
+ * @param {{ matches?: import('./Redaction.jsx').RedactionMatch[], matchCount?: number, total?: number, failure?: string, failureDetail?: string, failureAction?: { label: string, onSelect: () => void, busy?: boolean }, note?: { line: string, detail?: string } }} [props.scan] - the host's scan result. `note` is a quiet line under a finished scan's count (what the scanned copy leaves out, and why), with its detail behind a "details" disclosure; it is information, not an alert, and publishing stays on. `failure` is one plain line; `failureAction` is a button in the failure box (the one action that fixes it); `failureDetail`, the actionable detail (what, why, where, the fix), shows as pre-wrapped mono text behind a "details" disclosure in the failure box. `matchCount` is the full occurrence count when `matches` contains only examples. Until it carries a
  *        `matches` list, the popup says the transcript is not scanned and keeps publish off. A match with `kept: true` leaves un-redacted, and the
  *        popup says so and opens the matches.
  * @param {() => void} [props.onRescan]
@@ -125,13 +131,18 @@ export function CollectivePicker({ suggestions, onAdd, query: queryProp, onQuery
  * @param {string} [props.primaryLabel] - replaces the derived primary label.
  * @param {() => void} [props.onPublish]
  * @param {() => void} [props.onConnect] - `continue with github`.
- * @param {string} [props.joinHref] - `create or join one on village`.
+ * @param {string} [props.joinHref] - `create or join one on peasant online`.
  * @param {string} [props.stoppedAt] - the step that failed, in words ("setting who can read it").
+ * @param {string} [props.stoppedDetail] - stopped state: the host's actionable detail, pre-wrapped mono text behind a
+ *        "details" disclosure in the stopped box.
+ * @param {{ line: string, detail?: string, onRetry?: () => void, busy?: boolean }} [props.accessFailure] - the
+ *        collectives could not be read. "who can read it" shows the line, a retry for that read and the detail in
+ *        place of the access list and picker, and publishing stays off. The dialog's state stays the host's.
  * @param {() => void} [props.onRecover] - stopped-state prerequisite read/sign-in recovery only; may run before a scan or audience exists, but never with an explicitly refused review. Mutually exclusive with onRetry. Must not publish.
  * @param {() => void} [props.onRetry] - stopped-state actual publication retry; requires a valid review and audience. Mutually exclusive with onRecover.
  * @param {{ url: string, collectives: string[], pending?: string[], pullRequest?: { number: number, branch: string, href?: string } }} [props.done]
  */
-export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, checking, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, onRecover, onRetry, done, }: {
+export function PublishDialog({ open, onClose, title, mode, state, scan, onRescan, checking, changes, access, onRemove, onRestore, picker, autoPublish, accessSummary, primaryLabel, onPublish, onConnect, joinHref, stoppedAt, stoppedDetail, accessFailure, onRecover, onRetry, done, }: {
     open: boolean;
     onClose: () => void;
     title: string;
@@ -148,6 +159,10 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
             onSelect: () => void;
             busy?: boolean;
         };
+        note?: {
+            line: string;
+            detail?: string;
+        };
     };
     onRescan?: () => void;
     checking?: {
@@ -176,6 +191,13 @@ export function PublishDialog({ open, onClose, title, mode, state, scan, onResca
     onConnect?: () => void;
     joinHref?: string;
     stoppedAt?: string;
+    stoppedDetail?: string;
+    accessFailure?: {
+        line: string;
+        detail?: string;
+        onRetry?: () => void;
+        busy?: boolean;
+    };
     onRecover?: () => void;
     onRetry?: () => void;
     done?: {

package/dist/lib/types/Switch.d.ts

@@ -11,11 +11,13 @@
  * @property {React.ComponentType<{size?: number}>} [stateIcon] override icon for the
  *           .sw-state marker; defaults to CircleCheck (on) / Circle (off).
  * @property {string} [id]              id for the control; links the label's `for`.
+ * @property {boolean} [stateMarker=true] show the on/off word beside the switch; off where the
+ *           host already says the state (a settings row).
  */
 /**
  * @param {SwitchProps} props
  */
-export default function Switch({ checked, defaultChecked, onChange, disabled, busy, label, onText, offText, stateIcon: StateIcon, id, }: SwitchProps): import("react").JSX.Element;
+export default function Switch({ checked, defaultChecked, onChange, disabled, busy, label, onText, offText, stateIcon: StateIcon, id, stateMarker, }: SwitchProps): import("react").JSX.Element;
 export type SwitchProps = {
     /**
      * controlled on/off state; pair with onChange.
@@ -60,4 +62,9 @@ export type SwitchProps = {
      * id for the control; links the label's `for`.
      */
     id?: string;
+    /**
+     * show the on/off word beside the switch; off where the
+     * host already says the state (a settings row).
+     */
+    stateMarker?: boolean;
 };

package/dist/lib/types/analytics/format.d.ts

@@ -1,5 +1,6 @@
 /**
- * Compact token count: 1234 → "1.2k", 62_000 → "62k", 1_234_567 → "1.23M".
+ * Compact token count, the library's one count format: 1234 → "1.2k", 62_000 → "62k",
+ * 1_234_567 → "1.2M", 66_731_500_000 → "66.7B". A negative count is not a count and reads "—".
  * @param {number | null | undefined} n
  * @returns {string}
  */

package/dist/lib/types/brand-geometry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * resolve any accepted name/alias to a canonical mark key, or null when unknown.
+ * @param {string} name
+ * @returns {('claude'|'gemini'|'openai'|'cursor'|'opencode'|'strike'|'pi'|'github')|null}
+ */
+export function resolveBrand(name: string): ("claude" | "gemini" | "openai" | "cursor" | "opencode" | "strike" | "pi" | "github") | null;
+/** The view box a mark is drawn in. @param {string} key a canonical mark key */
+export function brandViewBox(key: string): string;
+/** @type {Record<string, string>} */
+export const BRAND_PATHS: Record<string, string>;
+/** @type {Record<string, string>} */
+export const BRAND_VIEW_BOX: Record<string, string>;
+export namespace BRAND_FILL_RULE {
+    let pi: string;
+}
+/** @type {Record<string, string>} */
+export const BRAND_ALIAS: Record<string, string>;
+export const WHEAT_LOGO: Readonly<{
+    viewBox: "0 0 32 32";
+    strokeWidth: 2.1;
+    paths: readonly string[];
+}>;

package/dist/lib/types/commons/providers.d.ts

@@ -4,4 +4,4 @@
 export function formatProvider(provider: unknown): string;
 /** @param {import('@peasant-labs/schema').Harness} provider */
 export function providerLabel(provider: import("@peasant-labs/schema").Harness): string;
-export const PROVIDER_LABEL: Readonly<Record<"strike" | "cursor" | "claude-code" | "gemini-cli" | "codex" | "opencode" | "antigravity" | "pi", string>>;
+export const PROVIDER_LABEL: Readonly<Record<"opencode" | "cursor" | "strike" | "pi" | "claude-code" | "gemini-cli" | "codex" | "antigravity", string>>;

package/dist/lib/types/format.d.ts

@@ -1,4 +1,35 @@
-/** Compact counts use one decimal place and lowercase magnitude suffixes. */
-export function formatCount(value: any): string;
-/** Calendar dates are stable across host locales; date-only inputs stay on their UTC day. */
-export function formatDate(value: any): string;
+/**
+ * Compact count, one decimal at most: 999 → "999", 1234 → "1.2k", 66_731_500_000 → "66.7B".
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatCount(value: unknown): string;
+/**
+ * Exact grouped integer: 272000 → "272,000". A bigint or a string of digits stays exact past the
+ * JS-safe range; any other value is rounded.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatInteger(value: unknown): string;
+/**
+ * A cost in US dollars at cents: "$0.30", "$1,234.56", "$0.00" for zero, "<$0.01" for a positive
+ * amount under one cent. Accepts the recorded decimal string as it arrives.
+ * @param {unknown} value
+ * @returns {string}
+ */
+export function formatCost(value: unknown): string;
+/**
+ * A decimal at fixed places: 0.99 → "0.99", 0.5 with 2 places → "0.50".
+ * @param {unknown} value
+ * @param {number} places
+ * @returns {string}
+ */
+export function formatDecimal(value: unknown, places: number): string;
+/**
+ * Calendar dates are stable across host locales; date-only inputs stay on their UTC day.
+ * @param {string | number | Date} value
+ * @returns {string}
+ */
+export function formatDate(value: string | number | Date): string;
+/** What every formatter shows for a missing or unreadable value. */
+export const MISSING_NUMBER: "\u2014";

package/dist/lib/types/index.d.ts

@@ -55,6 +55,7 @@ export { default as Breadcrumb, Steps } from "./Breadcrumb.jsx";
 export { default as Tooltip, Popover } from "./Tooltip.jsx";
 export { Avatar, AvatarGroup, Kbd, KbdChord, Tag } from "./Avatar.jsx";
 export { default as BrandMark, resolveBrand } from "./BrandMark.jsx";
+export { formatCount, formatInteger, formatCost, formatDecimal, MISSING_NUMBER } from "./format.js";
 export { providerAccent, providerDisplayName } from "./provider-policy.js";
 export { Skeleton, Progress, Spinner, Toast, FeedbackPanel } from "./Feedback.jsx";
 export { DataTableToolbar, DataTablePaginationControls } from "./DataTableControls.jsx";

package/dist/lib/types/share/ShareCard.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @typedef {object} PromptLine
+ * @property {string} text the line as drawn, single spaces between its words
+ * @property {boolean} breakSpace true when the line ends where the prompt has a space (the space is drawn zero wide)
+ */
+/**
+ * The prompt as drawn: whitespace collapsed to single spaces, wrapped into the layout's lines, and
+ * cut with an ellipsis where it would run past three of them.
+ * @param {string} prompt
+ * @param {boolean} fullWidth true when there is no stats column
+ * @returns {PromptLine[]}
+ */
+export function sharePromptLines(prompt: string, fullWidth: boolean): PromptLine[];
+/**
+ * The share card for a transcript link preview.
+ * @param {object} props
+ * @param {ShareCardData | null} props.card the card data, or null for a transcript that is not public
+ * @param {600 | 630} [props.height=600] 600 for X's 2:1 card (the default), 630 for every other
+ *   platform; any other value draws the 600 card
+ */
+export function ShareCard({ card, height }: {
+    card: ShareCardData | null;
+    height?: 600 | 630;
+}): import("react").JSX.Element;
+/** @typedef {import('./data.js').ShareCardData} ShareCardData */
+export const SHARE_CARD_WIDTH: 1200;
+/** X's large card is 2:1; every other platform gets 1.91:1, the same card with more background */
+export const SHARE_CARD_HEIGHTS: readonly [600, 630];
+export default ShareCard;
+export type PromptLine = {
+    /**
+     * the line as drawn, single spaces between its words
+     */
+    text: string;
+    /**
+     * true when the line ends where the prompt has a space (the space is drawn zero wide)
+     */
+    breakSpace: boolean;
+};
+export type ShareCardData = import("./data.js").ShareCardData;

package/dist/lib/types/share/data.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The chip label: the harness display name, then the model in brackets in short form. An unknown
+ * harness shows its raw value; a missing model leaves the harness name alone.
+ * @param {string | undefined} harness
+ * @param {string | undefined} model
+ * @returns {string}
+ */
+export function shareCardModelLabel(harness: string | undefined, model: string | undefined): string;
+/** @param {number} n @returns {string} 84000 -> "84k", 1200000 -> "1.2M" */
+export function formatShareCount(n: number): string;
+/**
+ * The card data for a session detail payload, or null when the payload does not parse.
+ * @param {unknown} payload
+ * @returns {ShareCardData | null}
+ */
+export function shareCardFromPayload(payload: unknown): ShareCardData | null;
+/** @param {ShareCardData} card @returns {string} */
+export function shareCardDescription(card: ShareCardData): string;
+/** @param {ShareCardData} card @returns {string} */
+export function shareCardAlt(card: ShareCardData): string;
+export type ShareCardData = {
+    /**
+     * transcript title
+     */
+    title: string;
+    /**
+     * the harness value as recorded
+     */
+    harness: string;
+    /**
+     * BrandMark key, or null when the harness is not a known provider
+     */
+    brand: string | null;
+    /**
+     * harness display name with the model in brackets, e.g. "Claude Code (Opus 5.5)"
+     */
+    chip: string;
+    /**
+     * the published text of the first user turn, or the title when it has none
+     */
+    firstPrompt: string;
+    /**
+     * true when the first user turn has no text and `firstPrompt`
+     * is the title standing in for it; the card then draws it without the "user" label (absent reads as false)
+     */
+    firstPromptIsTitle?: boolean;
+    /**
+     * both figures or neither
+     */
+    figures: {
+        prompts: number;
+        tokens: number;
+    } | null;
+};

package/dist/lib/types/share/fonts.d.ts

@@ -0,0 +1,16 @@
+/** @typedef {{ name: string, weight: 400 | 700, style: 'normal', file: string }} ShareCardFont */
+/** The family names the card's styles ask for. */
+export const SHARE_CARD_BODY_FONT: "Atkinson Hyperlegible";
+export const SHARE_CARD_MONO_FONT: "Atkinson Hyperlegible Mono";
+/**
+ * The card's faces. They cover Latin text: satori draws a CJK character or an emoji as an empty
+ * box (.notdef) unless the consumer passes its own fonts for those glyphs beside these.
+ * @type {ReadonlyArray<ShareCardFont>}
+ */
+export const SHARE_CARD_FONTS: ReadonlyArray<ShareCardFont>;
+export type ShareCardFont = {
+    name: string;
+    weight: 400 | 700;
+    style: "normal";
+    file: string;
+};

package/dist/lib/types/share/index.d.ts

@@ -0,0 +1,5 @@
+export type ShareCardData = import("./data.js").ShareCardData;
+export type ShareCardFont = import("./fonts.js").ShareCardFont;
+export { ShareCard, SHARE_CARD_WIDTH, SHARE_CARD_HEIGHTS } from "./ShareCard.jsx";
+export { shareCardFromPayload, shareCardDescription, shareCardAlt, shareCardModelLabel, formatShareCount } from "./data.js";
+export { SHARE_CARD_FONTS, SHARE_CARD_BODY_FONT, SHARE_CARD_MONO_FONT } from "./fonts.js";

package/dist/lib/types/share/marks.d.ts

@@ -0,0 +1,23 @@
+export const USER_ICON: Readonly<{
+    viewBox: "0 0 24 24";
+    strokeWidth: 2;
+    path: "M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2";
+    circle: Readonly<{
+        cx: 12;
+        cy: 7;
+        r: 4;
+    }>;
+}>;
+export const LOCK_ICON: Readonly<{
+    viewBox: "0 0 24 24";
+    strokeWidth: 2;
+    rect: Readonly<{
+        x: 3;
+        y: 11;
+        width: 18;
+        height: 11;
+        rx: 2;
+    }>;
+    path: "M7 11V7a5 5 0 0 1 10 0v4";
+}>;
+export { BRAND_FILL_RULE, BRAND_PATHS, WHEAT_LOGO, brandViewBox, resolveBrand } from "../ui/brand-geometry.js";

package/dist/lib/types/share/metrics.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The advance of one character in thousandths of an em, or null when it is outside the table.
+ * @param {number} codePoint
+ * @returns {number | null}
+ */
+export function bodyAdvance(codePoint: number): number | null;
+/** the ellipsis, U+2026 */
+export const ELLIPSIS_ADVANCE: 696;
+/** the mono bold advance of every character a count can hold */
+export const MONO_BOLD_ADVANCE: 632;

package/dist/lib/types/transcript/title.d.ts

@@ -12,6 +12,27 @@ export function unwrapUserQuery(text: string | undefined): string;
  * @returns {string}
  */
 export function cleanSessionTitle(text: string | undefined): string;
+/**
+ * The transcript page's title, the one rule the viewer's header and the share card both use: a
+ * curated title (an empty one is kept), else, when the session has no normalized evidence, the
+ * first task's prompt or the first user turn's text, else the session id, else "transcript".
+ * Session titles are often a whole first prompt, so the title is bounded to 160 characters: a
+ * longer one is cut to 159 and "…", never through a surrogate pair.
+ * @param {object} parts
+ * @param {string} [parts.title] curated session title
+ * @param {boolean} [parts.hasNormalizedEvidence] true when a title must not be inferred from a prompt
+ * @param {string} [parts.firstTaskPrompt]
+ * @param {string} [parts.firstUserContent]
+ * @param {string} [parts.id] session id
+ * @returns {string}
+ */
+export function transcriptTitle({ title, hasNormalizedEvidence, firstTaskPrompt, firstUserContent, id }: {
+    title?: string;
+    hasNormalizedEvidence?: boolean;
+    firstTaskPrompt?: string;
+    firstUserContent?: string;
+    id?: string;
+}): string;
 /**
  * Produce a short, human-readable summary of a raw prompt. Heuristic, in order:
  *   0. Drop a harness's <user_query> wrapper (cleanSessionTitle's rule).

package/dist/lib/types/ui/brand-geometry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * resolve any accepted name/alias to a canonical mark key, or null when unknown.
+ * @param {string} name
+ * @returns {('claude'|'gemini'|'openai'|'cursor'|'opencode'|'strike'|'pi'|'github')|null}
+ */
+export function resolveBrand(name: string): ("claude" | "gemini" | "openai" | "cursor" | "opencode" | "strike" | "pi" | "github") | null;
+/** The view box a mark is drawn in. @param {string} key a canonical mark key */
+export function brandViewBox(key: string): string;
+/** @type {Record<string, string>} */
+export const BRAND_PATHS: Record<string, string>;
+/** @type {Record<string, string>} */
+export const BRAND_VIEW_BOX: Record<string, string>;
+export namespace BRAND_FILL_RULE {
+    let pi: string;
+}
+/** @type {Record<string, string>} */
+export const BRAND_ALIAS: Record<string, string>;
+export const WHEAT_LOGO: Readonly<{
+    viewBox: "0 0 32 32";
+    strokeWidth: 2.1;
+    paths: readonly string[];
+}>;