@staticforge/checker 0.0.0-stage → 0.1.0

package/dist/report/pretty.js

@@ -0,0 +1,92 @@
+const ANSI = {
+    error: '\x1b[31m',
+    warning: '\x1b[33m',
+    info: '\x1b[36m',
+    dim: '\x1b[90m',
+    reset: '\x1b[0m',
+};
+const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`;
+/**
+ * Human-readable report, grouped by file. A problem that appears at the same
+ * place on several pages (usually the theme) is listed once, with its pages.
+ */
+export function formatPretty(result, options = {}) {
+    const paint = (key, text) => options.color ? `${ANSI[key]}${text}${ANSI.reset}` : text;
+    // Output and rendered findings have no line; group the identical ones across pages.
+    const repeated = new Map();
+    for (const d of result.diagnostics) {
+        if (d.line !== undefined)
+            continue;
+        const key = [d.ruleId, d.severity, d.message, d.selector ?? ''].join('\u0000');
+        repeated.set(key, [...(repeated.get(key) ?? []), d]);
+    }
+    const shared = [...repeated.values()].filter((group) => group.length > 1);
+    const sharedSet = new Set(shared.flat());
+    const byFile = new Map();
+    for (const d of result.diagnostics) {
+        if (sharedSet.has(d))
+            continue;
+        const key = d.file ?? d.url ?? '(site)';
+        byFile.set(key, [...(byFile.get(key) ?? []), d]);
+    }
+    const line = (d, location) => {
+        const wcag = d.wcag !== undefined ? paint('dim', ` WCAG ${d.wcag}`) : '';
+        const fixable = d.fixable ? paint('dim', ' (fixable)') : '';
+        const out = [
+            `  ${location.padEnd(7)} ${paint(d.severity, d.severity.padEnd(7))} ${d.message}${wcag}${fixable}  ${paint('dim', d.ruleId)}`,
+        ];
+        const where = [
+            d.file !== undefined && d.url !== undefined && d.line === undefined
+                ? `on ${d.url}`
+                : undefined,
+            d.selector !== undefined ? `at ${d.selector}` : undefined,
+        ].filter((s) => s !== undefined);
+        if (where.length > 0)
+            out.push(paint('dim', `          ${where.join(' ')}`));
+        if (d.hint !== undefined)
+            out.push(paint('dim', `          ${d.hint}`));
+        return out;
+    };
+    const lines = [];
+    for (const [file, diagnostics] of byFile) {
+        lines.push(file);
+        for (const d of diagnostics) {
+            lines.push(...line(d, d.line !== undefined ? `${d.line}:${d.column ?? 1}` : ''));
+        }
+        lines.push('');
+    }
+    if (shared.length > 0) {
+        lines.push('On several pages (likely the theme or a shared template)');
+        for (const group of shared) {
+            const first = group[0];
+            const urls = group.map((d) => d.url ?? d.file ?? '?');
+            const shown = urls.slice(0, 3).join(', ') + (urls.length > 3 ? `, +${urls.length - 3} more` : '');
+            lines.push(...line({ ...first, url: undefined, file: undefined }, ''));
+            lines.push(paint('dim', `          on ${plural(group.length, 'page')}: ${shown}`));
+        }
+        lines.push('');
+    }
+    const { error, warning, info } = result.summary;
+    const fixable = result.diagnostics.filter((d) => d.fixable).length;
+    const rendered = result.rendered === 'ran'
+        ? 'with rendered checks'
+        : result.rendered === 'skipped'
+            ? 'rendered checks skipped'
+            : 'static checks only';
+    const mark = result.ok ? paint('info', '✔') : paint('error', '✖');
+    let summary = `${mark} ${plural(error, 'error')}, ${plural(warning, 'warning')}, ${info} info ` +
+        `in ${plural(result.pages, 'page')} (${rendered}, ${result.durationMs}ms)`;
+    if (fixable > 0 && result.fixes === undefined) {
+        summary += `\n  ${plural(fixable, 'problem')} can be fixed with \`sforge check --fix\``;
+    }
+    if (result.fixes !== undefined) {
+        const files = result.fixes.files;
+        const edits = files.reduce((n, f) => n + f.edits, 0);
+        summary += result.fixes.applied
+            ? `\n  Fixed ${plural(edits, 'problem')} in ${plural(files.length, 'file')}: ${files.map((f) => f.file).join(', ') || 'none'}`
+            : `\n  Would fix ${plural(edits, 'problem')} in ${plural(files.length, 'file')} (dry run)`;
+    }
+    lines.push(summary);
+    return lines.join('\n');
+}
+//# sourceMappingURL=pretty.js.map

