pagegraph 0.11.0 → 0.13.0

package/dist/oxlint.js

@@ -0,0 +1,202 @@
+//#region src/oxlint/no-bare-text.js
+function importedDocumentNames(program) {
+	const namespaces = /* @__PURE__ */ new Set();
+	const suppressNames = /* @__PURE__ */ new Set();
+	let runtimeImport = false;
+	for (const declaration of program.body) {
+		if (declaration.type !== "ImportDeclaration" || declaration.source.value !== "pagegraph/react" || declaration.importKind === "type") continue;
+		if (declaration.specifiers.length === 0) runtimeImport = true;
+		for (const specifier of declaration.specifiers) if (specifier.type === "ImportSpecifier" && specifier.importKind !== "type") {
+			const imported = specifier.imported.name ?? specifier.imported.value;
+			if ([
+				"T",
+				"Title",
+				"ForHumans"
+			].includes(imported)) suppressNames.add(specifier.local.name);
+			runtimeImport = true;
+		} else if (specifier.type === "ImportNamespaceSpecifier") {
+			namespaces.add(specifier.local.name);
+			runtimeImport = true;
+		} else if (specifier.type === "ImportDefaultSpecifier") runtimeImport = true;
+	}
+	return {
+		namespaces,
+		suppressNames,
+		runtimeImport
+	};
+}
+function jsxName(node) {
+	if (node.type === "JSXIdentifier") return [node.name];
+	if (node.type === "JSXMemberExpression") return [...jsxName(node.object), node.property.name];
+	return [];
+}
+function matchesFiles(filename, files) {
+	if (!files?.length) return true;
+	const normalized = filename.replaceAll("\\", "/");
+	return files.some((pattern) => {
+		const escaped = pattern.replace(/[|\\{}()[\]^$+?.]/g, "\\$&");
+		return new RegExp(`(?:^|/)${escaped.replaceAll("**", "§").replaceAll("*", "[^/]*").replaceAll("§", ".*")}$`).test(normalized);
+	});
+}
+function* literalLabels(expression, stringsOnly = false) {
+	switch (expression.type) {
+		case "Literal":
+			if (typeof expression.value === "string" || !stringsOnly && typeof expression.value === "number") yield expression;
+			break;
+		case "ConditionalExpression":
+			yield* literalLabels(expression.consequent, stringsOnly);
+			yield* literalLabels(expression.alternate, stringsOnly);
+			break;
+		case "LogicalExpression":
+			if (expression.operator !== "&&") yield* literalLabels(expression.left, stringsOnly);
+			yield* literalLabels(expression.right, stringsOnly);
+			break;
+		case "BinaryExpression":
+			if (expression.operator === "+") {
+				yield* literalLabels(expression.left, true);
+				yield* literalLabels(expression.right, true);
+			}
+			break;
+		case "TemplateLiteral":
+			if (expression.quasis.some((part) => part.value.raw.trim())) yield expression;
+			for (const interpolation of expression.expressions) yield* literalLabels(interpolation, true);
+	}
+}
+var no_bare_text_default = {
+	meta: {
+		type: "problem",
+		docs: { description: "Require customer-facing text to use pagegraph primitives." },
+		schema: [{
+			type: "object",
+			properties: { files: {
+				type: "array",
+				items: { type: "string" }
+			} },
+			additionalProperties: false
+		}]
+	},
+	create(context) {
+		const files = context.options[0]?.files;
+		if (!matchesFiles(context.filename, files)) return {};
+		let active = false;
+		let names;
+		const suppressedRanges = [];
+		const attributeExpressions = /* @__PURE__ */ new Set();
+		const report = (node) => context.report({
+			node,
+			message: "Wrap customer-facing text in T, Title, or ForHumans."
+		});
+		const isSuppressed = (node) => suppressedRanges.some(([start, end]) => node.start >= start && node.end <= end);
+		return {
+			Program(node) {
+				const imports = importedDocumentNames(node);
+				active = imports.runtimeImport;
+				names = imports;
+			},
+			JSXElement(node) {
+				const parts = jsxName(node.openingElement.name);
+				const suppressed = parts.length === 1 && names.suppressNames.has(parts[0]) || parts.length === 2 && names.namespaces.has(parts[0]) && [
+					"T",
+					"Title",
+					"ForHumans"
+				].includes(parts[1]);
+				if (active && suppressed) suppressedRanges.push([node.start, node.end]);
+			},
+			JSXText(node) {
+				if (active && !isSuppressed(node) && node.value.trim()) report(node);
+			},
+			JSXAttribute(node) {
+				if (active && node.value?.type === "JSXExpressionContainer") attributeExpressions.add(node.value.start);
+			},
+			JSXExpressionContainer(node) {
+				if (active && !attributeExpressions.has(node.start) && !isSuppressed(node)) for (const label of literalLabels(node.expression)) report(label);
+			}
+		};
+	}
+};
+//#endregion
+//#region src/oxlint/t-children.js
+const INLINE_TAGS = /* @__PURE__ */ new Set([
+	"em",
+	"strong",
+	"a",
+	"code",
+	"br"
+]);
+function importedTNames(program) {
+	const named = /* @__PURE__ */ new Set();
+	const facts = /* @__PURE__ */ new Set();
+	const namespaces = /* @__PURE__ */ new Set();
+	for (const declaration of program.body) {
+		if (declaration.type !== "ImportDeclaration" || declaration.source.value !== "pagegraph/react" || declaration.importKind === "type") continue;
+		for (const specifier of declaration.specifiers) if (specifier.type === "ImportSpecifier" && specifier.importKind !== "type") {
+			const imported = specifier.imported.name ?? specifier.imported.value;
+			if (imported === "T" || imported === "Title") named.add(specifier.local.name);
+			if (imported === "Fact") facts.add(specifier.local.name);
+		} else if (specifier.type === "ImportNamespaceSpecifier") namespaces.add(specifier.local.name);
+	}
+	return {
+		named,
+		facts,
+		namespaces
+	};
+}
+function parts(node) {
+	if (node.type === "JSXIdentifier") return [node.name];
+	if (node.type === "JSXMemberExpression") return [...parts(node.object), node.property.name];
+	return [];
+}
+function isT(node, names) {
+	const path = parts(node);
+	return path.length === 1 && names.named.has(path[0]) || path.length === 2 && names.namespaces.has(path[0]) && ["T", "Title"].includes(path[1]);
+}
+function allowedElement(node, names) {
+	const path = parts(node);
+	if (path.length === 1 && INLINE_TAGS.has(path[0])) return true;
+	if (path.length === 1 && names.facts.has(path[0])) return true;
+	return path.length === 2 && names.namespaces.has(path[0]) && path[1] === "Fact";
+}
+//#endregion
+//#region src/oxlint/index.js
+var oxlint_default = {
+	meta: { name: "pagegraph" },
+	rules: {
+		"no-bare-text": no_bare_text_default,
+		"t-children": {
+			meta: {
+				type: "problem",
+				docs: { description: "Restrict T and Title children to plain text and approved inline content." }
+			},
+			create(context) {
+				const stack = [];
+				let names;
+				return {
+					Program(node) {
+						names = importedTNames(node);
+					},
+					JSXElement(node) {
+						const parent = stack.at(-1);
+						if (parent?.insideT && !allowedElement(node.openingElement.name, names)) context.report({
+							node: node.openingElement.name,
+							message: "T and Title accept text, em, strong, a, code, br, and Fact only."
+						});
+						stack.push({ insideT: isT(node.openingElement.name, names) || Boolean(parent?.insideT) });
+					},
+					"JSXElement:exit"() {
+						stack.pop();
+					},
+					JSXFragment(node) {
+						if (stack.at(-1)?.insideT) context.report({
+							node,
+							message: "T and Title accept text, em, strong, a, code, br, and Fact only; fragments are not supported."
+						});
+					}
+				};
+			}
+		}
+	}
+};
+//#endregion
+export { oxlint_default as default };
+
+//# sourceMappingURL=oxlint.js.map

