markuplint 5.0.0-rc.1 → 5.0.0-rc.2

package/CHANGELOG.md

@@ -3,6 +3,30 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [5.0.0-rc.2](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.1...v5.0.0-rc.2) (2026-04-15)
+
+### Bug Fixes
+
+- **markuplint:** add default export condition and re-export isFatalError ([55a990a](https://github.com/markuplint/markuplint/commit/55a990affeec62c23a96cf15b42327fcb867e809))
+- **markuplint:** add missing status property to github-reporter test data ([bb7ba62](https://github.com/markuplint/markuplint/commit/bb7ba62e9350c173987f76de2741aaeb3ba0997b))
+
+- build!: remove ESLint and replace with oxlint ([1e0a337](https://github.com/markuplint/markuplint/commit/1e0a337707f76b903b16beeeb8c4d4fc0d8fc9e4))
+- feat(markuplint)!: remove deprecated autoLoad option and MLResultInfo_v1 interface ([4eb1d05](https://github.com/markuplint/markuplint/commit/4eb1d05eb2829019cd4073afa153a512b1c4c8fa))
+
+### Features
+
+- **config-presets:** add document uniqueness rules to html-standard preset ([6ed848b](https://github.com/markuplint/markuplint/commit/6ed848bd800416d1220b9de95ece7a3d752d881f))
+- **markuplint:** add CLI summary output ([4743ba0](https://github.com/markuplint/markuplint/commit/4743ba0be7311288ea2b28fb9345567cf97c1a23))
+- **markuplint:** add suppressions subpath export and editor severity downgrade ([362adef](https://github.com/markuplint/markuplint/commit/362adef1a040c66fec36c01bd8d8fcbe9a66c453))
+- **vscode:** add suppressed message prefix and blame parser tests ([cd80a80](https://github.com/markuplint/markuplint/commit/cd80a802c3bad29a8a1d510d2160a21a6f0a2682))
+
+### BREAKING CHANGES
+
+- ESLint is no longer used. Use oxlint instead.
+- The autoLoad option has been removed from APIOptions.
+  Rules are now always auto-loaded unconditionally.
+  The MLResultInfo_v1 interface has also been removed.
+
 # [5.0.0-rc.1](https://github.com/markuplint/markuplint/compare/v5.0.0-rc.0...v5.0.0-rc.1) (2026-03-27)
 
 ### Bug Fixes

package/lib/api/ml-engine.js

@@ -341,7 +341,7 @@ export class MLEngine extends Emitter {
         return pretenders;
     }
     async #resolveRules(plugins, ruleset) {
-        const rules = await resolveRules(plugins, ruleset, this.#options?.importPresetRules ?? true, this.#options?.autoLoad ?? true);
+        const rules = await resolveRules(plugins, ruleset, this.#options?.importPresetRules ?? true);
         if (this.#options?.rules) {
             rules.push(...this.#options.rules);
         }

package/lib/api/types.d.ts

@@ -18,10 +18,6 @@ export type APIOptions = {
     readonly rules?: readonly Readonly<AnyMLRule>[];
     readonly importPresetRules?: boolean;
     readonly severity?: SeverityOptions;
-    /**
-     * @deprecated
-     */
-    readonly autoLoad?: boolean;
 };
 /**
  * Event map for the {@link MLEngine}, defining all emitted events and their payload types.

package/lib/cli/command.js

@@ -7,7 +7,7 @@ import { MLEngine } from '../api/index.js';
 import { log } from '../debug.js';
 import { applySuppressions, generateSuppressions, mergeSuppressions, pruneSuppressions, readSuppressionsFile, resolveSuppressionsPath, writeSuppressionsFile, } from '../suppressions/index.js';
 import { outputDryRunDiff } from './dry-run-output.js';
-import { output } from './output.js';
+import { output, outputSummary } from './output.js';
 /**
  * Executes the markuplint linting command against the given files.
  *
@@ -114,6 +114,11 @@ export async function command(files, options, apiOptions) {
         if (!result) {
             continue;
         }
+        processedFiles.push(result.filePath);
+        filesContent.set(result.filePath, {
+            sourceCode: result.sourceCode,
+            fixedCode: result.fixedCode,
+        });
         // Store engine for scope computation in suppressions
         engines.set(result.filePath, engine);
         // Progressive出力が有効でJSON形式でない場合
@@ -127,14 +132,6 @@ export async function command(files, options, apiOptions) {
                 status: 'processed',
             }, options);
         }
-        else {
-            // 従来の動作：メモリに蓄積
-            processedFiles.push(result.filePath);
-            filesContent.set(result.filePath, {
-                sourceCode: result.sourceCode,
-                fixedCode: result.fixedCode,
-            });
-        }
         // Add violations to collector
         collector.pushWithFile(result.filePath, ...result.violations);
         const errorCount = result.violations.filter(v => v.severity === 'error').length;
@@ -287,6 +284,40 @@ export async function command(files, options, apiOptions) {
             }
         }
     }
+    let errorCount = 0;
+    let warningCount = 0;
+    let noticeCount = 0;
+    let failedFileCount = 0;
+    for (const filePath of processedFiles) {
+        const violations = outputViolationsByFile.get(filePath) || [];
+        if (violations.length > 0) {
+            failedFileCount++;
+        }
+        for (const violation of violations) {
+            switch (violation.severity) {
+                case 'error': {
+                    errorCount++;
+                    break;
+                }
+                case 'warning': {
+                    warningCount++;
+                    break;
+                }
+                case 'info': {
+                    noticeCount++;
+                    break;
+                }
+            }
+        }
+    }
+    outputSummary({
+        checkedFileCount: processedFiles.length,
+        failedFileCount,
+        skippedFileCount: skippedFiles.length,
+        errorCount,
+        warningCount,
+        noticeCount,
+    }, options);
     // Check if max-warnings limit is exceeded (ESLint compatible)
     if (!hasError && options.maxWarnings >= 0 && totalWarningCount > options.maxWarnings) {
         hasError = true;

package/lib/cli/output.d.ts

@@ -1,5 +1,13 @@
 import type { CLIOptions } from './bootstrap.js';
 import type { MLResultInfo } from '../types.js';
+export interface SummaryInfo {
+    readonly checkedFileCount: number;
+    readonly failedFileCount: number;
+    readonly skippedFileCount: number;
+    readonly errorCount: number;
+    readonly warningCount: number;
+    readonly noticeCount: number;
+}
 /**
  * Writes lint results to stdout or stderr using the reporter selected by `--format`.
  *
@@ -12,3 +20,14 @@ import type { MLResultInfo } from '../types.js';
  * @param options - CLI options that control the output format and color.
  */
 export declare function output(results: MLResultInfo, options: CLIOptions): void;
+/**
+ * Writes an aggregated lint summary after all file outputs have been emitted.
+ *
+ * Summary output is enabled for the standard and simple formats only.
+ * JSON and GitHub formats are left unchanged because they are intended for
+ * machine-readable output.
+ *
+ * @param summary - Aggregated counts across all linted files.
+ * @param options - CLI options that control the output format and color.
+ */
+export declare function outputSummary(summary: SummaryInfo, options: CLIOptions): void;

package/lib/cli/output.js

@@ -1,5 +1,8 @@
+import { font, xterm } from '@markuplint/cli-utils';
 import stripAnsi from 'strip-ansi';
 import { simpleReporter, standardReporter, githubReporter } from '../reporter/index.js';
+const loggerError = font.red;
+const loggerWarning = xterm(208);
 /**
  * Writes lint results to stdout or stderr using the reporter selected by `--format`.
  *
@@ -43,3 +46,63 @@ export function output(results, options) {
     }
     process.stdout.write(msg);
 }
+/**
+ * Writes an aggregated lint summary after all file outputs have been emitted.
+ *
+ * Summary output is enabled for the standard and simple formats only.
+ * JSON and GitHub formats are left unchanged because they are intended for
+ * machine-readable output.
+ *
+ * @param summary - Aggregated counts across all linted files.
+ * @param options - CLI options that control the output format and color.
+ */
+export function outputSummary(summary, options) {
+    const format = options.format?.toLowerCase() ?? 'standard';
+    if (format === 'json' || format === 'github') {
+        return;
+    }
+    if (summary.checkedFileCount === 0 && summary.skippedFileCount === 0) {
+        return;
+    }
+    const problemCount = summary.errorCount + summary.warningCount + summary.noticeCount;
+    if (options.problemOnly && problemCount === 0) {
+        return;
+    }
+    const out = createSummaryLines(summary);
+    if (out.length === 0) {
+        return;
+    }
+    let msg = `\n${out.join('\n')}\n`;
+    msg = options.color ? msg : stripAnsi(msg);
+    if (problemCount > 0) {
+        process.stderr.write(msg);
+        return;
+    }
+    process.stdout.write(msg);
+}
+function createSummaryLines(summary) {
+    const out = [];
+    const problemCount = summary.errorCount + summary.warningCount + summary.noticeCount;
+    const passedFileCount = summary.checkedFileCount - summary.failedFileCount;
+    if (problemCount === 0) {
+        out.push(`${font.green('✔')} ${pluralize(summary.checkedFileCount, 'file')} checked, 0 problems`);
+    }
+    else {
+        const problemDetail = [
+            `${summary.errorCount} error${summary.errorCount === 1 ? '' : 's'}`,
+            `${summary.warningCount} warning${summary.warningCount === 1 ? '' : 's'}`,
+            summary.noticeCount > 0 ? `${summary.noticeCount} notice${summary.noticeCount === 1 ? '' : 's'}` : null,
+        ]
+            .filter(Boolean)
+            .join(', ');
+        const logger = summary.errorCount > 0 ? loggerError : loggerWarning;
+        out.push(`${logger('✖')} ${problemCount} problem${problemCount === 1 ? '' : 's'} (${problemDetail}) in ${pluralize(summary.checkedFileCount, 'file')}`, `${pluralize(summary.checkedFileCount, 'file')} checked: ${passedFileCount} passed, ${summary.failedFileCount} failed`);
+    }
+    if (summary.skippedFileCount > 0) {
+        out.push(`${font.yellow('⚠')} ${pluralize(summary.skippedFileCount, 'file')} skipped because --max-count was reached`);
+    }
+    return out;
+}
+function pluralize(count, noun) {
+    return `${count} ${noun}${count === 1 ? '' : 's'}`;
+}

package/lib/suppressions/downgrade-severity.d.ts

@@ -0,0 +1,51 @@
+import type { Violation } from '@markuplint/ml-config';
+import type { PositionedNode } from './compute-scope.js';
+import type { SuppressionsData } from './types.js';
+/**
+ * @experimental
+ * A violation with its severity potentially downgraded by bulk suppression.
+ */
+export type DowngradedViolation = Violation & {
+    /**
+     * When set, indicates the original severity before suppression downgrade.
+     * Absent when the violation was not affected by suppression.
+     */
+    readonly originalSeverity?: Violation['severity'];
+};
+/**
+ * @experimental
+ * Result of analyzing violations against suppression data for severity downgrade.
+ * Used by editor integrations to show suppressed violations as `info` instead of hiding them.
+ */
+export type DowngradeResult = {
+    /** All violation indices that should be downgraded to info. */
+    readonly withinThreshold: ReadonlySet<number>;
+    /**
+     * Violation indices where count exceeds the suppressed threshold.
+     * These need further analysis (e.g., git blame) to distinguish old vs new.
+     */
+    readonly exceedingThreshold: ReadonlyMap<string, readonly number[]>;
+};
+/**
+ * @experimental
+ * Analyzes violations against suppression data and returns which should be downgraded.
+ *
+ * - Within threshold: all violations for that rule → should be downgraded to info
+ * - Exceeding threshold: returns violation indices grouped by ruleId for further analysis
+ *
+ * @param absoluteFilePath - The file being linted
+ * @param violations - The violations to analyze
+ * @param suppressions - The suppression data
+ * @param suppressionsFilePath - Absolute path to the suppressions file
+ * @param nodeList - Optional node list for scope-aware filtering
+ */
+export declare function analyzeForDowngrade(absoluteFilePath: string, violations: readonly Violation[], suppressions: SuppressionsData, suppressionsFilePath: string, _nodeList?: readonly PositionedNode[]): DowngradeResult;
+/**
+ * @experimental
+ * Applies severity downgrade to violations based on downgrade indices.
+ *
+ * @param violations - Original violations
+ * @param downgradeIndices - Set of violation indices to downgrade to info
+ * @returns Violations with severity potentially modified
+ */
+export declare function applyDowngrade(violations: readonly Violation[], downgradeIndices: ReadonlySet<number>): readonly DowngradedViolation[];

package/lib/suppressions/downgrade-severity.js

@@ -0,0 +1,102 @@
+import { toRelativePath } from './suppressions-file.js';
+/**
+ * @experimental
+ * Analyzes violations against suppression data and returns which should be downgraded.
+ *
+ * - Within threshold: all violations for that rule → should be downgraded to info
+ * - Exceeding threshold: returns violation indices grouped by ruleId for further analysis
+ *
+ * @param absoluteFilePath - The file being linted
+ * @param violations - The violations to analyze
+ * @param suppressions - The suppression data
+ * @param suppressionsFilePath - Absolute path to the suppressions file
+ * @param nodeList - Optional node list for scope-aware filtering
+ */
+export function analyzeForDowngrade(absoluteFilePath, violations, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+suppressions, suppressionsFilePath, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+_nodeList) {
+    const relPath = toRelativePath(absoluteFilePath, suppressionsFilePath);
+    const fileSuppressions = suppressions[relPath];
+    if (!fileSuppressions) {
+        return { withinThreshold: new Set(), exceedingThreshold: new Map() };
+    }
+    const withinThreshold = new Set();
+    const exceedingThreshold = new Map();
+    // Group error violations by ruleId
+    const violationsByRule = new Map();
+    for (const [i, v] of violations.entries()) {
+        if (v.severity !== 'error') {
+            continue;
+        }
+        const group = violationsByRule.get(v.ruleId) ?? [];
+        group.push({ index: i, violation: v });
+        violationsByRule.set(v.ruleId, group);
+    }
+    for (const [ruleId, entry] of Object.entries(fileSuppressions)) {
+        const group = violationsByRule.get(ruleId);
+        if (!group) {
+            continue;
+        }
+        const scopedGroup = filterByScope(group, entry, _nodeList);
+        const scopedCount = scopedGroup.length;
+        if (scopedCount === 0) {
+            continue;
+        }
+        if (scopedCount <= entry.count) {
+            for (const item of scopedGroup) {
+                withinThreshold.add(item.index);
+            }
+        }
+        else {
+            exceedingThreshold.set(ruleId, scopedGroup.map(item => item.index));
+        }
+    }
+    return { withinThreshold, exceedingThreshold };
+}
+/**
+ * @experimental
+ * Applies severity downgrade to violations based on downgrade indices.
+ *
+ * @param violations - Original violations
+ * @param downgradeIndices - Set of violation indices to downgrade to info
+ * @returns Violations with severity potentially modified
+ */
+export function applyDowngrade(violations, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+downgradeIndices) {
+    const result = [];
+    for (const [i, violation] of violations.entries()) {
+        if (downgradeIndices.has(i)) {
+            result.push({
+                ...violation,
+                severity: 'info',
+                originalSeverity: violation.severity,
+            });
+        }
+        else {
+            result.push(violation);
+        }
+    }
+    return result;
+}
+/**
+ * Filters a group of violations by scope selector if present.
+ */
+function filterByScope(
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+group, entry, 
+// eslint-disable-next-line @typescript-eslint/prefer-readonly-parameter-types
+_nodeList) {
+    if (!entry.scope || !_nodeList) {
+        return group;
+    }
+    // Scope-aware filtering in editor context:
+    // When scope is present but we lack full scope matching infrastructure,
+    // fall back to file-level filtering (treats all violations as in-scope).
+    // This is the safe direction — more violations may be downgraded than intended,
+    // but no new violations are hidden.
+    // TODO(#3536): Export isViolationInScope from apply-suppressions.ts and reuse here.
+    return group;
+}

package/lib/suppressions/index.d.ts

@@ -18,3 +18,6 @@ export { generateSuppressions } from './generate-suppressions.js';
 export { mergeSuppressions } from './merge-suppressions.js';
 export { pruneSuppressions } from './prune-suppressions.js';
 export { readSuppressionsFile, writeSuppressionsFile, resolveSuppressionsPath, toRelativePath, toAbsolutePath, } from './suppressions-file.js';
+export type { DowngradedViolation, DowngradeResult } from './downgrade-severity.js';
+export { analyzeForDowngrade, applyDowngrade } from './downgrade-severity.js';
+export { isFatalError } from '@markuplint/shared';

package/lib/suppressions/index.js

@@ -14,3 +14,5 @@ export { generateSuppressions } from './generate-suppressions.js';
 export { mergeSuppressions } from './merge-suppressions.js';
 export { pruneSuppressions } from './prune-suppressions.js';
 export { readSuppressionsFile, writeSuppressionsFile, resolveSuppressionsPath, toRelativePath, toAbsolutePath, } from './suppressions-file.js';
+export { analyzeForDowngrade, applyDowngrade } from './downgrade-severity.js';
+export { isFatalError } from '@markuplint/shared';

package/lib/suppressions/suppressions-file.js

@@ -33,7 +33,7 @@ export async function readSuppressionsFile(filePath) {
             return {};
         }
         if (error instanceof SyntaxError) {
-            // User may have manually edited and broken the JSON — Tier 2, not Fatal
+            // eslint-disable-next-line unicorn/prefer-type-error -- Not a type error; this is a JSON parse failure
             throw new Error(`Failed to parse suppressions file "${filePath}": ${error.message}`, { cause: error });
         }
         if (isFatalError(error)) {

package/lib/testing-tool/index.js

@@ -19,7 +19,6 @@ export async function mlTest(sourceCode, config, rules, locale = 'en', fix = fal
         locale: locale ?? global.locale,
         fix,
         ignoreExt: true,
-        autoLoad: true,
         importPresetRules: !rules,
     });
     const result = results[0];
@@ -42,8 +41,10 @@ export async function mlTest(sourceCode, config, rules, locale = 'en', fix = fal
  * @returns An object containing violations (without ruleId) and the fixed code
  */
 export async function mlRuleTest(rule, sourceCode, 
-// eslint-disable-next-line unicorn/no-object-as-default-parameter
-config = { rule: true }, fix = false, locale = 'en') {
+/* eslint-disable unicorn/no-object-as-default-parameter */
+config = { rule: true }, 
+/* eslint-enable unicorn/no-object-as-default-parameter */
+fix = false, locale = 'en') {
     if (config.rule === undefined && (config.nodeRule || config.childNodeRule)) {
         config.rule = true;
     }
@@ -110,7 +111,6 @@ export async function mlTestFile(target, config, rules, locale, fix = false) {
         fix,
         ignoreExt: true,
         noSearchConfig: !!config,
-        autoLoad: true,
         importPresetRules: !rules,
     });
     const result = results[0];

package/lib/types.d.ts

@@ -1,5 +1,5 @@
-import type { Config, PlainData, RuleConfigValue, Violation } from '@markuplint/ml-config';
-import type { Document, FixSummary, Ruleset } from '@markuplint/ml-core';
+import type { Violation } from '@markuplint/ml-config';
+import type { FixSummary } from '@markuplint/ml-core';
 /**
  * The result of linting a single file, including violations, source code, and fix results.
  */
@@ -12,22 +12,4 @@ export interface MLResultInfo {
     /** Fix process summary. Present when fix mode was enabled and fixes were found. */
     readonly fixSummary?: FixSummary;
 }
-/**
- * @deprecated
- */
-export interface MLResultInfo_v1 {
-    results: Violation[];
-    filePath: string;
-    sourceCode: string;
-    fixedCode: string;
-    document: Document<RuleConfigValue, PlainData> | null;
-    parser: string;
-    locale?: string;
-    ruleset: Ruleset;
-    configSet: {
-        config: Config;
-        files: string[];
-        error: string[];
-    };
-}
 export { type FixSummary } from '@markuplint/ml-core';

package/package.json

@@ -1,19 +1,28 @@
 {
 	"name": "markuplint",
-	"version": "5.0.0-rc.1",
+	"version": "5.0.0-rc.2",
 	"description": "An HTML linter for all markup developers",
 	"author": "Yusuke Hirao",
 	"license": "MIT",
 	"engines": {
 		"node": ">=22"
 	},
-	"repository": "git@github.com:markuplint/markuplint.git",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/markuplint/markuplint.git",
+		"directory": "packages/markuplint"
+	},
 	"type": "module",
 	"exports": {
 		".": {
 			"import": "./lib/index.js",
 			"types": "./lib/index.d.ts"
 		},
+		"./suppressions": {
+			"import": "./lib/suppressions/index.js",
+			"types": "./lib/suppressions/index.d.ts",
+			"default": "./lib/suppressions/index.js"
+		},
 		"./package.json": "./package.json"
 	},
 	"typedoc": {
@@ -26,17 +35,17 @@
 		"clean": "tsc --build --clean tsconfig.build.json"
 	},
 	"dependencies": {
-		"@markuplint/cli-utils": "5.0.0-rc.1",
-		"@markuplint/file-resolver": "5.0.0-rc.1",
-		"@markuplint/html-parser": "5.0.0-rc.1",
-		"@markuplint/html-spec": "5.0.0-rc.1",
-		"@markuplint/i18n": "5.0.0-rc.1",
-		"@markuplint/ml-ast": "5.0.0-rc.1",
-		"@markuplint/ml-config": "5.0.0-rc.1",
-		"@markuplint/ml-core": "5.0.0-rc.1",
-		"@markuplint/ml-spec": "5.0.0-rc.1",
-		"@markuplint/rules": "5.0.0-rc.1",
-		"@markuplint/shared": "5.0.0-rc.1",
+		"@markuplint/cli-utils": "5.0.0-rc.2",
+		"@markuplint/file-resolver": "5.0.0-rc.2",
+		"@markuplint/html-parser": "5.0.0-rc.2",
+		"@markuplint/html-spec": "5.0.0-rc.2",
+		"@markuplint/i18n": "5.0.0-rc.2",
+		"@markuplint/ml-ast": "5.0.0-rc.2",
+		"@markuplint/ml-config": "5.0.0-rc.2",
+		"@markuplint/ml-core": "5.0.0-rc.2",
+		"@markuplint/ml-spec": "5.0.0-rc.2",
+		"@markuplint/rules": "5.0.0-rc.2",
+		"@markuplint/shared": "5.0.0-rc.2",
 		"@types/debug": "4.1.13",
 		"chokidar": "5.0.0",
 		"debug": "4.4.3",
@@ -46,5 +55,5 @@
 		"strip-ansi": "7.2.0",
 		"type-fest": "5.5.0"
 	},
-	"gitHead": "0d6b4324d9a7d6b9e1ba57d4a57e45d36975cba9"
+	"gitHead": "e43763858d9234c417053becc73dbd088c1e7ea6"
 }