pagegraph 0.12.0 → 0.13.0

package/dist/facts-1OKclPOk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"facts-1OKclPOk.js","names":[],"sources":["../src/markdown/facts.ts"],"sourcesContent":["export type Json = null | boolean | number | string | ReadonlyArray<Json> | { readonly [key: string]: Json };\nexport interface FactDefinition {\n  readonly kind: \"number\" | \"money\" | \"list\" | \"text\";\n  readonly value: Json;\n  readonly text: string;\n  readonly items?: ReadonlyArray<string>;\n}\nexport type Facts = Readonly<Record<string, FactDefinition>>;\nconst registeredFacts = new Map<string, FactDefinition>();\n\nfunction isJson(value: unknown, parents = new Set<object>()): value is Json {\n  if (value === null || typeof value === \"string\" || typeof value === \"boolean\") return true;\n  if (typeof value === \"number\") return Number.isFinite(value);\n  if (typeof value !== \"object\" || parents.has(value)) return false;\n  const prototype = Object.getPrototypeOf(value);\n  if (!Array.isArray(value) && prototype !== null && prototype !== Object.prototype) return false;\n  parents.add(value);\n  const entries = Array.isArray(value) ? Array.from(value) : Object.values(value);\n  const valid = entries.every((entry) => isJson(entry, parents));\n  parents.delete(value);\n  return valid;\n}\nfunction validateDefinition(value: unknown): FactDefinition {\n  if (typeof value !== \"object\" || value === null || Array.isArray(value)) throw new Error(\"Expected object\");\n  for (const key of [\"kind\", \"value\", \"text\"]) {\n    if (!(key in value)) throw new Error(`Missing key\\n  at [\"${key}\"]`);\n  }\n  if (!(\"kind\" in value) || ![\"number\", \"money\", \"list\", \"text\"].includes(String(value.kind)))\n    throw new Error('Expected \"number\" | \"money\" | \"list\" | \"text\"\\n  at [\"kind\"]');\n  if (!(\"value\" in value) || !isJson(value.value)) throw new Error('Expected JSON value\\n  at [\"value\"]');\n  if (!(\"text\" in value) || typeof value.text !== \"string\") throw new Error('Expected string\\n  at [\"text\"]');\n  let items: Array<string> | undefined;\n  if (\"items\" in value) {\n    if (!Array.isArray(value.items)) throw new Error('Expected array\\n  at [\"items\"]');\n    items = Array.from(value.items, (item, index) => {\n      if (typeof item !== \"string\") throw new Error(`Expected string\\n  at [\"items\"][${index}]`);\n      return item;\n    });\n  }\n  const kind = value.kind;\n  if (kind !== \"number\" && kind !== \"money\" && kind !== \"list\" && kind !== \"text\")\n    throw new Error('Expected \"number\" | \"money\" | \"list\" | \"text\"\\n  at [\"kind\"]');\n  return { kind, value: value.value, text: value.text, ...(items === undefined ? {} : { items }) };\n}\n\n/** Decode facts loaded from an application module before shipping them to the runtime. */\nexport function decodeFacts(input: unknown): Facts {\n  if (typeof input !== \"object\" || input === null || Array.isArray(input)) {\n    throw new Error(\"Document facts must be an object\");\n  }\n  return Object.fromEntries(Object.entries(input).map(([id, definition]) => {\n    if (!id) throw new Error(\"A document fact needs a nonempty id\");\n    return [id, validateDefinition(definition)];\n  }));\n}\n\n/** Register code-owned values for ordinary React rendering as well as capture. */\nexport function defineFacts<const F extends Facts>(facts: F): F {\n  for (const [id, definition] of Object.entries(facts)) {\n    if (!id) throw new Error(\"A document fact needs a nonempty id\");\n    registeredFacts.set(id, validateDefinition(definition));\n  }\n  return facts;\n}\nfunction finite(value: number): number {\n  if (!Number.isFinite(value)) throw new Error(`Document fact must be finite: ${value}`);\n  return value;\n}\nexport const fact = {\n  number(value: number, options?: Intl.NumberFormatOptions): FactDefinition {\n    const validated = finite(value);\n    return { kind: \"number\", value: validated, text: new Intl.NumberFormat(\"en-US\", options).format(validated) };\n  },\n  money(value: number, options: { currency?: string; per?: string } = {}): FactDefinition {\n    const validated = finite(value);\n    const text = new Intl.NumberFormat(\"en-US\", {\n      style: \"currency\", currency: options.currency ?? \"USD\",\n    }).format(validated);\n    return { kind: \"money\", value: validated, text: options.per === undefined ? text : `${text} per ${options.per}` };\n  },\n  list<T extends Json>(values: ReadonlyArray<T>, options?: { format: (value: T) => string }): FactDefinition {\n    const items = values.map((value) => options === undefined ? String(value) : options.format(value));\n    return { kind: \"list\", value: [...values], items, text: new Intl.ListFormat(\"en-US\", { style: \"long\", type: \"conjunction\" }).format(items) };\n  },\n  text(value: string): FactDefinition { return { kind: \"text\", value, text: value }; },\n};\nexport function resolveFact(id: string, facts?: Facts): FactDefinition {\n  const value = facts === undefined ? registeredFacts.get(id) : facts[id];\n  if (value === undefined) throw new Error(`Unknown document fact \"${id}\"; register it with defineFacts`);\n  return value;\n}\n"],"mappings":"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"}