package/dist/oxlint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"oxlint.js","names":["noBareText","tChildren"],"sources":["../src/oxlint/no-bare-text.js","../src/oxlint/t-children.js","../src/oxlint/index.js"],"sourcesContent":["function importedDocumentNames(program) {\n  const namespaces = new Set();\n  const suppressNames = new Set();\n  let runtimeImport = false;\n  for (const declaration of program.body) {\n    if (\n      declaration.type !== \"ImportDeclaration\" ||\n      declaration.source.value !== \"pagegraph/react\" ||\n      declaration.importKind === \"type\"\n    )\n      continue;\n    if (declaration.specifiers.length === 0) runtimeImport = true;\n    for (const specifier of declaration.specifiers) {\n      if (specifier.type === \"ImportSpecifier\" && specifier.importKind !== \"type\") {\n        const imported = specifier.imported.name ?? specifier.imported.value;\n        if ([\"T\", \"Title\", \"ForHumans\"].includes(imported)) suppressNames.add(specifier.local.name);\n        runtimeImport = true;\n      } else if (specifier.type === \"ImportNamespaceSpecifier\") {\n        namespaces.add(specifier.local.name);\n        runtimeImport = true;\n      } else if (specifier.type === \"ImportDefaultSpecifier\") runtimeImport = true;\n    }\n  }\n  return { namespaces, suppressNames, runtimeImport };\n}\n\nfunction jsxName(node) {\n  if (node.type === \"JSXIdentifier\") return [node.name];\n  if (node.type === \"JSXMemberExpression\") return [...jsxName(node.object), node.property.name];\n  return [];\n}\n\nfunction matchesFiles(filename, files) {\n  if (!files?.length) return true;\n  const normalized = filename.replaceAll(\"\\\\\", \"/\");\n  return files.some((pattern) => {\n    const escaped = pattern.replace(/[|\\\\{}()[\\]^$+?.]/g, \"\\\\$&\");\n    const regex = new RegExp(\n      `(?:^|/)${escaped.replaceAll(\"**\", \"§\").replaceAll(\"*\", \"[^/]*\").replaceAll(\"§\", \".*\")}$`,\n    );\n    return regex.test(normalized);\n  });\n}\n\nfunction* literalLabels(expression, stringsOnly = false) {\n  switch (expression.type) {\n    case \"Literal\":\n      if (\n        typeof expression.value === \"string\" ||\n        (!stringsOnly && typeof expression.value === \"number\")\n      )\n        yield expression;\n      break;\n    case \"ConditionalExpression\":\n      yield* literalLabels(expression.consequent, stringsOnly);\n      yield* literalLabels(expression.alternate, stringsOnly);\n      break;\n    case \"LogicalExpression\":\n      // A truthy string on the left of && is only a guard, never the returned child.\n      if (expression.operator !== \"&&\") yield* literalLabels(expression.left, stringsOnly);\n      yield* literalLabels(expression.right, stringsOnly);\n      break;\n    case \"BinaryExpression\":\n      // Comparisons and numeric arithmetic consume their literals rather than displaying them.\n      if (expression.operator === \"+\") {\n        yield* literalLabels(expression.left, true);\n        yield* literalLabels(expression.right, true);\n      }\n      break;\n    case \"TemplateLiteral\":\n      if (expression.quasis.some((part) => part.value.raw.trim())) yield expression;\n      for (const interpolation of expression.expressions) yield* literalLabels(interpolation, true);\n      break;\n  }\n}\n\nexport default {\n  meta: {\n    type: \"problem\",\n    docs: { description: \"Require customer-facing text to use pagegraph primitives.\" },\n    schema: [\n      {\n        type: \"object\",\n        properties: { files: { type: \"array\", items: { type: \"string\" } } },\n        additionalProperties: false,\n      },\n    ],\n  },\n  create(context) {\n    const files = context.options[0]?.files;\n    if (!matchesFiles(context.filename, files)) return {};\n    let active = false;\n    let names;\n    const suppressedRanges = [];\n    const attributeExpressions = new Set();\n    const report = (node) =>\n      context.report({ node, message: \"Wrap customer-facing text in T, Title, or ForHumans.\" });\n    const isSuppressed = (node) =>\n      suppressedRanges.some(([start, end]) => node.start >= start && node.end <= end);\n    return {\n      Program(node) {\n        const imports = importedDocumentNames(node);\n        active = imports.runtimeImport;\n        names = imports;\n      },\n      JSXElement(node) {\n        const parts = jsxName(node.openingElement.name);\n        const suppressed =\n          (parts.length === 1 && names.suppressNames.has(parts[0])) ||\n          (parts.length === 2 &&\n            names.namespaces.has(parts[0]) &&\n            [\"T\", \"Title\", \"ForHumans\"].includes(parts[1]));\n        if (active && suppressed) suppressedRanges.push([node.start, node.end]);\n      },\n      JSXText(node) {\n        if (active && !isSuppressed(node) && node.value.trim()) report(node);\n      },\n      JSXAttribute(node) {\n        // Exempt the prop value itself; nested JSX has its own children to check.\n        if (active && node.value?.type === \"JSXExpressionContainer\")\n          attributeExpressions.add(node.value.start);\n      },\n      JSXExpressionContainer(node) {\n        if (active && !attributeExpressions.has(node.start) && !isSuppressed(node))\n          for (const label of literalLabels(node.expression)) report(label);\n      },\n    };\n  },\n};\n","const INLINE_TAGS = new Set([\"em\", \"strong\", \"a\", \"code\", \"br\"]);\n\nfunction importedTNames(program) {\n  const named = new Set();\n  const facts = new Set();\n  const namespaces = new Set();\n  for (const declaration of program.body) {\n    if (\n      declaration.type !== \"ImportDeclaration\" ||\n      declaration.source.value !== \"pagegraph/react\" ||\n      declaration.importKind === \"type\"\n    )\n      continue;\n    for (const specifier of declaration.specifiers) {\n      if (specifier.type === \"ImportSpecifier\" && specifier.importKind !== \"type\") {\n        const imported = specifier.imported.name ?? specifier.imported.value;\n        if (imported === \"T\" || imported === \"Title\") named.add(specifier.local.name);\n        if (imported === \"Fact\") facts.add(specifier.local.name);\n      } else if (specifier.type === \"ImportNamespaceSpecifier\")\n        namespaces.add(specifier.local.name);\n    }\n  }\n  return { named, facts, namespaces };\n}\n\nfunction parts(node) {\n  if (node.type === \"JSXIdentifier\") return [node.name];\n  if (node.type === \"JSXMemberExpression\") return [...parts(node.object), node.property.name];\n  return [];\n}\n\nfunction isT(node, names) {\n  const path = parts(node);\n  return (\n    (path.length === 1 && names.named.has(path[0])) ||\n    (path.length === 2 && names.namespaces.has(path[0]) && [\"T\", \"Title\"].includes(path[1]))\n  );\n}\n\nfunction allowedElement(node, names) {\n  const path = parts(node);\n  if (path.length === 1 && INLINE_TAGS.has(path[0])) return true;\n  if (path.length === 1 && names.facts.has(path[0])) return true;\n  return path.length === 2 && names.namespaces.has(path[0]) && path[1] === \"Fact\";\n}\n\nexport default {\n  meta: {\n    type: \"problem\",\n    docs: { description: \"Restrict T and Title children to plain text and approved inline content.\" },\n  },\n  create(context) {\n    const stack = [];\n    let names;\n    return {\n      Program(node) {\n        names = importedTNames(node);\n      },\n      JSXElement(node) {\n        const parent = stack.at(-1);\n        if (parent?.insideT && !allowedElement(node.openingElement.name, names)) {\n          context.report({\n            node: node.openingElement.name,\n            message: \"T and Title accept text, em, strong, a, code, br, and Fact only.\",\n          });\n        }\n        stack.push({ insideT: isT(node.openingElement.name, names) || Boolean(parent?.insideT) });\n      },\n      \"JSXElement:exit\"() {\n        stack.pop();\n      },\n      JSXFragment(node) {\n        if (stack.at(-1)?.insideT)\n          context.report({\n            node,\n            message:\n              \"T and Title accept text, em, strong, a, code, br, and Fact only; fragments are not supported.\",\n          });\n      },\n    };\n  },\n};\n","import noBareText from \"./no-bare-text.js\";\nimport tChildren from \"./t-children.js\";\n\nexport default {\n  meta: { name: \"pagegraph\" },\n  rules: { \"no-bare-text\": noBareText, \"t-children\": tChildren },\n};\n"],"mappings":"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"}

