mcp-web-validator 1.0.0 → 1.2.0

package/dist/presentation.js

@@ -0,0 +1,347 @@
+function collapseWhitespace(value, maxLength = 240) {
+    const collapsed = value.replace(/\s+/g, " ").trim();
+    if (collapsed.length <= maxLength) {
+        return collapsed;
+    }
+    return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;
+}
+/** Escapes untrusted text while leaving the surrounding, controlled Markdown intact. */
+function markdownText(value, maxLength = 240) {
+    return collapseWhitespace(value, maxLength)
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/\\/g, "\\\\")
+        .replace(/([`*_[\]{}()#+\-.!|~])/g, "\\$1");
+}
+/** Wraps untrusted identifiers and paths in a code span that cannot be closed by their content. */
+function markdownCode(value, maxLength = 240) {
+    const collapsed = collapseWhitespace(value, maxLength);
+    const longestBacktickRun = Math.max(0, ...Array.from(collapsed.matchAll(/`+/g), (match) => match[0].length));
+    const delimiter = "`".repeat(longestBacktickRun + 1);
+    const content = collapsed.startsWith("`") || collapsed.endsWith("`")
+        ? ` ${collapsed} `
+        : collapsed;
+    return `${delimiter}${content}${delimiter}`;
+}
+function countLabel(count, singular, plural = `${singular}s`) {
+    return `${count} ${count === 1 ? singular : plural}`;
+}
+function priorityForSeverity(severity) {
+    if (severity.toLowerCase() === "error")
+        return 0;
+    if (severity.toLowerCase() === "warning")
+        return 1;
+    return 2;
+}
+function formatLocation(line, column) {
+    if (line === undefined && column === undefined)
+        return undefined;
+    if (line === undefined)
+        return `column ${column}`;
+    if (column === undefined)
+        return `line ${line}`;
+    return `line ${line}, column ${column}`;
+}
+function formatActions(items) {
+    const prioritized = items
+        .map((item, index) => ({ item, index }))
+        .sort((left, right) => left.item.priority - right.item.priority || left.index - right.index)
+        .slice(0, 3)
+        .map(({ item }) => {
+        const label = item.priority === 0 ? "Error" : item.priority === 1 ? "Warning" : "Check";
+        const location = item.location
+            ? ` · ${markdownCode(item.location, 120)}`
+            : "";
+        return `- **${label}**${location}: ${markdownText(item.message)}`;
+    });
+    return prioritized.length > 0 ? prioritized.join("\n") : undefined;
+}
+function toolContent(options) {
+    const sections = [
+        `### ${options.title}: ${options.status}`,
+        collapseWhitespace(options.outcome, 500),
+    ];
+    if (options.note) {
+        sections.push(collapseWhitespace(options.note, 500));
+    }
+    const actions = formatActions(options.actions ?? []);
+    if (actions) {
+        sections.push(`**Fix first**\n${actions}`);
+    }
+    sections.push(`**Next step:** ${collapseWhitespace(options.nextStep, 400)}`);
+    return sections.join("\n\n");
+}
+export function htmlValidationContent(messages, source) {
+    const errorCount = messages.filter((message) => message.type.toLowerCase() === "error").length;
+    const otherCount = messages.length - errorCount;
+    const sourceText = source ? ` for ${markdownCode(source, 180)}` : "";
+    if (messages.length === 0) {
+        return toolContent({
+            title: "HTML validation",
+            status: "clean",
+            outcome: `The W3C validator returned no HTML diagnostics${sourceText}.`,
+            nextStep: "Keep this result as a baseline and validate again after the next markup change.",
+        });
+    }
+    return toolContent({
+        title: "HTML validation",
+        status: "attention needed",
+        outcome: `The W3C validator returned ${countLabel(errorCount, "error")} and ${countLabel(otherCount, "other diagnostic")}${sourceText}.`,
+        actions: messages.map((message) => ({
+            priority: priorityForSeverity(message.type),
+            message: message.message,
+            location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),
+        })),
+        nextStep: "Fix the errors in order, then rerun HTML validation to confirm the markup is clean.",
+    });
+}
+export function cssValidationContent(messages) {
+    if (messages.length === 0) {
+        return toolContent({
+            title: "CSS validation",
+            status: "clean",
+            outcome: "The W3C validator returned no CSS errors.",
+            nextStep: "Validate again after the next stylesheet change.",
+        });
+    }
+    return toolContent({
+        title: "CSS validation",
+        status: "attention needed",
+        outcome: `The W3C validator returned ${countLabel(messages.length, "CSS error")}.`,
+        actions: messages.map((message) => ({
+            priority: 0,
+            message: message.context ? `${message.message} Context: ${message.context}` : message.message,
+            location: formatLocation(message.line),
+        })),
+        nextStep: "Correct the first errors, then rerun CSS validation because one syntax issue can cause later diagnostics.",
+    });
+}
+export function seoAuditContent(issues, totalIssues, truncated) {
+    const errors = issues.filter((issue) => issue.severity === "error").length;
+    const warnings = issues.filter((issue) => issue.severity === "warning").length;
+    const info = issues.filter((issue) => issue.severity === "info").length;
+    if (totalIssues === 0) {
+        return toolContent({
+            title: "SEO audit",
+            status: "clean within this audit",
+            outcome: "This focused rules-based audit found no SEO or accessibility issues in the supplied HTML.",
+            nextStep: "Keep the metadata current and rerun the audit whenever the page template changes.",
+            note: "This result does not replace a crawl, performance test, or Search Console review.",
+        });
+    }
+    return toolContent({
+        title: "SEO audit",
+        status: "attention needed",
+        outcome: `The audit found ${countLabel(errors, "error")}, ${countLabel(warnings, "warning")}, and ${countLabel(info, "suggestion")}.`,
+        actions: issues.map((issue) => ({
+            priority: priorityForSeverity(issue.severity),
+            message: issue.message,
+            location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,
+        })),
+        nextStep: "Address errors first, then warnings, and rerun the audit after updating the page.",
+        note: truncated
+            ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`
+            : undefined,
+    });
+}
+function countJsonLdBlocks(htmlContent) {
+    const matches = htmlContent.match(/<script\b(?=[^>]*\btype\s*=\s*(?:"application\/ld\+json"|'application\/ld\+json'|application\/ld\+json\b))[^>]*>/gi);
+    return matches?.length ?? 0;
+}
+export function schemaValidationContent(issues, totalIssues, truncated, htmlContent) {
+    const blockCount = countJsonLdBlocks(htmlContent);
+    if (blockCount === 0) {
+        return toolContent({
+            title: "JSON-LD syntax",
+            status: "not present",
+            outcome: "No JSON-LD script blocks were found, so there was no structured data to parse.",
+            nextStep: "Add JSON-LD only when it accurately describes visible page content, then validate it again.",
+        });
+    }
+    if (totalIssues === 0) {
+        return toolContent({
+            title: "JSON-LD syntax",
+            status: "clean",
+            outcome: `${countLabel(blockCount, "JSON-LD block")} parsed without syntax errors.`,
+            nextStep: "Verify the properties against the relevant Schema.org type and search-engine requirements.",
+            note: "This check covers JSON syntax only; it does not validate vocabulary semantics or rich-result eligibility.",
+        });
+    }
+    return toolContent({
+        title: "JSON-LD syntax",
+        status: "attention needed",
+        outcome: `${countLabel(totalIssues, "syntax issue")} ${totalIssues === 1 ? "was" : "were"} found across ${countLabel(blockCount, "JSON-LD block")}.`,
+        actions: issues.map((issue) => ({
+            priority: priorityForSeverity(issue.severity),
+            message: issue.message,
+        })),
+        nextStep: "Repair the invalid or empty blocks, then rerun this syntax check before testing rich-result eligibility.",
+        note: truncated
+            ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`
+            : undefined,
+    });
+}
+function linkPriority(link) {
+    if (isRedirect(link))
+        return 1;
+    return 0;
+}
+function isRedirect(link) {
+    return typeof link.status === "number" && link.status >= 300 && link.status < 400;
+}
+function linkActionMessage(link) {
+    if (isRedirect(link)) {
+        return `${link.status} redirect; destination was not followed`;
+    }
+    return `Link returned ${typeof link.status === "number" ? `HTTP ${link.status}` : link.status}${link.message ? ` — ${link.message}` : ""}`;
+}
+export function linkCheckContent(links, baseUrl) {
+    if (links.length === 0) {
+        return toolContent({
+            title: "Link check",
+            status: "nothing checked",
+            outcome: "No eligible public HTTP(S) links were found, so no link requests were made.",
+            nextStep: baseUrl
+                ? "Confirm the HTML contains reachable anchor URLs, then run the check again."
+                : "If the page uses relative links, provide its public base URL and run the check again.",
+        });
+    }
+    const unreachable = links.filter((link) => !link.ok);
+    const redirects = links.filter(isRedirect);
+    if (unreachable.length === 0 && redirects.length === 0) {
+        return toolContent({
+            title: "Link check",
+            status: "clean",
+            outcome: links.length === 1
+                ? "The checked link returned a successful response."
+                : `All ${links.length} checked links returned a successful response.`,
+            nextStep: "Recheck periodically because external link availability can change.",
+        });
+    }
+    const actions = [
+        ...unreachable,
+        ...redirects,
+    ].map((link) => ({
+        priority: linkPriority(link),
+        location: link.url,
+        message: linkActionMessage(link),
+    }));
+    const linkOutcome = [
+        unreachable.length > 0
+            ? `${countLabel(unreachable.length, "link")} ${unreachable.length === 1 ? "is" : "are"} broken or unreachable`
+            : "no checked links are broken or unreachable",
+        redirects.length > 0
+            ? `${countLabel(redirects.length, "redirect")} ${redirects.length === 1 ? "needs" : "need"} review`
+            : undefined,
+    ].filter((item) => item !== undefined).join("; ");
+    return toolContent({
+        title: "Link check",
+        status: unreachable.length > 0 ? "attention needed" : "review suggested",
+        outcome: `${linkOutcome} of ${links.length} checked. Redirect destinations are not followed.`,
+        actions,
+        nextStep: "Update failed destinations and review redirects, then rerun the link check.",
+    });
+}
+function reportActionItems(reportData) {
+    return [
+        ...(reportData.errors ?? []).map((message) => ({
+            priority: 0,
+            message,
+        })),
+        ...reportData.htmlMessages.map((message) => ({
+            priority: priorityForSeverity(message.type),
+            message: `HTML: ${message.message}`,
+            location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),
+        })),
+        ...reportData.cssMessages.map((message) => ({
+            priority: 0,
+            message: `CSS: ${message.message}`,
+            location: formatLocation(message.line),
+        })),
+        ...reportData.seoIssues.map((issue) => ({
+            priority: priorityForSeverity(issue.severity),
+            message: `${issue.category}: ${issue.message}`,
+            location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,
+        })),
+        ...reportData.schemaIssues.map((issue) => ({
+            priority: priorityForSeverity(issue.severity),
+            message: `JSON-LD: ${issue.message}`,
+        })),
+        ...reportData.links
+            .filter((link) => !link.ok || isRedirect(link))
+            .map((link) => ({
+            priority: linkPriority(link),
+            message: linkActionMessage(link),
+            location: link.url,
+        })),
+    ];
+}
+export function reportContent(reportData) {
+    const { summary } = reportData;
+    const actions = reportActionItems(reportData);
+    const partial = reportData.failedChecks.length > 0;
+    const hasActionableFinding = actions.some((action) => action.priority < 2);
+    const status = partial
+        ? "partial"
+        : actions.length === 0
+            ? "clean across completed checks"
+            : hasActionableFinding
+                ? "attention needed"
+                : "review suggested";
+    const cssSummary = summary.cssScore === null
+        ? reportData.failedChecks.includes("css")
+            ? "CSS validation unavailable"
+            : "CSS not audited"
+        : countLabel(summary.cssErrors, "CSS error");
+    const redirects = reportData.links.filter(isRedirect).length;
+    const linkSummary = summary.linkScore === null
+        ? reportData.failedChecks.includes("links")
+            ? "link checking unavailable"
+            : "no eligible links checked"
+        : `${summary.brokenLinks} broken or unreachable and ${countLabel(redirects, "redirect")} to review of ${countLabel(summary.linksChecked, "link")}`;
+    const checkLabels = {
+        input: "input file",
+        html: "HTML validation",
+        css: "CSS validation",
+        seo: "SEO analysis",
+        schema: "JSON-LD analysis",
+        links: "link checking",
+    };
+    const unavailableChecks = reportData.failedChecks
+        .filter((check) => check !== "input")
+        .map((check) => checkLabels[check]);
+    return toolContent({
+        title: "Validation report",
+        status,
+        outcome: partial
+            ? `Partial validation report: ${unavailableChecks.join(", ")} ${unavailableChecks.length === 1 ? "was" : "were"} unavailable; remaining checks completed. HTML has ${countLabel(summary.htmlErrors, "error")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, "error")}; JSON-LD has ${countLabel(summary.schemaErrors, "syntax error")}; ${linkSummary}.`
+            : `The report's heuristic overall score is **${summary.overallScore}/100**. HTML has ${countLabel(summary.htmlErrors, "error")} and ${countLabel(summary.htmlWarnings, "other diagnostic")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, "error")} and ${countLabel(summary.seoWarnings, "warning")}; JSON-LD has ${countLabel(summary.schemaErrors, "syntax error")}; ${linkSummary}.`,
+        actions,
+        nextStep: partial
+            ? "Review the completed findings, then retry the unavailable checks."
+            : actions.length === 0
+                ? "Use the full Markdown report as the audit record and rerun it after meaningful page changes."
+                : "Work through these priorities, then regenerate the report to compare the heuristic score.",
+        note: partial
+            ? "No overall score is shown while one or more checks are unavailable."
+            : "The score is a triage heuristic based on these checks, not a Lighthouse score or a search-ranking prediction.",
+    });
+}
+export function screenshotCaptureContent(count, outputDirectory) {
+    return toolContent({
+        title: "Screenshot capture",
+        status: "complete",
+        outcome: `Saved ${countLabel(count, "PNG screenshot")} to ${markdownCode(outputDirectory)}.`,
+        nextStep: "Open the PNG files and compare the rendered layouts at each requested viewport.",
+    });
+}
+export function failureContent(title, error, nextStep) {
+    return toolContent({
+        title,
+        status: "could not finish",
+        outcome: markdownText(error, 500),
+        nextStep,
+    });
+}
+//# sourceMappingURL=presentation.js.map

