pagegraph 0.11.0 → 0.13.0

package/dist/document-CztEu3Vd.d.ts

@@ -0,0 +1,109 @@
+import { m as Register } from "./graph-D1PIndsC.js";
+import { f as Message, h as SectionItem, m as SectionDocument, o as Facts, p as PageDocument, u as BodyEntry } from "./page-heads-BfjWQvau.js";
+import { D as SectionKind } from "./index-C5w9ripz.js";
+import { ComponentPropsWithRef, ReactNode } from "react";
+//#region src/react/document.d.ts
+/** Augment with `facts: typeof facts` to check Fact ids across the application. */
+type FactId = Register extends {
+  facts: infer F extends Facts;
+} ? Extract<keyof F, string> : string;
+type MutableSection = Omit<SectionDocument, "title" | "body" | "items"> & {
+  title?: Message;
+  body: Array<BodyEntry>;
+  items: Array<MutableItem>;
+};
+type MutableItem = Omit<SectionItem, "title" | "href" | "body" | "cells"> & {
+  title?: Message;
+  href?: string;
+  body: Array<BodyEntry>;
+  cells: Array<Message>;
+};
+interface Collector {
+  path: string;
+  site: string;
+  facts?: Facts;
+  sectionCount: number;
+  sections: Array<MutableSection>;
+  messages: Array<Message>;
+  records: Map<string, () => void>;
+  links: Set<MutableItem>;
+  completed: boolean;
+}
+declare const CaptureRequest: import("react").Context<Collector | undefined>;
+interface ChildrenProps {
+  children?: ReactNode;
+  source?: string;
+}
+interface FactProps {
+  id: FactId;
+  list?: boolean;
+}
+declare function createCollector(options: {
+  path: string;
+  site: string;
+  facts?: Facts;
+}): Collector;
+/** Mark the page body; ancestor layouts remain outside the captured document. */
+declare function DocumentProvider({ collector: supplied, children }: {
+  collector?: Collector;
+  children: ReactNode;
+}): import("react").JSX.Element;
+/** Static text for head()/JSON-LD; use format: "markdown" to retain inline marks. */
+declare function messageText(node: ReactNode, options?: {
+  format?: "text" | "markdown";
+  facts?: Facts;
+  site?: string;
+  path?: string;
+}): string;
+declare function T({ children, source }: ChildrenProps): import("react").JSX.Element;
+/**
+ * Mark an inline heading in place without adding markup. Capture assigns it to the nearest
+ * Section.Item, otherwise Section, and records one title message instead of body text.
+ * Accepts the same inline children as T. A title prop or another Title on that owner is an error.
+ */
+declare function Title({ children, source }: ChildrenProps): import("react").JSX.Element;
+declare function Fact({ id, list }: FactProps): import("react").JSX.Element;
+declare function ItemRoot(props: ChildrenProps & {
+  /** Capture-only heading; use Title to mark a visible heading in place. */
+  title?: ReactNode;
+}): import("react").JSX.Element;
+declare function SectionRoot({ evidence, kind, id, title, language, children, source }: ChildrenProps & {
+  kind: string | SectionKind;
+  id: string;
+  evidence?: boolean;
+  /** Capture-only heading; use Title to mark a visible heading in place. */
+  title?: ReactNode;
+  language?: string;
+}): import("react").JSX.Element;
+/**
+ * Render the card's anchor and record its destination on the enclosing Section.Item.
+ * Use `createLink(Section.Item.Link)` for TanStack navigation: Router supplies the resolved href,
+ * including params, search and hash, so the page and twin share one destination.
+ * Anchor props and refs pass through. An item may contain only one such link;
+ * capture rejects missing or disabled destinations.
+ */
+declare function ItemLink(props: ComponentPropsWithRef<"a">): import("react").JSX.Element;
+declare const Section: typeof SectionRoot & {
+  Item: typeof ItemRoot & {
+    Link: typeof ItemLink;
+  };
+};
+/**
+ * Render children unchanged outside capture. Under DocumentProvider, children never render or record;
+ * describe is the only twin output, and omitting it contributes nothing to the twin.
+ */
+declare function Visual({ describe, children, source }: ChildrenProps & {
+  describe?: string;
+}): import("react").JSX.Element | null;
+declare function ForAgents(props: ChildrenProps): import("react").JSX.Element;
+declare function ForHumans(props: ChildrenProps): import("react").JSX.Element;
+declare function finishDocument(collector: Collector, metadata: {
+  title: string;
+  description: string;
+}, html: string): PageDocument;
+declare function useCapturePage(): string | undefined;
+/** Host for TanStack createLink: capture receives the same resolved anchor props as normal SSR. */
+declare function CaptureAnchor(props: ComponentPropsWithRef<"a">): import("react").JSX.Element;
+//#endregion
+export { Fact as a, ForHumans as c, Title as d, Visual as f, useCapturePage as g, messageText as h, DocumentProvider as i, Section as l, finishDocument as m, CaptureRequest as n, FactId as o, createCollector as p, Collector as r, ForAgents as s, CaptureAnchor as t, T as u };
+//# sourceMappingURL=document-CztEu3Vd.d.ts.map

package/dist/document-Dvemcv7V.js

