docsanity 0.1.0

package/dist/index.cjs

@@ -0,0 +1,535 @@
+'use strict';
+
+var readlevel = require('@didrod2539/readlevel');
+var path = require('path');
+var linklint = require('@didrod2539/linklint');
+
+// src/checks/readability.ts
+function readabilityCheck(page, config) {
+  const text = page.md.text;
+  const wordCount = text ? text.split(/\s+/).filter(Boolean).length : 0;
+  if (wordCount < config.minWordsForReadability) {
+    return { findings: [] };
+  }
+  const a = readlevel.analyze(text);
+  const summary = {
+    grade: a.grade,
+    gradeLabel: a.gradeLabel,
+    ease: a.ease,
+    words: a.words,
+    readingTimeSeconds: a.readingTimeSeconds
+  };
+  const findings = [];
+  if (a.grade > config.maxGrade) {
+    findings.push({
+      dimension: "readability",
+      rule: "readability.too-hard",
+      severity: "warning",
+      message: `Reads at grade ${a.grade.toFixed(0)} (${a.gradeLabel}); target \u2264 grade ${config.maxGrade}`,
+      detail: `Flesch ease ${a.readability.fleschReadingEase.toFixed(0)} (${a.ease}), ${a.averageWordsPerSentence.toFixed(0)} words/sentence`,
+      fix: "Shorten sentences and prefer common words to lower the reading grade."
+    });
+  }
+  return { findings, summary };
+}
+
+// src/frontmatter.ts
+function unquote(raw) {
+  const s = raw.trim();
+  if (s.startsWith('"') && s.endsWith('"') && s.length >= 2 || s.startsWith("'") && s.endsWith("'") && s.length >= 2) {
+    return s.slice(1, -1);
+  }
+  return s;
+}
+function coerce(raw) {
+  const s = raw.trim();
+  if (s.startsWith("[") && s.endsWith("]")) {
+    return s.slice(1, -1).split(",").map((x) => unquote(x)).filter((x) => x.length > 0);
+  }
+  if (s === "true" || s === "false") return s === "true";
+  if (s !== "" && !Number.isNaN(Number(s)) && /^-?\d/.test(s)) return Number(s);
+  return unquote(s);
+}
+function parseFrontmatter(content) {
+  const normalized = content.replace(/^/, "");
+  const match = /^---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/.exec(normalized);
+  if (!match) {
+    return { data: {}, body: content, offset: 0, present: false };
+  }
+  const block = match[1];
+  const data = {};
+  const lines = block.split(/\r?\n/);
+  let pendingListKey = null;
+  let pendingList = [];
+  const flush = () => {
+    if (pendingListKey !== null) {
+      data[pendingListKey] = pendingList;
+      pendingListKey = null;
+      pendingList = [];
+    }
+  };
+  for (const line of lines) {
+    if (/^\s*-\s+/.test(line) && pendingListKey !== null) {
+      pendingList.push(unquote(line.replace(/^\s*-\s+/, "")));
+      continue;
+    }
+    flush();
+    const kv = /^([A-Za-z0-9_.-]+):\s*(.*)$/.exec(line);
+    if (!kv) continue;
+    const key = kv[1];
+    const value = kv[2];
+    if (value.trim() === "") {
+      pendingListKey = key;
+      pendingList = [];
+    } else {
+      data[key] = coerce(value);
+    }
+  }
+  flush();
+  const offset = match[0].split(/\r?\n/).length - 1;
+  return { data, body: normalized.slice(match[0].length), offset, present: true };
+}
+function asString(value) {
+  if (value === void 0) return "";
+  if (Array.isArray(value)) return value.join(", ");
+  return String(value).trim();
+}
+
+// src/checks/seo.ts
+function pageTitle(page) {
+  const fm = asString(page.frontmatter.data["title"]);
+  if (fm) return { value: fm, source: "frontmatter" };
+  const h1 = page.md.headings.find((h) => h.level === 1);
+  if (h1) return { value: h1.text, source: "h1" };
+  return { value: "", source: null };
+}
+function description(page) {
+  return asString(page.frontmatter.data["description"]);
+}
+function buildDuplicateIndex(pages) {
+  const titles = /* @__PURE__ */ new Map();
+  const descriptions = /* @__PURE__ */ new Map();
+  for (const page of pages) {
+    const t = pageTitle(page).value.trim().toLowerCase();
+    if (t) titles.set(t, [...titles.get(t) ?? [], page.relPath]);
+    const d = description(page).trim().toLowerCase();
+    if (d) descriptions.set(d, [...descriptions.get(d) ?? [], page.relPath]);
+  }
+  return { titles, descriptions };
+}
+function seoChecks(page, config, dup) {
+  const out = [];
+  const required = new Set(config.requireFrontmatter);
+  const title = pageTitle(page);
+  const desc = description(page);
+  if (required.has("title")) {
+    if (!title.value) {
+      out.push({
+        dimension: "seo",
+        rule: "seo.missing-title",
+        severity: "error",
+        message: "Page has no title (no frontmatter `title` and no H1)",
+        fix: "Add a `title:` to the frontmatter or an `# H1` heading."
+      });
+    } else if (title.source === "h1") {
+      out.push({
+        dimension: "seo",
+        rule: "seo.frontmatter-title",
+        severity: "info",
+        message: "Title comes from the H1; add an explicit frontmatter `title` for SEO control",
+        detail: `Using H1: "${title.value}"`
+      });
+    }
+    if (title.value && title.value.length > config.titleMax) {
+      out.push({
+        dimension: "seo",
+        rule: "seo.title-too-long",
+        severity: "warning",
+        message: `Title is ${title.value.length} chars (recommended \u2264 ${config.titleMax})`,
+        fix: "Shorten the title so it isn't truncated in search results."
+      });
+    }
+  }
+  if (required.has("description")) {
+    if (!desc) {
+      out.push({
+        dimension: "seo",
+        rule: "seo.missing-description",
+        severity: "warning",
+        message: "No frontmatter `description`",
+        fix: `Add a ${config.descriptionMin}\u2013${config.descriptionMax} char description for the search snippet.`
+      });
+    } else if (desc.length < config.descriptionMin) {
+      out.push({
+        dimension: "seo",
+        rule: "seo.description-short",
+        severity: "warning",
+        message: `Description is ${desc.length} chars (recommended \u2265 ${config.descriptionMin})`
+      });
+    } else if (desc.length > config.descriptionMax) {
+      out.push({
+        dimension: "seo",
+        rule: "seo.description-long",
+        severity: "warning",
+        message: `Description is ${desc.length} chars (recommended \u2264 ${config.descriptionMax})`,
+        fix: "Trim it so search engines don't truncate the snippet."
+      });
+    }
+  }
+  for (const key of config.requireFrontmatter) {
+    if (key === "title" || key === "description") continue;
+    if (!asString(page.frontmatter.data[key])) {
+      out.push({
+        dimension: "seo",
+        rule: `seo.missing-frontmatter`,
+        severity: "warning",
+        message: `Missing required frontmatter: \`${key}\``
+      });
+    }
+  }
+  const tKey = title.value.trim().toLowerCase();
+  const others = (dup.titles.get(tKey) ?? []).filter((p) => p !== page.relPath);
+  if (tKey && others.length) {
+    out.push({
+      dimension: "seo",
+      rule: "seo.duplicate-title",
+      severity: "warning",
+      message: `Duplicate title \u2014 also used by ${others.length} other page(s)`,
+      detail: others.slice(0, 3).join(", "),
+      fix: "Give each page a unique title; duplicates compete in search results."
+    });
+  }
+  const dKey = desc.trim().toLowerCase();
+  const dOthers = (dup.descriptions.get(dKey) ?? []).filter((p) => p !== page.relPath);
+  if (dKey && dOthers.length) {
+    out.push({
+      dimension: "seo",
+      rule: "seo.duplicate-description",
+      severity: "warning",
+      message: `Duplicate description \u2014 also used by ${dOthers.length} other page(s)`,
+      detail: dOthers.slice(0, 3).join(", "),
+      fix: "Write a unique description per page."
+    });
+  }
+  return out;
+}
+
+// src/checks/structure.ts
+function structureChecks(page, _config) {
+  const out = [];
+  const { headings, images, fences } = page.md;
+  const h1s = headings.filter((h) => h.level === 1);
+  if (h1s.length === 0) {
+    out.push({
+      dimension: "structure",
+      rule: "structure.no-h1",
+      severity: "warning",
+      message: "No H1 heading",
+      fix: "Start the page with a single `# Title`."
+    });
+  } else if (h1s.length > 1) {
+    out.push({
+      dimension: "structure",
+      rule: "structure.multiple-h1",
+      severity: "warning",
+      message: `${h1s.length} H1 headings (use exactly one)`,
+      line: h1s[1].line,
+      fix: "Demote the extra H1s to H2/H3 so the outline has one top level."
+    });
+  }
+  let prev = 0;
+  for (const h of headings) {
+    if (prev !== 0 && h.level > prev + 1) {
+      out.push({
+        dimension: "structure",
+        rule: "structure.skipped-heading",
+        severity: "warning",
+        message: `Heading jumps from H${prev} to H${h.level} ("${h.text}")`,
+        line: h.line,
+        fix: "Don't skip levels \u2014 screen readers and outlines rely on order."
+      });
+    }
+    prev = h.level;
+  }
+  for (const img of images) {
+    if (img.alt.trim() === "") {
+      out.push({
+        dimension: "structure",
+        rule: "structure.image-alt",
+        severity: "warning",
+        message: `Image has no alt text: ${img.src}`,
+        line: img.line,
+        fix: "Add descriptive alt text: `![what it shows](src)`."
+      });
+    }
+  }
+  for (const fence of fences) {
+    if (fence.lang === null) {
+      out.push({
+        dimension: "structure",
+        rule: "structure.code-language",
+        severity: "info",
+        message: "Code block has no language tag",
+        line: fence.line,
+        fix: "Add a language after the opening fence (e.g. ```ts) for highlighting."
+      });
+    }
+  }
+  return out;
+}
+
+// src/config.ts
+var DEFAULT_CONFIG = {
+  extensions: [".md", ".mdx", ".markdown"],
+  requireFrontmatter: ["title", "description"],
+  descriptionMin: 50,
+  descriptionMax: 160,
+  titleMax: 60,
+  maxGrade: 14,
+  minWordsForReadability: 80,
+  disable: [],
+  ignore: [],
+  minScore: 0
+};
+var CONFIG_FILENAMES = ["docsanity.config.json", ".docsanityrc.json", ".docsanityrc"];
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function mergeConfig(base, override) {
+  const out = { ...base };
+  for (const [k, v] of Object.entries(override ?? {})) {
+    if (v !== void 0) out[k] = v;
+  }
+  return out;
+}
+function parseConfig(json, label = "config") {
+  let data;
+  try {
+    data = JSON.parse(json);
+  } catch (e) {
+    throw new Error(`invalid ${label}: ${e.message}`);
+  }
+  if (!isPlainObject(data)) throw new Error(`invalid ${label}: must be a JSON object`);
+  return mergeConfig(DEFAULT_CONFIG, data);
+}
+function isDimensionEnabled(config, dim) {
+  return !config.disable.includes(dim);
+}
+function mapSeverity(s) {
+  return s === "error" || s === "warning" || s === "info" ? s : "warning";
+}
+function linkFindings(root, pages) {
+  const inputs = pages.map((p) => ({ path: p.absPath, content: p.content }));
+  const project = linklint.buildProjectFromInputs(root, inputs);
+  const report = linklint.analyze(project, linklint.DEFAULT_CONFIG);
+  const byPath = /* @__PURE__ */ new Map();
+  for (const doc of report.documents) {
+    byPath.set(
+      doc.path,
+      doc.issues.map((i) => ({
+        dimension: "links",
+        rule: `links.${i.rule}`,
+        severity: mapSeverity(i.severity),
+        message: i.message,
+        line: i.line,
+        detail: i.detail,
+        fix: i.fix
+      }))
+    );
+  }
+  for (const abs of linklint.findOrphans(project)) {
+    const rel = path.relative(root, abs) || abs;
+    const list = byPath.get(rel) ?? [];
+    list.push({
+      dimension: "links",
+      rule: "links.orphan-document",
+      severity: "warning",
+      message: "Orphan page \u2014 nothing links here",
+      fix: "Link to it from an index/README, or remove it if it's obsolete."
+    });
+    byPath.set(rel, list);
+  }
+  return byPath;
+}
+
+// src/markdown.ts
+var FENCE_RE = /^(\s*)(`{3,}|~{3,})\s*([A-Za-z0-9_+-]*)/;
+var HEADING_RE = /^(#{1,6})\s+(.+?)\s*#*\s*$/;
+var IMAGE_RE = /!\[([^\]]*)\]\(([^)\s]+)(?:\s+["'][^"']*["'])?\)/g;
+var HTML_IMG_RE = /<img\b[^>]*>/gi;
+function htmlImgAlt(tag) {
+  const m = /\balt\s*=\s*["']([^"']*)["']/i.exec(tag);
+  return m ? m[1] : "";
+}
+function htmlImgSrc(tag) {
+  const m = /\bsrc\s*=\s*["']([^"']*)["']/i.exec(tag);
+  return m ? m[1] : "";
+}
+function parseMarkdown(body, lineOffset = 0) {
+  const lines = body.split(/\r?\n/);
+  const headings = [];
+  const images = [];
+  const fences = [];
+  const textParts = [];
+  let inFence = false;
+  let fenceMarker = "";
+  for (let i = 0; i < lines.length; i++) {
+    const raw = lines[i];
+    const lineNo = i + 1 + lineOffset;
+    const fence = FENCE_RE.exec(raw);
+    if (fence && (!inFence || raw.trim().startsWith(fenceMarker))) {
+      const marker = fence[2];
+      if (!inFence) {
+        inFence = true;
+        fenceMarker = marker[0].repeat(3);
+        fences.push({ lang: fence[3] ? fence[3] : null, line: lineNo });
+      } else {
+        inFence = false;
+        fenceMarker = "";
+      }
+      continue;
+    }
+    if (inFence) continue;
+    const heading = HEADING_RE.exec(raw);
+    if (heading) {
+      headings.push({ level: heading[1].length, text: heading[2].trim(), line: lineNo });
+      textParts.push(heading[2].trim());
+      continue;
+    }
+    let m;
+    IMAGE_RE.lastIndex = 0;
+    while ((m = IMAGE_RE.exec(raw)) !== null) {
+      images.push({ alt: m[1], src: m[2], line: lineNo });
+    }
+    HTML_IMG_RE.lastIndex = 0;
+    while ((m = HTML_IMG_RE.exec(raw)) !== null) {
+      images.push({ alt: htmlImgAlt(m[0]), src: htmlImgSrc(m[0]), line: lineNo });
+    }
+    textParts.push(stripInline(raw));
+  }
+  return { headings, images, fences, text: textParts.join("\n").trim() };
+}
+function stripInline(line) {
+  return line.replace(IMAGE_RE, "").replace(/\[([^\]]*)\]\([^)]*\)/g, "$1").replace(/`([^`]*)`/g, "$1").replace(/<[^>]+>/g, "").replace(/^[>\s]*>/g, "").replace(/^\s{0,3}([*+-]|\d+\.)\s+/g, "").replace(/[*_~]+/g, "").trim();
+}
+
+// src/page.ts
+function parsePage(absPath, relPath, content) {
+  const frontmatter = parseFrontmatter(content);
+  const md = parseMarkdown(frontmatter.body, frontmatter.offset);
+  return { absPath, relPath, content, frontmatter, md };
+}
+
+// src/score.ts
+var PENALTY = { error: 12, warning: 4, info: 1, pass: 0 };
+function scorePage(findings) {
+  let penalty = 0;
+  for (const f of findings) penalty += PENALTY[f.severity] ?? 0;
+  return Math.max(0, 100 - penalty);
+}
+function gradeFor(score) {
+  if (score >= 90) return "A";
+  if (score >= 80) return "B";
+  if (score >= 70) return "C";
+  if (score >= 60) return "D";
+  return "F";
+}
+
+// src/types.ts
+var DIMENSIONS = ["links", "seo", "readability", "structure"];
+var DIMENSION_LABELS = {
+  links: "Links & references",
+  seo: "SEO & frontmatter",
+  readability: "Readability",
+  structure: "Structure & a11y"
+};
+
+// src/analyze.ts
+function analyzeDocs(root, inputs, config, meta) {
+  const pages = inputs.map((i) => parsePage(i.absPath, i.relPath, i.content));
+  const ignore = new Set(config.ignore);
+  const dup = buildDuplicateIndex(pages);
+  const links = isDimensionEnabled(config, "links") ? linkFindings(root, pages) : /* @__PURE__ */ new Map();
+  const pageReports = pages.map((page) => {
+    const findings = [];
+    let readability;
+    if (isDimensionEnabled(config, "links")) {
+      findings.push(...links.get(page.relPath) ?? []);
+    }
+    if (isDimensionEnabled(config, "seo")) {
+      findings.push(...seoChecks(page, config, dup));
+    }
+    if (isDimensionEnabled(config, "structure")) {
+      findings.push(...structureChecks(page));
+    }
+    if (isDimensionEnabled(config, "readability")) {
+      const r = readabilityCheck(page, config);
+      findings.push(...r.findings);
+      readability = r.summary;
+    }
+    const kept = findings.filter((f) => !ignore.has(f.rule));
+    const counts = { error: 0, warning: 0, info: 0 };
+    for (const f of kept) {
+      if (f.severity === "error") counts.error++;
+      else if (f.severity === "warning") counts.warning++;
+      else if (f.severity === "info") counts.info++;
+    }
+    const score2 = scorePage(kept);
+    return {
+      path: page.relPath,
+      title: pageTitle(page).value || null,
+      score: score2,
+      grade: gradeFor(score2),
+      counts,
+      findings: kept,
+      readability
+    };
+  });
+  pageReports.sort((a, b) => a.path.localeCompare(b.path));
+  const errors = pageReports.reduce((s, p) => s + p.counts.error, 0);
+  const warnings = pageReports.reduce((s, p) => s + p.counts.warning, 0);
+  const infos = pageReports.reduce((s, p) => s + p.counts.info, 0);
+  const score = pageReports.length ? Math.round(pageReports.reduce((s, p) => s + p.score, 0) / pageReports.length) : 100;
+  const byDimension = Object.fromEntries(
+    DIMENSIONS.map((d) => [d, { errors: 0, warnings: 0, infos: 0 }])
+  );
+  for (const p of pageReports) {
+    for (const f of p.findings) {
+      const bucket = byDimension[f.dimension];
+      if (f.severity === "error") bucket.errors++;
+      else if (f.severity === "warning") bucket.warnings++;
+      else if (f.severity === "info") bucket.infos++;
+    }
+  }
+  return {
+    tool: "docsanity",
+    version: meta.version,
+    generatedAt: meta.generatedAt,
+    root,
+    summary: { pages: pageReports.length, score, grade: gradeFor(score), errors, warnings, infos, byDimension },
+    pages: pageReports
+  };
+}
+
+exports.CONFIG_FILENAMES = CONFIG_FILENAMES;
+exports.DEFAULT_CONFIG = DEFAULT_CONFIG;
+exports.DIMENSIONS = DIMENSIONS;
+exports.DIMENSION_LABELS = DIMENSION_LABELS;
+exports.analyzeDocs = analyzeDocs;
+exports.asString = asString;
+exports.buildDuplicateIndex = buildDuplicateIndex;
+exports.gradeFor = gradeFor;
+exports.isDimensionEnabled = isDimensionEnabled;
+exports.linkFindings = linkFindings;
+exports.mergeConfig = mergeConfig;
+exports.pageTitle = pageTitle;
+exports.parseConfig = parseConfig;
+exports.parseFrontmatter = parseFrontmatter;
+exports.parseMarkdown = parseMarkdown;
+exports.parsePage = parsePage;
+exports.readabilityCheck = readabilityCheck;
+exports.scorePage = scorePage;
+exports.seoChecks = seoChecks;
+exports.structureChecks = structureChecks;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/checks/readability.ts","../src/frontmatter.ts","../src/checks/seo.ts","../src/checks/structure.ts","../src/config.ts","../src/links.ts","../src/markdown.ts","../src/page.ts","../src/score.ts","../src/types.ts","../src/analyze.ts"],"names":["readlevelAnalyze","buildProjectFromInputs","linklintAnalyze","LINKLINT_DEFAULTS","findOrphans","relative","score"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Readability check — leverages the `readlevel` engine on each page's prose and\n * flags pages that read harder than the configured grade ceiling. Docs that are\n * too dense lose readers (and AI answer engines that prefer clear sources).\n */\n\nimport { analyze as readlevelAnalyze } from \"@didrod2539/readlevel\";\nimport type { Config, Finding, ReadabilitySummary } from \"../types.js\";\nimport type { Page } from \"../page.js\";\n\nexport interface ReadabilityResult {\n  findings: Finding[];\n  summary?: ReadabilitySummary;\n}\n\nexport function readabilityCheck(page: Page, config: Config): ReadabilityResult {\n  const text = page.md.text;\n  const wordCount = text ? text.split(/\\s+/).filter(Boolean).length : 0;\n\n  // Too little prose to judge (e.g. an API reference table or stub).\n  if (wordCount < config.minWordsForReadability) {\n    return { findings: [] };\n  }\n\n  const a = readlevelAnalyze(text);\n  const summary: ReadabilitySummary = {\n    grade: a.grade,\n    gradeLabel: a.gradeLabel,\n    ease: a.ease,\n    words: a.words,\n    readingTimeSeconds: a.readingTimeSeconds,\n  };\n\n  const findings: Finding[] = [];\n  if (a.grade > config.maxGrade) {\n    findings.push({\n      dimension: \"readability\",\n      rule: \"readability.too-hard\",\n      severity: \"warning\",\n      message: `Reads at grade ${a.grade.toFixed(0)} (${a.gradeLabel}); target ≤ grade ${config.maxGrade}`,\n      detail: `Flesch ease ${a.readability.fleschReadingEase.toFixed(0)} (${a.ease}), ${a.averageWordsPerSentence.toFixed(0)} words/sentence`,\n      fix: \"Shorten sentences and prefer common words to lower the reading grade.\",\n    });\n  }\n  return { findings, summary };\n}\n","/**\n * A small, dependency-free YAML-frontmatter parser. Docs sites (Docusaurus,\n * Astro, Nextra, Hugo, Jekyll, …) put metadata in a `---` fenced block at the\n * top of each Markdown file. We only need scalars and simple lists, so we parse\n * those directly rather than pulling in a full YAML engine.\n */\n\nexport type FrontmatterValue = string | string[] | boolean | number;\n\nexport interface Frontmatter {\n  data: Record<string, FrontmatterValue>;\n  /** The document body with the frontmatter block removed. */\n  body: string;\n  /** Number of lines the frontmatter occupied (so body line numbers can be offset). */\n  offset: number;\n  present: boolean;\n}\n\nfunction unquote(raw: string): string {\n  const s = raw.trim();\n  if (\n    (s.startsWith('\"') && s.endsWith('\"') && s.length >= 2) ||\n    (s.startsWith(\"'\") && s.endsWith(\"'\") && s.length >= 2)\n  ) {\n    return s.slice(1, -1);\n  }\n  return s;\n}\n\nfunction coerce(raw: string): FrontmatterValue {\n  const s = raw.trim();\n  // Inline list: [a, b, c]\n  if (s.startsWith(\"[\") && s.endsWith(\"]\")) {\n    return s\n      .slice(1, -1)\n      .split(\",\")\n      .map((x) => unquote(x))\n      .filter((x) => x.length > 0);\n  }\n  if (s === \"true\" || s === \"false\") return s === \"true\";\n  if (s !== \"\" && !Number.isNaN(Number(s)) && /^-?\\d/.test(s)) return Number(s);\n  return unquote(s);\n}\n\n/** Parse a leading `---` frontmatter block. Returns empty data when absent. */\nexport function parseFrontmatter(content: string): Frontmatter {\n  const normalized = content.replace(/^/, \"\");\n  const match = /^---[ \\t]*\\r?\\n([\\s\\S]*?)\\r?\\n---[ \\t]*(?:\\r?\\n|$)/.exec(normalized);\n  if (!match) {\n    return { data: {}, body: content, offset: 0, present: false };\n  }\n\n  const block = match[1]!;\n  const data: Record<string, FrontmatterValue> = {};\n  const lines = block.split(/\\r?\\n/);\n\n  let pendingListKey: string | null = null;\n  let pendingList: string[] = [];\n\n  const flush = () => {\n    if (pendingListKey !== null) {\n      data[pendingListKey] = pendingList;\n      pendingListKey = null;\n      pendingList = [];\n    }\n  };\n\n  for (const line of lines) {\n    if (/^\\s*-\\s+/.test(line) && pendingListKey !== null) {\n      pendingList.push(unquote(line.replace(/^\\s*-\\s+/, \"\")));\n      continue;\n    }\n    flush();\n    const kv = /^([A-Za-z0-9_.-]+):\\s*(.*)$/.exec(line);\n    if (!kv) continue;\n    const key = kv[1]!;\n    const value = kv[2]!;\n    if (value.trim() === \"\") {\n      // Could be the start of a block list.\n      pendingListKey = key;\n      pendingList = [];\n    } else {\n      data[key] = coerce(value);\n    }\n  }\n  flush();\n\n  const offset = match[0].split(/\\r?\\n/).length - 1;\n  return { data, body: normalized.slice(match[0].length), offset, present: true };\n}\n\n/** Get a frontmatter value as a trimmed string (lists join with \", \"). */\nexport function asString(value: FrontmatterValue | undefined): string {\n  if (value === undefined) return \"\";\n  if (Array.isArray(value)) return value.join(\", \");\n  return String(value).trim();\n}\n","/**\n * SEO & frontmatter checks. Beyond per-page frontmatter completeness, this\n * includes the **site-wide** checks no single-file linter can do: duplicate\n * titles and duplicate meta descriptions across the whole docs set (both hurt\n * search ranking). That cross-page view is the point of a suite.\n */\n\nimport { asString } from \"../frontmatter.js\";\nimport type { Config, Finding } from \"../types.js\";\nimport type { Page } from \"../page.js\";\n\nexport interface DuplicateIndex {\n  titles: Map<string, string[]>;\n  descriptions: Map<string, string[]>;\n}\n\n/** Resolve a page's effective title: explicit frontmatter, else the first H1. */\nexport function pageTitle(page: Page): { value: string; source: \"frontmatter\" | \"h1\" | null } {\n  const fm = asString(page.frontmatter.data[\"title\"]);\n  if (fm) return { value: fm, source: \"frontmatter\" };\n  const h1 = page.md.headings.find((h) => h.level === 1);\n  if (h1) return { value: h1.text, source: \"h1\" };\n  return { value: \"\", source: null };\n}\n\nfunction description(page: Page): string {\n  return asString(page.frontmatter.data[\"description\"]);\n}\n\n/** Build the cross-page duplicate index (value → list of page paths). */\nexport function buildDuplicateIndex(pages: Page[]): DuplicateIndex {\n  const titles = new Map<string, string[]>();\n  const descriptions = new Map<string, string[]>();\n  for (const page of pages) {\n    const t = pageTitle(page).value.trim().toLowerCase();\n    if (t) titles.set(t, [...(titles.get(t) ?? []), page.relPath]);\n    const d = description(page).trim().toLowerCase();\n    if (d) descriptions.set(d, [...(descriptions.get(d) ?? []), page.relPath]);\n  }\n  return { titles, descriptions };\n}\n\nexport function seoChecks(page: Page, config: Config, dup: DuplicateIndex): Finding[] {\n  const out: Finding[] = [];\n  const required = new Set(config.requireFrontmatter);\n  const title = pageTitle(page);\n  const desc = description(page);\n\n  // Title.\n  if (required.has(\"title\")) {\n    if (!title.value) {\n      out.push({\n        dimension: \"seo\",\n        rule: \"seo.missing-title\",\n        severity: \"error\",\n        message: \"Page has no title (no frontmatter `title` and no H1)\",\n        fix: \"Add a `title:` to the frontmatter or an `# H1` heading.\",\n      });\n    } else if (title.source === \"h1\") {\n      out.push({\n        dimension: \"seo\",\n        rule: \"seo.frontmatter-title\",\n        severity: \"info\",\n        message: \"Title comes from the H1; add an explicit frontmatter `title` for SEO control\",\n        detail: `Using H1: \"${title.value}\"`,\n      });\n    }\n    if (title.value && title.value.length > config.titleMax) {\n      out.push({\n        dimension: \"seo\",\n        rule: \"seo.title-too-long\",\n        severity: \"warning\",\n        message: `Title is ${title.value.length} chars (recommended ≤ ${config.titleMax})`,\n        fix: \"Shorten the title so it isn't truncated in search results.\",\n      });\n    }\n  }\n\n  // Description.\n  if (required.has(\"description\")) {\n    if (!desc) {\n      out.push({\n        dimension: \"seo\",\n        rule: \"seo.missing-description\",\n        severity: \"warning\",\n        message: \"No frontmatter `description`\",\n        fix: `Add a ${config.descriptionMin}–${config.descriptionMax} char description for the search snippet.`,\n      });\n    } else if (desc.length < config.descriptionMin) {\n      out.push({\n        dimension: \"seo\",\n        rule: \"seo.description-short\",\n        severity: \"warning\",\n        message: `Description is ${desc.length} chars (recommended ≥ ${config.descriptionMin})`,\n      });\n    } else if (desc.length > config.descriptionMax) {\n      out.push({\n        dimension: \"seo\",\n        rule: \"seo.description-long\",\n        severity: \"warning\",\n        message: `Description is ${desc.length} chars (recommended ≤ ${config.descriptionMax})`,\n        fix: \"Trim it so search engines don't truncate the snippet.\",\n      });\n    }\n  }\n\n  // Other required keys.\n  for (const key of config.requireFrontmatter) {\n    if (key === \"title\" || key === \"description\") continue;\n    if (!asString(page.frontmatter.data[key])) {\n      out.push({\n        dimension: \"seo\",\n        rule: `seo.missing-frontmatter`,\n        severity: \"warning\",\n        message: `Missing required frontmatter: \\`${key}\\``,\n      });\n    }\n  }\n\n  // Site-wide duplicates.\n  const tKey = title.value.trim().toLowerCase();\n  const others = (dup.titles.get(tKey) ?? []).filter((p) => p !== page.relPath);\n  if (tKey && others.length) {\n    out.push({\n      dimension: \"seo\",\n      rule: \"seo.duplicate-title\",\n      severity: \"warning\",\n      message: `Duplicate title — also used by ${others.length} other page(s)`,\n      detail: others.slice(0, 3).join(\", \"),\n      fix: \"Give each page a unique title; duplicates compete in search results.\",\n    });\n  }\n  const dKey = desc.trim().toLowerCase();\n  const dOthers = (dup.descriptions.get(dKey) ?? []).filter((p) => p !== page.relPath);\n  if (dKey && dOthers.length) {\n    out.push({\n      dimension: \"seo\",\n      rule: \"seo.duplicate-description\",\n      severity: \"warning\",\n      message: `Duplicate description — also used by ${dOthers.length} other page(s)`,\n      detail: dOthers.slice(0, 3).join(\", \"),\n      fix: \"Write a unique description per page.\",\n    });\n  }\n\n  return out;\n}\n","/**\n * Structure & accessibility checks on Markdown — the docs-relevant subset of an\n * HTML a11y linter: a single H1, no skipped heading levels, images with alt\n * text, and fenced code blocks that declare a language (for correct syntax\n * highlighting and screen-reader hints).\n */\n\nimport type { Config, Finding } from \"../types.js\";\nimport type { Page } from \"../page.js\";\n\nexport function structureChecks(page: Page, _config: Config): Finding[] {\n  const out: Finding[] = [];\n  const { headings, images, fences } = page.md;\n\n  // Single H1.\n  const h1s = headings.filter((h) => h.level === 1);\n  if (h1s.length === 0) {\n    out.push({\n      dimension: \"structure\",\n      rule: \"structure.no-h1\",\n      severity: \"warning\",\n      message: \"No H1 heading\",\n      fix: \"Start the page with a single `# Title`.\",\n    });\n  } else if (h1s.length > 1) {\n    out.push({\n      dimension: \"structure\",\n      rule: \"structure.multiple-h1\",\n      severity: \"warning\",\n      message: `${h1s.length} H1 headings (use exactly one)`,\n      line: h1s[1]!.line,\n      fix: \"Demote the extra H1s to H2/H3 so the outline has one top level.\",\n    });\n  }\n\n  // No skipped heading levels (e.g. H2 → H4).\n  let prev = 0;\n  for (const h of headings) {\n    if (prev !== 0 && h.level > prev + 1) {\n      out.push({\n        dimension: \"structure\",\n        rule: \"structure.skipped-heading\",\n        severity: \"warning\",\n        message: `Heading jumps from H${prev} to H${h.level} (\"${h.text}\")`,\n        line: h.line,\n        fix: \"Don't skip levels — screen readers and outlines rely on order.\",\n      });\n    }\n    prev = h.level;\n  }\n\n  // Images need alt text.\n  for (const img of images) {\n    if (img.alt.trim() === \"\") {\n      out.push({\n        dimension: \"structure\",\n        rule: \"structure.image-alt\",\n        severity: \"warning\",\n        message: `Image has no alt text: ${img.src}`,\n        line: img.line,\n        fix: \"Add descriptive alt text: `![what it shows](src)`.\",\n      });\n    }\n  }\n\n  // Code fences should declare a language.\n  for (const fence of fences) {\n    if (fence.lang === null) {\n      out.push({\n        dimension: \"structure\",\n        rule: \"structure.code-language\",\n        severity: \"info\",\n        message: \"Code block has no language tag\",\n        line: fence.line,\n        fix: \"Add a language after the opening fence (e.g. ```ts) for highlighting.\",\n      });\n    }\n  }\n\n  return out;\n}\n","/** Configuration defaults, parsing, and resolution (pure — no file I/O). */\n\nimport type { Config, Dimension } from \"./types.js\";\n\nexport const DEFAULT_CONFIG: Config = {\n  extensions: [\".md\", \".mdx\", \".markdown\"],\n  requireFrontmatter: [\"title\", \"description\"],\n  descriptionMin: 50,\n  descriptionMax: 160,\n  titleMax: 60,\n  maxGrade: 14,\n  minWordsForReadability: 80,\n  disable: [],\n  ignore: [],\n  minScore: 0,\n};\n\nexport const CONFIG_FILENAMES = [\"docsanity.config.json\", \".docsanityrc.json\", \".docsanityrc\"];\n\nfunction isPlainObject(v: unknown): v is Record<string, unknown> {\n  return typeof v === \"object\" && v !== null && !Array.isArray(v);\n}\n\nexport function mergeConfig(base: Config, override: Partial<Config>): Config {\n  const out = { ...base } as unknown as Record<string, unknown>;\n  for (const [k, v] of Object.entries(override ?? {})) {\n    if (v !== undefined) out[k] = v;\n  }\n  return out as unknown as Config;\n}\n\nexport function parseConfig(json: string, label = \"config\"): Config {\n  let data: unknown;\n  try {\n    data = JSON.parse(json);\n  } catch (e) {\n    throw new Error(`invalid ${label}: ${(e as Error).message}`);\n  }\n  if (!isPlainObject(data)) throw new Error(`invalid ${label}: must be a JSON object`);\n  return mergeConfig(DEFAULT_CONFIG, data as Partial<Config>);\n}\n\nexport function isDimensionEnabled(config: Config, dim: Dimension): boolean {\n  return !config.disable.includes(dim);\n}\n","/**\n * Links & references — leverages the `linklint` engine, which already builds a\n * cross-file project graph and finds broken relative links, dead `#anchors`,\n * missing images, undefined references and **orphan pages** (nothing links to\n * them). docsanity runs it once over the whole set and folds its findings into\n * the unified per-page report, keyed by each page's root-relative path.\n */\n\nimport { relative } from \"node:path\";\nimport {\n  analyze as linklintAnalyze,\n  buildProjectFromInputs,\n  DEFAULT_CONFIG as LINKLINT_DEFAULTS,\n  findOrphans,\n  type Issue,\n} from \"@didrod2539/linklint\";\nimport type { Finding, Severity } from \"./types.js\";\nimport type { Page } from \"./page.js\";\n\nfunction mapSeverity(s: Issue[\"severity\"]): Severity {\n  return s === \"error\" || s === \"warning\" || s === \"info\" ? s : \"warning\";\n}\n\n/** Run linklint over all pages; return findings keyed by root-relative path. */\nexport function linkFindings(root: string, pages: Page[]): Map<string, Finding[]> {\n  const inputs = pages.map((p) => ({ path: p.absPath, content: p.content }));\n  const project = buildProjectFromInputs(root, inputs);\n  const report = linklintAnalyze(project, LINKLINT_DEFAULTS);\n\n  // linklint reports document paths relative to the project root.\n  const byPath = new Map<string, Finding[]>();\n  for (const doc of report.documents) {\n    byPath.set(\n      doc.path,\n      doc.issues.map((i) => ({\n        dimension: \"links\" as const,\n        rule: `links.${i.rule}`,\n        severity: mapSeverity(i.severity),\n        message: i.message,\n        line: i.line,\n        detail: i.detail,\n        fix: i.fix,\n      })),\n    );\n  }\n\n  // Orphan detection (off by default in linklint's config) — run it explicitly.\n  for (const abs of findOrphans(project)) {\n    const rel = relative(root, abs) || abs;\n    const list = byPath.get(rel) ?? [];\n    list.push({\n      dimension: \"links\",\n      rule: \"links.orphan-document\",\n      severity: \"warning\",\n      message: \"Orphan page — nothing links here\",\n      fix: \"Link to it from an index/README, or remove it if it's obsolete.\",\n    });\n    byPath.set(rel, list);\n  }\n\n  return byPath;\n}\n","/**\n * Lightweight Markdown extraction — headings, images, code fences and a plain\n * text projection — without a full Markdown parser. We track fenced code blocks\n * so `#` inside a code sample is never mistaken for a heading.\n */\n\nexport interface Heading {\n  level: number;\n  text: string;\n  line: number;\n}\n\nexport interface MdImage {\n  alt: string;\n  src: string;\n  line: number;\n}\n\nexport interface CodeFence {\n  lang: string | null;\n  line: number;\n}\n\nexport interface MarkdownModel {\n  headings: Heading[];\n  images: MdImage[];\n  fences: CodeFence[];\n  /** Plain-text projection suitable for readability scoring. */\n  text: string;\n}\n\nconst FENCE_RE = /^(\\s*)(`{3,}|~{3,})\\s*([A-Za-z0-9_+-]*)/;\nconst HEADING_RE = /^(#{1,6})\\s+(.+?)\\s*#*\\s*$/;\nconst IMAGE_RE = /!\\[([^\\]]*)\\]\\(([^)\\s]+)(?:\\s+[\"'][^\"']*[\"'])?\\)/g;\nconst HTML_IMG_RE = /<img\\b[^>]*>/gi;\n\nfunction htmlImgAlt(tag: string): string {\n  const m = /\\balt\\s*=\\s*[\"']([^\"']*)[\"']/i.exec(tag);\n  return m ? m[1]! : \"\";\n}\nfunction htmlImgSrc(tag: string): string {\n  const m = /\\bsrc\\s*=\\s*[\"']([^\"']*)[\"']/i.exec(tag);\n  return m ? m[1]! : \"\";\n}\n\nexport function parseMarkdown(body: string, lineOffset = 0): MarkdownModel {\n  const lines = body.split(/\\r?\\n/);\n  const headings: Heading[] = [];\n  const images: MdImage[] = [];\n  const fences: CodeFence[] = [];\n  const textParts: string[] = [];\n\n  let inFence = false;\n  let fenceMarker = \"\";\n\n  for (let i = 0; i < lines.length; i++) {\n    const raw = lines[i]!;\n    const lineNo = i + 1 + lineOffset;\n\n    const fence = FENCE_RE.exec(raw);\n    if (fence && (!inFence || raw.trim().startsWith(fenceMarker))) {\n      const marker = fence[2]!;\n      if (!inFence) {\n        inFence = true;\n        fenceMarker = marker[0]!.repeat(3);\n        fences.push({ lang: fence[3] ? fence[3] : null, line: lineNo });\n      } else {\n        inFence = false;\n        fenceMarker = \"\";\n      }\n      continue;\n    }\n    if (inFence) continue; // skip code content entirely\n\n    const heading = HEADING_RE.exec(raw);\n    if (heading) {\n      headings.push({ level: heading[1]!.length, text: heading[2]!.trim(), line: lineNo });\n      textParts.push(heading[2]!.trim());\n      continue;\n    }\n\n    let m: RegExpExecArray | null;\n    IMAGE_RE.lastIndex = 0;\n    while ((m = IMAGE_RE.exec(raw)) !== null) {\n      images.push({ alt: m[1]!, src: m[2]!, line: lineNo });\n    }\n    HTML_IMG_RE.lastIndex = 0;\n    while ((m = HTML_IMG_RE.exec(raw)) !== null) {\n      images.push({ alt: htmlImgAlt(m[0]), src: htmlImgSrc(m[0]), line: lineNo });\n    }\n\n    textParts.push(stripInline(raw));\n  }\n\n  return { headings, images, fences, text: textParts.join(\"\\n\").trim() };\n}\n\n/** Reduce a Markdown line to readable prose for readability scoring. */\nfunction stripInline(line: string): string {\n  return line\n    .replace(IMAGE_RE, \"\") // images contribute no prose\n    .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\") // links → their text\n    .replace(/`([^`]*)`/g, \"$1\") // inline code\n    .replace(/<[^>]+>/g, \"\") // html tags\n    .replace(/^[>\\s]*>/g, \"\") // blockquote markers\n    .replace(/^\\s{0,3}([*+-]|\\d+\\.)\\s+/g, \"\") // list markers\n    .replace(/[*_~]+/g, \"\") // emphasis\n    .trim();\n}\n","/** A parsed documentation page: frontmatter + extracted Markdown model. */\n\nimport { parseFrontmatter, type Frontmatter } from \"./frontmatter.js\";\nimport { parseMarkdown, type MarkdownModel } from \"./markdown.js\";\n\nexport interface Page {\n  /** Absolute path (needed for cross-file link resolution). */\n  absPath: string;\n  /** Path relative to the scanned root (for display). */\n  relPath: string;\n  content: string;\n  frontmatter: Frontmatter;\n  md: MarkdownModel;\n}\n\nexport function parsePage(absPath: string, relPath: string, content: string): Page {\n  const frontmatter = parseFrontmatter(content);\n  // Offset Markdown line numbers by the frontmatter block so they map to the file.\n  const md = parseMarkdown(frontmatter.body, frontmatter.offset);\n  return { absPath, relPath, content, frontmatter, md };\n}\n","/** Weighted scoring: turn findings into a 0–100 score and an A–F grade. */\n\nimport type { Finding } from \"./types.js\";\n\nconst PENALTY: Record<string, number> = { error: 12, warning: 4, info: 1, pass: 0 };\n\n/** Page score: 100 minus capped, weighted penalties for its findings. */\nexport function scorePage(findings: Finding[]): number {\n  let penalty = 0;\n  for (const f of findings) penalty += PENALTY[f.severity] ?? 0;\n  return Math.max(0, 100 - penalty);\n}\n\nexport function gradeFor(score: number): string {\n  if (score >= 90) return \"A\";\n  if (score >= 80) return \"B\";\n  if (score >= 70) return \"C\";\n  if (score >= 60) return \"D\";\n  return \"F\";\n}\n","/** Core types for docsanity. */\n\nexport type Severity = \"error\" | \"warning\" | \"info\" | \"pass\";\n\n/** The four health dimensions docsanity unifies into one report. */\nexport type Dimension = \"links\" | \"seo\" | \"readability\" | \"structure\";\n\nexport const DIMENSIONS: Dimension[] = [\"links\", \"seo\", \"readability\", \"structure\"];\n\nexport const DIMENSION_LABELS: Record<Dimension, string> = {\n  links: \"Links & references\",\n  seo: \"SEO & frontmatter\",\n  readability: \"Readability\",\n  structure: \"Structure & a11y\",\n};\n\nexport interface Finding {\n  dimension: Dimension;\n  /** Stable id, e.g. \"seo.missing-description\". */\n  rule: string;\n  severity: Severity;\n  message: string;\n  /** 1-based line number, when known. */\n  line?: number;\n  detail?: string;\n  fix?: string;\n}\n\nexport interface ReadabilitySummary {\n  grade: number;\n  gradeLabel: string;\n  ease: string;\n  words: number;\n  readingTimeSeconds: number;\n}\n\nexport interface PageReport {\n  /** Path relative to the scanned root. */\n  path: string;\n  title: string | null;\n  score: number;\n  grade: string;\n  counts: { error: number; warning: number; info: number };\n  findings: Finding[];\n  readability?: ReadabilitySummary;\n}\n\nexport interface DocsReport {\n  tool: \"docsanity\";\n  version: string;\n  generatedAt: string;\n  root: string;\n  summary: {\n    pages: number;\n    score: number;\n    grade: string;\n    errors: number;\n    warnings: number;\n    infos: number;\n    byDimension: Record<Dimension, { errors: number; warnings: number; infos: number }>;\n  };\n  pages: PageReport[];\n}\n\nexport interface Config {\n  /** File extensions to scan. */\n  extensions: string[];\n  /** Frontmatter keys every page must have (non-empty). */\n  requireFrontmatter: string[];\n  /** Recommended meta-description length window. */\n  descriptionMin: number;\n  descriptionMax: number;\n  /** Warn when a title is longer than this (characters). */\n  titleMax: number;\n  /** Warn when a page's reading grade exceeds this. */\n  maxGrade: number;\n  /** Minimum word count before readability is scored. */\n  minWordsForReadability: number;\n  /** Dimensions to skip entirely. */\n  disable: Dimension[];\n  /** Rule ids to ignore (e.g. \"structure.code-language\"). */\n  ignore: string[];\n  /** CI gate: overall score floor. */\n  minScore: number;\n}\n","/**\n * The orchestrator: parse every page once, run all four dimensions over the\n * shared page set (so site-wide checks like duplicate titles and orphan pages\n * work), and fold everything into one unified report with a combined score.\n */\n\nimport { readabilityCheck } from \"./checks/readability.js\";\nimport { buildDuplicateIndex, pageTitle, seoChecks } from \"./checks/seo.js\";\nimport { structureChecks } from \"./checks/structure.js\";\nimport { isDimensionEnabled } from \"./config.js\";\nimport { linkFindings } from \"./links.js\";\nimport { parsePage, type Page } from \"./page.js\";\nimport { gradeFor, scorePage } from \"./score.js\";\nimport {\n  DIMENSIONS,\n  type Config,\n  type Dimension,\n  type DocsReport,\n  type Finding,\n  type PageReport,\n  type ReadabilitySummary,\n} from \"./types.js\";\n\nexport interface InputDoc {\n  absPath: string;\n  relPath: string;\n  content: string;\n}\n\nexport interface AnalyzeMeta {\n  version: string;\n  generatedAt: string;\n}\n\n/** Analyze a set of documentation pages into a unified {@link DocsReport}. */\nexport function analyzeDocs(\n  root: string,\n  inputs: InputDoc[],\n  config: Config,\n  meta: AnalyzeMeta,\n): DocsReport {\n  const pages: Page[] = inputs.map((i) => parsePage(i.absPath, i.relPath, i.content));\n  const ignore = new Set(config.ignore);\n\n  // Cross-page indexes / engines (computed once over the whole set).\n  const dup = buildDuplicateIndex(pages);\n  const links = isDimensionEnabled(config, \"links\")\n    ? linkFindings(root, pages)\n    : new Map<string, Finding[]>();\n\n  const pageReports: PageReport[] = pages.map((page) => {\n    const findings: Finding[] = [];\n    let readability: ReadabilitySummary | undefined;\n\n    if (isDimensionEnabled(config, \"links\")) {\n      findings.push(...(links.get(page.relPath) ?? []));\n    }\n    if (isDimensionEnabled(config, \"seo\")) {\n      findings.push(...seoChecks(page, config, dup));\n    }\n    if (isDimensionEnabled(config, \"structure\")) {\n      findings.push(...structureChecks(page, config));\n    }\n    if (isDimensionEnabled(config, \"readability\")) {\n      const r = readabilityCheck(page, config);\n      findings.push(...r.findings);\n      readability = r.summary;\n    }\n\n    const kept = findings.filter((f) => !ignore.has(f.rule));\n    const counts = { error: 0, warning: 0, info: 0 };\n    for (const f of kept) {\n      if (f.severity === \"error\") counts.error++;\n      else if (f.severity === \"warning\") counts.warning++;\n      else if (f.severity === \"info\") counts.info++;\n    }\n    const score = scorePage(kept);\n\n    return {\n      path: page.relPath,\n      title: pageTitle(page).value || null,\n      score,\n      grade: gradeFor(score),\n      counts,\n      findings: kept,\n      readability,\n    };\n  });\n\n  pageReports.sort((a, b) => a.path.localeCompare(b.path));\n\n  // Summary.\n  const errors = pageReports.reduce((s, p) => s + p.counts.error, 0);\n  const warnings = pageReports.reduce((s, p) => s + p.counts.warning, 0);\n  const infos = pageReports.reduce((s, p) => s + p.counts.info, 0);\n  const score = pageReports.length\n    ? Math.round(pageReports.reduce((s, p) => s + p.score, 0) / pageReports.length)\n    : 100;\n\n  const byDimension = Object.fromEntries(\n    DIMENSIONS.map((d) => [d, { errors: 0, warnings: 0, infos: 0 }]),\n  ) as Record<Dimension, { errors: number; warnings: number; infos: number }>;\n  for (const p of pageReports) {\n    for (const f of p.findings) {\n      const bucket = byDimension[f.dimension];\n      if (f.severity === \"error\") bucket.errors++;\n      else if (f.severity === \"warning\") bucket.warnings++;\n      else if (f.severity === \"info\") bucket.infos++;\n    }\n  }\n\n  return {\n    tool: \"docsanity\",\n    version: meta.version,\n    generatedAt: meta.generatedAt,\n    root,\n    summary: { pages: pageReports.length, score, grade: gradeFor(score), errors, warnings, infos, byDimension },\n    pages: pageReports,\n  };\n}\n"]}