package/dist/presentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.js","sourceRoot":"","sources":["../src/presentation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ValidationReport } from \"./report.js\";\nimport type { LinkStatus, SEOIssue } from \"./seo-auditor.js\";\nimport type { CSSMessage, W3CMessage } from \"./w3c-validator.js\";\n\ntype ActionPriority = 0 | 1 | 2;\n\ninterface ActionItem {\n  message: string;\n  priority: ActionPriority;\n  location?: string;\n}\n\ninterface ValidationReportResult extends ValidationReport {\n  errors?: string[];\n}\n\nfunction collapseWhitespace(value: string, maxLength = 240): string {\n  const collapsed = value.replace(/\\s+/g, \" \").trim();\n  if (collapsed.length <= maxLength) {\n    return collapsed;\n  }\n  return `${collapsed.slice(0, Math.max(0, maxLength - 1)).trimEnd()}…`;\n}\n\n/** Escapes untrusted text while leaving the surrounding, controlled Markdown intact. */\nfunction markdownText(value: string, maxLength = 240): string {\n  return collapseWhitespace(value, maxLength)\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\")\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/([`*_[\\]{}()#+\\-.!|~])/g, \"\\\\$1\");\n}\n\n/** Wraps untrusted identifiers and paths in a code span that cannot be closed by their content. */\nfunction markdownCode(value: string, maxLength = 240): string {\n  const collapsed = collapseWhitespace(value, maxLength);\n  const longestBacktickRun = Math.max(\n    0,\n    ...Array.from(collapsed.matchAll(/`+/g), (match) => match[0].length),\n  );\n  const delimiter = \"`\".repeat(longestBacktickRun + 1);\n  const content = collapsed.startsWith(\"`\") || collapsed.endsWith(\"`\")\n    ? ` ${collapsed} `\n    : collapsed;\n  return `${delimiter}${content}${delimiter}`;\n}\n\nfunction countLabel(count: number, singular: string, plural = `${singular}s`): string {\n  return `${count} ${count === 1 ? singular : plural}`;\n}\n\nfunction priorityForSeverity(severity: string): ActionPriority {\n  if (severity.toLowerCase() === \"error\") return 0;\n  if (severity.toLowerCase() === \"warning\") return 1;\n  return 2;\n}\n\nfunction formatLocation(line?: number, column?: number): string | undefined {\n  if (line === undefined && column === undefined) return undefined;\n  if (line === undefined) return `column ${column}`;\n  if (column === undefined) return `line ${line}`;\n  return `line ${line}, column ${column}`;\n}\n\nfunction formatActions(items: ActionItem[]): string | undefined {\n  const prioritized = items\n    .map((item, index) => ({ item, index }))\n    .sort((left, right) => left.item.priority - right.item.priority || left.index - right.index)\n    .slice(0, 3)\n    .map(({ item }) => {\n      const label = item.priority === 0 ? \"Error\" : item.priority === 1 ? \"Warning\" : \"Check\";\n      const location = item.location\n        ? ` · ${markdownCode(item.location, 120)}`\n        : \"\";\n      return `- **${label}**${location}: ${markdownText(item.message)}`;\n    });\n\n  return prioritized.length > 0 ? prioritized.join(\"\\n\") : undefined;\n}\n\nfunction toolContent(options: {\n  title: string;\n  status: string;\n  outcome: string;\n  nextStep: string;\n  actions?: ActionItem[];\n  note?: string;\n}): string {\n  const sections = [\n    `### ${options.title}: ${options.status}`,\n    collapseWhitespace(options.outcome, 500),\n  ];\n  if (options.note) {\n    sections.push(collapseWhitespace(options.note, 500));\n  }\n  const actions = formatActions(options.actions ?? []);\n  if (actions) {\n    sections.push(`**Fix first**\\n${actions}`);\n  }\n  sections.push(`**Next step:** ${collapseWhitespace(options.nextStep, 400)}`);\n  return sections.join(\"\\n\\n\");\n}\n\nexport function htmlValidationContent(messages: W3CMessage[], source?: string): string {\n  const errorCount = messages.filter((message) => message.type.toLowerCase() === \"error\").length;\n  const otherCount = messages.length - errorCount;\n  const sourceText = source ? ` for ${markdownCode(source, 180)}` : \"\";\n  if (messages.length === 0) {\n    return toolContent({\n      title: \"HTML validation\",\n      status: \"clean\",\n      outcome: `The W3C validator returned no HTML diagnostics${sourceText}.`,\n      nextStep: \"Keep this result as a baseline and validate again after the next markup change.\",\n    });\n  }\n\n  return toolContent({\n    title: \"HTML validation\",\n    status: \"attention needed\",\n    outcome: `The W3C validator returned ${countLabel(errorCount, \"error\")} and ${countLabel(otherCount, \"other diagnostic\")}${sourceText}.`,\n    actions: messages.map((message) => ({\n      priority: priorityForSeverity(message.type),\n      message: message.message,\n      location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n    })),\n    nextStep: \"Fix the errors in order, then rerun HTML validation to confirm the markup is clean.\",\n  });\n}\n\nexport function cssValidationContent(messages: CSSMessage[]): string {\n  if (messages.length === 0) {\n    return toolContent({\n      title: \"CSS validation\",\n      status: \"clean\",\n      outcome: \"The W3C validator returned no CSS errors.\",\n      nextStep: \"Validate again after the next stylesheet change.\",\n    });\n  }\n\n  return toolContent({\n    title: \"CSS validation\",\n    status: \"attention needed\",\n    outcome: `The W3C validator returned ${countLabel(messages.length, \"CSS error\")}.`,\n    actions: messages.map((message) => ({\n      priority: 0,\n      message: message.context ? `${message.message} Context: ${message.context}` : message.message,\n      location: formatLocation(message.line),\n    })),\n    nextStep: \"Correct the first errors, then rerun CSS validation because one syntax issue can cause later diagnostics.\",\n  });\n}\n\nexport function seoAuditContent(issues: SEOIssue[], totalIssues: number, truncated: boolean): string {\n  const errors = issues.filter((issue) => issue.severity === \"error\").length;\n  const warnings = issues.filter((issue) => issue.severity === \"warning\").length;\n  const info = issues.filter((issue) => issue.severity === \"info\").length;\n  if (totalIssues === 0) {\n    return toolContent({\n      title: \"SEO audit\",\n      status: \"clean within this audit\",\n      outcome: \"This focused rules-based audit found no SEO or accessibility issues in the supplied HTML.\",\n      nextStep: \"Keep the metadata current and rerun the audit whenever the page template changes.\",\n      note: \"This result does not replace a crawl, performance test, or Search Console review.\",\n    });\n  }\n\n  return toolContent({\n    title: \"SEO audit\",\n    status: \"attention needed\",\n    outcome: `The audit found ${countLabel(errors, \"error\")}, ${countLabel(warnings, \"warning\")}, and ${countLabel(info, \"suggestion\")}.`,\n    actions: issues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: issue.message,\n      location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n    })),\n    nextStep: \"Address errors first, then warnings, and rerun the audit after updating the page.\",\n    note: truncated\n      ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n      : undefined,\n  });\n}\n\nfunction countJsonLdBlocks(htmlContent: string): number {\n  const matches = htmlContent.match(\n    /<script\\b(?=[^>]*\\btype\\s*=\\s*(?:\"application\\/ld\\+json\"|'application\\/ld\\+json'|application\\/ld\\+json\\b))[^>]*>/gi,\n  );\n  return matches?.length ?? 0;\n}\n\nexport function schemaValidationContent(\n  issues: SEOIssue[],\n  totalIssues: number,\n  truncated: boolean,\n  htmlContent: string,\n): string {\n  const blockCount = countJsonLdBlocks(htmlContent);\n  if (blockCount === 0) {\n    return toolContent({\n      title: \"JSON-LD syntax\",\n      status: \"not present\",\n      outcome: \"No JSON-LD script blocks were found, so there was no structured data to parse.\",\n      nextStep: \"Add JSON-LD only when it accurately describes visible page content, then validate it again.\",\n    });\n  }\n  if (totalIssues === 0) {\n    return toolContent({\n      title: \"JSON-LD syntax\",\n      status: \"clean\",\n      outcome: `${countLabel(blockCount, \"JSON-LD block\")} parsed without syntax errors.`,\n      nextStep: \"Verify the properties against the relevant Schema.org type and search-engine requirements.\",\n      note: \"This check covers JSON syntax only; it does not validate vocabulary semantics or rich-result eligibility.\",\n    });\n  }\n\n  return toolContent({\n    title: \"JSON-LD syntax\",\n    status: \"attention needed\",\n    outcome: `${countLabel(totalIssues, \"syntax issue\")} ${totalIssues === 1 ? \"was\" : \"were\"} found across ${countLabel(blockCount, \"JSON-LD block\")}.`,\n    actions: issues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: issue.message,\n    })),\n    nextStep: \"Repair the invalid or empty blocks, then rerun this syntax check before testing rich-result eligibility.\",\n    note: truncated\n      ? `Showing the first ${issues.length} of ${totalIssues} findings in structured output.`\n      : undefined,\n  });\n}\n\nfunction linkPriority(link: LinkStatus): ActionPriority {\n  if (isRedirect(link)) return 1;\n  return 0;\n}\n\nfunction isRedirect(link: LinkStatus): boolean {\n  return typeof link.status === \"number\" && link.status >= 300 && link.status < 400;\n}\n\nfunction linkActionMessage(link: LinkStatus): string {\n  if (isRedirect(link)) {\n    return `${link.status} redirect; destination was not followed`;\n  }\n  return `Link returned ${typeof link.status === \"number\" ? `HTTP ${link.status}` : link.status}${link.message ? ` — ${link.message}` : \"\"}`;\n}\n\nexport function linkCheckContent(links: LinkStatus[], baseUrl?: string): string {\n  if (links.length === 0) {\n    return toolContent({\n      title: \"Link check\",\n      status: \"nothing checked\",\n      outcome: \"No eligible public HTTP(S) links were found, so no link requests were made.\",\n      nextStep: baseUrl\n        ? \"Confirm the HTML contains reachable anchor URLs, then run the check again.\"\n        : \"If the page uses relative links, provide its public base URL and run the check again.\",\n    });\n  }\n\n  const unreachable = links.filter((link) => !link.ok);\n  const redirects = links.filter(isRedirect);\n  if (unreachable.length === 0 && redirects.length === 0) {\n    return toolContent({\n      title: \"Link check\",\n      status: \"clean\",\n      outcome: links.length === 1\n        ? \"The checked link returned a successful response.\"\n        : `All ${links.length} checked links returned a successful response.`,\n      nextStep: \"Recheck periodically because external link availability can change.\",\n    });\n  }\n\n  const actions = [\n    ...unreachable,\n    ...redirects,\n  ].map((link) => ({\n    priority: linkPriority(link),\n    location: link.url,\n    message: linkActionMessage(link),\n  }));\n\n  const linkOutcome = [\n    unreachable.length > 0\n      ? `${countLabel(unreachable.length, \"link\")} ${unreachable.length === 1 ? \"is\" : \"are\"} broken or unreachable`\n      : \"no checked links are broken or unreachable\",\n    redirects.length > 0\n      ? `${countLabel(redirects.length, \"redirect\")} ${redirects.length === 1 ? \"needs\" : \"need\"} review`\n      : undefined,\n  ].filter((item): item is string => item !== undefined).join(\"; \");\n\n  return toolContent({\n    title: \"Link check\",\n    status: unreachable.length > 0 ? \"attention needed\" : \"review suggested\",\n    outcome: `${linkOutcome} of ${links.length} checked. Redirect destinations are not followed.`,\n    actions,\n    nextStep: \"Update failed destinations and review redirects, then rerun the link check.\",\n  });\n}\n\nfunction reportActionItems(reportData: ValidationReportResult): ActionItem[] {\n  return [\n    ...(reportData.errors ?? []).map((message) => ({\n      priority: 0 as const,\n      message,\n    })),\n    ...reportData.htmlMessages.map((message) => ({\n      priority: priorityForSeverity(message.type),\n      message: `HTML: ${message.message}`,\n      location: formatLocation(message.lastLine ?? message.firstLine, message.lastColumn ?? message.firstColumn),\n    })),\n    ...reportData.cssMessages.map((message) => ({\n      priority: 0 as const,\n      message: `CSS: ${message.message}`,\n      location: formatLocation(message.line),\n    })),\n    ...reportData.seoIssues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: `${issue.category}: ${issue.message}`,\n      location: issue.element ? collapseWhitespace(issue.element, 120) : undefined,\n    })),\n    ...reportData.schemaIssues.map((issue) => ({\n      priority: priorityForSeverity(issue.severity),\n      message: `JSON-LD: ${issue.message}`,\n    })),\n    ...reportData.links\n      .filter((link) => !link.ok || isRedirect(link))\n      .map((link) => ({\n        priority: linkPriority(link),\n        message: linkActionMessage(link),\n        location: link.url,\n      })),\n  ];\n}\n\nexport function reportContent(reportData: ValidationReportResult): string {\n  const { summary } = reportData;\n  const actions = reportActionItems(reportData);\n  const partial = reportData.failedChecks.length > 0;\n  const hasActionableFinding = actions.some((action) => action.priority < 2);\n  const status = partial\n    ? \"partial\"\n    : actions.length === 0\n    ? \"clean across completed checks\"\n    : hasActionableFinding\n      ? \"attention needed\"\n      : \"review suggested\";\n  const cssSummary = summary.cssScore === null\n    ? reportData.failedChecks.includes(\"css\")\n      ? \"CSS validation unavailable\"\n      : \"CSS not audited\"\n    : countLabel(summary.cssErrors, \"CSS error\");\n  const redirects = reportData.links.filter(isRedirect).length;\n  const linkSummary = summary.linkScore === null\n    ? reportData.failedChecks.includes(\"links\")\n      ? \"link checking unavailable\"\n      : \"no eligible links checked\"\n    : `${summary.brokenLinks} broken or unreachable and ${countLabel(redirects, \"redirect\")} to review of ${countLabel(summary.linksChecked, \"link\")}`;\n  const checkLabels = {\n    input: \"input file\",\n    html: \"HTML validation\",\n    css: \"CSS validation\",\n    seo: \"SEO analysis\",\n    schema: \"JSON-LD analysis\",\n    links: \"link checking\",\n  } as const;\n  const unavailableChecks = reportData.failedChecks\n    .filter((check) => check !== \"input\")\n    .map((check) => checkLabels[check]);\n  return toolContent({\n    title: \"Validation report\",\n    status,\n    outcome: partial\n      ? `Partial validation report: ${unavailableChecks.join(\", \")} ${unavailableChecks.length === 1 ? \"was\" : \"were\"} unavailable; remaining checks completed. HTML has ${countLabel(summary.htmlErrors, \"error\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`\n      : `The report's heuristic overall score is **${summary.overallScore}/100**. HTML has ${countLabel(summary.htmlErrors, \"error\")} and ${countLabel(summary.htmlWarnings, \"other diagnostic\")}; ${cssSummary}; SEO has ${countLabel(summary.seoErrors, \"error\")} and ${countLabel(summary.seoWarnings, \"warning\")}; JSON-LD has ${countLabel(summary.schemaErrors, \"syntax error\")}; ${linkSummary}.`,\n    actions,\n    nextStep: partial\n      ? \"Review the completed findings, then retry the unavailable checks.\"\n      : actions.length === 0\n      ? \"Use the full Markdown report as the audit record and rerun it after meaningful page changes.\"\n      : \"Work through these priorities, then regenerate the report to compare the heuristic score.\",\n    note: partial\n      ? \"No overall score is shown while one or more checks are unavailable.\"\n      : \"The score is a triage heuristic based on these checks, not a Lighthouse score or a search-ranking prediction.\",\n  });\n}\n\nexport function screenshotCaptureContent(count: number, outputDirectory: string): string {\n  return toolContent({\n    title: \"Screenshot capture\",\n    status: \"complete\",\n    outcome: `Saved ${countLabel(count, \"PNG screenshot\")} to ${markdownCode(outputDirectory)}.`,\n    nextStep: \"Open the PNG files and compare the rendered layouts at each requested viewport.\",\n  });\n}\n\nexport function failureContent(title: string, error: string, nextStep: string): string {\n  return toolContent({\n    title,\n    status: \"could not finish\",\n    outcome: markdownText(error, 500),\n    nextStep,\n  });\n}\n"]}

