@redocly/recheck 0.14.0 → 2.58.0

package/examples/appendices/google.appendix.yaml

@@ -2,7 +2,7 @@
 # Appendix — candidates NOT shipped by recheck/google (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/google.yaml stale until you regenerate — the drift test's
 # failure message says so, so this doesn't read as a generator bug.
 #

package/examples/appendices/inclusive-language.appendix.yaml

@@ -2,7 +2,7 @@
 # Appendix — candidates NOT shipped by recheck/inclusive-language (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/inclusive-language.yaml stale until you regenerate — the
 # drift test's failure message says so, so this doesn't read as a generator bug.
 #

package/examples/appendices/microsoft.appendix.yaml

@@ -2,7 +2,7 @@
 # Appendix — candidates NOT shipped by recheck/microsoft (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/microsoft.yaml stale until you regenerate — the drift
 # test's failure message says so, so this doesn't read as a generator bug.
 #

package/examples/appendices/plain-language.appendix.yaml

@@ -2,7 +2,7 @@
 # Appendix — candidates NOT shipped by recheck/plain-language (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/plain-language.yaml stale until you regenerate — the drift
 # test's failure message says so, so this doesn't read as a generator bug.
 #

package/examples/appendices/technical-english.appendix.yaml

@@ -2,7 +2,7 @@
 # Appendix — candidates NOT shipped by recheck/technical-english (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs).
+# `node scripts/generate-examples.mjs`.
 #
 # Full detail and reasons: packages/recheck/presets/technical-english/PROVENANCE.md
 #

package/examples/google.yaml

@@ -13,7 +13,7 @@
 # capitalization, length); wording is paraphrased in each rule's `message`,
 # never quoted verbatim from the guide.
 #
-# Generated file — do not hand-edit. Regenerate with `pnpm examples:generate`
+# Generated file — do not hand-edit. Regenerate with `node scripts/generate-examples.mjs`
 # after changing src/config/presets/google.ts or this file's appendix
 # (examples/appendices/google.appendix.yaml).
 
@@ -101,11 +101,11 @@ extends:
 # Full expansion (reference)
 # ------------------------------------------------------------------------------
 # This is what `extends: [recheck/google]` resolves to today: all 99 rules,
-# alphabetized by rule id, generated straight from the live preset (`pnpm
-# examples:generate`). You do not need to copy any of it — the extends
-# block above already gives you all of this. Read it to see exactly what
-# you are adopting, or as a starting point if you would rather pin or fork
-# specific rules into your own config instead of extending the preset.
+# alphabetized by rule id, generated straight from the live preset (`node
+# scripts/generate-examples.mjs`). You do not need to copy any of it — the
+# extends block above already gives you all of this. Read it to see exactly
+# what you are adopting, or as a starting point if you would rather pin or
+# fork specific rules into your own config instead of extending the preset.
 #
 # `fix: false` on every rule below means what it says: detection-only, no
 # exceptions — see "How to tune it" above and PROVENANCE.md for why.
@@ -1436,7 +1436,7 @@ google/vs-versus:
 # Appendix — candidates NOT shipped by recheck/google (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/google.yaml stale until you regenerate — the drift test's
 # failure message says so, so this doesn't read as a generator bug.
 #

package/examples/inclusive-language.yaml

@@ -14,7 +14,7 @@
 #             verification reports; see PROVENANCE.md)
 # Provenance: packages/recheck/presets/inclusive-language/PROVENANCE.md
 #
-# Generated file — do not hand-edit. Regenerate with `pnpm examples:generate`
+# Generated file — do not hand-edit. Regenerate with `node scripts/generate-examples.mjs`
 # after changing src/config/presets/inclusive-language.ts or this file's
 # appendix (examples/appendices/inclusive-language.appendix.yaml).
 
@@ -96,11 +96,11 @@ extends:
 # Full expansion (reference)
 # ------------------------------------------------------------------------------
 # This is what `extends: [recheck/inclusive-language]` resolves to today: all 11 rules,
-# alphabetized by rule id, generated straight from the live preset (`pnpm
-# examples:generate`). You do not need to copy any of it — the extends
-# block above already gives you all of this. Read it to see exactly what
-# you are adopting, or as a starting point if you would rather pin or fork
-# specific rules into your own config instead of extending the preset.
+# alphabetized by rule id, generated straight from the live preset (`node
+# scripts/generate-examples.mjs`). You do not need to copy any of it — the
+# extends block above already gives you all of this. Read it to see exactly
+# what you are adopting, or as a starting point if you would rather pin or
+# fork specific rules into your own config instead of extending the preset.
 #
 # `fix: false` on every rule below means what it says: detection-only, no
 # exceptions — see "How to tune it" above and PROVENANCE.md for why.
