wikilint 2.4.4 → 2.5.0

package/README.md

@@ -2,9 +2,9 @@
 [![CodeQL](https://github.com/bhsd-harry/wikiparser-node/actions/workflows/codeql.yml/badge.svg)](https://github.com/bhsd-harry/wikiparser-node/actions/workflows/codeql.yml)
 [![CI](https://github.com/bhsd-harry/wikiparser-node/actions/workflows/node.js.yml/badge.svg)](https://github.com/bhsd-harry/wikiparser-node/actions/workflows/node.js.yml)
 
-# wikilint
+# WikiLint
 
-This is a minimal version of [wikiparser-node](https://www.npmjs.com/package/wikiparser-node) customized for [eslint-plugin-wikitext](https://www.npmjs.com/package/eslint-plugin-wikitext).
+This is a minimal version of [WikiParser-Node](https://www.npmjs.com/package/wikiparser-node) customized for [eslint-plugin-wikitext](https://www.npmjs.com/package/eslint-plugin-wikitext).
 
 You can also directly lint Wikitext articles in the command line using this package:
 
@@ -19,7 +19,7 @@ npx wikilint --config zhwiki --include --lang zh-hans *.wiki
 | `-c`, `--config` \<path or preset config\> | Choose parser's configuration | `default` |
 | `-h`, `--help` | Print available options | |
 | `-i`, `--include` | Parse for inclusion | no inclusion |
-| `-l`, `--lang` | Choose i18n language | English
+| `-l`, `--lang` | Choose i18n language | English |
 | `-q`, `--quiet` | Report errors only | errors and warnings |
 | `-s`, `--strict` | Exit when there is an error or warning<br>Override `-q` or `--quiet` | Exit `1` only where there is an error |
 | `-v`, `--version` | Print package version | |

package/dist/base.d.ts

@@ -10,16 +10,28 @@ export interface Config {
     readonly variants: string[];
     readonly excludes?: string[];
 }
-export type Severity = 'error' | 'warning';
+export declare namespace LintError {
+    type Severity = 'error' | 'warning';
+    type Rule = 'bold-header' | 'format-leakage' | 'fostered-content' | 'h1' | 'illegal-attr' | 'insecure-style' | 'invalid-gallery' | 'invalid-imagemap' | 'invalid-invoke' | 'lonely-apos' | 'lonely-bracket' | 'lonely-http' | 'nested-link' | 'no-arg' | 'no-duplicate' | 'no-ignored' | 'obsolete-attr' | 'obsolete-tag' | 'parsing-order' | 'pipe-like' | 'table-layout' | 'tag-like' | 'unbalanced-header' | 'unclosed-comment' | 'unclosed-quote' | 'unclosed-table' | 'unescaped' | 'unknown-page' | 'unmatched-tag' | 'unterminated-url' | 'url-encoding' | 'var-anchor' | 'void-ext';
+    interface Fix {
+        readonly range: [number, number];
+        text: string;
+    }
+}
 export interface LintError {
-    readonly message: string;
-    readonly severity: Severity;
-    readonly startIndex: number;
-    readonly endIndex: number;
-    readonly startLine: number;
-    readonly startCol: number;
-    readonly endLine: number;
-    readonly endCol: number;
+    rule: LintError.Rule;
+    message: string;
+    severity: LintError.Severity;
+    startIndex: number;
+    endIndex: number;
+    startLine: number;
+    startCol: number;
+    endLine: number;
+    endCol: number;
+    fix?: LintError.Fix;
+    suggestions?: (LintError.Fix & {
+        desc: string;
+    })[];
 }
 /** 类似Node */
 export interface AstNode {

package/dist/bin/cli.js

@@ -3,10 +3,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs_1 = require("fs");
 const path_1 = require("path");
+const chalk = require("chalk");
 const Parser = require("../index");
 const man = `
 Available options:
 -c, --config <path or preset config>    Choose parser's configuration
+--fix                                   Automatically fix problems
 -h, --help                              Print available options
 -i, --include                           Parse for inclusion
 -l, --lang                              Choose i18n language
@@ -14,8 +16,8 @@ Available options:
 -s, --strict                            Exit when there is an error or warning
                                         Override -q or --quiet
 -v, --version                           Print package version
-`, preset = new Set(['default', 'zhwiki', 'moegirl', 'llwiki']), { argv } = process, files = [];
-let include = false, quiet = false, strict = false, exit = false, nErr = 0, nWarn = 0, option, config, lang;
+`, preset = new Set((0, fs_1.readdirSync)('./config').filter(file => file.endsWith('.json')).map(file => file.slice(0, -5))), { argv } = process, files = [];
+let include = false, quiet = false, strict = false, exit = false, fixing = false, nErr = 0, nWarn = 0, nFixableErr = 0, nFixableWarn = 0, option, config, lang;
 /**
  * throw if `-c` or `--config` option is incorrect
  * @throws `Error` unrecognized config input
@@ -33,12 +35,12 @@ const throwOnConfig = () => {
  * @param n number of items
  * @param word item name
  */
-const plural = (n, word) => `${n} ${word}${n > 1 ? 's' : ''}`;
+const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`;
 /**
  * color the severity
  * @param severity problem severity
  */
-const coloredSeverity = (severity) => `\x1B[${severity === 'error' ? 31 : 33}m${severity}\x1B[0m`.padEnd(16);
+const coloredSeverity = (severity) => chalk[severity === 'error' ? 'red' : 'yellow'](severity.padEnd(7));
 for (let i = 2; i < argv.length; i++) {
     option = argv[i];
     switch (option) {
@@ -47,6 +49,9 @@ for (let i = 2; i < argv.length; i++) {
             config = argv[++i];
             throwOnConfig();
             break;
+        case '--fix':
+            fixing = true;
+            break;
         case '-h':
         case '--help':
             console.log(man);
@@ -105,28 +110,46 @@ if (quiet && strict) {
     console.error('-s or --strict will override -q or --quiet\n');
 }
 for (const file of files) {
-    const wikitext = (0, fs_1.readFileSync)(file, 'utf8');
-    let problems = Parser.parse(wikitext, include).lint();
-    const errors = problems.filter(({ severity }) => severity === 'error'), { length: nLocalErr } = errors, nLocalWarn = problems.length - nLocalErr;
+    let wikitext = (0, fs_1.readFileSync)(file, 'utf8'), problems = Parser.parse(wikitext, include).lint();
+    if (fixing && problems.some(({ fix }) => fix)) {
+        // 倒序修复，跳过嵌套的修复
+        const fixable = problems.map(({ fix }) => fix).filter(Boolean)
+            .sort(({ range: [aFrom, aTo] }, { range: [bFrom, bTo] }) => aTo === bTo ? bFrom - aFrom : bTo - aTo);
+        let start = Infinity;
+        for (const { range: [from, to], text } of fixable) {
+            if (to <= start) {
+                wikitext = `${wikitext.slice(0, from)}${text}${wikitext.slice(to)}`;
+                start = from;
+            }
+        }
+        void fs_1.promises.writeFile(file, wikitext);
+        problems = Parser.parse(wikitext, include).lint();
+    }
+    const errors = problems.filter(({ severity }) => severity === 'error'), fixable = problems.filter(({ fix }) => fix), nLocalErr = errors.length, nLocalWarn = problems.length - nLocalErr, nLocalFixableErr = fixable.filter(({ severity }) => severity === 'error').length, nLocalFixableWarn = fixable.length - nLocalFixableErr;
     if (quiet) {
         problems = errors;
     }
     else {
         nWarn += nLocalWarn;
+        nFixableWarn += nLocalFixableWarn;
     }
     if (problems.length > 0) {
-        console.error('\x1B[4m%s\x1B[0m', (0, path_1.resolve)(file));
-        const { length: maxLineChars } = String(Math.max(...problems.map(({ startLine }) => startLine))), { length: maxColChars } = String(Math.max(...problems.map(({ startCol }) => startCol)));
-        for (const { message, severity, startLine, startCol } of problems) {
-            console.error(`  ${String(startLine).padStart(maxLineChars)}:${String(startCol).padEnd(maxColChars)}  ${coloredSeverity(severity)}  ${message}`);
+        console.error(`\n${chalk.underline('%s')}`, (0, path_1.resolve)(file));
+        const maxLineChars = String(Math.max(...problems.map(({ startLine }) => startLine))).length, maxColChars = String(Math.max(...problems.map(({ startCol }) => startCol))).length, maxMessageChars = Math.max(...problems.map(({ message: { length } }) => length));
+        for (const { rule, message, severity, startLine, startCol } of problems) {
+            console.error(`  ${chalk.dim('%s:%s')}  %s  %s  ${chalk.dim('%s')}`, String(startLine).padStart(maxLineChars), String(startCol).padEnd(maxColChars), coloredSeverity(severity), message.padEnd(maxMessageChars), rule);
         }
-        console.error();
     }
     nErr += nLocalErr;
+    nFixableErr += nLocalFixableErr;
     exit ||= Boolean(nLocalErr || strict && nLocalWarn);
 }
 if (nErr || nWarn) {
-    console.error('\x1B[1;31m%s\x1B[0m\n', `✖ ${plural(nErr + nWarn, 'problem')} (${plural(nErr, 'error')}, ${plural(nWarn, 'warning')})`);
+    console.error(chalk.red.bold('%s'), `\n✖ ${plural(nErr + nWarn, 'problem')} (${plural(nErr, 'error')}, ${plural(nWarn, 'warning')})`);
+    if (nFixableErr || nFixableWarn) {
+        console.error(chalk.red.bold('%s'), `  ${plural(nFixableErr, 'error')} and ${plural(nFixableWarn, 'warning')} potentially fixable with the \`--fix\` option.`);
+    }
+    console.error();
 }
 if (exit) {
     process.exitCode = 1;

package/dist/lib/text.js

@@ -17,6 +17,13 @@ errorSyntax = new RegExp(`${source}|https?[:/]\\/+`, 'giu'), errorSyntaxUrl = ne
     '{': /[{}]/u,
     ']': /[[\]](?=[^[\]]*$)/u,
     '}': /[{}](?=[^{}]*$)/u,
+}, ruleMap = {
+    '<': 'tag-like',
+    '[': 'lonely-bracket',
+    '{': 'lonely-bracket',
+    ']': 'lonely-bracket',
+    '}': 'lonely-bracket',
+    h: 'lonely-http',
 }, disallowedTags = [
     'html',
     'head',
@@ -73,8 +80,11 @@ class AstText extends node_1.AstNode {
      */
     lint(start = this.getAbsoluteIndex()) {
         const { data, parentNode, nextSibling, previousSibling } = this;
+        if (!parentNode) {
+            return [];
+        }
         const { NowikiToken } = require('../src/nowiki');
-        const { type, name } = parentNode, nowiki = name === 'nowiki' || name === 'pre';
+        const { type, name } = parentNode, nowiki = name === 'nowiki' || name === 'pre', isHtmlAttrVal = type === 'attr-value' && parentNode.parentNode.type !== 'ext-attr';
         let errorRegex;
         if (type === 'ext-inner' && (name === 'pre' || parentNode instanceof NowikiToken)) {
             errorRegex = new RegExp(`<\\s*(?:\\/\\s*)${nowiki ? '' : '?'}(${name})\\b`, 'giu');
@@ -82,7 +92,7 @@ class AstText extends node_1.AstNode {
         else if (type === 'free-ext-link'
             || type === 'ext-link-url'
             || type === 'image-parameter' && name === 'link'
-            || type === 'attr-value') {
+            || isHtmlAttrVal) {
             errorRegex = errorSyntaxUrl;
         }
         else {
@@ -114,14 +124,15 @@ class AstText extends node_1.AstNode {
             else if (char === ']' && (index || length > 1)) {
                 errorRegex.lastIndex--;
             }
-            const startIndex = start + index, endIndex = startIndex + length, rootStr = String(root), nextChar = rootStr[endIndex], previousChar = rootStr[startIndex - 1], severity = length > 1 && (char !== '<' || !nowiki && /[\s/>]/u.test(nextChar ?? ''))
+            const startIndex = start + index, endIndex = startIndex + length, rootStr = String(root), nextChar = rootStr[endIndex], previousChar = rootStr[startIndex - 1], severity = length > 1 && !(char === '<' && (nowiki || !/[\s/>]/u.test(nextChar ?? ''))
+                || isHtmlAttrVal && (char === '[' || char === ']'))
                 || char === '{' && (nextChar === char || previousChar === '-')
                 || char === '}' && (previousChar === char || nextChar === '-')
                 || char === '[' && (nextChar === char
                     || type === 'ext-link-text'
-                    || !data.slice(index + 1).trim() && nextType === 'free-ext-link')
+                    || nextType === 'free-ext-link' && !data.slice(index + 1).trim())
                 || char === ']' && (previousChar === char
-                    || !data.slice(0, index).trim() && previousType === 'free-ext-link')
+                    || previousType === 'free-ext-link' && !data.slice(0, index).includes(']'))
                 ? 'error'
                 : 'warning';
             const leftBracket = char === '{' || char === '[', rightBracket = char === ']' || char === '}';
@@ -142,8 +153,8 @@ class AstText extends node_1.AstNode {
                     }
                 }
             }
-            const lines = data.slice(0, index).split('\n'), startLine = lines.length + top - 1, line = lines[lines.length - 1], startCol = lines.length === 1 ? left + line.length : line.length;
-            errors.push({
+            const lines = data.slice(0, index).split('\n'), startLine = lines.length + top - 1, line = lines[lines.length - 1], startCol = lines.length === 1 ? left + line.length : line.length, e = {
+                rule: ruleMap[char],
                 message: index_1.default.msg('lonely "$1"', char === 'h' ? error : char),
                 severity,
                 startIndex,
@@ -152,7 +163,45 @@ class AstText extends node_1.AstNode {
                 endLine: startLine,
                 startCol,
                 endCol: startCol + length,
-            });
+            };
+            if (char === '<') {
+                e.suggestions = [
+                    {
+                        desc: 'escape',
+                        range: [startIndex, startIndex + 1],
+                        text: '&lt;',
+                    },
+                ];
+            }
+            else if (char === 'h'
+                && !(type === 'ext-link-text' || type === 'link-text')
+                && /[\p{L}\d_]/u.test(previousChar || '')) {
+                e.suggestions = [
+                    {
+                        desc: 'whitespace',
+                        range: [startIndex, startIndex],
+                        text: ' ',
+                    },
+                ];
+            }
+            else if (char === '[' && type === 'ext-link-text') {
+                const i = parentNode.getAbsoluteIndex() + String(parentNode).length;
+                e.suggestions = [
+                    {
+                        desc: 'escape',
+                        range: [i, i + 1],
+                        text: '&#93;',
+                    },
+                ];
+            }
+            else if (char === ']' && previousType === 'free-ext-link' && severity === 'error') {
+                const i = start - String(previousSibling).length;
+                e.fix = {
+                    range: [i, i],
+                    text: '[',
+                };
+            }
+            errors.push(e);
         }
         return errors;
     }

package/dist/src/arg.js

@@ -55,22 +55,40 @@ class ArgToken extends index_2.Token {
     }
     /** @override */
     lint(start = this.getAbsoluteIndex()) {
+        const { childNodes: [argName, argDefault, ...rest] } = this;
         if (!this.getAttribute('include')) {
-            return [(0, lint_1.generateForSelf)(this, { start }, 'unexpected template argument')];
+            const e = (0, lint_1.generateForSelf)(this, { start }, 'no-arg', 'unexpected template argument');
+            if (argDefault) {
+                e.fix = {
+                    range: [start, e.endIndex],
+                    text: argDefault.text(),
+                };
+            }
+            return [e];
         }
-        const { childNodes: [argName, argDefault, ...rest] } = this, errors = argName.lint(start + 3);
+        const errors = argName.lint(start + 3);
         if (argDefault) {
             errors.push(...argDefault.lint(start + 4 + String(argName).length));
         }
         if (rest.length > 0) {
             const rect = { start, ...this.getRootNode().posFromIndex(start) };
             errors.push(...rest.map(child => {
-                const error = (0, lint_1.generateForChild)(child, rect, 'invisible content inside triple braces');
-                return {
-                    ...error,
-                    startIndex: error.startIndex - 1,
-                    startCol: error.startCol - 1,
-                };
+                const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', 'invisible content inside triple braces');
+                e.startIndex--;
+                e.startCol--;
+                e.suggestions = [
+                    {
+                        desc: 'remove',
+                        range: [e.startIndex, e.endIndex],
+                        text: '',
+                    },
+                    {
+                        desc: 'escape',
+                        range: [e.startIndex, e.startIndex + 1],
+                        text: '{{!}}',
+                    },
+                ];
+                return e;
             }));
         }
         return errors;

package/dist/src/attribute.js

@@ -260,12 +260,25 @@ class AttributeToken extends index_2.Token {
         if (!balanced) {
             const root = this.getRootNode();
             rect = { start, ...root.posFromIndex(start) };
-            const e = (0, lint_1.generateForChild)(lastChild, rect, index_1.default.msg('unclosed $1', 'quotes'), 'warning');
-            errors.push({
-                ...e,
-                startIndex: e.startIndex - 1,
-                startCol: e.startCol - 1,
-            });
+            const e = (0, lint_1.generateForChild)(lastChild, rect, 'unclosed-quote', index_1.default.msg('unclosed $1', 'quotes'), 'warning');
+            e.startIndex--;
+            e.startCol--;
+            const fix = {
+                range: [e.endIndex, e.endIndex],
+                text: this.#quotes[0],
+            };
+            if (lastChild.childNodes.some(child => child.type === 'text' && /\s/u.test(child.text()))) {
+                e.suggestions = [
+                    {
+                        desc: 'quote',
+                        ...fix,
+                    },
+                ];
+            }
+            else {
+                e.fix = fix;
+            }
+            errors.push(e);
         }
         const attrs = extAttrs[tag];
         if (attrs && !attrs.has(name)
@@ -274,19 +287,32 @@ class AttributeToken extends index_2.Token {
                 && !/^(?:xmlns:[\w:.-]+|data-[^:]*)$/u.test(name)
                 && (tag === 'meta' || tag === 'link' || !commonHtmlAttrs.has(name))) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(firstChild, rect, 'illegal attribute name'));
+            errors.push((0, lint_1.generateForChild)(firstChild, rect, 'illegal-attr', 'illegal attribute name'));
         }
         else if (obsoleteAttrs[tag]?.has(name)) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(firstChild, rect, 'obsolete attribute', 'warning'));
+            errors.push((0, lint_1.generateForChild)(firstChild, rect, 'obsolete-attr', 'obsolete attribute', 'warning'));
         }
         else if (name === 'style' && typeof value === 'string' && insecureStyle.test(value)) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(lastChild, rect, 'insecure style'));
+            errors.push((0, lint_1.generateForChild)(lastChild, rect, 'insecure-style', 'insecure style'));
         }
         else if (name === 'tabindex' && typeof value === 'string' && value.trim() !== '0') {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(lastChild, rect, 'nonzero tabindex'));
+            const e = (0, lint_1.generateForChild)(lastChild, rect, 'illegal-attr', 'nonzero tabindex');
+            e.suggestions = [
+                {
+                    desc: 'remove',
+                    range: [start, e.endIndex],
+                    text: '',
+                },
+                {
+                    desc: '0 tabindex',
+                    range: [e.startIndex, e.endIndex],
+                    text: '0',
+                },
+            ];
+            errors.push(e);
         }
         return errors;
     }

package/dist/src/attributes.js

@@ -100,13 +100,23 @@ class AttributesToken extends index_2.Token {
         let rect;
         if (parentNode?.type === 'html' && parentNode.closing && this.text().trim()) {
             rect = { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForSelf)(this, rect, 'attributes of a closing tag'));
+            const e = (0, lint_1.generateForSelf)(this, rect, 'no-ignored', 'attributes of a closing tag');
+            e.fix = { range: [start, e.endIndex], text: '' };
+            errors.push(e);
         }
         for (let i = 0; i < length; i++) {
             const attr = childNodes[i];
             if (attr instanceof atom_1.AtomToken && attr.text().trim()) {
                 rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-                errors.push((0, lint_1.generateForChild)(attr, rect, 'containing invalid attribute'));
+                const e = (0, lint_1.generateForChild)(attr, rect, 'no-ignored', 'containing invalid attribute');
+                e.suggestions = [
+                    {
+                        desc: 'remove',
+                        range: [e.startIndex, e.endIndex],
+                        text: ' ',
+                    },
+                ];
+                errors.push(e);
             }
             else if (attr instanceof attribute_1.AttributeToken) {
                 const { name } = attr;
@@ -122,7 +132,7 @@ class AttributesToken extends index_2.Token {
         if (duplicated.size > 0) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
             for (const key of duplicated) {
-                errors.push(...attrs.get(key).map(attr => (0, lint_1.generateForChild)(attr, rect, index_1.default.msg('duplicated $1 attribute', key))));
+                errors.push(...attrs.get(key).map(attr => (0, lint_1.generateForChild)(attr, rect, 'no-duplicate', index_1.default.msg('duplicated $1 attribute', key))));
             }
         }
         return errors;

package/dist/src/converterFlags.js

@@ -56,7 +56,23 @@ class ConverterFlagsToken extends index_2.Token {
                 && !variantFlags.has(flag)
                 && !unknownFlags.has(flag)
                 && (variantFlags.size > 0 || !validFlags.has(flag))) {
-                errors.push((0, lint_1.generateForChild)(child, rect, 'invalid conversion flag'));
+                const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', 'invalid conversion flag');
+                if (variantFlags.size === 0 && definedFlags.has(flag.toUpperCase())) {
+                    e.fix = {
+                        range: [e.startIndex, e.endIndex],
+                        text: flag.toUpperCase(),
+                    };
+                }
+                else {
+                    e.suggestions = [
+                        {
+                            desc: 'remove',
+                            range: [e.startIndex, e.endIndex],
+                            text: '',
+                        },
+                    ];
+                }
+                errors.push(e);
             }
         }
         return errors;

package/dist/src/extLink.js

@@ -53,7 +53,7 @@ class ExtLinkToken extends index_2.Token {
     lint(start = this.getAbsoluteIndex()) {
         const errors = super.lint(start);
         if (this.length === 1 && this.closest('heading-title')) {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'variable anchor in a section header'));
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'var-anchor', 'variable anchor in a section header'));
         }
         return errors;
     }

package/dist/src/gallery.js

@@ -58,6 +58,7 @@ class GalleryToken extends index_2.Token {
             const child = this.childNodes[i], str = String(child), { length } = str, trimmed = str.trim(), startLine = top + i, startCol = i ? 0 : left;
             if (child.type === 'noinclude' && trimmed && !/^<!--.*-->$/u.test(trimmed)) {
                 errors.push({
+                    rule: 'no-ignored',
                     message: index_1.default.msg('invalid content in <$1>', 'gallery'),
                     severity: 'error',
                     startIndex: start,
@@ -66,6 +67,18 @@ class GalleryToken extends index_2.Token {
                     endLine: startLine,
                     startCol,
                     endCol: startCol + length,
+                    suggestions: [
+                        {
+                            desc: 'remove',
+                            range: [start, start + length],
+                            text: '',
+                        },
+                        {
+                            desc: 'comment',
+                            range: [start, start + length],
+                            text: `<!--${str}-->`,
+                        },
+                    ],
                 });
             }
             else if (child.type !== 'noinclude' && child.type !== 'text') {

package/dist/src/heading.js

@@ -57,23 +57,23 @@ class HeadingToken extends index_2.Token {
         let rect;
         if (this.level === 1) {
             rect = { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(firstChild, rect, '<h1>'));
+            errors.push((0, lint_1.generateForChild)(firstChild, rect, 'h1', '<h1>'));
         }
         if (innerStr.startsWith('=') || innerStr.endsWith('=')) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(firstChild, rect, index_1.default.msg('unbalanced $1 in a section header', '"="')));
+            errors.push((0, lint_1.generateForChild)(firstChild, rect, 'unbalanced-header', index_1.default.msg('unbalanced $1 in a section header', '"="')));
         }
         if (this.closest('html-attrs, table-attrs')) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForSelf)(this, rect, 'section header in a HTML tag'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'parsing-order', 'section header in a HTML tag'));
         }
         if (boldQuotes.length % 2) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(boldQuotes[boldQuotes.length - 1], { ...rect, start: start + level, left: rect.left + level }, index_1.default.msg('unbalanced $1 in a section header', 'bold apostrophes')));
+            errors.push((0, lint_1.generateForChild)(boldQuotes[boldQuotes.length - 1], { ...rect, start: start + level, left: rect.left + level }, 'format-leakage', index_1.default.msg('unbalanced $1 in a section header', 'bold apostrophes')));
         }
         if (italicQuotes.length % 2) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(italicQuotes[italicQuotes.length - 1], { start: start + level }, index_1.default.msg('unbalanced $1 in a section header', 'italic apostrophes')));
+            errors.push((0, lint_1.generateForChild)(italicQuotes[italicQuotes.length - 1], { start: start + level }, 'format-leakage', index_1.default.msg('unbalanced $1 in a section header', 'italic apostrophes')));
         }
         return errors;
     }