package/dist/{declare-DVgdEdOL.d.ts → graph-D1PIndsC.d.ts}

@@ -1,4 +1,4 @@
-import { AnyRouteMatch } from "@tanstack/react-router";
+import { AnyRoute, AnyRouteMatch } from "@tanstack/react-router";
 //#region node_modules/schema-dts-lib/dist/index.d.ts
 /**
  * Minimal valid JSON-LD object.
@@ -2302,7 +2302,7 @@ interface CreativeWorkLeaf extends CreativeWorkBase {
   "@type": "CreativeWork";
 }
 /** The most generic kind of creative work, including books, movies, photographs, software programs, etc. */
-type CreativeWork = CreativeWorkLeaf | AmpStory | ArchiveComponent | Article | Atlas | Blog | Book | Certification | Chapter | Claim | Clip | Code | Collection | ComicStory | Comment | Conversation | Course | CreativeWorkSeason | CreativeWorkSeries | Credential | DataCatalog | Dataset | DefinedTermSet | Diet | DigitalDocument | Drawing | Episode | ExercisePlan | Game | Guide | HowTo | HowToDirection | HowToSection | HowToStep | HowToTip | HyperToc | HyperTocEntry | LearningResource | Legislation | Manuscript | Map | MathSolver | MediaObject | MediaReviewItem | Menu | MenuSection | Message | Movie | MusicComposition | MusicPlaylist | MusicRecording | Painting | Photograph | Play | Poster | PublicationIssue | PublicationVolume | Quotation | Review | Sculpture | Season | SheetMusic | ShortStory | SoftwareApplication | SoftwareSourceCode | SpecialAnnouncement | Statement | Thesis | TVSeason | TVSeries | VisualArtwork | WebContent | WebPage | WebPageElement | WebSite;
+type CreativeWork = CreativeWorkLeaf | AmpStory | ArchiveComponent | Article | Atlas | Blog | Book | Certification | Chapter | Claim | Clip | Code | Collection | ComicStory | Comment | Conversation | Course | CreativeWorkSeason | CreativeWorkSeries | Credential | DataCatalog | Dataset | DefinedTermSet | Diet | DigitalDocument | Drawing | Episode | ExercisePlan | Game | Guide | HowTo | HowToDirection | HowToSection | HowToStep | HowToTip | HyperToc | HyperTocEntry | LearningResource | Legislation | Manuscript | Map$1 | MathSolver | MediaObject | MediaReviewItem | Menu | MenuSection | Message | Movie | MusicComposition | MusicPlaylist | MusicRecording | Painting | Photograph | Play | Poster | PublicationIssue | PublicationVolume | Quotation | Review | Sculpture | Season | SheetMusic | ShortStory | SoftwareApplication | SoftwareSourceCode | SpecialAnnouncement | Statement | Thesis | TVSeason | TVSeries | VisualArtwork | WebContent | WebPage | WebPageElement | WebSite;
 interface CreativeWorkSeasonBase extends CreativeWorkBase {
   /** An actor (individual or a group), e.g. in TV, radio, movie, video games etc., or in an event. Actors can be associated with individual items or with a series, episode, clip. */
   "actor"?: SchemaValue<PerformingGroup | Person | IdReference, "actor">;
@@ -5467,7 +5467,7 @@ interface MapLeaf extends MapBase {
   "@type": "Map";
 }
 /** A map. */
-type Map = MapLeaf;
+type Map$1 = MapLeaf;
 interface MapCategoryTypeLeaf extends EnumerationBase {
   "@type": "MapCategoryType";
 }
@@ -8176,7 +8176,7 @@ interface PlaceBase extends ThingBase {
    */
   "hasGS1DigitalLink"?: SchemaValue<URL, "hasGS1DigitalLink">;
   /** A URL to a map of the place. */
-  "hasMap"?: SchemaValue<Map | URL | IdReference, "hasMap">;
+  "hasMap"?: SchemaValue<Map$1 | URL | IdReference, "hasMap">;
   /** A flag to signal that the item, event, or place is accessible for free. */
   "isAccessibleForFree"?: SchemaValue<Boolean, "isAccessibleForFree">;
   /** The International Standard of Industrial Classification of All Economic Activities (ISIC), Revision 4 code for a particular organization, business person, or place. */
@@ -11996,6 +11996,7 @@ type Zoo = ZooLeaf | string;
  *   interface Register {
  *     paths: FileRouteTypes["fullPaths"];
  *     kinds: "page" | "article" | "hub";
+ *     facts: typeof facts;
  *   }
  * }
  * ```
@@ -12120,8 +12121,118 @@ declare function applyTitleTemplate(template: string | undefined, title: string)
 declare module "@tanstack/react-router" {
   interface StaticDataRouteOption {
     seo?: RouteSeo | undefined;
+    /** How this route supplies its authored document. */
+    markdown?: "rendered" | "source" | undefined;
+    /** Group label for this page in llms.txt. */
+    llms?: string | undefined;
   }
 }
 //#endregion
-export { Thing as _, SeoFaq as a, IdReference as b, SitemapPolicy as c, BreadcrumbList as d, FAQPage as f, Service as g, Organization as h, RouteSeo as i, applyTitleTemplate as l, ItemList as m, PublicPath as n, SeoKind as o, Graph as p, Register as r, SeoPageHead as s, JsonLdDocument as t, Article as u, WebSite as v, WithContext as y };
-//# sourceMappingURL=declare-DVgdEdOL.d.ts.map
+//#region src/core/graph.d.ts
+/**
+ * Where a node came from: `"route"` for a structural route declaration, or the
+ * `source` label of the collection that produced the instance (e.g. "blog").
+ */
+type SeoSource = string;
+interface SeoNode {
+  /** Canonical path, no origin (e.g. "/pricing", "/blog/my-post"). */
+  path: string;
+  kind: SeoKind;
+  source: SeoSource;
+  /** Route-declared authored-document mode, inherited by collection instances. */
+  markdown?: "rendered" | "source" | undefined;
+  /** Group label for llms.txt, inherited by collection instances. */
+  llms?: string | undefined;
+  /** Route-declared policy, or synthesized (kind + inherited sitemap) for instances. */
+  policy: RouteSeo;
+  /**
+   * The head the page ships: a static route's declared `head`, or an instance's
+   * title (through its route's `titleTemplate`) and description. Absent when the
+   * route computes its head at request time and no collection supplies it.
+   */
+  head?: SeoNodeHead | undefined;
+  instance?: {
+    title: string;
+    description?: string | undefined;
+    publishedAt?: string | undefined;
+    modifiedAt?: string | undefined;
+  } | undefined;
+}
+/**
+ * A node's head as graph data: the full title, description, and FAQ text. An
+ * instance without a description still carries its title.
+ */
+interface SeoNodeHead {
+  readonly title: string;
+  readonly description?: string | undefined;
+  readonly faqs?: ReadonlyArray<{
+    readonly question: string;
+    readonly answer: string;
+  }> | undefined;
+}
+type SeoEdgeType = "crumb-parent" | "related" | "redirect" | "collection-member";
+interface SeoEdge {
+  from: string;
+  to: string;
+  type: SeoEdgeType;
+}
+interface SeoGraph {
+  nodes: Map<string, SeoNode>;
+  edges: Array<SeoEdge>;
+  /** Exact-path ownership conflicts encountered while assembling graph sources. */
+  collisions?: ReadonlyArray<{
+    path: string;
+    sources: ReadonlyArray<SeoSource>;
+  }> | undefined;
+}
+/** One concrete page produced by a collection. */
+interface SeoInstance {
+  /** Canonical path of the page (e.g. "/blog/my-post"). */
+  readonly path: string;
+  readonly title: string;
+  readonly description?: string | undefined;
+  readonly publishedAt?: string | undefined;
+  readonly modifiedAt?: string | undefined;
+}
+interface SeoCollection {
+  /**
+   * The param route these instances render through (e.g. "/blog/$slug"). Instances
+   * inherit this route's declared policy (kind + sitemap) — the graph reads it from
+   * the structural node, so declarations stay the single source of truth.
+   */
+  readonly route: PublicPath;
+  /** The `source` stamped on every node this collection produces (e.g. "blog"). */
+  readonly source: SeoSource;
+  readonly instances: ReadonlyArray<SeoInstance>;
+  /** Edges the collection declares between its instances and the rest of the graph. */
+  readonly edges?: ReadonlyArray<SeoEdge> | undefined;
+}
+/**
+ * The structural route shape the graph walks: a TanStack route tree has it
+ * before `init()`, and an adapter can build it from parsed route files.
+ */
+interface SeoRouteNode {
+  readonly options: {
+    readonly path?: string | undefined;
+    readonly staticData?: {
+      readonly seo?: RouteSeo | undefined;
+      readonly markdown?: SeoNode["markdown"];
+      readonly llms?: SeoNode["llms"];
+    } | undefined;
+  };
+  readonly children?: ReadonlyArray<SeoRouteNode> | undefined;
+}
+interface BuildSeoGraphInput {
+  readonly routeTree: AnyRoute | SeoRouteNode;
+  readonly collections?: ReadonlyArray<SeoCollection> | undefined;
+}
+/**
+ * Build the SEO graph from route declarations and content collections.
+ *
+ * Synchronous: the caller materializes its collections before calling, so there is
+ * no async work here. Callers own the origin.
+ */
+declare function buildSeoGraph(input: BuildSeoGraphInput): SeoGraph;
+//#endregion
+export { WithContext as A, FAQPage as C, Service as D, Organization as E, Thing as O, BreadcrumbList as S, ItemList as T, SeoKind as _, SeoGraph as a, applyTitleTemplate as b, SeoNodeHead as c, buildSeoGraph as d, JsonLdDocument as f, SeoFaq as g, RouteSeo as h, SeoEdgeType as i, IdReference as j, WebSite as k, SeoRouteNode as l, Register as m, SeoCollection as n, SeoInstance as o, PublicPath as p, SeoEdge as r, SeoNode as s, BuildSeoGraphInput as t, SeoSource as u, SeoPageHead as v, Graph as w, Article as x, SitemapPolicy as y };
+//# sourceMappingURL=graph-D1PIndsC.d.ts.map

package/dist/{graph-Bcsourlv.js → graph-DMNOLXLu.js}

@@ -47,22 +47,30 @@ function mergeSeo(base, override) {
 */
 function walkRoutes(route, parentPath, isRoot, nodes, edges, crumbStack) {
 	const path = isRoot ? "/" : joinPath(parentPath, route.options.path);
-	const seo = route.options.staticData?.seo;
-	if (seo) {
+	const data = route.options.staticData;
+	const seo = data?.seo;
+	if (seo || data?.markdown !== void 0 || data?.llms !== void 0) {
 		const existing = nodes.get(path);
 		if (existing) {
-			existing.policy = mergeSeo(existing.policy, seo);
+			if (seo) existing.policy = mergeSeo(existing.policy, seo);
 			existing.kind = existing.policy.kind;
-			existing.head = declaredHead(seo) ?? existing.head;
-		} else nodes.set(path, {
-			path,
-			kind: seo.kind,
-			source: "route",
-			policy: { ...seo },
-			head: declaredHead(seo)
-		});
+			existing.head = (seo && declaredHead(seo)) ?? existing.head;
+			existing.markdown = data?.markdown ?? existing.markdown;
+			existing.llms = data?.llms ?? existing.llms;
+		} else {
+			const policy = seo ?? { kind: FALLBACK_KIND };
+			nodes.set(path, {
+				path,
+				kind: policy.kind,
+				source: "route",
+				policy: { ...policy },
+				head: seo && declaredHead(seo),
+				markdown: data?.markdown,
+				llms: data?.llms
+			});
+		}
 		const nearestCrumbAncestor = crumbStack[crumbStack.length - 1];
-		if (seo.crumb !== void 0 && nearestCrumbAncestor !== void 0) edges.push({
+		if (seo?.crumb !== void 0 && nearestCrumbAncestor !== void 0) edges.push({
 			from: path,
 			to: nearestCrumbAncestor,
 			type: "crumb-parent"
@@ -104,6 +112,8 @@ function addCollection(nodes, edges, collisions, collection) {
 			path: instance.path,
 			kind,
 			source: collection.source,
+			markdown: collectionNode?.markdown,
+			llms: collectionNode?.llms,
 			policy: {
 				kind,
 				sitemap
@@ -159,4 +169,4 @@ function buildSeoGraph(input) {
 //#endregion
 export { buildSeoGraph as t };
 
-//# sourceMappingURL=graph-Bcsourlv.js.map
+//# sourceMappingURL=graph-DMNOLXLu.js.map

package/dist/graph-DMNOLXLu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-DMNOLXLu.js","names":[],"sources":["../src/core/graph.ts"],"sourcesContent":["/**\n * SEO graph — the derived model that projections (sitemap, robots), the CLI, and\n * the check engine all read from. Built from route declarations (`staticData.seo`)\n * plus consumer-supplied content collections. This module is pure: no React, no\n * env, no knowledge of where instances come from. Origins and env-derived values\n * are injected by the callers of the projections, never read here.\n *\n * A node is one of:\n *  - a structural route (`source: \"route\"`), keyed by its normalized full path,\n *    merging a layout route's declaration (crumb) with its index child's (kind,\n *    sitemap policy) when both resolve to the same URL;\n *  - a content instance (`source` = the collection's label), keyed by the page URL\n *    and carrying page-level metadata.\n *\n * Edges: `crumb-parent` (breadcrumb ancestry), `related` (deliberate cross-links),\n * `collection-member` (membership in a curated set), and `redirect` (route aliases).\n * The route walk emits crumb/related/redirect edges from declarations; a collection\n * may declare any additional edges its instances need.\n */\n\nimport type { AnyRoute } from \"@tanstack/react-router\";\n\nimport { applyTitleTemplate, type PublicPath, type RouteSeo, type SeoKind } from \"./declare\";\n\n/**\n * Where a node came from: `\"route\"` for a structural route declaration, or the\n * `source` label of the collection that produced the instance (e.g. \"blog\").\n */\nexport type SeoSource = string;\n\nexport interface SeoNode {\n  /** Canonical path, no origin (e.g. \"/pricing\", \"/blog/my-post\"). */\n  path: string;\n  kind: SeoKind;\n  source: SeoSource;\n  /** Route-declared authored-document mode, inherited by collection instances. */\n  markdown?: \"rendered\" | \"source\" | undefined;\n  /** Group label for llms.txt, inherited by collection instances. */\n  llms?: string | undefined;\n  /** Route-declared policy, or synthesized (kind + inherited sitemap) for instances. */\n  policy: RouteSeo;\n  /**\n   * The head the page ships: a static route's declared `head`, or an instance's\n   * title (through its route's `titleTemplate`) and description. Absent when the\n   * route computes its head at request time and no collection supplies it.\n   */\n  head?: SeoNodeHead | undefined;\n  instance?:\n    | {\n        title: string;\n        description?: string | undefined;\n        publishedAt?: string | undefined;\n        modifiedAt?: string | undefined;\n      }\n    | undefined;\n}\n\n/**\n * A node's head as graph data: the full title, description, and FAQ text. An\n * instance without a description still carries its title.\n */\nexport interface SeoNodeHead {\n  readonly title: string;\n  readonly description?: string | undefined;\n  readonly faqs?: ReadonlyArray<{ readonly question: string; readonly answer: string }> | undefined;\n}\n\nexport type SeoEdgeType = \"crumb-parent\" | \"related\" | \"redirect\" | \"collection-member\";\n\nexport interface SeoEdge {\n  from: string;\n  to: string;\n  type: SeoEdgeType;\n}\n\nexport interface SeoGraph {\n  nodes: Map<string, SeoNode>;\n  edges: Array<SeoEdge>;\n  /** Exact-path ownership conflicts encountered while assembling graph sources. */\n  collisions?: ReadonlyArray<{ path: string; sources: ReadonlyArray<SeoSource> }> | undefined;\n}\n\n/** One concrete page produced by a collection. */\nexport interface SeoInstance {\n  /** Canonical path of the page (e.g. \"/blog/my-post\"). */\n  readonly path: string;\n  readonly title: string;\n  readonly description?: string | undefined;\n  readonly publishedAt?: string | undefined;\n  readonly modifiedAt?: string | undefined;\n}\n\nexport interface SeoCollection {\n  /**\n   * The param route these instances render through (e.g. \"/blog/$slug\"). Instances\n   * inherit this route's declared policy (kind + sitemap) — the graph reads it from\n   * the structural node, so declarations stay the single source of truth.\n   */\n  readonly route: PublicPath;\n  /** The `source` stamped on every node this collection produces (e.g. \"blog\"). */\n  readonly source: SeoSource;\n  readonly instances: ReadonlyArray<SeoInstance>;\n  /** Edges the collection declares between its instances and the rest of the graph. */\n  readonly edges?: ReadonlyArray<SeoEdge> | undefined;\n}\n\n/**\n * The structural route shape the graph walks: a TanStack route tree has it\n * before `init()`, and an adapter can build it from parsed route files.\n */\nexport interface SeoRouteNode {\n  readonly options: {\n    readonly path?: string | undefined;\n    readonly staticData?:\n      | {\n          readonly seo?: RouteSeo | undefined;\n          readonly markdown?: SeoNode[\"markdown\"];\n          readonly llms?: SeoNode[\"llms\"];\n        }\n      | undefined;\n  };\n  readonly children?: ReadonlyArray<SeoRouteNode> | undefined;\n}\n\nexport interface BuildSeoGraphInput {\n  readonly routeTree: AnyRoute | SeoRouteNode;\n  readonly collections?: ReadonlyArray<SeoCollection> | undefined;\n}\n\n/** Kind for instances whose collection route carries no declaration to inherit. */\nconst FALLBACK_KIND: SeoKind = \"page\";\n\n\n/**\n * Join a child's local path onto its parent's computed full path with the same\n * semantics as TanStack's route init (relative segments, index \"/\" inherits the\n * parent, pathless/group routes are transparent), then normalize trailing slashes.\n */\nfunction joinPath(parent: string, seg: string | undefined): string {\n  if (seg === undefined) return parent; // pathless layout / route group\n  if (seg === \"/\") return parent; // index route resolves to its parent's URL\n  const trimmed = seg.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\");\n  const joined = `${parent === \"/\" ? \"\" : parent}/${trimmed}`;\n  return joined.replace(/\\/{2,}/g, \"/\");\n}\n\n/** A route's declared head as graph data: templated title, description, and plain FAQs. */\nfunction declaredHead(seo: RouteSeo): SeoNodeHead | undefined {\n  if (seo.head === undefined) return undefined;\n  return {\n    title: applyTitleTemplate(seo.titleTemplate, seo.head.title),\n    description: seo.head.description,\n    faqs: seo.head.faqs?.map(({ question, answer }) => ({ question, answer })),\n  };\n}\n\n/** Merge a route's declaration into an existing same-path node (deeper route wins). */\nfunction mergeSeo(base: RouteSeo, override: RouteSeo): RouteSeo {\n  return {\n    kind: override.kind,\n    crumb: override.crumb ?? base.crumb,\n    sitemap: override.sitemap ?? base.sitemap,\n    robots: override.robots ?? base.robots,\n    related: override.related ?? base.related,\n    link: override.link ?? base.link,\n    redirectTo: override.redirectTo ?? base.redirectTo,\n    modifiedAt: override.modifiedAt ?? base.modifiedAt,\n    head: override.head ?? base.head,\n    titleTemplate: override.titleTemplate ?? base.titleTemplate,\n  };\n}\n\n/**\n * Walk the route tree building structural nodes and crumb-parent edges. `crumbStack`\n * holds the paths of crumb-declaring ancestors so each crumb node links to its nearest\n * crumb ancestor down the real route-parent chain (matching render-time breadcrumbs).\n */\nfunction walkRoutes(\n  route: SeoRouteNode,\n  parentPath: string,\n  isRoot: boolean,\n  nodes: Map<string, SeoNode>,\n  edges: Array<SeoEdge>,\n  crumbStack: Array<string>,\n): void {\n  const path = isRoot ? \"/\" : joinPath(parentPath, route.options.path);\n  const data = route.options.staticData;\n  const seo = data?.seo;\n\n  if (seo || data?.markdown !== undefined || data?.llms !== undefined) {\n    const existing = nodes.get(path);\n    if (existing) {\n      if (seo) existing.policy = mergeSeo(existing.policy, seo);\n      existing.kind = existing.policy.kind;\n      // A head renders with its own route's template, never one merged from a layout.\n      existing.head = (seo && declaredHead(seo)) ?? existing.head;\n      existing.markdown = data?.markdown ?? existing.markdown;\n      existing.llms = data?.llms ?? existing.llms;\n    } else {\n      const policy = seo ?? { kind: FALLBACK_KIND };\n      nodes.set(path, {\n        path,\n        kind: policy.kind,\n        source: \"route\",\n        policy: { ...policy },\n        head: seo && declaredHead(seo),\n        markdown: data?.markdown,\n        llms: data?.llms,\n      });\n    }\n\n    const nearestCrumbAncestor = crumbStack[crumbStack.length - 1];\n    if (seo?.crumb !== undefined && nearestCrumbAncestor !== undefined) {\n      edges.push({ from: path, to: nearestCrumbAncestor, type: \"crumb-parent\" });\n    }\n  }\n\n  const pushedCrumb = seo?.crumb !== undefined;\n  if (pushedCrumb) crumbStack.push(path);\n  for (const child of route.children ?? []) {\n    walkRoutes(child, path, false, nodes, edges, crumbStack);\n  }\n  if (pushedCrumb) crumbStack.pop();\n}\n\n/**\n * Add one collection's instance nodes, inheriting kind + sitemap policy from the\n * collection route's declaration, then append the edges it declares. A path already\n * owned by another node is a collision: the first owner keeps the path and the\n * conflict is reported (the `path-owner-collision` check turns it into a violation).\n */\nfunction addCollection(\n  nodes: Map<string, SeoNode>,\n  edges: Array<SeoEdge>,\n  collisions: Array<{ path: string; sources: ReadonlyArray<SeoSource> }>,\n  collection: SeoCollection,\n): void {\n  const collectionNode = nodes.get(collection.route);\n  const kind = collectionNode?.kind ?? FALLBACK_KIND;\n  const sitemap = collectionNode?.policy.sitemap;\n  const titleTemplate = collectionNode?.policy.titleTemplate;\n\n  /**\n   * Paths this collection lost to an earlier owner. Their instances never enter\n   * the graph, so any edge declared out of them would dangle — and the dead-edge\n   * check only validates an edge's `to`, so nothing downstream would catch it.\n   */\n  const rejected = new Set<string>();\n\n  for (const instance of collection.instances) {\n    const existing = nodes.get(instance.path);\n    if (existing) {\n      collisions.push({ path: instance.path, sources: [existing.source, collection.source] });\n      rejected.add(instance.path);\n      continue;\n    }\n    nodes.set(instance.path, {\n      path: instance.path,\n      kind,\n      source: collection.source,\n      markdown: collectionNode?.markdown,\n      llms: collectionNode?.llms,\n      policy: { kind, sitemap },\n      head: { title: applyTitleTemplate(titleTemplate, instance.title), description: instance.description },\n      instance: {\n        title: instance.title,\n        description: instance.description,\n        publishedAt: instance.publishedAt,\n        modifiedAt: instance.modifiedAt,\n      },\n    });\n  }\n\n  for (const edge of collection.edges ?? []) {\n    if (rejected.has(edge.from)) continue;\n    edges.push(edge);\n  }\n}\n\n/**\n * Build the SEO graph from route declarations and content collections.\n *\n * Synchronous: the caller materializes its collections before calling, so there is\n * no async work here. Callers own the origin.\n */\nexport function buildSeoGraph(input: BuildSeoGraphInput): SeoGraph {\n  const nodes = new Map<string, SeoNode>();\n  const edges: Array<SeoEdge> = [];\n  const collisions: Array<{ path: string; sources: ReadonlyArray<SeoSource> }> = [];\n\n  walkRoutes(input.routeTree as unknown as SeoRouteNode, \"/\", true, nodes, edges, []);\n\n  for (const collection of input.collections ?? []) {\n    addCollection(nodes, edges, collisions, collection);\n  }\n\n  for (const node of nodes.values()) {\n    if (node.source !== \"route\") continue;\n    for (const to of node.policy.related ?? []) {\n      edges.push({ from: node.path, to, type: \"related\" });\n    }\n    if (node.policy.redirectTo !== undefined) {\n      edges.push({ from: node.path, to: node.policy.redirectTo, type: \"redirect\" });\n    }\n  }\n\n  return { nodes, edges, collisions };\n}\n"],"mappings":"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"}

