@peasant-labs/fairtrade 0.0.40 → 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/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/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[];
+}>;

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

@@ -0,0 +1,35 @@
+/**
+ * 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/ui/provider-policy.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Validate an untrusted provider value before it enters canonical display APIs.
+ * @param {unknown} harness
+ * @param {string} operation
+ * @returns {asserts harness is Harness}
+ */
+export function assertHarness(harness: unknown, operation: string): asserts harness is Harness;
+/** @param {Harness} harness @returns {string} */
+export function providerDisplayName(harness: Harness): string;
+/** @param {Harness} harness @returns {ProviderBrand} */
+export function providerBrand(harness: Harness): ProviderBrand;
+/** @param {Harness} harness @returns {ProviderAccent} */
+export function providerAccent(harness: Harness): ProviderAccent;
+/** @typedef {import('@peasant-labs/schema').Harness} Harness */
+/** @typedef {'claude'|'gemini'|'openai'|'opencode'|'cursor'|'strike'|'pi'} ProviderBrand */
+/** @typedef {'amber'|'teal'|'olive'|'mauve'|'clay'} ProviderAccent */
+/** @type {readonly Harness[]} */
+export const PROVIDER_HARNESSES: readonly Harness[];
+/** @type {Readonly<Record<Harness, string>>} */
+export const PROVIDER_DISPLAY_NAMES: Readonly<Record<Harness, string>>;
+/** @type {Readonly<Record<Harness, ProviderBrand>>} */
+export const PROVIDER_BRANDS: Readonly<Record<Harness, ProviderBrand>>;
+/** @type {Readonly<Record<Harness, ProviderAccent>>} */
+export const PROVIDER_ACCENTS: Readonly<Record<Harness, ProviderAccent>>;
+export type Harness = import("@peasant-labs/schema").Harness;
+export type ProviderBrand = "claude" | "gemini" | "openai" | "opencode" | "cursor" | "strike" | "pi";
+export type ProviderAccent = "amber" | "teal" | "olive" | "mauve" | "clay";

package/dist/lib/types/ui/transcript/adapter.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Is this wire turn one of Claude Code's session metadata records rather than conversation?
+ * @param {TurnDetail} turn
+ * @param {string | undefined} harness  the session's harness
+ * @returns {boolean}
+ */
+export function isSessionMetadataTurn(turn: TurnDetail, harness: string | undefined): boolean;
+/**
+ * Default turn prefilter the adapter applies independently per partition:
+ * preserve normalized evidence, including unknown provenance and folded refs.
+ * Only truly legacy rows lose empty/short banners or collapse equal adjacent
+ * content, preferring the tool-bearing copy. Pure, order-preserving. Exported
+ * so a host that pre-scopes turns can run the SAME filter.
+ * @param {TurnDetail[]} turns
+ * @returns {TurnDetail[]}
+ */
+export function prefilterTurns(turns: TurnDetail[]): TurnDetail[];
+/**
+ * Project the canonical wire payload (folded turns) into the cooked
+ * `TranscriptViewModel` every dumb transcript component renders. The SOLE
+ * wire-parse + legacy-git normalisation site.
+ *
+ * @param {TranscriptWireInput} payload          canonical wire plus legacy git compatibility
+ * @param {AnnotationSummary[]} [annotations]     separately-fetched entry annotations
+ * @param {TranscriptAnalyticsVM} [analytics]     precomputed analytics; else derived on demand
+ * @param {AdaptTranscriptOptions} [options]      optional post-resolution visible-turn projection
+ * @returns {TranscriptViewModel}
+ */
+export function adaptTranscript(payload: TranscriptWireInput, annotations?: AnnotationSummary[], analytics?: TranscriptAnalyticsVM, options?: AdaptTranscriptOptions): TranscriptViewModel;
+export { diffLines };
+export type TranscriptWireInput = import("./wire-types.js").TranscriptWireInput;
+export type SessionDetailPayload = import("./wire-types.js").SessionDetailPayload;
+export type TurnDetail = import("./wire-types.js").TurnDetail;
+export type ToolCallDetail = import("./wire-types.js").ToolCallDetail;
+export type AnnotationSummary = import("./wire-types.js").AnnotationSummary;
+export type CommitInfo = import("./wire-types.js").CommitInfo;
+export type LegacyCommit = import("./wire-types.js").LegacyCommit;
+export type LegacyGitContext = import("./wire-types.js").LegacyGitContext;
+export type TranscriptViewModel = import("./view-model.js").TranscriptViewModel;
+export type TranscriptAnalyticsVM = import("./view-model.js").TranscriptAnalyticsVM;
+export type SessionVM = import("./view-model.js").SessionVM;
+export type SessionGitVM = import("./view-model.js").SessionGitVM;
+export type CommitVM = import("./view-model.js").CommitVM;
+export type TurnVM = import("./view-model.js").TurnVM;
+export type TaskGroupVM = import("./view-model.js").TaskGroupVM;
+export type ToolCallVM = import("./view-model.js").ToolCallVM;
+export type ToolGroup = import("./view-model.js").ToolGroup;
+export type DiffLineVM = import("./view-model.js").DiffLineVM;
+export type DiffHunkVM = import("./view-model.js").DiffHunkVM;
+export type DiffEntryVM = import("./view-model.js").DiffEntryVM;
+export type FileEntryVM = import("./view-model.js").FileEntryVM;
+export type AnnotationVM = import("./view-model.js").AnnotationVM;
+export type HighlightVM = import("./view-model.js").HighlightVM;
+export type FilterIndexVM = import("./view-model.js").FilterIndexVM;
+export type PhaseVM = import("./view-model.js").PhaseVM;
+export type AdaptTranscriptOptions = {
+    /**
+     * post-resolution projection by canonical turn index
+     */
+    visibleTurnIndices?: readonly number[];
+    /**
+     * separately authorized read metadata; never durable content
+     */
+    relationshipNavigation?: import("@peasant-labs/schema").SessionRelationshipNavigation[];
+};
+import { diffLines } from './adapter.parse.js';

