wikilint 2.16.4 → 2.16.6

package/dist/src/gallery.js

@@ -6,8 +6,10 @@ const index_2 = require("./index");
 const galleryImage_1 = require("./link/galleryImage");
 const noinclude_1 = require("./nowiki/noinclude");
 /**
+ * gallery tag
+ *
  * gallery标签
- * @classdesc `{childNodes: ...(GalleryImageToken|NoincludeToken|AstText)}`
+ * @classdesc `{childNodes: (GalleryImageToken|NoincludeToken|AstText)[]}`
  */
 class GalleryToken extends index_2.Token {
     get type() {
@@ -39,7 +41,7 @@ class GalleryToken extends index_2.Token {
      * @param file 文件名
      */
     #checkFile(file) {
-        return this.normalizeTitle(file, 6, true, true).valid;
+        return this.normalizeTitle(file, 6, true, true, true).valid;
     }
     /** @private */
     toString(skip) {
@@ -57,8 +59,8 @@ class GalleryToken extends index_2.Token {
     lint(start = this.getAbsoluteIndex(), re) {
         const { top, left } = this.getRootNode().posFromIndex(start), errors = [];
         for (const [i, child] of this.childNodes.entries()) {
-            const str = child.toString(), { length } = str, trimmed = str.trim(), startLine = top + i, startCol = i ? 0 : left;
-            if (child.type === 'noinclude' && trimmed && !/^<!--.*-->$/u.test(trimmed)) {
+            const str = child.toString(), { length } = str, trimmed = str.trim(), { type } = child, startLine = top + i, startCol = i ? 0 : left;
+            if (type === 'noinclude' && trimmed && !/^<!--.*-->$/u.test(trimmed)) {
                 const endIndex = start + length;
                 errors.push({
                     rule: 'no-ignored',
@@ -76,7 +78,7 @@ class GalleryToken extends index_2.Token {
                     ],
                 });
             }
-            else if (child.type !== 'noinclude' && child.type !== 'text') {
+            else if (type !== 'noinclude' && type !== 'text') {
                 errors.push(...child.lint(start, re));
             }
             start += length + 1;

package/dist/src/heading.d.ts

@@ -4,6 +4,8 @@ import { SyntaxToken } from './syntax';
 import type { LintError } from '../base';
 import type { AstText } from '../internal';
 /**
+ * section heading
+ *
  * 章节标题
  * @classdesc `{childNodes: [Token, SyntaxToken]}`
  */
@@ -14,7 +16,7 @@ export declare abstract class HeadingToken extends Token {
     abstract get lastChild(): SyntaxToken;
     abstract get nextSibling(): AstText | undefined;
     get type(): 'heading';
-    /** 标题层级 */
+    /** level of the heading / 标题层级 */
     get level(): number;
     /**
      * @param level 标题层级

package/dist/src/heading.js

@@ -8,6 +8,8 @@ const index_1 = require("../index");
 const index_2 = require("./index");
 const syntax_1 = require("./syntax");
 /**
+ * section heading
+ *
  * 章节标题
  * @classdesc `{childNodes: [Token, SyntaxToken]}`
  */
@@ -16,7 +18,7 @@ class HeadingToken extends index_2.Token {
     get type() {
         return 'heading';
     }
-    /** 标题层级 */
+    /** level of the heading / 标题层级 */
     get level() {
         return this.#level;
     }
@@ -87,7 +89,7 @@ class HeadingToken extends index_2.Token {
             errors.push(e);
         }
         if (this.closest('html-attrs,table-attrs')) {
-            errors.push((0, lint_1.generateForSelf)(this, rect, 'parsing-order', 'section header in a HTML tag'));
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'parsing-order', 'section header in an HTML tag'));
         }
         const rootStr = this.getRootNode().toString();
         if (boldQuotes.length % 2) {

package/dist/src/hidden.d.ts

@@ -1,5 +1,9 @@
 import { Token } from './index';
-/** 不可见的节点 */
+/**
+ * invisible token
+ *
+ * 不可见的节点
+ */
 export declare class HiddenToken extends Token {
     get type(): 'hidden';
 }

package/dist/src/hidden.js

@@ -37,7 +37,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HiddenToken = void 0;
 const hidden_1 = require("../mixin/hidden");
 const index_1 = require("./index");
-/** 不可见的节点 */
+/**
+ * invisible token
+ *
+ * 不可见的节点
+ */
 let HiddenToken = (() => {
     let _classDecorators = [(0, hidden_1.hiddenToken)()];
     let _classDescriptor;

package/dist/src/html.d.ts

@@ -5,6 +5,8 @@ import type { AttributesToken } from '../internal';
 export interface HtmlToken extends AttributesParentBase {
 }
 /**
+ * HTML tag
+ *
  * HTML标签
  * @classdesc `{childNodes: [AttributesToken]}`
  */
@@ -15,9 +17,9 @@ export declare abstract class HtmlToken extends Token {
     abstract get firstChild(): AttributesToken;
     abstract get lastChild(): AttributesToken;
     get type(): 'html';
-    /** 是否自封闭 */
+    /** whether to be self-closing / 是否自封闭 */
     get selfClosing(): boolean;
-    /** 是否是闭合标签 */
+    /** whether to be a closing tag / 是否是闭合标签 */
     get closing(): boolean;
     /**
      * @param name 标签名
@@ -27,6 +29,8 @@ export declare abstract class HtmlToken extends Token {
      */
     constructor(name: string, attr: AttributesToken, closing: boolean, selfClosing: boolean, config?: Config, accum?: Token[]);
     /**
+     * Find the matching tag
+     *
      * 搜索匹配的标签
      * @throws `SyntaxError` 同时闭合和自封闭的标签
      * @throws `SyntaxError` 无效自封闭标签

package/dist/src/html.js

@@ -68,6 +68,8 @@ const magicWords = new Set(['if', 'ifeq', 'ifexpr', 'ifexist', 'iferror', 'switc
     'var',
 ]), obsoleteTags = new Set(['strike', 'big', 'center', 'font', 'tt']);
 /**
+ * HTML tag
+ *
  * HTML标签
  * @classdesc `{childNodes: [AttributesToken]}`
  */
@@ -92,11 +94,11 @@ let HtmlToken = (() => {
         get type() {
             return 'html';
         }
-        /** 是否自封闭 */
+        /** whether to be self-closing / 是否自封闭 */
         get selfClosing() {
             return this.#selfClosing;
         }
-        /** 是否是闭合标签 */
+        /** whether to be a closing tag / 是否是闭合标签 */
         get closing() {
             return this.#closing;
         }
@@ -208,6 +210,8 @@ let HtmlToken = (() => {
             return errors;
         }
         /**
+         * Find the matching tag
+         *
          * 搜索匹配的标签
          * @throws `SyntaxError` 同时闭合和自封闭的标签
          * @throws `SyntaxError` 无效自封闭标签

package/dist/src/imageParameter.d.ts

@@ -4,7 +4,11 @@ import type { LintError } from '../base';
 import type { Title } from '../lib/title';
 import type { AtomToken, FileToken } from '../internal';
 export declare const galleryParams: Set<string>;
-/** 图片参数 */
+/**
+ * image parameter
+ *
+ * 图片参数
+ */
 export declare abstract class ImageParameterToken extends Token {
     #private;
     readonly name: string;
@@ -12,10 +16,14 @@ export declare abstract class ImageParameterToken extends Token {
     abstract get nextSibling(): this | undefined;
     abstract get previousSibling(): AtomToken | this;
     get type(): 'image-parameter';
-    /** 图片链接 */
+    /** image link / 图片链接 */
     get link(): string | Title | undefined;
     /** @param str 图片参数 */
     constructor(str: string, extension: string | undefined, config?: Parser.Config, accum?: Token[]);
-    /** 获取参数值 */
+    /**
+     * Get the parameter value
+     *
+     * 获取参数值
+     */
     getValue(): string | true;
 }

package/dist/src/imageParameter.js

@@ -24,7 +24,7 @@ function validate(key, val, config, halfParsed, ext) {
             else if (value.startsWith('[[') && value.endsWith(']]')) {
                 value = value.slice(2, -2);
             }
-            const title = index_1.default.normalizeTitle(value, 0, false, config, halfParsed, true, true);
+            const title = index_1.default.normalizeTitle(value, 0, false, config, false, halfParsed, true, true);
             return title.valid && title;
         }
         case 'lang':
@@ -39,13 +39,17 @@ function validate(key, val, config, halfParsed, ext) {
             return Boolean(value) && !isNaN(value);
     }
 }
-/** 图片参数 */
+/**
+ * image parameter
+ *
+ * 图片参数
+ */
 class ImageParameterToken extends index_2.Token {
     #syntax = '';
     get type() {
         return 'image-parameter';
     }
-    /** 图片链接 */
+    /** image link / 图片链接 */
     get link() {
         return this.name === 'link' ? validate('link', super.text(), this.getAttribute('config')) : undefined;
     }
@@ -121,7 +125,11 @@ class ImageParameterToken extends index_2.Token {
     #isVoid() {
         return this.#syntax && !this.#syntax.includes('$1');
     }
-    /** 获取参数值 */
+    /**
+     * Get the parameter value
+     *
+     * 获取参数值
+     */
     getValue() {
         return this.name === 'invalid' ? this.text() : this.#isVoid() || super.text();
     }

package/dist/src/imagemap.d.ts

@@ -8,7 +8,7 @@ import type { AstText, AttributesToken, ExtToken } from '../internal';
 declare type Child = GalleryImageToken | NoincludeToken;
 /**
  * `<imagemap>`
- * @classdesc `{childNodes: ...NoincludeToken, GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)}`
+ * @classdesc `{childNodes: [...NoincludeToken[], GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)[]]}`
  */
 export declare abstract class ImagemapToken extends Token {
     readonly name: 'imagemap';

package/dist/src/imagemap.js

@@ -11,7 +11,7 @@ const galleryImage_1 = require("./link/galleryImage");
 const imagemapLink_1 = require("./imagemapLink");
 /**
  * `<imagemap>`
- * @classdesc `{childNodes: ...NoincludeToken, GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)}`
+ * @classdesc `{childNodes: [...NoincludeToken[], GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)[]]}`
  */
 class ImagemapToken extends index_2.Token {
     get type() {
@@ -35,8 +35,9 @@ class ImagemapToken extends index_2.Token {
                 //
             }
             else if (first) {
-                const pipe = line.indexOf('|'), file = pipe === -1 ? line : line.slice(0, pipe), title = this.normalizeTitle(file, 0, true);
-                if (title.valid && !title.interwiki && title.ns === 6) {
+                const pipe = line.indexOf('|'), file = pipe === -1 ? line : line.slice(0, pipe), { valid, ns, } = this.normalizeTitle(file, 0, true, true);
+                if (valid
+                    && ns === 6) {
                     // @ts-expect-error abstract class
                     const token = new galleryImage_1.GalleryImageToken('imagemap', file, pipe === -1 ? undefined : line.slice(pipe + 1), config, accum);
                     super.insertAt(token);
@@ -55,7 +56,7 @@ class ImagemapToken extends index_2.Token {
                 const i = line.indexOf('['), substr = line.slice(i), mtIn = /^\[\[([^|]+)(?:\|([^\]]+))?\]\][\w\s]*$/u
                     .exec(substr);
                 if (mtIn) {
-                    if (this.normalizeTitle(mtIn[1], 0, true, false, true).valid) {
+                    if (this.normalizeTitle(mtIn[1], 0, true, true, false, true).valid) {
                         // @ts-expect-error abstract class
                         super.insertAt(new imagemapLink_1.ImagemapLinkToken(line.slice(0, i), mtIn.slice(1), substr.slice(substr.indexOf(']]') + 2), config, accum));
                         continue;

package/dist/src/imagemapLink.d.ts

@@ -5,6 +5,8 @@ import { LinkToken } from './link/index';
 import { ExtLinkToken } from './extLink';
 import type { AstText, ImagemapToken, GalleryImageToken } from '../internal';
 /**
+ * link inside the `<imagemap>`
+ *
  * `<imagemap>`内的链接
  * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
  */

package/dist/src/imagemapLink.js

@@ -7,6 +7,8 @@ const noinclude_1 = require("./nowiki/noinclude");
 const index_3 = require("./link/index");
 const extLink_1 = require("./extLink");
 /**
+ * link inside the `<imagemap>`
+ *
  * `<imagemap>`内的链接
  * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
  */

package/dist/src/index.d.ts

@@ -5,8 +5,10 @@ import type { LintError, TokenTypes } from '../base';
 import type { Title } from '../lib/title';
 import type { AstNodes } from '../internal';
 /**
+ * base class for all tokens
+ *
  * 所有节点的基类
- * @classdesc `{childNodes: ...(AstText|Token)}`
+ * @classdesc `{childNodes: (AstText|Token)[]}`
  */
 export declare class Token extends AstElement {
     #private;
@@ -16,8 +18,8 @@ export declare class Token extends AstElement {
     constructor(wikitext?: string, config?: Parser.Config, accum?: Token[], acceptable?: Acceptable);
     /**
      * @override
-     * @param child 待插入的子节点
-     * @param i 插入位置
+     * @param child node to be inserted / 待插入的子节点
+     * @param i position to be inserted at / 插入位置
      */
     insertAt(child: string, i?: number): AstText;
     insertAt<T extends AstNodes>(child: T, i?: number): T;

package/dist/src/index.js

@@ -50,8 +50,10 @@ const index_1 = require("../index");
 const element_1 = require("../lib/element");
 const text_1 = require("../lib/text");
 /**
+ * base class for all tokens
+ *
  * 所有节点的基类
- * @classdesc `{childNodes: ...(AstText|Token)}`
+ * @classdesc `{childNodes: (AstText|Token)[]}`
  */
 class Token extends element_1.AstElement {
     #type = 'plain';
@@ -80,7 +82,7 @@ class Token extends element_1.AstElement {
         accum.push(this);
     }
     /** @private */
-    parseOnce(n = this.#stage, include = false) {
+    parseOnce(n = this.#stage, include = false, tidy) {
         if (n < this.#stage || this.length === 0 || !this.getAttribute('plain')) {
             return this;
         }
@@ -110,10 +112,10 @@ class Token extends element_1.AstElement {
                 this.#parseHrAndDoubleUnderscore();
                 break;
             case 5:
-                this.#parseLinks();
+                this.#parseLinks(tidy);
                 break;
             case 6:
-                this.#parseQuotes();
+                this.#parseQuotes(tidy);
                 break;
             case 7:
                 this.#parseExternalLinks();
@@ -130,7 +132,7 @@ class Token extends element_1.AstElement {
         }
         if (this.type === 'root') {
             for (const token of this.#accum) {
-                token?.parseOnce(n, include); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+                token?.parseOnce(n, include, tidy); // eslint-disable-line @typescript-eslint/no-unnecessary-condition
             }
         }
         this.#stage++;
@@ -179,10 +181,10 @@ class Token extends element_1.AstElement {
         this.#built = true;
     }
     /** @private */
-    parse(n = constants_1.MAX_STAGE, include) {
+    parse(n = constants_1.MAX_STAGE, include, tidy) {
         n = Math.min(n, constants_1.MAX_STAGE);
         while (this.#stage < n) {
-            this.parseOnce(this.#stage, include);
+            this.parseOnce(this.#stage, include, tidy);
         }
         if (n) {
             this.build();
@@ -237,20 +239,26 @@ class Token extends element_1.AstElement {
         const { parseHrAndDoubleUnderscore } = require('../parser/hrAndDoubleUnderscore');
         this.setText(parseHrAndDoubleUnderscore(this, this.#config, this.#accum));
     }
-    /** 解析内部链接 */
-    #parseLinks() {
+    /**
+     * 解析内部链接
+     * @param tidy 是否整理
+     */
+    #parseLinks(tidy) {
         const { parseLinks } = require('../parser/links');
-        this.setText(parseLinks(this.firstChild.toString(), this.#config, this.#accum));
+        this.setText(parseLinks(this.firstChild.toString(), this.#config, this.#accum, tidy));
     }
-    /** 解析单引号 */
-    #parseQuotes() {
+    /**
+     * 解析单引号
+     * @param tidy 是否整理
+     */
+    #parseQuotes(tidy) {
         if (this.#config.excludes?.includes('quote')) {
             return;
         }
         const { parseQuotes } = require('../parser/quotes');
         const lines = this.firstChild.toString().split('\n');
         for (let i = 0; i < lines.length; i++) {
-            lines[i] = parseQuotes(lines[i], this.#config, this.#accum);
+            lines[i] = parseQuotes(lines[i], this.#config, this.#accum, tidy);
         }
         this.setText(lines.join('\n'));
     }
@@ -276,8 +284,8 @@ class Token extends element_1.AstElement {
             return;
         }
         const { parseList } = require('../parser/list');
-        const lines = this.firstChild.toString().split('\n'), state = { lastPrefix: '' };
-        let i = this.type === 'root' || this.type === 'ext-inner' && this.name === 'poem' ? 0 : 1;
+        const { firstChild, type, name } = this, lines = firstChild.toString().split('\n'), state = { lastPrefix: '' };
+        let i = type === 'root' || type === 'ext-inner' && name === 'poem' ? 0 : 1;
         for (; i < lines.length; i++) {
             lines[i] = parseList(lines[i], state, this.#config, this.#accum);
         }
@@ -323,14 +331,16 @@ class Token extends element_1.AstElement {
     insertAt(child, i = this.length) {
         const token = typeof child === 'string' ? new text_1.AstText(child) : child;
         super.insertAt(token, i);
-        if (token.type === 'root') {
+        const { type, } = token;
+        if (type === 'root') {
             token.type = 'plain';
         }
         return token;
     }
     /** @private */
-    normalizeTitle(title, defaultNs = 0, halfParsed, decode, selfLink) {
-        return index_1.default.normalizeTitle(title, defaultNs, this.#include, this.#config, halfParsed, decode, selfLink);
+    normalizeTitle(title, defaultNs = 0, temporary, halfParsed, decode, selfLink) {
+        return index_1.default
+            .normalizeTitle(title, defaultNs, this.#include, this.#config, temporary, halfParsed, decode, selfLink);
     }
     /** @private */
     lint(start = this.getAbsoluteIndex(), re) {

package/dist/src/link/base.d.ts

@@ -4,8 +4,10 @@ import { AtomToken } from '../atom';
 import type { LintError } from '../../base';
 import type { Title } from '../../lib/title';
 /**
+ * internal link
+ *
  * 内链
- * @classdesc `{childNodes: [AtomToken, ...Token]}`
+ * @classdesc `{childNodes: [AtomToken, ...Token[]]}`
  */
 export declare abstract class LinkBaseToken extends Token {
     #private;
@@ -14,7 +16,7 @@ export declare abstract class LinkBaseToken extends Token {
     readonly childNodes: readonly [AtomToken, ...Token[]];
     abstract get firstChild(): AtomToken;
     abstract get lastChild(): Token;
-    /** 完整链接 */
+    /** full link / 完整链接 */
     get link(): string | Title;
     /**
      * @param link 链接标题

package/dist/src/link/base.js

@@ -14,16 +14,19 @@ const atom_1 = require("../atom");
  */
 const isLink = (type) => type === 'redirect-target' || type === 'link';
 /**
+ * internal link
+ *
  * 内链
- * @classdesc `{childNodes: [AtomToken, ...Token]}`
+ * @classdesc `{childNodes: [AtomToken, ...Token[]]}`
  */
 class LinkBaseToken extends index_2.Token {
     #bracket = true;
     #delimiter;
     #title;
-    /** 完整链接 */
+    /** full link / 完整链接 */
     get link() {
-        return this.#title;
+        // eslint-disable-next-line no-unused-labels
+        LSP: return this.#title;
     }
     /**
      * @param link 链接标题
@@ -112,7 +115,10 @@ class LinkBaseToken extends index_2.Token {
             const e = (0, lint_1.generateForChild)(target, rect, 'no-ignored', 'useless fragment'), j = target.childNodes.findIndex(c => c.type === 'text' && c.data.includes('#')), textNode = target.childNodes[j];
             if (textNode) {
                 e.fix = {
-                    range: [e.startIndex + target.getRelativeIndex(j) + textNode.data.indexOf('#'), e.endIndex],
+                    range: [
+                        e.startIndex + target.getRelativeIndex(j) + textNode.data.indexOf('#'),
+                        e.endIndex,
+                    ],
                     text: '',
                     desc: 'remove',
                 };
@@ -122,8 +128,8 @@ class LinkBaseToken extends index_2.Token {
         return errors;
     }
     /** @private */
-    getTitle(halfParsed) {
-        return this.normalizeTitle(this.firstChild.toString(true), 0, halfParsed, true, true);
+    getTitle(temporary, halfParsed) {
+        return this.normalizeTitle(this.firstChild.toString(true), 0, temporary, halfParsed, true, true);
     }
 }
 exports.LinkBaseToken = LinkBaseToken;

package/dist/src/link/category.d.ts

@@ -2,6 +2,8 @@ import { LinkBaseToken } from './base';
 import type { Title } from '../../lib/title';
 import type { Token, AtomToken } from '../../internal';
 /**
+ * category
+ *
  * 分类
  * @classdesc `{childNodes: [AtomToken, ?Token]}`
  */

package/dist/src/link/category.js

@@ -3,6 +3,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CategoryToken = void 0;
 const base_1 = require("./base");
 /**
+ * category
+ *
  * 分类
  * @classdesc `{childNodes: [AtomToken, ?Token]}`
  */

package/dist/src/link/file.d.ts

@@ -4,36 +4,46 @@ import { ImageParameterToken } from '../imageParameter';
 import type { LintError } from '../../base';
 import type { Token, AtomToken } from '../../internal';
 /**
+ * image
+ *
  * 图片
- * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken]}`
+ * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken[]]}`
  */
 export declare abstract class FileToken extends LinkBaseToken {
     readonly childNodes: readonly [AtomToken, ...ImageParameterToken[]];
     abstract get lastChild(): AtomToken | ImageParameterToken;
     get type(): 'file' | 'gallery-image' | 'imagemap-image';
-    /** 扩展名 */
-    get extension(): string | undefined;
     /**
      * @param link 文件名
      * @param text 图片参数
      * @param delimiter `|`
      */
     constructor(link: string, text?: string, config?: Parser.Config, accum?: Token[], delimiter?: string);
-    /** 获取所有图片参数节点 */
+    /**
+     * Get all image parameter tokens
+     *
+     * 获取所有图片参数节点
+     */
     getAllArgs(): ImageParameterToken[];
     /**
+     * Get image parameters with the specified name
+     *
      * 获取指定图片参数
-     * @param key 参数名
+     * @param key parameter name / 参数名
      */
     getArgs(key: string): ImageParameterToken[];
     /**
+     * Get the effective image parameter with the specified name
+     *
      * 获取生效的指定图片参数
-     * @param key 参数名
+     * @param key parameter name / 参数名
      */
     getArg(key: string): ImageParameterToken | undefined;
     /**
+     * Get the effective image parameter value
+     *
      * 获取生效的指定图片参数值
-     * @param key 参数名
+     * @param key parameter name / 参数名
      */
     getValue(key: string): string | true | undefined;
 }