wikiparser-node 1.6.1 → 1.6.2

package/dist/addon/table.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const assert = require("assert/strict");
 const debug_1 = require("../util/debug");
 const constants_1 = require("../util/constants");
-const src_1 = require("../src");
+const index_1 = require("../src/index");
 const tr_1 = require("../src/table/tr");
-const table_1 = require("../src/table");
+const index_2 = require("../src/table/index");
 const td_1 = require("../src/table/td");
 const trBase_1 = require("../src/table/trBase");
 /**
@@ -29,11 +29,11 @@ const cmpCoords = (coords1, coords2) => {
  * @param i 单元格序号
  * @param oneCol 是否仅有一列
  */
-const isStartCol = (rowLayout, i, oneCol = false) => {
+const isStartCol = (rowLayout, i, oneCol) => {
     const coords = rowLayout[i];
     return rowLayout[i - 1] !== coords && (!oneCol || rowLayout[i + 1] !== coords);
 };
-function occupied(layout, i, oneRow = false, cells) {
+function occupied(layout, i, oneRow, cells) {
     const rowLayout = layout[i];
     if (rowLayout) {
         return rowLayout.map(({ row, column }, j) => row === i && (!oneRow || cells[column]?.rowspan === 1) ? j : undefined).filter((j) => j !== undefined);
@@ -46,7 +46,7 @@ function occupied(layout, i, oneRow = false, cells) {
  * @param attr 属性
  * @param multi 是否对所有单元格设置，或是仅对行首单元格设置
  */
-const format = (cells, attr = {}, multi = false) => {
+const format = (cells, attr = {}, multi) => {
     for (const [token, start] of cells) {
         if (multi || start) {
             if (typeof attr === 'string') {
@@ -76,18 +76,18 @@ const fill = (y, rowToken, layout, maxCol, token) => {
         }
     });
 };
-table_1.TableToken.prototype.printLayout =
+index_2.TableToken.prototype.printLayout =
     /** @implements */
     function () {
         this.getLayout().print();
     };
-table_1.TableToken.prototype.toRenderedCoords =
+index_2.TableToken.prototype.toRenderedCoords =
     /** @implements */
     function ({ row, column }) {
         const rowLayout = this.getLayout({ row, column })[row], x = rowLayout?.findIndex(coords => cmpCoords(coords, { row, column }) === 0);
         return rowLayout && (x === -1 ? undefined : { y: row, x: x });
     };
-table_1.TableToken.prototype.toRawCoords =
+index_2.TableToken.prototype.toRawCoords =
     /** @implements */
     function ({ x, y }) {
         const rowLayout = this.getLayout({ x, y })[y], coords = rowLayout?.[x];
@@ -101,35 +101,35 @@ table_1.TableToken.prototype.toRawCoords =
         }
         return { row: 0, column: 0, start: true };
     };
-table_1.TableToken.prototype.getFullRow =
+index_2.TableToken.prototype.getFullRow =
     /** @implements */
     function (y) {
         const rows = this.getAllRows();
         return new Map(this.getLayout({ y })[y]?.map(({ row, column }) => [rows[row].getNthCol(column), row === y]));
     };
-table_1.TableToken.prototype.getFullCol =
+index_2.TableToken.prototype.getFullCol =
     /** @implements */
     function (x) {
         const layout = this.getLayout(), colLayout = layout.map(row => row[x]).filter(Boolean), rows = this.getAllRows();
         return new Map(colLayout.map(coords => [rows[coords.row].getNthCol(coords.column), layout[coords.row][x - 1] !== coords]));
     };
-table_1.TableToken.prototype.formatTableRow =
+index_2.TableToken.prototype.formatTableRow =
     /** @implements */
-    function (y, attr = {}, multiRow = false) {
+    function (y, attr = {}, multiRow) {
         format(this.getFullRow(y), attr, multiRow);
     };
-table_1.TableToken.prototype.formatTableCol =
+index_2.TableToken.prototype.formatTableCol =
     /** @implements */
-    function (x, attr = {}, multiCol = false) {
+    function (x, attr = {}, multiCol) {
         format(this.getFullCol(x), attr, multiCol);
     };
-table_1.TableToken.prototype.fillTableRow =
+index_2.TableToken.prototype.fillTableRow =
     /** @implements */
     function (y, inner, subtype = 'td', attr = {}) {
         const rowToken = this.getNthRow(y), layout = this.getLayout({ y }), maxCol = Math.max(...layout.map(({ length }) => length)), token = (0, td_1.createTd)(inner, subtype, attr, this.getAttribute('include'), this.getAttribute('config'));
         fill(y, rowToken, layout, maxCol, token);
     };
-table_1.TableToken.prototype.fillTable =
+index_2.TableToken.prototype.fillTable =
     /** @implements */
     function (inner, subtype = 'td', attr = {}) {
         const rowTokens = this.getAllRows(), layout = this.getLayout(), maxCol = Math.max(...layout.map(({ length }) => length)), token = (0, td_1.createTd)(inner, subtype, attr, this.getAttribute('include'), this.getAttribute('config'));
@@ -137,7 +137,7 @@ table_1.TableToken.prototype.fillTable =
             fill(y, rowTokens[y], layout, maxCol, token);
         }
     };
-table_1.TableToken.prototype.insertTableCell =
+index_2.TableToken.prototype.insertTableCell =
     /** @implements */
     function (inner, coords, subtype = 'td', attr = {}) {
         let rawCoords;
@@ -156,11 +156,11 @@ table_1.TableToken.prototype.insertTableCell =
             ? trBase_1.TrBaseToken.prototype.insertTableCell.call(this, inner, rawCoords, subtype, attr)
             : rowToken.insertTableCell(inner, rawCoords, subtype, attr);
     };
-table_1.TableToken.prototype.prependTableRow =
+index_2.TableToken.prototype.prependTableRow =
     /** @implements */
     function () {
         // @ts-expect-error abstract class
-        const row = debug_1.Shadow.run(() => new tr_1.TrToken('\n|-', undefined, this.getAttribute('config'))), { childNodes } = this, [, , plain] = childNodes, start = plain?.constructor === src_1.Token ? 3 : 2, tdChildren = childNodes.slice(start), index = tdChildren.findIndex(({ type }) => type !== 'td');
+        const row = debug_1.Shadow.run(() => new tr_1.TrToken('\n|-', undefined, this.getAttribute('config'))), { childNodes } = this, [, , plain] = childNodes, start = plain?.constructor === index_1.Token ? 3 : 2, tdChildren = childNodes.slice(start), index = tdChildren.findIndex(({ type }) => type !== 'td');
         this.insertAt(row, index === -1 ? -1 : index + start);
         debug_1.Shadow.run(() => {
             for (const cell of tdChildren.slice(0, index === -1 ? undefined : index)) {
@@ -171,7 +171,7 @@ table_1.TableToken.prototype.prependTableRow =
         });
         return row;
     };
-table_1.TableToken.prototype.insertTableRow =
+index_2.TableToken.prototype.insertTableRow =
     /** @implements */
     function (y, attr = {}, inner, subtype = 'td', innerAttr = {}) {
         let reference = this.getNthRow(y, false, true);
@@ -201,7 +201,7 @@ table_1.TableToken.prototype.insertTableRow =
         }
         return token;
     };
-table_1.TableToken.prototype.insertTableCol =
+index_2.TableToken.prototype.insertTableCol =
     /** @implements */
     function (x, inner, subtype = 'td', attr = {}) {
         const layout = this.getLayout(), rowLength = layout.map(({ length }) => length), minCol = Math.min(...rowLength);
@@ -223,7 +223,7 @@ table_1.TableToken.prototype.insertTableCol =
             }
         }
     };
-table_1.TableToken.prototype.removeTableRow =
+index_2.TableToken.prototype.removeTableRow =
     /** @implements */
     function (y) {
         const rows = this.getAllRows(), layout = this.getLayout(), rowLayout = layout[y], set = new WeakSet();
@@ -253,7 +253,7 @@ table_1.TableToken.prototype.removeTableRow =
         rowToken.remove();
         return rowToken;
     };
-table_1.TableToken.prototype.removeTableCol =
+index_2.TableToken.prototype.removeTableCol =
     /** @implements */
     function (x) {
         for (const [token, start] of this.getFullCol(x)) {
@@ -269,7 +269,7 @@ table_1.TableToken.prototype.removeTableCol =
             }
         }
     };
-table_1.TableToken.prototype.mergeCells =
+index_2.TableToken.prototype.mergeCells =
     /** @implements */
     function (xlim, ylim) {
         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)));
@@ -286,7 +286,7 @@ table_1.TableToken.prototype.mergeCells =
         }
         return cornerCell;
     };
