wikiparser-node 1.9.0 → 1.9.1

package/README.en.md

@@ -50,8 +50,8 @@ or
 <script src="//unpkg.com/wikiparser-node@browser/bundle/bundle.min.js"></script>
 ```
 
-For more browser extensions, please refer to the corresponding [documentation](https://github.com/bhsd-harry/wikiparser-node/wiki/Browser.en).
+For more browser extensions, please refer to the corresponding [documentation](https://github.com/bhsd-harry/wikiparser-node/wiki/Browser-%28EN%29).
 
 # Usage
 
-Please refer to the [Wiki](https://github.com/bhsd-harry/wikiparser-node/wiki/Home.en).
+Please refer to the [Wiki](https://github.com/bhsd-harry/wikiparser-node/wiki/Home-%28EN%29).

package/dist/addon/table.js

@@ -38,7 +38,7 @@ function occupied(layout, i, oneRow, cells) {
     if (rowLayout) {
         return rowLayout.map(({ row, column }, j) => row === i && (!oneRow || cells[column]?.rowspan === 1) ? j : undefined).filter((j) => j !== undefined);
     }
-    throw new RangeError(`表格没有第 ${i} 行！`);
+    throw new RangeError(`The table layout does not contain row ${i}!`);
 }
 /**
  * 设置表格格式
@@ -145,7 +145,7 @@ index_2.TableToken.prototype.insertTableCell =
             const { x, y } = coords;
             rawCoords = this.toRawCoords(coords);
             if (!rawCoords?.start) {
-                throw new RangeError(`指定的坐标不是单元格起始点：(${x}, ${y})`);
+                throw new RangeError(`The specified coordinates are not the starting point of any cell: (${x}, ${y})`);
             }
         }
         else {
@@ -206,7 +206,7 @@ index_2.TableToken.prototype.insertTableCol =
     function (x, inner, subtype, attr) {
         const layout = this.getLayout(), rowLength = layout.map(({ length }) => length), minCol = Math.min(...rowLength);
         if (x > minCol) {
-            throw new RangeError(`表格第 ${rowLength.indexOf(minCol)} 行仅有 ${minCol} 列！`);
+            throw new RangeError(`Row ${rowLength.indexOf(minCol)} has only ${minCol} column(s)!`);
         }
         const token = (0, td_1.createTd)(inner, subtype, attr, this.getAttribute('include'), this.getAttribute('config'));
         for (let i = 0; i < layout.length; i++) {
@@ -275,7 +275,7 @@ index_2.TableToken.prototype.mergeCells =
         const layout = this.getLayout(), maxCol = Math.max(...layout.map(({ length }) => length)), [xmin, xmax] = xlim.map(x => x < 0 ? x + maxCol : x).sort(), [ymin, ymax] = ylim.map(y => y < 0 ? y + layout.length : y).sort(), set = new Set(layout.slice(ymin, ymax).flatMap(rowLayout => rowLayout.slice(xmin, xmax)));
         if ([...layout[ymin - 1] ?? [], ...layout[ymax] ?? []].some(coords => set.has(coords))
             || layout.some(rowLayout => set.has(rowLayout[xmin - 1]) || set.has(rowLayout[xmax]))) {
-            throw new RangeError('待合并区域与外侧区域有重叠！');
+            throw new RangeError('The area to be merged overlaps with the outer area!');
         }
         const corner = layout[ymin][xmin], rows = this.getAllRows(), cornerCell = rows[corner.row].getNthCol(corner.column);
         cornerCell.rowspan = ymax - ymin;
@@ -318,7 +318,8 @@ index_2.TableToken.prototype.split =
                         this.insertTableCell('', { x: i, y: j }, subtype, attr);
                     }
                     catch (e) {
-                        if (e instanceof RangeError && e.message.startsWith('指定的坐标不是单元格起始点：')) {
+                        if (e instanceof RangeError
+                            && e.message.startsWith('The specified coordinates are not the starting point of a cell: ')) {
                             break;
                         }
                         throw e;
@@ -386,7 +387,7 @@ index_2.TableToken.prototype.moveTableRowBefore =
         }
         catch (e) {
             if (e instanceof assert.AssertionError) {
-                throw new RangeError(`第 ${y} 行与第 ${before} 行的构造不同，无法移动！`);
+                throw new RangeError(`The structure of row ${y} is different from that of row ${before}, so it cannot be moved!`);
             }
             throw e;
         }
@@ -412,7 +413,7 @@ index_2.TableToken.prototype.moveTableRowAfter =
         }
         catch (e) {
             if (e instanceof assert.AssertionError) {
-                throw new RangeError(`第 ${y} 行与第 ${after} 行的构造不同，无法移动！`);
+                throw new RangeError(`The structure of row ${y} is different from that of row ${after}, so it cannot be moved!`);
             }
             throw e;
         }
@@ -442,7 +443,7 @@ index_2.TableToken.prototype.moveCol =
     function (x, reference, after) {
         const layout = this.getLayout();
         if (layout.some(rowLayout => isStartCol(rowLayout, x) !== isStartCol(rowLayout, reference, after))) {
-            throw new RangeError(`第 ${x} 列与第 ${reference} 列的构造不同，无法移动！`);
+            throw new RangeError(`The structure of column ${x} is different from that of column ${reference}, so it cannot be moved!`);
         }
         const setX = new WeakSet(), setRef = new WeakSet(), rows = this.getAllRows();
         for (let i = 0; i < layout.length; i++) {

package/dist/addon/token.js

@@ -29,7 +29,7 @@ index_1.Token.prototype.createElement =
             // @ts-expect-error abstract class
             return debug_1.Shadow.run(() => new ext_1.ExtToken(tagName, '', undefined, selfClosing ? undefined : '', config));
         }
-        else if (config.html.flat().includes(tagName)) {
+        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);
@@ -37,7 +37,7 @@ index_1.Token.prototype.createElement =
                 return new html_1.HtmlToken(tagName, attr, Boolean(closing), Boolean(selfClosing), config);
             });
         }
-        throw new RangeError(`非法的标签名：${tagName}`);
+        throw new RangeError(`Invalid tag name: ${tagName}`);
     };
 index_1.Token.prototype.caretPositionFromIndex =
     /** @implements */
@@ -110,8 +110,11 @@ index_1.Token.prototype.findEnclosingHtml =
     function (tag) {
         tag = tag?.toLowerCase();
         const { html } = this.getAttribute('config'), normalTags = new Set(html[0]), voidTags = new Set(html[2]);
-        if (tag !== undefined && !html.slice(0, 2).flat().includes(tag)) {
-            throw new RangeError(`非法的标签或空标签：${tag}`);
+        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) {
@@ -155,7 +158,7 @@ index_1.Token.prototype.findEnclosingHtml =
 index_1.Token.prototype.redoQuotes =
     /** @implements */
     function () {
-        const acceptable = this.getAttribute('acceptable');
+        const acceptable = this.getAcceptable();
         if (acceptable && !('QuoteToken' in acceptable)) {
             return;
         }

package/dist/addon/transclude.js

@@ -23,7 +23,7 @@ transclude_1.TranscludeToken.prototype.setValue =
     /** @implements */
     function (key, value) {
         if (!this.isTemplate()) {
-            throw new Error('setValue 方法仅供模板使用！');
+            throw new Error('TranscludeToken.setValue method is only for templates!');
         }
         const arg = this.getArg(key);
         if (arg) {
@@ -42,7 +42,7 @@ transclude_1.TranscludeToken.prototype.replaceTemplate =
     /** @implements */
     function (title) {
         if (this.type === 'magic-word') {
-            throw new Error('replaceTemplate 方法仅用于更换模板！');
+            throw new Error('TranscludeToken.replaceTemplate method is only for templates!');
         }
         const { childNodes } = index_1.default.parse(title, this.getAttribute('include'), 2, this.getAttribute('config'));
         this.firstChild.replaceChildren(...childNodes);
@@ -51,7 +51,7 @@ transclude_1.TranscludeToken.prototype.replaceModule =
     /** @implements */
     function (title) {
         if (this.type !== 'magic-word' || this.name !== 'invoke') {
-            throw new Error('replaceModule 方法仅用于更换模块！');
+            throw new Error('TranscludeToken.replaceModule method is only for modules!');
         }
         const config = this.getAttribute('config');
         if (this.length === 1) {
@@ -67,10 +67,10 @@ transclude_1.TranscludeToken.prototype.replaceFunction =
     /** @implements */
     function (func) {
         if (this.type !== 'magic-word' || this.name !== 'invoke') {
-            throw new Error('replaceModule 方法仅用于更换模块！');
+            throw new Error('TranscludeToken.replaceModule method is only for modules!');
         }
         else if (this.length < 2) {
-            throw new Error('尚未指定模块名称！');
+            throw new Error('No module name specified!');
         }
         const config = this.getAttribute('config');
         if (this.length === 2) {
@@ -129,8 +129,10 @@ transclude_1.TranscludeToken.prototype.fixDuplication =
             }
             else if (aggressive && (anonCount ? /\D\d+$/u : /(?:^|\D)\d+$/u).test(key)) {
                 let last;
+                // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+                /^a\d+$/u;
                 // eslint-disable-next-line es-x/no-regexp-lookbehind-assertions
-                const str = key.slice(0, -/(?<!\d)\d+$/u.exec(key)[0].length), regex = new RegExp(`^${(0, string_1.escapeRegExp)(str)}\\d+$`, 'u'), series = this.getAllArgs().filter(({ name }) => regex.test(name)), ordered = series.every(({ name }, i) => {
+                const str = key.slice(0, -/(?<!\d)\d+$/u.exec(key)[0].length), regex = new RegExp(String.raw `^${(0, string_1.escapeRegExp)(str)}\d+$`, 'u'), series = this.getAllArgs().filter(({ name }) => regex.test(name)), ordered = series.every(({ name }, i) => {
                     const j = Number(name.slice(str.length)), cmp = j <= i + 1 && (i === 0 || j >= last || name === key);
                     last = j;
                     return cmp;
@@ -151,10 +153,10 @@ transclude_1.TranscludeToken.prototype.fixDuplication =
                 index_1.default.error(`${this.type === 'template'
                     ? this.name
                     : this.normalizeTitle(this.childNodes[1].text(), 828)
-                        .title} 还留有 ${remaining} 个重复的 ${key} 参数：${[...this.getArgs(key)].map(arg => {
+                        .title} still has ${remaining} duplicated ${key} parameters:\n${[...this.getArgs(key)].map(arg => {
                     const { top, left } = arg.getBoundingClientRect();
-                    return `第 ${String(top)} 行第 ${String(left)} 列`;
-                }).join('、')}`);
+                    return `Line ${String(top)} Column ${String(left)}`;
+                }).join('\n')}`);
                 duplicatedKeys.push(key);
                 continue;
             }
