wikiparser-node 1.18.2 → 1.18.4

package/dist/lib/title.d.ts

@@ -1,4 +1,10 @@
 import type { Config } from '../base';
+export interface TitleOptions {
+    temporary?: boolean | undefined;
+    decode?: boolean | undefined;
+    selfLink?: boolean | undefined;
+    halfParsed?: boolean | undefined;
+}
 /**
  * title object of a MediaWiki page
  *
@@ -19,7 +25,10 @@ export declare class Title {
     get prefix(): string;
     /** full title / 完整标题 */
     get title(): string;
-    /** file extension / 扩展名 */
+    /**
+     * file extension / 扩展名
+     * @since v1.1.0
+     */
     get extension(): string | undefined;
     set extension(extension: string | undefined);
     /** @throws `RangeError` undefined namespace */
@@ -30,14 +39,18 @@ export declare class Title {
      *
      * @param title 标题（含或不含命名空间前缀）
      * @param defaultNs 命名空间
-     * @param decode 是否需要解码
-     * @param selfLink 是否允许selfLink
+     * @param config
+     * @param opt 选项
+     * @param opt.temporary 是否是临时标题
+     * @param opt.decode 是否需要解码
+     * @param opt.selfLink 是否允许selfLink
      */
-    constructor(title: string, defaultNs: number, config: Config, temporary: boolean, decode: boolean, selfLink: boolean);
+    constructor(title: string, defaultNs: number, config: Config, { temporary, decode, selfLink }?: TitleOptions);
     /**
      * Check if the title is a redirect
      *
      * 检测是否是重定向
+     * @since v1.12.2
      */
     getRedirection(): [boolean, string];
     /**
@@ -45,6 +58,7 @@ export declare class Title {
      *
      * 生成URL
      * @param articlePath article path / 条目路径
+     * @since v1.10.0
      */
     getUrl(articlePath?: string): string;
     /**
@@ -57,30 +71,35 @@ export declare class Title {
      * Get the title of its subject page
      *
      * 转换为主页面
+     * @since v1.1.0
      */
     toSubjectPage(): void;
     /**
      * Get the title of its talk page
      *
      * 转换为讨论页面
+     * @since v1.1.0
      */
     toTalkPage(): void;
     /**
      * Check if the title is a talk page
      *
      * 是否是讨论页
+     * @since v1.1.0
      */
     isTalkPage(): boolean;
     /**
      * Get the title of its base page
      *
      * 转换为上一级页面
+     * @since v1.1.0
      */
     toBasePage(): void;
     /**
      * Get the title of its root page
      *
      * 转换为根页面
+     * @since v1.1.0
      */
     toRootPage(): void;
 }

package/dist/lib/title.js

@@ -8,7 +8,6 @@ const string_1 = require("../util/string");
 /* NOT FOR BROWSER */
 const constants_1 = require("../util/constants");
 const index_1 = __importDefault(require("../index"));
