wikiparser-node 1.16.4 → 1.16.5

package/dist/src/hidden.d.ts

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

package/dist/src/hidden.js

@@ -41,7 +41,11 @@ const index_1 = require("./index");
 const debug_1 = require("../util/debug");
 const constants_1 = require("../util/constants");
 /* NOT FOR BROWSER END */
-/** 不可见的节点 */
+/**
+ * invisible token
+ *
+ * 不可见的节点
+ */
 let HiddenToken = (() => {
     let _classDecorators = [(0, hidden_1.hiddenToken)()];
     let _classDescriptor;
@@ -68,9 +72,9 @@ let HiddenToken = (() => {
             });
         }
         cloneNode() {
-            const cloned = this.cloneChildNodes(), config = this.getAttribute('config');
+            const cloned = this.cloneChildNodes();
             return debug_1.Shadow.run(() => {
-                const token = new HiddenToken(undefined, config, []);
+                const token = new HiddenToken(undefined, this.getAttribute('config'), []);
                 token.append(...cloned);
                 return token;
             });

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]}`
  */
@@ -18,9 +20,9 @@ export declare abstract class HtmlToken extends Token {
     abstract get firstElementChild(): AttributesToken;
     abstract get lastElementChild(): AttributesToken;
     get type(): 'html';
-    /** 是否自封闭 */
+    /** whether to be self-closing / 是否自封闭 */
     get selfClosing(): boolean;
-    /** 是否是闭合标签 */
+    /** whether to be a closing tag / 是否是闭合标签 */
     get closing(): boolean;
     /** @throws `Error` 自封闭标签或空标签 */
     set closing(value: boolean);
@@ -34,22 +36,26 @@ 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` 无效自封闭标签
      * @throws `SyntaxError` 未匹配的标签
      */
     findMatchingTag(): this | undefined;
-    /** @override */
-    json(): AST;
     cloneNode(): this;
     /**
+     * Change the tag name
+     *
      * 更换标签名
-     * @param tag 标签名
+     * @param tag tag name / 标签名
      * @throws `RangeError` 非法的HTML标签
      */
     replaceTag(tag: string): void;
     /**
+     * Fix the invalid self-closing tag
+     *
      * 修复无效自封闭标签
      * @throws `Error` 无法修复无效自封闭标签
      */

package/dist/src/html.js

@@ -73,6 +73,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]}`
  */
@@ -98,11 +100,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;
         }
@@ -253,6 +255,8 @@ let HtmlToken = (() => {
             return errors;
         }
         /**
+         * Find the matching tag
+         *
          * 搜索匹配的标签
          * @throws `SyntaxError` 同时闭合和自封闭的标签
          * @throws `SyntaxError` 无效自封闭标签
@@ -297,9 +301,9 @@ let HtmlToken = (() => {
                 post: `${this.#selfClosing ? '/' : ''}>`,
             });
         }