@@ -245,7 +245,7 @@ inclusive-language/suffering-victim:
 # Appendix — candidates NOT shipped by recheck/inclusive-language (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/inclusive-language.yaml stale until you regenerate — the
 # drift test's failure message says so, so this doesn't read as a generator bug.
 #

package/examples/microsoft.yaml

@@ -13,7 +13,7 @@
 # capitalization, length, occurrence); wording is paraphrased in each rule's
 # `message`, never quoted verbatim from the guide.
 #
-# Generated file — do not hand-edit. Regenerate with `pnpm examples:generate`
+# Generated file — do not hand-edit. Regenerate with `node scripts/generate-examples.mjs`
 # after changing src/config/presets/microsoft.ts or this file's appendix
 # (examples/appendices/microsoft.appendix.yaml).
 
@@ -102,11 +102,11 @@ extends:
 # Full expansion (reference)
 # ------------------------------------------------------------------------------
 # This is what `extends: [recheck/microsoft]` resolves to today: all 93 rules,
-# alphabetized by rule id, generated straight from the live preset (`pnpm
-# examples:generate`). You do not need to copy any of it — the extends
-# block above already gives you all of this. Read it to see exactly what
-# you are adopting, or as a starting point if you would rather pin or fork
-# specific rules into your own config instead of extending the preset.
+# alphabetized by rule id, generated straight from the live preset (`node
+# scripts/generate-examples.mjs`). You do not need to copy any of it — the
+# extends block above already gives you all of this. Read it to see exactly
+# what you are adopting, or as a starting point if you would rather pin or
+# fork specific rules into your own config instead of extending the preset.
 #
 # `fix: false` on every rule below means what it says: detection-only, no
 # exceptions — see "How to tune it" above and PROVENANCE.md for why.
@@ -1445,7 +1445,7 @@ microsoft/world-wide-web:
 # Appendix — candidates NOT shipped by recheck/microsoft (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/microsoft.yaml stale until you regenerate — the drift
 # test's failure message says so, so this doesn't read as a generator bug.
 #

package/examples/plain-language.yaml

@@ -8,7 +8,7 @@
 # Synced:     2026-07-30
 # Provenance: packages/recheck/presets/plain-language/PROVENANCE.md
 #
-# Generated file — do not hand-edit. Regenerate with `pnpm examples:generate`
+# Generated file — do not hand-edit. Regenerate with `node scripts/generate-examples.mjs`
 # after changing src/config/presets/plain-language.ts or this file's
 # appendix (examples/appendices/plain-language.appendix.yaml).
 
@@ -89,11 +89,11 @@ extends:
 # Full expansion (reference)
 # ------------------------------------------------------------------------------
 # This is what `extends: [recheck/plain-language]` resolves to today: all 10 rules,
-# alphabetized by rule id, generated straight from the live preset (`pnpm
-# examples:generate`). You do not need to copy any of it — the extends
-# block above already gives you all of this. Read it to see exactly what
-# you are adopting, or as a starting point if you would rather pin or fork
-# specific rules into your own config instead of extending the preset.
+# alphabetized by rule id, generated straight from the live preset (`node
+# scripts/generate-examples.mjs`). You do not need to copy any of it — the
+# extends block above already gives you all of this. Read it to see exactly
+# what you are adopting, or as a starting point if you would rather pin or
+# fork specific rules into your own config instead of extending the preset.
 #
 # `fix: false` on every rule below means what it says: detection-only, no
 # exceptions — see "How to tune it" above and PROVENANCE.md for why.
@@ -239,7 +239,7 @@ plain-language/redundant-pairs:
 # Appendix — candidates NOT shipped by recheck/plain-language (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs). Editing it
+# `node scripts/generate-examples.mjs`. Editing it
 # makes examples/plain-language.yaml stale until you regenerate — the drift
 # test's failure message says so, so this doesn't read as a generator bug.
 #

package/examples/technical-english.yaml

@@ -10,7 +10,7 @@
 #             standard.
 # Provenance: packages/recheck/presets/technical-english/PROVENANCE.md
 #