package/dist/report/pretty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pretty.js","sourceRoot":"","sources":["../../src/report/pretty.ts"],"names":[],"mappings":"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"}

package/dist/report/sarif.d.ts

@@ -0,0 +1,14 @@
+import type { CheckResult } from '../check.js';
+export interface SarifOptions {
+    toolVersion: string;
+    /**
+     * Prefix for file URIs, so they are relative to the repository root as
+     * GitHub code scanning expects (e.g. "site/" when the project is in site/).
+     */
+    uriPrefix?: string;
+    /** Location for problems without a source file, e.g. the generated 404 page. */
+    fallbackFile: string;
+}
+/** SARIF 2.1.0 log for GitHub code scanning and other SARIF viewers. */
+export declare function formatSarif(result: CheckResult, options: SarifOptions): Record<string, unknown>;
+//# sourceMappingURL=sarif.d.ts.map

package/dist/report/sarif.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.d.ts","sourceRoot":"","sources":["../../src/report/sarif.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4D/F"}

package/dist/report/sarif.js

@@ -0,0 +1,65 @@
+import { createHash } from 'node:crypto';
+const LEVEL = { error: 'error', warning: 'warning', info: 'note' };
+/** SARIF 2.1.0 log for GitHub code scanning and other SARIF viewers. */
+export function formatSarif(result, options) {
+    const prefix = options.uriPrefix ?? '';
+    const rules = new Map();
+    for (const d of result.diagnostics) {
+        if (!rules.has(d.ruleId))
+            rules.set(d.ruleId, { index: rules.size, diagnostic: d });
+    }
+    return {
+        $schema: 'https://json.schemastore.org/sarif-2.1.0.json',
+        version: '2.1.0',
+        runs: [
+            {
+                tool: {
+                    driver: {
+                        name: 'staticforge',
+                        version: options.toolVersion,
+                        rules: [...rules].map(([id, { diagnostic: d }]) => ({
+                            id,
+                            shortDescription: { text: id },
+                            ...(d.helpUrl !== undefined && { helpUri: d.helpUrl }),
+                            properties: {
+                                tags: ['accessibility', ...(d.wcag !== undefined ? [`WCAG ${d.wcag}`] : [])],
+                            },
+                        })),
+                    },
+                },
+                results: result.diagnostics.map((d) => {
+                    const where = [
+                        d.url !== undefined ? `on ${d.url}` : undefined,
+                        d.selector !== undefined ? `at ${d.selector}` : undefined,
+                    ].filter((s) => s !== undefined);
+                    const text = [
+                        d.message + (where.length > 0 ? ` (${where.join(' ')})` : ''),
+                        d.hint,
+                    ].filter((s) => s !== undefined);
+                    const fingerprint = createHash('sha256')
+                        .update([d.ruleId, d.file, d.url, d.selector, d.message].join('\u0000'))
+                        .digest('hex');
+                    return {
+                        ruleId: d.ruleId,
+                        ruleIndex: rules.get(d.ruleId)?.index ?? 0,
+                        level: LEVEL[d.severity],
+                        message: { text: text.join('\n') },
+                        locations: [
+                            {
+                                physicalLocation: {
+                                    artifactLocation: { uri: prefix + (d.file ?? options.fallbackFile) },
+                                    region: {
+                                        startLine: d.line ?? 1,
+                                        ...(d.column !== undefined && { startColumn: d.column }),
+                                    },
+                                },
+                            },
+                        ],
+                        partialFingerprints: { 'staticforge/v1': fingerprint },
+                    };
+                }),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=sarif.js.map

package/dist/report/sarif.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sarif.js","sourceRoot":"","sources":["../../src/report/sarif.ts"],"names":[],"mappings":"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"}

package/dist/report/schema.d.ts

@@ -0,0 +1,3 @@
+/** JSON Schema of `sforge check --json` data (and of a single diagnostic, under $defs). */
+export declare function checkReportJsonSchema(): Record<string, unknown>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/report/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/report/schema.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqD/D"}

package/dist/report/schema.js

@@ -0,0 +1,57 @@
+import { diagnosticJsonSchema } from '@staticforge/core';
+/** JSON Schema of `sforge check --json` data (and of a single diagnostic, under $defs). */
+export function checkReportJsonSchema() {
+    return {
+        $schema: 'https://json-schema.org/draft/2020-12/schema',
+        $id: 'urn:staticforge:schema:diagnostics:v1',
+        title: 'staticforge check report',
+        type: 'object',
+        required: ['ok', 'failOn', 'pages', 'rendered', 'diagnostics', 'summary', 'durationMs'],
+        additionalProperties: false,
+        properties: {
+            ok: { type: 'boolean', description: 'No diagnostics at or above failOn.' },
+            failOn: { enum: ['error', 'warning'] },
+            pages: { type: 'integer', minimum: 0, description: 'Built pages checked.' },
+            rendered: {
+                enum: ['ran', 'skipped', 'off'],
+                description: 'Whether headless (axe-core) checks ran; skipped when Chromium is missing.',
+            },
+            diagnostics: { type: 'array', items: { $ref: '#/$defs/diagnostic' } },
+            summary: {
+                type: 'object',
+                required: ['error', 'warning', 'info'],
+                additionalProperties: false,
+                properties: {
+                    error: { type: 'integer', minimum: 0 },
+                    warning: { type: 'integer', minimum: 0 },
+                    info: { type: 'integer', minimum: 0 },
+                },
+            },
+            fixes: {
+                type: 'object',
+                required: ['applied', 'files', 'diff'],
+                additionalProperties: false,
+                properties: {
+                    applied: { type: 'boolean', description: 'False for --dry-run.' },
+                    files: {
+                        type: 'array',
+                        items: {
+                            type: 'object',
+                            required: ['file', 'ruleIds', 'edits'],
+                            additionalProperties: false,
+                            properties: {
+                                file: { type: 'string' },
+                                ruleIds: { type: 'array', items: { type: 'string' } },
+                                edits: { type: 'integer', minimum: 0 },
+                            },
+                        },
+                    },
+                    diff: { type: 'string', description: 'Unified diff of the fixes.' },
+                },
+            },
+            durationMs: { type: 'integer', minimum: 0 },
+        },
+        $defs: { diagnostic: diagnosticJsonSchema() },
+    };
+}
+//# sourceMappingURL=schema.js.map

package/dist/report/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/report/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD,2FAA2F;AAC3F,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,OAAO,EAAE,8CAA8C;QACvD,GAAG,EAAE,uCAAuC;QAC5C,KAAK,EAAE,0BAA0B;QACjC,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,CAAC;QACvF,oBAAoB,EAAE,KAAK;QAC3B,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,oCAAoC,EAAE;YAC1E,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE;YACtC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,sBAAsB,EAAE;YAC3E,QAAQ,EAAE;gBACR,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC;gBAC/B,WAAW,EAAE,2EAA2E;aACzF;YACD,WAAW,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,EAAE;YACrE,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;gBACtC,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;oBACtC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;oBACxC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;iBACtC;aACF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC;gBACtC,oBAAoB,EAAE,KAAK;gBAC3B,UAAU,EAAE;oBACV,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,sBAAsB,EAAE;oBACjE,KAAK,EAAE;wBACL,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;4BACtC,oBAAoB,EAAE,KAAK;4BAC3B,UAAU,EAAE;gCACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gCACxB,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE;gCACrD,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;6BACvC;yBACF;qBACF;oBACD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;iBACpE;aACF;YACD,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE;SAC5C;QACD,KAAK,EAAE,EAAE,UAAU,EAAE,oBAAoB,EAAE,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/dist/source-rules.d.ts

@@ -0,0 +1,24 @@
+import { type PreparedSource } from '@staticforge/content';
+import type { CheckPage, Finding } from './types.js';
+export interface SourceContext {
+    page: CheckPage & {
+        source: string;
+    };
+    /** The source file as on disk. */
+    text: string;
+    prepared: PreparedSource;
+    /** Site language, for `lang` fixes. */
+    language: string;
+    /** Page URL by project-relative source path. */
+    pageUrls: ReadonlyMap<string, string>;
+    trailingSlash: 'always' | 'never';
+}
+/**
+ * Source rules re-parse the author's file, so their findings point at exact
+ * lines and can carry fixes. They only report what they can locate; the
+ * output rules cover everything else (including theme templates).
+ */
+export declare function checkSource(ctx: SourceContext): Finding[];
+/** Page URL by project-relative source path, as the build assigned them. */
+export declare function pageUrlMap(pages: CheckPage[]): Map<string, string>;
+//# sourceMappingURL=source-rules.d.ts.map

package/dist/source-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-rules.d.ts","sourceRoot":"","sources":["../src/source-rules.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,sBAAsB,CAAC;AAG1E,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,aAAa,EAAE,QAAQ,GAAG,OAAO,CAAC;CACnC;AAoBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,EAAE,CA0DzD;AA4SD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMlE"}

package/dist/source-rules.js

@@ -0,0 +1,327 @@
+import { posix } from 'node:path';
+import { fromHtml } from 'hast-util-from-html';
+import { toString as hastToString } from 'hast-util-to-string';
+import remarkGfm from 'remark-gfm';
+import remarkParse from 'remark-parse';
+import { unified } from 'unified';
+import { visit } from 'unist-util-visit';
+import { createRefResolver } from '@staticforge/build';
+import { titleFromPath } from '@staticforge/content';
+import { LineIndex, escapeHtml } from './text.js';
+const markdownParser = unified().use(remarkParse).use(remarkGfm);
+const verbose = (node) => node.data?.position;
+/**
+ * Source rules re-parse the author's file, so their findings point at exact
+ * lines and can carry fixes. They only report what they can locate; the
+ * output rules cover everything else (including theme templates).
+ */
+export function checkSource(ctx) {
+    const { prepared, text } = ctx;
+    const body = prepared.body;
+    const bodyIndex = new LineIndex(body);
+    const fileIndex = new LineIndex(text);
+    // Front-matter is blanked line for line, so body and file share line
+    // numbers; only a stripped BOM shifts the first line.
+    const bom = text.startsWith('') && !body.startsWith('') ? 1 : 0;
+    const toFile = (offset) => {
+        const point = bodyIndex.point(offset);
+        return fileIndex.offset(point) + (point.line === 1 ? bom : 0);
+    };
+    const findings = [];
+    const report = (diagnostic, at, edits, match) => {
+        const point = fileIndex.point(toFile(at));
+        findings.push({
+            layer: 'source',
+            diagnostic: {
+                ...diagnostic,
+                file: ctx.page.source,
+                line: point.line,
+                column: point.column,
+                url: ctx.page.url,
+                fixable: edits !== undefined,
+            },
+            ...(edits && {
+                edits: edits.map((e) => ({ start: toFile(e.start), end: toFile(e.end), text: e.text })),
+            }),
+            ...(match !== undefined && { match }),
+        });
+    };
+    const elements = [];
+    let mdast;
+    if (prepared.format === 'markdown') {
+        mdast = markdownParser.parse(body);
+        visit(mdast, 'html', (node) => {
+            const base = node.position?.start.offset;
+            if (base === undefined)
+                return;
+            collectElements(fromHtml(node.value, { fragment: true, verbose: true }), base, elements);
+        });
+    }
+    else {
+        const tree = fromHtml(body, { fragment: ctx.page.kind !== 'document', verbose: true });
+        collectElements(tree, 0, elements);
+        if (ctx.page.kind === 'document') {
+            checkHtmlLang(elements, ctx, report);
+            checkDocumentTitle(elements, ctx, bodyIndex, report);
+        }
+    }
+    if (mdast !== undefined)
+        checkMarkdownHeadings(mdast, body, prepared, report);
+    checkTrailingSlashLinks(mdast, elements, body, ctx, report);
+    return findings;
+}
+function collectElements(tree, base, into) {
+    visit(tree, 'element', (node) => {
+        into.push({ node, base });
+    });
+}
+const openingOf = (el) => {
+    const opening = verbose(el.node)?.opening;
+    if (opening?.start.offset === undefined || opening.end.offset === undefined)
+        return undefined;
+    return { start: el.base + opening.start.offset, end: el.base + opening.end.offset };
+};
+const explicit = (elements, tagName) => elements.find((el) => el.node.tagName === tagName && openingOf(el) !== undefined);
+function checkHtmlLang(elements, ctx, report) {
+    const html = explicit(elements, 'html');
+    if (html === undefined)
+        return;
+    const lang = html.node.properties.lang;
+    if (typeof lang === 'string' && lang.trim() !== '')
+        return;
+    const opening = openingOf(html);
+    if (opening === undefined)
+        return;
+    const attribute = verbose(html.node)?.properties?.lang;
+    const replacement = `lang="${escapeHtml(ctx.language)}"`;
+    const edit = attribute?.start.offset !== undefined && attribute.end.offset !== undefined
+        ? {
+            start: html.base + attribute.start.offset,
+            end: html.base + attribute.end.offset,
+            text: replacement,
+        }
+        : {
+            start: opening.start + '<html'.length,
+            end: opening.start + '<html'.length,
+            text: ` ${replacement}`,
+        };
+    report({
+        ruleId: 'html-lang',
+        severity: 'error',
+        wcag: '3.1.1',
+        message: 'The <html> element has no lang attribute',
+        hint: `Add ${replacement} so assistive technology uses the right language.`,
+    }, opening.start, [edit]);
+}
+function checkDocumentTitle(elements, ctx, index, report) {
+    const title = elements.find((el) => el.node.tagName === 'title');
+    if (title !== undefined && hastToString(title.node).trim() !== '')
+        return;
+    const h1 = elements.find((el) => el.node.tagName === 'h1');
+    const h1Text = h1 === undefined ? '' : hastToString(h1.node).replace(/\s+/g, ' ').trim();
+    const text = escapeHtml(h1Text === '' ? titleFromPath(ctx.page.source) : h1Text);
+    const diagnostic = {
+        ruleId: 'document-title',
+        severity: 'error',
+        wcag: '2.4.2',
+        message: title === undefined ? 'Page has no <title>' : 'Page has an empty <title>',
+        hint: 'Give every page a <title> that describes its topic or purpose.',
+    };
+    const titlePosition = title === undefined ? undefined : verbose(title.node);
+    if (title !== undefined) {
+        const start = titlePosition?.opening?.end.offset;
+        const end = titlePosition?.closing?.start.offset;
+        const opening = openingOf(title);
+        if (opening === undefined)
+            return;
+        report(diagnostic, opening.start, start === undefined || end === undefined
+            ? undefined
+            : [{ start: title.base + start, end: title.base + end, text }]);
+        return;
+    }
+    // Insert at the top of <head>, or straight after <html> when <head> is implied.
+    const parent = explicit(elements, 'head') ?? explicit(elements, 'html');
+    const opening = parent === undefined ? undefined : openingOf(parent);
+    if (opening === undefined) {
+        report(diagnostic, 0, undefined);
+        return;
+    }
+    // After leading <meta> elements: the charset declaration must come first.
+    let at = opening.end;
+    let indent = `${index.indentAt(opening.start)}  `;
+    if (parent?.node.tagName === 'head') {
+        for (const child of parent.node.children) {
+            if (child.type === 'text' && child.value.trim() === '')
+                continue;
+            if (child.type !== 'element' || child.tagName !== 'meta')
+                break;
+            const meta = openingOf({ node: child, base: parent.base });
+            if (meta === undefined)
+                break;
+            at = meta.end;
+            indent = index.indentAt(meta.start);
+        }
+    }
+    report(diagnostic, opening.start, [
+        { start: at, end: at, text: `\n${indent}<title>${text}</title>` },
+    ]);
+}
+/**
+ * Mirror the build: a leading `# Title` becomes the layout's <h1>, and other
+ * `#` headings are demoted. Then no heading may skip a level below its
+ * predecessor. ATX headings (`###`) are fixed by changing the `#` count.
+ */
+function checkMarkdownHeadings(tree, body, prepared, report) {
+    const headings = [];
+    visit(tree, 'heading', (node) => {
+        headings.push(node);
+    });
+    if (headings.length === 0)
+        return;
+    const normalize = (s) => s.replace(/\s+/g, ' ').trim();
+    const first = headings[0];
+    const metaTitle = prepared.meta.title;
+    const rest = first?.depth === 1 &&
+        (metaTitle === undefined || normalize(metaTitle) === normalize(mdText(first)))
+        ? headings.slice(1)
+        : headings;
+    const shift = rest.some((h) => h.depth === 1) ? 1 : 0;
+    let previous = 1;
+    for (const heading of rest) {
+        const depth = Math.min(heading.depth + shift, 6);
+        if (depth <= previous + 1) {
+            previous = depth;
+            continue;
+        }
+        const target = previous + 1;
+        const start = heading.position?.start.offset;
+        if (start === undefined)
+            continue;
+        const hashes = /^ {0,3}(#{1,6})(?=[ \t]|$)/.exec(body.slice(start));
+        const marker = hashes?.[1];
+        const edits = marker === undefined
+            ? undefined
+            : [
+                {
+                    start: start + (hashes?.[0].length ?? 0) - marker.length,
+                    end: start + (hashes?.[0].length ?? 0),
+                    text: '#'.repeat(target - shift),
+                },
+            ];
+        report({
+            ruleId: 'heading-order',
+            severity: 'warning',
+            wcag: '1.3.1',
+            message: `Heading level skips from h${previous} to h${depth}`,
+            hint: `Use an h${target} here (${'#'.repeat(target - shift)}), so the outline has no gaps.`,
+        }, start, edits);
+        previous = target;
+    }
+}
+const mdText = (node) => {
+    if ('value' in node && typeof node.value === 'string')
+        return node.value;
+    if ('children' in node)
+        return node.children.map(mdText).join('');
+    return '';
+};
+const EXTERNAL = /^(?:[a-z][a-z\d+.-]*:|\/\/|#)/i;
+/**
+ * Links that resolve to a page except for the trailing slash cost a redirect
+ * on every click (`/about` → 301 `/about/`). Rewrite them to the canonical URL.
+ */
+function checkTrailingSlashLinks(mdast, elements, body, ctx, report) {
+    const refs = [];
+    if (mdast !== undefined) {
+        visit(mdast, (node) => {
+            if (node.type !== 'link' && node.type !== 'definition')
+                return;
+            const { url, position } = node;
+            const start = position?.start.offset;
+            const end = position?.end.offset;
+            if (start === undefined || end === undefined)
+                return;
+            // The URL follows the link text (or the definition label).
+            const after = node.type === 'link'
+                ? (node.children.at(-1)?.position?.end.offset ?? start)
+                : start + body.slice(start, end).indexOf(']:');
+            const found = body.indexOf(url, after);
+            refs.push({
+                value: url,
+                range: found !== -1 && found + url.length <= end
+                    ? { start: found, end: found + url.length }
+                    : undefined,
+                at: start,
+            });
+        });
+    }
+    for (const el of elements) {
+        const href = el.node.properties.href;
+        if (el.node.tagName !== 'a' || typeof href !== 'string')
+            continue;
+        const attribute = verbose(el.node)?.properties?.href;
+        const start = attribute?.start.offset;
+        const end = attribute?.end.offset;
+        const opening = openingOf(el);
+        if (opening === undefined)
+            continue;
+        let range;
+        if (start !== undefined && end !== undefined) {
+            const raw = body.slice(el.base + start, el.base + end);
+            const at = raw.indexOf(href, raw.indexOf('=') + 1);
+            if (at !== -1)
+                range = { start: el.base + start + at, end: el.base + start + at + href.length };
+        }
+        refs.push({ value: href, range, at: opening.start });
+    }
+    if (refs.length === 0)
+        return;
+    const resolve = createRefResolver({
+        sourcePath: ctx.page.source,
+        pageUrls: ctx.pageUrls,
+        report: () => undefined,
+    });
+    const urls = new Set(ctx.pageUrls.values());
+    const placeholder = { type: 'element', tagName: 'a', properties: {}, children: [] };
+    for (const ref of refs) {
+        if (ref.value === '' || EXTERNAL.test(ref.value))
+            continue;
+        const [, path = '', suffix = ''] = /^([^?#]*)(.*)$/s.exec(ref.value) ?? [];
+        if (path === '' || /\.(?:md|markdown)$/i.test(path))
+            continue;
+        const pathname = (value) => new URL(resolve(value, placeholder) ?? value, `http://site.invalid${ctx.page.url}`).pathname;
+        const current = pathname(path);
+        if (urls.has(current) || current === '/')
+            continue;
+        let fixed;
+        if (ctx.trailingSlash === 'always' && !current.endsWith('/') && urls.has(`${current}/`)) {
+            fixed = `${path}/`;
+        }
+        else if (ctx.trailingSlash === 'never' &&
+            current.endsWith('/') &&
+            urls.has(current.slice(0, -1)) &&
+            path.endsWith('/')) {
+            fixed = path.slice(0, -1);
+        }
+        if (fixed === undefined)
+            continue;
+        report({
+            ruleId: 'link-trailing-slash',
+            severity: 'warning',
+            message: `Link to ${ref.value} redirects to ${pathname(fixed)}${suffix}`,
+            hint: "Link to the page's canonical URL to save a redirect.",
+        }, ref.at, ref.range === undefined
+            ? undefined
+            : [{ start: ref.range.start, end: ref.range.end, text: fixed + suffix }], current);
+    }
+}
+/** Page URL by project-relative source path, as the build assigned them. */
+export function pageUrlMap(pages) {
+    const map = new Map();
+    for (const page of pages) {
+        if (page.source !== undefined)
+            map.set(posix.normalize(page.source), page.url);
+    }
+    return map;
+}
+//# sourceMappingURL=source-rules.js.map