wikiparser-node 1.9.3 → 1.10.0

package/config/.schema.json

@@ -162,6 +162,11 @@
 				"minItems": 2,
 				"maxItems": 2
 			}
+		},
+		"articlePath": {
+			"description": "base URL of internal links",
+			"type": "string",
+			"pattern": "\\$1"
 		}
 	},
 	"required": [

package/config/enwiki.json

@@ -1222,5 +1222,6 @@
 	"redirection": [
 		"#redirect"
 	],
-	"variants": []
+	"variants": [],
+	"articlePath": "/wiki/$1"
 }

package/config/llwiki.json

@@ -631,5 +631,6 @@
 		"zh-sg",
 		"zh-my",
 		"zh-mo"
-	]
+	],
+	"articlePath": "/zh/$1"
 }

package/config/moegirl.json

@@ -730,5 +730,6 @@
 		"zh-cn",
 		"zh-tw",
 		"zh-hk"
-	]
+	],
+	"articlePath": "/$1"
 }

package/config/zhwiki.json

@@ -1270,5 +1270,6 @@
 		"zh-sg",
 		"zh-my",
 		"zh-mo"
-	]
+	],
+	"articlePath": "/wiki/$1"
 }

package/dist/addon/token.js

@@ -1,240 +1,324 @@
 "use strict";
-/* eslint @stylistic/operator-linebreak: [2, "before", {overrides: {"=": "after"}}] */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.expand = void 0;
+const fs = require("fs");
+const path = require("path");
 const constants_1 = require("../util/constants");
 const debug_1 = require("../util/debug");
-const index_1 = require("../src/index");
+const string_1 = require("../util/string");
+const index_1 = require("../index");
+const index_2 = require("../src/index");
 const comment_1 = require("../src/nowiki/comment");
 const include_1 = require("../src/tagPair/include");
 const ext_1 = require("../src/tagPair/ext");
 const html_1 = require("../src/html");
 const attributes_1 = require("../src/attributes");