-# Generated file — do not hand-edit. Regenerate with `pnpm examples:generate`
+# Generated file — do not hand-edit. Regenerate with `node scripts/generate-examples.mjs`
 # after changing src/config/presets/technical-english.ts or this file's
 # appendix (examples/appendices/technical-english.appendix.yaml).
 
@@ -58,11 +58,11 @@ extends:
 # Full expansion (reference)
 # ------------------------------------------------------------------------------
 # This is what `extends: [recheck/technical-english]` resolves to today: all 3 rules,
-# alphabetized by rule id, generated straight from the live preset (`pnpm
-# examples:generate`). You do not need to copy any of it — the extends
-# block above already gives you all of this. Read it to see exactly what
-# you are adopting, or as a starting point if you would rather pin or fork
-# specific rules into your own config instead of extending the preset.
+# alphabetized by rule id, generated straight from the live preset (`node
+# scripts/generate-examples.mjs`). You do not need to copy any of it — the
+# extends block above already gives you all of this. Read it to see exactly
+# what you are adopting, or as a starting point if you would rather pin or
+# fork specific rules into your own config instead of extending the preset.
 #
 # `fix: false` on every rule below means what it says: detection-only, no
 # exceptions — see "How to tune it" above and PROVENANCE.md for why.
@@ -103,7 +103,7 @@ technical-english/sentence-length:
 # Appendix — candidates NOT shipped by recheck/technical-english (hand-maintained)
 # ==============================================================================
 # This file is appended verbatim to the generated example above by
-# `pnpm examples:generate` (see scripts/generate-examples.mjs).
+# `node scripts/generate-examples.mjs`.
 #
 # Full detail and reasons: packages/recheck/presets/technical-english/PROVENANCE.md
 #

package/lib/actions/baseline.d.ts

@@ -0,0 +1,15 @@
+import { type ResolvedRecheckConfig } from '../config/resolve.js';
+export interface BaselineRunResult {
+    roots: string[];
+    filesFound: number;
+    unreadableFiles: string[];
+    outPath: string;
+    errorCount: number;
+    baselinedFileCount: number;
+}
+/**
+ * Runs all configured rules and writes the baseline file: the error count for each
+ * file and rule. The format is in core/baseline.ts.
+ */
+export declare function generateBaseline(paths: string | string[] | undefined, config: ResolvedRecheckConfig): Promise<BaselineRunResult>;
+//# sourceMappingURL=baseline.d.ts.map

package/lib/actions/baseline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseline.d.ts","sourceRoot":"","sources":["../../src/actions/baseline.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAOzF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,YAAM,EAC9B,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAyC5B"}

package/lib/actions/baseline.js

@@ -0,0 +1,51 @@
+import * as fs from 'fs/promises';
+import * as pathModule from 'path';
+import { DEFAULT_BASELINE_FILE } from '../config/resolve.js';
+import { buildBaseline, serializeBaseline, baselineKeyMapper } from '../core/baseline.js';
+import { needsImageMetadata, loadImageMetadata } from '../core/files.js';
+import { filterEnabledRules } from '../core/rule-filters.js';
+import { runRules } from '../core/runner.js';
+import { discoverFilesForRoots, rootForFile, toRoots } from './roots.js';
+/**
+ * Runs all configured rules and writes the baseline file: the error count for each
+ * file and rule. The format is in core/baseline.ts.
+ */
+export async function generateBaseline(paths = '.', config) {
+    const roots = toRoots(paths);
+    const configDir = config.configDir;
+    const { enabled: rulesToRun } = filterEnabledRules(config.rules);
+    const files = await discoverFilesForRoots(roots);
+    const loadImageMeta = needsImageMetadata(rulesToRun);
+    const fileInputs = [];
+    const unreadableFiles = [];
+    for (const filePath of files) {
+        try {
+            const content = await fs.readFile(filePath, 'utf8');
+            const metadata = loadImageMeta
+                ? await loadImageMetadata(filePath, content, rootForFile(filePath, roots))
+                : undefined;
+            fileInputs.push({ path: filePath, content, metadata });
+        }
+        catch {
+            unreadableFiles.push(filePath);
+        }
+    }
+    const { problems } = await runRules(fileInputs, rulesToRun, {
+        knownRuleNames: new Set(config.rules.map((rule) => rule.name)),
+        markdoc: config.markdoc,
+        markdocSchema: config.markdocSchema,
+    });
+    const errors = problems.filter((problem) => problem.severity === 'error');
+    const baseline = buildBaseline(errors, baselineKeyMapper(configDir));
+    const outPath = pathModule.resolve(configDir, DEFAULT_BASELINE_FILE);
+    await fs.writeFile(outPath, serializeBaseline(baseline), 'utf8');
+    return {
+        roots,
+        filesFound: files.length,
+        unreadableFiles,
+        outPath,
+        errorCount: errors.length,
+        baselinedFileCount: Object.keys(baseline.files).length,
+    };
+}
+//# sourceMappingURL=baseline.js.map

