wikilint 2.16.4 → 2.16.6

package/dist/src/pre.d.ts

@@ -6,7 +6,7 @@ import type { AstText, AttributesToken, ExtToken, ConverterToken } from '../inte
 declare type Child = NoincludeToken | ConverterToken;
 /**
  * `<pre>`
- * @classdesc `{childNodes: [...AstText|NoincludeToken|ConverterToken]}`
+ * @classdesc `{childNodes: (AstText|NoincludeToken|ConverterToken)[]}`
  */
 export declare abstract class PreToken extends Token {
     readonly name: 'pre';

package/dist/src/pre.js

@@ -7,7 +7,7 @@ const index_2 = require("./index");
 const noinclude_1 = require("./nowiki/noinclude");
 /**
  * `<pre>`
- * @classdesc `{childNodes: [...AstText|NoincludeToken|ConverterToken]}`
+ * @classdesc `{childNodes: (AstText|NoincludeToken|ConverterToken)[]}`
  */
 class PreToken extends index_2.Token {
     get type() {

package/dist/src/redirect.d.ts

@@ -4,6 +4,8 @@ import { SyntaxToken } from './syntax';
 import { RedirectTargetToken } from './link/redirectTarget';
 import type { LintError } from '../base';
 /**
+ * redirect
+ *
  * 重定向
  * @classdesc `{childNodes: [SyntaxToken, LinkToken]}`
  */

package/dist/src/redirect.js

@@ -41,6 +41,8 @@ const index_2 = require("./index");
 const syntax_1 = require("./syntax");
 const redirectTarget_1 = require("./link/redirectTarget");
 /**
+ * redirect
+ *
  * 重定向
  * @classdesc `{childNodes: [SyntaxToken, LinkToken]}`
  */

package/dist/src/syntax.d.ts

@@ -1,7 +1,11 @@
 import { Token } from './index';
 import type { Config, LintError } from '../base';
 declare type SyntaxTypes = 'heading-trail' | 'magic-word-name' | 'table-syntax' | 'redirect-syntax';
-/** 满足特定语法格式的plain Token */
+/**
+ * plain token that satisfies specific grammar syntax
+ *
+ * 满足特定语法格式的plain Token
+ */
 export declare class SyntaxToken extends Token {
     #private;
     get type(): SyntaxTypes;

package/dist/src/syntax.js

@@ -2,7 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SyntaxToken = void 0;
 const index_1 = require("./index");
-/** 满足特定语法格式的plain Token */
+/**
+ * plain token that satisfies specific grammar syntax
+ *
+ * 满足特定语法格式的plain Token
+ */
 class SyntaxToken extends index_1.Token {
     #type;
     get type() {

package/dist/src/table/base.js

@@ -7,8 +7,10 @@ const index_2 = require("../index");
 const syntax_1 = require("../syntax");
 const attributes_1 = require("../attributes");
 /**
+ * table row that contains the newline at the beginning but not at the end
+ *
  * 表格行，含开头的换行，不含结尾的换行
- * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ...Token]}`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ...Token[]]}`
  */
 class TableBaseToken extends (0, attributesParent_1.attributesParent)(1)(index_2.Token) {
     /**

package/dist/src/table/index.d.ts

@@ -13,14 +13,16 @@ export declare const isRowEnd: ({ type }: Token) => boolean;
 export declare class Layout extends Array<TableCoords[]> {
 }
 /**
+ * table
+ *
  * 表格
- * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken, ...TrToken, ?SyntaxToken]}`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken[], ...TrToken[], ?SyntaxToken]}`
  */
 export declare abstract class TableToken extends TrBaseToken {
     readonly childNodes: readonly [SyntaxToken, AttributesToken, ...(TdToken | TrToken)[], SyntaxToken] | readonly [SyntaxToken, AttributesToken, ...(TdToken | TrToken)[]];
     abstract get lastChild(): AttributesToken | TdToken | TrToken | SyntaxToken;
     get type(): 'table';
-    /** 表格是否闭合 */
+    /** whether the table is closed / 表格是否闭合 */
     get closed(): boolean;
     /**
      * @param syntax 表格语法
@@ -28,12 +30,14 @@ export declare abstract class TableToken extends TrBaseToken {
      */
     constructor(syntax: string, attr?: string, config?: Config, accum?: Token[]);
     /**
+     * Get the table layout
+     *
      * 获取表格布局
-     * @param stop 中止条件
-     * @param stop.row 中止行
-     * @param stop.column 中止列
-     * @param stop.x 中止行
-     * @param stop.y 中止列
+     * @param stop stop condition / 中止条件
+     * @param stop.row stop at the row / 中止行
+     * @param stop.column stop at the column / 中止列
+     * @param stop.x stop at the row / 中止行
+     * @param stop.y stop at the column / 中止列
      */
     getLayout(stop?: {
         row?: number;
@@ -41,18 +45,19 @@ export declare abstract class TableToken extends TrBaseToken {
         x?: number;
         y?: number;
     }): Layout;
-    /** 获取所有行 */
-    getAllRows(): (TrToken | this)[];
     /**
-     * 获取指定坐标的单元格
-     * @param coords 表格坐标
+     * Get all rows
+     *
+     * 获取所有行
      */
-    getNthCell(coords: TableCoords): TdToken | undefined;
+    getAllRows(): (TrToken | this)[];
     /**
+     * Get the `n`-th row
+     *
      * 获取第n行
-     * @param n 行号
-     * @param force 是否将表格自身视为第一行
-     * @param insert 是否用于判断插入新行的位置
+     * @param n row number / 行号
+     * @param force whether to regard the table itself as the first row / 是否将表格自身视为第一行
+     * @param insert whether to be used to insert a new row / 是否用于判断插入新行的位置
      * @throws `RangeError` 不存在该行
      */
     getNthRow(n: number, force?: boolean, insert?: false): TrToken | this | undefined;

package/dist/src/table/index.js

@@ -25,14 +25,16 @@ class Layout extends Array {
 }
 exports.Layout = Layout;
 /**
+ * table
+ *
  * 表格
- * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken, ...TrToken, ?SyntaxToken]}`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken[], ...TrToken[], ?SyntaxToken]}`
  */
 class TableToken extends trBase_1.TrBaseToken {
     get type() {
         return 'table';
     }
-    /** 表格是否闭合 */
+    /** whether the table is closed / 表格是否闭合 */
     get closed() {
         return this.lastChild.type === 'table-syntax';
     }
@@ -80,20 +82,24 @@ class TableToken extends trBase_1.TrBaseToken {
     }
     /** @private */
     close(syntax = '\n|}', halfParsed) {
-        const config = this.getAttribute('config'), accum = this.getAttribute('accum'), inner = halfParsed ? [syntax] : index_1.default.parse(syntax, this.getAttribute('include'), 2, config).childNodes;
+        const config = this.getAttribute('config'), accum = this.getAttribute('accum'), inner = halfParsed
+            ? [syntax]
+            : index_1.default.parse(syntax, this.getAttribute('include'), 2, config).childNodes;
         debug_1.Shadow.run(() => {
-            const token = new syntax_1.SyntaxToken(undefined, closingPattern, 'table-syntax', config, accum, {});
+            const token = new syntax_1.SyntaxToken(undefined, closingPattern, 'table-syntax', config, accum);
             super.insertAt(token);
         });
         this.lastChild.replaceChildren(...inner);
     }
     /**
+     * Get the table layout
+     *
      * 获取表格布局
-     * @param stop 中止条件
-     * @param stop.row 中止行
-     * @param stop.column 中止列
-     * @param stop.x 中止行
-     * @param stop.y 中止列
+     * @param stop stop condition / 中止条件
+     * @param stop.row stop at the row / 中止行
+     * @param stop.column stop at the column / 中止列
+     * @param stop.x stop at the row / 中止行
+     * @param stop.y stop at the column / 中止列
      */
     getLayout(stop) {
         const rows = this.getAllRows(), { length } = rows, layout = new Layout(...emptyArray(length, () => []));
@@ -125,7 +131,11 @@ class TableToken extends trBase_1.TrBaseToken {
         }
         return layout;
     }
-    /** 获取所有行 */
+    /**
+     * Get all rows
+     *
+     * 获取所有行
+     */
     getAllRows() {
         return [
             ...super.getRowCount() ? [this] : [],
@@ -133,18 +143,6 @@ class TableToken extends trBase_1.TrBaseToken {
                 .filter((child) => child.type === 'tr' && child.getRowCount() > 0),
         ];
     }
-    /**
-     * 获取指定坐标的单元格
-     * @param coords 表格坐标
-     */
-    getNthCell(
-    // eslint-disable-next-line @stylistic/comma-dangle
-    coords) {
-        // eslint-disable-next-line prefer-const, @typescript-eslint/no-unnecessary-type-assertion
-        let rawCoords = coords;
-        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
-        return rawCoords && this.getNthRow(rawCoords.row, false, false)?.getNthCol(rawCoords.column);
-    }
     getNthRow(n, force, insert) {
         const isRow = super.getRowCount();
         if (n === 0
@@ -156,7 +154,8 @@ class TableToken extends trBase_1.TrBaseToken {
             n--;
         }
         for (const child of this.childNodes.slice(2)) {
-            if (child.type === 'tr' && child.getRowCount()) {
+            const { type } = child;
+            if (type === 'tr' && child.getRowCount()) {
                 n--;
                 if (n < 0) {
                     return child;

package/dist/src/table/td.d.ts

@@ -10,7 +10,9 @@ export interface TdSpanAttrs {
 }
 declare type TdAttrGetter<T extends string> = T extends keyof TdSpanAttrs ? number : string | true | undefined;
 /**
- * `<td>`、`<th>`和`<caption>`
+ * `<td>`, `<th>` or `<caption>`
+ *
+ * `<td>`、`<th>`或`<caption>`
  * @classdesc `{childNodes: [SyntaxToken, AttributesToken, Token]}`
  */
 export declare abstract class TdToken extends TableBaseToken {
@@ -24,14 +26,18 @@ export declare abstract class TdToken extends TableBaseToken {
     get rowspan(): number;
     /** colspan */
     get colspan(): number;
-    /** 单元格类型 */
+    /** cell type / 单元格类型 */
     get subtype(): TdSubtypes;
     /**
      * @param syntax 单元格语法
      * @param inner 内部wikitext
      */
     constructor(syntax: string, inner?: string, config?: Parser.Config, accum?: Token[]);
-    /** 是否位于行首 */
+    /**
+     * Check if the cell is at the beginning of a line
+     *
+     * 是否位于行首
+     */
     isIndependent(): boolean;
     getAttr<T extends string>(key: T): TdAttrGetter<T>;
 }

package/dist/src/table/td.js

@@ -8,7 +8,9 @@ const index_1 = require("../../index");
 const index_2 = require("../index");
 const base_1 = require("./base");
 /**
- * `<td>`、`<th>`和`<caption>`
+ * `<td>`, `<th>` or `<caption>`
+ *
+ * `<td>`、`<th>`或`<caption>`
  * @classdesc `{childNodes: [SyntaxToken, AttributesToken, Token]}`
  */
 class TdToken extends base_1.TableBaseToken {
@@ -25,7 +27,7 @@ class TdToken extends base_1.TableBaseToken {
     get colspan() {
         return this.getAttr('colspan');
     }
-    /** 单元格类型 */
+    /** cell type / 单元格类型 */
     get subtype() {
         return this.#getSyntax().subtype;
     }
@@ -126,7 +128,11 @@ class TdToken extends base_1.TableBaseToken {
         }
         return errors;
     }
-    /** 是否位于行首 */
+    /**
+     * Check if the cell is at the beginning of a line
+     *
+     * 是否位于行首
+     */
     isIndependent() {
         return this.firstChild.text().startsWith('\n');
     }

package/dist/src/table/tr.d.ts

@@ -2,8 +2,10 @@ import { TrBaseToken } from './trBase';
 import type { Config } from '../../base';
 import type { Token, TdToken, TableToken, SyntaxToken, AttributesToken } from '../../internal';
 /**
+ * table row that contains the newline at the beginning but not at the end
+ *
  * 表格行，含开头的换行，不含结尾的换行
- * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken]}`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken[]]}`
  */
 export declare abstract class TrToken extends TrBaseToken {
     readonly childNodes: readonly [SyntaxToken, AttributesToken, ...TdToken[]];

package/dist/src/table/tr.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.TrToken = void 0;
 const trBase_1 = require("./trBase");
 /**
+ * table row that contains the newline at the beginning but not at the end
+ *
  * 表格行，含开头的换行，不含结尾的换行
- * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken]}`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken[]]}`
  */
 class TrToken extends trBase_1.TrBaseToken {
     get type() {
@@ -15,7 +17,7 @@ class TrToken extends trBase_1.TrBaseToken {
      * @param attr 表格属性
      */
     constructor(syntax, attr, config, accum) {
-        super(/^\n[^\S\n]*(?:\|-+|\{\{\s*!\s*\}\}-+|\{\{\s*!-\s*\}\}-*)$/u, syntax, 'tr', attr, config, accum, {});
+        super(/^\n[^\S\n]*(?:\|-+|\{\{\s*!\s*\}\}-+|\{\{\s*!-\s*\}\}-*)$/u, syntax, 'tr', attr, config, accum);
     }
 }
 exports.TrToken = TrToken;

package/dist/src/table/trBase.d.ts

@@ -1,5 +1,4 @@
 import { TableBaseToken } from './base';
-import { TdToken } from './td';
 import type { LintError } from '../../base';
 export interface TableCoords {
     readonly row: number;
@@ -8,16 +7,17 @@ export interface TableCoords {
     readonly y?: undefined;
     readonly start?: boolean;
 }
-/** 表格行或表格 */
+/**
+ * table row or table
+ *
+ * 表格行或表格
+ */
 export declare abstract class TrBaseToken extends TableBaseToken {
     abstract get type(): 'table' | 'tr';
-    /** 获取行数 */
-    getRowCount(): number;
     /**
-     * 获取第n列
-     * @param n 列号
-     * @param insert 是否用于判断插入新列的位置
-     * @throws `RangeError` 不存在对应单元格
+     * Get the number of rows
+     *
+     * 获取行数
      */
-    getNthCol(n: number, insert?: false): TdToken | undefined;
+    getRowCount(): number;
 }

package/dist/src/table/trBase.js

@@ -4,7 +4,11 @@ exports.TrBaseToken = void 0;
 const lint_1 = require("../../util/lint");
 const base_1 = require("./base");
 const td_1 = require("./td");
-/** 表格行或表格 */
+/**
+ * table row or table
+ *
+ * 表格行或表格
+ */
 class TrBaseToken extends base_1.TableBaseToken {
     /** @private */
     lint(start = this.getAbsoluteIndex(), re) {
@@ -34,24 +38,15 @@ class TrBaseToken extends base_1.TableBaseToken {
         errors.push(error);
         return errors;
     }
-    /** 获取行数 */
+    /**
+     * Get the number of rows
+     *
+     * 获取行数
+     */
     getRowCount() {
-        return Number(this.childNodes.some(child => child instanceof td_1.TdToken && child.isIndependent() && !child.firstChild.text().endsWith('+')));
-    }
-    getNthCol(n, insert) {
-        let last = 0;
-        for (const child of this.childNodes.slice(2)) {
-            if (child instanceof td_1.TdToken) {
-                if (child.isIndependent()) {
-                    last = Number(child.subtype !== 'caption');
-                }
-                n -= last;
-                if (n < 0) {
-                    return child;
-                }
-            }
-        }
-        return undefined;
+        return Number(this.childNodes.some(child => child instanceof td_1.TdToken
+            && child.isIndependent()
+            && !child.firstChild.text().endsWith('+')));
     }
 }
 exports.TrBaseToken = TrBaseToken;

package/dist/src/tagPair/ext.d.ts

@@ -7,6 +7,8 @@ import type { AttributesParentBase } from '../../mixin/attributesParent';
 export interface ExtToken extends AttributesParentBase {
 }
 /**
+ * extension tag
+ *
  * 扩展标签
  * @classdesc `{childNodes: [AttributesToken, Token]}`
  */
@@ -18,10 +20,10 @@ export declare abstract class ExtToken extends TagPairToken {
     get type(): 'ext';
     /**
      * @param name 标签名
-     * @param include 是否嵌入
      * @param attr 标签属性
      * @param inner 内部wikitext
      * @param closed 是否封闭
+     * @param include 是否嵌入
      */
     constructor(name: string, attr?: string, inner?: string, closed?: string, config?: Parser.Config, include?: boolean, accum?: Token[]);
 }

package/dist/src/tagPair/ext.js

@@ -59,6 +59,8 @@ const del = (arr, ele) => {
     return [...set];
 };
 /**
+ * extension tag
+ *
  * 扩展标签
  * @classdesc `{childNodes: [AttributesToken, Token]}`
  */
@@ -82,10 +84,10 @@ let ExtToken = (() => {
         }
         /**
          * @param name 标签名
-         * @param include 是否嵌入
          * @param attr 标签属性
          * @param inner 内部wikitext
          * @param closed 是否封闭
+         * @param include 是否嵌入
          */
         constructor(name, attr, inner, closed, config = index_1.default.getConfig(), include = false, accum = []) {
             const lcName = name.toLowerCase(), 

package/dist/src/tagPair/include.d.ts

@@ -2,6 +2,8 @@ import { TagPairToken } from './index';
 import type { LintError, Config } from '../../base';
 import type { AstText, Token } from '../../internal';
 /**
+ * `<includeonly>`, `<noinclude>` or `<onlyinclude>`
+ *
  * `<includeonly>`或`<noinclude>`或`<onlyinclude>`
  * @classdesc `{childNodes: [AstText, AstText]}`
  */

package/dist/src/tagPair/include.js

@@ -41,6 +41,8 @@ const hidden_1 = require("../../mixin/hidden");
 const index_1 = require("../../index");
 const index_2 = require("./index");
 /**
+ * `<includeonly>`, `<noinclude>` or `<onlyinclude>`
+ *
  * `<includeonly>`或`<noinclude>`或`<onlyinclude>`
  * @classdesc `{childNodes: [AstText, AstText]}`
  */

package/dist/src/tagPair/index.d.ts

@@ -1,7 +1,11 @@
 import { Token } from '../index';
 import type { Config } from '../../base';
 import type { AstNodes } from '../../lib/node';
-/** 成对标签 */
+/**
+ * Paired tags
+ *
+ * 成对标签
+ */
 export declare abstract class TagPairToken extends Token {
     #private;
     readonly name: string;
@@ -11,7 +15,7 @@ export declare abstract class TagPairToken extends Token {
     readonly childNodes: readonly [AstNodes, AstNodes];
     abstract get firstChild(): AstNodes;
     abstract get lastChild(): AstNodes;
-    /** 内部wikitext */
+    /** inner wikitext / 内部wikitext */
     get innerText(): string | undefined;
     /**
      * @param name 标签名

package/dist/src/tagPair/index.js

@@ -2,12 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TagPairToken = void 0;
 const index_1 = require("../index");
-/** 成对标签 */
+/**
+ * Paired tags
+ *
+ * 成对标签
+ */
 class TagPairToken extends index_1.Token {
     #tags;
     closed;
     selfClosing;
-    /** 内部wikitext */
+    /** inner wikitext / 内部wikitext */
     get innerText() {
         return this.selfClosing ? undefined : this.lastChild.text();
     }

package/dist/src/transclude.d.ts

@@ -6,8 +6,10 @@ import { SyntaxToken } from './syntax';
 import type { LintError } from '../base';
 declare type Child = AtomToken | SyntaxToken;
 /**
+ * template or magic word
+ *
  * 模板或魔术字
- * @classdesc `{childNodes: [AtomToken|SyntaxToken, ...AtomToken, ...ParameterToken]}`
+ * @classdesc `{childNodes: [AtomToken|SyntaxToken, ...AtomToken[], ...ParameterToken[]]}`
  */
 export declare abstract class TranscludeToken extends Token {
     #private;
@@ -24,39 +26,61 @@ export declare abstract class TranscludeToken extends Token {
      */
     constructor(title: string, parts: ([string] | [string | number, string])[], config?: Parser.Config, accum?: Token[]);
     /**
+     * Set the transclusion modifier
+     *
      * 设置引用修饰符
-     * @param modifier 引用修饰符
+     * @param modifier transclusion modifier / 引用修饰符
      */
     setModifier(modifier: string): boolean;
-    /** 是否是模板或模块 */
+    /**
+     * Check if it is a template or a module
+     *
+     * 是否是模板或模块
+     */
     isTemplate(): boolean;
     /**
+     * Get the module name and module function name
+     *
      * 获取模块名和模块函数名
      * @throws `Error` 仅用于模块
      */
     getModule(): [string, string | undefined];
     /**
      * @override
-     * @param token 待插入的子节点
-     * @param i 插入位置
+     * @param token node to be inserted / 待插入的子节点
+     * @param i position to be inserted at / 插入位置
      */
     insertAt<T extends ParameterToken>(token: T, i?: number): T;
-    /** 获取所有参数 */
+    /**
+     * Get all parameters
+     *
+     * 获取所有参数
+     */
     getAllArgs(): ParameterToken[];
-    /** 获取所有匿名参数 */
+    /**
+     * Get all anonymous parameters
+     *
+     * 获取所有匿名参数
+     */
     getAnonArgs(): ParameterToken[];
     /**
+     * Get parameters with the specified name
+     *
      * 获取指定参数
-     * @param key 参数名
-     * @param exact 是否匹配匿名性
-     * @param copy 是否返回一个备份
+     * @param key parameter name / 参数名
+     * @param exact whether to match anonymosity / 是否匹配匿名性
+     * @param copy whether to return a copy / 是否返回一个备份
      */
     getArgs(key: string | number, exact?: boolean, copy?: boolean): Set<ParameterToken>;
     /**
+     * Get duplicated parameters
+     *
      * 获取重名参数
      */
     getDuplicatedArgs(): [string, ParameterToken[]][];
     /**
+     * Get possible values of some magic words
+     *
      * 对特定魔术字获取可能的取值
      * @throws `Error` 不是可接受的魔术字
      */