pagegraph 0.5.1 → 0.6.0

package/dist/{graph-BlLoEOw2.d.ts → checks-BfsQtKga.d.ts}

@@ -118,5 +118,46 @@ interface BuildSeoGraphInput {
  */
 declare function buildSeoGraph(input: BuildSeoGraphInput): SeoGraph;
 //#endregion
-export { SeoGraph as a, SeoSource as c, Register as d, RouteSeo as f, SeoEdgeType as i, buildSeoGraph as l, SitemapPolicy as m, SeoCollection as n, SeoInstance as o, SeoKind as p, SeoEdge as r, SeoNode as s, BuildSeoGraphInput as t, PublicPath as u };
-//# sourceMappingURL=graph-BlLoEOw2.d.ts.map
+//#region src/core/checks.d.ts
+type Severity = "structural" | "editorial";
+interface Violation {
+  severity: Severity;
+  rule: string;
+  path?: string | undefined;
+  message: string;
+  fix?: string | undefined;
+}
+/**
+ * A contextual-link coverage rule: every sitemap-eligible page matching the
+ * `path` glob must have at least `minInbound` incoming `related` edges. Unlike
+ * the static rules, these come from project policy (a CLI flag or
+ * `seo.config.ts`), because "which pages are money pages" is app knowledge.
+ */
+interface CoverageRule {
+  /** Path glob: `*` matches within a segment, `**` matches across segments. */
+  readonly path: string;
+  /** Minimum incoming contextual (`related`) edges the matched page needs. */
+  readonly minInbound: number;
+}
+/**
+ * Run every static rule against the graph, then any caller-supplied
+ * {@link CoverageRule}s, and return the flat list of violations. With no
+ * `coverage` option the result is exactly the static rule set.
+ */
+declare function checkGraph(graph: SeoGraph, options?: {
+  readonly coverage?: ReadonlyArray<CoverageRule> | undefined;
+}): Array<Violation>;
+/**
+ * Enforce contextual-link coverage rules: a named set of sitemap-eligible
+ * "money" pages each needs `minInbound` incoming `related` edges. Only
+ * `related` edges count — breadcrumb ancestry is navigation, not context.
+ *
+ * A rule that matches no sitemap-eligible page is itself a violation: a typo or
+ * a rule aimed at a noindex page would otherwise pass silently forever.
+ */
+declare function checkCoverage(graph: SeoGraph, rules: ReadonlyArray<CoverageRule>): Array<Violation>;
+/** Structural violations fail `pagegraph check`; editorial-only stays green. */
+declare const hasStructuralViolations: (violations: ReadonlyArray<Violation>) => boolean;
+//#endregion
+export { Register as _, checkGraph as a, SitemapPolicy as b, SeoCollection as c, SeoGraph as d, SeoInstance as f, PublicPath as g, buildSeoGraph as h, checkCoverage as i, SeoEdge as l, SeoSource as m, Severity as n, hasStructuralViolations as o, SeoNode as p, Violation as r, BuildSeoGraphInput as s, CoverageRule as t, SeoEdgeType as u, RouteSeo as v, SeoKind as y };
+//# sourceMappingURL=checks-BfsQtKga.d.ts.map