package/lib/actions/baseline.js.map

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

package/lib/actions/lint.d.ts

@@ -0,0 +1,51 @@
+import type { ResolvedRecheckConfig } from '../config/resolve.js';
+import type { Fix, Problem } from '../types/index.js';
+export interface LintOptions {
+    severity?: 'off' | 'info' | 'warn' | 'warning' | 'error';
+    tags?: (string | number)[];
+    rules?: string[];
+    excludeRules?: string[];
+    fix?: boolean;
+    changedOnly?: boolean;
+    changedListPath?: string;
+}
+export interface LintRunReport {
+    roots: string[];
+    ruleCount: number;
+    disabledRuleCount: number;
+    filesFound: number;
+    changedFilter?: {
+        provided: boolean;
+        matched: number;
+    };
+    unreadableFiles: string[];
+    scannedFileCount: number;
+    problems: Problem[];
+    fixes?: {
+        applied: Fix[];
+        skippedCount: number;
+    };
+    baseline?: {
+        matched: number;
+        new: number;
+        stale: number;
+    };
+    empty: boolean;
+}
+export type LintRunResult = {
+    status: 'unknown-rule';
+    message: string;
+    available: string[];
+} | {
+    status: 'baseline-missing';
+    baselinePath: string;
+    report: LintRunReport;
+} | {
+    status: 'failed';
+    message: string;
+    report: LintRunReport;
+} | ({
+    status: 'completed';
+} & LintRunReport);
+export declare function runLint(paths: string | string[] | undefined, config: ResolvedRecheckConfig, options: LintOptions): Promise<LintRunResult>;
+//# sourceMappingURL=lint.d.ts.map

package/lib/actions/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/actions/lint.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAKlE,OAAO,KAAK,EAAE,GAAG,EAAkB,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAGtE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACzD,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,aAAa,CAAC,EAAE;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,KAAK,CAAC,EAAE;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,QAAQ,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAChE;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAC3E;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,CAAA;CAAE,GAC5D,CAAC;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GAAG,aAAa,CAAC,CAAC;AAE9C,wBAAsB,OAAO,CAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,YAAM,EAC9B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgIxB"}

package/lib/actions/lint.js

