pagegraph 0.12.0 → 0.14.0

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-6y-CARRQ.js → page-heads-BgbaIjj9.js}

@@ -1,9 +1,9 @@
-import { a as globToRegExp } from "./checks-uZk5Em9A.js";
+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.policy.sitemap !== void 0 || node.instance !== void 0) && !excludes.some((pattern) => pattern.test(node.path)) && (options.indexable === false || !node.path.includes("$") && node.policy.redirectTo === void 0 && !node.policy.robots?.toLowerCase().split(/[\s,]+/).includes("noindex")));
+	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 = {}) {
@@ -22,4 +22,4 @@ function pageHeads(graph, options = {}) {
 //#endregion
 export { selectPageHeadNodes as n, pageHeads as t };
 
-//# sourceMappingURL=page-heads-6y-CARRQ.js.map
+//# 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"}