package/dist/lib/types/ui/transcript/adapter.parse.d.ts

@@ -0,0 +1,103 @@
+/** @typedef {import('./wire-types.js').ToolCallDetail} ToolCallDetail */
+/** @typedef {import('./view-model.js').DiffLineVM} DiffLineVM */
+/**
+ * The SOLE `JSON.parse` of a wire-encoded tool string in the lifted code. Every
+ * other parse helper here, the adapter, and the analytics util route through it,
+ * so a grep for `JSON.parse` of tool args/result yields exactly one hit. Returns
+ * `undefined` for empty or malformed input — callers degrade rather than throw.
+ *
+ * @param {string | undefined | null} raw
+ * @returns {unknown}
+ */
+export function parseJson(raw: string | undefined | null): unknown;
+/**
+ * Parse a tool call's `arguments` JSON string. Thin named entry point over the
+ * one `parseJson` site; the cooked `ToolCallVM.args` is this value (shape varies
+ * by tool, hence `unknown`).
+ * @param {string | undefined | null} raw
+ * @returns {unknown}
+ */
+export function parseArgs(raw: string | undefined | null): unknown;
+/**
+ * Parse a tool call's `result` JSON string. Thin named entry point over the one
+ * `parseJson` site; the cooked `ToolCallVM.output` is this value.
+ * @param {string | undefined | null} raw
+ * @returns {unknown}
+ */
+export function parseResult(raw: string | undefined | null): unknown;
+/**
+ * Extract the file path a tool call targets, preferring the wire `filePath`
+ * field and falling back to the common `file_path` / `path` / `notebook_path`
+ * argument keys. Consolidates the THREE duplicate `extractPath` definitions
+ * (tasks.ts, FilesView.tsx, file-rollup.ts) into one.
+ * @param {ToolCallDetail} call
+ * @returns {string | undefined}
+ */
+export function extractPath(call: ToolCallDetail): string | undefined;
+/**
+ * One old→new replacement inside an Edit / MultiEdit / NotebookEdit call.
+ * @typedef {object} EditPair
+ * @property {string} old_string
+ * @property {string} new_string
+ */
+/**
+ * The list of old→new replacements for an edit-family tool call: the `edits[]`
+ * array for MultiEdit, else the single `old_string` / `new_string` pair. Used by
+ * BOTH the diff-hunk builder (adapter) and the churn counter (`countDiff`), so
+ * the argument shape is parsed in exactly one place.
+ * @param {ToolCallDetail} call
+ * @returns {EditPair[]}
+ */
+export function editPairs(call: ToolCallDetail): EditPair[];
+/**
+ * The full-file body a Write tool call lays down (its `content` argument).
+ * @param {ToolCallDetail} call
+ * @returns {string}
+ */
+export function writeContent(call: ToolCallDetail): string;
+/**
+ * Dependency-free line diff (LCS) → cooked `DiffLineVM[]`. fairtrade ships no
+ * `diff` package, so the adapter computes hunks itself. Line numbers are 1-based
+ * within the supplied snippet (the wire carries the edit snippet, not the file
+ * offset). Deterministic — no clock/randomness — so it is screenshot-stable.
+ * @param {string} oldText
+ * @param {string} newText
+ * @returns {DiffLineVM[]}
+ */
+export function diffLines(oldText: string, newText: string): DiffLineVM[];
+/**
+ * The cooked line diff of an edit-family or write tool call (one line list per replaced span) and
+ * its churn: the + and − lines of that same diff, so a rewrite of three lines counts +3 −3 and every
+ * count (the tool call, the diffs tab, a task's churn) agrees with the lines it heads. A span's
+ * trailing empty line is the newline artifact, not a line anyone wrote, so it is not counted, as the
+ * renderer does not show it. Undefined for any other kind, or an edit with no replacement. Memoised
+ * per call object, because the adapter and the analytics both ask and the line diff is quadratic in
+ * the span length.
+ * @param {ToolCallDetail} call
+ * @returns {{ spans: DiffLineVM[][], adds: number, dels: number } | undefined}
+ */
+export function callDiff(call: ToolCallDetail): {
+    spans: DiffLineVM[][];
+    adds: number;
+    dels: number;
+} | undefined;
+/**
+ * Lines inserted / removed for an edit-family or write tool call: the churn of `callDiff`, zero
+ * for any other kind. Consolidates the THREE duplicate `countDiff` definitions. Pure: depends only
+ * on the parsed arguments, never a clock or the file system.
+ * @param {ToolCallDetail} call
+ * @returns {{ adds: number, dels: number }}
+ */
+export function countDiff(call: ToolCallDetail): {
+    adds: number;
+    dels: number;
+};
+export type ToolCallDetail = import("./wire-types.js").ToolCallDetail;
+export type DiffLineVM = import("./view-model.js").DiffLineVM;
+/**
+ * One old→new replacement inside an Edit / MultiEdit / NotebookEdit call.
+ */
+export type EditPair = {
+    old_string: string;
+    new_string: string;
+};