wikiparser-node 1.29.2 → 1.31.0

package/dist/addon/token.js

@@ -8,6 +8,7 @@ const path_1 = __importDefault(require("path"));
 const constants_1 = require("../util/constants");
 const debug_1 = require("../util/debug");
 const string_1 = require("../util/string");
+const redirect_1 = require("../parser/redirect");
 const index_1 = __importDefault(require("../index"));
 const index_2 = require("../src/index");
 const comment_1 = require("../src/nowiki/comment");
@@ -20,6 +21,7 @@ const blockElems = 'table|h1|h2|h3|h4|h5|h6|pre|p|ul|ol|dl', antiBlockElems = 't
     'if',
     'ifeq',
     'ifexist',
+    'iferror',
     'switch',
 ]);
 // eslint-disable-next-line @typescript-eslint/no-unused-expressions
@@ -35,29 +37,46 @@ const closeRegex = new RegExp(String.raw `<(?:\/(?:${blockElems})|${antiBlockEle
  */
 const implicitNewLine = (str, prev) => prev + (prev !== '\n' && /^(?:\{\||[:;#*])/u.test(str) ? `\n${str}` : str);
 /**
- * 比较两个字符串是否相等
- * @param a
- * @param b
- */
-const cmp = (a, b) => a === b || Boolean(a && b) && Number(a) === Number(b);
-/**
- * 解析 if/ifexist/ifeq 解析器函数
- * @param accum
- * @param prev 解析器函数前的字符串
- * @param effective 生效的参数
+ * 加载模板
+ * @param title 模板名
+ * @param config
  */
-const parseIf = (accum, prev, effective) => {
-    if (effective) {
-        // @ts-expect-error sparse array
-        accum[accum.indexOf(effective.lastChild)] = undefined;
-        return implicitNewLine(effective.value, prev);
+const loadTemplate = (title, config) => {
+    if (index_1.default.templates.has(title)) {
+        return title;
+    }
+    else if (index_1.default.templateDir === undefined) {
+        return false;
+    }
+    else if (!path_1.default.isAbsolute(index_1.default.templateDir)) {
+        index_1.default.templateDir = path_1.default.join(__dirname, '..', '..', index_1.default.templateDir);
+    }
+    const file = fs_1.default.readdirSync(index_1.default.templateDir, { withFileTypes: true, recursive: true })
+        .filter(dirent => dirent.isFile())
+        .find(({ name, parentPath }) => {
+        const t = path_1.default.relative(index_1.default.templateDir, path_1.default.join(parentPath, name.replace(/\.(?:wiki|txt)$/iu, ''))).replaceAll('꞉', ':');
+        try {
+            return decodeURIComponent(t) === title;
+        }
+        catch {
+            return t === title;
+        }
+    });
+    if (!file) {
+        return false;
     }
-    return prev;
+    const content = (0, string_1.tidy)(fs_1.default.readFileSync(path_1.default.join(file.parentPath, file.name), 'utf8')), accum = [], parsed = debug_1.Shadow.run(() => (0, redirect_1.parseRedirect)(content, config, accum));
+    if (parsed) {
+        return loadTemplate(accum[0].lastChild.getTitle().title, config);
+    }
+    index_1.default.templates.set(title, content);
+    return title;
 };
 /**
  * 展开模板
  * @param wikitext
  * @param page 页面名称
+ * @param callPage 调用页面名称
  * @param config
  * @param include
  * @param context 模板调用环境
@@ -65,28 +84,63 @@ const parseIf = (accum, prev, effective) => {
  * @param accum
  * @param stack 模板调用栈
  */
-const expand = (wikitext, page, config, include, context, now = index_1.default.now ?? new Date(), accum = [], stack = []) => {
+const expand = (wikitext, page, callPage, config, include, context, now = index_1.default.now, accum = [], stack = []) => {
     const n = accum.length, token = new index_2.Token(wikitext, { ...config, inExt: true }, accum);
     token.type = 'root';
     token.pageName = page;
     token.parseOnce(0, include);
     if (context !== false) {
+        for (const plain of [...accum.slice(n), token]) {
+            if (plain.length !== 1 || plain.firstChild.type !== 'text') {
+                continue;
+            }
+            const { data } = plain.firstChild;
+            if (!/\0\d+g\x7F/u.test(data)) {
+                continue;
+            }
+            const expanded = data.replace(/\0(\d+)g\x7F/gu, (_, i) => {
+                const target = accum[i];
+                if (target.type === 'onlyinclude') {
+                    // @ts-expect-error sparse array
+                    accum[accum.indexOf(target)] = undefined;
+                    return target.firstChild.toString();
+                }
+                const { lastChild } = target;
+                // @ts-expect-error sparse array
+                accum[accum.indexOf(lastChild)] = undefined;
+                return lastChild.firstChild.toString().replace(/\0(\d+)c\x7F[\n ]|\0(\d+)n\x7F|^\n|\n$/gu, (m, p1, p2) => {
+                    if (p1 !== undefined) {
+                        const { innerText } = accum[p1];
+                        return /^T:[^_/\n<>~]+$/u.test(innerText) ? '' : m;
+                    }
+                    else if (p2 !== undefined) {
+                        const { type } = accum[p2];
+                        return type === 'tvar' ? '' : m;
+                    }
+                    return '';
+                });
+            });
+            plain.setText(expanded);
+            if (plain.type === 'parameter-key') {
+                plain.parentNode.trimName((0, string_1.removeCommentLine)(expanded));
+            }
+        }
         token.setText((0, string_1.removeCommentLine)(token.firstChild.toString(), true));
     }
     token.parseOnce();
     for (const plain of [...accum.slice(n), token]) {
-        if (plain.length !== 1 || plain.firstChild.type !== 'text') {
+        if (!plain || plain.length !== 1 || plain.firstChild.type !== 'text') {
             continue;
         }
         const { data } = plain.firstChild;
-        if (!/\0\d+t\x7F/u.test(data)) {
+        if (!/\0\d+[tm]\x7F/u.test(data)) {
             continue;
         }
-        const expanded = data.replace(/([^\x7F]?)\0(\d+)t\x7F/gu, (m, prev, i) => {
+        const expanded = data.replace(/([^\x7F]?)\0(\d+)[tm]\x7F/gu, (m, prev, i) => {
             const target = accum[i], { type, name, length, firstChild: f, childNodes } = target, isTemplate = type === 'template', args = childNodes.slice(1);
             if (type === 'arg') {
                 const arg = (0, string_1.removeCommentLine)(f.toString()).trim();
-                if (/\0\d+t\x7F/u.test(arg)) {
+                if (/\0\d+[tm]\x7F/u.test(arg)) {
                     return m;
                 }
                 else if (!context || !context.hasArg(arg)) {
@@ -111,110 +165,40 @@ const expand = (wikitext, page, config, include, context, now = index_1.default.
                     accum[accum.indexOf(f)] = undefined;
                     return isTemplate ? prev + target.toString() : fallback;
                 }
-                else if (!index_1.default.templates.has(title)) {
-                    if (index_1.default.templateDir === undefined) {
-                        return fallback;
-                    }
-                    else if (!path_1.default.isAbsolute(index_1.default.templateDir)) {
-                        index_1.default.templateDir = path_1.default.join(__dirname, '..', '..', index_1.default.templateDir);
-                    }
-                    const file = fs_1.default.readdirSync(index_1.default.templateDir, { withFileTypes: true, recursive: true })
-                        .filter(dirent => dirent.isFile())
-                        .find(({ name: fl, parentPath }) => {
-                        const t = path_1.default.relative(index_1.default.templateDir, path_1.default.join(parentPath, fl.replace(/\.(?:wiki|txt)$/iu, ''))).replaceAll('꞉', ':');
-                        try {
-                            return decodeURIComponent(t) === title;
-                        }
-                        catch {
-                            return t === title;
-                        }
-                    });
-                    if (!file) {
-                        return fallback;
-                    }
-                    index_1.default.templates.set(title, fs_1.default.readFileSync(path_1.default.join(file.parentPath, file.name), 'utf8'));
+                const dest = loadTemplate(title, config);
+                if (dest === false) {
+                    return fallback;
                 }
-                else if (stack.includes(title)) {
-                    return `${prev}<span class="error">Template loop detected: [[${title}]]</span>`;
+                else if (stack.includes(dest)) {
+                    return `${prev}<span class="error">Template loop detected: [[${dest}]]</span>`;
                 }
-                let template = index_1.default.templates.get(title);
+                let template = index_1.default.templates.get(dest).replace(/\n$/u, '');
                 if (!isTemplate) {
                     for (let j = 1; j < args.length; j++) {
                         template = template.replaceAll(`$${j}`, (0, string_1.removeComment)(args[j].toString()));
                     }
                 }
-                return implicitNewLine(expand(template, title, config, true, target, now, accum, [...stack, title]).toString(), prev);
+                return implicitNewLine(expand(template, dest, callPage, config, true, target, now, accum, [...stack, dest])
+                    .toString(), prev);
             }
             else if (index_1.default.functionHooks.has(name)) {
-                return context === false ? m : index_1.default.functionHooks.get(name)(target, context || undefined);
+                return context === false
+                    ? m
+                    : implicitNewLine(index_1.default.functionHooks.get(name)(target, context || undefined), prev);
             }
             else if (magicWords_1.expandedMagicWords.has(name)) {
-                return context === false ? m : `${prev}${(0, magicWords_1.expandMagicWord)(name, now, config, args)}`;
-            }
-            else if (!solvedMagicWords.has(name)) {
-                return m;
-            }
-            else if (length < 3 || name === 'ifeq' && length === 3) {
-                return prev;
-            }
-            const var1 = (0, string_1.decodeHtml)(args[0].value), var2 = (0, string_1.decodeHtml)(args[1].value), known = !/\0\d+t\x7F/u.test(var1);
-            if (known && (name === 'if' || name === 'ifexist')) {
-                let bool = Boolean(var1);
-                if (name === 'ifexist') {
-                    const { valid, interwiki } = index_1.default.normalizeTitle(var1, 0, include, config, { halfParsed: true, temporary: true, page: '' });
-                    bool = valid && !interwiki;
+                const solved = solvedMagicWords.has(name);
+                if (context === false && !solved) {
+                    return m;
                 }
-                return parseIf(accum, prev, args[bool ? 1 : 2]);
-            }
-            else if (known && name === 'ifeq' && !/\0\d+t\x7F/u.test(var2)) {
-                return parseIf(accum, prev, args[cmp(var1, var2) ? 2 : 3]);
-            }
-            else if (known && name === 'switch') {
-                let defaultVal = '', j = 2, 
-                /**
-                 * - `1` 表示默认值
-                 * - `2` 表示匹配值
-                 */
-                found = 0, transclusion = false, defaultParam;
-                for (; j < length; j++) {
-                    const { anon, value, lastChild, name: option } = args[j - 1];
-                    transclusion = /\0\d+t\x7F/u.test(anon ? value : option);
-                    if (anon) {
-                        if (j === length - 1) { // 位于最后的匿名参数是默认值
-                            defaultParam = lastChild;
-                            defaultVal = value;
-                        }
-                        else if (transclusion) { // 不支持复杂参数
-                            break;
-                        }
-                        else if (cmp(var1, (0, string_1.decodeHtml)(value))) { // 下一个命名参数视为匹配值
-                            found = 2;
-                        }
-                        else if (value === '#default' && found !== 2) { // 下一个命名参数视为默认值
-                            found = 1;
-                        }
-                    }
-                    else if (transclusion) { // 不支持复杂参数
-                        break;
-                    }
-                    else if (found === 2 || cmp(var1, (0, string_1.decodeHtml)(option))) { // 第一个匹配值
+                const result = (0, magicWords_1.expandMagicWord)(name, args.map(({ anon, name: key, value }) => anon ? value : `${key}=${value}`), callPage, config, now, accum);
+                if (solved && result !== false) {
+                    for (const { lastChild } of args) {
                         // @ts-expect-error sparse array
                         accum[accum.indexOf(lastChild)] = undefined;
-                        return implicitNewLine(value, prev);
-                    }
-                    else if (found === 1 || option.toLowerCase() === '#default') { // 更新默认值
-                        defaultParam = lastChild;
-                        defaultVal = value;
-                        found = 0;
                     }
                 }
-                if (j === length) { // 不含复杂参数
-                    if (defaultParam) {
-                        // @ts-expect-error sparse array
-                        accum[accum.indexOf(defaultParam)] = undefined;
-                    }
-                    return implicitNewLine(defaultVal, prev);
-                }
+                return result === false ? m : implicitNewLine(result, prev);
             }
             return m;
         });
@@ -230,7 +214,10 @@ const expand = (wikitext, page, config, include, context, now = index_1.default.
  * @param token 目标节点
  * @param context 模板调用环境
  */
-const expandToken = (token, context) => expand(token.toString(), token.pageName, token.getAttribute('config'), token.getAttribute('include'), context);
+const expandToken = (token, context) => {
+    const { pageName } = token;
+    return expand(token.toString(), pageName, pageName, token.getAttribute('config'), token.getAttribute('include'), context);
+};
 index_2.Token.prototype.expand = /** @implements */ function () {
     return debug_1.Shadow.run(() => expandToken(this).parse());
 };
@@ -242,7 +229,8 @@ index_2.Token.prototype.toHtml = /** @implements */ function () {
     let html;
     if (this.type === 'root') {
         index_1.default.viewOnly = true;
-        const expanded = debug_1.Shadow.run(() => expandToken(this).parse(undefined, false, true));
+        const expanded = debug_1.Shadow.run(() => expandToken(this).parse(undefined, false, true)), e = new Event('expand');
+        this.dispatchEvent(e, { type: 'expand', token: expanded });
         index_1.default.viewOnly = false;
         constants_1.states.set(expanded, { headings: new Set() });
         const lines = expanded.toHtmlInternal().split('\n');

package/dist/addon/transclude.js

@@ -17,8 +17,8 @@ const atom_1 = require("../src/atom");
  * @param token 魔术字或模板节点
  */
 const format = (token) => {
-    const { lastChild, type } = token, isParameter = lastChild.type === 'parameter';
-    if (!(type === 'template' ? isParameter && lastChild.anon : lastChild.type === 'magic-word-name')
+    const { lastChild, type } = token, isParameter = lastChild.is('parameter');
+    if (!(type === 'template' ? isParameter && lastChild.anon : lastChild.is('magic-word-name'))
         && !lastChild.toString().endsWith('\n')) {
         (isParameter ? lastChild.lastChild : lastChild).insertAt('\n');
     }

package/dist/base.d.mts

@@ -18,7 +18,7 @@ export interface Config {
     readonly redirects?: [string, string][];
 }
 export type ConfigData = Omit<Config, 'excludes'>;
-export type TokenTypes = 'root' | 'plain' | 'redirect' | 'redirect-syntax' | 'redirect-target' | 'translate' | 'translate-attr' | 'translate-inner' | 'tvar' | 'tvar-name' | 'onlyinclude' | 'noinclude' | 'include' | 'comment' | 'ext' | 'ext-attrs' | 'ext-attr-dirty' | 'ext-attr' | 'attr-key' | 'attr-value' | 'ext-inner' | 'arg' | 'arg-name' | 'arg-default' | 'hidden' | 'magic-word' | 'magic-word-name' | 'invoke-function' | 'invoke-module' | 'template' | 'template-name' | 'parameter' | 'parameter-key' | 'parameter-value' | 'heading' | 'heading-title' | 'heading-trail' | 'html' | 'html-attrs' | 'html-attr-dirty' | 'html-attr' | 'table' | 'tr' | 'td' | 'table-syntax' | 'table-attrs' | 'table-attr-dirty' | 'table-attr' | 'table-inter' | 'td-inner' | 'hr' | 'double-underscore' | 'link' | 'link-target' | 'link-text' | 'category' | 'file' | 'gallery-image' | 'imagemap-image' | 'image-parameter' | 'quote' | 'ext-link' | 'ext-link-text' | 'ext-link-url' | 'free-ext-link' | 'magic-link' | 'list' | 'dd' | 'list-range' | 'converter' | 'converter-flags' | 'converter-flag' | 'converter-rule' | 'converter-rule-variant' | 'converter-rule-to' | 'converter-rule-from' | 'param-line' | 'imagemap-link';
+export type TokenTypes = 'root' | 'plain' | 'redirect' | 'redirect-syntax' | 'redirect-target' | 'translate' | 'translate-attr' | 'translate-inner' | 'tvar' | 'tvar-name' | 'onlyinclude' | 'noinclude' | 'include' | 'comment' | 'ext' | 'ext-attrs' | 'ext-attr-dirty' | 'ext-attr' | 'attr-key' | 'attr-value' | 'ext-inner' | 'arg' | 'arg-name' | 'arg-default' | 'hidden' | 'magic-word' | 'magic-word-name' | 'invoke-function' | 'invoke-module' | 'template' | 'template-name' | 'parameter' | 'parameter-key' | 'parameter-value' | 'heading' | 'heading-title' | 'heading-trail' | 'html' | 'html-attrs' | 'html-attr-dirty' | 'html-attr' | 'table' | 'tr' | 'td' | 'table-syntax' | 'table-attrs' | 'table-attr-dirty' | 'table-attr' | 'table-inter' | 'td-inner' | 'hr' | 'double-underscore' | 'link' | 'link-target' | 'link-text' | 'category' | 'file' | 'gallery-image' | 'imagemap-image' | 'image-parameter' | 'quote' | 'ext-link' | 'ext-link-text' | 'ext-link-url' | 'free-ext-link' | 'magic-link' | 'list' | 'dd' | 'converter' | 'converter-flags' | 'converter-flag' | 'converter-rule' | 'converter-rule-variant' | 'converter-rule-to' | 'converter-rule-from' | 'param-line' | 'imagemap-link' | 'list-range';
 export declare const stages: {
     redirect: number;
     onlyinclude: number;
@@ -47,7 +47,7 @@ export declare const stages: {
     'list-range': number;
 };
 export type Stage = keyof typeof stages;
-export declare const rules: readonly ["bold-header", "format-leakage", "fostered-content", "h1", "illegal-attr", "insecure-style", "invalid-gallery", "invalid-imagemap", "invalid-invoke", "invalid-isbn", "invalid-url", "lonely-apos", "lonely-bracket", "lonely-http", "nested-link", "no-arg", "no-duplicate", "no-ignored", "obsolete-attr", "obsolete-tag", "parsing-order", "pipe-like", "table-layout", "tag-like", "unbalanced-header", "unclosed-comment", "unclosed-quote", "unclosed-table", "unescaped", "unknown-page", "unmatched-tag", "unterminated-url", "url-encoding", "var-anchor", "void-ext", "invalid-css", "invalid-math"];
+export declare const rules: readonly ["arg-in-ext", "bold-header", "format-leakage", "fostered-content", "h1", "illegal-attr", "insecure-style", "invalid-gallery", "invalid-imagemap", "invalid-invoke", "invalid-isbn", "invalid-url", "lonely-apos", "lonely-bracket", "lonely-http", "nested-link", "no-arg", "no-duplicate", "no-ignored", "obsolete-attr", "obsolete-tag", "parsing-order", "pipe-like", "syntax-like", "table-layout", "tag-like", "unbalanced-header", "unclosed-comment", "unclosed-quote", "unclosed-table", "unescaped", "unknown-page", "unmatched-tag", "unterminated-url", "url-encoding", "var-anchor", "void-ext", "invalid-css", "invalid-math"];
 export declare namespace LintError {
     type Severity = 'error' | 'warning';
     type Rule = typeof rules[number];
@@ -313,7 +313,8 @@ export interface LintConfiguration extends FullLintConfig {
     getSeverity(rule: LintError.Rule, key?: string): LintError.Severity | false;
 }
 export interface Parser {
-    config: ConfigData | string;
+    config: string | // eslint-disable-line @stylistic/operator-linebreak
+    ConfigData;
     i18n: Record<string, string> | string | undefined;
     /** @since v1.22.0 */
     lintConfig: LintConfig;

package/dist/base.d.ts

@@ -18,7 +18,7 @@ export interface Config {
     readonly redirects?: [string, string][];
 }
 export type ConfigData = Omit<Config, 'excludes'>;
-export type TokenTypes = 'root' | 'plain' | 'redirect' | 'redirect-syntax' | 'redirect-target' | 'translate' | 'translate-attr' | 'translate-inner' | 'tvar' | 'tvar-name' | 'onlyinclude' | 'noinclude' | 'include' | 'comment' | 'ext' | 'ext-attrs' | 'ext-attr-dirty' | 'ext-attr' | 'attr-key' | 'attr-value' | 'ext-inner' | 'arg' | 'arg-name' | 'arg-default' | 'hidden' | 'magic-word' | 'magic-word-name' | 'invoke-function' | 'invoke-module' | 'template' | 'template-name' | 'parameter' | 'parameter-key' | 'parameter-value' | 'heading' | 'heading-title' | 'heading-trail' | 'html' | 'html-attrs' | 'html-attr-dirty' | 'html-attr' | 'table' | 'tr' | 'td' | 'table-syntax' | 'table-attrs' | 'table-attr-dirty' | 'table-attr' | 'table-inter' | 'td-inner' | 'hr' | 'double-underscore' | 'link' | 'link-target' | 'link-text' | 'category' | 'file' | 'gallery-image' | 'imagemap-image' | 'image-parameter' | 'quote' | 'ext-link' | 'ext-link-text' | 'ext-link-url' | 'free-ext-link' | 'magic-link' | 'list' | 'dd' | 'list-range' | 'converter' | 'converter-flags' | 'converter-flag' | 'converter-rule' | 'converter-rule-variant' | 'converter-rule-to' | 'converter-rule-from' | 'param-line' | 'imagemap-link';
+export type TokenTypes = 'root' | 'plain' | 'redirect' | 'redirect-syntax' | 'redirect-target' | 'translate' | 'translate-attr' | 'translate-inner' | 'tvar' | 'tvar-name' | 'onlyinclude' | 'noinclude' | 'include' | 'comment' | 'ext' | 'ext-attrs' | 'ext-attr-dirty' | 'ext-attr' | 'attr-key' | 'attr-value' | 'ext-inner' | 'arg' | 'arg-name' | 'arg-default' | 'hidden' | 'magic-word' | 'magic-word-name' | 'invoke-function' | 'invoke-module' | 'template' | 'template-name' | 'parameter' | 'parameter-key' | 'parameter-value' | 'heading' | 'heading-title' | 'heading-trail' | 'html' | 'html-attrs' | 'html-attr-dirty' | 'html-attr' | 'table' | 'tr' | 'td' | 'table-syntax' | 'table-attrs' | 'table-attr-dirty' | 'table-attr' | 'table-inter' | 'td-inner' | 'hr' | 'double-underscore' | 'link' | 'link-target' | 'link-text' | 'category' | 'file' | 'gallery-image' | 'imagemap-image' | 'image-parameter' | 'quote' | 'ext-link' | 'ext-link-text' | 'ext-link-url' | 'free-ext-link' | 'magic-link' | 'list' | 'dd' | 'converter' | 'converter-flags' | 'converter-flag' | 'converter-rule' | 'converter-rule-variant' | 'converter-rule-to' | 'converter-rule-from' | 'param-line' | 'imagemap-link' | 'list-range';
 export declare const stages: {
     redirect: number;
     onlyinclude: number;
@@ -47,7 +47,7 @@ export declare const stages: {
     'list-range': number;
 };
 export type Stage = keyof typeof stages;
-export declare const rules: readonly ["bold-header", "format-leakage", "fostered-content", "h1", "illegal-attr", "insecure-style", "invalid-gallery", "invalid-imagemap", "invalid-invoke", "invalid-isbn", "invalid-url", "lonely-apos", "lonely-bracket", "lonely-http", "nested-link", "no-arg", "no-duplicate", "no-ignored", "obsolete-attr", "obsolete-tag", "parsing-order", "pipe-like", "table-layout", "tag-like", "unbalanced-header", "unclosed-comment", "unclosed-quote", "unclosed-table", "unescaped", "unknown-page", "unmatched-tag", "unterminated-url", "url-encoding", "var-anchor", "void-ext", "invalid-css", "invalid-math"];
+export declare const rules: readonly ["arg-in-ext", "bold-header", "format-leakage", "fostered-content", "h1", "illegal-attr", "insecure-style", "invalid-gallery", "invalid-imagemap", "invalid-invoke", "invalid-isbn", "invalid-url", "lonely-apos", "lonely-bracket", "lonely-http", "nested-link", "no-arg", "no-duplicate", "no-ignored", "obsolete-attr", "obsolete-tag", "parsing-order", "pipe-like", "syntax-like", "table-layout", "tag-like", "unbalanced-header", "unclosed-comment", "unclosed-quote", "unclosed-table", "unescaped", "unknown-page", "unmatched-tag", "unterminated-url", "url-encoding", "var-anchor", "void-ext", "invalid-css", "invalid-math"];
 export declare namespace LintError {
     type Severity = 'error' | 'warning';
     type Rule = typeof rules[number];
@@ -313,7 +313,8 @@ export interface LintConfiguration extends FullLintConfig {
     getSeverity(rule: LintError.Rule, key?: string): LintError.Severity | false;
 }
 export interface Parser {
-    config: ConfigData | string;
+    config: string | // eslint-disable-line @stylistic/operator-linebreak
+    ConfigData;
     i18n: Record<string, string> | string | undefined;
     /** @since v1.22.0 */
     lintConfig: LintConfig;

package/dist/base.js

@@ -27,6 +27,7 @@ exports.stages = (() => {
         list: 10,
         dd: 10,
         converter: 11,
+        /* NOT FOR BROWSER */
         'list-range': 11,
     };
     Object.setPrototypeOf(obj, null);
@@ -34,6 +35,7 @@ exports.stages = (() => {
 })();
 exports.rules = (() => {
     const arr = [
+        'arg-in-ext',
         'bold-header',
         'format-leakage',
         'fostered-content',
@@ -56,6 +58,7 @@ exports.rules = (() => {
         'obsolete-tag',
         'parsing-order',
         'pipe-like',
+        'syntax-like',
         'table-layout',
         'tag-like',
         'unbalanced-header',

package/dist/base.mjs

@@ -24,6 +24,7 @@ const stages = /* @__PURE__ */ (() => {
     list: 10,
     dd: 10,
     converter: 11,
+    /* NOT FOR BROWSER */
     "list-range": 11
   };
   Object.setPrototypeOf(obj, null);
@@ -31,6 +32,7 @@ const stages = /* @__PURE__ */ (() => {
 })();
 const rules = /* @__PURE__ */ (() => {
   const arr = [
+    "arg-in-ext",
     "bold-header",
     "format-leakage",
     "fostered-content",
@@ -53,6 +55,7 @@ const rules = /* @__PURE__ */ (() => {
     "obsolete-tag",
     "parsing-order",
     "pipe-like",
+    "syntax-like",
     "table-layout",
     "tag-like",
     "unbalanced-header",

package/dist/bin/config.js

@@ -77,7 +77,7 @@ const mw = {
         },
     },
 };
-const pkg = "wikiparser-node", version = "1.29.2";
+const pkg = "wikiparser-node", version = "1.31.0";
 let mwConfig;
 /**
  * Get the parser configuration for a Wikimedia Foundation project.

package/dist/index.d.ts

@@ -24,7 +24,7 @@ declare interface Parser extends ParserBase {
      * 指定解析器的当前时间
      * @since v1.21.2
      */
-    now?: Date;
+    now: Date;
     configPaths: string[];
     /**
      * Normalize page title
@@ -81,6 +81,16 @@ declare interface Parser extends ParserBase {
      * @since v1.22.0
      */
     setHook(name: string, hook: TagHook): void;
+    /**
+     * Call a parser function
+     *
+     * 调用一个解析器函数
+     * @param name parser function name / 解析器函数名
+     * @param args arguments / 参数
+     * @since v1.30.1
+     */
+    callParserFunction(name: string, ...args: string[]): string;
+    callParserFunction(name: string, args: string[] | Record<string, string>): string;
     /**
      * Check if the title is an interwiki link
      *

package/dist/index.js

@@ -34,37 +34,37 @@ let viewOnly = false;
 const promises = [Promise.resolve()];
 /^(zh|en)\s*:/diu; // eslint-disable-line @typescript-eslint/no-unused-expressions
 const getInterwikiRegex = (0, common_1.getRegex)(interwiki => new RegExp(String.raw `^(${interwiki.join('|')})\s*:`, 'diu'));
-let redirectMap = new redirectMap_1.RedirectMap();
+let redirectMap = new redirectMap_1.RedirectMap(), now;
 /* NOT FOR BROWSER END */
 let lintConfig = (() => {
-    LINT: return new lintConfig_1.LintConfiguration(); // eslint-disable-line no-unused-labels
+    LINT: return new lintConfig_1.LintConfiguration();
 })(), i18n;
 const Parser = {
     config: 'default',
     /** @implements */
     get rules() {
-        LINT: return base_1.rules; // eslint-disable-line no-unused-labels
+        LINT: return base_1.rules;
     },
     /** @implements */
     get i18n() {
-        LINT: return { ...constants_1.enMsg, ...i18n }; // eslint-disable-line no-unused-labels
+        LINT: return { ...constants_1.enMsg, ...i18n };
     },
     set i18n(data) {
         /* NOT FOR BROWSER ONLY */
-        if (typeof data === 'string') { // eslint-disable-line unicorn/prefer-ternary
+        if (typeof data === 'string') {
             i18n = rootRequire(data, 'i18n');
         }
         else {
             /* NOT FOR BROWSER ONLY END */
-            LINT: i18n = data; // eslint-disable-line no-unused-labels
+            LINT: i18n = data;
         }
     },
     /** @implements */
     get lintConfig() {
-        LINT: return lintConfig; // eslint-disable-line no-unused-labels
+        LINT: return lintConfig;
     },
     set lintConfig(config) {
-        LINT: lintConfig = new lintConfig_1.LintConfiguration(config); // eslint-disable-line no-unused-labels
+        LINT: lintConfig = new lintConfig_1.LintConfiguration(config);
     },
     /** @implements */
     get viewOnly() {
@@ -84,6 +84,13 @@ const Parser = {
     functionHooks: new Map(),
     tagHooks: new Map(),
     /** @implements */
+    get now() {
+        return now ?? new Date();
+    },
+    set now(value) {
+        now = value;
+    },
+    /** @implements */
     get redirects() {
         return redirectMap;
     },
@@ -152,7 +159,7 @@ const Parser = {
     },
     /** @implements */
     msg(msg, arg = '') {
-        LINT: return msg // eslint-disable-line no-unused-labels
+        LINT: return msg
             && (this.i18n[msg] ?? msg).replace('$1', this.msg(arg));
     },
     /** @implements */
@@ -169,7 +176,7 @@ const Parser = {
                 root.type = 'root';
                 root.pageName = opt?.page;
                 root.parseOnce(0, include).parseOnce();
-                const t = new Title(root.toString(), defaultNs, config, opt);
+                const t = new Title(root.firstChild.toString(), defaultNs, config, opt);
                 root.build();
                 for (const key of ['main', 'fragment']) {
                     const str = t[key];
@@ -211,7 +218,7 @@ const Parser = {
         maxStage ??= constants_1.MAX_STAGE;
         config ??= this.getConfig();
         let types;
-        LINT: { // eslint-disable-line no-unused-labels
+        LINT: {
             if (typeof maxStage !== 'number') {
                 types = Array.isArray(maxStage) ? maxStage : [maxStage];
                 maxStage = Math.max(...types.map(t => base_1.stages[t] || constants_1.MAX_STAGE));
@@ -229,7 +236,7 @@ const Parser = {
             catch (e) /* istanbul ignore next */ {
                 if (e instanceof Error) {
                     const file = path_1.default.join(__dirname, '..', 'errors', new Date().toISOString()), stage = token.getAttribute('stage');
-                    for (const k in config) {
+                    for (const k of Object.keys(config)) {
                         if (k.startsWith('regex') || config[k] instanceof Set) {
                             delete config[k];
                         }
@@ -272,7 +279,7 @@ const Parser = {
     },
     /** @implements */
     async partialParse(wikitext, watch, include, config = Parser.getConfig()) {
-        LSP: { // eslint-disable-line no-unused-labels
+        LSP: {
             const { Token } = require('./src/index');
             const set = typeof setImmediate === 'function' ? setImmediate : /* istanbul ignore next */ setTimeout, { running } = debug_1.Shadow;
             debug_1.Shadow.running = true;
@@ -313,7 +320,7 @@ const Parser = {
     },
     /** @implements */
     createLanguageService(uri = {}) {
-        LSP: { // eslint-disable-line no-unused-labels
+        LSP: {
             const mod = require('./lib/lsp');
             const { LanguageService, tasks } = mod;
             this.viewOnly = true;
@@ -347,6 +354,31 @@ const Parser = {
         this.tagHooks.set(name, hook);
     },
     /** @implements */
+    callParserFunction(name, arg, ...args) {
+        const { expandMagicWord } = require('./addon/magicWords'), { getCanonicalName } = require('./src/transclude');
+        if (typeof arg === 'string') {
+            args.unshift(arg);
+        }
+        else if (Array.isArray(arg)) {
+            args = arg;
+        }
+        else if (arg) {
+            for (let i = 1; i in arg; i++) {
+                args.push(arg[i]);
+                delete arg[i];
+            }
+            for (const [key, value] of Object.entries(arg)) {
+                args.push(`${key}=${value}`);
+            }
+        }
+        const [, , , canonicalName] = getCanonicalName(name, this.getConfig().parserFunction), result = expandMagicWord((canonicalName || name.toLowerCase()), args);
+        /* istanbul ignore if */
+        if (result === false) {
+            throw new RangeError(`Unable to resolve parser function: ${name}`);
+        }
+        return result;
+    },
+    /** @implements */
     warn(msg, ...args) {
         /* istanbul ignore if */
         if (this.warning) {
@@ -453,7 +485,7 @@ const def = {
     'debugging',
     'isInterwiki',
 ]);
-for (const key in Parser) {
+for (const key of Object.keys(Parser)) {
     if (!enumerable.has(key)) {
         def[key] = { enumerable: false };
     }

package/dist/internal.d.ts

@@ -31,7 +31,6 @@ export type { GalleryImageToken } from './src/link/galleryImage';
 export type { QuoteToken } from './src/nowiki/quote';
 export type { MagicLinkToken } from './src/magicLink';
 export type { ExtLinkToken } from './src/extLink';
-export type { ListRangeToken } from './src/nowiki/listBase';
 export type { DdToken } from './src/nowiki/dd';
 export type { ListToken } from './src/nowiki/list';
 export type { ConverterFlagsToken } from './src/converterFlags';
@@ -47,3 +46,5 @@ export type { ImagemapLinkToken } from './src/imagemapLink';
 export type { ImagemapToken } from './src/multiLine/imagemap';
 export type { CommentedToken } from './src/commented';
 export type { TranslateToken } from './src/tagPair/translate';
+export type { TvarToken } from './src/tag/tvar';
+export type { ListRangeToken } from './src/nowiki/listBase';

package/dist/lib/attributes.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Attributes = void 0;
-/* eslint-disable jsdoc/require-jsdoc */
 const constants_1 = require("../util/constants");
 /** 用于选择器的属性 */
 class Attributes {