package/dist/page-heads-BfjWQvau.d.ts

@@ -0,0 +1,108 @@
+import { a as SeoGraph, s as SeoNode } from "./graph-D1PIndsC.js";
+//#region src/markdown/document.d.ts
+type InlineNode = string | {
+  readonly fact: string;
+  readonly text: string;
+} | {
+  readonly tag: "em" | "strong" | "a" | "code" | "br";
+  readonly href?: string;
+  readonly children: ReadonlyArray<InlineNode>;
+};
+interface Message {
+  readonly hash: string;
+  readonly tree: ReadonlyArray<InlineNode>;
+  readonly text: string;
+  readonly source: string;
+  readonly facts: ReadonlyArray<string>;
+  readonly audience: "all" | "agents" | "humans";
+}
+interface VisualDocument {
+  readonly type: "visual";
+  readonly text: string;
+  readonly source: string;
+  readonly audience: Message["audience"];
+}
+type BodyEntry = {
+  readonly type: "message";
+  readonly message: Message;
+} | VisualDocument;
+interface SectionItem {
+  readonly title?: Message;
+  /** Destination recorded from the item's rendered Section.Item.Link anchor. */
+  readonly href?: string;
+  readonly body: ReadonlyArray<BodyEntry>;
+  readonly cells: ReadonlyArray<Message>;
+  readonly source: string;
+  readonly audience: Message["audience"];
+}
+interface SectionDocument {
+  /** Captured with human-only messages included for offline custom serializers. */
+  readonly claimsMarkdown?: string;
+  readonly evidence?: boolean;
+  readonly kind: string;
+  readonly id: string;
+  readonly title?: Message;
+  readonly language?: string;
+  readonly body: ReadonlyArray<BodyEntry>;
+  readonly items: ReadonlyArray<SectionItem>;
+  readonly source: string;
+  readonly audience: Message["audience"];
+}
+interface PageDocument {
+  readonly path: string;
+  readonly hash: string;
+  readonly title: string;
+  readonly description: string;
+  readonly sections: ReadonlyArray<SectionDocument>;
+  readonly messages: ReadonlyArray<Message>;
+  readonly facts: ReadonlyArray<string>;
+}
+/** The document includes resolved values; source relocation alone is not a content edit. */
+declare function hashDocument(document: Omit<PageDocument, "hash">): string;
+//#endregion
+//#region src/markdown/facts.d.ts
+type Json = null | boolean | number | string | ReadonlyArray<Json> | {
+  readonly [key: string]: Json;
+};
+interface FactDefinition {
+  readonly kind: "number" | "money" | "list" | "text";
+  readonly value: Json;
+  readonly text: string;
+  readonly items?: ReadonlyArray<string>;
+}
+type Facts = Readonly<Record<string, FactDefinition>>;
+/** Register code-owned values for ordinary React rendering as well as capture. */
+declare function defineFacts<const F extends Facts>(facts: F): F;
+declare const fact: {
+  number(value: number, options?: Intl.NumberFormatOptions): FactDefinition;
+  money(value: number, options?: {
+    currency?: string;
+    per?: string;
+  }): FactDefinition;
+  list<T extends Json>(values: ReadonlyArray<T>, options?: {
+    format: (value: T) => string;
+  }): FactDefinition;
+  text(value: string): FactDefinition;
+};
+declare function resolveFact(id: string, facts?: Facts): FactDefinition;
+//#endregion
+//#region src/core/page-heads.d.ts
+/** Plain document metadata, without framework or schema dependencies. */
+interface PageHead {
+  readonly path: string;
+  readonly title: string;
+  readonly description: string;
+}
+interface PageHeadsOptions {
+  /** Path globs: `*` matches a segment, `**` matches across segments. */
+  readonly exclude?: ReadonlyArray<string>;
+  /** Exclude noindex pages and redirects. Parameter templates are always excluded. Defaults to true. */
+  readonly indexable?: boolean;
+}
+/** Select page nodes before the host resolves metadata; sitemap-disabled hubs remain pages. */
+declare function selectPageHeadNodes(graph: SeoGraph, options?: PageHeadsOptions): Array<SeoNode>;
+/** Extract resolved heads, naming the selected page when metadata is missing or blank. */
+declare function pageHeads(graph: SeoGraph, options?: PageHeadsOptions): Array<PageHead>;
+//#endregion
+export { hashDocument as _, FactDefinition as a, fact as c, InlineNode as d, Message as f, VisualDocument as g, SectionItem as h, selectPageHeadNodes as i, resolveFact as l, SectionDocument as m, PageHeadsOptions as n, Facts as o, PageDocument as p, pageHeads as r, defineFacts as s, PageHead as t, BodyEntry as u };
+//# sourceMappingURL=page-heads-BfjWQvau.d.ts.map