-        /** @override */
-        json() {
-            const json = super.json();
+        /** @private */
+        json(_, start = this.getAbsoluteIndex()) {
+            const json = super.json(undefined, start);
             Object.assign(json, { closing: this.closing, selfClosing: this.#selfClosing });
             return json;
         }
@@ -310,8 +314,10 @@ let HtmlToken = (() => {
             return debug_1.Shadow.run(() => new HtmlToken(this.#tag, attr, this.closing, this.selfClosing, config));
         }
         /**
+         * Change the tag name
+         *
          * 更换标签名
-         * @param tag 标签名
+         * @param tag tag name / 标签名
          * @throws `RangeError` 非法的HTML标签
          */
         replaceTag(tag) {
@@ -323,6 +329,8 @@ let HtmlToken = (() => {
             this.#tag = tag;
         }
         /**
+         * Fix the invalid self-closing tag
+         *
          * 修复无效自封闭标签
          * @throws `Error` 无法修复无效自封闭标签
          */
@@ -333,7 +341,8 @@ let HtmlToken = (() => {
             }
             else if (firstChild.text().trim()) {
                 this.#selfClosing = false;
-                this.after(index_2.default.parse(`</${this.name}>`, false, 3, this.getAttribute('config')).firstChild);
+                this.after(index_2.default.parse(`</${this.name}>`, false, 3, this.getAttribute('config'))
+                    .firstChild);
                 return;
             }
             const { childNodes } = parentNode, i = childNodes.indexOf(this), prevSiblings = childNodes.slice(0, i)

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, AstNodes, AstText } from '../internal';
 export declare const galleryParams: Set<string>;
-/** 图片参数 */
+/**
+ * image parameter
+ *
+ * 图片参数
+ */
 export declare abstract class ImageParameterToken extends Token {
     #private;
     readonly name: string;
@@ -15,13 +19,13 @@ export declare abstract class ImageParameterToken extends Token {
     abstract get nextElementSibling(): this | undefined;
     abstract get previousElementSibling(): AtomToken | this;
     get type(): 'image-parameter';
-    /** 图片链接 */
+    /** image link / 图片链接 */
     get link(): string | Title | undefined;
     set link(value: string);
-    /** getValue()的getter */
+    /** parameter value / 参数值 */
     get value(): string | true;
     set value(value: string | true);
-    /** 图片大小 */
+    /** iamge size / 图片大小 */
     get size(): {
         width: string;
         height: string;
@@ -30,34 +34,42 @@ export declare abstract class ImageParameterToken extends Token {
         width: string;
         height: string;
     } | undefined);
-    /** 图片宽度 */
+    /** image width / 图片宽度 */
     get width(): string | undefined;
     set width(width: string | undefined);
-    /** 图片高度 */
+    /** image height / 图片高度 */
     get height(): string | undefined;
     set height(height: string | undefined);
     /** @param str 图片参数 */
     constructor(str: string, extension: string | undefined, config?: Parser.Config, accum?: Token[]);
-    /** 获取参数值 */
+    /**
+     * Get the parameter value
+     *
+     * 获取参数值
+     */
     getValue(): string | true;
     cloneNode(): this;
     /**
      * @override
-     * @param token 待插入的子节点
-     * @param i 插入位置
+     * @param token node to be inserted / 待插入的子节点
+     * @param i position to be inserted at / 插入位置
      * @throws `Error` 不接受自定义输入的图片参数
      */
     insertAt(token: string, i?: number): AstText;
     insertAt<T extends AstNodes>(token: T, i?: number): T;
     /**
+     * Set the parameter value
+     *
      * 设置参数值
-     * @param value 参数值
+     * @param value parameter value / 参数值
      * @throws `Error` 无效参数
      */
     setValue(value?: string | boolean): void;
     /**
+     * Get the URL
+     *
      * 获取网址
-     * @param articlePath 条目路径
+     * @param articlePath article path / 条目路径
      */
     getUrl(articlePath?: string): string | undefined;
 }

package/dist/src/imageParameter.js

@@ -31,7 +31,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':
@@ -46,7 +46,11 @@ function validate(key, val, config, halfParsed, ext) {
             return Boolean(value) && !isNaN(value);
     }
 }
-/** 图片参数 */
+/**
+ * image parameter
+ *
+ * 图片参数
+ */
 class ImageParameterToken extends index_2.Token {
     #syntax = '';
     #extension;
@@ -54,7 +58,7 @@ class ImageParameterToken extends index_2.Token {
     get type() {
         return 'image-parameter';
     }
-    /** 图片链接 */
+    /** image link / 图片链接 */
     get link() {
         return this.name === 'link' ? validate('link', super.text(), this.getAttribute('config')) : undefined;
     }
@@ -64,14 +68,14 @@ class ImageParameterToken extends index_2.Token {
             this.setValue(value);
         }
     }
-    /** getValue()的getter */
+    /** parameter value / 参数值 */
     get value() {
         return this.getValue();
     }
     set value(value) {
         this.setValue(value);
     }
-    /** 图片大小 */
+    /** iamge size / 图片大小 */
     get size() {
         if (this.name === 'width') {
             const size = this.getValue().trim().replace(/px$/u, '').trim();
@@ -94,7 +98,7 @@ class ImageParameterToken extends index_2.Token {
             this.setValue(size && size.width + (size.height && 'x') + size.height);
         }
     }
-    /** 图片宽度 */
+    /** image width / 图片宽度 */
     get width() {
         return this.size?.width;
     }
@@ -104,7 +108,7 @@ class ImageParameterToken extends index_2.Token {
             this.setValue((width || '') + (height && 'x') + height);
         }
     }
-    /** 图片高度 */
+    /** image height / 图片高度 */
     get height() {
         return this.size?.height;
     }
@@ -194,7 +198,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();
     }
@@ -222,8 +230,10 @@ class ImageParameterToken extends index_2.Token {
         return super.insertAt(token, i);
     }
     /**
+     * Set the parameter value
+     *
      * 设置参数值
-     * @param value 参数值
+     * @param value parameter value / 参数值
      * @throws `Error` 无效参数
      */
     setValue(value = false) {
@@ -245,8 +255,10 @@ class ImageParameterToken extends index_2.Token {
         }
     }
     /**
+     * Get the URL
+     *
      * 获取网址
-     * @param articlePath 条目路径
+     * @param articlePath article path / 条目路径
      */
     getUrl(articlePath) {
         let { link } = this;

package/dist/src/imagemap.d.ts

@@ -8,7 +8,7 @@ import type { AstText, AttributesToken, ExtToken, AstNodes } 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';
@@ -31,8 +31,8 @@ export declare abstract class ImagemapToken extends Token {
     constructor(inner?: string, config?: Parser.Config, accum?: Token[]);
     /**
      * @override
-     * @param token 待插入的节点
-     * @param i 插入位置
+     * @param token node to be inserted / 待插入的节点
+     * @param i position to be inserted at / 插入位置
      * @throws `Error` 当前缺少合法图片
      * @throws `RangeError` 已有一张合法图片
      */
@@ -40,7 +40,7 @@ export declare abstract class ImagemapToken extends Token {
     insertAt<T extends AstNodes>(token: T, i?: number): T;
     /**
      * @override
-     * @param i 移除位置
+     * @param i position of the child node /移除位置
      * @throws `Error` 禁止移除图片
      */
     removeAt(i: number): AstNodes;

package/dist/src/imagemap.js

@@ -14,7 +14,7 @@ const constants_1 = require("../util/constants");
 const singleLine_1 = require("../mixin/singleLine");
 /**
  * `<imagemap>`
- * @classdesc `{childNodes: ...NoincludeToken, GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)}`
+ * @classdesc `{childNodes: [...NoincludeToken[], GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)[]]}`
  */
 class ImagemapToken extends index_2.Token {
     /* NOT FOR BROWSER END */
@@ -41,8 +41,12 @@ 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, 
+                /* NOT FOR BROWSER */
+                interwiki, } = this.normalizeTitle(file, 0, true, true);
+                if (valid
+                    && !interwiki
+                    && 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);
@@ -61,7 +65,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;
@@ -131,7 +135,7 @@ class ImagemapToken extends index_2.Token {
     }
     /**
      * @override
-     * @param i 移除位置
+     * @param i position of the child node /移除位置
      * @throws `Error` 禁止移除图片
      */
     removeAt(i) {

package/dist/src/imagemapLink.d.ts

@@ -6,6 +6,8 @@ import { ExtLinkToken } from './extLink';
 import type { AstText, ImagemapToken, GalleryImageToken } from '../internal';
 import type { Title } from '../lib/title';
 /**
+ * link inside the `<imagemap>`
+ *
  * `<imagemap>`内的链接
  * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
  */
@@ -23,7 +25,7 @@ export declare abstract class ImagemapLinkToken extends Token {
     abstract get previousElementSibling(): GalleryImageToken | this | NoincludeToken;
     abstract get nextElementSibling(): this | NoincludeToken | undefined;
     get type(): 'imagemap-link';
-    /** 内外链接 */
+    /** internal or external link / 内外链接 */
     get link(): string | Title;
     set link(link: string);
     /**

package/dist/src/imagemapLink.js

@@ -46,6 +46,8 @@ const fixed_1 = require("../mixin/fixed");
 const singleLine_1 = require("../mixin/singleLine");
 /* NOT FOR BROWSER END */
 /**
+ * link inside the `<imagemap>`
+ *
  * `<imagemap>`内的链接
  * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
  */
@@ -69,7 +71,7 @@ let ImagemapLinkToken = (() => {
             return 'imagemap-link';
         }
         /* NOT FOR BROWSER */
-        /** 内外链接 */
+        /** internal or external link / 内外链接 */
         get link() {
             return this.childNodes[1].link;
         }

package/dist/src/index.d.ts

@@ -8,8 +8,10 @@ import { Ranges } from '../lib/ranges';
 import { AstRange } from '../lib/range';
 import type { Range } from '../lib/ranges';
 /**
+ * base class for all tokens
+ *
  * 所有节点的基类
- * @classdesc `{childNodes: ...(AstText|Token)}`
+ * @classdesc `{childNodes: (AstText|Token)[]}`
  */
 export declare class Token extends AstElement {
     #private;
@@ -19,33 +21,39 @@ 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;
     /**
      * @override
-     * @param i 移除位置
+     * @param i position of the child node / 移除位置
      */
     removeAt(i: number): AstNodes;
     /**
+     * Replace with a token of the same type
+     *
      * 替换为同类节点
-     * @param token 待替换的节点
+     * @param token token to be replaced with / 待替换的节点
      * @throws `Error` 不存在父节点
      */
     safeReplaceWith(token: this): void;
     /**
+     * Create an HTML comment
+     *
      * 创建HTML注释
-     * @param data 注释内容
+     * @param data comment content / 注释内容
      */
     createComment(data?: string): CommentToken;
     /**
+     * Create a tag
+     *
      * 创建标签
-     * @param tagName 标签名
+     * @param tagName tag name / 标签名
      * @param options 选项
-     * @param options.selfClosing 是否自封闭
-     * @param options.closing 是否是闭合标签
+     * @param options.selfClosing whether to be a self-closing tag / 是否自封闭
+     * @param options.closing whether to be a closing tag / 是否是闭合标签
      * @throws `RangeError` 非法的标签名
      */
     createElement(tagName: string, options?: {
@@ -53,43 +61,80 @@ export declare class Token extends AstElement {
         closing?: boolean;
     }): IncludeToken | ExtToken | HtmlToken;
     /**
+     * Create a text node
+     *
      * 创建纯文本节点
-     * @param data 文本内容
+     * @param data text content / 文本内容
      */
     createTextNode(data?: string): AstText;
-    /** 创建AstRange对象 */
+    /**
+     * Create an AstRange object
+     *
+     * 创建AstRange对象
+     */
     createRange(): AstRange;
     /**
+     * Check if a title is an interwiki link
+     *
      * 判断标题是否是跨维基链接
      * @param title 标题
      */
     isInterwiki(title: string): RegExpExecArray | null;
-    /** 深拷贝节点 */
+    /**
+     * Deep clone the node
+     *
+     * 深拷贝节点
+     */
     cloneNode(): this;
-    /** 获取全部章节 */
+    /**
+     * Get all sections
+     *
+     * 获取全部章节
+     */
     sections(): AstRange[] | undefined;
     /**
+     * Get a section
+     *
      * 获取指定章节
-     * @param n 章节序号
+     * @param n rank of the section / 章节序号
      */
     section(n: number): AstRange | undefined;
     /**
+     * Get the enclosing HTML tags
+     *
      * 获取指定的外层HTML标签
-     * @param tag HTML标签名
+     * @param tag HTML tag name / HTML标签名
      * @throws `RangeError` 非法的标签或空标签
      */
     findEnclosingHtml(tag?: string): AstRange | undefined;
-    /** 获取全部分类 */
+    /**
+     * Get all categories
+     *
+     * 获取全部分类
+     */
     getCategories(): [string, string | undefined][];
     /**
+     * Expand templates
+     *
      * 展开模板
-     * @param context 模板调用环境
      */
     expand(): Token;
-    /** 解析部分魔术字 */
+    /**
+     * Parse some magic words
+     *
+     * 解析部分魔术字
+     */
     solveConst(): Token;
-    /** 合并普通节点的普通子节点 */
+    /**
+     * Merge plain child tokens of a plain token
+     *
+     * 合并普通节点的普通子节点
+     */
     flatten(): void;
-    /** 生成HTML */
+    /**
+     * Generate HTML
+     *
+     * 生成HTML
+     */
     toHtml(): string;
 }