package/dist/index-C5w9ripz.d.ts

@@ -0,0 +1,204 @@
+import { a as SeoGraph, h as RouteSeo, n as SeoCollection, o as SeoInstance, p as PublicPath, r as SeoEdge, s as SeoNode, u as SeoSource } from "./graph-D1PIndsC.js";
+import { N as SimpleEdge, w as AnchorRegion } from "./content-DgNr7apS.js";
+import { f as Message, m as SectionDocument, p as PageDocument } from "./page-heads-BfjWQvau.js";
+import "./projections-Bk-qOOsR.js";
+import { AnyRouter } from "@tanstack/react-router";
+//#region src/markdown/hash.d.ts
+declare const contentHash: (value: unknown) => string;
+//#endregion
+//#region src/markdown/markdown.d.ts
+interface MarkdownWriter {
+  text(value: Message | string | undefined): string;
+  heading(level: number, value: Message | string | undefined): string;
+  table(rows: ReadonlyArray<ReadonlyArray<Message | string>>): string;
+}
+interface SectionKind {
+  readonly kind: string;
+  readonly markdown: (section: SectionDocument, md: MarkdownWriter) => string;
+}
+/** A kind can be passed directly to Section; importing its definition registers its serializer. */
+declare function defineSectionKind<const K extends string>(definition: SectionKind & {
+  kind: K;
+}): SectionKind & {
+  kind: K;
+};
+declare function sectionMarkdown(section: SectionDocument, options?: {
+  includeHumans?: boolean;
+}): string;
+/** One public twin, in authored section order. Human-only messages never enter it. */
+declare function documentMarkdown(document: PageDocument, site: string): string;
+//#endregion
+//#region src/markdown/llms.d.ts
+interface LlmsPage {
+  document: Pick<PageDocument, "path" | "title" | "description">;
+  llms?: string;
+}
+declare function llmsSection(path: string): string;
+declare function llmsMarkdown(pages: ReadonlyArray<LlmsPage>, site: string): string;
+//#endregion
+//#region src/markdown/lock.d.ts
+/** Stable, reviewable snapshot of document and message hashes with source locations. */
+interface MarkdownLock {
+  readonly version: 1;
+  readonly pages: Readonly<Record<string, {
+    readonly document: string;
+    readonly messages: Readonly<Record<string, string>>;
+  }>>;
+}
+/** Build the v1 lock without changing document hashes, message hashes, or sources. */
+declare function createMarkdownLock(documents: ReadonlyArray<PageDocument>): MarkdownLock;
+//#endregion
+//#region src/core/collections.d.ts
+/** What a page contributes: its instance metadata plus the paths it links to deliberately. */
+interface ContentEntry extends Omit<SeoInstance, "path"> {
+  /** Defaults to the page's `url`. */
+  readonly path?: string | undefined;
+  /** Deliberate cross-links, emitted as `related` edges from this page. */
+  readonly related?: ReadonlyArray<string> | undefined;
+}
+interface ContentCollectionOptions<Page> {
+  /** The param route these pages render through, e.g. `/blog/$slug`. */
+  readonly route: PublicPath;
+  /** The `source` label stamped on every node, e.g. `"blog"`. */
+  readonly source: SeoSource;
+  readonly pages: ReadonlyArray<Page>;
+  /** Map one page to its entry; decode frontmatter here. */
+  readonly entry: (page: Page) => ContentEntry;
+  /** Edges beyond `related` (crumb parents, collection membership). */
+  readonly edges?: ReadonlyArray<SeoEdge> | undefined;
+}
+declare function contentCollection<Page extends {
+  readonly url: string;
+}>(options: ContentCollectionOptions<Page>): SeoCollection;
+//#endregion
+//#region src/core/wire.d.ts
+interface SeoGraphJson {
+  readonly nodes: ReadonlyArray<SeoNode>;
+  readonly edges: ReadonlyArray<SeoEdge>;
+  readonly collisions?: ReadonlyArray<{
+    readonly path: string;
+    readonly sources: ReadonlyArray<SeoSource>;
+  }> | undefined;
+}
+declare function graphToJson(graph: SeoGraph): SeoGraphJson;
+declare function graphFromJson(json: SeoGraphJson): SeoGraph;
+//#endregion
+//#region src/core/link-candidates.d.ts
+/** One proposed contextual link, in the direction the link would be authored. */
+interface LinkCandidatePair {
+  readonly source: string;
+  readonly destination: string;
+  /** The cluster the pair shares: a top-level section, or `kind:<kind>`. */
+  readonly cluster: string;
+  /** Why the pair is plausible, e.g. `same top-level section "/blog"`. */
+  readonly reason: string;
+}
+interface LinkCandidateOptions {
+  /** Maximum candidates to return after ordering (default 50). */
+  readonly limit?: number;
+  /** Restrict to these clusters; a filter may be a section or a bare kind. */
+  readonly clusters?: ReadonlyArray<string>;
+  /** Anchors already served in HTML. Only body-region edges exclude their own direction. */
+  readonly renderedEdges?: ReadonlyArray<SimpleEdge & {
+    readonly region?: AnchorRegion;
+  }>;
+}
+/** One cluster and how many candidate pairs it contributes (before `limit`). */
+interface LinkClusterSummary {
+  readonly key: string;
+  readonly candidates: number;
+}
+interface LinkCandidateResult {
+  readonly candidates: ReadonlyArray<LinkCandidatePair>;
+  /** Candidate pairs before `limit` was applied (after cluster filters). */
+  readonly total: number;
+  readonly truncated: boolean;
+  readonly clusters: ReadonlyArray<LinkClusterSummary>;
+}
+/** Directionless pair key, so an edge in either direction means "connected". */
+declare const undirectedEdgeKey: (from: string, to: string) => string;
+/** A `--cluster` filter matches a section by name, or a kind via its bare label. */
+declare const matchesClusterFilter: (cluster: string, filter: string) => boolean;
+/** Human reason string for a candidate's source page, used when handing a plan to Jev. */
+declare const candidateSourceText: (node: SeoNode) => string;
+/**
+ * Enumerate reviewable contextual-link candidates from the declared graph.
+ *
+ * Excluded: self-pairs, pages that are not sitemap-eligible, pairs already
+ * declared as a `related` edge, and — when {@link LinkCandidateOptions.renderedEdges}
+ * is supplied — pairs already rendered as an anchor. Queries, hashes, and
+ * trailing slashes are normalized so both sides compare by the graph's path key.
+ */
+declare const generateLinkCandidates: (graph: SeoGraph, options?: LinkCandidateOptions) => LinkCandidateResult;
+/**
+ * Decode a rendered-edge dump supplied to the CLI: either a bare array of
+ * `{ from, to }` edges, or an object carrying `edges` (or `internalEdges`).
+ * Throws on any other shape — this is user input, not a provider payload.
+ */
+declare const decodeRenderedEdges: (input: unknown) => ReadonlyArray<SimpleEdge & {
+  readonly region?: AnchorRegion;
+}>;
+//#endregion
+//#region src/core/inspect-html.d.ts
+/**
+ * Read a rendered `<head>` and validate it: title, meta
+ * (description/robots/og/twitter), canonical link, and `application/ld+json`
+ * blocks, with a minimal per-type JSON-LD check.
+ *
+ * This is the pure half of `pagegraph inspect --live` — the half worth having on its
+ * own. The CLI fetches a URL and hands the body here; a test suite can render a
+ * page and hand *that* here, asserting the head it actually ships. Both get the
+ * same verdict, because it is the same function.
+ *
+ * No HTML-parsing dependency, by design: a `<head>` is small and well-formed, so
+ * string/regex scanning is enough, and the package's core stays zero-dependency
+ * (which is also why the object guard below is hand-rolled — `effect/Predicate`
+ * is not reachable from this entry). It is honest about its limits: it does not
+ * build a DOM, so exotic markup (commented-out tags, CDATA, attributes spanning
+ * constructs) is out of scope. This validates *rendered output*, not arbitrary
+ * HTML.
+ *
+ * `issues` are blocking: a non-empty list makes `pagegraph inspect --live` exit 1.
+ * Required tags are `<title>`, `meta[name=description]`, and
+ * `link[rel=canonical]`; any JSON-LD that fails to parse or fails its minimal
+ * schema is also blocking.
+ */
+interface JsonLdReport {
+  type: string;
+  valid: boolean;
+  errors: Array<string>;
+}
+interface LiveHeadReport {
+  url: string;
+  status: number;
+  title?: string | undefined;
+  description?: string | undefined;
+  canonical?: string | undefined;
+  robots?: string | undefined;
+  og: Record<string, string>;
+  twitter: Record<string, string>;
+  jsonLd: Array<JsonLdReport>;
+  issues: Array<string>;
+}
+/** Parse a rendered HTML document's `<head>` into a report. Pure. */
+declare const inspectHtml: (url: string, status: number, html: string) => LiveHeadReport;
+/** A non-empty `issues` list fails `pagegraph inspect --live` (exit 1). */
+declare const hasBlockingIssues: (report: LiveHeadReport) => boolean;
+//#endregion
+//#region src/core/resolve-route-link.d.ts
+/**
+ * Resolve a route's declared `seo.link` card (title + description) by its full
+ * path.
+ *
+ * `useRouter()` returns a Router typed to this app's exact route tree, so
+ * `routesByPath` is keyed by the literal `FileRouteTypes["fullPaths"]` union —
+ * but callers here (declared `related` targets) hold arbitrary runtime path
+ * strings, not that literal type. `routesByPath` and `routesById` are plain
+ * Records on every Router instance regardless of which route tree it's
+ * parameterized over, so this narrows to that structural shape once, at this
+ * boundary, instead of threading an `AnyRoute` cast through every call site.
+ */
+declare function resolveRouteLink(router: AnyRouter, path: string): RouteSeo["link"];
+//#endregion
+export { sectionMarkdown as A, LlmsPage as C, SectionKind as D, MarkdownWriter as E, defineSectionKind as O, createMarkdownLock as S, llmsSection as T, graphToJson as _, inspectHtml as a, contentCollection as b, LinkCandidateResult as c, decodeRenderedEdges as d, generateLinkCandidates as f, graphFromJson as g, SeoGraphJson as h, hasBlockingIssues as i, contentHash as j, documentMarkdown as k, LinkClusterSummary as l, undirectedEdgeKey as m, JsonLdReport as n, LinkCandidateOptions as o, matchesClusterFilter as p, LiveHeadReport as r, LinkCandidatePair as s, resolveRouteLink as t, candidateSourceText as u, ContentCollectionOptions as v, llmsMarkdown as w, MarkdownLock as x, ContentEntry as y };
+//# sourceMappingURL=index-C5w9ripz.d.ts.map