package/dist/src/html.js

@@ -79,13 +79,14 @@ class HtmlToken extends index_2.Token {
         const errors = super.lint(start);
         let refError;
         if (this.name === 'h1' && !this.closing) {
-            refError = (0, lint_1.generateForSelf)(this, { start }, '<h1>');
+            refError = (0, lint_1.generateForSelf)(this, { start }, 'h1', '<h1>');
             errors.push(refError);
         }
         if (this.closest('table-attrs')) {
-            refError ??= (0, lint_1.generateForSelf)(this, { start }, '');
+            refError ??= (0, lint_1.generateForSelf)(this, { start }, 'h1', '');
             errors.push({
                 ...refError,
+                rule: 'parsing-order',
                 message: index_1.default.msg('HTML tag in table attributes'),
             });
         }
@@ -95,8 +96,8 @@ class HtmlToken extends index_2.Token {
         catch (e) {
             if (e instanceof SyntaxError) {
                 const { message } = e;
-                refError ??= (0, lint_1.generateForSelf)(this, { start }, '');
-                const [msg] = message.split(':'), error = { ...refError, message: index_1.default.msg(msg) };
+                refError ??= (0, lint_1.generateForSelf)(this, { start }, 'h1', '');
+                const [msg] = message.split(':'), error = { ...refError, rule: 'unmatched-tag', message: index_1.default.msg(msg) };
                 if (msg === 'unclosed tag' && !this.closest('heading-title')) {
                     if (formattingTags.has(this.name)) {
                         const childNodes = this.parentNode?.childNodes, i = childNodes?.indexOf(this);
@@ -113,22 +114,42 @@ class HtmlToken extends index_2.Token {
                     if (ancestor && magicWords.has(ancestor.name)) {
                         error.severity = 'warning';
                     }
+                    else {
+                        error.suggestions = [
+                            {
+                                desc: 'remove',
+                                range: [start, error.endIndex],
+                                text: '',
+                            },
+                        ];
+                    }
+                }
+                else if (msg === 'tag that is both closing and self-closing') {
+                    const { html: [, , voidTags] } = this.getAttribute('config');
+                    if (voidTags.includes(this.name)) {
+                        error.fix = {
+                            range: [start + 1, start + 2],
+                            text: '',
+                        };
+                    }
                 }
                 errors.push(error);
             }
         }
         if (obsoleteTags.has(this.name)) {
-            refError ??= (0, lint_1.generateForSelf)(this, { start }, '');
+            refError ??= (0, lint_1.generateForSelf)(this, { start }, 'h1', '');
             errors.push({
                 ...refError,
+                rule: 'obsolete-tag',
                 message: index_1.default.msg('obsolete HTML tag'),
                 severity: 'warning',
             });
         }
         if ((this.name === 'b' || this.name === 'strong') && this.closest('heading-title')) {
-            refError ??= (0, lint_1.generateForSelf)(this, { start }, '');
+            refError ??= (0, lint_1.generateForSelf)(this, { start }, 'h1', '');
             errors.push({
                 ...refError,
+                rule: 'bold-header',
                 message: index_1.default.msg('bold in section header'),
                 severity: 'warning',
             });

package/dist/src/imageParameter.js

@@ -102,10 +102,15 @@ class ImageParameterToken extends index_2.Token {
     lint(start = this.getAbsoluteIndex()) {
         const errors = super.lint(start), { link, name } = this;
         if (name === 'invalid') {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid gallery image parameter'));
+            const e = (0, lint_1.generateForSelf)(this, { start }, 'invalid-gallery', 'invalid gallery image parameter');
+            e.fix = {
+                range: [start, start + e.endIndex],
+                text: '',
+            };
+            errors.push(e);
         }
         else if (typeof link === 'object' && link.encoded) {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'unnecessary URL encoding in an internal link'));
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'url-encoding', 'unnecessary URL encoding in an internal link'));
         }
         return errors;
     }

package/dist/src/imagemap.js

@@ -92,10 +92,10 @@ class ImagemapToken extends index_2.Token {
             errors.push(...this.childNodes.filter(child => {
                 const str = String(child).trim();
                 return child.type === 'noinclude' && str && !str.startsWith('#');
-            }).map(child => (0, lint_1.generateForChild)(child, rect, 'invalid link in <imagemap>')));
+            }).map(child => (0, lint_1.generateForChild)(child, rect, 'invalid-imagemap', 'invalid link in <imagemap>')));
         }
         else {
-            errors.push((0, lint_1.generateForSelf)(this, rect, '<imagemap> without an image'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'invalid-imagemap', '<imagemap> without an image'));
         }
         return errors;
     }