@@ -0,0 +1,123 @@
+import * as fs from 'fs/promises';
+import * as pathModule from 'path';
+import { parseBaseline, compareToBaseline, baselineKeyMapper } from '../core/baseline.js';
+import { loadChangedFiles, needsImageMetadata, loadImageMetadata } from '../core/files.js';
+import { applyFilters, UnknownRuleNameError } from '../core/rule-filters.js';
+import { runRules, runRulesUntilStable } from '../core/runner.js';
+import { discoverFilesForRoots, rootForFile, toRoots } from './roots.js';
+export async function runLint(paths = '.', config, options) {
+    const roots = toRoots(paths);
+    let rulesToRun;
+    let disabledCount;
+    try {
+        ({ filtered: rulesToRun, disabledCount } = applyFilters(config.rules, {
+            severity: options.severity,
+            tags: options.tags,
+            rules: options.rules,
+            excludeRules: options.excludeRules,
+        }));
+    }
+    catch (error) {
+        if (error instanceof UnknownRuleNameError) {
+            return { status: 'unknown-rule', message: error.message, available: error.available };
+        }
+        throw error;
+    }
+    const report = {
+        roots,
+        ruleCount: rulesToRun.length,
+        disabledRuleCount: disabledCount,
+        filesFound: 0,
+        unreadableFiles: [],
+        scannedFileCount: 0,
+        problems: [],
+        empty: true,
+    };
+    try {
+        let files = await discoverFilesForRoots(roots);
+        report.filesFound = files.length;
+        // With a baseline, still compare when no files are found: deleting the last
+        // baselined files makes their entries stale. Changed-only runs skip this.
+        if (files.length === 0 && !(config.baselinePath && !options.changedOnly)) {
+            return { status: 'completed', ...report };
+        }
+        if (options.changedOnly) {
+            const changedCandidates = await loadChangedFiles(options.changedListPath);
+            if (!changedCandidates || changedCandidates.length === 0) {
+                report.changedFilter = { provided: false, matched: 0 };
+                return { status: 'completed', ...report };
+            }
+            const changedSet = new Set(changedCandidates.map((candidate) => pathModule.isAbsolute(candidate) ? candidate : pathModule.resolve(candidate)));
+            const filtered = files.filter((file) => changedSet.has(pathModule.resolve(file)));
+            report.changedFilter = { provided: true, matched: filtered.length };
+            if (filtered.length === 0)
+                return { status: 'completed', ...report };
+            files = filtered;
+        }
+        const loadImageMeta = needsImageMetadata(rulesToRun);
+        const fileInputs = [];
+        for (const filePath of files) {
+            try {
+                const content = await fs.readFile(filePath, 'utf8');
+                const metadata = loadImageMeta
+                    ? await loadImageMetadata(filePath, content, rootForFile(filePath, roots))
+                    : undefined;
+                fileInputs.push({ path: filePath, content, metadata });
+            }
+            catch {
+                report.unreadableFiles.push(filePath);
+            }
+        }
+        report.scannedFileCount = fileInputs.length;
+        report.empty = false;
+        // Includes rules set to `off`, so a directive that turns one off is not reported as unknown.
+        const runnerOptions = {
+            knownRuleNames: new Set(config.rules.map((rule) => rule.name)),
+            markdoc: config.markdoc,
+            markdocSchema: config.markdocSchema,
+        };
+        const { problems: allProblems, fixedFiles, fixes, skippedFixes, } = options.fix
+            ? await runRulesUntilStable(fileInputs, rulesToRun, runnerOptions)
+            : await runRules(fileInputs, rulesToRun, runnerOptions);
+        if (options.fix) {
+            for (const [filePath, fixedContent] of fixedFiles) {
+                await fs.writeFile(filePath, fixedContent, 'utf8');
+            }
+            report.fixes = { applied: fixes, skippedCount: skippedFixes.length };
+        }
+        report.problems = allProblems;
+        if (config.baselinePath) {
+            let baselineText;
+            try {
+                baselineText = await fs.readFile(config.baselinePath, 'utf8');
+            }
+            catch {
+                return { status: 'baseline-missing', baselinePath: config.baselinePath, report };
+            }
+            const baseline = parseBaseline(baselineText, config.baselinePath);
+            const toKey = baselineKeyMapper(config.configDir);
+            const comparison = compareToBaseline(allProblems, baseline, {
+                scannedFiles: fileInputs.map((file) => file.path),
+                executedRules: new Set(rulesToRun.map((rule) => rule.name)),
+                toKey,
+                // A changed-only run does not scan every file, so a missing file means nothing there.
+                scanRoots: options.changedOnly ? undefined : roots.map(toKey),
+            });
+            report.problems = comparison.problems;
+            report.baseline = {
+                matched: comparison.suppressed,
+                new: comparison.newFindings,
+                stale: comparison.staleEntries,
+            };
+        }
+        return { status: 'completed', ...report };
+    }
+    catch (error) {
+        return {
+            status: 'failed',
+            message: error instanceof Error ? error.message : 'Unknown error',
+            report,
+        };
+    }
+}
+//# sourceMappingURL=lint.js.map

package/lib/actions/lint.js.map

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

package/lib/actions/markdoc-schema.d.ts

@@ -0,0 +1,34 @@
+export interface MarkdocSchemaOptions {
+    from: string[];
+    out: string;
+    check?: boolean;
+}
+export type MarkdocSchemaResult = {
+    status: 'written';
+    outPath: string;
+} | {
+    status: 'up-to-date';
+    outPath: string;
+} | {
+    status: 'missing';
+    outPath: string;
+} | {
+    status: 'stale';
+    outPath: string;
+} | {
+    status: 'conflicts';
+    conflicts: string[];
+} | {
+    status: 'load-error';
+    message: string;
+} | {
+    status: 'write-error';
+    outPath: string;
+    message: string;
+};
+/**
+ * Generates a `markdoc.extend.tagsFile` YAML file from one or more project schema
+ * modules. The file holds only the project's own tags, not the built-in ones.
+ */
+export declare function generateMarkdocSchema(options: MarkdocSchemaOptions): Promise<MarkdocSchemaResult>;
+//# sourceMappingURL=markdoc-schema.d.ts.map