@@ -0,0 +1,379 @@
+import { a as RESERVED_SECTION_ID_PREFIX, n as inlineMarkdown, o as hashDocument, r as plainText, s as contentHash, t as documentLinkHref } from "./inline-BbS93GAT.js";
+import { i as resolveFact } from "./facts-1OKclPOk.js";
+import { useRouter } from "@tanstack/react-router";
+import { createContext, isValidElement, useContext, useId, useMemo } from "react";
+import { Fragment as Fragment$1, jsx, jsxs } from "react/jsx-runtime";
+//#region src/react/document.tsx
+const CaptureRequest = createContext(void 0);
+const Capture = createContext(void 0);
+function CaptureProvider({ collector, section, item, audience, suppress, link, children }) {
+	const value = useMemo(() => ({
+		collector,
+		...section === void 0 ? {} : { section },
+		...item === void 0 ? {} : { item },
+		audience,
+		suppress,
+		...link === void 0 ? {} : { link }
+	}), [
+		collector,
+		section,
+		item,
+		audience,
+		suppress,
+		link
+	]);
+	return /* @__PURE__ */ jsx(Capture.Provider, {
+		value,
+		children
+	});
+}
+function createCollector(options) {
+	return {
+		...options,
+		sectionCount: 0,
+		sections: [],
+		messages: [],
+		records: /* @__PURE__ */ new Map(),
+		links: /* @__PURE__ */ new Set(),
+		completed: false
+	};
+}
+/** Mark the page body; ancestor layouts remain outside the captured document. */
+function DocumentProvider({ collector: supplied, children }) {
+	const request = useContext(CaptureRequest);
+	const router = useRouter({ warn: false });
+	if (import.meta.env?.DEV && router !== null && router !== void 0) {
+		const match = router.stores.matches.get().at(-1);
+		if (match !== void 0 && match.staticData.markdown !== "rendered") throw new Error(`DocumentProvider on ${match.pathname} requires staticData.markdown: "rendered"; declare it on the page route.`);
+	}
+	const collector = supplied ?? request;
+	if (collector === void 0) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	return /* @__PURE__ */ jsx(CaptureProvider, {
+		collector,
+		audience: "all",
+		suppress: false,
+		children
+	});
+}
+function record(context, id, apply) {
+	context.collector.records.set(id, apply);
+	return /* @__PURE__ */ jsx("template", { "data-document-record": id });
+}
+const sourceOf = (source) => source ?? "<inline>:1";
+function elementProps(node) {
+	return node.props;
+}
+function factProps(node) {
+	const props = node.props;
+	if (typeof props !== "object" || props === null || !("id" in props) || typeof props.id !== "string") throw new Error("Fact requires an id");
+	return {
+		id: props.id,
+		..."list" in props && props.list === true ? { list: true } : {}
+	};
+}
+/** Sanitize without executing components: identity is authored text, inline marks and fact ids. */
+function inlineTree(node, options = {}) {
+	if (node === void 0 || node === null || typeof node === "boolean") return [];
+	if (typeof node === "string" || typeof node === "number") return [String(node)];
+	if (Array.isArray(node)) return node.flatMap((child) => inlineTree(child, options));
+	if (!isValidElement(node)) throw new Error("T only accepts text, em, strong, a, code, br, and Fact");
+	if (node.type === T) return inlineTree(elementProps(node).children, options);
+	if (node.type === Fact) {
+		const { id, list } = factProps(node);
+		const definition = resolveFact(id, options.facts);
+		if (list && definition.kind !== "list") throw new Error(`Fact "${id}" is not a list`);
+		return [{
+			fact: id,
+			text: definition.text
+		}];
+	}
+	const tag = node.type;
+	if (tag !== "em" && tag !== "strong" && tag !== "a" && tag !== "code" && tag !== "br") throw new Error(`T only accepts text, em, strong, a, code, br, and Fact; found ${typeof tag === "string" ? tag : "a component"}`);
+	const props = elementProps(node);
+	const href = tag === "a" ? props.href : void 0;
+	if (tag === "a" && typeof href !== "string") throw new Error("An anchor in T needs a string href");
+	return [{
+		tag,
+		...href === void 0 ? {} : { href: documentLinkHref(href, options.site === void 0 ? void 0 : new URL(options.path ?? "/", options.site)) },
+		children: inlineTree(props.children, options)
+	}];
+}
+function authoredTree(tree) {
+	return tree.map((node) => typeof node === "string" ? node : "fact" in node ? { fact: node.fact } : {
+		tag: node.tag,
+		...node.href === void 0 ? {} : { href: node.href },
+		children: authoredTree(node.children)
+	});
+}
+/** Static text for head()/JSON-LD; use format: "markdown" to retain inline marks. */
+function messageText(node, options = {}) {
+	const tree = inlineTree(isValidElement(node) && node.type === Title ? node.props.children : node, options);
+	return options.format === "markdown" ? inlineMarkdown(tree) : plainText(tree);
+}
+function messageFor(node, source, context) {
+	const options = context.collector;
+	const linkedContent = context.link === void 0 || context.link === context.item?.href ? node : /* @__PURE__ */ jsx("a", {
+		href: context.link,
+		children: node
+	});
+	const tree = inlineTree(linkedContent, options);
+	const authored = inlineTree(linkedContent, options.facts === void 0 ? {} : { facts: options.facts });
+	const refs = /* @__PURE__ */ new Set();
+	const visit = (nodes) => {
+		for (const child of nodes) if (typeof child !== "string") if ("fact" in child) refs.add(child.fact);
+		else visit(child.children);
+	};
+	visit(tree);
+	return {
+		hash: contentHash(authoredTree(authored)).slice(0, 16),
+		tree,
+		text: plainText(tree),
+		source: sourceOf(source),
+		facts: [...refs],
+		audience: context.audience
+	};
+}
+function append(context, entry) {
+	if (context.item !== void 0) {
+		context.item.body.push(entry);
+		if (entry.type === "message") context.item.cells.push(entry.message);
+	} else if (context.section !== void 0) context.section.body.push(entry);
+	else {
+		let section = context.collector.sections.at(-1);
+		if (section?.kind !== `for-${context.audience}`) {
+			section = {
+				kind: `for-${context.audience}`,
+				id: `for-${context.audience}-${context.collector.sections.length}`,
+				body: [],
+				items: [],
+				source: entry.type === "message" ? entry.message.source : entry.source,
+				audience: context.audience
+			};
+			context.collector.sections.push(section);
+		}
+		section.body.push(entry);
+	}
+}
+function T({ children, source }) {
+	const id = useId();
+	const context = useContext(Capture);
+	if (context === void 0 || context.suppress) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	const message = messageFor(children, source, context);
+	const marker = record(context, id, () => {
+		context.collector.messages.push(message);
+		append(context, {
+			type: "message",
+			message
+		});
+	});
+	return /* @__PURE__ */ jsxs(Fragment$1, { children: [marker, children] });
+}
+/**
+* Mark an inline heading in place without adding markup. Capture assigns it to the nearest
+* Section.Item, otherwise Section, and records one title message instead of body text.
+* Accepts the same inline children as T. A title prop or another Title on that owner is an error.
+*/
+function Title({ children, source }) {
+	const id = useId();
+	const context = useContext(Capture);
+	if (context === void 0 || context.suppress) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	const title = messageFor(children, source, context);
+	const marker = record(context, id, () => {
+		if (context.section === void 0) throw new Error(`Title outside Section on ${context.collector.path}`);
+		const owner = context.item ?? context.section;
+		if (owner.title !== void 0) throw new Error(`Duplicate document title for ${context.item === void 0 ? `Section "${context.section.id}"` : `Section.Item at ${context.item.source}`} on ${context.collector.path}; use a title prop or one Title`);
+		owner.title = title;
+		context.collector.messages.push(title);
+		if (context.item !== void 0) context.item.cells.unshift(title);
+	});
+	return /* @__PURE__ */ jsxs(CaptureProvider, {
+		...context,
+		suppress: true,
+		children: [marker, children]
+	});
+}
+function Fact({ id, list }) {
+	const context = useContext(Capture);
+	const definition = resolveFact(id, context?.collector.facts);
+	if (list && definition.kind !== "list") throw new Error(`Fact "${id}" is not a list`);
+	return /* @__PURE__ */ jsx(Fragment$1, { children: definition.text });
+}
+function ItemRoot(props) {
+	const key = useId();
+	const { title, children, source } = props;
+	const context = useContext(Capture);
+	if (context === void 0 || context.suppress) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	if ("href" in props) throw new Error(`Section.Item does not accept href on ${context.collector.path}; render Section.Item.Link instead`);
+	if (context.section === void 0) throw new Error(`Section.Item outside Section on ${context.collector.path}`);
+	const item = {
+		body: [],
+		cells: [],
+		source: sourceOf(source),
+		audience: context.audience
+	};
+	const heading = title === void 0 ? void 0 : messageFor(title, isValidElement(title) ? title.props.source ?? source : source, {
+		...context,
+		item
+	});
+	if (heading !== void 0) {
+		item.title = heading;
+		item.cells.push(heading);
+	}
+	const marker = record(context, key, () => {
+		context.section?.items.push(item);
+		if (heading !== void 0) context.collector.messages.push(heading);
+	});
+	return /* @__PURE__ */ jsxs(CaptureProvider, {
+		...context,
+		item,
+		children: [marker, children]
+	});
+}
+function SectionRoot({ evidence, kind, id, title, language, children, source }) {
+	const key = useId();
+	const context = useContext(Capture);
+	if (context === void 0 || context.suppress) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	const heading = title === void 0 ? void 0 : messageFor(title, isValidElement(title) ? title.props.source ?? source : source, context);
+	const section = {
+		...evidence === void 0 ? {} : { evidence },
+		kind: typeof kind === "string" ? kind : kind.kind,
+		id,
+		...heading === void 0 ? {} : { title: heading },
+		...language === void 0 ? {} : { language },
+		body: [],
+		items: [],
+		source: sourceOf(source),
+		audience: context.audience
+	};
+	const marker = record(context, key, () => {
+		if (id.startsWith("__pagegraph:")) throw new Error(`Document Section id "${id}" on ${context.collector.path} uses reserved prefix "${RESERVED_SECTION_ID_PREFIX}"`);
+		if (context.collector.sections.some((entry) => entry.id === id)) throw new Error(`Duplicate document Section id "${id}" on ${context.collector.path}`);
+		context.collector.sectionCount++;
+		context.collector.sections.push(section);
+		if (heading !== void 0) context.collector.messages.push(heading);
+	});
+	return /* @__PURE__ */ jsxs(CaptureProvider, {
+		collector: context.collector,
+		section,
+		audience: context.audience,
+		suppress: false,
+		children: [marker, children]
+	});
+}
+/**
+* Render the card's anchor and record its destination on the enclosing Section.Item.
+* Use `createLink(Section.Item.Link)` for TanStack navigation: Router supplies the resolved href,
+* including params, search and hash, so the page and twin share one destination.
+* Anchor props and refs pass through. An item may contain only one such link;
+* capture rejects missing or disabled destinations.
+*/
+function ItemLink(props) {
+	return /* @__PURE__ */ jsx(CapturedAnchor, {
+		...props,
+		itemLink: true
+	});
+}
+const Item = Object.assign(ItemRoot, { Link: ItemLink });
+const Section = Object.assign(SectionRoot, { Item });
+/**
+* Render children unchanged outside capture. Under DocumentProvider, children never render or record;
+* describe is the only twin output, and omitting it contributes nothing to the twin.
+*/
+function Visual({ describe, children, source }) {
+	const id = useId();
+	const context = useContext(Capture);
+	if (context === void 0) return /* @__PURE__ */ jsx(Fragment$1, { children });
+	if (context.suppress || describe === void 0) return null;
+	return record(context, id, () => append(context, {
+		type: "visual",
+		text: describe,
+		source: sourceOf(source),
+		audience: context.audience
+	}));
+}
+function AudienceContent({ audience, children }) {
+	const context = useContext(Capture);
+	if (context === void 0) return audience === "agents" ? null : /* @__PURE__ */ jsx(Fragment$1, { children });
+	return /* @__PURE__ */ jsx(CaptureProvider, {
+		...context,
+		audience,
+		children
+	});
+}
+function ForAgents(props) {
+	return /* @__PURE__ */ jsx(AudienceContent, {
+		...props,
+		audience: "agents"
+	});
+}
+function ForHumans(props) {
+	return /* @__PURE__ */ jsx(AudienceContent, {
+		...props,
+		audience: "humans"
+	});
+}
+function finishDocument(collector, metadata, html) {
+	if (collector.completed) throw new Error(`Document capture already completed for ${collector.path}`);
+	collector.completed = true;
+	collector.sections.length = 0;
+	collector.messages.length = 0;
+	collector.sectionCount = 0;
+	collector.links.clear();
+	for (const marker of html.matchAll(/<template data-document-record="([^"]+)"><\/template>/g)) {
+		const apply = collector.records.get(marker[1] ?? "");
+		if (apply === void 0) throw new Error(`Unknown document record on ${collector.path}`);
+		apply();
+	}
+	if (collector.sectionCount === 0) throw new Error(`Document page ${collector.path} recorded no <Section>`);
+	for (const section of collector.sections) {
+		if (section.kind !== "table" || section.audience === "humans") continue;
+		const rows = section.items.filter((item) => item.audience !== "humans").map((item) => ({
+			source: item.source,
+			width: item.cells.filter((cell) => cell.audience !== "humans").length
+		}));
+		const expected = rows[0]?.width;
+		const invalid = rows.find((row) => row.width === 0 || row.width !== expected);
+		if (invalid !== void 0) throw new Error(`Table Section "${section.id}" on ${collector.path} needs equal, nonempty visible cell counts after excluding ForHumans; row at ${invalid.source} has ${invalid.width}, expected ${expected}`);
+	}
+	const document = {
+		path: collector.path,
+		...metadata,
+		sections: collector.sections,
+		messages: collector.messages,
+		facts: [...new Set(collector.messages.flatMap((message) => message.facts))]
+	};
+	return {
+		...document,
+		hash: hashDocument(document)
+	};
+}
+function useCapturePage() {
+	return useContext(Capture)?.collector.path;
+}
+function CapturedAnchor({ itemLink = false, ...props }) {
+	const key = useId();
+	const context = useContext(Capture);
+	if (context === void 0 || context.suppress) return /* @__PURE__ */ jsx("a", { ...props });
+	if (itemLink && context.item === void 0) throw new Error(`Section.Item.Link outside Section.Item on ${context.collector.path}`);
+	if (typeof props.href !== "string") throw new Error(`Document page ${context.collector.path}: Link requires a resolved href`);
+	const href = documentLinkHref(props.href, new URL(context.collector.path, context.collector.site));
+	const item = context.item;
+	const marker = itemLink && item !== void 0 ? record(context, key, () => {
+		if (context.collector.links.has(item)) throw new Error(`Duplicate Section.Item.Link at ${item.source} on ${context.collector.path}`);
+		context.collector.links.add(item);
+		item.href = href;
+	}) : null;
+	return /* @__PURE__ */ jsxs(CaptureProvider, {
+		...context,
+		link: itemLink ? void 0 : href,
+		children: [marker, /* @__PURE__ */ jsx("a", { ...props })]
+	});
+}
+/** Host for TanStack createLink: capture receives the same resolved anchor props as normal SSR. */
+function CaptureAnchor(props) {
+	return /* @__PURE__ */ jsx(CapturedAnchor, { ...props });
+}
+//#endregion
+export { ForAgents as a, T as c, createCollector as d, finishDocument as f, Fact as i, Title as l, useCapturePage as m, CaptureRequest as n, ForHumans as o, messageText as p, DocumentProvider as r, Section as s, CaptureAnchor as t, Visual as u };
+
+//# sourceMappingURL=document-Dvemcv7V.js.map