-table_1.TableToken.prototype.split =
+index_2.TableToken.prototype.split =
     /** @implements */
     function (coords, dirs) {
         const cell = this.getNthCell(coords), attr = cell.getAttrs(), { subtype } = cell;
@@ -327,22 +327,22 @@ table_1.TableToken.prototype.split =
             }
         }
     };
-table_1.TableToken.prototype.splitIntoRows =
+index_2.TableToken.prototype.splitIntoRows =
     /** @implements */
     function (coords) {
         this.split(coords, new Set(['rowspan']));
     };
-table_1.TableToken.prototype.splitIntoCols =
+index_2.TableToken.prototype.splitIntoCols =
     /** @implements */
     function (coords) {
         this.split(coords, new Set(['colspan']));
     };
-table_1.TableToken.prototype.splitIntoCells =
+index_2.TableToken.prototype.splitIntoCells =
     /** @implements */
     function (coords) {
         this.split(coords, new Set(['rowspan', 'colspan']));
     };
-table_1.TableToken.prototype.replicateTableRow =
+index_2.TableToken.prototype.replicateTableRow =
     /** @implements */
     function (row) {
         let rowToken = this.getNthRow(row);
@@ -360,7 +360,7 @@ table_1.TableToken.prototype.replicateTableRow =
         }
         return replicated;
     };