package/dist/src/link/base.js

@@ -76,20 +76,40 @@ class LinkBaseToken extends index_2.Token {
         let rect;
         if (target.childNodes.some(({ type }) => type === 'template')) {
             rect = { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(target, rect, 'template in an internal link target', 'warning'));
+            errors.push((0, lint_1.generateForChild)(target, rect, 'unknown-page', 'template in an internal link target', 'warning'));
         }
         if (encoded) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(target, rect, 'unnecessary URL encoding in an internal link'));
+            errors.push((0, lint_1.generateForChild)(target, rect, 'url-encoding', 'unnecessary URL encoding in an internal link'));
         }
-        if ((linkType === 'link' || linkType === 'category')
-            && linkText?.childNodes.some(({ type, data }) => type === 'text' && data.includes('|'))) {
-            rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(linkText, rect, 'additional "|" in the link text', 'warning'));
+        if (linkType === 'link' || linkType === 'category') {
+            const textNode = linkText?.childNodes.find((c) => c.type === 'text' && c.data.includes('|'));
+            if (textNode) {
+                rect ??= { start, ...this.getRootNode().posFromIndex(start) };
+                const e = (0, lint_1.generateForChild)(linkText, rect, 'pipe-like', 'additional "|" in the link text', 'warning');
+                e.suggestions = [
+                    {
+                        desc: 'escape',
+                        range: [
+                            e.startIndex + textNode.getRelativeIndex(),
+                            e.startIndex + textNode.getRelativeIndex() + textNode.data.length,
+                        ],
+                        text: textNode.data.replace(/\|/gu, '|'),
+                    },
+                ];
+                errors.push(e);
+            }
         }