-/* NOT FOR BROWSER END */
 /**
  * title object of a MediaWiki page
  *
@@ -56,7 +55,10 @@ class Title {
     get title() {
         return this.getRedirection()[1];
     }
-    /** file extension / 扩展名 */
+    /**
+     * file extension / 扩展名
+     * @since v1.1.0
+     */
     get extension() {
         const { main } = this, i = main.lastIndexOf('.');
         return i === -1 ? undefined : main.slice(i + 1).toLowerCase();
@@ -97,10 +99,13 @@ class Title {
      *
      * @param title 标题（含或不含命名空间前缀）
      * @param defaultNs 命名空间
-     * @param decode 是否需要解码
-     * @param selfLink 是否允许selfLink
+     * @param config
+     * @param opt 选项
+     * @param opt.temporary 是否是临时标题
+     * @param opt.decode 是否需要解码
+     * @param opt.selfLink 是否允许selfLink
      */
-    constructor(title, defaultNs, config, temporary, decode, selfLink) {
+    constructor(title, defaultNs, config, { temporary, decode, selfLink } = {}) {
         const subpage = title.trim().startsWith('../');
         if (decode && title.includes('%')) {
             try {
@@ -174,6 +179,7 @@ class Title {
      * Check if the title is a redirect
      *
      * 检测是否是重定向
+     * @since v1.12.2
      */
     getRedirection() {
         const prefix = this.interwiki + (this.interwiki && ':') + // eslint-disable-line @stylistic/operator-linebreak
@@ -202,6 +208,7 @@ class Title {
      *
      * 生成URL
      * @param articlePath article path / 条目路径
+     * @since v1.10.0
      */
     getUrl(articlePath) {
         LSP: { // eslint-disable-line no-unused-labels
@@ -267,6 +274,7 @@ class Title {
      * Get the title of its subject page
      *
      * 转换为主页面
+     * @since v1.1.0
      */
     toSubjectPage() {
         if (this.isTalkPage()) {
@@ -277,6 +285,7 @@ class Title {
      * Get the title of its talk page
      *
      * 转换为讨论页面
+     * @since v1.1.0
      */
     toTalkPage() {
         if (!this.isTalkPage()) {
@@ -287,6 +296,7 @@ class Title {
      * Check if the title is a talk page
      *
      * 是否是讨论页
+     * @since v1.1.0
      */
     isTalkPage() {
         return this.ns % 2 === 1;
@@ -295,6 +305,7 @@ class Title {
      * Get the title of its base page
      *
      * 转换为上一级页面
+     * @since v1.1.0
      */
     toBasePage() {
         this.main = this.main.replace(/\/[^/]*$/u, '');
@@ -303,6 +314,7 @@ class Title {
      * Get the title of its root page
      *
      * 转换为根页面
+     * @since v1.1.0
      */
     toRootPage() {
         this.main = this.main.replace(/\/.*/u, '');

package/dist/mixin/noEscape.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 不需要转义的类
+ * @ignore
+ */

package/dist/mixin/noEscape.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.noEscape = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/**
+ * 不需要转义的类
+ * @ignore
+ */
+const noEscape = (constructor, _) => {
+    /** 不可包含换行符的类 */
+    class NoEscapeToken extends constructor {
+        /** @private */
+        escape() {
+            //
+        }
+    }
+    (0, debug_1.mixin)(NoEscapeToken, constructor);
+    return NoEscapeToken;
+};
+exports.noEscape = noEscape;
+constants_1.mixins['noEscape'] = __filename;

package/dist/mixin/readOnly.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 只读或可写的方法
+ * @param readonly 是否只读
+ */

package/dist/mixin/readOnly.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readOnly = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+const index_1 = __importDefault(require("../index"));
+/**
+ * 只读或可写的方法
+ * @param readonly 是否只读
+ */
+const readOnly = (readonly = false) => 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+(method) => function (...args) {
+    const { viewOnly } = index_1.default;
+    if (!debug_1.Shadow.running) {
+        index_1.default.viewOnly = readonly;
+    }
+    const result = method.apply(this, args);
+    index_1.default.viewOnly = viewOnly;
+    return result;
+};
+exports.readOnly = readOnly;
+constants_1.mixins['readOnly'] = __filename;

package/dist/parser/braces.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseBraces = void 0;
+const common_1 = require("@bhsd/common");
 const string_1 = require("../util/string");
 const heading_1 = require("../src/heading");
 const transclude_1 = require("../src/transclude");
@@ -8,12 +9,35 @@ const arg_1 = require("../src/arg");
 /* NOT FOR BROWSER */
 const constants_1 = require("../util/constants");
 /* NOT FOR BROWSER END */
+/* NOT FOR BROWSER ONLY */
+const v8_1 = require("v8");
+const MAXHEAP = (0, v8_1.getHeapStatistics)().heap_size_limit * 0.9;
+/* NOT FOR BROWSER ONLY END */
 const closes = {
     '=': String.raw `\n(?!(?:[^\S\n]|\0\d+[cn]\x7F)*\n)`,
     '{': String.raw `\}{2,}|\|`,
     '-': String.raw `\}-`,
     '[': String.raw `\]\]`,
-}, openBraces = String.raw `|\{{2,}`, marks = new Map([['!', '!'], ['!!', '+'], ['(!', '{'], ['!)', '}'], ['!-', '-'], ['=', '~'], ['server', 'm']]);
+}, lbrack = String.raw `\[(?!\[)`, newline = String.raw `\n(?![=\0])`, openBraces = String.raw `|\{{2,}`, marks = new Map([['!', '!'], ['!!', '+'], ['(!', '{'], ['!)', '}'], ['!-', '-'], ['=', '~'], ['server', 'm']]), getExecRegex = (0, common_1.getRegex)(s => new RegExp(s, 'gmu'));
+let reReplace;
+/* NOT FOR BROWSER ONLY */
+try {
+    reReplace = new RegExp(String.raw `(?<!\{)\{\{((?:[^\n{}[]|${lbrack}|${newline})*)\}\}` // eslint-disable-line prefer-template
+        + '|'
+        + String.raw `\{\{((?:[^\n{}[]|${lbrack}|${newline})*)\}\}(?!\})`
+        + '|'
+        + String.raw `\[\[(?:[^\n[\]{]|${newline})*\]\]`
+        + '|'
+        + String.raw `-\{(?:[^\n{}[]|${lbrack}|${newline})*\}-`, 'gu');
+}
+catch {
+    /* NOT FOR BROWSER ONLY END */
+    reReplace = new RegExp(String.raw `\{\{((?:[^\n{}[]|${lbrack}|${newline})*)\}\}(?!\})` // eslint-disable-line prefer-template
+        + '|'
+        + String.raw `\[\[(?:[^\n[\]{]|${newline})*\]\]`
+        + '|'
+        + String.raw `-\{(?:[^\n{}[]|${lbrack}|${newline})*\}-`, 'gu');
+}
 /**
  * 获取模板或魔术字对应的字符
  * @param s 模板或魔术字名
@@ -36,7 +60,8 @@ const getSymbol = (s) => {
  * @param wikitext
  * @param config
  * @param accum
- * @throws TranscludeToken.constructor()
+ * @throws `RangeError` Maximum iteration exceeded
+ * @throws `TranscludeToken.constructor()`
  */
 const parseBraces = (wikitext, config, accum) => {
     const source = String.raw `${config.excludes?.includes('heading') ? '' : String.raw `^((?:\0\d+[cno]\x7F)*)={1,6}|`}\[\[|-\{(?!\{)`, { parserFunction: [, , , subst] } = config, stack = [], linkStack = [];
@@ -45,48 +70,63 @@ const parseBraces = (wikitext, config, accum) => {
      * @param s 不含内链的字符串
      */
     const restore = (s) => s.replace(/\0(\d+)\x7F/gu, (_, p1) => linkStack[p1]);
-    wikitext = wikitext.replace(/\{\{([^\n{}[]*)\}\}(?!\})|\[\[[^\n[\]{]*\]\]/gu, (m, p1) => {
-        if (p1 !== undefined) {
-            try {
-                const { length } = accum, parts = p1.split('|');
-                // @ts-expect-error abstract class
-                new transclude_1.TranscludeToken(parts[0], parts.slice(1).map(part => {
-                    const i = part.indexOf('=');
-                    return i === -1 ? [part] : [part.slice(0, i), part.slice(i + 1)];
-                }), config, accum);
-                return `\0${length}${getSymbol(parts[0])}\x7F`;
-            }
-            catch (e) {
-                /* istanbul ignore if */
-                if (!(e instanceof SyntaxError) || e.message !== 'Invalid template name') {
-                    throw e;
+    /**
+     * 填入模板内容
+     * @param text wikitext全文
+     * @param parts 模板参数
+     * @param lastIndex 匹配的起始位置
+     * @param index 匹配位置
+     */
+    const push = (text, parts, lastIndex, index) => {
+        parts[parts.length - 1].push(restore(text.slice(lastIndex, index)));
+    };
+    let replaced;
+    do {
+        if (replaced !== undefined) {
+            wikitext = replaced;
+        }
+        replaced = wikitext.replace(reReplace, (m, p1, p2) => {
+            if (p1 !== undefined || typeof p2 === 'string') {
+                try {
+                    const { length } = accum, parts = (p1 ?? p2).split('|');
+                    // @ts-expect-error abstract class
+                    new transclude_1.TranscludeToken(restore(parts[0]), parts.slice(1).map(part => {
+                        const i = part.indexOf('=');
+                        return (i === -1 ? [part] : [part.slice(0, i), part.slice(i + 1)]).map(restore);
+                    }), config, accum);
+                    return `\0${length}${getSymbol(parts[0])}\x7F`;
+                }
+                catch (e) {
+                    /* istanbul ignore if */
+                    if (!(e instanceof SyntaxError) || e.message !== 'Invalid template name') {
+                        throw e;
+                    }
                 }
             }
-        }
-        linkStack.push(m);
-        return `\0${linkStack.length - 1}\x7F`;
-    });
+            linkStack.push(restore(m));
+            return `\0${linkStack.length - 1}\x7F`;
+        });
+    } while (replaced !== wikitext);
+    wikitext = replaced;
     const lastBraces = wikitext.lastIndexOf('}}') - wikitext.length;
     let moreBraces = lastBraces + wikitext.length !== -1;
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     /^((?:\0\d+[cno]\x7F)*)={1,6}|\[\[|-\{(?!\{)|\{{2,}|\n(?!(?:[^\S\n]|\0\d+[cn]\x7F)*\n)|[|=]|\}{2,}|\}-|\]\]/gmu;
-    let regex = new RegExp(source + (moreBraces ? openBraces : ''), 'gmu'), mt = regex.exec(wikitext), lastIndex;
+    let regex = getExecRegex(source + (moreBraces ? openBraces : '')), mt = regex.exec(wikitext), lastIndex;
     while (mt
         || lastIndex !== undefined && lastIndex <= wikitext.length
             && stack[stack.length - 1]?.[0]?.startsWith('=')) {
+        /* NOT FOR BROWSER ONLY */
+        if (process.memoryUsage().heapUsed > MAXHEAP) {
+            throw new RangeError('Maximum heap size exceeded');
+        }
+        /* NOT FOR BROWSER ONLY END */
         if (mt?.[1]) {
             const [, { length }] = mt;
             mt[0] = mt[0].slice(length);
             mt.index += length;
         }
         const { 0: syntax, index: curIndex } = mt ?? { 0: '\n', index: wikitext.length }, top = stack.pop() ?? {}, { 0: open, index, parts, findEqual: topFindEqual, pos: topPos } = top, innerEqual = syntax === '=' && topFindEqual;
-        /**
-         * 填入模板内容
-         * @param text wikitext全文
-         */
-        const push = (text) => {
-            parts[parts.length - 1].push(restore(text.slice(topPos, curIndex)));
-        };
         if (syntax === ']]' || syntax === '}-') { // 情形1：闭合内链或转换
             lastIndex = curIndex + 2;
         }
@@ -97,17 +137,19 @@ const parseBraces = (wikitext, config, accum) => {
                 const rmt = /^(={1,6})(.+)\1((?:\s|\0\d+[cn]\x7F)*)$/u
                     .exec(wikitext.slice(index, curIndex));
                 if (rmt) {
-                    wikitext = `${wikitext.slice(0, index)}\0${accum.length}h\x7F${wikitext.slice(curIndex)}`;
-                    lastIndex = index + 4 + String(accum.length).length;
                     rmt[2] = restore(rmt[2]);
-                    // @ts-expect-error abstract class
-                    new heading_1.HeadingToken(rmt[1].length, rmt.slice(2), config, accum);
+                    if (!rmt[2].includes('\n')) {
+                        wikitext = `${wikitext.slice(0, index)}\0${accum.length}h\x7F${wikitext.slice(curIndex)}`;
+                        lastIndex = index + 4 + String(accum.length).length;
+                        // @ts-expect-error abstract class
+                        new heading_1.HeadingToken(rmt[1].length, rmt.slice(2), config, accum);
+                    }
                 }
             }
         }
         else if (syntax === '|' || innerEqual) { // 情形3：模板内部，含行首单个'='
             lastIndex = curIndex + 1;
-            push(wikitext);
+            push(wikitext, parts, topPos, curIndex);
             if (syntax === '|') {
                 parts.push([]);
             }
@@ -118,7 +160,7 @@ const parseBraces = (wikitext, config, accum) => {
         else if (syntax.startsWith('}}')) { // 情形4：闭合模板
             const close = syntax.slice(0, Math.min(open.length, 3)), rest = open.length - close.length, { length } = accum;
             lastIndex = curIndex + close.length; // 这不是最终的lastIndex
-            push(wikitext);
+            push(wikitext, parts, topPos, curIndex);
             let skip = false, ch = 't';
             if (close.length === 3) {
                 const argParts = parts.map(part => part.join('=')), str = argParts.length > 1 && (0, string_1.removeComment)(argParts[1]).trim();
@@ -173,9 +215,9 @@ const parseBraces = (wikitext, config, accum) => {
             }
         }
         /\{\{\s*([!=]|!!|\(!|!\)|!-)\s*\}\}(?!\})/gu; // eslint-disable-line @typescript-eslint/no-unused-expressions
-        regex = new RegExp(source
+        regex = getExecRegex(source
             + (moreBraces ? openBraces : '')
-            + (curTop ? `|${closes[curTop[0][0]]}${curTop.findEqual ? '|=' : ''}` : ''), 'gmu');
+            + (curTop ? `|${closes[curTop[0][0]]}${curTop.findEqual ? '|=' : ''}` : ''));
         regex.lastIndex = lastIndex;
         mt = regex.exec(wikitext);
     }

package/dist/parser/commentAndExt.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseCommentAndExt = void 0;
+const common_1 = require("@bhsd/common");
 const onlyinclude_1 = require("../src/onlyinclude");
 const noinclude_1 = require("../src/nowiki/noinclude");
 const include_1 = require("../src/tagPair/include");
@@ -9,24 +10,12 @@ const comment_1 = require("../src/nowiki/comment");
 /* NOT FOR BROWSER */
 const constants_1 = require("../util/constants");
 /* NOT FOR BROWSER END */
-const onlyincludeLeft = '<onlyinclude>', onlyincludeRight = '</onlyinclude>', { length } = onlyincludeLeft, regexInclude = new WeakMap(), regexNoinclude = new WeakMap();
-/**
- * 获取正则表达式
- * @param ext 扩展标签
- * @param includeOnly 是否嵌入
- */
-const getRegex = (ext, includeOnly) => {
-    const regex = includeOnly ? regexInclude : regexNoinclude;
-    if (regex.has(ext)) {
-        return regex.get(ext);
-    }
+const onlyincludeLeft = '<onlyinclude>', onlyincludeRight = '</onlyinclude>', { length } = onlyincludeLeft, getRegex = [false, true].map(includeOnly => {
     const noincludeRegex = includeOnly ? 'includeonly' : '(?:no|only)include', includeRegex = includeOnly ? 'noinclude' : 'includeonly';
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     /<!--[\s\S]*?(?:-->|$)|<foo(?:\s[^>]*)?\/?>|<\/foo\s*>|<(bar)(\s[^>]*?)?(?:\/>|>([\s\S]*?)<\/(\1\s*)>)|<(baz)(\s[^>]*?)?(?:\/>|>([\s\S]*?)(?:<\/(baz\s*)>|$))/giu;
-    const re = new RegExp(String.raw `<!--[\s\S]*?(?:-->|$)|<${noincludeRegex}(?:\s[^>]*)?/?>|</${noincludeRegex}\s*>|<(${ext.join('|')})(\s[^>]*?)?(?:/>|>([\s\S]*?)</(\1\s*)>)|<(${includeRegex})(\s[^>]*?)?(?:/>|>([\s\S]*?)(?:</(${includeRegex}\s*)>|$))`, 'giu');
-    regex.set(ext, re);
-    return re;
-};
+    return (0, common_1.getRegex)(ext => new RegExp(String.raw `<!--[\s\S]*?(?:-->|$)|<${noincludeRegex}(?:\s[^>]*)?/?>|</${noincludeRegex}\s*>|<(${ext.join('|')})(\s[^>]*?)?(?:/>|>([\s\S]*?)</(\1\s*)>)|<(${includeRegex})(\s[^>]*?)?(?:/>|>([\s\S]*?)(?:</(${includeRegex}\s*)>|$))`, 'giu'));
+});
 /**
  * 更新`<onlyinclude>`和`</onlyinclude>`的位置
  * @param wikitext
@@ -72,7 +61,7 @@ const parseCommentAndExt = (wikitext, config, accum, includeOnly) => {
             return str;
         }
     }
-    return wikitext.replace(getRegex(config.ext, includeOnly), (substr, name, attr, inner, closing, include, includeAttr, includeInner, includeClosing) => {
+    return wikitext.replace(getRegex[includeOnly ? 1 : 0](config.ext), (substr, name, attr, inner, closing, include, includeAttr, includeInner, includeClosing) => {
         const l = accum.length;
         let ch = 'n';
         if (name) {

package/dist/parser/links.js

@@ -56,7 +56,7 @@ const parseLinks = (wikitext, config, accum, tidy) => {
         }
         const { ns, valid, 
         /* NOT FOR BROWSER */
-        interwiki, } = index_1.default.normalizeTitle(link, 0, false, config, true, true, true, true);
+        interwiki, } = index_1.default.normalizeTitle(link, 0, false, config, { halfParsed: true, temporary: true, decode: true, selfLink: true });
         if (!valid) {
             s += `[[${x}`;
             continue;

package/dist/parser/quotes.js

@@ -79,7 +79,7 @@ const parseQuotes = (wikitext, config, accum, tidy) => {
     /* NOT FOR BROWSER */
     if (tidy && (!bold || !italic)) {
         // @ts-expect-error abstract class
-        new quote_1.QuoteToken((bold ? '' : "'''") + (italic ? '' : "''"), { bold: !bold, italic: !italic }, config, accum);
+        new quote_1.QuoteToken((bold ? '' : `'''`) + (italic ? '' : `''`), { bold: !bold, italic: !italic }, config, accum);
         arr.push(`\0${accum.length - 1}q\x7F`);
     }
     /* NOT FOR BROWSER END */

package/dist/parser/redirect.js

@@ -21,9 +21,7 @@ const parseRedirect = (text, config, accum) => {
     config.regexRedirect ??= new RegExp(String.raw `^(\s*)((?:${config.redirection.join('|')})\s*(?::\s*)?)\[\[([^\n|\]]+)(\|.*?)?\]\](\s*)`, 'iu');
     const mt = config.regexRedirect.exec(text);
     if (mt
-        && index_1.default
-            .normalizeTitle(mt[3], 0, false, config, true, true, true)
-            .valid) {
+        && index_1.default.normalizeTitle(mt[3], 0, false, config, { halfParsed: true, temporary: true, decode: true }).valid) {
         text = `\0${accum.length}o\x7F${text.slice(mt[0].length)}`;
         // @ts-expect-error abstract class
         new redirect_1.RedirectToken(...mt.slice(1), config, accum);