@suzumiyaaoba/mdxr 0.3.0 → 0.5.0

package/dist/cli.mjs

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { Ap as splitPathLines, Cp as takeUsedIcons, Dp as fenceFilename, Fp as isRecord, Gd as reportModel, Ip as nonEmpty, Jf as isStatus, Kd as comparisonModel, Kf as STATUSES, Lp as own, Np as langForPath, Op as fenceLang, Pp as isComponent, Rp as safeHref, V as shadcnModules, Vd as calculate, Wd as REPORT_SPECS, _l as PLOT_NAMES, af as display, ap as textList, cf as parseJson, dc as queryPlanModel, df as tableRecords, fc as diagramModel, gp as numOf, hp as attrTrue, if as columnsOf, jl as PlanHeader, jp as SKIP_LANGS, kp as parseLineRange, lc as bundleModel, lf as readRecords, of as isDataRecord, pc as flameModel, qd as schemaRows, sf as numberValue, t as builtinComponents, uc as dependencyMatrixModel, uf as records, vl as plotModel, wp as DocContext, xf as parseDiff, zp as urlScheme } from "./ui-DOxuV3n8.mjs";
-import { a as loadUserModule, c as srcDir, i as importBundledCode, n as loadConfig, o as resolveModuleEntry, r as SHARED_PACKAGES, s as pkgRoot } from "./config-DhBFpSdB.mjs";
+import { $d as reportModel, Bp as splitPathLines, Cu as CLAIM_LABELS, Du as performanceDetails, Eu as RESEARCH_CLAIM_SCHEMA, Fp as parseProps, Gp as isRecord, Jp as safeHref, Kp as nonEmpty, Lp as fenceFilename, Ml as PlanHeader, Mp as takeUsedIcons, Np as DocContext, Ou as performanceResult, Qd as REPORT_SPECS, Rp as fenceLang, Tp as numOf, Tu as PERFORMANCE_TARGET_SCHEMA, Up as langForPath, V as shadcnModules, Vp as SKIP_LANGS, Wp as isComponent, Yd as calculate, Yp as urlScheme, _f as readRecords, dc as queryPlanModel, ef as comparisonModel, ep as STATUSES, fc as diagramModel, ff as columnsOf, gf as parseJson, hf as numberValue, kf as parseDiff, lc as bundleModel, mf as isDataRecord, mp as textList, np as isStatus, pc as flameModel, pf as display, pp as numList, qp as own, t as builtinComponents, tf as schemaRows, uc as dependencyMatrixModel, vf as records, vl as PLOT_NAMES, wp as attrTrue, wu as PERFORMANCE_LABELS, yf as tableRecords, yl as plotModel, zp as parseLineRange } from "./ui-k-VrmhPJ.mjs";
+import { a as loadUserModule, c as srcDir, i as importBundledCode, n as loadConfig, o as resolveModuleEntry, r as SHARED_PACKAGES, s as pkgRoot } from "./config-C-pcUAoU.mjs";
 import module from "node:module";
 import fsp, { access, readFile, readdir, writeFile } from "node:fs/promises";
 import path from "node:path";
@@ -26,6 +26,7 @@ import * as valibot from "valibot";
 import { Fragment, createElement } from "react";
 import { icons } from "@iconify-json/lucide";
 import { icons as icons$1 } from "@iconify-json/vscode-icons";
+import { differenceInCalendarDays, isValid, parseISO } from "date-fns";
 import { build } from "esbuild";
 import os from "node:os";
 import { spawn } from "node:child_process";