-        else if (linkType !== 'link' && fragment !== undefined) {
+        if (linkType !== 'link' && fragment !== undefined) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(target, rect, 'useless fragment'));
+            const e = (0, lint_1.generateForChild)(target, rect, 'no-ignored', 'useless fragment'), textNode = target.childNodes.find((c) => c.type === 'text' && c.data.includes('#'));
+            if (textNode) {
+                e.fix = {
+                    range: [e.startIndex + textNode.getRelativeIndex() + textNode.data.indexOf('#'), e.endIndex],
+                    text: '',
+                };
+            }
+            errors.push(e);
         }
         return errors;
     }

package/dist/src/link/file.js

@@ -58,7 +58,7 @@ class FileToken extends base_1.LinkBaseToken {
             return visibleNodes.length !== 1 || visibleNodes[0].type !== 'arg';
         }), keys = [...new Set(args.map(({ name }) => name))].filter(key => key !== 'invalid'), frameKeys = keys.filter(key => frame.has(key)), horizAlignKeys = keys.filter(key => horizAlign.has(key)), vertAlignKeys = keys.filter(key => vertAlign.has(key));
         if (this.closest('ext-link-text') && this.getValue('link')?.trim() !== '') {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'internal link in an external link'));
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'nested-link', 'internal link in an external link'));
         }
         if (args.length === keys.length
             && frameKeys.length < 2
@@ -72,7 +72,7 @@ class FileToken extends base_1.LinkBaseToken {
          * @param msg 消息键
          * @param p1 替换$1
          */
-        const generate = (msg, p1) => (arg) => (0, lint_1.generateForChild)(arg, rect, index_1.default.msg(`${msg} image $1 parameter`, p1));
+        const generate = (msg, p1) => (arg) => (0, lint_1.generateForChild)(arg, rect, 'no-duplicate', index_1.default.msg(`${msg} image $1 parameter`, p1));
         for (const key of keys) {
             let relevantArgs = args.filter(({ name }) => name === key);
             if (key === 'caption') {

package/dist/src/link/galleryImage.js

@@ -40,7 +40,7 @@ class GalleryImageToken extends file_1.FileToken {
     lint(start = this.getAbsoluteIndex()) {
         const errors = super.lint(start), { ns, interwiki } = this.getAttribute('title');
         if (interwiki || ns !== 6) {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid gallery image'));
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid-gallery', 'invalid gallery image'));
         }
         return errors;
     }

package/dist/src/link/index.js

@@ -13,7 +13,7 @@ class LinkToken extends base_1.LinkBaseToken {
     lint(start = this.getAbsoluteIndex()) {
         const errors = super.lint(start);
         if (this.closest('ext-link-text')) {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'internal link in an external link'));
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'nested-link', 'internal link in an external link'));
         }
         return errors;
     }

package/dist/src/magicLink.js

@@ -27,20 +27,44 @@ class MagicLinkToken extends index_2.Token {
                 continue;
             }
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            const refError = (0, lint_1.generateForChild)(child, rect, '', 'warning');
+            const refError = (0, lint_1.generateForChild)(child, rect, 'unterminated-url', '', 'warning');
             regexGlobal.lastIndex = 0;
             for (let mt = regexGlobal.exec(data); mt; mt = regexGlobal.exec(data)) {
-                const { index, 0: s } = mt, lines = data.slice(0, index).split('\n'), top = lines.length, left = lines[top - 1].length, startIndex = refError.startIndex + index, startLine = refError.startLine + top - 1, startCol = top === 1 ? refError.startCol + left : left;
-                errors.push({
+                const { index, 0: s } = mt, lines = data.slice(0, index).split('\n'), top = lines.length, left = lines[top - 1].length, startIndex = refError.startIndex + index, startLine = refError.startLine + top - 1, startCol = top === 1 ? refError.startCol + left : left, pipe = s.startsWith('|');
+                const e = {
                     ...refError,
-                    message: index_1.default.msg('$1 in URL', s.startsWith('|') ? '"|"' : 'full-width punctuation'),
+                    message: index_1.default.msg('$1 in URL', pipe ? '"|"' : 'full-width punctuation'),
                     startIndex,
                     endIndex: startIndex + s.length,
                     startLine,
                     endLine: startLine,
                     startCol,
                     endCol: startCol + s.length,
-                });
+                };
+                if (!pipe) {
+                    e.suggestions = [
+                        {
+                            desc: 'whitespace',
+                            range: [startIndex, startIndex],
+                            text: ' ',
+                        },
+                        {
+                            desc: 'escape',
+                            range: [startIndex, e.endIndex],
+                            text: encodeURI(s),
+                        },
+                    ];
+                }
+                else if (s.length === 1) {
+                    e.suggestions = [
+                        {
+                            desc: 'whitespace',
+                            range: [startIndex, startIndex + 1],
+                            text: ' ',
+                        },
+                    ];
+                }
+                errors.push(e);
             }
         }
         return errors;

package/dist/src/nested.js

@@ -50,7 +50,20 @@ class NestedToken extends index_2.Token {
                 return str && !/^<!--.*-->$/su.test(str);
             }).map(child => {
                 rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-                return (0, lint_1.generateForChild)(child, rect, index_1.default.msg('invalid content in <$1>', this.name));
+                const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', index_1.default.msg('invalid content in <$1>', this.name));
+                e.suggestions = [
+                    {
+                        desc: 'remove',
+                        range: [e.startIndex, e.endIndex],
+                        text: '',
+                    },
+                    {
+                        desc: 'comment',
+                        range: [e.startIndex, e.startIndex],
+                        text: `<!--${String(child)}-->`,
+                    },
+                ];
+                return e;
             }),
         ];
     }