@@ -175,7 +177,7 @@ transclude_1.TranscludeToken.prototype.escapeTables =
         }
         const { firstChild, length } = index_1.default.parse(`{{${parsed.toString()}}}`, include, undefined, config);
         if (length !== 1 || !(firstChild instanceof transclude_1.TranscludeToken)) {
-            throw new Error('转义表格失败！');
+            throw new Error('Failed to escape tables!');
         }
         this.safeReplaceWith(firstChild);
         return firstChild;

package/dist/base.d.ts

@@ -61,6 +61,8 @@ interface AstElement extends AstNode {
 export interface Parser {
     config: Config | string;
     i18n: Record<string, string> | string | undefined;
+    /** 获取当前的解析设置 */
+    getConfig(): Config;
     /**
      * 解析wikitext
      * @param include 是否嵌入

package/dist/index.d.ts

@@ -13,11 +13,8 @@ declare interface Parser extends ParserBase {
      * @param title 标题（含或不含命名空间前缀）
      * @param defaultNs 命名空间
      * @param include 是否嵌入
-     * @param halfParsed 是否是半解析状态
-     * @param decode 是否需要解码
-     * @param selfLink 是否允许selfLink
      */
-    normalizeTitle(title: string, defaultNs?: number, include?: boolean, config?: Config, halfParsed?: boolean, decode?: boolean, selfLink?: boolean): Title;
+    normalizeTitle(title: string, defaultNs?: number, include?: boolean, config?: Config): Title;
     parse(wikitext: string, include?: boolean, maxStage?: number, config?: Config): Token;
     /**
      * 是否是跨维基链接
@@ -28,6 +25,7 @@ declare interface Parser extends ParserBase {
 declare const Parser: Parser;
 // @ts-expect-error mixed export styles
 export = Parser;
+export default Parser;
 export type { Config, LintError };
 export type * from './internal';
 declare global { type Acceptable = unknown; }

package/dist/index.js

@@ -144,7 +144,7 @@ const Parser = {
     },
     /** @implements */
     async clearCache() {
-        const promise = (0, diff_1.cmd)('npm', ['run', 'build']), entries = [
+        const promise = (0, diff_1.cmd)('npm', ['run', 'build:core']), entries = [
             ...Object.entries(constants_1.classes),
             ...Object.entries(constants_1.mixins),
             ...Object.entries(constants_1.parsers),
@@ -166,8 +166,10 @@ const Parser = {
     },
     /** @implements */
     isInterwiki(title, { interwiki } = Parser.getConfig()) {
+        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+        /^(zh|en)\s*:/diu;
         return interwiki.length > 0
-            ? new RegExp(`^(${interwiki.join('|')})\\s*:`, 'diu')
+            ? new RegExp(String.raw `^(${interwiki.join('|')})\s*:`, 'diu')
                 .exec(title.replace(/_/gu, ' ').replace(/^\s*:?\s*/u, ''))
             : null;
     },
@@ -215,4 +217,5 @@ for (const key in Parser) {
     }
 }
 Object.defineProperties(Parser, def);
+exports.default = Parser;
 module.exports = Parser;

package/dist/lib/element.d.ts

@@ -27,11 +27,6 @@ export declare abstract class AstElement extends AstNode {
     /** 内部宽度 */
     get clientWidth(): number | undefined;
     constructor();
-    /**
-     * 可见部分
-     * @param separator 子节点间的连接符
-     */
-    text(separator?: string): string;
     /** 合并相邻的文本子节点 */
     normalize(): void;
     /**

package/dist/lib/element.js

@@ -21,7 +21,7 @@ const toCase = (val, i) => i ? val.toLowerCase() : val;
  * @param str 表达式
  * @param i 待检查的下标
  */
-const nth = (str, i) => new ranges_1.Ranges(str.split(',')).applyTo(i + 1).includes(i);
+const nth = (str, i) => new ranges_1.Ranges(str).applyTo(i + 1).includes(i);
 /**
  * 检测:lang()伪选择器
  * @param node 节点
@@ -30,7 +30,7 @@ const nth = (str, i) => new ranges_1.Ranges(str.split(',')).applyTo(i + 1).inclu
  */
 const matchesLang = ({ attributes }, regex) => {
     const lang = attributes?.['lang'];
-    return typeof lang === 'string' && regex.test(lang);
+    return lang === undefined ? undefined : typeof lang === 'string' && regex.test(lang);
 };
 const primitives = new Set(['string', 'number', 'boolean', 'undefined']);
 /* NOT FOR BROWSER END */
@@ -88,10 +88,7 @@ class AstElement extends node_1.AstNode {
         this.seal('name');
     }
     /* NOT FOR BROWSER END */
-    /**
-     * 可见部分
-     * @param separator 子节点间的连接符
-     */
+    /** @private */
     text(separator) {
         return (0, string_1.text)(this.childNodes, separator);
     }
@@ -145,10 +142,10 @@ class AstElement extends node_1.AstNode {
     insertAt(node, i = this.length) {
         /* NOT FOR BROWSER */
         if (node.contains(this)) {
-            throw new RangeError('不能插入祖先节点！');
+            throw new RangeError('Cannot insert an ancestor node!');
         }
-        if (this.childNodes.includes(node)) {
-            throw new RangeError('不能插入子节点！');
+        else if (this.childNodes.includes(node)) {
+            throw new RangeError('Cannot insert its own child node!');
         }
         this.verifyChild(i, 1);
         node.parentNode?.removeChild(node);
@@ -275,7 +272,7 @@ class AstElement extends node_1.AstNode {
             return data;
         }
         /* NOT FOR BROWSER */
-        throw new RangeError(`第 ${i} 个子节点是 ${oldText.constructor.name}！`);
+        throw new RangeError(`The child node at position ${i} is ${oldText.constructor.name}!`);
     }
     /** @private */
     toString(separator = '') {
@@ -310,17 +307,14 @@ class AstElement extends node_1.AstNode {
         };
         for (let i = 0, cur = start + this.getAttribute('padding'); i < this.length; i++) {
             const child = this.childNodes[i], { length } = child.toString();
-            if (child.type === 'text') {
-                json.childNodes.push({ data: child.data, range: [cur, cur + length] });
-            }
-            else {
-                json.childNodes.push(child.json(undefined, cur));
-            }
+            json.childNodes.push(child.type === 'text'
+                ? { data: child.data, range: [cur, cur + length] }
+                : child.json(undefined, cur));
             cur += length + this.getGaps(i);
         }
         /* NOT FOR BROWSER */
         if (typeof file === 'string') {
-            fs.writeFileSync(path.join(__dirname.slice(0, -4), '..', 'printed', file + (file.endsWith('.json') ? '' : '.json')), JSON.stringify(json, null, 2));
+            fs.writeFileSync(path.join(__dirname, '..', '..', 'printed', file + (file.endsWith('.json') ? '' : '.json')), JSON.stringify(json, null, 2));
         }
         /* NOT FOR BROWSER END */
         return json;
@@ -332,8 +326,24 @@ class AstElement extends node_1.AstNode {
         if (!parentNode) {
             return undefined;
         }
-        const { childNodes, fixed } = parentNode, protectedIndices = parentNode.getAttribute('protectedChildren').applyTo(childNodes);
-        return fixed || protectedIndices.includes(childNodes.indexOf(this));
+        const { childNodes, fixed } = parentNode;
+        return fixed
+            || parentNode.getAttribute('protectedChildren').applyTo(childNodes)
+                .includes(childNodes.indexOf(this));
+    }
+    /**
+     * 获取属性
+     * @param key 属性键
+     */
+    #getAttr(key) {
+        if (typeof this.getAttr === 'function') {
+            const attr = this.getAttr(key);
+            if (attr !== undefined) {
+                return attr;
+            }
+        }
+        const val = this.getAttribute(key);
+        return val instanceof RegExp ? val.source : val;
     }
     /**
      * 检查是否符合属性选择器
@@ -348,27 +358,17 @@ class AstElement extends node_1.AstNode {
         if (!(key in this) && (!isAttr || !this.hasAttr(key))) {
             return equal === '!=';
         }
-        const v = toCase(val, i);
-        let thisVal = this.getAttribute(key);
-        if (isAttr) {
-            const attr = this.getAttr(key);
-            if (attr !== undefined) {
-                thisVal = attr === true ? '' : attr;
-            }
-        }
+        const v = toCase(val, i), thisVal = this.#getAttr(key);
         if (!equal) {
             return thisVal !== undefined && thisVal !== false;
         }
-        else if (thisVal instanceof RegExp) {
-            thisVal = thisVal.source;
-        }
         if (equal === '~=') {
             const thisVals = typeof thisVal === 'string' ? thisVal.split(/\s/u) : thisVal;
             return Boolean(thisVals?.[Symbol.iterator])
                 && [...thisVals].some(w => typeof w === 'string' && toCase(w, i) === v);
         }
         else if (!primitives.has(typeof thisVal) && !(thisVal instanceof title_1.Title)) {
-            throw new RangeError(`复杂属性 ${key} 不能用于选择器！`);
+            throw new RangeError(`The complex attribute ${key} cannot be used in a selector!`);
         }
         const stringVal = toCase(String(thisVal), i);
         switch (equal) {
@@ -430,7 +430,7 @@ class AstElement extends node_1.AstNode {
                             || type === 'free-ext-link'
                             || type === 'magic-link'
                             || type === 'ext-link'
-                            || (type === 'file' || type === 'gallery-image' && link);
+                            || (type === 'file' || type === 'gallery-image') && link;
                     case ':local-link':
                         return (type === 'link' || type === 'file' || type === 'gallery-image')
                             && link instanceof title_1.Title
@@ -469,24 +469,31 @@ class AstElement extends node_1.AstNode {
                 case 'has':
                     return Boolean(this.querySelector(s));
                 case 'lang': {
-                    const regex = new RegExp(`^${s}(?:-|$)`, 'u');
-                    return matchesLang(this, regex)
-                        || this.getAncestors().some(ancestor => matchesLang(ancestor, regex));
+                    // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+                    /^zh(?:-|$)/iu;
+                    const regex = new RegExp(`^${s}(?:-|$)`, 'iu');
+                    for (let node = this; node; node = node.parentNode) {
+                        const result = matchesLang(node, regex);
+                        if (result !== undefined) {
+                            return result;
+                        }
+                    }
+                    return false;
                 }
                 case 'regex': {
                     const mt = /^([^,]+),\s*\/(.+)\/([a-z]*)$/u.exec(s);
                     if (!mt) {
-                        throw new SyntaxError('错误的伪选择器用法。请使用形如 ":regex(\'attr, /re/i\')" 的格式。');
+                        throw new SyntaxError(`Wrong usage of the regex pseudo-selector. Use ":regex('attr, /re/i')" format.`);
                     }
                     try {
-                        return new RegExp(mt[2], mt[3]).test(String(this.getAttribute(mt[1].trim())));
+                        return new RegExp(mt[2], mt[3]).test(String(this.#getAttr(mt[1].trim())));
                     }
                     catch {
-                        throw new SyntaxError(`错误的正则表达式：/${mt[2]}/${mt[3]}`);
+                        throw new SyntaxError(`Invalid regular expression: /${mt[2]}/${mt[3]}`);
                     }
                 }
                 default:
-                    throw new SyntaxError(`未定义的伪选择器：${pseudo}`);
+                    throw new SyntaxError(`Undefined pseudo-selector: ${pseudo}`);
             }
         });
     }

package/dist/lib/node.d.ts

@@ -19,7 +19,7 @@ export declare abstract class AstNode implements AstNodeBase {
     type: TokenTypes | 'text';
     data?: string | undefined;
     readonly childNodes: readonly AstNodes[];
-    abstract text(): string;
+    text(): string;
     lint(): LintError[];
     print(): string;
     /** 首位子节点 */

package/dist/lib/node.js

@@ -130,13 +130,13 @@ class AstNode {
     }
     /** 字体样式 */
     get font() {
-        const { parentNode } = this, acceptable = parentNode?.getAttribute('acceptable');
+        const { parentNode } = this, acceptable = parentNode?.getAcceptable();
         if (!parentNode || acceptable && !('QuoteToken' in acceptable)) {
             return { bold: false, italic: false };
         }
-        const { childNodes } = parentNode, index = childNodes.indexOf(this), isQuote = (0, debug_1.isToken)('quote');
-        let bold = false, italic = false;
-        for (let i = index - 1; i >= 0; i--) {
+        const { childNodes, type } = parentNode, isQuote = (0, debug_1.isToken)('quote');
+        let { bold = false, italic = false } = type === 'ext-link-text' && parentNode.parentNode || {};
+        for (let i = childNodes.indexOf(this) - 1; i >= 0; i--) {
             const child = childNodes[i];
             if (isQuote(child)) {
                 bold = child.bold !== bold;
@@ -168,7 +168,7 @@ class AstNode {
             /* NOT FOR BROWSER */
         }
         else if (key === 'optional') {
-            return new Set(this.#optional);
+            return this.#optional;
             /* NOT FOR BROWSER END */
         }
         return this[key];
@@ -264,7 +264,7 @@ class AstNode {
     }
     /** @private */
     constructorError(msg) {
-        throw new Error(`${this.constructor.name} ${msg}！`);
+        throw new Error(`${this.constructor.name} ${msg}!`);
     }
     /**
      * 是否是全同节点
@@ -292,7 +292,7 @@ class AstNode {
     #insertAdjacent(nodes, offset) {
         const { parentNode } = this;
         if (!parentNode) {
-            throw new Error('The node has no parent!');
+            throw new Error('There is no parent node!');
         }
         const i = parentNode.childNodes.indexOf(this) + offset;
         for (let j = 0; j < nodes.length; j++) {
@@ -336,7 +336,7 @@ class AstNode {
     verifyChild(i, addition = 0) {
         const { childNodes: { length } } = this;
         if (i < -length || i >= length + addition) {
-            throw new RangeError(`The ${i}th child does not exist!`);
+            throw new RangeError(`The child node at position ${i} does not exist!`);
         }
     }
     /**
@@ -436,7 +436,7 @@ class AstNode {
             return 1;
         }
         else if (this.getRootNode() !== other.getRootNode()) {
-            throw new RangeError('不在同一个语法树！');
+            throw new RangeError('Nodes to be compared are not in the same document!');
         }
         const aAncestors = [...this.getAncestors().reverse(), this], bAncestors = [...other.getAncestors().reverse(), other], depth = aAncestors.findIndex((ancestor, i) => bAncestors[i] !== ancestor), { childNodes } = aAncestors[depth - 1];
         return childNodes.indexOf(aAncestors[depth]) - childNodes.indexOf(bAncestors[depth]);

package/dist/lib/rect.d.ts

@@ -0,0 +1,18 @@
+import type { AstNodes, Position } from './node';
+/** 节点位置 */
+export declare class BoundingRect {
+    #private;
+    readonly token: AstNodes;
+    readonly start: number;
+    /** 起点行 */
+    get top(): number;
+    /** 起点列 */
+    get left(): number;
+    /**
+     * @param token 节点
+     * @param start 起点
+     */
+    constructor(token: AstNodes, start: number);
+    /** 计算位置 */
+    getPosition(): Position;
+}

package/dist/lib/rect.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoundingRect = void 0;
+const constants_1 = require("../util/constants");
+/** 节点位置 */
+class BoundingRect {
+    #pos;
+    token;
+    start;
+    /** 起点行 */
+    get top() {
+        this.#pos ??= this.getPosition();
+        return this.#pos.top;
+    }
+    /** 起点列 */
+    get left() {
+        this.#pos ??= this.getPosition();
+        return this.#pos.left;
+    }
+    /**
+     * @param token 节点
+     * @param start 起点
+     */
+    constructor(token, start) {
+        this.token = token;
+        this.start = start;
+    }
+    /** 计算位置 */
+    getPosition() {
+        return this.token.getRootNode().posFromIndex(this.start);
+    }
+}
+exports.BoundingRect = BoundingRect;
+constants_1.classes['BoundingRect'] = __filename;

package/dist/lib/text.js

@@ -6,16 +6,11 @@ const debug_1 = require("../util/debug");
 const string_1 = require("../util/string");
 const index_1 = require("../index");
 const node_1 = require("./node");
-// eslint-disable-next-line @typescript-eslint/no-unused-expressions
+/* eslint-disable @typescript-eslint/no-unused-expressions */
 /<\s*(?:\/\s*)?([a-z]\w*)|\{+|\}+|\[{2,}|\[(?![^[]*?\])|((?:^|\])[^[]*?)\]+|https?[:/]\/+/giu;
-const source = '<\\s*(?:\\/\\s*)?([a-z]\\w*)' // 疑似标签
-    + '|'
-    + '\\{+|\\}+' // `{`、`}`
-    + '|'
-    + '\\[{2,}|\\[(?![^[]*?\\])' // `[`
-    + '|'
-    + '((?:^|\\])[^[]*?)\\]+', // `]`
-errorSyntax = new RegExp(`${source}|https?[:/]\\/+`, 'giu'), errorSyntaxUrl = new RegExp(source, 'giu'), extImage = new RegExp(`^https?:\\/\\/${string_1.extUrlCharFirst}${string_1.extUrlChar}\\.(?:gif|png|jpg|jpeg)$`, 'iu'), regexes = {
+/^https?:\/\/(?:\[[\da-f:.]+\]|[^[\]<>"\t\n\p{Zs}])[^[\]<>"\t\n\p{Zs}]*\.(?:gif|png|jpg|jpeg)$/iu;
+/* eslint-enable @typescript-eslint/no-unused-expressions */
+const source = String.raw `<\s*(?:/\s*)?([a-z]\w*)|\{+|\}+|\[{2,}|\[(?![^[]*?\])|((?:^|\])[^[]*?)\]+`, errorSyntax = new RegExp(String.raw `${source}|https?[:/]/+`, 'giu'), errorSyntaxUrl = new RegExp(source, 'giu'), extImage = new RegExp(String.raw `^https?://${string_1.extUrlCharFirst}${string_1.extUrlChar}\.(?:gif|png|jpg|jpeg)$`, 'iu'), regexes = {
     '[': /[[\]]/u,
     '{': /[{}]/u,
     ']': /[[\]](?=[^[\]]*$)/u,
@@ -114,7 +109,7 @@ class AstText extends node_1.AstNode {
     lint(start = this.getAbsoluteIndex(), errorRegex) {
         const { data, parentNode, nextSibling, previousSibling } = this;
         if (!parentNode) {
-            throw new Error('无法对孤立文本节点进行语法分析！');
+            throw new Error('An isolated text node cannot be linted!');
         }
         const { type, name, parentNode: grandparent } = parentNode;
         let isHtmlAttrVal = false;
@@ -312,11 +307,11 @@ class AstText extends node_1.AstNode {
      */
     splitText(offset) {
         if (offset > this.length || offset < -this.length) {
-            throw new RangeError(`错误的断开位置：${offset}`);
+            throw new RangeError(`Wrong offset to split: ${offset}`);
         }
         const { parentNode, data } = this;
         if (!parentNode) {
-            throw new Error('待分裂的文本节点没有父节点！');
+            throw new Error('The text node to be split has no parent node!');
         }
         const newText = new AstText(data.slice(offset));
         (0, debug_1.setChildNodes)(parentNode, parentNode.childNodes.indexOf(this) + 1, 0, [newText]);
@@ -329,7 +324,7 @@ class AstText extends node_1.AstNode {
             return super.getRelativeIndex();
         }
         else if (j < 0 || j > this.length) {
-            throw new RangeError('超出文本长度范围！');
+            throw new RangeError('Exceeding the text length range!');
         }
         return j;
     }

package/dist/mixin/attributesParent.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.attributesParent = void 0;
+const debug_1 = require("../util/debug");
 const constants_1 = require("../util/constants");
 /**
  * 子节点含有AttributesToken的类
@@ -74,7 +75,7 @@ const attributesParent = (i = 0) => (constructor, _) => {
             this.#attributesChild.toggleAttr(key, force);
         }
     }
-    Object.defineProperty(AttributesParent, 'name', { value: constructor.name });
+    (0, debug_1.mixin)(AttributesParent, constructor);
     return AttributesParent;
 };
 exports.attributesParent = attributesParent;