-table_1.TableToken.prototype.replicateTableCol =
+index_2.TableToken.prototype.replicateTableCol =
     /** @implements */
     function (x) {
         const replicated = [];
@@ -377,7 +377,7 @@ table_1.TableToken.prototype.replicateTableCol =
         }
         return replicated;
     };
-table_1.TableToken.prototype.moveTableRowBefore =
+index_2.TableToken.prototype.moveTableRowBefore =
     /** @implements */
     function (y, before) {
         const layout = this.getLayout();
@@ -403,7 +403,7 @@ table_1.TableToken.prototype.moveTableRowBefore =
         this.insertBefore(rowToken, beforeToken);
         return rowToken;
     };
-table_1.TableToken.prototype.moveTableRowAfter =
+index_2.TableToken.prototype.moveTableRowAfter =
     /** @implements */
     function (y, after) {
         const layout = this.getLayout(), afterToken = this.getNthRow(after), cells = afterToken.childNodes.filter(child => child.type === 'td' && child.subtype !== 'caption');
@@ -429,7 +429,7 @@ table_1.TableToken.prototype.moveTableRowAfter =
             }
         }
         if (afterToken === this) {
-            const index = this.childNodes.slice(2).findIndex(table_1.isRowEnd);
+            const index = this.childNodes.slice(2).findIndex(index_2.isRowEnd);
             this.insertAt(rowToken, index + 2);
         }
         else {
@@ -437,7 +437,7 @@ table_1.TableToken.prototype.moveTableRowAfter =
         }
         return rowToken;
     };