-index_1.Token.prototype.createComment =
-    /** @implements */
-    function (data = '') {
-        const config = this.getAttribute('config');
+index_2.Token.prototype.createComment = /** @implements */ function (data = '') {
+    const config = this.getAttribute('config');
+    // @ts-expect-error abstract class
+    return debug_1.Shadow.run(() => new comment_1.CommentToken(data.replace(/-->/gu, '-->'), true, config));
+};
+index_2.Token.prototype.createElement = /** @implements */ function (tagName, { selfClosing, closing } = {}) {
+    const config = this.getAttribute('config'), include = this.getAttribute('include');
+    if (tagName === (include ? 'noinclude' : 'includeonly')) {
+        return debug_1.Shadow.run(
         // @ts-expect-error abstract class
-        return debug_1.Shadow.run(() => new comment_1.CommentToken(data.replace(/-->/gu, '-->'), true, config));
-    };
-index_1.Token.prototype.createElement =
-    /** @implements */
-    function (tagName, { selfClosing, closing } = {}) {
-        const config = this.getAttribute('config'), include = this.getAttribute('include');
-        if (tagName === (include ? 'noinclude' : 'includeonly')) {
-            return debug_1.Shadow.run(
+        () => new include_1.IncludeToken(tagName, '', undefined, selfClosing ? undefined : tagName, config));
+    }
+    else if (config.ext.includes(tagName)) {
+        // @ts-expect-error abstract class
+        return debug_1.Shadow.run(() => new ext_1.ExtToken(tagName, '', undefined, selfClosing ? undefined : '', config));
+    }
+    else if (config.html.some(tags => tags.includes(tagName))) {
+        return debug_1.Shadow.run(() => {
             // @ts-expect-error abstract class
-            () => new include_1.IncludeToken(tagName, '', undefined, selfClosing ? undefined : tagName, config));
-        }
-        else if (config.ext.includes(tagName)) {
+            const attr = new attributes_1.AttributesToken(undefined, 'html-attrs', tagName, config);
+            attr.afterBuild();
             // @ts-expect-error abstract class
-            return debug_1.Shadow.run(() => new ext_1.ExtToken(tagName, '', undefined, selfClosing ? undefined : '', config));
-        }
-        else if (config.html.some(tags => tags.includes(tagName))) {
-            return debug_1.Shadow.run(() => {
-                // @ts-expect-error abstract class
-                const attr = new attributes_1.AttributesToken(undefined, 'html-attrs', tagName, config);
-                attr.afterBuild();
-                // @ts-expect-error abstract class
-                return new html_1.HtmlToken(tagName, attr, Boolean(closing), Boolean(selfClosing), config);
-            });
-        }
-        throw new RangeError(`Invalid tag name: ${tagName}`);
-    };
-index_1.Token.prototype.caretPositionFromIndex =
-    /** @implements */
-    function (index) {
-        if (index === undefined) {
-            return undefined;
+            return new html_1.HtmlToken(tagName, attr, Boolean(closing), Boolean(selfClosing), config);
+        });
+    }
+    throw new RangeError(`Invalid tag name: ${tagName}`);
+};
+index_2.Token.prototype.caretPositionFromIndex = /** @implements */ function (index) {
+    if (index === undefined) {
+        return undefined;
+    }
+    const { length } = this.toString();
+    if (index >= length || index < -length) {
+        return undefined;
+    }
+    index += index < 0 ? length : 0;
+    let self = this, acc = 0, start = 0;
+    while (self.type !== 'text') {
+        const { childNodes } = self;
+        acc += self.getAttribute('padding');
+        for (let i = 0; acc <= index && i < childNodes.length; i++) {
+            const cur = childNodes[i], l = cur.toString().length;
+            acc += l;
+            if (acc > index) {
+                self = cur;
+                acc -= l;
+                start = acc;
+                break;
+            }
+            acc += self.getGaps(i);
         }
-        const { length } = this.toString();
-        if (index >= length || index < -length) {
-            return undefined;
+        if (self.childNodes === childNodes) {
+            return { offsetNode: self, offset: index - start };
         }
-        index += index < 0 ? length : 0;
-        let self = this, acc = 0, start = 0;
-        while (self.type !== 'text') {
-            const { childNodes } = self;
-            acc += self.getAttribute('padding');
-            for (let i = 0; acc <= index && i < childNodes.length; i++) {
-                const cur = childNodes[i], l = cur.toString().length;
-                acc += l;
-                if (acc > index) {
-                    self = cur;
-                    acc -= l;
-                    start = acc;
-                    break;
-                }
-                acc += self.getGaps(i);
-            }
-            if (self.childNodes === childNodes) {
-                return { offsetNode: self, offset: index - start };
+    }
+    return { offsetNode: self, offset: index - start };
+};
+index_2.Token.prototype.sections = /** @implements */ function () {
+    if (this.type !== 'root') {
+        return undefined;
+    }
+    const { childNodes, length } = this, headings = [...childNodes.entries()]
+        .filter((entry) => entry[1].type === 'heading')
+        .map(([i, { level }]) => [i, level]), lastHeading = [-1, -1, -1, -1, -1, -1], sections = headings.map(([i]) => {
+        const range = this.createRange();
+        range.setStart(this, i);
+        return range;
+    });
+    for (let i = 0; i < headings.length; i++) {
+        const [index, level] = headings[i];
+        for (let j = level; j < 6; j++) {
+            const last = lastHeading[j];
+            if (last >= 0) {
+                sections[last].setEnd(this, index);
             }
+            lastHeading[j] = j === level ? i : -1;
         }
-        return { offsetNode: self, offset: index - start };
-    };
-index_1.Token.prototype.sections =
-    /** @implements */
-    function () {
-        if (this.type !== 'root') {
-            return undefined;
+    }
+    for (const last of lastHeading) {
+        if (last >= 0) {
+            sections[last].setEnd(this, length);
         }
-        const { childNodes, length } = this, headings = [...childNodes.entries()]
-            .filter((entry) => entry[1].type === 'heading')
-            .map(([i, { level }]) => [i, level]), lastHeading = [-1, -1, -1, -1, -1, -1], sections = headings.map(([i]) => {
-            const range = this.createRange();
-            range.setStart(this, i);
-            return range;
-        });
-        for (let i = 0; i < headings.length; i++) {
-            const [index, level] = headings[i];
-            for (let j = level; j < 6; j++) {
-                const last = lastHeading[j];
-                if (last >= 0) {
-                    sections[last].setEnd(this, index);
+    }
+    const range = this.createRange();
+    range.setStart(this, 0);
+    range.setEnd(this, headings[0]?.[0] ?? length);
+    sections.unshift(range);
+    return sections;
+};
+index_2.Token.prototype.findEnclosingHtml = /** @implements */ function (tag) {
+    tag = tag?.toLowerCase();
+    const { html } = this.getAttribute('config'), normalTags = new Set(html[0]), voidTags = new Set(html[2]);
+    if (html[2].includes(tag)) {
+        throw new RangeError(`Void tag: ${tag}`);
+    }
+    else if (tag !== undefined && !html.slice(0, 2).some(tags => tags.includes(tag))) {
+        throw new RangeError(`Invalid tag name: ${tag}`);
+    }
+    const { parentNode } = this;
+    if (!parentNode) {
+        return undefined;
+    }
+    /**
+     * 检查是否为指定的 HTML 标签
+     * @param node 节点
+     * @param name 标签名
+     * @param closing 是否为闭合标签
+     */
+    const checkHtml = (node, name, closing) => node.is('html')
+        && (!name && !voidTags.has(node.name) || node.name === name)
+        && (normalTags.has(node.name) || !node.selfClosing)
+        && node.closing === closing;
+    const { childNodes, length } = parentNode, index = childNodes.indexOf(this);
+    let i = index - 1, j = length;
+    for (; i >= 0; i--) {
+        const open = childNodes[i];
+        if (checkHtml(open, tag, false)) {
+            for (j = index + 1; j < length; j++) {
+                const close = childNodes[j];
+                if (checkHtml(close, open.name, true)) {
+                    break;
                 }
-                lastHeading[j] = j === level ? i : -1;
             }
-        }
-        for (const last of lastHeading) {
-            if (last >= 0) {
-                sections[last].setEnd(this, length);
+            if (j < length) {
+                break;
             }
         }
-        const range = this.createRange();
-        range.setStart(this, 0);
-        range.setEnd(this, headings[0]?.[0] ?? length);
-        sections.unshift(range);
-        return sections;
-    };
-index_1.Token.prototype.findEnclosingHtml =
-    /** @implements */
-    function (tag) {
-        tag = tag?.toLowerCase();
-        const { html } = this.getAttribute('config'), normalTags = new Set(html[0]), voidTags = new Set(html[2]);
-        if (html[2].includes(tag)) {
-            throw new RangeError(`Void tag: ${tag}`);
+    }
+    if (i === -1) {
+        return parentNode.findEnclosingHtml(tag);
+    }
+    const range = this.createRange();
+    range.setStart(parentNode, i);
+    range.setEnd(parentNode, j + 1);
+    return range;
+};
+index_2.Token.prototype.redoQuotes = /** @implements */ function () {
+    const acceptable = this.getAcceptable();
+    if (acceptable && !('QuoteToken' in acceptable)) {
+        return;
+    }
+    const accum = [];
+    for (const child of this.childNodes) {
+        if (child.type !== 'quote' && child.type !== 'text') {
+            child.replaceWith(`\0${accum.length}e\x7F`);
+            accum.push(child);
         }
-        else if (tag !== undefined && !html.slice(0, 2).some(tags => tags.includes(tag))) {
-            throw new RangeError(`Invalid tag name: ${tag}`);
+    }
+    const token = debug_1.Shadow.run(() => {
+        const node = new index_2.Token(this.toString(), this.getAttribute('config'), accum);
+        node.setAttribute('stage', 6);
+        return node.parse(7);
+    });
+    this.replaceChildren(...token.childNodes);
+};
+/**
+ * 展开模板
+ * @param wikitext
+ * @param config
+ * @param include
+ * @param context 模板调用环境
+ * @param accum
+ * @throws `Error` not root token
+ */
+const expand = (wikitext, config, include, context, accum = []) => {
+    const magicWords = new Set(['if', 'ifeq', 'switch']), n = accum.length, token = new index_2.Token(wikitext, config, accum);
+    token.type = 'root';
+    token.parseOnce(0, include);
+    if (context) {
+        token.setText((0, string_1.removeComment)(token.firstChild.toString()));
+    }
+    token.parseOnce();
+    for (const plain of [...accum.slice(n), token]) {
+        if (plain.length !== 1 || plain.firstChild.type !== 'text') {
+            continue;
         }
-        const { parentNode } = this;
-        if (!parentNode) {
-            return undefined;
+        const { data } = plain.firstChild;
+        if (!/\0\d+t\x7F/u.test(data)) {
+            continue;
         }
-        const isHtml = (0, debug_1.isToken)('html'), 
-        /**
-         * 检查是否为指定的 HTML 标签
-         * @param node 节点
-         * @param name 标签名
-         * @param closing 是否为闭合标签
-         */
-        checkHtml = (node, name, closing) => isHtml(node)
-            && (!name && !voidTags.has(node.name) || node.name === name)
-            && (normalTags.has(node.name) || !node.selfClosing)
-            && node.closing === closing;
-        const { childNodes, length } = parentNode, index = childNodes.indexOf(this);
-        let i = index - 1, j = length;
-        for (; i >= 0; i--) {
-            const open = childNodes[i];
-            if (checkHtml(open, tag, false)) {
-                for (j = index + 1; j < length; j++) {
-                    const close = childNodes[j];
-                    if (checkHtml(close, open.name, true)) {
-                        break;
-                    }
+        const expanded = data.replace(/\0(\d+)t\x7F/gu, (m, i) => {
+            const target = accum[i], { type, name, length, firstChild: f } = target;
+            if (type === 'arg') {
+                const arg = (0, string_1.removeComment)(f.toString()).trim();
+                if (context === undefined || /\0\d+t\x7F/u.test(arg)) {
+                    return m;
                 }
-                if (j < length) {
-                    break;
+                else if (context === false || !context.hasArg(arg)) {
+                    const effective = target.childNodes[1] ?? target;
+                    // @ts-expect-error sparse array
+                    accum[accum.indexOf(effective)] = undefined;
+                    return effective.toString();
                 }
+                // @ts-expect-error sparse array
+                accum[accum.indexOf(context.getArg(arg).lastChild)] = undefined;
+                return context.getValue(arg);
             }
-        }
-        if (i === -1) {
-            return parentNode.findEnclosingHtml(tag);
-        }
-        const range = this.createRange();
-        range.setStart(parentNode, i);
-        range.setEnd(parentNode, j + 1);
-        return range;
-    };
-index_1.Token.prototype.redoQuotes =
-    /** @implements */
-    function () {
-        const acceptable = this.getAcceptable();
-        if (acceptable && !('QuoteToken' in acceptable)) {
-            return;
-        }
-        const accum = [];
-        for (const child of this.childNodes) {
-            if (child.type !== 'quote' && child.type !== 'text') {
-                child.replaceWith(`\0${accum.length}e\x7F`);
-                accum.push(child);
-            }
-        }
-        const token = debug_1.Shadow.run(() => {
-            const node = new index_1.Token(this.toString(), this.getAttribute('config'), accum);
-            node.setAttribute('stage', 6);
-            return node.parse(7);
-        });
-        this.replaceChildren(...token.childNodes);
-    };
-index_1.Token.prototype.solveConst =
-    /** @implements */
-    function () {
-        const targets = this.querySelectorAll('magic-word, arg'), magicWords = new Set(['if', 'ifeq', 'switch']);
-        for (let i = targets.length - 1; i >= 0; i--) {
-            const target = targets[i], { type, name, childNodes, length } = target, [, var1, var2 = ''] = childNodes;
-            if (type === 'arg' || type === 'magic-word' && magicWords.has(name)) {
-                let replace = '';
-                if (type === 'arg') {
-                    replace = target.default === false ? target.toString() : target.default;
+            else if (type === 'template') {
+                if (context === false) {
+                    return m;
+                }
+                const c = target.getAttribute('config'), { title } = index_1.default.normalizeTitle((0, string_1.removeComment)(f.toString()), 10, include, c, true);
+                if (!index_1.default.templates.has(title)) {
+                    if (index_1.default.templateDir === undefined) {
+                        return m;
+                    }
+                    else if (!path.isAbsolute(index_1.default.templateDir)) {
+                        index_1.default.templateDir = path.join(__dirname, '..', '..', index_1.default.templateDir);
+                    }
+                    const file = ['.wiki', '.txt', ''].map(ext => path.join(index_1.default.templateDir, title + ext))
+                        .find(fs.existsSync);
+                    if (!file) {
+                        return m;
+                    }
+                    index_1.default.templates.set(title, fs.readFileSync(file, 'utf8'));
                 }
-                else if (name === 'if' && !var1?.getElementByTypes('magic-word, template')) {
-                    replace = String(childNodes[String(var1 ?? '').trim() ? 2 : 3] ?? '').trim();
+                return (0, exports.expand)(index_1.default.templates.get(title), config, true, target, accum).toString();
+            }
+            else if (!magicWords.has(name)) {
+                return m;
+            }
+            else if (length < 3 || name === 'ifeq' && length === 3) {
+                return '';
+            }
+            const c = target.childNodes, var1 = c[1].value, var2 = c[2].value, known = !/\0\d+t\x7F/u.test(var1);
+            if (name === 'if' && known) {
+                const effective = c[var1 ? 2 : 3];
+                if (effective) {
+                    // @ts-expect-error sparse array
+                    accum[accum.indexOf(effective.lastChild)] = undefined;
+                    return effective.value;
                 }
-                else if (name === 'ifeq'
-                    && !childNodes.slice(1, 3).some(child => child.getElementByTypes('magic-word, template'))) {
-                    replace = String(childNodes[String(var1 ?? '').trim() === String(var2).trim() ? 3 : 4] ?? '').trim();
+                return '';
+            }
+            else if (name === 'ifeq' && known && !/\0\d+t\x7F/u.test(var2)) {
+                const effective = c[var1 === var2 ? 3 : 4];
+                if (effective) {
+                    // @ts-expect-error sparse array
+                    accum[accum.indexOf(effective.lastChild)] = undefined;
+                    return effective.value;
                 }
-                else if (name === 'switch' && !var1?.getElementByTypes('magic-word, template')) {
-                    const key = String(var1 ?? '').trim();
-                    let defaultVal = '', found = false, transclusion = false;
-                    for (let j = 2; j < length; j++) {
-                        const { anon, name: option, value, firstChild } = childNodes[j];
-                        transclusion = Boolean(firstChild.getElementByTypes('magic-word, template'));
-                        if (anon) {
-                            if (j === length - 1) {
-                                defaultVal = value;
-                            }
-                            else if (transclusion) {
-                                break;
-                            }
-                            else {
-                                found ||= key === value;
-                            }
+                return '';
+            }
+            else if (name === 'switch' && known) {
+                let defaultVal = '', found = false, transclusion = false, defaultParam;
+                for (let j = 2; j < length; j++) {
+                    const { anon, value, firstChild, lastChild } = c[j], option = (0, string_1.removeComment)(firstChild.toString())
+                        .replace(/^[ \t\n\0\v]+|([^ \t\n\0\v])[ \t\n\0\v]+$/gu, '$1');
+                    transclusion = /\0\d+t\x7F/u.test(anon ? value : option);
+                    if (anon) {
+                        if (j === length - 1) {
+                            // @ts-expect-error sparse array
+                            accum[accum.indexOf(lastChild)] = undefined;
+                            return value;
                         }
                         else if (transclusion) {
                             break;
                         }
-                        else if (found || option === key) {
-                            replace = value;
-                            break;
-                        }
-                        else if (option.toLowerCase() === '#default') {
-                            defaultVal = value;
-                        }
-                        if (j === length - 1) {
-                            replace = defaultVal;
+                        else {
+                            found ||= var1 === value;
                         }
                     }
-                    if (transclusion) {
-                        continue;
+                    else if (transclusion) {
+                        break;
+                    }
+                    else if (found || option === var1) {
+                        // @ts-expect-error sparse array
+                        accum[accum.indexOf(lastChild)] = undefined;
+                        return value;
+                    }
+                    else if (option.toLowerCase() === '#default') {
+                        defaultVal = value;
+                        defaultParam = lastChild;
+                    }
+                    if (j === length - 1) {
+                        if (defaultParam) {
+                            // @ts-expect-error sparse array
+                            accum[accum.indexOf(defaultParam)] = undefined;
+                        }
+                        return defaultVal;
                     }
                 }
-                else {
-                    continue;
+                if (transclusion) {
+                    return m;
                 }
-                target.replaceWith(replace);
             }
+            return m;
+        });
+        plain.setText(expanded);
+        if (plain.type === 'parameter-key') {
+            plain.parentNode.trimName((0, string_1.removeComment)(expanded));
         }
-    };
+    }
+    return token;
+};
+exports.expand = expand;
+index_2.Token.prototype.expand = /** @implements */ function (context) {
+    if (this.type !== 'root') {
+        throw new Error('Only root token can be expanded!');
+    }
+    return debug_1.Shadow.run(() => (0, exports.expand)(this.toString(), this.getAttribute('config'), this.getAttribute('include'), context).parse());
+};
+index_2.Token.prototype.solveConst = /** @implements */ function () {
+    if (this.type !== 'root') {
+        throw new Error('Only root token can be expanded!');
+    }
+    return debug_1.Shadow.run(() => (0, exports.expand)(this.toString(), this.getAttribute('config'), this.getAttribute('include'), false).parse());
+};
 constants_1.classes['ExtendedTableToken'] = __filename;

package/dist/addon/transclude.js

@@ -55,9 +55,9 @@ transclude_1.TranscludeToken.prototype.replaceModule =
         }
         const config = this.getAttribute('config');
         if (this.length === 1) {
-            index_2.Token.prototype.insertAt.call(this, new atom_1.AtomToken(undefined, 'invoke-module', config, [], {
+            index_2.Token.prototype.insertAt.call(this, debug_1.Shadow.run(() => new atom_1.AtomToken(undefined, 'invoke-module', config, [], {
                 'Stage-1': ':', '!ExtToken': '',
-            }));
+            })));
             return;
         }
         const { childNodes } = index_1.default.parse(title, this.getAttribute('include'), 2, config);
@@ -74,9 +74,9 @@ transclude_1.TranscludeToken.prototype.replaceFunction =
         }
         const config = this.getAttribute('config');
         if (this.length === 2) {
-            index_2.Token.prototype.insertAt.call(this, new atom_1.AtomToken(undefined, 'invoke-function', config, [], {
+            index_2.Token.prototype.insertAt.call(this, debug_1.Shadow.run(() => new atom_1.AtomToken(undefined, 'invoke-function', config, [], {
                 'Stage-1': ':', '!ExtToken': '',
-            }));
+            })));
             return;
         }
         const { childNodes } = index_1.default.parse(func, this.getAttribute('include'), 2, config);
@@ -152,7 +152,7 @@ transclude_1.TranscludeToken.prototype.fixDuplication =
             if (remaining > 1) {
                 index_1.default.error(`${this.type === 'template'
                     ? this.name
-                    : this.normalizeTitle(this.childNodes[1].text(), 828)
+                    : this.normalizeTitle(this.childNodes[1].toString(true), 828)
                         .title} still has ${remaining} duplicated ${key} parameters:\n${[...this.getArgs(key)].map(arg => {
                     const { top, left } = arg.getBoundingClientRect();
                     return `Line ${String(top)} Column ${String(left)}`;
@@ -169,9 +169,9 @@ transclude_1.TranscludeToken.prototype.escapeTables =
         if (!/\n[^\S\n]*(?::+[^\S\n]*)?\{\|/u.test(this.text())) {
             return this;
         }
-        const stripped = this.toString().slice(2, -2), include = this.getAttribute('include'), config = this.getAttribute('config'), parsed = index_1.default.parse(stripped, include, 4, config), isTable = (0, debug_1.isToken)('table');
+        const stripped = this.toString().slice(2, -2), include = this.getAttribute('include'), config = this.getAttribute('config'), parsed = index_1.default.parse(stripped, include, 4, config);
         for (const table of parsed.childNodes) {
-            if (isTable(table)) {
+            if (table.is('table')) {
                 table.escape();
             }
         }

package/dist/base.d.ts

@@ -13,6 +13,7 @@ export interface Config {
     readonly interwiki: string[];
     readonly conversionTable?: [string, string][];
     readonly redirects?: [string, string][];
+    readonly articlePath?: string;
 }
 export type TokenTypes = 'root' | 'plain' | 'redirect' | 'redirect-syntax' | 'redirect-target' | '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';
 export declare const rules: readonly ["bold-header", "format-leakage", "fostered-content", "h1", "illegal-attr", "insecure-style", "invalid-gallery", "invalid-imagemap", "invalid-invoke", "invalid-isbn", "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"];
@@ -46,8 +47,9 @@ export type AST = Record<string, string | number | boolean> & {
 };
 /** 类似Node */
 export interface AstNode {
-    type: string;
     readonly childNodes: readonly AstNode[];
+    /** 节点类型 */
+    type: string;
     /** Linter */
     lint(): LintError[];
     /** 以HTML格式打印 */