package/lib/actions/markdoc-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdoc-schema.d.ts","sourceRoot":"","sources":["../../src/actions/markdoc-schema.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,GAC5C;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAiFhE;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,mBAAmB,CAAC,CA0C9B"}

package/lib/actions/markdoc-schema.js

@@ -0,0 +1,106 @@
+import * as yaml from 'js-yaml';
+import { readFile, writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { extractStatics } from '../parser/markdoc/extract-statics.js';
+import { isPlainObject } from '../utils/is-plain-object.js';
+/**
+ * Imports one `--from` module and returns its tags. Accepts a named `tags` export
+ * or a default export with `tags`. If the import fails, throws a short message:
+ * the usual cause is a TypeScript file that Node cannot run.
+ */
+async function loadModuleTags(fromArg, cwd) {
+    const resolvedUrl = pathToFileURL(path.resolve(cwd, fromArg)).href;
+    let imported;
+    try {
+        imported = (await import(resolvedUrl));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`could not import "${fromArg}". Compile it to JavaScript first, or run the CLI ` +
+            `under a TypeScript loader such as tsx. (${detail})`);
+    }
+    const namedTags = imported.tags;
+    const defaultTags = imported.default?.tags;
+    const tags = namedTags ?? defaultTags;
+    if (!isPlainObject(tags)) {
+        throw new Error(`"${fromArg}" has no "tags" export — expected a named "tags" export or a default ` +
+            `export with a "tags" property`);
+    }
+    return tags;
+}
+/**
+ * Merges the tags of all modules. A tag defined twice with the same shape is fine.
+ * A tag defined twice with different shapes is a conflict, and neither one wins.
+ */
+function mergeExtracted(modules) {
+    const merged = {};
+    const owner = {};
+    const conflicts = [];
+    for (const { source, tags } of modules) {
+        for (const [tagName, tagSchema] of Object.entries(tags)) {
+            if (!(tagName in merged)) {
+                merged[tagName] = tagSchema;
+                owner[tagName] = source;
+                continue;
+            }
+            if (JSON.stringify(merged[tagName]) !== JSON.stringify(tagSchema)) {
+                conflicts.push(`tag "${tagName}" differs between "${owner[tagName]}" and "${source}"`);
+            }
+        }
+    }
+    return { merged, conflicts };
+}
+// Renders the YAML for `markdoc.extend.tagsFile`: a flat map of tag name to schema, with no top-level `tags:` key.
+function renderYaml(merged, fromArgs, outArg) {
+    const fromFlags = fromArgs.map((fromArg) => `--from ${fromArg}`).join(' ');
+    const header = `# Generated file — do not hand-edit.\n` +
+        `# Source module(s): ${fromArgs.join(', ')}\n` +
+        `# Regenerate: redocly recheck --generate-markdoc-schema ${fromFlags} --output ${outArg}\n`;
+    return header + yaml.dump(merged, { sortKeys: true });
+}
+/**
+ * Generates a `markdoc.extend.tagsFile` YAML file from one or more project schema
+ * modules. The file holds only the project's own tags, not the built-in ones.
+ */
+export async function generateMarkdocSchema(options) {
+    const cwd = process.cwd();
+    const modules = [];
+    for (const fromArg of options.from) {
+        try {
+            const rawTags = await loadModuleTags(fromArg, cwd);
+            const { tags } = extractStatics(rawTags, {}, {});
+            modules.push({ source: fromArg, tags });
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { status: 'load-error', message };
+        }
+    }
+    const { merged, conflicts } = mergeExtracted(modules);
+    if (conflicts.length > 0) {
+        return { status: 'conflicts', conflicts };
+    }
+    const rendered = renderYaml(merged, options.from, options.out);
+    const outPath = path.resolve(cwd, options.out);
+    if (options.check) {
+        const onDisk = await readFile(outPath, 'utf8').catch(() => null);
+        if (onDisk === null) {
+            return { status: 'missing', outPath };
+        }
+        if (onDisk !== rendered) {
+            return { status: 'stale', outPath };
+        }
+        return { status: 'up-to-date', outPath };
+    }
+    try {
+        await writeFile(outPath, rendered, 'utf8');
+    }
+    catch (error) {
+        // Missing directories are not created, so a typo in --output is reported.
+        const detail = error instanceof Error ? error.message : String(error);
+        return { status: 'write-error', outPath, message: detail };
+    }
+    return { status: 'written', outPath };
+}
+//# sourceMappingURL=markdoc-schema.js.map