package/dist/src/nowiki/comment.js

@@ -20,7 +20,15 @@ class CommentToken extends (0, hidden_1.hiddenToken)(base_1.NowikiBaseToken) {
     }
     /** @override */
     lint(start = this.getAbsoluteIndex()) {
-        return this.closed ? [] : [(0, lint_1.generateForSelf)(this, { start }, index_1.default.msg('unclosed $1', 'HTML comment'))];
+        if (this.closed) {
+            return [];
+        }
+        const e = (0, lint_1.generateForSelf)(this, { start }, 'unclosed-comment', index_1.default.msg('unclosed $1', 'HTML comment'));
+        e.fix = {
+            range: [e.endIndex, e.endIndex],
+            text: '-->',
+        };
+        return [e];
     }
     /** @private */
     toString() {

package/dist/src/nowiki/index.js

@@ -10,9 +10,15 @@ class NowikiToken extends base_1.NowikiBaseToken {
     /** @override */
     lint(start = this.getAbsoluteIndex()) {
         const { name, firstChild: { data } } = this;
-        return (name === 'templatestyles' || name === 'section') && data
-            ? [(0, lint_1.generateForSelf)(this, { start }, index_1.default.msg('nothing should be in <$1>', name))]
-            : super.lint(start);
+        if ((name === 'templatestyles' || name === 'section') && data) {
+            const e = (0, lint_1.generateForSelf)(this, { start }, 'void-ext', index_1.default.msg('nothing should be in <$1>', name));
+            e.fix = {
+                range: [start - 1, e.endIndex + name.length + 3],
+                text: '/>',
+            };
+            return [e];
+        }
+        return super.lint(start);
     }
 }
 exports.NowikiToken = NowikiToken;

package/dist/src/nowiki/quote.js

@@ -20,7 +20,7 @@ class QuoteToken extends base_1.NowikiBaseToken {
         const { previousSibling, nextSibling, bold } = this, message = index_1.default.msg('lonely "$1"', `'`), errors = [];
         let refError;
         if (previousSibling?.type === 'text' && previousSibling.data.endsWith(`'`)) {
-            refError = (0, lint_1.generateForSelf)(this, { start }, message);
+            refError = (0, lint_1.generateForSelf)(this, { start }, 'lonely-apos', message);
             const { startIndex: endIndex, startLine: endLine, startCol: endCol } = refError, [, { length }] = /(?:^|[^'])('+)$/u.exec(previousSibling.data), startIndex = start - length;
             errors.push({
                 ...refError,
@@ -29,10 +29,17 @@ class QuoteToken extends base_1.NowikiBaseToken {
                 startCol: endCol - length,
                 endLine,
                 endCol,
+                suggestions: [
+                    {
+                        desc: 'escape',
+                        range: [startIndex, endIndex],
+                        text: '''.repeat(length),
+                    },
+                ],
             });
         }
         if (nextSibling?.type === 'text' && nextSibling.data.startsWith(`'`)) {
-            refError ??= (0, lint_1.generateForSelf)(this, { start }, message);
+            refError ??= (0, lint_1.generateForSelf)(this, { start }, 'lonely-apos', message);
             const { endIndex: startIndex, endLine: startLine, endCol: startCol } = refError, [{ length }] = /^'+/u.exec(nextSibling.data), endIndex = startIndex + length;
             errors.push({
                 ...refError,
@@ -41,12 +48,20 @@ class QuoteToken extends base_1.NowikiBaseToken {
                 startLine,
                 startCol,
                 endCol: startCol + length,
+                suggestions: [
+                    {
+                        desc: 'escape',
+                        range: [startIndex, endIndex],
+                        text: '''.repeat(length),
+                    },
+                ],
             });
         }
         if (bold && this.closest('heading-title')) {
-            refError ??= (0, lint_1.generateForSelf)(this, { start }, message);
+            refError ??= (0, lint_1.generateForSelf)(this, { start }, 'lonely-apos', message);
             errors.push({
                 ...refError,
+                rule: 'bold-header',
                 message: index_1.default.msg('bold in section header'),
                 severity: 'warning',
             });

package/dist/src/paramTag/index.js

@@ -39,7 +39,15 @@ class ParamTagToken extends index_2.Token {
             return str && !(i >= 0 ? /^[a-z]+(?:\[\])?\s*(?:=|$)/iu : /^[a-z]+(?:\[\])?\s*=/iu).test(str);
         }).map(child => {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            return (0, lint_1.generateForChild)(child, rect, index_1.default.msg('invalid parameter of <$1>', this.name));
+            const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', index_1.default.msg('invalid parameter of <$1>', this.name));
+            e.suggestions = [
+                {
+                    desc: 'remove',
+                    range: [e.startIndex, e.endIndex],
+                    text: '',
+                },
+            ];
+            return e;
         });
     }
 }

package/dist/src/parameter.js

@@ -60,15 +60,17 @@ class ParameterToken extends index_2.Token {
         /https?:\/\/(?:\[[\da-f:.]+\]|[^[\]<>"\t\n\p{Zs}])(?:[^[\]<>"\0\t\n\p{Zs}]|\0\d+c\x7F)*$/iu;
         const errors = super.lint(start), { firstChild } = this, link = new RegExp(`https?://${string_1.extUrlCharFirst}${string_1.extUrlChar}$`, 'iu').exec(firstChild.text())?.[0];
         if (link && new URL(link).search) {
-            const e = (0, lint_1.generateForChild)(firstChild, { start }, 'unescaped query string in an anonymous parameter');
-            errors.push({
-                ...e,
-                startIndex: e.endIndex,
-                endIndex: e.endIndex + 1,
-                startLine: e.endLine,
-                startCol: e.endCol,
-                endCol: e.endCol + 1,
-            });
+            const e = (0, lint_1.generateForChild)(firstChild, { start }, 'unescaped', 'unescaped query string in an anonymous parameter');
+            e.startIndex = e.endIndex;
+            e.startLine = e.endLine;
+            e.startCol = e.endCol;
+            e.endIndex++;
+            e.endCol++;
+            e.fix = {
+                range: [e.startIndex, e.endIndex],
+                text: '{{=}}',
+            };
+            errors.push(e);
         }
         return errors;
     }

package/dist/src/table/index.js

@@ -28,7 +28,7 @@ class TableToken extends trBase_1.TrBaseToken {
     lint(start = this.getAbsoluteIndex()) {
         const errors = super.lint(start);
         if (!this.closed) {
-            errors.push((0, lint_1.generateForChild)(this.firstChild, { start }, index_1.default.msg('unclosed $1', 'table')));
+            errors.push((0, lint_1.generateForChild)(this.firstChild, { start }, 'unclosed-table', index_1.default.msg('unclosed $1', 'table')));
         }
         return errors;
     }

package/dist/src/table/td.js

@@ -81,7 +81,24 @@ class TdToken extends base_1.TableBaseToken {
             if (child.type === 'text') {
                 const { data } = child;
                 if (data.includes('|')) {
-                    errors.push((0, lint_1.generateForChild)(child, { start }, 'additional "|" in a table cell', data.includes('||') ? 'error' : 'warning'));
+                    const isError = data.includes('||'), e = (0, lint_1.generateForChild)(child, { start }, 'pipe-like', 'additional "|" in a table cell', isError ? 'error' : 'warning');
+                    if (isError) {
+                        const syntax = { caption: '|+', td: '|', th: '!' }[this.subtype];
+                        e.fix = {
+                            range: [e.startIndex, e.endIndex],
+                            text: data.replace(/\|\|/gu, `\n${syntax}`),
+                        };
+                    }
+                    else {
+                        e.suggestions = [
+                            {
+                                desc: 'escape',
+                                range: [e.startIndex, e.endIndex],
+                                text: data.replace(/\|/gu, '|'),
+                            },
+                        ];
+                    }
+                    errors.push(e);
                 }
             }
         }

package/dist/src/table/trBase.js

@@ -26,14 +26,12 @@ class TrBaseToken extends base_1.TableBaseToken {
             }
             catch { }
         }
-        const error = (0, lint_1.generateForChild)(inter, { start }, 'content to be moved out from the table');
-        errors.push({
-            ...error,
-            severity: first.type === 'template' ? 'warning' : 'error',
-            startIndex: error.startIndex + 1,
-            startLine: error.startLine + 1,
-            startCol: 0,
-        });
+        const error = (0, lint_1.generateForChild)(inter, { start }, 'fostered-content', 'content to be moved out from the table');
+        error.severity = first.type === 'template' ? 'warning' : 'error';
+        error.startIndex++;
+        error.startLine++;
+        error.startCol = 0;
+        errors.push(error);
         return errors;
     }
 }