package/dist/report.d.ts

@@ -0,0 +1,43 @@
+import type { CSSMessage, W3CMessage } from "./w3c-validator.js";
+import type { LinkStatus, SEOIssue } from "./seo-auditor.js";
+export declare const validationReportChecks: readonly ["input", "html", "css", "seo", "schema", "links"];
+export type ValidationReportCheck = (typeof validationReportChecks)[number];
+export interface ValidationReportSummary {
+    overallScore: number | null;
+    htmlScore: number | null;
+    cssScore: number | null;
+    seoScore: number | null;
+    linkScore: number | null;
+    htmlErrors: number;
+    htmlWarnings: number;
+    cssErrors: number;
+    seoErrors: number;
+    seoWarnings: number;
+    schemaErrors: number;
+    linksChecked: number;
+    brokenLinks: number;
+}
+export interface ValidationReport {
+    report: string;
+    summary: ValidationReportSummary;
+    htmlMessages: W3CMessage[];
+    cssMessages: CSSMessage[];
+    seoIssues: SEOIssue[];
+    schemaIssues: SEOIssue[];
+    links: LinkStatus[];
+    failedChecks: ValidationReportCheck[];
+    errors?: string[];
+}
+export interface ValidationReportInput {
+    htmlFilePath: string;
+    cssAudited: boolean;
+    htmlMessages: W3CMessage[];
+    cssMessages: CSSMessage[];
+    seoIssues: SEOIssue[];
+    schemaIssues: SEOIssue[];
+    links: LinkStatus[];
+    failedChecks?: ValidationReportCheck[];
+    errors?: string[];
+}
+/** Builds the human-readable report and its machine-readable equivalent. */
+export declare function createValidationReport(input: ValidationReportInput): ValidationReport;