package/dist/page-heads-BgbaIjj9.js

@@ -0,0 +1,25 @@
+import { a as globToRegExp } from "./checks-BS-aDXB_.js";
+//#region src/core/page-heads.ts
+/** Select page nodes before the host resolves metadata; sitemap-disabled hubs remain pages. */
+function selectPageHeadNodes(graph, options = {}) {
+	const excludes = (options.exclude ?? []).map(globToRegExp);
+	return [...graph.nodes.values()].filter((node) => node.kind !== "layout" && !node.path.includes("$") && (node.policy.sitemap !== void 0 || node.instance !== void 0) && !excludes.some((pattern) => pattern.test(node.path)) && (options.indexable === false || node.policy.redirectTo === void 0 && !node.policy.robots?.toLowerCase().split(/[\s,]+/).includes("noindex")));
+}
+/** Extract resolved heads, naming the selected page when metadata is missing or blank. */
+function pageHeads(graph, options = {}) {
+	return selectPageHeadNodes(graph, options).map((node) => {
+		const title = node.head?.title;
+		const description = node.head?.description;
+		if (!title?.trim()) throw new Error(`Invalid page head for ${node.path}: missing title`);
+		if (!description?.trim()) throw new Error(`Invalid page head for ${node.path}: missing description`);
+		return {
+			path: node.path,
+			title,
+			description
+		};
+	});
+}
+//#endregion
+export { selectPageHeadNodes as n, pageHeads as t };
+
+//# sourceMappingURL=page-heads-BgbaIjj9.js.map