package/dist/src/tagPair/ext.js

@@ -124,11 +124,11 @@ class ExtToken extends index_3.TagPairToken {
         let rect;
         if (this.name !== 'nowiki' && this.closest('html-attrs, table-attrs')) {
             rect = { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForSelf)(this, rect, 'extension tag in HTML tag attributes'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'parsing-order', 'extension tag in HTML tag attributes'));
         }
         if (this.name === 'ref' && this.closest('heading-title')) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForSelf)(this, rect, 'variable anchor in a section header'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'var-anchor', 'variable anchor in a section header'));
         }
         return errors;
     }

package/dist/src/tagPair/include.js

@@ -22,7 +22,15 @@ class IncludeToken extends (0, hidden_1.hiddenToken)(index_2.TagPairToken) {
     }
     /** @override */
     lint(start = this.getAbsoluteIndex()) {
-        return this.closed ? [] : [(0, lint_1.generateForSelf)(this, { start }, index_1.default.msg('unclosed $1', `<${this.name}>`))];
+        if (this.closed) {
+            return [];
+        }
+        const e = (0, lint_1.generateForSelf)(this, { start }, 'unclosed-comment', index_1.default.msg('unclosed $1', `<${this.name}>`));
+        e.fix = {
+            range: [e.endIndex, e.endIndex],
+            text: `</${this.name}>`,
+        };
+        return [e];
     }
 }
 exports.IncludeToken = IncludeToken;