-table_1.TableToken.prototype.moveCol =
+index_2.TableToken.prototype.moveCol =
     /** @implements */
     function (x, reference, after = false) {
         const layout = this.getLayout();
@@ -467,17 +467,17 @@ table_1.TableToken.prototype.moveCol =
                 }
                 if (start) {
                     const col = rowLayout.slice(reference + Number(after)).find(({ row }) => row === i)?.column;
-                    rowToken.insertBefore(token, col === undefined ? rowToken.childNodes.slice(2).find(table_1.isRowEnd) : rowToken.getNthCol(col));
+                    rowToken.insertBefore(token, col === undefined ? rowToken.childNodes.slice(2).find(index_2.isRowEnd) : rowToken.getNthCol(col));
                 }
             }
         }
     };
-table_1.TableToken.prototype.moveTableColBefore =
+index_2.TableToken.prototype.moveTableColBefore =
     /** @implements */
     function (x, before) {
         this.moveCol(x, before);
     };
-table_1.TableToken.prototype.moveTableColAfter =
+index_2.TableToken.prototype.moveTableColAfter =
     /** @implements */
     function (x, after) {
         this.moveCol(x, after, true);

package/dist/base.d.ts

@@ -59,9 +59,6 @@ interface AstElement extends AstNode {
 export interface Parser {
     config: string | Config;
     i18n: string | Record<string, string> | undefined;
-    rules: readonly LintError.Rule[];
-    /** 获取解析设置 */
-    getConfig(): Config;
     /**
      * 解析wikitext
      * @param include 是否嵌入

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import type { Config, LintError, Parser as ParserBase } from './base';
 import type { Title } from './lib/title';
 import type { Token } from './internal';
 declare interface Parser extends ParserBase {
+    rules: readonly LintError.Rule[];
     conversionTable: Map<string, string>;
     redirects: Map<string, string>;
     warning: boolean;

package/dist/index.js

@@ -14,6 +14,7 @@ const diff_1 = require("./util/diff");
  * @param dir 子路径
  */
 const rootRequire = (file, dir) => require(file.startsWith('/') ? file : `../${file.includes('/') ? '' : dir}${file}`);
+const promises = [Promise.resolve()];
 // eslint-disable-next-line @typescript-eslint/no-redeclare
 const Parser = {
     config: 'default',
@@ -54,14 +55,13 @@ const Parser = {
         return msg && (this.i18n?.[msg] ?? msg).replace('$1', this.msg(arg));
     },
     /** @implements */
-    normalizeTitle(title, defaultNs = 0, include = false, config = Parser.getConfig(), halfParsed = false, decode = false, selfLink = false) {
+    normalizeTitle(title, defaultNs = 0, include, config = Parser.getConfig(), halfParsed, decode = false, selfLink = false) {
         const { Title } = require('./lib/title');
         if (halfParsed) {
             return new Title(title, defaultNs, config, decode, selfLink);
         }
         const { Token } = require('./src/index');
         const token = debug_1.Shadow.run(() => new Token(title, config).parseOnce(0, include).parseOnce()), titleObj = new Title(String(token), defaultNs, config, decode, selfLink);
-        /* NOT FOR BROWSER */
         debug_1.Shadow.run(() => {
             for (const key of ['main', 'fragment']) {
                 const str = titleObj[key];
@@ -70,6 +70,7 @@ const Parser = {
                 }
             }
         });
+        /* NOT FOR BROWSER */
         titleObj.conversionTable = this.conversionTable;
         titleObj.redirects = this.redirects;
         /* NOT FOR BROWSER END */
@@ -89,27 +90,25 @@ const Parser = {
                     const file = path.join(__dirname, '..', 'errors', new Date().toISOString()), stage = token.getAttribute('stage');
                     fs.writeFileSync(file, stage === constants_1.MAX_STAGE ? wikitext : String(token));
                     fs.writeFileSync(`${file}.err`, e.stack);
-                    fs.writeFileSync(`${file}.json`, JSON.stringify({
-                        stage, include: token.getAttribute('include'), config: this.config,
-                    }, null, '\t'));
+                    fs.writeFileSync(`${file}.json`, JSON.stringify({ stage, include, config }, null, '\t'));
                 }
                 throw e;
             }
         });
         /* NOT FOR BROWSER */
         if (this.debugging) {
-            let restored = String(root), process = '解析';
+            let restored = String(root), process = 'parsing';
             if (restored === wikitext) {
                 const entities = { lt: '<', gt: '>', amp: '&' };
                 restored = root.print().replace(/<[^<]+?>|&([lg]t|amp);/gu, (_, s) => s ? entities[s] : '');
-                process = '渲染HTML';
+                process = 'printing';
             }
             if (restored !== wikitext) {
                 const { diff } = require('./util/diff');
-                const { 0: cur, length } = constants_1.promises;
-                constants_1.promises.unshift((async () => {
+                const { 0: cur, length } = promises;
+                promises.unshift((async () => {
                     await cur;
-                    this.error(`${process}过程中不可逆地修改了原始文本！`);
+                    this.error(`Original wikitext is altered when ${process}!`);
                     return diff(wikitext, restored, length);
                 })());
             }
@@ -168,17 +167,16 @@ const Parser = {
             : null;
     },
     /** @implements */
-    reparse(date) {
+    reparse(date = '') {
         const main = fs.readdirSync(path.join(__dirname, '..', 'errors'))
             .find(name => name.startsWith(date) && name.endsWith('Z'));
         if (!main) {
             throw new RangeError(`找不到对应时间戳的错误记录：${date}`);
         }
         const file = path.join(__dirname, '..', 'errors', main), wikitext = fs.readFileSync(file, 'utf8');
-        const { stage, include, config } = require(`${file}.json`), { Token } = require('./src');
-        this.config = config;
+        const { stage, include, config } = require(`${file}.json`), { Token } = require('./src/index');
         return debug_1.Shadow.run(() => {
-            const halfParsed = stage < constants_1.MAX_STAGE, token = new Token(halfParsed ? wikitext : (0, string_1.tidy)(wikitext), this.getConfig());
+            const halfParsed = stage < constants_1.MAX_STAGE, token = new Token(halfParsed ? wikitext : (0, string_1.tidy)(wikitext), config);
             if (halfParsed) {
                 token.setAttribute('stage', stage);
                 token.parseOnce(stage, include);

package/dist/lib/element.d.ts

@@ -55,6 +55,11 @@ export declare abstract class AstElement extends AstNode {
      * @param selector 选择器
      */
     closest<T = Token>(selector: string): T | undefined;
+    /**
+     * 符合选择器的所有后代节点
+     * @param selector 选择器
+     */
+    querySelectorAll<T = Token>(selector: string): T[];
     /**
      * 在末尾批量插入子节点
      * @param elements 插入节点
@@ -111,11 +116,6 @@ export declare abstract class AstElement extends AstNode {
      * @param id id名
      */
     getElementById<T = Token>(id: string): T | undefined;
-    /**
-     * 符合选择器的所有后代节点
-     * @param selector 选择器
-     */
-    querySelectorAll<T = Token>(selector: string): T[];
     /**
      * 类选择器
      * @param className 类名之一

package/dist/lib/element.js

@@ -194,6 +194,31 @@ class AstElement extends node_1.AstNode {
         }
         return undefined;
     }
+    /**
+     * 符合条件的所有后代节点
+     * @param condition 条件
+     */
+    #getElementsBy(condition) {
+        const descendants = [];
+        for (const child of this.childNodes) {
+            if (child.type === 'text') {
+                continue;
+            }
+            else if (condition(child)) {
+                descendants.push(child);
+            }
+            descendants.push(...child.#getElementsBy(condition));
+        }
+        return descendants;
+    }
+    /**
+     * 符合选择器的所有后代节点
+     * @param selector 选择器
+     */
+    querySelectorAll(selector) {
+        const condition = this.#getCondition(selector);
+        return this.#getElementsBy(condition);
+    }
     /**
      * 在末尾批量插入子节点
      * @param elements 插入节点
@@ -533,28 +558,6 @@ class AstElement extends node_1.AstNode {
     getElementById(id) {
         return this.#getElementBy((token => 'id' in token && token.id === id));
     }
-    /**
-     * 符合条件的所有后代节点
-     * @param condition 条件
-     */
-    #getElementsBy(condition) {
-        const descendants = [];
-        for (const child of this.children) {
-            if (condition(child)) {
-                descendants.push(child);
-            }
-            descendants.push(...child.#getElementsBy(condition));
-        }
-        return descendants;
-    }
-    /**
-     * 符合选择器的所有后代节点
-     * @param selector 选择器
-     */
-    querySelectorAll(selector) {
-        const condition = this.#getCondition(selector);
-        return this.#getElementsBy(condition);
-    }
     /**
      * 类选择器
      * @param className 类名之一

package/dist/lib/range.js

@@ -233,7 +233,7 @@ class AstRange {
      * 使起始和终止位置重合
      * @param toStart 重合至起始位置
      */
-    collapse(toStart = false) {
+    collapse(toStart) {
         if (toStart) {
             this.#endContainer = this.startContainer;
             this.#endOffset = this.startOffset;

package/dist/lib/ranges.d.ts

@@ -1,6 +1,8 @@
 /** 模拟Python的Range对象。除`step`至少为`1`外，允许负数、小数或`end < start`的情形。 */
 export declare class Range {
-    #private;
+    readonly start: number;
+    readonly end: number;
+    readonly step: number;
     /**
      * @param s 表达式
      * @throws `RangeError` 起点、终点和步长均应为整数

package/dist/lib/ranges.js

@@ -3,11 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Ranges = exports.Range = void 0;
 const constants_1 = require("../util/constants");
 const debug_1 = require("../util/debug");
+const diff_1 = require("../util/diff");
 /** 模拟Python的Range对象。除`step`至少为`1`外，允许负数、小数或`end < start`的情形。 */
 class Range {
-    #start;
-    #end;
-    #step;
+    start;
+    end;
+    step;
     /**
      * @param s 表达式
      * @throws `RangeError` 起点、终点和步长均应为整数
@@ -24,43 +25,43 @@ class Range {
         }
         else if (str.includes(':')) {
             const [start, end, step = '1'] = str.split(':', 3);
-            this.#start = Number(start);
-            this.#end = Number(end || Infinity);
-            this.#step = Math.max(Number(step), 1);
-            if (!Number.isInteger(this.#start)) {
-                throw new RangeError(`起点 ${this.#start} 应为整数！`);
+            this.start = Number(start);
+            this.end = Number(end?.trim() || Infinity);
+            this.step = Math.max(Number(step), 1);
+            if (!Number.isInteger(this.start)) {
+                throw new RangeError(`The start of a range, \`${start}\`, should be an integer!`);
             }
-            else if (this.#end !== Infinity && !Number.isInteger(this.#end)) {
-                throw new RangeError(`终点 ${this.#end} 应为整数！`);
+            else if (this.end !== Infinity && !Number.isInteger(this.end)) {
+                throw new RangeError(`The end of a range, \`${end}\`, should be an integer!`);
             }
-            else if (!Number.isInteger(this.#step)) {
-                throw new RangeError(`步长 ${this.#step} 应为整数！`);
+            else if (!Number.isInteger(this.step)) {
+                throw new RangeError(`The step of a range, \`${step}\`, should be an integer!`);
             }
         }
         else {
-            const mt = /^([+-])?(\d+)?n(?:([+-])(\d+))?$/u
+            const mt = /^([+-])?(\d+)?n(?:\s*([+-])\s*(\d+))?$/u
                 .exec(str);
             if (mt) {
                 const [, sgnA = '+', a = 1, sgnB = '+'] = mt, b = Number(mt[4] ?? 0);
-                this.#step = Number(a);
-                if (this.#step === 0) {
-                    throw new RangeError(`参数 ${str} 中 "n" 的系数不允许为 0！`);
+                this.step = Number(a);
+                if (this.step === 0) {
+                    throw new RangeError(`In the argument \`${str}\`, the coefficient of "n" must not be 0!`);
                 }
-                else if (sgnA === '+') {
-                    this.#start = sgnB === '+' || b === 0 ? b : this.#step - 1 - (b - 1) % this.#step;
-                    this.#end = Infinity;
+                else if (sgnA === '+') { // `an+b` or `an-b`
+                    this.start = sgnB === '+' || b === 0 ? b : this.step - 1 - (b - 1) % this.step;
+                    this.end = Infinity;
                 }
-                else if (sgnB === '-') {
-                    this.#start = 0;
-                    this.#end = b > 0 ? 0 : this.#step;
+                else if (sgnB === '-') { // `-an-b`
+                    this.start = 0;
+                    this.end = b > 0 ? 0 : this.step;
                 }
-                else {
-                    this.#start = b % this.#step;
-                    this.#end = this.#step + b;
+                else { // `-an+b`
+                    this.start = b % this.step;
+                    this.end = this.step + b;
                 }
             }
             else {
-                throw new RangeError(`参数 ${str} 应写作CSS选择器的 "an+b" 形式或Python切片！`);
+                throw new RangeError(`The argument \`${str}\` should be either in the form of "an+b" as in CSS selectors or Python slices!`);
             }
         }
     }
@@ -69,7 +70,7 @@ class Range {
      * @param arr 参考数组`[0, 1, 2, ...]`
      */
     applyTo(arr) {
-        return arr.slice(this.#start, this.#end).filter((_, j) => j % this.#step === 0);
+        return arr.slice(this.start, this.end).filter((_, j) => j % this.step === 0);
     }
 }
 exports.Range = Range;
@@ -81,7 +82,7 @@ class Ranges extends Array {
         if (a === undefined) {
             return;
         }
-        for (const ele of Array.isArray(a) ? a : [a]) {
+        for (const ele of (Array.isArray(a) ? a : [a])) {
             if (ele instanceof Range) {
                 this.push(ele);
                 continue;
@@ -97,7 +98,11 @@ class Ranges extends Array {
                 try {
                     this.push(new Range(ele));
                 }
-                catch { }
+                catch (e) {
+                    if (e instanceof RangeError) {
+                        (0, diff_1.error)(e.message);
+                    }
+                }
             }
         }
     }

package/dist/lib/text.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstText = void 0;
 const constants_1 = require("../util/constants");
 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
@@ -269,8 +270,7 @@ class AstText extends node_1.AstNode {
     }
     /** @override */
     print() {
-        const entities = { '&': 'amp', '<': 'lt', '>': 'gt' };
-        return this.data.replace(/[&<>]/gu, p => `&${entities[p]};`);
+        return (0, string_1.escape)(this.data);
     }
     /* NOT FOR BROWSER */
     /** 复制 */

package/dist/lib/title.d.ts

@@ -1,28 +1,30 @@
-import Parser from '../index';
+import type { Config } from '../base';
 /** MediaWiki页面标题对象 */
 export declare class Title {
     #private;
-    readonly valid: boolean;
     ns: number;
     fragment: string | undefined;
     interwiki: string;
+    readonly valid: boolean;
     /** 不含命名空间的标题主体部分 */
     get main(): string;
     set main(title: string);
-    /** 扩展名 */
-    get extension(): string | undefined;
-    set extension(extension: string | undefined);
     /** 命名空间前缀 */
     get prefix(): string;
     /** 完整标题 */
     get title(): string;
+    /** 扩展名 */
+    get extension(): string | undefined;
+    set extension(extension: string | undefined);
     /**
+     * @see MediaWikiTitleCodec::splitTitleString
+     *
      * @param title 标题（含或不含命名空间前缀）
      * @param defaultNs 命名空间
      * @param decode 是否需要解码
      * @param selfLink 是否允许selfLink
      */
-    constructor(title: string, defaultNs?: number, config?: Parser.Config, decode?: boolean, selfLink?: boolean);
+    constructor(title: string, defaultNs: number, config: Config, decode: boolean, selfLink: boolean);
     /** 执行单向转换 */
     autoConvert(): void;
     /** 转换为主页面 */