package/dist/page-heads-BgbaIjj9.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-heads-BgbaIjj9.js","names":[],"sources":["../src/core/page-heads.ts"],"sourcesContent":["import { globToRegExp } from \"./checks\";\nimport type { SeoGraph, SeoNode } from \"./graph\";\n\n/** Plain document metadata, without framework or schema dependencies. */\nexport interface PageHead {\n  readonly path: string;\n  readonly title: string;\n  readonly description: string;\n}\n\nexport interface PageHeadsOptions {\n  /** Path globs: `*` matches a segment, `**` matches across segments. */\n  readonly exclude?: ReadonlyArray<string>;\n  /** Exclude noindex pages and redirects. Parameter templates are always excluded. Defaults to true. */\n  readonly indexable?: boolean;\n}\n\n/** Select page nodes before the host resolves metadata; sitemap-disabled hubs remain pages. */\nexport function selectPageHeadNodes(graph: SeoGraph, options: PageHeadsOptions = {}): Array<SeoNode> {\n  const excludes = (options.exclude ?? []).map(globToRegExp);\n  return [...graph.nodes.values()].filter((node) =>\n    node.kind !== \"layout\" &&\n    !node.path.includes(\"$\") &&\n    (node.policy.sitemap !== undefined || node.instance !== undefined) &&\n    !excludes.some((pattern) => pattern.test(node.path)) &&\n    (options.indexable === false || (\n      node.policy.redirectTo === undefined &&\n      !node.policy.robots?.toLowerCase().split(/[\\s,]+/).includes(\"noindex\")\n    )),\n  );\n}\n\n/** Extract resolved heads, naming the selected page when metadata is missing or blank. */\nexport function pageHeads(graph: SeoGraph, options: PageHeadsOptions = {}): Array<PageHead> {\n  return selectPageHeadNodes(graph, options).map((node) => {\n    const title = node.head?.title;\n    const description = node.head?.description;\n    if (!title?.trim()) throw new Error(`Invalid page head for ${node.path}: missing title`);\n    if (!description?.trim()) throw new Error(`Invalid page head for ${node.path}: missing description`);\n    return { path: node.path, title, description };\n  });\n}\n"],"mappings":";;;AAkBA,SAAgB,oBAAoB,OAAiB,UAA4B,CAAC,GAAmB;CACnG,MAAM,YAAY,QAAQ,WAAW,CAAC,EAAA,CAAG,IAAI,YAAY;CACzD,OAAO,CAAC,GAAG,MAAM,MAAM,OAAO,CAAC,CAAC,CAAC,QAAQ,SACvC,KAAK,SAAS,YACd,CAAC,KAAK,KAAK,SAAS,GAAG,MACtB,KAAK,OAAO,YAAY,KAAA,KAAa,KAAK,aAAa,KAAA,MACxD,CAAC,SAAS,MAAM,YAAY,QAAQ,KAAK,KAAK,IAAI,CAAC,MAClD,QAAQ,cAAc,SACrB,KAAK,OAAO,eAAe,KAAA,KAC3B,CAAC,KAAK,OAAO,QAAQ,YAAY,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,SAAS,SAAS,EAEzE;AACF;;AAGA,SAAgB,UAAU,OAAiB,UAA4B,CAAC,GAAoB;CAC1F,OAAO,oBAAoB,OAAO,OAAO,CAAC,CAAC,KAAK,SAAS;EACvD,MAAM,QAAQ,KAAK,MAAM;EACzB,MAAM,cAAc,KAAK,MAAM;EAC/B,IAAI,CAAC,OAAO,KAAK,GAAG,MAAM,IAAI,MAAM,yBAAyB,KAAK,KAAK,gBAAgB;EACvF,IAAI,CAAC,aAAa,KAAK,GAAG,MAAM,IAAI,MAAM,yBAAyB,KAAK,KAAK,sBAAsB;EACnG,OAAO;GAAE,MAAM,KAAK;GAAM;GAAO;EAAY;CAC/C,CAAC;AACH"}

package/dist/projections-Bk-qOOsR.d.ts

@@ -0,0 +1,78 @@
+import { a as SeoGraph, r as SeoEdge, s as SeoNode } from "./graph-D1PIndsC.js";
+//#region src/core/projections.d.ts
+interface ProjectionConfig {
+  origin: string;
+  indexable: boolean;
+}
+interface RobotsConfig extends ProjectionConfig {
+  /** Path prefixes to disallow on an indexable host (e.g. the app-only groups). */
+  disallow: ReadonlyArray<string>;
+  /**
+   * Origin-wide Content-Signal preferences
+   * (https://contentsignals.org/), emitted as `Content-Signal: <value>` under
+   * `User-agent: *` on an indexable host. Omit for none. The plugin never
+   * invents a default — pass the policy you want, e.g.
+   * `"search=yes, ai-input=yes, ai-train=yes"`.
+   */
+  contentSignal?: string | undefined;
+  /**
+   * Extra full lines in the indexable `User-agent: *` group, after
+   * Content-Signal (if any) and before Allow/Disallow. Use for directives the
+   * plugin does not model, or to compose {@link contentSignal} yourself.
+   */
+  directives?: ReadonlyArray<string> | undefined;
+  /**
+   * Last-mile override: receives the rendered robots.txt and returns the file
+   * to emit. Runs for indexable and preview hosts. Use when you need to wrap
+   * or replace the default body rather than add group lines.
+   */
+  transform?: ((robots: string) => string) | undefined;
+}
+interface NodeReport {
+  node: SeoNode;
+  inSitemap: boolean;
+  incoming: Array<SeoEdge>;
+  outgoing: Array<SeoEdge>;
+}
+/**
+ * A node belongs in the sitemap when it declares a positive sitemap policy, is not
+ * a redirect, is not robots-noindexed, and is not a param template (a route whose
+ * path still contains a `$` segment — those exist only so their instances inherit).
+ */
+declare function isSitemapEligible(node: SeoNode): boolean;
+/**
+ * The date a node's content last changed, as declared: an instance's
+ * `modifiedAt`, else its `publishedAt`; a route's own `modifiedAt`. A node with
+ * no date (a docs page without frontmatter dates, an undated route) returns
+ * undefined, and the sitemap omits its `<lastmod>`.
+ */
+declare function lastModified(node: SeoNode): string | undefined;
+/**
+ * Render sitemap.xml from the graph. Each entry's `<lastmod>` is its
+ * {@link lastModified} date: frontmatter for content instances, the declared
+ * `modifiedAt` for routes. Route entries are sorted by path, then instances follow in collection order.
+ * `indexable` is intentionally unused — the sitemap body is host-independent;
+ * robots.txt is what gates crawling.
+ */
+declare function renderSitemap(graph: SeoGraph, cfg: ProjectionConfig): string;
+/** Format a Content-Signal robots.txt directive from the preference list. */
+declare function contentSignal(value: string): string;
+/**
+ * Render robots.txt. A non-indexable host (previews) gets a disallow-all
+ * with no Sitemap line; an indexable host disallows exactly the prefixes the caller
+ * passes. Pages that declare `robots: noindex` are intentionally NOT added as
+ * Disallow entries — a Disallow would stop crawlers reaching the page to read its
+ * `noindex, follow` meta, so the graph's per-node robots policy never feeds this
+ * list. `graph` is unused — kept for signature parity with the other projections,
+ * which callers load the graph once for and pass to each.
+ *
+ * Origin-wide group directives (`contentSignal`, `directives`) are indexable-host
+ * only. {@link RobotsConfig.transform} always runs last so a consumer can override
+ * the whole file.
+ */
+declare function renderRobots(_graph: SeoGraph, cfg: RobotsConfig): string;
+/** Inspect a single node: its declaration, sitemap eligibility, and edges. */
+declare function inspectNode(graph: SeoGraph, path: string): NodeReport | undefined;
+//#endregion
+export { inspectNode as a, renderRobots as c, contentSignal as i, renderSitemap as l, ProjectionConfig as n, isSitemapEligible as o, RobotsConfig as r, lastModified as s, NodeReport as t };
+//# sourceMappingURL=projections-Bk-qOOsR.d.ts.map