package/dist/document-Dvemcv7V.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-Dvemcv7V.js","names":[],"sources":["../src/react/document.tsx"],"sourcesContent":["import { useRouter } from \"@tanstack/react-router\";\nimport { createContext, isValidElement, useContext, useId, useMemo } from \"react\";\nimport type { ComponentPropsWithRef, ReactElement, ReactNode } from \"react\";\n\nimport type {\n  BodyEntry,\n  InlineNode,\n  Message,\n  PageDocument,\n  SectionDocument,\n  SectionItem,\n} from \"../markdown/document\";\nimport { documentLinkHref, inlineMarkdown, plainText } from \"../markdown/inline\";\nimport { RESERVED_SECTION_ID_PREFIX, hashDocument } from \"../markdown/document\";\nimport { resolveFact } from \"../markdown/facts\";\nimport type { Facts } from \"../markdown/facts\";\nimport { contentHash } from \"../markdown/hash\";\nimport type { Register } from \"../core/index\";\nimport type { SectionKind } from \"../markdown/markdown\";\n\n/** Augment with `facts: typeof facts` to check Fact ids across the application. */\n\nexport type FactId = Register extends { facts: infer F extends Facts }\n  ? Extract<keyof F, string>\n  : string;\ntype Audience = Message[\"audience\"];\ntype MutableSection = Omit<SectionDocument, \"title\" | \"body\" | \"items\"> & {\n  title?: Message;\n  body: Array<BodyEntry>;\n  items: Array<MutableItem>;\n};\ntype MutableItem = Omit<SectionItem, \"title\" | \"href\" | \"body\" | \"cells\"> & {\n  title?: Message;\n  href?: string;\n  body: Array<BodyEntry>;\n  cells: Array<Message>;\n};\nexport interface Collector {\n  path: string;\n  site: string;\n  facts?: Facts;\n  sectionCount: number;\n  sections: Array<MutableSection>;\n  messages: Array<Message>;\n  records: Map<string, () => void>;\n  links: Set<MutableItem>;\n  completed: boolean;\n}\ninterface CaptureContext {\n  collector: Collector;\n  section?: MutableSection;\n  item?: MutableItem;\n  audience: Audience;\n  suppress: boolean;\n  link?: string | undefined;\n}\nexport const CaptureRequest = createContext<Collector | undefined>(undefined);\nconst Capture = createContext<CaptureContext | undefined>(undefined);\n\nfunction CaptureProvider({\n  collector,\n  section,\n  item,\n  audience,\n  suppress,\n  link,\n  children,\n}: CaptureContext & { children?: ReactNode }) {\n  const value = useMemo(\n    () => ({\n      collector,\n      ...(section === undefined ? {} : { section }),\n      ...(item === undefined ? {} : { item }),\n      audience,\n      suppress,\n      ...(link === undefined ? {} : { link }),\n    }),\n    [collector, section, item, audience, suppress, link],\n  );\n  return <Capture.Provider value={value}>{children}</Capture.Provider>;\n}\n\ninterface ChildrenProps {\n  children?: ReactNode;\n  source?: string;\n}\ninterface FactProps {\n  id: FactId;\n  list?: boolean;\n}\ninterface InlineProps extends ChildrenProps {\n  href?: string;\n}\n\nexport function createCollector(options: { path: string; site: string; facts?: Facts }): Collector {\n  return {\n    ...options,\n    sectionCount: 0,\n    sections: [],\n    messages: [],\n    records: new Map(),\n    links: new Set(),\n    completed: false,\n  };\n}\n\n/** Mark the page body; ancestor layouts remain outside the captured document. */\nexport function DocumentProvider({\n  collector: supplied,\n  children,\n}: {\n  collector?: Collector;\n  children: ReactNode;\n}) {\n  const request = useContext(CaptureRequest);\n  const router = useRouter({ warn: false });\n  if (import.meta.env?.DEV && router !== null && router !== undefined) {\n    const match = router.stores.matches.get().at(-1);\n    if (match !== undefined && match.staticData.markdown !== \"rendered\")\n      throw new Error(\n        `DocumentProvider on ${match.pathname} requires staticData.markdown: \"rendered\"; declare it on the page route.`,\n      );\n  }\n  const collector = supplied ?? request;\n  if (collector === undefined) return <>{children}</>;\n  return (\n    <CaptureProvider collector={collector} audience=\"all\" suppress={false}>\n      {children}\n    </CaptureProvider>\n  );\n}\n\nfunction record(context: CaptureContext, id: string, apply: () => void) {\n  context.collector.records.set(id, apply);\n  return <template data-document-record={id} />;\n}\n\nconst sourceOf = (source: string | undefined): string => source ?? \"<inline>:1\";\n\nfunction elementProps(node: ReactElement<InlineProps>): InlineProps {\n  return node.props;\n}\nfunction factProps(node: ReactElement): { id: string; list?: boolean } {\n  const props = node.props;\n  if ((typeof props !== \"object\" || props === null) || !(\"id\" in props) || typeof props.id !== \"string\") {\n    throw new Error(\"Fact requires an id\");\n  }\n  return { id: props.id, ...(\"list\" in props && props.list === true ? { list: true } : {}) };\n}\n\n/** Sanitize without executing components: identity is authored text, inline marks and fact ids. */\nexport function inlineTree(\n  node: ReactNode,\n  options: { facts?: Facts; site?: string; path?: string } = {},\n): Array<InlineNode> {\n  if (node === undefined || node === null || typeof node === \"boolean\") return [];\n  if (typeof node === \"string\" || typeof node === \"number\") return [String(node)];\n  if (Array.isArray(node)) return node.flatMap((child) => inlineTree(child, options));\n  if (!isValidElement<InlineProps>(node))\n    throw new Error(\"T only accepts text, em, strong, a, code, br, and Fact\");\n  if (node.type === T) return inlineTree(elementProps(node).children, options);\n  if (node.type === Fact) {\n    const { id, list } = factProps(node);\n    const definition = resolveFact(id, options.facts);\n    if (list && definition.kind !== \"list\")\n      throw new Error(`Fact \"${id}\" is not a list`);\n    return [{ fact: id, text: definition.text }];\n  }\n  const tag = node.type;\n  if (tag !== \"em\" && tag !== \"strong\" && tag !== \"a\" && tag !== \"code\" && tag !== \"br\") {\n    throw new Error(\n      `T only accepts text, em, strong, a, code, br, and Fact; found ${typeof tag === \"string\" ? tag : \"a component\"}`,\n    );\n  }\n  const props = elementProps(node);\n  const href = tag === \"a\" ? props.href : undefined;\n  if (tag === \"a\" && typeof href !== \"string\")\n    throw new Error(\"An anchor in T needs a string href\");\n  return [\n    {\n      tag,\n      ...(href === undefined\n        ? {}\n        : {\n            href: documentLinkHref(\n              href,\n              options.site === undefined ? undefined : new URL(options.path ?? \"/\", options.site),\n            ),\n          }),\n      children: inlineTree(props.children, options),\n    },\n  ];\n}\n\nfunction authoredTree(tree: ReadonlyArray<InlineNode>): unknown {\n  return tree.map((node) =>\n    typeof node === \"string\"\n      ? node\n      : \"fact\" in node\n        ? { fact: node.fact }\n        : {\n            tag: node.tag,\n            ...(node.href === undefined ? {} : { href: node.href }),\n            children: authoredTree(node.children),\n          },\n  );\n}\n/** Static text for head()/JSON-LD; use format: \"markdown\" to retain inline marks. */\nexport function messageText(\n  node: ReactNode,\n  options: { format?: \"text\" | \"markdown\"; facts?: Facts; site?: string; path?: string } = {},\n): string {\n  const content =\n    isValidElement<ChildrenProps>(node) && node.type === Title ? node.props.children : node;\n  const tree = inlineTree(content, options);\n  return options.format === \"markdown\" ? inlineMarkdown(tree) : plainText(tree);\n}\n\nfunction messageFor(node: ReactNode, source: string | undefined, context: CaptureContext): Message {\n  const options = context.collector;\n  // A whole-card destination is serialized on the item, rather than repeated on every message.\n  const linkedContent =\n    context.link === undefined || context.link === context.item?.href ? (\n      node\n    ) : (\n      <a href={context.link}>{node}</a>\n    );\n  const tree = inlineTree(linkedContent, options);\n  const authored = inlineTree(linkedContent, options.facts === undefined ? {} : { facts: options.facts });\n  const refs = new Set<string>();\n  const visit = (nodes: ReadonlyArray<InlineNode>): void => {\n    for (const child of nodes) {\n      if (typeof child !== \"string\") {\n        if (\"fact\" in child) refs.add(child.fact);\n        else visit(child.children);\n      }\n    }\n  };\n  visit(tree);\n  const message: Message = {\n    hash: contentHash(authoredTree(authored)).slice(0, 16),\n    tree,\n    text: plainText(tree),\n    source: sourceOf(source),\n    facts: [...refs],\n    audience: context.audience,\n  };\n  return message;\n}\nfunction append(context: CaptureContext, entry: BodyEntry): void {\n  if (context.item !== undefined) {\n    context.item.body.push(entry);\n    if (entry.type === \"message\") context.item.cells.push(entry.message);\n  } else if (context.section !== undefined) context.section.body.push(entry);\n  else {\n    let section = context.collector.sections.at(-1);\n    if (section?.kind !== `for-${context.audience}`) {\n      section = {\n        kind: `for-${context.audience}`,\n        id: `for-${context.audience}-${context.collector.sections.length}`,\n        body: [],\n        items: [],\n        source: entry.type === \"message\" ? entry.message.source : entry.source,\n        audience: context.audience,\n      };\n      context.collector.sections.push(section);\n    }\n    section.body.push(entry);\n  }\n}\n\nexport function T({ children, source }: ChildrenProps) {\n  const id = useId();\n  const context = useContext(Capture);\n  if (context === undefined || context.suppress) return <>{children}</>;\n  const message = messageFor(children, source, context);\n  const marker = record(context, id, () => {\n    context.collector.messages.push(message);\n    append(context, { type: \"message\", message });\n  });\n  return (\n    <>\n      {marker}\n      {children}\n    </>\n  );\n}\n/**\n * Mark an inline heading in place without adding markup. Capture assigns it to the nearest\n * Section.Item, otherwise Section, and records one title message instead of body text.\n * Accepts the same inline children as T. A title prop or another Title on that owner is an error.\n */\nexport function Title({ children, source }: ChildrenProps) {\n  const id = useId();\n  const context = useContext(Capture);\n  if (context === undefined || context.suppress) return <>{children}</>;\n  const title = messageFor(children, source, context);\n  const marker = record(context, id, () => {\n    if (context.section === undefined)\n      throw new Error(`Title outside Section on ${context.collector.path}`);\n    const owner = context.item ?? context.section;\n    if (owner.title !== undefined)\n      throw new Error(\n        `Duplicate document title for ${context.item === undefined ? `Section \"${context.section.id}\"` : `Section.Item at ${context.item.source}`} on ${context.collector.path}; use a title prop or one Title`,\n      );\n    owner.title = title;\n    context.collector.messages.push(title);\n    if (context.item !== undefined) context.item.cells.unshift(title);\n  });\n  return (\n    <CaptureProvider {...context} suppress>\n      {marker}\n      {children}\n    </CaptureProvider>\n  );\n}\nexport function Fact({ id, list }: FactProps) {\n  const context = useContext(Capture);\n  const definition = resolveFact(id, context?.collector.facts);\n  if (list && definition.kind !== \"list\")\n    throw new Error(`Fact \"${id}\" is not a list`);\n  return <>{definition.text}</>;\n}\nfunction ItemRoot(\n  props: ChildrenProps & {\n    /** Capture-only heading; use Title to mark a visible heading in place. */\n    title?: ReactNode;\n  },\n) {\n  const key = useId();\n  const { title, children, source } = props;\n  const context = useContext(Capture);\n  if (context === undefined || context.suppress) return <>{children}</>;\n  if (\"href\" in props)\n    throw new Error(\n      `Section.Item does not accept href on ${context.collector.path}; render Section.Item.Link instead`,\n    );\n  if (context.section === undefined)\n    throw new Error(`Section.Item outside Section on ${context.collector.path}`);\n  const item: MutableItem = {\n    body: [],\n    cells: [],\n    source: sourceOf(source),\n    audience: context.audience,\n  };\n  const heading =\n    title === undefined\n      ? undefined\n      : messageFor(\n          title,\n          isValidElement<ChildrenProps>(title) ? (title.props.source ?? source) : source,\n          { ...context, item },\n        );\n  if (heading !== undefined) {\n    item.title = heading;\n    item.cells.push(heading);\n  }\n  const marker = record(context, key, () => {\n    context.section?.items.push(item);\n    if (heading !== undefined) context.collector.messages.push(heading);\n  });\n  return (\n    <CaptureProvider {...context} item={item}>\n      {marker}\n      {children}\n    </CaptureProvider>\n  );\n}\nfunction SectionRoot({\n  evidence,\n  kind,\n  id,\n  title,\n  language,\n  children,\n  source,\n}: ChildrenProps & {\n  kind: string | SectionKind;\n  id: string;\n  evidence?: boolean;\n  /** Capture-only heading; use Title to mark a visible heading in place. */\n  title?: ReactNode;\n  language?: string;\n}) {\n  const key = useId();\n  const context = useContext(Capture);\n  if (context === undefined || context.suppress) return <>{children}</>;\n  const heading =\n    title === undefined\n      ? undefined\n      : messageFor(\n          title,\n          isValidElement<ChildrenProps>(title) ? (title.props.source ?? source) : source,\n          context,\n        );\n  const section: MutableSection = {\n    ...(evidence === undefined ? {} : { evidence }),\n    kind: typeof kind === \"string\" ? kind : kind.kind,\n    id,\n    ...(heading === undefined ? {} : { title: heading }),\n    ...(language === undefined ? {} : { language }),\n    body: [],\n    items: [],\n    source: sourceOf(source),\n    audience: context.audience,\n  };\n  const marker = record(context, key, () => {\n    if (id.startsWith(RESERVED_SECTION_ID_PREFIX))\n      throw new Error(`Document Section id \"${id}\" on ${context.collector.path} uses reserved prefix \"${RESERVED_SECTION_ID_PREFIX}\"`);\n    if (context.collector.sections.some((entry) => entry.id === id))\n      throw new Error(`Duplicate document Section id \"${id}\" on ${context.collector.path}`);\n    context.collector.sectionCount++;\n    context.collector.sections.push(section);\n    if (heading !== undefined) context.collector.messages.push(heading);\n  });\n  return (\n    <CaptureProvider\n      collector={context.collector}\n      section={section}\n      audience={context.audience}\n      suppress={false}\n    >\n      {marker}\n      {children}\n    </CaptureProvider>\n  );\n}\n/**\n * Render the card's anchor and record its destination on the enclosing Section.Item.\n * Use `createLink(Section.Item.Link)` for TanStack navigation: Router supplies the resolved href,\n * including params, search and hash, so the page and twin share one destination.\n * Anchor props and refs pass through. An item may contain only one such link;\n * capture rejects missing or disabled destinations.\n */\nfunction ItemLink(props: ComponentPropsWithRef<\"a\">) {\n  return <CapturedAnchor {...props} itemLink />;\n}\nconst Item = Object.assign(ItemRoot, { Link: ItemLink });\nexport const Section = Object.assign(SectionRoot, { Item });\n/**\n * Render children unchanged outside capture. Under DocumentProvider, children never render or record;\n * describe is the only twin output, and omitting it contributes nothing to the twin.\n */\nexport function Visual({ describe, children, source }: ChildrenProps & { describe?: string }) {\n  const id = useId();\n  const context = useContext(Capture);\n  if (context === undefined) return <>{children}</>;\n  if (context.suppress || describe === undefined) return null;\n  return record(context, id, () =>\n    append(context, {\n      type: \"visual\",\n      text: describe,\n      source: sourceOf(source),\n      audience: context.audience,\n    }),\n  );\n}\nfunction AudienceContent({\n  audience,\n  children,\n}: ChildrenProps & { audience: \"agents\" | \"humans\" }) {\n  const context = useContext(Capture);\n  if (context === undefined) return audience === \"agents\" ? null : <>{children}</>;\n  return (\n    <CaptureProvider {...context} audience={audience}>\n      {children}\n    </CaptureProvider>\n  );\n}\nexport function ForAgents(props: ChildrenProps) {\n  return <AudienceContent {...props} audience=\"agents\" />;\n}\nexport function ForHumans(props: ChildrenProps) {\n  return <AudienceContent {...props} audience=\"humans\" />;\n}\n\nexport function finishDocument(\n  collector: Collector,\n  metadata: { title: string; description: string },\n  html: string,\n): PageDocument {\n  if (collector.completed) throw new Error(`Document capture already completed for ${collector.path}`);\n  collector.completed = true;\n  // Only completed SSR output decides which attempted renders belong to the document and their order.\n  collector.sections.length = 0;\n  collector.messages.length = 0;\n  collector.sectionCount = 0;\n  collector.links.clear();\n  for (const marker of html.matchAll(/<template data-document-record=\"([^\"]+)\"><\\/template>/g)) {\n    const apply = collector.records.get(marker[1] ?? \"\");\n    if (apply === undefined) throw new Error(`Unknown document record on ${collector.path}`);\n    apply();\n  }\n  if (collector.sectionCount === 0)\n    throw new Error(`Document page ${collector.path} recorded no <Section>`);\n  // Validate completed public rows after replay; abandoned renders and human-only rows do not count.\n  for (const section of collector.sections) {\n    if (section.kind !== \"table\" || section.audience === \"humans\") continue;\n    const rows = section.items\n      .filter((item) => item.audience !== \"humans\")\n      .map((item) => ({\n        source: item.source,\n        width: item.cells.filter((cell) => cell.audience !== \"humans\").length,\n      }));\n    const expected = rows[0]?.width;\n    const invalid = rows.find((row) => row.width === 0 || row.width !== expected);\n    if (invalid !== undefined)\n      throw new Error(\n        `Table Section \"${section.id}\" on ${collector.path} needs equal, nonempty visible cell counts after excluding ForHumans; row at ${invalid.source} has ${invalid.width}, expected ${expected}`,\n      );\n  }\n  const document = {\n    path: collector.path,\n    ...metadata,\n    sections: collector.sections,\n    messages: collector.messages,\n    facts: [...new Set(collector.messages.flatMap((message) => message.facts))],\n  };\n  return { ...document, hash: hashDocument(document) };\n}\n\nexport function useCapturePage(): string | undefined {\n  return useContext(Capture)?.collector.path;\n}\n\nfunction CapturedAnchor({\n  itemLink = false,\n  ...props\n}: ComponentPropsWithRef<\"a\"> & { itemLink?: boolean }) {\n  const key = useId();\n  const context = useContext(Capture);\n  if (context === undefined || context.suppress) return <a {...props} />;\n  if (itemLink && context.item === undefined)\n    throw new Error(`Section.Item.Link outside Section.Item on ${context.collector.path}`);\n  if (typeof props.href !== \"string\")\n    throw new Error(`Document page ${context.collector.path}: Link requires a resolved href`);\n  const href = documentLinkHref(props.href, new URL(context.collector.path, context.collector.site));\n  const item = context.item;\n  const marker =\n    itemLink && item !== undefined\n      ? record(context, key, () => {\n          if (context.collector.links.has(item))\n            throw new Error(\n              `Duplicate Section.Item.Link at ${item.source} on ${context.collector.path}`,\n            );\n          context.collector.links.add(item);\n          item.href = href;\n        })\n      : null;\n  return (\n    <CaptureProvider {...context} link={itemLink ? undefined : href}>\n      {marker}\n      <a {...props} />\n    </CaptureProvider>\n  );\n}\n\n/** Host for TanStack createLink: capture receives the same resolved anchor props as normal SSR. */\nexport function CaptureAnchor(props: ComponentPropsWithRef<\"a\">) {\n  return <CapturedAnchor {...props} />;\n}\n"],"mappings":"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"}