package/dist/src/transclude.js

@@ -166,21 +166,28 @@ class TranscludeToken extends index_2.Token {
         const title = this.#getTitle();
         if (title.fragment !== undefined) {
             rect = { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(childNodes[type === 'template' ? 0 : 1], rect, 'useless fragment'));
+            const child = childNodes[type === 'template' ? 0 : 1], e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', 'useless fragment'), textNode = child.childNodes.find((c) => c.type === 'text' && c.data.includes('#'));
+            if (textNode) {
+                e.fix = {
+                    range: [e.startIndex + textNode.getRelativeIndex() + textNode.data.indexOf('#'), e.endIndex],
+                    text: '',
+                };
+            }
+            errors.push(e);
         }
         if (!title.valid) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(childNodes[1], rect, 'illegal module name'));
+            errors.push((0, lint_1.generateForChild)(childNodes[1], rect, 'invalid-invoke', 'illegal module name'));
         }
         if (type === 'magic-word' && length === 2) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForSelf)(this, rect, 'missing module function'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'invalid-invoke', 'missing module function'));
             return errors;
         }
         const duplicatedArgs = this.getDuplicatedArgs();
         if (duplicatedArgs.length > 0) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push(...duplicatedArgs.flatMap(([, args]) => args).map(arg => (0, lint_1.generateForChild)(arg, rect, 'duplicated parameter')));
