wikiparser-node 1.16.4 → 1.16.6

package/dist/src/nowiki/quote.js

@@ -41,10 +41,14 @@ const index_1 = require("../../index");
 const base_1 = require("./base");
 /* NOT FOR BROWSER */
 const constants_1 = require("../../util/constants");
-const html_1 = require("../../util/html");
+const debug_1 = require("../../util/debug");
 const syntax_1 = require("../../mixin/syntax");
 /* NOT FOR BROWSER END */
-/** `''`和`'''` */
+/**
+ * `''` and `'''`
+ *
+ * `''`和`'''`
+ */
 let QuoteToken = (() => {
     let _classDecorators = [(0, syntax_1.syntax)(/^(?:'{5}|'{2,3})$/u)];
     let _classDescriptor;
@@ -60,6 +64,9 @@ let QuoteToken = (() => {
             if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
             __runInitializers(_classThis, _classExtraInitializers);
         }
+        /* NOT FOR BROWSER */
+        #closing;
+        /* NOT FOR BROWSER END */
         get type() {
             return 'quote';
         }
@@ -73,6 +80,18 @@ let QuoteToken = (() => {
         get font() {
             return { bold: this.bold, italic: this.italic };
         }
+        /** whether to be closing quotes / 是否闭合 */
+        get closing() {
+            return {
+                ...this.bold ? { bold: this.#closing.bold } : undefined,
+                ...this.italic ? { italic: this.#closing.italic } : undefined,
+            };
+        }
+        /** @param closing 是否闭合 */
+        constructor(wikitext, closing, config, accum) {
+            super(wikitext, config, accum);
+            this.#closing = closing;
+        }
         /* NOT FOR BROWSER END */
         /** @private */
         text() {
@@ -123,22 +142,23 @@ let QuoteToken = (() => {
             }
             return errors;
         }
-        /** @override */
-        json() {
-            const json = super.json();
+        /** @private */
+        json(_, start = this.getAbsoluteIndex()) {
+            const json = super.json(undefined, start);
             Object.assign(json, { bold: this.bold, italic: this.italic });
             return json;
         }
         /* NOT FOR BROWSER */
+        cloneNode() {
+            return debug_1.Shadow.run(
+            // @ts-expect-error abstract class
+            () => new QuoteToken(this.innerText, this.#closing, this.getAttribute('config')));
+        }
         /** @private */
         toHtmlInternal() {
-            const { previousVisibleSibling, nextVisibleSibling } = this;
-            return (!previousVisibleSibling
-                || previousVisibleSibling.type === 'text' && previousVisibleSibling.data.includes('\n'))
-                && nextVisibleSibling?.type === 'text'
-                && nextVisibleSibling.data.startsWith('\n')
-                ? (0, html_1.font)(this)
-                : '';
+            const { closing: { bold, italic } } = this;
+            return (bold ? '</b>' : '') + (italic ? '</i>' : '')
+                + (italic === false ? '<i>' : '') + (bold === false ? '<b>' : '');
         }
     };
     return QuoteToken = _classThis;

package/dist/src/onlyinclude.d.ts

@@ -1,11 +1,13 @@
 import { Token } from './index';
 /**
+ * `<onlyinclude>` during transclusion
+ *
  * 嵌入时的`<onlyinclude>`
- * @classdesc `{childNodes: ...AstText|Token}`
+ * @classdesc `{childNodes: (AstText|Token)[]}`
  */
 export declare class OnlyincludeToken extends Token {
     get type(): 'onlyinclude';
-    /** 内部wikitext */
+    /** inner wikitext / 内部wikitext */
     get innerText(): string;
     /** @throws `RangeError` 不允许包含`</onlyinclude>` */
     set innerText(text: string);

package/dist/src/onlyinclude.js

@@ -8,15 +8,17 @@ const constants_1 = require("../util/constants");
 const index_2 = require("../index");
 /* NOT FOR BROWSER END */
 /**
+ * `<onlyinclude>` during transclusion
+ *
  * 嵌入时的`<onlyinclude>`
- * @classdesc `{childNodes: ...AstText|Token}`
+ * @classdesc `{childNodes: (AstText|Token)[]}`
  */
 class OnlyincludeToken extends index_1.Token {
     get type() {
         return 'onlyinclude';
     }
     /* NOT FOR BROWSER */
-    /** 内部wikitext */
+    /** inner wikitext / 内部wikitext */
     get innerText() {
         return this.text();
     }

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

@@ -5,7 +5,7 @@ import type { LintError } from '../../base';
 import type { AttributesToken, ExtToken } from '../../internal';
 /**
  * `<dynamicpagelist>`
- * @classdesc `{childNodes: ...AtomToken}`
+ * @classdesc `{childNodes: AtomToken[]}`
  */
 export declare abstract class ParamTagToken extends Token {
     readonly name: string;

package/dist/src/paramTag/index.js

@@ -14,7 +14,7 @@ const singleLine_1 = require("../../mixin/singleLine");
 /* NOT FOR BROWSER END */
 /**
  * `<dynamicpagelist>`
- * @classdesc `{childNodes: ...AtomToken}`
+ * @classdesc `{childNodes: AtomToken[]}`
  */
 class ParamTagToken extends index_2.Token {
     /* NOT FOR BROWSER END */

package/dist/src/parameter.d.ts

@@ -3,6 +3,8 @@ import { Token } from './index';
 import type { LintError, AST } from '../base';
 import type { AtomToken, SyntaxToken, TranscludeToken } from '../internal';
 /**
+ * template or magic word parameter
+ *
  * 模板或魔术字参数
  * @classdesc `{childNodes: [Token, Token]}`
  */
@@ -21,40 +23,50 @@ export declare abstract class ParameterToken extends Token {
     abstract get nextElementSibling(): this | undefined;
     abstract get previousElementSibling(): AtomToken | SyntaxToken | this;
     get type(): 'parameter';
-    /** 是否是匿名参数 */
+    /** whether to be anonymous / 是否是匿名参数 */
     get anon(): boolean;
+    /** whether to be a duplicated parameter / 是否是重复参数 */
+    get duplicated(): boolean;
+    set duplicated(value: boolean);
     set anon(value: boolean);
-    /** getValue()的getter */
+    /** parameter value / 参数值 */
     get value(): string;
     set value(value: string);
-    /** 是否是重复参数 */
-    get duplicated(): boolean;
-    set duplicated(value: boolean);
     /**
      * @param key 参数名
      * @param value 参数值
      */
     constructor(key?: string | number, value?: string, config?: Parser.Config, accum?: Token[]);
     text(): string;
-    /** @override */
-    json(): AST;
     cloneNode(): this;
     safeReplaceWith(token: this): void;
-    /** 获取参数值 */
+    /**
+     * Get the parameter value
+     *
+     * 获取参数值
+     */
     getValue(): string;
     /**
+     * Set the parameter value
+     *
      * 设置参数值
-     * @param value 参数值
+     * @param value parameter value / 参数值
      */
     setValue(value: string): void;
     /**
+     * Rename the parameter
+     *
      * 修改参数名
-     * @param key 新参数名
-     * @param force 是否无视冲突命名
+     * @param key new parameter name / 新参数名
+     * @param force whether to rename regardless of conflicts / 是否无视冲突命名
      * @throws `Error` 仅用于模板参数
      * @throws `RangeError` 更名造成重复参数
      */
     rename(key: string, force?: boolean): void;
-    /** 转义 `=` */
+    /**
+     * Ecape `=`
+     *
+     * 转义 `=`
+     */
     escape(): void;
 }

package/dist/src/parameter.js

@@ -48,6 +48,8 @@ const fixed_1 = require("../mixin/fixed");
 /https?:\/\/(?:\[[\da-f:.]+\]|[^[\]<>"\t\n\p{Zs}])[^[\]<>"\0\t\n\p{Zs}]*$/iu;
 const linkRegex = new RegExp(`https?://${string_1.extUrlCharFirst}${string_1.extUrlChar}$`, 'iu');
 /**
+ * template or magic word parameter
+ *
  * 模板或魔术字参数
  * @classdesc `{childNodes: [Token, Token]}`
  */
@@ -70,25 +72,12 @@ let ParameterToken = (() => {
         get type() {
             return 'parameter';
         }
-        /** 是否是匿名参数 */
+        /** whether to be anonymous / 是否是匿名参数 */
         get anon() {
             return this.firstChild.length === 0;
         }
-        /* NOT FOR BROWSER */
-        set anon(value) {
-            if (value) {
-                throw new Error('Cannot convert named parameter to anonymous parameter!');
-            }
-            this.parentNode?.anonToNamed();
-        }
-        /** getValue()的getter */
-        get value() {
-            return this.getValue();
-        }
-        set value(value) {
-            this.setValue(value);
-        }
-        /** 是否是重复参数 */
+        /* PRINT ONLY */
+        /** whether to be a duplicated parameter / 是否是重复参数 */
         get duplicated() {
             try {
                 return Boolean(this.parentNode?.getDuplicatedArgs().some(([key]) => key === this.name));
@@ -97,11 +86,26 @@ let ParameterToken = (() => {
                 return false;
             }
         }
+        /* PRINT ONLY END */
+        /* NOT FOR BROWSER */
         set duplicated(value) {
             if (this.duplicated && !value) {
                 this.parentNode.fixDuplication();
             }
         }
+        set anon(value) {
+            if (value) {
+                throw new Error('Cannot convert named parameter to anonymous parameter!');
+            }
+            this.parentNode?.anonToNamed();
+        }
+        /** parameter value / 参数值 */
+        get value() {
+            return this.getValue();
+        }
+        set value(value) {
+            this.setValue(value);
+        }
         /* NOT FOR BROWSER END */
         /**
          * @param key 参数名
@@ -185,10 +189,10 @@ let ParameterToken = (() => {
         print() {
             return super.print({ sep: this.anon ? '' : '=' });
         }
-        /** @override */
-        json() {
-            const json = super.json();
-            json['anon'] = this.anon;
+        /** @private */
+        json(_, start = this.getAbsoluteIndex()) {
+            const json = super.json(undefined, start);
+            Object.assign(json, { anon: this.anon, duplicated: this.duplicated });
             return json;
         }
         /* NOT FOR BROWSER */
@@ -209,23 +213,32 @@ let ParameterToken = (() => {
             index_1.default.warn(`${this.constructor.name}.safeReplaceWith regress to AstNode.replaceWith.`);
             this.replaceWith(token);
         }
-        /** 获取参数值 */
+        /**
+         * Get the parameter value
+         *
+         * 获取参数值
+         */
         getValue() {
             const value = (0, string_1.removeCommentLine)(this.lastChild.text());
             return this.anon && this.parentNode?.isTemplate() !== false ? value : value.trim();
         }
         /**
+         * Set the parameter value
+         *
          * 设置参数值
-         * @param value 参数值
+         * @param value parameter value / 参数值
          */
         setValue(value) {
-            const { childNodes } = index_1.default.parse(value, this.getAttribute('include'), undefined, this.getAttribute('config'));
+            const { childNodes } = index_1.default
+                .parse(value, this.getAttribute('include'), undefined, this.getAttribute('config'));
             this.lastChild.replaceChildren(...childNodes);
         }
         /**
+         * Rename the parameter
+         *
          * 修改参数名
-         * @param key 新参数名
-         * @param force 是否无视冲突命名
+         * @param key new parameter name / 新参数名
+         * @param force whether to rename regardless of conflicts / 是否无视冲突命名
          * @throws `Error` 仅用于模板参数
          * @throws `RangeError` 更名造成重复参数
          */
@@ -238,7 +251,8 @@ let ParameterToken = (() => {
             else if (anon) {
                 parentNode?.anonToNamed();
             }
-            const root = index_1.default.parse(key, this.getAttribute('include'), undefined, this.getAttribute('config')), name = this.trimName(root, false);
+            const root = index_1.default
+                .parse(key, this.getAttribute('include'), undefined, this.getAttribute('config')), name = this.trimName(root, false);
             if (this.name === name) {
                 index_1.default.warn('The actual parameter name is not changed', name);
             }
@@ -252,7 +266,11 @@ let ParameterToken = (() => {
             }
             this.firstChild.replaceChildren(...root.childNodes);
         }
-        /** 转义 `=` */
+        /**
+         * Ecape `=`
+         *
+         * 转义 `=`
+         */
         escape() {
             for (const child of this.lastChild.childNodes) {
                 if (child.type === 'text') {

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

@@ -9,7 +9,7 @@ const noinclude_1 = require("./nowiki/noinclude");
 const debug_1 = require("../util/debug");
 /**
  * `<pre>`
- * @classdesc `{childNodes: [...AstText|NoincludeToken|ConverterToken]}`
+ * @classdesc `{childNodes: (AstText|NoincludeToken|ConverterToken)[]}`
  */
 class PreToken extends index_2.Token {
     /* NOT FOR BROWSER END */

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

@@ -46,6 +46,8 @@ const debug_1 = require("../util/debug");
 const fixed_1 = require("../mixin/fixed");
 /* NOT FOR BROWSER END */
 /**
+ * redirect
+ *
  * 重定向
  * @classdesc `{childNodes: [SyntaxToken, LinkToken]}`
  */

package/dist/src/syntax.d.ts

@@ -4,7 +4,11 @@ import type { SyntaxBase } from '../mixin/syntax';
 export interface SyntaxToken extends SyntaxBase {
 }
 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

@@ -40,7 +40,11 @@ const index_1 = require("./index");
 const debug_1 = require("../util/debug");
 const constants_1 = require("../util/constants");
 const syntax_1 = require("../mixin/syntax");
-/** 满足特定语法格式的plain Token */
+/**
+ * plain token that satisfies specific grammar syntax
+ *
+ * 满足特定语法格式的plain Token
+ */
 let SyntaxToken = (() => {
     let _classDecorators = [(0, syntax_1.syntax)()];
     let _classDescriptor;

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

@@ -22,7 +22,11 @@ export declare abstract class TableBaseToken extends Token {
      */
     constructor(pattern: RegExp, syntax: string, type: TableTypes, attr?: string, config?: Parser.Config, accum?: Token[], acceptable?: Acceptable);
     cloneNode(): this;
-    /** 转义表格语法 */
+    /**
+     * Escape the table syntax
+     *
+     * 转义表格语法
+     */
     escape(): void;
 }
 export {};

package/dist/src/table/base.js

@@ -16,12 +16,15 @@ const constants_1 = require("../../util/constants");
 const escapeTable = (syntax) => {
     const wikitext = syntax.childNodes.map(child => child.type === 'text'
         ? child.data.replaceAll('|', '{{!}}')
-        : child.toString()).join(''), { childNodes } = index_1.default.parse(wikitext, syntax.getAttribute('include'), 2, syntax.getAttribute('config'));
+        : child.toString()).join(''), { childNodes } = index_1.default
+        .parse(wikitext, syntax.getAttribute('include'), 2, syntax.getAttribute('config'));
     syntax.replaceChildren(...childNodes);
 };
 /**
+ * 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) {
     /* NOT FOR BROWSER END */
@@ -57,7 +60,11 @@ class TableBaseToken extends (0, attributesParent_1.attributesParent)(1)(index_2
             return token;
         });
     }
-    /** 转义表格语法 */
+    /**
+     * Escape the table syntax
+     *
+     * 转义表格语法
+     */
     escape() {
         for (const child of this.childNodes) {
             if (child instanceof syntax_1.SyntaxToken) {