package/dist/facts-1OKclPOk.js

@@ -0,0 +1,115 @@
+//#region src/markdown/facts.ts
+const registeredFacts = /* @__PURE__ */ new Map();
+function isJson(value, parents = /* @__PURE__ */ new Set()) {
+	if (value === null || typeof value === "string" || typeof value === "boolean") return true;
+	if (typeof value === "number") return Number.isFinite(value);
+	if (typeof value !== "object" || parents.has(value)) return false;
+	const prototype = Object.getPrototypeOf(value);
+	if (!Array.isArray(value) && prototype !== null && prototype !== Object.prototype) return false;
+	parents.add(value);
+	const valid = (Array.isArray(value) ? Array.from(value) : Object.values(value)).every((entry) => isJson(entry, parents));
+	parents.delete(value);
+	return valid;
+}
+function validateDefinition(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) throw new Error("Expected object");
+	for (const key of [
+		"kind",
+		"value",
+		"text"
+	]) if (!(key in value)) throw new Error(`Missing key\n  at ["${key}"]`);
+	if (!("kind" in value) || ![
+		"number",
+		"money",
+		"list",
+		"text"
+	].includes(String(value.kind))) throw new Error("Expected \"number\" | \"money\" | \"list\" | \"text\"\n  at [\"kind\"]");
+	if (!("value" in value) || !isJson(value.value)) throw new Error("Expected JSON value\n  at [\"value\"]");
+	if (!("text" in value) || typeof value.text !== "string") throw new Error("Expected string\n  at [\"text\"]");
+	let items;
+	if ("items" in value) {
+		if (!Array.isArray(value.items)) throw new Error("Expected array\n  at [\"items\"]");
+		items = Array.from(value.items, (item, index) => {
+			if (typeof item !== "string") throw new Error(`Expected string\n  at ["items"][${index}]`);
+			return item;
+		});
+	}
+	const kind = value.kind;
+	if (kind !== "number" && kind !== "money" && kind !== "list" && kind !== "text") throw new Error("Expected \"number\" | \"money\" | \"list\" | \"text\"\n  at [\"kind\"]");
+	return {
+		kind,
+		value: value.value,
+		text: value.text,
+		...items === void 0 ? {} : { items }
+	};
+}
+/** Decode facts loaded from an application module before shipping them to the runtime. */
+function decodeFacts(input) {
+	if (typeof input !== "object" || input === null || Array.isArray(input)) throw new Error("Document facts must be an object");
+	return Object.fromEntries(Object.entries(input).map(([id, definition]) => {
+		if (!id) throw new Error("A document fact needs a nonempty id");
+		return [id, validateDefinition(definition)];
+	}));
+}
+/** Register code-owned values for ordinary React rendering as well as capture. */
+function defineFacts(facts) {
+	for (const [id, definition] of Object.entries(facts)) {
+		if (!id) throw new Error("A document fact needs a nonempty id");
+		registeredFacts.set(id, validateDefinition(definition));
+	}
+	return facts;
+}
+function finite(value) {
+	if (!Number.isFinite(value)) throw new Error(`Document fact must be finite: ${value}`);
+	return value;
+}
+const fact = {
+	number(value, options) {
+		const validated = finite(value);
+		return {
+			kind: "number",
+			value: validated,
+			text: new Intl.NumberFormat("en-US", options).format(validated)
+		};
+	},
+	money(value, options = {}) {
+		const validated = finite(value);
+		const text = new Intl.NumberFormat("en-US", {
+			style: "currency",
+			currency: options.currency ?? "USD"
+		}).format(validated);
+		return {
+			kind: "money",
+			value: validated,
+			text: options.per === void 0 ? text : `${text} per ${options.per}`
+		};
+	},
+	list(values, options) {
+		const items = values.map((value) => options === void 0 ? String(value) : options.format(value));
+		return {
+			kind: "list",
+			value: [...values],
+			items,
+			text: new Intl.ListFormat("en-US", {
+				style: "long",
+				type: "conjunction"
+			}).format(items)
+		};
+	},
+	text(value) {
+		return {
+			kind: "text",
+			value,
+			text: value
+		};
+	}
+};
+function resolveFact(id, facts) {
+	const value = facts === void 0 ? registeredFacts.get(id) : facts[id];
+	if (value === void 0) throw new Error(`Unknown document fact "${id}"; register it with defineFacts`);
+	return value;
+}
+//#endregion
+export { resolveFact as i, defineFacts as n, fact as r, decodeFacts as t };
+
+//# sourceMappingURL=facts-1OKclPOk.js.map