+            errors.push(...duplicatedArgs.flatMap(([, args]) => args).map(arg => (0, lint_1.generateForChild)(arg, rect, 'no-duplicate', 'duplicated parameter')));
         }
         return errors;
     }

package/dist/util/diff.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.info = exports.error = exports.diff = exports.cmd = void 0;
 const fs = require("fs/promises");
 const child_process_1 = require("child_process");
+const chalk = require("chalk");
 process.on('unhandledRejection', e => {
     console.error(e);
 });
@@ -72,11 +73,11 @@ const diff = async (oldStr, newStr, uid = -1) => {
 exports.diff = diff;
 /** @implements */
 const error = (msg, ...args) => {
-    console.error('\x1B[31m%s\x1B[0m', msg, ...args);
+    console.error(chalk.red(msg), ...args);
 };
 exports.error = error;
 /** @implements */
 const info = (msg, ...args) => {
-    console.info('\x1B[32m%s\x1B[0m', msg, ...args);
+    console.info(chalk.green(msg), ...args);
 };
 exports.info = info;

package/dist/util/lint.js

@@ -6,9 +6,10 @@ const index_1 = require("../index");
  * 生成lint函数
  * @param func lint函数
  */
-const factory = (func) => (token, boundingRect, msg, severity = 'error') => {
+const factory = (func) => (token, boundingRect, rule, msg, severity = 'error') => {
     const { start } = boundingRect, { top, left } = 'top' in boundingRect ? boundingRect : token.getRootNode().posFromIndex(start), { offsetHeight, offsetWidth } = token, { startIndex, startLine, startCol } = func(token, start, top, left);
     return {
+        rule,
         message: index_1.default.msg(msg),
         severity,
         startIndex,

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "wikilint",
-	"version": "2.4.4",
+	"version": "2.5.0",
 	"description": "A Node.js linter for MediaWiki markup",
 	"keywords": [
 		"mediawiki",
@@ -51,6 +51,7 @@
 		"@typescript-eslint/eslint-plugin": "^6.19.1",
 		"@typescript-eslint/parser": "^6.19.1",
 		"ajv-cli": "^5.0.0",
+		"chalk": "^4.1.2",
 		"eslint": "^8.56.0",
 		"eslint-plugin-es-x": "^7.5.0",
 		"eslint-plugin-eslint-comments": "^3.2.0",