@@ -1000,12 +1001,14 @@ const CONTAINER_COMPONENTS = {
 	package: "Package",
 	packages: "Packages",
 	pathway: "Pathway",
+	performancetarget: "PerformanceTarget",
 	phase: "Phase",
 	piechart: "PieChart",
 	plan: "Plan",
 	quadrant: "Quadrant",
 	radar: "Radar",
 	release: "Release",
+	researchclaim: "ResearchClaim",
 	review: "Review",
 	sankey: "Sankey",
 	scatter: "Scatter",
@@ -1336,6 +1339,7 @@ const INLINE_REFERENCES = /* @__PURE__ */ new Set([
 const REFERENCE_FEATURES = /* @__PURE__ */ new Set([
 	...INLINE_REFERENCES,
 	"Source",
+	"ResearchClaim",
 	"TableOfFigures",
 	"NumberedEquation",
 	"Theorem"
@@ -1396,6 +1400,26 @@ const resolveCitation = (node, state) => {
 	ids.push(id);
 	state.backlinks.set(target, ids);
 };
+/** Claims reuse the bibliography's numbering and backlink contract. */
+const resolveClaimCitation = (node, state) => {
+	const source = jsxAttr(node, "source");
+	if (source === void 0) return;
+	const citation = {
+		attributes: [{
+			name: "source",
+			type: "mdxJsxAttribute",
+			value: source
+		}],
+		children: [],
+		name: "Cite",
+		position: node.position,
+		type: "mdxJsxTextElement"
+	};
+	resolveCitation(citation, state);
+	set(node, "citationId", jsxAttr(citation, "id") ?? "");
+	set(node, "sourceHref", jsxAttr(citation, "href") ?? "");
+	set(node, "sourceLabel", jsxAttr(citation, "label") ?? "");
+};
 const resolveCrossReference = (node, state) => {
 	const target = jsxAttr(node, "target") ?? (node.name === "TermRef" ? `term-${jsxAttr(node, "term") ?? ""}` : "");
 	const reference = state.references.get(target);
@@ -1442,6 +1466,13 @@ const addLegacyAnchor = (node) => {
 		type: "mdxJsxTextElement"
 	});
 };
+const resolveReference = (node, state) => {
+	if (node.name === "ResearchClaim") resolveClaimCitation(node, state);
+	if (node.name === "Cite") resolveCitation(node, state);
+	if (node.name === "CrossRef" || node.name === "TermRef") resolveCrossReference(node, state);
+	if (node.name === "TableOfFigures") listFigures(node, state.references);
+	addLegacyAnchor(node);
+};
 /** Two passes support forward references without changing older documents. */
 const remarkReferences = () => (tree, file) => {
 	const elements = [];
@@ -1458,12 +1489,7 @@ const remarkReferences = () => (tree, file) => {
 		sources: /* @__PURE__ */ new Map()
 	};
 	for (const node of elements) registerReference(node, state);
-	for (const node of elements) {
-		if (node.name === "Cite") resolveCitation(node, state);
-		if (node.name === "CrossRef" || node.name === "TermRef") resolveCrossReference(node, state);
-		if (node.name === "TableOfFigures") listFigures(node, state.references);
-		addLegacyAnchor(node);
-	}
+	for (const node of elements) resolveReference(node, state);
 	for (const [source, ids] of state.backlinks) {
 		const reference = state.sources.get(source);
 		if (reference) set(reference.node, "backlinks", ids.join(","));
@@ -1483,6 +1509,8 @@ const flag = (node, name) => {
 	for (const a of node.attributes) if (isRecord(a) && a.name === name) return a.value === null || a.value === true || attrTrue(a.value);
 	return false;
 };
+/** Attribute explicitly set to the string `"false"` (open="false" opt-outs). */
+const flagOff = (node, name) => attr(node, name) === "false";
 /** Numeric part of an attribute — `"120ms"` → 120. */
 const num = (node, name) => numOf(attr(node, name));
 /** Comma-separated attribute list (`labels="a,b"`). */
@@ -1501,36 +1529,29 @@ const hoistable = (c) => c.type === "paragraph" && isParent(c) && c.children.eve
 * elements hoisted out of element-only paragraphs (see `hoistable`).
 */
 const els = (node, name) => {
-	const out = [];
-	for (const c of node.children ?? []) {
-		if (isMdxEl(c)) {
-			if (name === void 0 || c.name === name) out.push(c);
-			continue;
-		}
-		if (hoistable(c)) {
-			for (const cc of c.children) if (isMdxEl(cc) && (name === void 0 || cc.name === name)) out.push(cc);
-		}
-	}
-	return out;
+	return (node.children ?? []).flatMap((c) => hoistable(c) ? c.children : [c]).filter((c) => isMdxEl(c) && (name === void 0 || c.name === name));
 };
 /**
 * `node` minus the named JSX children — direct elements removed, matching
 * elements stripped out of paragraphs (now-empty paragraphs dropped).
 */
-const withoutEls = (node, names) => ({
-	...node,
-	children: (node.children ?? []).flatMap((c) => {
-		if (isMdxEl(c)) return names.includes(c.name ?? "") ? [] : [c];
-		if (c.type === "paragraph" && isParent(c)) {
-			const kids = c.children.filter((cc) => !(isMdxEl(cc) && names.includes(cc.name ?? "")));
-			return kids.every((cc) => cc.type === "text" && "value" in cc && typeof cc.value === "string" && cc.value.trim() === "") ? [] : [{
-				...c,
-				children: kids
-			}];
-		}
-		return [c];
-	})
-});
+const withoutEls = (node, names) => {
+	const removed = new Set(names);
+	return {
+		...node,
+		children: (node.children ?? []).flatMap((c) => {
+			if (isMdxEl(c)) return removed.has(c.name ?? "") ? [] : [c];
+			if (hoistable(c)) {
+				const kids = c.children.filter((cc) => !(isMdxEl(cc) && removed.has(cc.name ?? "")));
+				return kids.every((cc) => cc.type === "text" && "value" in cc && typeof cc.value === "string" && cc.value.trim() === "") ? [] : [{
+					...c,
+					children: kids
+				}];
+			}
+			return [c];
+		})
+	};
+};
 /** All literal text under `node` (text + inlineCode values, tree order). */
 const textOf = (node) => Array.isArray(node) ? node.map(textContent$1).join("") : textContent$1(node);
 const txt = (value) => ({
@@ -1663,6 +1684,53 @@ const phrasing = (nodes) => nodes.flatMap((n) => {
 	const t = deepText([n]).trim();
 	return t === "" ? [] : [txt(t)];
 });
+const boldHtml = (node, ctx) => [strong(ctx.inline(node))];
+const emphasisHtml = (node, ctx) => [em(ctx.inline(node))];
+const deleteHtml = (node, ctx) => [del(ctx.inline(node))];
+const codeHtml = (node) => [icode(deepText(node.children ?? []))];
+const HTML_INLINE = {
+	a: (node, ctx) => {
+		const href = attr(node, "href");
+		const inner = ctx.inline(node);
+		return href === void 0 ? inner : [link(href, inner)];
+	},
+	b: boldHtml,
+	br: () => [brk()],
+	code: codeHtml,
+	del: deleteHtml,
+	em: emphasisHtml,
+	i: emphasisHtml,
+	img: (node) => {
+		return [{
+			alt: attr(node, "alt"),
+			type: "image",
+			url: attr(node, "src") ?? ""
+		}];
+	},
+	kbd: codeHtml,
+	s: deleteHtml,
+	samp: codeHtml,
+	strike: deleteHtml,
+	strong: boldHtml
+};
+/** Wrap adjacent inline nodes while retaining nested block structure. */
+const blocksOf = (nodes) => {
+	const blocks = [];
+	let inline = [];
+	for (const node of nodes) {
+		if (PHRASING.has(node.type)) {
+			inline.push(...phrasing([node]));
+			continue;
+		}
+		if (inline.length > 0) {
+			blocks.push(para(inline));
+			inline = [];
+		}
+		blocks.push(node);
+	}
+	if (inline.length > 0) blocks.push(para(inline));
+	return blocks;
+};
 /**
 * Raw HTML elements written into a document are mdxJsx elements too —
 * give the meaningful ones a markdown form (`<a>` → link, `<code>` →
@@ -1672,49 +1740,52 @@ const htmlEl = (node, ctx, inline) => {
 	const name = node.name ?? "";
 	const kids = () => phrasing(ctx.children(node));
 	const blocks = () => ctx.children(node);
-	if (name === "a") {
-		const href = attr(node, "href");
-		const inner = kids();
-		return href === void 0 ? inner : [link(href, inner)];
-	}
-	if (name === "img") return [{
-		alt: attr(node, "alt"),
-		type: "image",
-		url: attr(node, "src") ?? ""
-	}];
-	if (name === "br") return [brk()];
-	if (name === "strong" || name === "b") return [strong(kids())];
-	if (name === "em" || name === "i") return [em(kids())];
-	if (name === "del" || name === "s" || name === "strike") return [del(kids())];
-	if (name === "code" || name === "kbd" || name === "samp") return [icode(deepText(node.children ?? []))];
+	const inlineRenderer = own(HTML_INLINE, name);
+	if (inlineRenderer !== void 0) return inlineRenderer(node, ctx);
 	if (name === "hr") return [thematic()];
 	if (name === "p") return [para(kids())];
 	if (/^h[1-6]$/u.test(name)) return [heading(Number(name[1]), kids())];
 	if (name === "blockquote") return [quote(blocks())];
 	if (name === "pre") return [pre(deepText(node.children ?? []))];
 	if (name === "ul" || name === "ol") {
-		const items = els(node, "li").map((li) => item([para(phrasing(ctx.children(li)))]));
+		const items = els(node, "li").map((li) => item(blocksOf(ctx.children(li))));
 		return items.length === 0 ? blocks() : [list(items, name === "ol")];
 	}
 	return inline ? kids() : blocks();
 };
+const renderMdxElement = (node, ctx, registry) => {
+	const name = node.name ?? "";
+	const entry = own(registry, name);
+	if (entry === void 0) {
+		if (/^[a-z]/u.test(name)) return htmlEl(node, ctx, node.type === "mdxJsxTextElement");
+		ctx.warn(name);
+		return ctx.children(node);
+	}
+	if (node.type === "mdxJsxTextElement") return entry.text?.(node, ctx) ?? phrasing(entry.flow?.(node, ctx) ?? ctx.children(node));
+	if (entry.flow !== void 0) return entry.flow(node, ctx);
+	const inlineOut = entry.text?.(node, ctx);
+	return inlineOut === void 0 ? ctx.children(node) : [para(inlineOut)];
+};
 /** Replace every mdxJsx element under `root` with its ASCII representation. */
 const transformAscii = (root, registry, serialize, warn) => {
 	const transformElement = (n, ctx) => {
-		if (isMdxEl(n)) {
-			const name = n.name ?? "";
-			const entry = own(registry, name);
-			if (entry === void 0) {
-				if (/^[a-z]/u.test(name)) return htmlEl(n, ctx, n.type === "mdxJsxTextElement");
-				warn(name);
-				return ctx.children(n);
+		if (isMdxEl(n)) return renderMdxElement(n, ctx, registry);
+		if (isParent(n)) {
+			if (hoistable(n)) {
+				const children = n.children.filter(isMdxEl).map((child) => ({
+					...child,
+					type: "mdxJsxFlowElement"
+				}));
+				return blocksOf(ctx.children({
+					...n,
+					children
+				}));
 			}
-			if (n.type === "mdxJsxTextElement") return entry.text?.(n, ctx) ?? phrasing(entry.flow?.(n, ctx) ?? ctx.children(n));
-			if (entry.flow !== void 0) return entry.flow(n, ctx);
-			const inlineOut = entry.text?.(n, ctx);
-			return inlineOut === void 0 ? ctx.children(n) : [para(inlineOut)];
+			return [{
+				...n,
+				children: ctx.children(n)
+			}];
 		}
-		if (isParent(n)) n.children = ctx.children(n);
 		return [n];
 	};
 	const transformNodes = (nodes, ctx) => nodes.flatMap((node) => {
@@ -1784,7 +1855,7 @@ const STATUS_ICON = {
 	unverified: "?",
 	up: "✓"
 };
-const statusIcon = (status) => status === void 0 ? "•" : STATUS_ICON[status.toLowerCase()] ?? "•";
+const statusIcon = (status) => status === void 0 ? "•" : own(STATUS_ICON, status.toLowerCase()) ?? "•";
 /** Left-align `s` in a `width`-wide column (no padding past the width). */
 const pad = (s, width) => s.length >= width ? s : s + " ".repeat(width - s.length);
 //#endregion
@@ -1796,6 +1867,11 @@ const suffix = (parts) => {
 };
 /** Bare `a · b · c` joining (no leading separator). */
 const joined = (parts) => parts.filter(nonEmpty).join(" · ");
+/** A disclosure with literal summary text and an already serialized body. */
+const detailsBlock = (summary, body) => {
+	const escaped = summary.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+	return html(`<details>\n<summary>${escaped}</summary>\n\n${body.trim()}\n\n</details>`);
+};
 /**
 * `**Title — extra**` caption paragraph, emitted only when something is
 * there. A title-less caption drops a leading ` — `/space so `extra` alone
@@ -1824,7 +1900,7 @@ const tally$1 = (entries, key) => {
 //#endregion
 //#region src/ascii/charts.ts
 /** Attribute → number list (`values="12, 8, 4"`). */
-const nums = (node, key) => csv(node, key).map(Number).filter((v) => !Number.isNaN(v));
+const nums = (node, key) => numList(attr(node, key));
 /** `label ██████░░ 42` fence rows from name/value pairs. */
 const barRows = (rows, max) => {
 	const W = 24;
@@ -2190,7 +2266,7 @@ const term = (node, ctx) => [para([strong([txt(attr(node, "name") ?? "")]), ...c
 const details = (node, ctx) => {
 	const summary = attr(node, "summary") ?? "Details";
 	const body = ctx.serialize(ctx.children(node)).trim();
-	return [html(`<details>\n<summary>${summary}</summary>\n\n${body}\n\n</details>`)];
+	return [detailsBlock(summary, body)];
 };
 const documentRenderers = {
 	Callout: { flow: (n, ctx) => {
@@ -2286,7 +2362,7 @@ const nodeRows = (node) => {
 	if (grid && isParent(grid)) return tableRecords(grid.children.map((row) => isParent(row) ? row.children.map(textOf) : []));
 	return els(node, "RecordItem").map(nodeAttributes);
 };
-const recordsTable = (rows, cols) => rows.length ? [table(cols ?? columnsOf(rows), rows.map((row) => (cols ?? columnsOf(rows)).map((key) => display(row[key]) || "—")))] : [para([txt("No data")])];
+const recordsTable = (rows, cols) => rows.length ? [table(cols ?? columnsOf(rows), rows.map((row) => (cols ?? columnsOf(rows)).map((key) => display(own(row, key)) || "—")))] : [para([txt("No data")])];
 const narrative = (node, ctx) => {
 	if (attr(node, "data") !== void 0) return ctx.children(node);
 	const children = node.children?.filter((child) => {
@@ -2411,14 +2487,14 @@ Object.assign(extendedRenderers, {
 		"pnpm",
 		"yarn",
 		"bun"
-	].map((manager) => `${manager} ${manager === "npm" ? "install" : "add"}${attr(node, "dev") === "true" ? " -D" : ""} ${attr(node, "packages") ?? ""}`).join("\n"), "sh")] },
+	].map((manager) => `${manager} ${manager === "npm" ? "install" : "add"}${flag(node, "dev") ? " -D" : ""} ${attr(node, "packages") ?? ""}`).join("\n"), "sh")] },
 	PageBreak: { flow: () => [{ type: "thematicBreak" }] },
 	PdfPreview: { flow: (node) => sourceLink(node, "src", `${attr(node, "title") ?? "PDF document"} (page ${attr(node, "page") ?? "1"})`) },
 	PrintLayout: { flow: (node, ctx) => ctx.children(node) },
 	PromptTemplate: { flow: (node) => {
 		const rows = nodeRows(node);
 		const defaults = Object.fromEntries(rows.map((row) => [display(row.name), display(row.value)]));
-		const prompt = (attr(node, "template") ?? "").replaceAll(/\{\{\s*(?<variable>[\w.-]+)\s*\}\}/gu, (match, name) => defaults[name] ?? match);
+		const prompt = (attr(node, "template") ?? "").replaceAll(/\{\{\s*(?<variable>[\w.-]+)\s*\}\}/gu, (match, name) => own(defaults, name) ?? match);
 		return [
 			...caption(attr(node, "title") ?? "Prompt template"),
 			...recordsTable(rows),
@@ -2534,28 +2610,20 @@ const numbered = (entries, statusKey, ctx) => list(entries.map((e) => item([para
 ])])), true);
 const NOTE_RE = /\s+(?:—|#)\s+/u;
 const PLACEHOLDER_RE = /^(?:\.{3}|…)$/u;
-const treeEntries = (nodes) => {
-	const out = [];
-	const walk = (n) => {
-		if (n.type === "list" && isParent(n)) {
-			for (const li of n.children) {
-				if (li.type !== "listItem" || !isParent(li)) continue;
-				const nested = li.children.filter((c) => c.type === "list");
-				const labelText = li.children.filter((c) => c.type !== "list").map((c) => textOf(c)).join("").trim();
-				const m = NOTE_RE.exec(labelText);
-				out.push({
-					children: treeEntries(nested),
-					name: (m === null ? labelText : labelText.slice(0, m.index)).trim(),
-					...m === null ? {} : { note: labelText.slice(m.index + m[0].length).trim() }
-				});
-			}
-			return;
-		}
-		if (isParent(n)) for (const c of n.children) walk(c);
+const treeEntry = (node, children) => {
+	const label = node.children.filter((child) => child.type !== "list").map(textOf).join("").trim();
+	const note = NOTE_RE.exec(label);
+	return {
+		children,
+		name: (note === null ? label : label.slice(0, note.index)).trim(),
+		...note === null ? {} : { note: label.slice(note.index + note[0].length).trim() }
 	};
-	for (const c of nodes) walk(c);
-	return out;
 };
+const treeEntries = (nodes) => nodes.flatMap((node) => {
+	if (!isParent(node)) return [];
+	if (node.type === "list") return node.children.filter((child) => child.type === "listItem" && isParent(child)).map((child) => treeEntry(child, treeEntries(child.children.filter((nested) => nested.type === "list"))));
+	return treeEntries(node.children);
+});
 const treeLines = (entries, prefix) => entries.flatMap((e, i) => {
 	const last = i === entries.length - 1;
 	const name = PLACEHOLDER_RE.test(e.name) ? "…" : e.name;
@@ -2652,14 +2720,18 @@ const investigationRenderers = {
 		...nonEmpty(attr(n, "path")) ? [txt(" — "), icode(pathAt(n))] : [],
 		...ctx.inline(n).length === 0 ? [] : [txt(": "), ...ctx.inline(n)]
 	])] },
-	Hypotheses: { flow: (n, ctx) => [...caption(attr(n, "title")), list(els(n, "Hypothesis").map((h) => {
-		const status = (attr(h, "status") ?? "untested").toLowerCase();
-		return item([para([
-			txt(`${statusIcon(status)} `),
-			...nonEmpty(attr(h, "title")) ? [strong([txt(attr(h, "title") ?? "")])] : [],
-			...ctx.inline(h).length === 0 ? [] : [txt(" — "), ...ctx.inline(h)]
-		]), ...ctx.children(withoutEls(n, ["Hypothesis"]))], status === "supported" ? true : void 0);
-	}))] },
+	Hypotheses: { flow: (n, ctx) => [
+		...caption(attr(n, "title")),
+		list(els(n, "Hypothesis").map((h) => {
+			const status = (attr(h, "status") ?? "untested").toLowerCase();
+			return item([para([
+				txt(`${statusIcon(status)} `),
+				...nonEmpty(attr(h, "title")) ? [strong([txt(attr(h, "title") ?? "")])] : [],
+				...ctx.inline(h).length === 0 ? [] : [txt(" — "), ...ctx.inline(h)]
+			])], status === "supported" ? true : void 0);
+		})),
+		...ctx.children(withoutEls(n, ["Hypothesis"]))
+	] },
 	Hypothesis: { flow: (n, ctx) => [para([txt(`${statusIcon(attr(n, "status"))} `), ...nonEmpty(attr(n, "title")) ? [strong([txt(attr(n, "title") ?? "")])] : []]), ...ctx.children(n)] },
 	Prop: { flow: (n, ctx) => [para([
 		icode(attr(n, "name") ?? ""),
@@ -2784,12 +2856,13 @@ const comment = (node, ctx) => {
 const graph = (node, ctx) => {
 	const nodes = els(node, "Node");
 	const edges = els(node, "Edge");
+	const connected = new Set(edges.flatMap((edge) => [attr(edge, "from"), attr(edge, "to")]));
 	const nodeNotes = nodes.flatMap((nd) => {
 		const label = attr(nd, "label");
 		const note = attr(nd, "note");
 		const path = attr(nd, "path");
 		const status = attr(nd, "status");
-		if ((label === void 0 || label === attr(nd, "id")) && note === void 0 && path === void 0 && status === void 0) return [];
+		if ((label === void 0 || label === attr(nd, "id")) && note === void 0 && path === void 0 && status === void 0 && connected.has(attr(nd, "id"))) return [];
 		const head = [
 			icode(attr(nd, "id") ?? ""),
 			txt(" = "),
@@ -2912,9 +2985,10 @@ const waterfall = (node, ctx) => {
 	const title = attr(node, "title");
 	if (nonEmpty(title)) lines.push(`${title}  (0 → ${total}${unit})`);
 	for (const s of spans) {
-		const from = Math.round(s.start / Math.max(1, total) * W);
-		const len = Math.max(1, Math.round(s.duration / Math.max(1, total) * W));
-		const cells = `${" ".repeat(Math.min(W, from))}${"█".repeat(Math.min(len, W - from))}`;
+		const scale = Math.max(1, total);
+		const from = Math.max(0, Math.min(W, Math.round(s.start / scale * W)));
+		const to = Math.max(from, Math.min(W, Math.round((s.start + Math.max(0, s.duration)) / scale * W)));
+		const cells = `${" ".repeat(from)}${"█".repeat(to - from)}`;
 		lines.push(`${pad(s.name, nameW)} ${cells} ${s.durationRaw || `${s.duration}${unit}`}${nonEmpty(s.note) ? `  ${s.note}` : ""}`);
 	}
 	return [pre(lines.join("\n")), ...ctx.children(withoutEls(node, ["Span"]))];
@@ -2970,6 +3044,7 @@ const outputRenderers = {
 };
 //#endregion
 //#region src/ascii/planning.ts
+/** ASCII renderers for planning & status components. */
 /** `owner` attr → a normalized `@name` chip (leading `@`s collapsed). */
 const ownerChip = (node) => {
 	const owner = attr(node, "owner");
@@ -3009,8 +3084,8 @@ const approvalStatus = (s) => {
 const DAY_MS = 864e5;
 const dayOf = (iso) => {
 	if (iso === void 0) return;
-	const t = Date.parse(iso);
-	return Number.isNaN(t) ? void 0 : Math.floor(t / DAY_MS);
+	const date = parseISO(iso);
+	return isValid(date) ? differenceInCalendarDays(date, new Date(1970, 0, 1)) : void 0;
 };
 const TASK_CHAR = {
 	blocked: "▒",
@@ -3018,56 +3093,75 @@ const TASK_CHAR = {
 	done: "█",
 	todo: "░"
 };
+const GANTT_WIDTH = 40;
+const ganttTasks = (node) => els(node, "Task").flatMap((el) => {
+	const start = dayOf(attr(el, "start"));
+	if (start === void 0) return [];
+	return [{
+		el,
+		end: Math.max(start, dayOf(attr(el, "end")) ?? start),
+		name: attr(el, "name") ?? "",
+		progress: num(el, "progress"),
+		start,
+		status: (attr(el, "status") ?? "todo").toLowerCase()
+	}];
+});
+const ganttMilestones = (node) => els(node, "Milestone").flatMap((el) => {
+	const date = dayOf(attr(el, "date"));
+	return date === void 0 ? [] : [{
+		date,
+		el,
+		name: attr(el, "name") ?? ""
+	}];
+});
+const ganttRange = (node, tasks, milestones) => {
+	const start = dayOf(attr(node, "start"));
+	const end = dayOf(attr(node, "end"));
+	let first = start ?? Math.min(...tasks.map((task) => task.start), ...milestones.map((milestone) => milestone.date));
+	let last = end ?? Math.max(...tasks.map((task) => task.end), ...milestones.map((milestone) => milestone.date));
+	if (last < first) {
+		if (end !== void 0 && start === void 0) first = last;
+		else last = first;
+	}
+	return {
+		first,
+		last
+	};
+};
+const ganttColumn = (day, range) => Math.max(0, Math.min(GANTT_WIDTH, Math.round((day - range.first) / (range.last - range.first + 1) * GANTT_WIDTH)));
+const ganttTaskLine = (task, range, nameWidth) => {
+	const from = ganttColumn(task.start, range);
+	const to = Math.max(from + 1, ganttColumn(task.end + 1, range));
+	const outside = task.end < range.first || task.start > range.last;
+	const glyph = own(TASK_CHAR, task.status) ?? "░";
+	const filled = (to - from) * Math.min(100, Math.max(0, task.progress ?? 0)) / 100;
+	const cells = Array.from({ length: GANTT_WIDTH }, (_, i) => {
+		if (outside || i < from || i >= to) return " ";
+		return i - from < filled ? "█" : glyph;
+	}).join("");
+	const tail = joined([ownerChip(task.el), attr(task.el, "note")]);
+	return `${pad(task.name, nameWidth)} ${cells}${tail === "" ? "" : `  ${tail}`}`;
+};
+const ganttMilestoneLine = (milestone, range, nameWidth) => {
+	const position = milestone.date < range.first || milestone.date > range.last ? -1 : Math.min(39, ganttColumn(milestone.date, range));
+	const cells = Array.from({ length: GANTT_WIDTH }, (_, i) => i === position ? "◆" : " ").join("");
+	const tail = joined([attr(milestone.el, "status"), attr(milestone.el, "note")]);
+	return `${pad(milestone.name, nameWidth)} ${cells}${tail === "" ? "" : `  ${tail}`}`;
+};
 const gantt = (node, ctx) => {
-	const tasks = els(node, "Task").flatMap((t) => {
-		const start = dayOf(attr(t, "start"));
-		return start === void 0 ? [] : [{
-			el: t,
-			end: dayOf(attr(t, "end")) ?? start,
-			name: attr(t, "name") ?? "",
-			progress: num(t, "progress"),
-			start,
-			status: (attr(t, "status") ?? "todo").toLowerCase()
-		}];
-	});
-	const milestones = els(node, "Milestone").flatMap((m) => {
-		const date = dayOf(attr(m, "date"));
-		return date === void 0 ? [] : [{
-			date,
-			el: m,
-			name: attr(m, "name") ?? ""
-		}];
-	});
+	const tasks = ganttTasks(node);
+	const milestones = ganttMilestones(node);
 	if (tasks.length === 0 && milestones.length === 0) return ctx.children(node);
-	const lo = dayOf(attr(node, "start")) ?? Math.min(...tasks.map((t) => t.start), ...milestones.map((m) => m.date));
-	const hi = dayOf(attr(node, "end")) ?? Math.max(...tasks.map((t) => t.end + 1), ...milestones.map((m) => m.date + 1));
-	const span = Math.max(1, hi - lo);
-	const W = 40;
-	const at = (day) => Math.max(0, Math.min(W, Math.round((day - lo) / span * W)));
-	const nameW = Math.min(24, Math.max(8, ...tasks.map((t) => t.name.length), ...milestones.map((m) => m.name.length)));
-	const iso = (d) => (/* @__PURE__ */ new Date(d * DAY_MS)).toISOString().slice(0, 10);
-	const lines = [];
+	const range = ganttRange(node, tasks, milestones);
+	const nameWidth = Math.min(24, Math.max(8, ...tasks.map((task) => task.name.length), ...milestones.map((milestone) => milestone.name.length)));
+	const iso = (day) => (/* @__PURE__ */ new Date(day * DAY_MS)).toISOString().slice(0, 10);
 	const title = attr(node, "title");
-	if (nonEmpty(title)) lines.push(title);
-	lines.push(`${pad("", nameW)} ${iso(lo)} → ${iso(hi)}`);
-	for (const t of tasks) {
-		const from = at(t.start);
-		const to = Math.max(from + 1, at(t.end + 1));
-		const cells = Array.from({ length: W }, (_, i) => {
-			if (i < from || i >= to) return " ";
-			const ch = TASK_CHAR[t.status] ?? "░";
-			if (t.progress === void 0 || t.progress <= 0) return ch;
-			return i - from < (to - from) * Math.min(100, t.progress) / 100 ? "█" : ch;
-		}).join("");
-		const owner = attr(t.el, "owner");
-		const tail = joined([nonEmpty(owner) ? `@${owner.replace(/^@+/u, "")}` : void 0, attr(t.el, "note")]);
-		lines.push(`${pad(t.name, nameW)} ${cells}${tail === "" ? "" : `  ${tail}`}`);
-	}
-	for (const m of milestones) {
-		const cells = Array.from({ length: W }, (_, i) => i === at(m.date) ? "◆" : " ").join("");
-		const tail = joined([attr(m.el, "status"), attr(m.el, "note")]);
-		lines.push(`${pad(m.name, nameW)} ${cells}${tail === "" ? "" : `  ${tail}`}`);
-	}
+	const lines = [
+		...nonEmpty(title) ? [title] : [],
+		`${pad("", nameWidth)} ${iso(range.first)} → ${iso(range.last)}`,
+		...tasks.map((task) => ganttTaskLine(task, range, nameWidth)),
+		...milestones.map((milestone) => ganttMilestoneLine(milestone, range, nameWidth))
+	];
 	return [pre(lines.join("\n")), ...ctx.children(withoutEls(node, ["Task", "Milestone"]))];
 };
 const CELL_GLYPH = {
@@ -3103,7 +3197,7 @@ const CELL_GLYPH = {
 };
 const matrixCell = (cell) => {
 	const key = cell.trim().toLowerCase();
-	return key === "" ? "—" : CELL_GLYPH[key] ?? cell.trim();
+	return key === "" ? "—" : own(CELL_GLYPH, key) ?? cell.trim();
 };
 /** `- label | a | b` list items → matrix rows. */
 const matrixRows = (node) => {
@@ -3135,12 +3229,16 @@ const planningRenderers = {
 		attr(a, "role"),
 		attr(a, "status"),
 		attr(a, "date")
-	])], []))), ...ctx.children(withoutEls(n, ["Approval"]))] },
+	])], ctx.children(a)))), ...ctx.children(withoutEls(n, ["Approval"]))] },
 	Board: { flow: (n, ctx) => [
 		...caption(attr(n, "title")),
 		...els(n, "Lane").flatMap((lane) => {
 			const cards = els(lane, "BoardCard");
-			return [para([txt(`${statusIcon(attr(lane, "status"))} `), strong([txt(`${attr(lane, "title") ?? ""} (${cards.length})`)])]), list(cards.map((c) => boardCard(c, ctx)))];
+			return [
+				para([txt(`${statusIcon(attr(lane, "status"))} `), strong([txt(`${attr(lane, "title") ?? ""} (${cards.length})`)])]),
+				list(cards.map((c) => boardCard(c, ctx))),
+				...ctx.children(withoutEls(lane, ["BoardCard"]))
+			];
 		}),
 		...ctx.children(withoutEls(n, ["Lane"]))
 	] },
@@ -3202,11 +3300,11 @@ const planningRenderers = {
 		])],
 		text: (n) => [strong([txt(attr(n, "value") ?? "")]), txt(` ${attr(n, "label") ?? ""}`)]
 	},
-	Stats: { flow: (n) => [list(els(n, "Stat").map((s) => item([para([
+	Stats: { flow: (n, ctx) => [list(els(n, "Stat").map((s) => item([para([
 		strong([txt(attr(s, "value") ?? "")]),
 		txt(` ${attr(s, "label") ?? ""}`),
 		...nonEmpty(attr(s, "delta")) ? [txt(` (${attr(s, "delta")})`)] : []
-	])])))] },
+	])]))), ...ctx.children(withoutEls(n, ["Stat"]))] },
 	StatusBadge: { text: (n) => [icode(attr(n, "status") ?? "")] },
 	Step: { flow: (n, ctx) => [para([
 		txt(`${statusIcon(attr(n, "status"))} `),
@@ -3269,7 +3367,7 @@ const VERDICT_LABEL = {
 	pass: "Passed",
 	warn: "Warning"
 };
-const verdictLabel = (s) => s === void 0 ? void 0 : VERDICT_LABEL[s.toLowerCase()] ?? s;
+const verdictLabel = (s) => s === void 0 ? void 0 : own(VERDICT_LABEL, s.toLowerCase()) ?? s;
 const DURATION_MS = {
 	h: 36e5,
 	m: 6e4,
@@ -3318,9 +3416,14 @@ const DAY_CELL = {
 const uptimeStrip = (node) => {
 	const days = els(node, "Day");
 	if (days.length === 0) return "";
-	return days.map((d) => DAY_CELL[(attr(d, "status") ?? "up").toLowerCase()] ?? "█").join("");
+	return days.map((d) => own(DAY_CELL, (attr(d, "status") ?? "up").toLowerCase()) ?? "█").join("");
+};
+const percentText = (value) => nonEmpty(value) && !value.endsWith("%") ? `${value}%` : value;
+const serviceRow = (node, ctx) => statusItem$1(attr(node, "status"), [txt(attr(node, "name") ?? ""), ...suffix([attr(node, "status"), percentText(attr(node, "uptime"))])], ctx.children(node));
+const releaseVersion = (node) => {
+	const version = attr(node, "version") ?? "";
+	return version.startsWith("v") ? version : `v${version}`;
 };
-const serviceRow = (node) => statusItem$1(attr(node, "status"), [txt(attr(node, "name") ?? ""), ...suffix([attr(node, "status"), nonEmpty(attr(node, "uptime")) ? `${attr(node, "uptime")}%` : void 0])], []);
 const entryRow = (node, ctx) => {
 	const scope = attr(node, "scope");
 	return item([para([
@@ -3368,7 +3471,7 @@ const reportRenderers = {
 					attr(b, "before") ?? "",
 					attr(b, "after") ?? "",
 					d,
-					attr(b, "note") ?? ctx.text(b)
+					joined([attr(b, "note"), ctx.text(b)])
 				];
 			})),
 			...ctx.children(withoutEls(n, ["Bench"]))
@@ -3439,7 +3542,8 @@ const reportRenderers = {
 			"field",
 			"type",
 			"flags",
-			"default"
+			"default",
+			"description"
 		], els(n, "DbField").map((f) => {
 			const flags = [
 				flag(f, "pk") ? "pk" : void 0,
@@ -3451,7 +3555,8 @@ const reportRenderers = {
 				[icode(attr(f, "name") ?? "")],
 				[icode(attr(f, "type") ?? "")],
 				flags,
-				attr(f, "default") ?? ""
+				attr(f, "default") ?? "",
+				ctx.text(f)
 			];
 		})),
 		...ctx.children(withoutEls(n, ["DbField"]))
@@ -3464,7 +3569,7 @@ const reportRenderers = {
 	EnvVar: { flow: (n, ctx) => [para([
 		icode(attr(n, "name") ?? ""),
 		...flag(n, "required") ? [txt(" "), icode("required")] : [],
-		...suffix([flag(n, "secret") ? "secret" : attr(n, "value"), nonEmpty(attr(n, "default")) ? `default ${attr(n, "default")}` : void 0]),
+		...suffix([flag(n, "secret") ? "secret" : attr(n, "value"), !flag(n, "secret") && nonEmpty(attr(n, "default")) ? `default ${attr(n, "default")}` : void 0]),
 		...ctx.inline(n).length === 0 ? [] : [txt(" — "), ...ctx.inline(n)]
 	])] },
 	EnvVars: { flow: (n, ctx) => [
@@ -3479,7 +3584,7 @@ const reportRenderers = {
 			[icode(attr(e, "name") ?? "")],
 			flag(e, "required") ? "yes" : "",
 			flag(e, "secret") ? "•••" : attr(e, "value") ?? "",
-			attr(e, "default") ?? "",
+			flag(e, "secret") ? "•••" : attr(e, "default") ?? "",
 			ctx.text(e)
 		])),
 		...ctx.children(withoutEls(n, ["EnvVar"]))
@@ -3553,7 +3658,7 @@ const reportRenderers = {
 			attr(p, "version") ?? "",
 			attr(p, "kind") ?? "",
 			attr(p, "license") ?? "",
-			ctx.text(p)
+			joined([attr(p, "note"), ctx.text(p)])
 		])),
 		...ctx.children(withoutEls(n, ["Package"]))
 	] },
@@ -3563,17 +3668,17 @@ const reportRenderers = {
 		...ctx.children(withoutEls(n, ["Stop"]))
 	] },
 	Release: { flow: (n, ctx) => [
-		heading(3, [...nonEmpty(attr(n, "href")) ? [link(attr(n, "href") ?? "", [txt(`v${attr(n, "version") ?? ""}`)])] : [icode(`v${attr(n, "version") ?? ""}`)], ...nonEmpty(attr(n, "title")) ? [txt(` — ${attr(n, "title")}`)] : []]),
+		heading(3, [...nonEmpty(attr(n, "href")) ? [link(attr(n, "href") ?? "", [txt(releaseVersion(n))])] : [icode(releaseVersion(n))], ...nonEmpty(attr(n, "title")) ? [txt(` — ${attr(n, "title")}`)] : []]),
 		...nonEmpty(attr(n, "date")) ? [para([em([txt(attr(n, "date") ?? "")])])] : [],
 		...els(n, "Entry").length === 0 ? ctx.children(n) : [list(els(n, "Entry").map((e) => entryRow(e, ctx))), ...ctx.children(withoutEls(n, ["Entry"]))]
 	] },
 	Review: { flow: (n, ctx) => [...caption(attr(n, "title"), `${nonEmpty(attr(n, "verdict")) ? ` — ${verdictLabel(attr(n, "verdict"))}` : ""}${tally$1(els(n, "Comment"), "severity")}`), ...ctx.children(n)] },
 	Schema: { flow: (n, ctx) => [...caption(attr(n, "title"), nonEmpty(attr(n, "engine")) ? ` (${attr(n, "engine")})` : ""), ...ctx.children(n)] },
-	Service: { flow: (n) => [para([
+	Service: { flow: (n, ctx) => [para([
 		txt(`${statusIcon(attr(n, "status"))} `),
 		txt(attr(n, "name") ?? ""),
-		...suffix([attr(n, "status"), nonEmpty(attr(n, "uptime")) ? `${attr(n, "uptime")}%` : void 0])
-	])] },
+		...suffix([attr(n, "status"), percentText(attr(n, "uptime"))])
+	]), ...ctx.children(n)] },
 	Severity: { text: (n) => [icode((attr(n, "level") ?? "").toUpperCase())] },
 	StatusPage: { flow: (n, ctx) => {
 		const services = els(n, "Service");
@@ -3588,7 +3693,7 @@ const reportRenderers = {
 					...suffix([[attr(u, "from"), attr(u, "to")].filter(nonEmpty).join(" → ")])
 				]), ...strip === "" ? [] : [pre(strip)]];
 			}),
-			...services.length === 0 ? [] : [list(services.map(serviceRow))],
+			...services.length === 0 ? [] : [list(services.map((service) => serviceRow(service, ctx)))],
 			...ctx.children(withoutEls(n, ["Service", "Uptime"]))
 		];
 	} },
@@ -3622,6 +3727,48 @@ const reportRenderers = {
 	]), ...ctx.children(n)] }
 };
 //#endregion
+//#region src/ascii/research.ts
+const attributes = (node, names) => Object.fromEntries(names.map((name) => [name, attr(node, name)]));
+const researchRenderers = {
+	PerformanceTarget: { flow: (node, ctx) => {
+		const props = parseProps(PERFORMANCE_TARGET_SCHEMA, attributes(node, [
+			"actual",
+			"better",
+			"conditions",
+			"measuredAt",
+			"name",
+			"statistic",
+			"status",
+			"target",
+			"unit"
+		]), "PerformanceTarget");
+		return [
+			...caption(props.name, ` — ${PERFORMANCE_LABELS[performanceResult(props)]}`),
+			table(["Field", "Value"], performanceDetails(props)),
+			...ctx.children(node)
+		];
+	} },
+	ResearchClaim: { flow: (node, ctx) => {
+		const props = parseProps(RESEARCH_CLAIM_SCHEMA, attributes(node, [
+			"checked",
+			"citationId",
+			"id",
+			"kind",
+			"source",
+			"sourceHref",
+			"sourceLabel",
+			"title"
+		]), "ResearchClaim");
+		return [
+			...caption(props.title, ` — ${CLAIM_LABELS[props.kind]}`),
+			...ctx.children(node),
+			...props.source === void 0 || props.citationId === void 0 ? [] : [html(`<a id="${props.citationId.replaceAll("&", "&amp;").replaceAll("\"", "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;")}"></a>`)],
+			...props.source === void 0 ? [] : [para([txt("Source: "), link(props.sourceHref ?? `#${props.source}`, [txt(props.sourceLabel ?? props.source)])])],
+			...props.checked === void 0 ? [] : [para([txt(`Checked: ${props.checked}`)])]
+		];
+	} }
+};
+//#endregion
 //#region src/ascii/shadcn.ts
 /** `ctx.inline` result wrapped so empty children fall back to `alt`. */
 const inlineOr = (node, ctx, alt) => {
@@ -3661,33 +3808,39 @@ const menuItem = {
 	text: (n, ctx) => ctx.inline(n)
 };
 /** `[x]`/`[ ]`/`( )` control from a checked-ish attribute. */
+const controlOn = (n) => {
+	if (flag(n, "checked") || flagOff(n, "checked")) return flag(n, "checked");
+	return flag(n, "defaultChecked") || flag(n, "pressed");
+};
 const control = (mark) => ({
 	flow: (n, ctx) => {
 		const inner = ctx.inline(n);
 		const label = attr(n, "label");
 		return [para([
-			icode(mark(flag(n, "checked") || flag(n, "defaultChecked") || flag(n, "pressed"))),
+			icode(mark(controlOn(n))),
 			...inner.length === 0 ? [] : [txt(" "), ...inner],
 			...nonEmpty(label) ? [txt(` ${label}`)] : []
 		])];
 	},
-	text: (n, ctx) => [icode(mark(flag(n, "checked") || flag(n, "defaultChecked") || flag(n, "pressed"))), ...ctx.inline(n).length === 0 ? [] : [txt(" "), ...ctx.inline(n)]]
+	text: (n, ctx) => [icode(mark(controlOn(n))), ...ctx.inline(n).length === 0 ? [] : [txt(" "), ...ctx.inline(n)]]
 });
 /** `` `[____]` ``-style empty input stand-in. */
+const inputText = (n) => {
+	const value = attr(n, "value") ?? attr(n, "defaultValue");
+	if (value !== void 0) return attr(n, "type") === "password" ? "••••" : value;
+	return attr(n, "placeholder") ?? attr(n, "label") ?? "____";
+};
 const input = {
-	flow: (n) => [pre(`[ ${attr(n, "placeholder") ?? attr(n, "value") ?? attr(n, "label") ?? "____"} ]`)],
-	text: (n) => [icode(`[${attr(n, "placeholder") ?? attr(n, "value") ?? attr(n, "label") ?? "____"}]`)]
+	flow: (n) => [pre(`[ ${inputText(n)} ]`)],
+	text: (n) => [icode(`[${inputText(n)}]`)]
 };
 /** `<details>` disclosure — summary from AccordionTrigger/collapsible label. */
 const disclosure = (trigger, fallback) => ({ flow: (n, ctx) => {
 	const [head] = els(n, trigger);
 	const summary = head === void 0 ? attr(n, "label") ?? fallback : ctx.text(head);
-	const rest = ctx.children({
-		...n,
-		children: (n.children ?? []).filter((c) => !named(c, trigger))
-	});
+	const rest = ctx.children(withoutEls(n, [trigger]));
 	const body = ctx.serialize(rest).trim();
-	return [html(`<details>\n<summary>${summary}</summary>\n\n${body}\n\n</details>`)];
+	return [detailsBlock(summary, body)];
 } });
 /** `<Tabs>` → `**tab**` headings + content sections. */
 const tabs = { flow: (n, ctx) => {
@@ -3762,7 +3915,7 @@ const frac = (n) => {
 	const max = num(n, "max") ?? 100;
 	return {
 		text: `${attr(n, "value") ?? Math.round(value)}${nonEmpty(attr(n, "max")) ? `/${attr(n, "max")}` : "%"}`,
-		v: max === 0 ? 0 : Math.min(1, value / max)
+		v: max <= 0 ? 0 : Math.max(0, Math.min(1, value / max))
 	};
 };
 const progress = {
@@ -3813,7 +3966,7 @@ const otp = {
 		return [pre(`[ ${"_ ".repeat(count).trim()} ]`)];
 	},
 	text: (n) => {
-		const count = num(n, "maxLength") ?? 6;
+		const count = Math.max(0, num(n, "maxLength") ?? 6);
 		return [icode(`[${"_".repeat(count)}]`)];
 	}
 };
@@ -4015,6 +4168,7 @@ const asciiRenderers = {
 	...investigationRenderers,
 	...outputRenderers,
 	...reportRenderers,
+	...researchRenderers,
 	...chartRenderers,
 	...layoutRenderers,
 	...formRenderers,
@@ -4091,50 +4245,54 @@ const mdxToAscii = async (source, filePath = "document.mdx") => {
 };
 //#endregion
 //#region src/catalog.ts
+const OPTIONAL_TYPES = /* @__PURE__ */ new Set([
+	"exact_optional",
+	"nullish",
+	"optional"
+]);
+const describeLiteral = (value) => {
+	if (typeof value === "bigint") return `${value}n`;
+	return JSON.stringify(value) ?? String(value);
+};
+const pipeConstraint = (schema) => {
+	if (!Array.isArray(schema.pipe)) return;
+	return schema.pipe.find((s) => isRecord(s) && (s.type === "picklist" || s.type === "union" || s.type === "literal"));
+};
 /** Structural view of a valibot schema — enough for catalog introspection. */
 const describeSchema = (schema) => {
 	if (!isRecord(schema)) return "unknown";
-	if (schema.type === "array") return `${describeSchema(schema.item)}[]`;
-	if (schema.type === "literal") return JSON.stringify(schema.literal);
-	if (schema.type === "picklist" && Array.isArray(schema.options)) return schema.options.map((o) => JSON.stringify(o)).join(" | ");
-	if (schema.type === "union" && Array.isArray(schema.options)) return schema.options.map(describeSchema).join(" | ");
-	if (Array.isArray(schema.pipe)) {
-		const constrained = schema.pipe.find((s) => isRecord(s) && (s.type === "picklist" || s.type === "union" || s.type === "literal"));
-		if (constrained !== void 0) return describeSchema(constrained);
+	switch (schema.type) {
+		case "nullable":
+		case "nullish": return `${describeSchema(schema.wrapped)} | null`;
+		case "optional":
+		case "exact_optional": return describeSchema(schema.wrapped);
+		case "array": {
+			const item = describeSchema(schema.item);
+			return item.includes(" | ") ? `(${item})[]` : `${item}[]`;
+		}
+		case "literal": return describeLiteral(schema.literal);
+		case "picklist":
+		case "union": if (Array.isArray(schema.options)) {
+			const describe = schema.type === "picklist" ? describeLiteral : describeSchema;
+			return schema.options.map(describe).join(" | ");
+		}
 	}
+	const constrained = pipeConstraint(schema);
+	if (constrained !== void 0) return describeSchema(constrained);
 	return typeof schema.type === "string" ? schema.type : "unknown";
 };
-const WRAPPER_TYPES = /* @__PURE__ */ new Set([
-	"nullable",
-	"nullish",
-	"optional"
-]);
-const unwrapProp = (raw) => {
-	let s = isRecord(raw) ? raw : {};
-	let required = true;
-	let def;
-	while (typeof s.type === "string" && WRAPPER_TYPES.has(s.type)) {
-		required = false;
-		def ??= s.default;
-		s = isRecord(s.wrapped) ? s.wrapped : {};
-	}
-	return {
-		def,
-		required,
-		s
-	};
-};
 const propsOf = (schema) => {
 	if (!isRecord(schema) || !isRecord(schema.entries)) return {};
 	const out = {};
 	for (const [key, raw] of Object.entries(schema.entries)) {
-		const { def, required, s } = unwrapProp(raw);
+		const optional = isRecord(raw) && typeof raw.type === "string" && OPTIONAL_TYPES.has(raw.type);
+		const def = optional ? raw.default : void 0;
 		Object.defineProperty(out, key, {
 			configurable: true,
 			enumerable: true,
 			value: {
-				required,
-				type: describeSchema(s),
+				required: !optional,
+				type: describeSchema(raw),
 				...def === void 0 ? {} : { default: def }
 			},
 			writable: true
@@ -4883,14 +5041,16 @@ const iconSets = (usedIcons) => ({
 */
 const scanVProps = (stripped, alias) => {
 	const esc = alias.replaceAll(/[$()*+.?[\\\]^{|}]/gu, "\\$&");
-	const access = new RegExp(`\\b${esc}\\s*\\?\\.\\s*(\\w+)|\\b${esc}\\s*\\.\\s*(\\w+)`, "gu");
+	const identifierPart = String.raw`[\p{ID_Continue}$\u200C\u200D]`;
+	const start = `(?<!${identifierPart})${esc}`;
+	const access = new RegExp(`${start}\\s*\\??\\.\\s*(\\w+)`, "gu");
 	const props = /* @__PURE__ */ new Set();
 	for (const use of stripped.matchAll(access)) {
-		const prop = use[1] ?? use[2];
+		const [, prop] = use;
 		if (prop !== void 0) props.add(prop);
 	}
 	const leftover = stripped.replaceAll(access, "");
-	return new RegExp(`\\b${esc}\\b`, "u").test(leftover) ? "all" : props;
+	return new RegExp(`${start}(?!${identifierPart})`, "u").test(leftover) ? "all" : props;
 };
 /**
 * `/* … *\/` and `// …` are legal inside a multiline import clause, and a
@@ -5633,6 +5793,20 @@ const BASE_CSS = `
 .task-list-item { list-style: none; }
 ul.contains-task-list { padding-left: 1.25rem; }
 .task-list-item input[type='checkbox'] { margin-right: 0.4em; }
+/* Graph fitting is native SVG sizing: readable minimum scale on screen,
+ * full-width containment in print, and a keyboard-operable actual-size toggle. */
+.mdxr-graph-view:has(.mdxr-graph-actual:checked) .mdxr-graph-image {
+  max-width: none !important;
+}
+.mdxr-graph-tools:focus-within { outline: 2px solid rgb(14 165 233); outline-offset: -2px; }
+@media print {
+  .mdxr-graph-tools { display: none; }
+  .mdxr-graph-scroll { overflow: visible; }
+  .mdxr-graph-view:has(.mdxr-graph-actual:checked) .mdxr-graph-image,
+  .mdxr-graph-view .mdxr-graph-image {
+    max-width: 100% !important; min-width: 0 !important; height: auto !important;
+  }
+}
 /* --- Interaction feedback -------------------------------------------
  * Every [data-copy] button carries an idle and a done icon
  * (.mdxr-copy-idle/.mdxr-copy-done); the delegated event handler
@@ -5909,7 +6083,7 @@ details[open] > summary .mdxr-chev { transform: rotate(90deg); }
 .dark .mdxr-toc-body > ul > li > a { color: rgb(212 212 212); }
 .mdxr-toc-body > ul > li > p > a::before,
 .mdxr-toc-body > ul > li > a::before {
-  content: counter(mdxr-toc); min-width: 1em;
+  content: counter(mdxr-toc); min-width: 1em; flex-shrink: 0; white-space: nowrap;
   font-size: 0.72rem; font-weight: 400; font-variant-numeric: tabular-nums;
   color: rgb(163 163 163);
 }
@@ -5921,6 +6095,27 @@ details[open] > summary .mdxr-chev { transform: rotate(90deg); }
 }
 .dark .mdxr-toc-body ul ul { border-color: rgb(64 64 64); }
 .mdxr-toc-body ul ul a { font-size: 0.8125rem; padding: 0.2rem 0.45rem; }
+/* A 64rem viewport fits the usual 45rem article, a 14rem ToC, a 2rem
+ * gap, and 1.5rem outer gutters. Only the first document-level ToC docks;
+ * additional or nested tables stay in the document flow. Print stays inline. */
+@media screen and (min-width: 64rem) {
+  #mdxr-root:has(> .mdxr-toc, > article:only-of-type > .mdxr-toc) {
+    max-width: 64rem;
+    padding-right: 17.5rem;
+  }
+  #mdxr-root > .mdxr-toc:nth-child(1 of .mdxr-toc),
+  #mdxr-root:not(:has(> .mdxr-toc)) > article:only-of-type > .mdxr-toc:nth-child(1 of .mdxr-toc) {
+    position: fixed;
+    top: 4rem;
+    right: max(1.5rem, calc((100vw - 64rem) / 2 + 1.5rem));
+    width: 14rem;
+    max-height: calc(100dvh - 5.5rem);
+    margin: 0;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    overflow-wrap: anywhere;
+  }
+}
 /* Ask: native form controls stay interactive without hydration. The real
  * inputs are visually hidden; state is styled through :checked/~ siblings. */
 .mdxr-choice {