package/dist/projections-D0oOFKiY.js

@@ -0,0 +1,142 @@
+//#region src/core/projections.ts
+const escapeXml = (value) => value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+/**
+* A node belongs in the sitemap when it declares a positive sitemap policy, is not
+* a redirect, is not robots-noindexed, and is not a param template (a route whose
+* path still contains a `$` segment — those exist only so their instances inherit).
+*/
+function isSitemapEligible(node) {
+	if (node.policy.redirectTo !== void 0) return false;
+	if (node.policy.robots?.includes("noindex")) return false;
+	if (!node.policy.sitemap) return false;
+	if (node.path.includes("$")) return false;
+	return true;
+}
+/** Canonical absolute URL for a node under the given origin. */
+function urlForNode(origin, node) {
+	return node.path === "/" ? origin : `${origin}${node.path}`;
+}
+/**
+* The date a node's content last changed, as declared: an instance's
+* `modifiedAt`, else its `publishedAt`; a route's own `modifiedAt`. A node with
+* no date (a docs page without frontmatter dates, an undated route) returns
+* undefined, and the sitemap omits its `<lastmod>`.
+*/
+function lastModified(node) {
+	if (node.instance) return node.instance.modifiedAt ?? node.instance.publishedAt;
+	return node.policy.modifiedAt;
+}
+/** An ISO 8601 date, or a date-time that states its offset. */
+const ISO_DATE = /^(\d{4})-(\d{2})-(\d{2})(?:T\d{2}:\d{2}(?::\d{2}(?:\.\d+)?)?(?:Z|[+-]\d{2}:\d{2}))?$/;
+/**
+* Parse a declared date to epoch milliseconds, or undefined when it is not an
+* ISO 8601 date (`2026-09-29`) or offset date-time (`2026-09-29T10:00:00Z`) on a
+* real calendar day. `Date.parse` alone would accept "Sep 29" in the host's
+* zone and roll "2026-02-30" into March; either would publish a wrong
+* `<lastmod>`. The `invalid-date` check reports the undefined case, so
+* projections that meet one fail loudly.
+*/
+function parseDeclaredDate(value) {
+	const match = ISO_DATE.exec(value);
+	if (match === null) return void 0;
+	const [year, month, day] = [
+		Number(match[1]),
+		Number(match[2]),
+		Number(match[3])
+	];
+	const calendar = new Date(Date.UTC(year, month - 1, day));
+	if (calendar.getUTCMonth() !== month - 1 || calendar.getUTCDate() !== day) return void 0;
+	const time = Date.parse(value);
+	return Number.isNaN(time) ? void 0 : time;
+}
+function sitemapLastmod(node) {
+	const date = lastModified(node);
+	if (date === void 0) return void 0;
+	const time = parseDeclaredDate(date);
+	if (time === void 0) throw new Error(`"${node.path}" declares an invalid date "${date}"; run \`pagegraph check\`.`);
+	return new Date(time).toISOString();
+}
+function renderUrlEntry(url, lastmod, node) {
+	const { changeFrequency, priority } = node.policy.sitemap;
+	const lines = [`  <url>`, `    <loc>${escapeXml(url)}</loc>`];
+	if (lastmod) lines.push(`    <lastmod>${lastmod}</lastmod>`);
+	lines.push(`    <changefreq>${changeFrequency}</changefreq>`, `    <priority>${priority.toFixed(1)}</priority>`, `  </url>`);
+	return lines.join("\n");
+}
+/**
+* Render sitemap.xml from the graph. Each entry's `<lastmod>` is its
+* {@link lastModified} date: frontmatter for content instances, the declared
+* `modifiedAt` for routes. Route entries are sorted by path, then instances follow in collection order.
+* `indexable` is intentionally unused — the sitemap body is host-independent;
+* robots.txt is what gates crawling.
+*/
+function renderSitemap(graph, cfg) {
+	const nodes = [...graph.nodes.values()];
+	const staticNodes = nodes.filter((node) => node.source === "route" && isSitemapEligible(node)).sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+	const instanceNodes = nodes.filter((node) => node.source !== "route" && isSitemapEligible(node));
+	const seen = /* @__PURE__ */ new Set();
+	const entries = [];
+	for (const node of [...staticNodes, ...instanceNodes]) {
+		const url = urlForNode(cfg.origin, node);
+		const key = url.toLowerCase().replace(/\/$/, "");
+		if (seen.has(key)) continue;
+		seen.add(key);
+		entries.push(renderUrlEntry(url, sitemapLastmod(node), node));
+	}
+	return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${entries.join("\n")}\n</urlset>\n`;
+}
+/** Format a Content-Signal robots.txt directive from the preference list. */
+function contentSignal(value) {
+	return `Content-Signal: ${value}`;
+}
+const groupLines = (cfg) => {
+	const lines = [];
+	if (cfg.contentSignal !== void 0 && cfg.contentSignal !== "") lines.push(contentSignal(cfg.contentSignal));
+	for (const directive of cfg.directives ?? []) if (directive !== "") lines.push(directive);
+	return lines;
+};
+/**
+* Render robots.txt. A non-indexable host (previews) gets a disallow-all
+* with no Sitemap line; an indexable host disallows exactly the prefixes the caller
+* passes. Pages that declare `robots: noindex` are intentionally NOT added as
+* Disallow entries — a Disallow would stop crawlers reaching the page to read its
+* `noindex, follow` meta, so the graph's per-node robots policy never feeds this
+* list. `graph` is unused — kept for signature parity with the other projections,
+* which callers load the graph once for and pass to each.
+*
+* Origin-wide group directives (`contentSignal`, `directives`) are indexable-host
+* only. {@link RobotsConfig.transform} always runs last so a consumer can override
+* the whole file.
+*/
+function renderRobots(_graph, cfg) {
+	const rendered = cfg.indexable ? [
+		"User-agent: *",
+		...groupLines(cfg),
+		"Allow: /",
+		...cfg.disallow.map((path) => `Disallow: ${path}`),
+		"",
+		`Sitemap: ${cfg.origin}/sitemap.xml`,
+		`Host: ${cfg.origin}`,
+		""
+	].join("\n") : [
+		"User-agent: *",
+		"Disallow: /",
+		""
+	].join("\n");
+	return cfg.transform === void 0 ? rendered : cfg.transform(rendered);
+}
+/** Inspect a single node: its declaration, sitemap eligibility, and edges. */
+function inspectNode(graph, path) {
+	const node = graph.nodes.get(path);
+	if (!node) return void 0;
+	return {
+		node,
+		inSitemap: isSitemapEligible(node),
+		incoming: graph.edges.filter((edge) => edge.to === path),
+		outgoing: graph.edges.filter((edge) => edge.from === path)
+	};
+}
+//#endregion
+export { parseDeclaredDate as a, lastModified as i, inspectNode as n, renderRobots as o, isSitemapEligible as r, renderSitemap as s, contentSignal as t };
+
+//# sourceMappingURL=projections-D0oOFKiY.js.map

package/dist/projections-D0oOFKiY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections-D0oOFKiY.js","names":[],"sources":["../src/core/projections.ts"],"sourcesContent":["/**\n * Projections of the SEO graph: sitemap.xml, robots.txt, and single-node\n * inspection. Pure functions — the origin, the host's indexability, and the\n * robots disallow list are injected by the caller, never read from the\n * environment or a generated file.\n */\n\nimport type { SeoEdge, SeoGraph, SeoNode } from \"./graph\";\n\nexport interface ProjectionConfig {\n  origin: string;\n  indexable: boolean;\n}\n\nexport interface RobotsConfig extends ProjectionConfig {\n  /** Path prefixes to disallow on an indexable host (e.g. the app-only groups). */\n  disallow: ReadonlyArray<string>;\n  /**\n   * Origin-wide Content-Signal preferences\n   * (https://contentsignals.org/), emitted as `Content-Signal: <value>` under\n   * `User-agent: *` on an indexable host. Omit for none. The plugin never\n   * invents a default — pass the policy you want, e.g.\n   * `\"search=yes, ai-input=yes, ai-train=yes\"`.\n   */\n  contentSignal?: string | undefined;\n  /**\n   * Extra full lines in the indexable `User-agent: *` group, after\n   * Content-Signal (if any) and before Allow/Disallow. Use for directives the\n   * plugin does not model, or to compose {@link contentSignal} yourself.\n   */\n  directives?: ReadonlyArray<string> | undefined;\n  /**\n   * Last-mile override: receives the rendered robots.txt and returns the file\n   * to emit. Runs for indexable and preview hosts. Use when you need to wrap\n   * or replace the default body rather than add group lines.\n   */\n  transform?: ((robots: string) => string) | undefined;\n}\n\nexport interface NodeReport {\n  node: SeoNode;\n  inSitemap: boolean;\n  incoming: Array<SeoEdge>;\n  outgoing: Array<SeoEdge>;\n}\n\nconst escapeXml = (value: string): string =>\n  value\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\"/g, \"&quot;\")\n    .replace(/'/g, \"&apos;\");\n\n/**\n * A node belongs in the sitemap when it declares a positive sitemap policy, is not\n * a redirect, is not robots-noindexed, and is not a param template (a route whose\n * path still contains a `$` segment — those exist only so their instances inherit).\n */\nexport function isSitemapEligible(node: SeoNode): boolean {\n  if (node.policy.redirectTo !== undefined) return false;\n  if (node.policy.robots?.includes(\"noindex\")) return false;\n  if (!node.policy.sitemap) return false; // false or absent\n  if (node.path.includes(\"$\")) return false;\n  return true;\n}\n\n/** Canonical absolute URL for a node under the given origin. */\nfunction urlForNode(origin: string, node: SeoNode): string {\n  return node.path === \"/\" ? origin : `${origin}${node.path}`;\n}\n\n/**\n * The date a node's content last changed, as declared: an instance's\n * `modifiedAt`, else its `publishedAt`; a route's own `modifiedAt`. A node with\n * no date (a docs page without frontmatter dates, an undated route) returns\n * undefined, and the sitemap omits its `<lastmod>`.\n */\nexport function lastModified(node: SeoNode): string | undefined {\n  if (node.instance) return node.instance.modifiedAt ?? node.instance.publishedAt;\n  return node.policy.modifiedAt;\n}\n\n/** An ISO 8601 date, or a date-time that states its offset. */\nconst ISO_DATE = /^(\\d{4})-(\\d{2})-(\\d{2})(?:T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d+)?)?(?:Z|[+-]\\d{2}:\\d{2}))?$/;\n\n/**\n * Parse a declared date to epoch milliseconds, or undefined when it is not an\n * ISO 8601 date (`2026-09-29`) or offset date-time (`2026-09-29T10:00:00Z`) on a\n * real calendar day. `Date.parse` alone would accept \"Sep 29\" in the host's\n * zone and roll \"2026-02-30\" into March; either would publish a wrong\n * `<lastmod>`. The `invalid-date` check reports the undefined case, so\n * projections that meet one fail loudly.\n */\nexport function parseDeclaredDate(value: string): number | undefined {\n  const match = ISO_DATE.exec(value);\n  if (match === null) return undefined;\n  const [year, month, day] = [Number(match[1]), Number(match[2]), Number(match[3])];\n  const calendar = new Date(Date.UTC(year, month - 1, day));\n  if (calendar.getUTCMonth() !== month - 1 || calendar.getUTCDate() !== day) return undefined;\n  const time = Date.parse(value);\n  return Number.isNaN(time) ? undefined : time;\n}\n\nfunction sitemapLastmod(node: SeoNode): string | undefined {\n  const date = lastModified(node);\n  if (date === undefined) return undefined;\n  const time = parseDeclaredDate(date);\n  if (time === undefined) {\n    throw new Error(`\"${node.path}\" declares an invalid date \"${date}\"; run \\`pagegraph check\\`.`);\n  }\n  return new Date(time).toISOString();\n}\n\nfunction renderUrlEntry(url: string, lastmod: string | undefined, node: SeoNode): string {\n  const sitemap = node.policy.sitemap;\n  // isSitemapEligible guarantees a positive policy before this runs.\n  const { changeFrequency, priority } = sitemap as { changeFrequency: string; priority: number };\n  const lines = [`  <url>`, `    <loc>${escapeXml(url)}</loc>`];\n  if (lastmod) lines.push(`    <lastmod>${lastmod}</lastmod>`);\n  lines.push(\n    `    <changefreq>${changeFrequency}</changefreq>`,\n    `    <priority>${priority.toFixed(1)}</priority>`,\n    `  </url>`,\n  );\n  return lines.join(\"\\n\");\n}\n\n/**\n * Render sitemap.xml from the graph. Each entry's `<lastmod>` is its\n * {@link lastModified} date: frontmatter for content instances, the declared\n * `modifiedAt` for routes. Route entries are sorted by path, then instances follow in collection order.\n * `indexable` is intentionally unused — the sitemap body is host-independent;\n * robots.txt is what gates crawling.\n */\nexport function renderSitemap(graph: SeoGraph, cfg: ProjectionConfig): string {\n  const nodes = [...graph.nodes.values()];\n  const staticNodes = nodes\n    .filter((node) => node.source === \"route\" && isSitemapEligible(node))\n    .sort((a, b) => (a.path < b.path ? -1 : a.path > b.path ? 1 : 0));\n  const instanceNodes = nodes.filter((node) => node.source !== \"route\" && isSitemapEligible(node));\n\n  const seen = new Set<string>();\n  const entries: Array<string> = [];\n  for (const node of [...staticNodes, ...instanceNodes]) {\n    const url = urlForNode(cfg.origin, node);\n    const key = url.toLowerCase().replace(/\\/$/, \"\");\n    if (seen.has(key)) continue;\n    seen.add(key);\n    entries.push(renderUrlEntry(url, sitemapLastmod(node), node));\n  }\n\n  return `<?xml version=\"1.0\" encoding=\"UTF-8\"?>\\n<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">\\n${entries.join(\n    \"\\n\",\n  )}\\n</urlset>\\n`;\n}\n\n/** Format a Content-Signal robots.txt directive from the preference list. */\nexport function contentSignal(value: string): string {\n  return `Content-Signal: ${value}`;\n}\n\nconst groupLines = (cfg: RobotsConfig): Array<string> => {\n  const lines: Array<string> = [];\n  if (cfg.contentSignal !== undefined && cfg.contentSignal !== \"\") {\n    lines.push(contentSignal(cfg.contentSignal));\n  }\n  for (const directive of cfg.directives ?? []) {\n    if (directive !== \"\") lines.push(directive);\n  }\n  return lines;\n};\n\n/**\n * Render robots.txt. A non-indexable host (previews) gets a disallow-all\n * with no Sitemap line; an indexable host disallows exactly the prefixes the caller\n * passes. Pages that declare `robots: noindex` are intentionally NOT added as\n * Disallow entries — a Disallow would stop crawlers reaching the page to read its\n * `noindex, follow` meta, so the graph's per-node robots policy never feeds this\n * list. `graph` is unused — kept for signature parity with the other projections,\n * which callers load the graph once for and pass to each.\n *\n * Origin-wide group directives (`contentSignal`, `directives`) are indexable-host\n * only. {@link RobotsConfig.transform} always runs last so a consumer can override\n * the whole file.\n */\nexport function renderRobots(_graph: SeoGraph, cfg: RobotsConfig): string {\n  const rendered = cfg.indexable\n    ? [\n        \"User-agent: *\",\n        ...groupLines(cfg),\n        \"Allow: /\",\n        ...cfg.disallow.map((path) => `Disallow: ${path}`),\n        \"\",\n        `Sitemap: ${cfg.origin}/sitemap.xml`,\n        `Host: ${cfg.origin}`,\n        \"\",\n      ].join(\"\\n\")\n    : [\"User-agent: *\", \"Disallow: /\", \"\"].join(\"\\n\");\n  return cfg.transform === undefined ? rendered : cfg.transform(rendered);\n}\n\n/** Inspect a single node: its declaration, sitemap eligibility, and edges. */\nexport function inspectNode(graph: SeoGraph, path: string): NodeReport | undefined {\n  const node = graph.nodes.get(path);\n  if (!node) return undefined;\n  return {\n    node,\n    inSitemap: isSitemapEligible(node),\n    incoming: graph.edges.filter((edge) => edge.to === path),\n    outgoing: graph.edges.filter((edge) => edge.from === path),\n  };\n}\n"],"mappings":"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"}