package/dist/report.js

@@ -0,0 +1,143 @@
+import * as path from "node:path";
+export const validationReportChecks = ["input", "html", "css", "seo", "schema", "links"];
+function clampScore(score) {
+    return Math.max(0, Math.min(100, score));
+}
+function scoreIndicator(score) {
+    if (score === null)
+        return "Unavailable";
+    if (score >= 90)
+        return "🟢";
+    if (score >= 50)
+        return "🟠";
+    return "🔴";
+}
+function markdownCell(value) {
+    return String(value ?? "")
+        .replace(/\\/g, "\\\\")
+        .replace(/\|/g, "\\|")
+        .replace(/`/g, "\\`")
+        .replace(/[\r\n]+/g, " ")
+        .trim();
+}
+function isRedirect(link) {
+    return typeof link.status === "number" && link.status >= 300 && link.status < 400;
+}
+/** Builds the human-readable report and its machine-readable equivalent. */
+export function createValidationReport(input) {
+    const failedChecks = input.failedChecks ?? [];
+    const checkFailed = (check) => failedChecks.includes(check);
+    const htmlErrors = input.htmlMessages.filter((message) => message.type === "error").length;
+    const htmlWarnings = input.htmlMessages.length - htmlErrors;
+    const cssErrors = input.cssMessages.length;
+    const seoErrors = input.seoIssues.filter((issue) => issue.severity === "error").length;
+    const seoWarnings = input.seoIssues.filter((issue) => issue.severity === "warning").length;
+    const schemaErrors = input.schemaIssues.filter((issue) => issue.severity === "error").length;
+    const brokenLinks = input.links.filter((link) => !link.ok).length;
+    const redirectLinks = input.links.filter(isRedirect).length;
+    const htmlScore = checkFailed("html") ? null : clampScore(100 - htmlErrors * 15 - htmlWarnings * 2);
+    const cssScore = checkFailed("css") || !input.cssAudited ? null : clampScore(100 - cssErrors * 20);
+    const seoScore = checkFailed("seo") ? null : clampScore(100 - seoErrors * 15 - seoWarnings * 4 - schemaErrors * 15);
+    const linkScore = checkFailed("links") || input.links.length === 0
+        ? null
+        : clampScore(100 - brokenLinks * 25);
+    const auditedScores = [htmlScore, seoScore, cssScore, linkScore].filter((score) => score !== null);
+    const overallScore = failedChecks.length > 0 || auditedScores.length === 0
+        ? null
+        : Math.round(auditedScores.reduce((total, score) => total + score, 0) / auditedScores.length);
+    const summary = {
+        overallScore,
+        htmlScore,
+        cssScore,
+        seoScore,
+        linkScore,
+        htmlErrors,
+        htmlWarnings,
+        cssErrors,
+        seoErrors,
+        seoWarnings,
+        schemaErrors,
+        linksChecked: input.links.length,
+        brokenLinks,
+    };
+    const report = [
+        `# Web Validation & SEO Audit Report — ${overallScore === null ? "Partial" : `${scoreIndicator(overallScore)} **${overallScore}**/100`}`,
+        `*Generated for: \`${markdownCell(path.basename(input.htmlFilePath))}\`*`,
+        "",
+        "## Page health scores",
+        "",
+        "| Audit | Status | Score |",
+        "| :--- | :---: | :---: |",
+        `| W3C HTML validation | ${htmlScore === null ? "Unavailable" : scoreIndicator(htmlScore)} | ${htmlScore === null ? "N/A" : `**${htmlScore}** / 100`} |`,
+        `| CSS validation | ${cssScore === null ? (checkFailed("css") ? "Unavailable" : "Not audited") : scoreIndicator(cssScore)} | ${cssScore === null ? "N/A" : `**${cssScore}** / 100`} |`,
+        `| SEO and accessibility | ${seoScore === null ? "Unavailable" : scoreIndicator(seoScore)} | ${seoScore === null ? "N/A" : `**${seoScore}** / 100`} |`,
+        `| Link integrity | ${linkScore === null ? (checkFailed("links") ? "Unavailable" : "No links checked") : scoreIndicator(linkScore)} | ${linkScore === null ? "N/A" : `**${linkScore}** / 100`} |`,
+        "",
+        "## Summary",
+        "",
+        `- HTML: ${htmlErrors} error(s), ${htmlWarnings} other diagnostic(s)`,
+        `- CSS: ${input.cssAudited ? `${cssErrors} error(s)` : "not audited"}`,
+        `- SEO and accessibility: ${seoErrors} error(s), ${seoWarnings} warning(s)`,
+        `- JSON-LD syntax: ${schemaErrors} error(s)`,
+        `- Links: ${brokenLinks} broken or unreachable, ${redirectLinks} redirect${redirectLinks === 1 ? "" : "s"} to review of ${input.links.length} checked`,
+        "",
+        `## HTML diagnostics (${input.htmlMessages.length})`,
+    ];
+    if (failedChecks.length > 0) {
+        report.splice(2, 0, "", "## Partial validation report", "The following checks were unavailable: " + failedChecks.join(", ") + ". Remaining checks completed.");
+    }
+    if (input.htmlMessages.length === 0) {
+        report.push("No HTML validation diagnostics were returned.");
+    }
+    else {
+        report.push("", "| Line | Column | Severity | Message | Extract |", "| :---: | :---: | :--- | :--- | :--- |");
+        for (const message of input.htmlMessages) {
+            report.push(`| ${message.lastLine ?? "N/A"} | ${message.lastColumn ?? "N/A"} | ${markdownCell(message.type)} | ${markdownCell(message.message)} | ${markdownCell(message.extract ?? "N/A")} |`);
+        }
+    }
+    if (input.cssAudited) {
+        report.push("", `## CSS diagnostics (${input.cssMessages.length})`);
+        if (input.cssMessages.length === 0) {
+            report.push("No CSS validation errors were returned.");
+        }
+        else {
+            report.push("", "| Line | Context | Message |", "| :---: | :--- | :--- |");
+            for (const message of input.cssMessages) {
+                report.push(`| ${message.line} | ${markdownCell(message.context ?? "N/A")} | ${markdownCell(message.message)} |`);
+            }
+        }
+    }
+    const combinedIssues = [...input.seoIssues, ...input.schemaIssues];
+    report.push("", `## SEO, accessibility, and JSON-LD findings (${combinedIssues.length})`);
+    if (combinedIssues.length === 0) {
+        report.push("No SEO, accessibility, or JSON-LD syntax findings were returned.");
+    }
+    else {
+        report.push("", "| Category | Severity | Message | Element |", "| :--- | :--- | :--- | :--- |");
+        for (const issue of combinedIssues) {
+            report.push(`| ${markdownCell(issue.category)} | ${markdownCell(issue.severity)} | ${markdownCell(issue.message)} | ${markdownCell(issue.element ?? "N/A")} |`);
+        }
+    }
+    report.push("", `## Link health (${input.links.length} checked)`);
+    if (input.links.length === 0) {
+        report.push("No public HTTP(S) links were checked.");
+    }
+    else {
+        report.push("", "| URL | Status | Reachable | Details |", "| :--- | :---: | :---: | :--- |");
+        for (const link of input.links) {
+            report.push(`| ${markdownCell(link.url)} | ${markdownCell(link.status)} | ${link.ok ? "Yes" : "No"} | ${markdownCell(link.message ?? "Accessible")} |`);
+        }
+    }
+    return {
+        report: report.join("\n"),
+        summary,
+        htmlMessages: input.htmlMessages,
+        cssMessages: input.cssMessages,
+        seoIssues: input.seoIssues,
+        schemaIssues: input.schemaIssues,
+        links: input.links,
+        failedChecks,
+        ...(input.errors && input.errors.length > 0 ? { errors: input.errors } : {}),
+    };
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"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","sourcesContent":["import * as path from \"node:path\";\nimport type { CSSMessage, W3CMessage } from \"./w3c-validator.js\";\nimport type { LinkStatus, SEOIssue } from \"./seo-auditor.js\";\n\nexport const validationReportChecks = [\"input\", \"html\", \"css\", \"seo\", \"schema\", \"links\"] as const;\nexport type ValidationReportCheck = (typeof validationReportChecks)[number];\n\nexport interface ValidationReportSummary {\n  overallScore: number | null;\n  htmlScore: number | null;\n  cssScore: number | null;\n  seoScore: number | null;\n  linkScore: number | null;\n  htmlErrors: number;\n  htmlWarnings: number;\n  cssErrors: number;\n  seoErrors: number;\n  seoWarnings: number;\n  schemaErrors: number;\n  linksChecked: number;\n  brokenLinks: number;\n}\n\nexport interface ValidationReport {\n  report: string;\n  summary: ValidationReportSummary;\n  htmlMessages: W3CMessage[];\n  cssMessages: CSSMessage[];\n  seoIssues: SEOIssue[];\n  schemaIssues: SEOIssue[];\n  links: LinkStatus[];\n  failedChecks: ValidationReportCheck[];\n  errors?: string[];\n}\n\nexport interface ValidationReportInput {\n  htmlFilePath: string;\n  cssAudited: boolean;\n  htmlMessages: W3CMessage[];\n  cssMessages: CSSMessage[];\n  seoIssues: SEOIssue[];\n  schemaIssues: SEOIssue[];\n  links: LinkStatus[];\n  failedChecks?: ValidationReportCheck[];\n  errors?: string[];\n}\n\nfunction clampScore(score: number): number {\n  return Math.max(0, Math.min(100, score));\n}\n\nfunction scoreIndicator(score: number | null): string {\n  if (score === null) return \"Unavailable\";\n  if (score >= 90) return \"🟢\";\n  if (score >= 50) return \"🟠\";\n  return \"🔴\";\n}\n\nfunction markdownCell(value: unknown): string {\n  return String(value ?? \"\")\n    .replace(/\\\\/g, \"\\\\\\\\\")\n    .replace(/\\|/g, \"\\\\|\")\n    .replace(/`/g, \"\\\\`\")\n    .replace(/[\\r\\n]+/g, \" \")\n    .trim();\n}\n\nfunction isRedirect(link: LinkStatus): boolean {\n  return typeof link.status === \"number\" && link.status >= 300 && link.status < 400;\n}\n\n/** Builds the human-readable report and its machine-readable equivalent. */\nexport function createValidationReport(input: ValidationReportInput): ValidationReport {\n  const failedChecks = input.failedChecks ?? [];\n  const checkFailed = (check: ValidationReportCheck): boolean => failedChecks.includes(check);\n  const htmlErrors = input.htmlMessages.filter((message) => message.type === \"error\").length;\n  const htmlWarnings = input.htmlMessages.length - htmlErrors;\n  const cssErrors = input.cssMessages.length;\n  const seoErrors = input.seoIssues.filter((issue) => issue.severity === \"error\").length;\n  const seoWarnings = input.seoIssues.filter((issue) => issue.severity === \"warning\").length;\n  const schemaErrors = input.schemaIssues.filter((issue) => issue.severity === \"error\").length;\n  const brokenLinks = input.links.filter((link) => !link.ok).length;\n  const redirectLinks = input.links.filter(isRedirect).length;\n\n  const htmlScore = checkFailed(\"html\") ? null : clampScore(100 - htmlErrors * 15 - htmlWarnings * 2);\n  const cssScore = checkFailed(\"css\") || !input.cssAudited ? null : clampScore(100 - cssErrors * 20);\n  const seoScore = checkFailed(\"seo\") ? null : clampScore(100 - seoErrors * 15 - seoWarnings * 4 - schemaErrors * 15);\n  const linkScore = checkFailed(\"links\") || input.links.length === 0\n    ? null\n    : clampScore(100 - brokenLinks * 25);\n  const auditedScores = [htmlScore, seoScore, cssScore, linkScore].filter(\n    (score): score is number => score !== null,\n  );\n  const overallScore = failedChecks.length > 0 || auditedScores.length === 0\n    ? null\n    : Math.round(auditedScores.reduce((total, score) => total + score, 0) / auditedScores.length);\n\n  const summary: ValidationReportSummary = {\n    overallScore,\n    htmlScore,\n    cssScore,\n    seoScore,\n    linkScore,\n    htmlErrors,\n    htmlWarnings,\n    cssErrors,\n    seoErrors,\n    seoWarnings,\n    schemaErrors,\n    linksChecked: input.links.length,\n    brokenLinks,\n  };\n\n  const report: string[] = [\n    `# Web Validation & SEO Audit Report — ${overallScore === null ? \"Partial\" : `${scoreIndicator(overallScore)} **${overallScore}**/100`}`,\n    `*Generated for: \\`${markdownCell(path.basename(input.htmlFilePath))}\\`*`,\n    \"\",\n    \"## Page health scores\",\n    \"\",\n    \"| Audit | Status | Score |\",\n    \"| :--- | :---: | :---: |\",\n    `| W3C HTML validation | ${htmlScore === null ? \"Unavailable\" : scoreIndicator(htmlScore)} | ${htmlScore === null ? \"N/A\" : `**${htmlScore}** / 100`} |`,\n    `| CSS validation | ${cssScore === null ? (checkFailed(\"css\") ? \"Unavailable\" : \"Not audited\") : scoreIndicator(cssScore)} | ${cssScore === null ? \"N/A\" : `**${cssScore}** / 100`} |`,\n    `| SEO and accessibility | ${seoScore === null ? \"Unavailable\" : scoreIndicator(seoScore)} | ${seoScore === null ? \"N/A\" : `**${seoScore}** / 100`} |`,\n    `| Link integrity | ${linkScore === null ? (checkFailed(\"links\") ? \"Unavailable\" : \"No links checked\") : scoreIndicator(linkScore)} | ${linkScore === null ? \"N/A\" : `**${linkScore}** / 100`} |`,\n    \"\",\n    \"## Summary\",\n    \"\",\n    `- HTML: ${htmlErrors} error(s), ${htmlWarnings} other diagnostic(s)` ,\n    `- CSS: ${input.cssAudited ? `${cssErrors} error(s)` : \"not audited\"}`,\n    `- SEO and accessibility: ${seoErrors} error(s), ${seoWarnings} warning(s)`,\n    `- JSON-LD syntax: ${schemaErrors} error(s)`,\n    `- Links: ${brokenLinks} broken or unreachable, ${redirectLinks} redirect${redirectLinks === 1 ? \"\" : \"s\"} to review of ${input.links.length} checked`,\n    \"\",\n    `## HTML diagnostics (${input.htmlMessages.length})`,\n  ];\n\n  if (failedChecks.length > 0) {\n    report.splice(2, 0, \"\", \"## Partial validation report\", \"The following checks were unavailable: \" + failedChecks.join(\", \") + \". Remaining checks completed.\");\n  }\n\n  if (input.htmlMessages.length === 0) {\n    report.push(\"No HTML validation diagnostics were returned.\");\n  } else {\n    report.push(\"\", \"| Line | Column | Severity | Message | Extract |\", \"| :---: | :---: | :--- | :--- | :--- |\");\n    for (const message of input.htmlMessages) {\n      report.push(\n        `| ${message.lastLine ?? \"N/A\"} | ${message.lastColumn ?? \"N/A\"} | ${markdownCell(message.type)} | ${markdownCell(message.message)} | ${markdownCell(message.extract ?? \"N/A\")} |`,\n      );\n    }\n  }\n\n  if (input.cssAudited) {\n    report.push(\"\", `## CSS diagnostics (${input.cssMessages.length})`);\n    if (input.cssMessages.length === 0) {\n      report.push(\"No CSS validation errors were returned.\");\n    } else {\n      report.push(\"\", \"| Line | Context | Message |\", \"| :---: | :--- | :--- |\");\n      for (const message of input.cssMessages) {\n        report.push(\n          `| ${message.line} | ${markdownCell(message.context ?? \"N/A\")} | ${markdownCell(message.message)} |`,\n        );\n      }\n    }\n  }\n\n  const combinedIssues = [...input.seoIssues, ...input.schemaIssues];\n  report.push(\"\", `## SEO, accessibility, and JSON-LD findings (${combinedIssues.length})`);\n  if (combinedIssues.length === 0) {\n    report.push(\"No SEO, accessibility, or JSON-LD syntax findings were returned.\");\n  } else {\n    report.push(\"\", \"| Category | Severity | Message | Element |\", \"| :--- | :--- | :--- | :--- |\");\n    for (const issue of combinedIssues) {\n      report.push(\n        `| ${markdownCell(issue.category)} | ${markdownCell(issue.severity)} | ${markdownCell(issue.message)} | ${markdownCell(issue.element ?? \"N/A\")} |`,\n      );\n    }\n  }\n\n  report.push(\"\", `## Link health (${input.links.length} checked)`);\n  if (input.links.length === 0) {\n    report.push(\"No public HTTP(S) links were checked.\");\n  } else {\n    report.push(\"\", \"| URL | Status | Reachable | Details |\", \"| :--- | :---: | :---: | :--- |\");\n    for (const link of input.links) {\n      report.push(\n        `| ${markdownCell(link.url)} | ${markdownCell(link.status)} | ${link.ok ? \"Yes\" : \"No\"} | ${markdownCell(link.message ?? \"Accessible\")} |`,\n      );\n    }\n  }\n\n  return {\n    report: report.join(\"\\n\"),\n    summary,\n    htmlMessages: input.htmlMessages,\n    cssMessages: input.cssMessages,\n    seoIssues: input.seoIssues,\n    schemaIssues: input.schemaIssues,\n    links: input.links,\n    failedChecks,\n    ...(input.errors && input.errors.length > 0 ? { errors: input.errors } : {}),\n  };\n}\n"]}

package/dist/screenshot.d.ts

@@ -9,6 +9,7 @@ export interface ScreenshotResult {
     height: number;
     outputPath: string;
 }
+export declare const SCREENSHOT_HEADLESS_MODE: "shell";
 /**
  * Captures screenshots of a local HTML file or remote URL at different viewport sizes.
  * @param targetPath Local file path or HTTP(S) URL