wikiparser-node 1.4.4 → 1.4.5

package/README.en.md

@@ -8,11 +8,11 @@
 
 # Introduction
 
-wikiparser-node is an offline [Wikitext](https://www.mediawiki.org/wiki/Wikitext) parser developed by Bhsd for the [Node.js](https://nodejs.org/) environment. It can parse almost all wiki syntax and generate an [Abstract Syntax Tree (AST)](https://en.wikipedia.org/wiki/Abstract_syntax_tree) ([Try it online](https://bhsd-harry.github.io/wikiparser-node/#editor)). It also allows for easy querying and modification of the AST, and returns the modified wikitext.
+WikiParser-Node is an offline [Wikitext](https://www.mediawiki.org/wiki/Wikitext) parser developed by Bhsd for the [Node.js](https://nodejs.org/) environment. It can parse almost all wiki syntax and generate an [Abstract Syntax Tree (AST)](https://en.wikipedia.org/wiki/Abstract_syntax_tree) ([Try it online](https://bhsd-harry.github.io/wikiparser-node/#editor)). It also allows for easy querying and modification of the AST, and returns the modified wikitext.
 
 # Other Versions
 
-## Mini (also known as [wikilint](https://www.npmjs.com/package/wikilint))
+## Mini (also known as [WikiLint](https://www.npmjs.com/package/wikilint))
 
 This version provides a [CLI](https://en.wikipedia.org/wiki/Command-line_interface), but only retains the parsing functionality and linting functionality. The parsed AST cannot be modified. It is used in the [eslint-plugin-wikitext](https://www.npmjs.com/package/eslint-plugin-wikitext) plugin.
 
@@ -24,7 +24,7 @@ A browser-compatible version, which can be used for code highlighting or as a li
 
 ## Node.js
 
-Please install the corresponding version as needed (`wikiparser-node` or `wikilint`), for example:
+Please install the corresponding version as needed (`WikiParser-Node` or `WikiLint`), for example:
 
 ```sh
 npm i wikiparser-node

package/README.md

@@ -8,11 +8,11 @@
 
 # 简介
 
-wikiparser-node 是一款由 Bhsd 开发的基于 [Node.js](https://nodejs.org/) 环境的离线[维基文本](https://www.mediawiki.org/wiki/Wikitext)语法解析器，可以解析几乎全部的维基语法并生成[语法树](https://en.wikipedia.org/wiki/Abstract_syntax_tree)（[在线解析](https://bhsd-harry.github.io/wikiparser-node/#editor)），还可以很方便地对语法树进行查询和修改，最后返回修改后的维基文本。
+WikiParser-Node 是一款由 Bhsd 开发的基于 [Node.js](https://nodejs.org/) 环境的离线[维基文本](https://www.mediawiki.org/wiki/Wikitext)语法解析器，可以解析几乎全部的维基语法并生成[语法树](https://en.wikipedia.org/wiki/Abstract_syntax_tree)（[在线解析](https://bhsd-harry.github.io/wikiparser-node/#editor)），还可以很方便地对语法树进行查询和修改，最后返回修改后的维基文本。
 
 # 其他版本
 
-## Mini (又名 [wikilint](https://www.npmjs.com/package/wikilint))
+## Mini (又名 [WikiLint](https://www.npmjs.com/package/wikilint))
 
 提供了 [CLI](https://en.wikipedia.org/wiki/Command-line_interface)，但仅保留了解析功能和语法错误分析功能，解析生成的语法树不能修改。这个版本被应用于 [eslint-plugin-wikitext](https://www.npmjs.com/package/eslint-plugin-wikitext) 插件。
 
@@ -24,7 +24,7 @@ wikiparser-node 是一款由 Bhsd 开发的基于 [Node.js](https://nodejs.org/)
 
 ## Node.js
 
-请根据需要需要安装对应的版本（`wikiparser-node` 或 `wikilint`），如：
+请根据需要需要安装对应的版本（`WikiParser-Node` 或 `WikiLint`），如：
 
 ```sh
 npm i wikiparser-node
@@ -41,13 +41,13 @@ npm i wikilint
 可以通过 CDN 下载代码，如：
 
 ```html
-<script src="//cdn.jsdelivr.net/npm/wikiparser-node@browser/bundle/bundle.min.js"></script>
+<script src="//cdn.jsdelivr.net/npm/wikiparser-node@browser"></script>
 ```
 
 或
 
 ```html
-<script src="//unpkg.com/wikiparser-node@browser/bundle/bundle.min.js"></script>
+<script src="//unpkg.com/wikiparser-node@browser"></script>
 ```
 
 更多浏览器端可用的插件请查阅对应[文档](https://github.com/bhsd-harry/wikiparser-node/wiki/Browser)。

package/dist/base.d.ts

@@ -14,7 +14,9 @@ export interface Config {
     readonly redirects?: [string, string][];
 }
 export type Severity = 'error' | 'warning';
+export 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';
 export interface LintError {
+    readonly rule: Rule;
     readonly message: string;
     readonly severity: Severity;
     readonly startIndex: number;

package/dist/lib/text.js

@@ -19,6 +19,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',
     'base',
@@ -186,6 +193,7 @@ 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({
+                rule: ruleMap[char],
                 message: index_1.default.msg('lonely "$1"', char === 'h' ? error : char),
                 severity,
                 startIndex,

package/dist/src/arg.js

@@ -72,7 +72,7 @@ class ArgToken extends index_2.Token {
     /** @override */
     lint(start = this.getAbsoluteIndex()) {
         if (!this.getAttribute('include')) {
-            return [(0, lint_1.generateForSelf)(this, { start }, 'unexpected template argument')];
+            return [(0, lint_1.generateForSelf)(this, { start }, 'no-arg', 'unexpected template argument')];
         }
         const { childNodes: [argName, argDefault, ...rest] } = this, errors = argName.lint(start + 3);
         if (argDefault) {
@@ -81,7 +81,7 @@ class ArgToken extends index_2.Token {
         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');
+                const error = (0, lint_1.generateForChild)(child, rect, 'no-ignored', 'invisible content inside triple braces');
                 return {
                     ...error,
                     startIndex: error.startIndex - 1,

package/dist/src/attribute.js

@@ -346,7 +346,7 @@ let AttributeToken = (() => {
             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');
+                const e = (0, lint_1.generateForChild)(lastChild, rect, 'unclosed-quote', index_1.default.msg('unclosed $1', 'quotes'), 'warning');
                 errors.push({
                     ...e,
                     startIndex: e.startIndex - 1,
@@ -360,19 +360,19 @@ let AttributeToken = (() => {
                     && !/^(?: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'));
+                errors.push((0, lint_1.generateForChild)(lastChild, rect, 'illegal-attr', 'nonzero tabindex'));
             }
             return errors;
         }

package/dist/src/attributes.js

@@ -149,13 +149,13 @@ 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'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'no-ignored', 'attributes of a closing tag'));
         }
         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'));
+                errors.push((0, lint_1.generateForChild)(attr, rect, 'no-ignored', 'containing invalid attribute'));
             }
             else if (attr instanceof attribute_1.AttributeToken) {
                 const { name } = attr;
@@ -171,7 +171,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

@@ -78,7 +78,7 @@ 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'));
+                errors.push((0, lint_1.generateForChild)(child, rect, 'no-ignored', 'invalid conversion flag'));
             }
         }
         return errors;

package/dist/src/extLink.js

@@ -130,7 +130,7 @@ let ExtLinkToken = (() => {
         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

@@ -67,6 +67,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,

package/dist/src/heading.js

@@ -129,23 +129,23 @@ let HeadingToken = (() => {
             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

@@ -181,13 +181,14 @@ let HtmlToken = (() => {
             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'),
                 });
             }
@@ -197,8 +198,8 @@ let HtmlToken = (() => {
             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);
@@ -220,17 +221,19 @@ let HtmlToken = (() => {
                 }
             }
             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: 'format-leakage',
                     message: index_1.default.msg('bold in section header'),
                     severity: 'warning',
                 });

package/dist/src/imageParameter.js

@@ -168,10 +168,10 @@ 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'));
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid-gallery', 'invalid gallery image parameter'));
         }
         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

@@ -103,10 +103,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/index.js

@@ -414,7 +414,7 @@ class Token extends element_1.AstElement {
             }
             for (const value of Object.values(record)) {
                 if (value.size > 1) {
-                    errors.push(...[...value].map(cat => (0, lint_1.generateForSelf)(cat, { start: cat.getAbsoluteIndex() }, 'duplicated category')));
+                    errors.push(...[...value].map(cat => (0, lint_1.generateForSelf)(cat, { start: cat.getAbsoluteIndex() }, 'no-duplicate', 'duplicated category')));
                 }
             }
         }

package/dist/src/link/base.js

@@ -135,20 +135,20 @@ 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'));
+            errors.push((0, lint_1.generateForChild)(linkText, rect, 'pipe-like', 'additional "|" in the link text', 'warning'));
         }
         else if (linkType !== 'link' && fragment !== undefined) {
             rect ??= { start, ...this.getRootNode().posFromIndex(start) };
-            errors.push((0, lint_1.generateForChild)(target, rect, 'useless fragment'));
+            errors.push((0, lint_1.generateForChild)(target, rect, 'no-ignored', 'useless fragment'));
         }
         return errors;
     }

package/dist/src/link/file.js

@@ -104,7 +104,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
@@ -118,7 +118,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

@@ -102,7 +102,7 @@ let GalleryImageToken = (() => {
         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

@@ -51,7 +51,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

@@ -111,7 +111,7 @@ let MagicLinkToken = (() => {
                     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;

package/dist/src/nested.js

@@ -61,7 +61,7 @@ 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));
+                return (0, lint_1.generateForChild)(child, rect, 'no-ignored', index_1.default.msg('invalid content in <$1>', this.name));
             }),
         ];
     }

package/dist/src/nowiki/comment.js

@@ -31,7 +31,9 @@ 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'))];
+        return this.closed
+            ? []
+            : [(0, lint_1.generateForSelf)(this, { start }, 'unclosed-comment', index_1.default.msg('unclosed $1', 'HTML comment'))];
     }
     /** @private */
     toString() {

package/dist/src/nowiki/index.js

@@ -13,7 +13,7 @@ class NowikiToken extends base_1.NowikiBaseToken {
     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))]
+            ? [(0, lint_1.generateForSelf)(this, { start }, 'void-ext', index_1.default.msg('nothing should be in <$1>', name))]
             : super.lint(start);
     }
 }

package/dist/src/nowiki/quote.js

@@ -70,7 +70,7 @@ let QuoteToken = (() => {
             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,
@@ -82,7 +82,7 @@ let QuoteToken = (() => {
                 });
             }
             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,
@@ -94,9 +94,10 @@ let QuoteToken = (() => {
                 });
             }
             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

@@ -47,7 +47,7 @@ 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));
+            return (0, lint_1.generateForChild)(child, rect, 'no-ignored', index_1.default.msg('invalid parameter of <$1>', this.name));
         });
     }
     /** @override */

package/dist/src/parameter.js

@@ -158,7 +158,7 @@ let ParameterToken = (() => {
             /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');
+                const e = (0, lint_1.generateForChild)(firstChild, { start }, 'unescaped', 'unescaped query string in an anonymous parameter');
                 errors.push({
                     ...e,
                     startIndex: e.endIndex,

package/dist/src/table/index.js

@@ -41,7 +41,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')));
         }
         /* NOT FOR BROWSER */
         const layout = this.getLayout(), { length } = layout;
@@ -49,7 +49,7 @@ class TableToken extends trBase_1.TrBaseToken {
             const j = new Array(length - 1).fill(undefined)
                 .findIndex((_, i) => layout[i].length !== layout[i + 1].length) + 1;
             if (j) {
-                errors.push((0, lint_1.generateForChild)(this.getNthRow(j), { start }, 'inconsistent table layout', 'warning'));
+                errors.push((0, lint_1.generateForChild)(this.getNthRow(j), { start }, 'table-layout', 'inconsistent table layout', 'warning'));
             }
         }
         /* NOT FOR BROWSER END */

package/dist/src/table/td.js

@@ -193,7 +193,7 @@ let TdToken = (() => {
                 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'));
+                        errors.push((0, lint_1.generateForChild)(child, { start }, 'pipe-like', 'additional "|" in a table cell', data.includes('||') ? 'error' : 'warning'));
                     }
                 }
             }

package/dist/src/table/trBase.js

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

package/dist/src/tagPair/ext.js

@@ -177,11 +177,11 @@ let ExtToken = (() => {
             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

@@ -38,7 +38,9 @@ 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}>`))];
+        return this.closed
+            ? []
+            : [(0, lint_1.generateForSelf)(this, { start }, 'unclosed-comment', index_1.default.msg('unclosed $1', `<${this.name}>`))];
     }
     /* NOT FOR BROWSER */
     /** @override */

package/dist/src/transclude.js

@@ -232,21 +232,21 @@ 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'));
+            errors.push((0, lint_1.generateForChild)(childNodes[type === 'template' ? 0 : 1], rect, 'no-ignored', 'useless fragment'));
         }
         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/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": "wikiparser-node",
-	"version": "1.4.4",
+	"version": "1.4.5",
 	"description": "A Node.js parser for MediaWiki markup with AST",
 	"keywords": [
 		"mediawiki",