wikiparser-node 0.3.1 → 0.5.0

package/src/transclude.js

@@ -1,8 +1,9 @@
 'use strict';
 
-const {removeComment, escapeRegExp, text, noWrap} = require('../util/string'),
+const {removeComment, escapeRegExp, text, noWrap, print} = require('../util/string'),
 	{externalUse} = require('../util/debug'),
-	/** @type {Parser} */ Parser = require('..'),
+	{generateForChild} = require('../util/lint'),
+	Parser = require('..'),
 	Token = require('.'),
 	ParameterToken = require('./parameter');
 
@@ -16,12 +17,16 @@ class TranscludeToken extends Token {
 	/** @type {Set<string>} */ #keys = new Set();
 	/** @type {Record<string, Set<ParameterToken>>} */ #args = {};
 
-	/** @complexity `n` */
+	/**
+	 * 设置引用修饰符
+	 * @param {string} modifier 引用修饰符
+	 * @complexity `n`
+	 */
 	setModifier(modifier = '') {
 		if (typeof modifier !== 'string') {
 			this.typeError('setModifier', 'String');
 		}
-		const [,, raw, subst] = this.getAttribute('config').parserFunction,
+		const {parserFunction: [,, raw, subst]} = this.getAttribute('config'),
 			lcModifier = modifier.trim().toLowerCase(),
 			isRaw = raw.includes(lcModifier),
 			isSubst = subst.includes(lcModifier),
@@ -36,16 +41,17 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {string} title
-	 * @param {[string, string|undefined][]} parts
+	 * @param {string} title 模板标题或魔术字
+	 * @param {[string, string|undefined][]} parts 参数各部分
 	 * @param {accum} accum
 	 * @complexity `n`
+	 * @throws `SyntaxError` 非法的模板名称
 	 */
 	constructor(title, parts, config = Parser.getConfig(), accum = []) {
 		super(undefined, config, true, accum, {AtomToken: 0, SyntaxToken: 0, ParameterToken: '1:'});
 		const AtomToken = require('./atom'),
-			SyntaxToken = require('./syntax'),
-			{parserFunction: [insensitive, sensitive, raw]} = config;
+			SyntaxToken = require('./syntax');
+		const {parserFunction: [insensitive, sensitive, raw]} = config;
 		this.seal('modifier');
 		if (title.includes(':')) {
 			const [modifier, ...arg] = title.split(':');
@@ -58,13 +64,13 @@ class TranscludeToken extends Token {
 				name = removeComment(magicWord),
 				isSensitive = sensitive.includes(name);
 			if (isSensitive || insensitive.includes(name.toLowerCase())) {
-				this.setAttribute('name', name.toLowerCase().replace(/^#/, '')).type = 'magic-word';
-				const pattern = RegExp(`^\\s*${name}\\s*$`, isSensitive ? '' : 'i'),
+				this.setAttribute('name', name.toLowerCase().replace(/^#/u, '')).type = 'magic-word';
+				const pattern = new RegExp(`^\\s*${name}\\s*$`, isSensitive ? 'u' : 'iu'),
 					token = new SyntaxToken(magicWord, pattern, 'magic-word-name', config, accum, {
 						'Stage-1': ':', '!ExtToken': '',
 					});
 				this.appendChild(token);
-				if (arg.length) {
+				if (arg.length > 0) {
 					parts.unshift([arg.join(':')]);
 				}
 				if (this.name === 'invoke') {
@@ -79,13 +85,13 @@ class TranscludeToken extends Token {
 						}`, config, accum, {'Stage-1': ':', '!ExtToken': ''});
 						this.appendChild(invoke);
 					}
-					this.protectChildren('1:3');
+					this.getAttribute('protectChildren')('1:3');
 				}
 			}
 		}
 		if (this.type === 'template') {
 			const [name] = removeComment(title).split('#');
-			if (/\0\d+[eh!+-]\x7f|[<>[\]{}]/.test(name)) {
+			if (/\0\d+[eh!+-]\x7F|[<>[\]{}]/u.test(name)) {
 				accum.pop();
 				throw new SyntaxError(`非法的模板名称：${name}`);
 			}
@@ -93,7 +99,7 @@ class TranscludeToken extends Token {
 			const token = new AtomToken(title, 'template-name', config, accum, {'Stage-2': ':', '!HeadingToken': ''});
 			this.appendChild(token);
 		}
-		const templateLike = this.matches('template, magic-word#invoke');
+		const templateLike = this.isTemplate();
 		let i = 1;
 		for (const part of parts) {
 			if (!templateLike) {
@@ -106,28 +112,29 @@ class TranscludeToken extends Token {
 			}
 			this.appendChild(new ParameterToken(...part, config, accum));
 		}
-		this.protectChildren(0);
+		this.getAttribute('protectChildren')(0);
 	}
 
+	/** @override */
 	cloneNode() {
-		const [first, ...cloned] = this.cloneChildren(),
+		const [first, ...cloned] = this.cloneChildNodes(),
 			config = this.getAttribute('config');
 		return Parser.run(() => {
 			const token = new TranscludeToken(this.type === 'template' ? '' : first.text(), [], config);
 			token.setModifier(this.modifier);
-			token.firstElementChild.safeReplaceWith(first);
+			token.firstChild.safeReplaceWith(first);
 			token.afterBuild();
 			token.append(...cloned);
 			return token;
 		});
 	}
 
+	/** @override */
 	afterBuild() {
 		if (this.name.includes('\0')) {
-			this.setAttribute('name', text(this.buildFromStr(this.name)));
+			this.setAttribute('name', text(this.getAttribute('buildFromStr')(this.name)));
 		}
-		if (this.matches('template, magic-word#invoke')) {
-			const that = this;
+		if (this.isTemplate()) {
 			/**
 			 * 当事件bubble到`parameter`时，将`oldKey`和`newKey`保存进AstEventData。
 			 * 当继续bubble到`template`时，处理并删除`oldKey`和`newKey`。
@@ -140,15 +147,15 @@ class TranscludeToken extends Token {
 					delete data.oldKey;
 					delete data.newKey;
 				}
-				if (prevTarget === that.firstElementChild && that.type === 'template') {
-					that.setAttribute('name', that.normalizeTitle(prevTarget.text(), 10).title);
+				if (prevTarget === this.firstChild && this.type === 'template') {
+					this.setAttribute('name', this.normalizeTitle(prevTarget.text(), 10).title);
 				} else if (oldKey !== newKey && prevTarget instanceof ParameterToken) {
-					const oldArgs = that.getArgs(oldKey, false, false);
+					const oldArgs = this.getArgs(oldKey, false, false);
 					oldArgs.delete(prevTarget);
-					that.getArgs(newKey, false, false).add(prevTarget);
-					that.#keys.add(newKey);
+					this.getArgs(newKey, false, false).add(prevTarget);
+					this.#keys.add(newKey);
 					if (oldArgs.size === 0) {
-						that.#keys.delete(oldKey);
+						this.#keys.delete(oldKey);
 					}
 				}
 			};
@@ -157,17 +164,20 @@ class TranscludeToken extends Token {
 		return this;
 	}
 
+	/** 替换引用 */
 	subst() {
 		this.setModifier('subst');
 	}
 
+	/** 安全的替换引用 */
 	safesubst() {
 		this.setModifier('safesubst');
 	}
 
 	/**
+	 * @override
 	 * @template {string} T
-	 * @param {T} key
+	 * @param {T} key 属性键
 	 * @returns {TokenAttribute<T>}
 	 */
 	getAttribute(key) {
@@ -179,38 +189,83 @@ class TranscludeToken extends Token {
 		return super.getAttribute(key);
 	}
 
-	toString() {
-		const {children, childNodes: {length}, firstChild} = this;
-		return `{{${this.modifier}${this.modifier && ':'}${
+	/**
+	 * @override
+	 * @param {string} selector
+	 */
+	toString(selector) {
+		if (selector && this.matches(selector)) {
+			return '';
+		}
+		const {childNodes, firstChild, modifier} = this;
+		return `{{${modifier}${modifier && ':'}${
 			this.type === 'magic-word'
-				? `${String(firstChild)}${length > 1 ? ':' : ''}${children.slice(1).map(String).join('|')}`
-				: super.toString('|')
+				? `${String(firstChild)}${childNodes.length > 1 ? ':' : ''}${childNodes.slice(1).map(String).join('|')}`
+				: super.toString(selector, '|')
 		}}}`;
 	}
 
+	/** @override */
 	getPadding() {
 		return this.modifier ? this.modifier.length + 3 : 2;
 	}
 
+	/** @override */
 	getGaps() {
 		return 1;
 	}
 
+	/** @override */
+	print() {
+		const {childNodes, firstChild, modifier} = this;
+		return `<span class="wpb-${this.type}">{{${modifier}${modifier && ':'}${
+			this.type === 'magic-word'
+				? `${firstChild.print()}${childNodes.length > 1 ? ':' : ''}${print(childNodes.slice(1), {sep: '|'})}`
+				: print(childNodes, {sep: '|'})
+		}}}</span>`;
+	}
+
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start);
+		if (!this.isTemplate()) {
+			return errors;
+		}
+		const duplicatedArgs = this.getDuplicatedArgs();
+		if (duplicatedArgs.length > 0) {
+			const rect = this.getRootNode().posFromIndex(start);
+			errors.push(...duplicatedArgs.flatMap(([, args]) => [...args]).map(
+				arg => generateForChild(arg, rect, '重复参数'),
+			));
+		}
+		return errors;
+	}
+
+	/** 是否是模板 */
+	isTemplate() {
+		return this.type === 'template' || this.type === 'magic-word' && this.name === 'invoke';
+	}
+
 	/**
+	 * @override
 	 * @returns {string}
 	 * @complexity `n`
 	 */
 	text() {
-		const {children, childNodes: {length}, firstElementChild} = this;
-		return `{{${this.modifier}${this.modifier && ':'}${
+		const {childNodes, firstChild, modifier} = this;
+		return `{{${modifier}${modifier && ':'}${
 			this.type === 'magic-word'
-				? `${firstElementChild.text()}${length > 1 ? ':' : ''}${text(children.slice(1), '|')}`
+				? `${firstChild.text()}${childNodes.length > 1 ? ':' : ''}${text(childNodes.slice(1), '|')}`
 				: super.text('|')
 		}}}`;
 	}
 
 	/**
-	 * @param {number|ParameterToken} addedToken
+	 * 处理匿名参数更改
+	 * @param {number|ParameterToken} addedToken 新增的参数
 	 * @complexity `n`
 	 */
 	#handleAnonArgChange(addedToken) {
@@ -223,8 +278,9 @@ class TranscludeToken extends Token {
 			this.#keys.delete(maxAnon);
 		}
 		const j = added ? args.indexOf(addedToken) : addedToken - 1;
-		for (const [i, token] of [...args.entries()].slice(j)) {
-			const {name} = token,
+		for (let i = j; i < args.length; i++) {
+			const token = args[i],
+				{name} = token,
 				newName = String(i + 1);
 			if (name !== newName) {
 				this.getArgs(newName, false, false).add(token.setAttribute('name', newName));
@@ -236,7 +292,8 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {number} i
+	 * @override
+	 * @param {number} i 移除位置
 	 * @complexity `n`
 	 */
 	removeAt(i) {
@@ -254,7 +311,9 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {ParameterToken} token
+	 * @override
+	 * @param {ParameterToken} token 待插入的子节点
+	 * @param {number} i 插入位置
 	 * @complexity `n`
 	 */
 	insertAt(token, i = this.childNodes.length) {
@@ -269,28 +328,34 @@ class TranscludeToken extends Token {
 	}
 
 	/**
+	 * 获取所有参数
 	 * @returns {ParameterToken[]}
 	 * @complexity `n`
 	 */
 	getAllArgs() {
-		return this.children.filter(child => child instanceof ParameterToken);
+		return this.childNodes.filter(child => child instanceof ParameterToken);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取匿名参数
+	 * @complexity `n`
+	 */
 	getAnonArgs() {
 		return this.getAllArgs().filter(({anon}) => anon);
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 获取指定参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
+	 * @param {boolean} copy 是否返回一个备份
 	 * @complexity `n`
 	 */
-	getArgs(key, exact = false, copy = true) {
-		if (!['string', 'number'].includes(typeof key)) {
+	getArgs(key, exact, copy = true) {
+		if (typeof key !== 'string' && typeof key !== 'number') {
 			this.typeError('getArgs', 'String', 'Number');
-		} else if (!copy && !Parser.debugging && externalUse('getArgs')) {
-			this.debugOnly('getArgs');
 		}
+		copy ||= !Parser.debugging && externalUse('getArgs');
 		const keyStr = String(key).trim();
 		let args = this.#args[keyStr];
 		if (!args) {
@@ -306,26 +371,32 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 是否具有某参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
 	 * @complexity `n`
 	 */
-	hasArg(key, exact = false) {
+	hasArg(key, exact) {
 		return this.getArgs(key, exact, false).size > 0;
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 获取生效的指定参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
 	 * @complexity `n`
 	 */
-	getArg(key, exact = false) {
-		return [...this.getArgs(key, exact, false)].sort((a, b) => a.comparePosition(b)).at(-1);
+	getArg(key, exact) {
+		return [...this.getArgs(key, exact, false)].sort((a, b) => a.compareDocumentPosition(b)).at(-1);
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 移除指定参数
+	 * @param {string|number} key 参数名
+	 * @param {boolean} exact 是否匹配匿名性
 	 * @complexity `n`
 	 */
-	removeArg(key, exact = false) {
+	removeArg(key, exact) {
 		Parser.run(() => {
 			for (const token of this.getArgs(key, exact, false)) {
 				this.removeChild(token);
@@ -333,10 +404,13 @@ class TranscludeToken extends Token {
 		});
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取所有参数名
+	 * @complexity `n`
+	 */
 	getKeys() {
 		const args = this.getAllArgs();
-		if (this.#keys.size === 0 && args.length) {
+		if (this.#keys.size === 0 && args.length > 0) {
 			for (const {name} of args) {
 				this.#keys.add(name);
 			}
@@ -345,7 +419,8 @@ class TranscludeToken extends Token {
 	}
 
 	/**
-	 * @param {string|number} key
+	 * 获取参数值
+	 * @param {string|number} key 参数名
 	 * @complexity `n`
 	 */
 	getValues(key) {
@@ -353,46 +428,53 @@ class TranscludeToken extends Token {
 	}
 
 	/**
+	 * 获取生效的参数值
 	 * @template {string|number|undefined} T
-	 * @param {T} key
+	 * @param {T} key 参数名
 	 * @returns {T extends undefined ? Object<string, string> : string}
 	 * @complexity `n`
 	 */
 	getValue(key) {
-		if (key !== undefined) {
-			return this.getArg(key)?.getValue();
-		}
-		return Object.fromEntries(this.getKeys().map(k => [k, this.getValue(k)]));
+		return key === undefined
+			? Object.fromEntries(this.getKeys().map(k => [k, this.getValue(k)]))
+			: this.getArg(key)?.getValue();
 	}
 
 	/**
-	 * @param {string} val
+	 * 插入匿名参数
+	 * @param {string} val 参数值
 	 * @returns {ParameterToken}
 	 * @complexity `n`
+	 * @throws `SyntaxError` 非法的匿名参数
 	 */
 	newAnonArg(val) {
 		val = String(val);
-		const templateLike = this.matches('template, magic-word#invoke'),
+		const templateLike = this.isTemplate(),
 			wikitext = `{{${templateLike ? ':T|' : 'lc:'}${val}}}`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches(templateLike ? 'template#T' : 'magic-word#lc')
-			|| firstElementChild.childNodes.length !== 2 || !firstElementChild.lastElementChild.anon
-		) {
-			throw new SyntaxError(`非法的匿名参数：${noWrap(val)}`);
+			{childNodes: {length}, firstChild: transclude} = root,
+			/** @type {Token & {lastChild: ParameterToken}} */
+			{type, name, childNodes: {length: transcludeLength}, lastChild} = transclude,
+			targetType = templateLike ? 'template' : 'magic-word',
+			targetName = templateLike ? 'T' : 'lc';
+		if (length === 1 && type === targetType && name === targetName && transcludeLength === 2 && lastChild.anon) {
+			return this.appendChild(lastChild);
 		}
-		return this.appendChild(firstElementChild.lastChild);
+		throw new SyntaxError(`非法的匿名参数：${noWrap(val)}`);
 	}
 
 	/**
-	 * @param {string} key
-	 * @param {string} value
+	 * 设置参数值
+	 * @param {string} key 参数名
+	 * @param {string} value 参数值
 	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 * @throws `SyntaxError` 非法的命名参数
 	 */
 	setValue(key, value) {
 		if (typeof key !== 'string') {
 			this.typeError('setValue', 'String');
-		} else if (!this.matches('template, magic-word#invoke')) {
+		} else if (!this.isTemplate()) {
 			throw new Error(`${this.constructor.name}.setValue 方法仅供模板使用！`);
 		}
 		const token = this.getArg(key);
@@ -403,27 +485,34 @@ class TranscludeToken extends Token {
 		}
 		const wikitext = `{{:T|${key}=${value}}}`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches('template#T')
-			|| firstElementChild.childNodes.length !== 2 || firstElementChild.lastElementChild.name !== key
-		) {
+			{childNodes: {length}, firstChild: template} = root,
+			{type, name, childNodes: {length: templateLength}, lastChild: parameter} = template;
+		if (length !== 1 || type !== 'template' || name !== 'T' || templateLength !== 2 || parameter.name !== key) {
 			throw new SyntaxError(`非法的命名参数：${key}=${noWrap(value)}`);
 		}
-		this.appendChild(firstElementChild.lastChild);
+		this.appendChild(parameter);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 将匿名参数改写为命名参数
+	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 */
 	anonToNamed() {
-		if (!this.matches('template, magic-word#invoke')) {
+		if (!this.isTemplate()) {
 			throw new Error(`${this.constructor.name}.anonToNamed 方法仅供模板使用！`);
 		}
 		for (const token of this.getAnonArgs()) {
-			token.anon = false;
-			token.firstElementChild.replaceChildren(token.name);
+			token.firstChild.replaceChildren(token.name);
 		}
 	}
 
-	/** @param {string} title */
+	/**
+	 * 替换模板名
+	 * @param {string} title 模板名
+	 * @throws `Error` 仅用于模板
+	 * @throws `SyntaxError` 非法的模板名称
+	 */
 	replaceTemplate(title) {
 		if (this.type === 'magic-word') {
 			throw new Error(`${this.constructor.name}.replaceTemplate 方法仅用于更换模板！`);
@@ -431,14 +520,19 @@ class TranscludeToken extends Token {
 			this.typeError('replaceTemplate', 'String');
 		}
 		const root = Parser.parse(`{{${title}}}`, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild?.type !== 'template' || firstElementChild.childNodes.length !== 1) {
+			{childNodes: {length}, firstChild: template} = root;
+		if (length !== 1 || template.type !== 'template' || template.childNodes.length !== 1) {
 			throw new SyntaxError(`非法的模板名称：${title}`);
 		}
-		this.firstElementChild.replaceChildren(...firstElementChild.firstElementChild.childNodes);
+		this.firstChild.replaceChildren(...template.firstChild.childNodes);
 	}
 
-	/** @param {string} title */
+	/**
+	 * 替换模块名
+	 * @param {string} title 模块名
+	 * @throws `Error` 仅用于模块
+	 * @throws `SyntaxError` 非法的模块名称
+	 */
 	replaceModule(title) {
 		if (this.type !== 'magic-word' || this.name !== 'invoke') {
 			throw new Error(`${this.constructor.name}.replaceModule 方法仅用于更换模块！`);
@@ -446,22 +540,25 @@ class TranscludeToken extends Token {
 			this.typeError('replaceModule', 'String');
 		}
 		const root = Parser.parse(`{{#invoke:${title}}}`, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches('magic-word#invoke')
-			|| firstElementChild.childNodes.length !== 2
-		) {
+			{childNodes: {length}, firstChild: invoke} = root,
+			{type, name, childNodes: {length: invokeLength}, lastChild} = invoke;
+		if (length !== 1 || type !== 'magic-word' || name !== 'invoke' || invokeLength !== 2) {
 			throw new SyntaxError(`非法的模块名称：${title}`);
 		} else if (this.childNodes.length > 1) {
-			this.children[1].replaceChildren(...firstElementChild.lastElementChild.childNodes);
+			this.childNodes[1].replaceChildren(...lastChild.childNodes);
 		} else {
-			const {lastChild} = firstElementChild;
-			root.destroy();
-			firstElementChild.destroy();
+			invoke.destroy(true);
 			this.appendChild(lastChild);
 		}
 	}
 
-	/** @param {string} func */
+	/**
+	 * 替换模块函数
+	 * @param {string} func 模块函数名
+	 * @throws `Error` 仅用于模块
+	 * @throws `Error` 尚未指定模块名称
+	 * @throws `SyntaxError` 非法的模块函数名
+	 */
 	replaceFunction(func) {
 		if (this.type !== 'magic-word' || this.name !== 'invoke') {
 			throw new Error(`${this.constructor.name}.replaceModule 方法仅用于更换模块！`);
@@ -473,48 +570,56 @@ class TranscludeToken extends Token {
 		const root = Parser.parse(
 				`{{#invoke:M|${func}}}`, this.getAttribute('include'), 2, this.getAttribute('config'),
 			),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches('magic-word#invoke')
-			|| firstElementChild.childNodes.length !== 3
-		) {
+			{childNodes: {length}, firstChild: invoke} = root,
+			{type, name, childNodes: {length: invokeLength}, lastChild} = invoke;
+		if (length !== 1 || type !== 'magic-word' || name !== 'invoke' || invokeLength !== 3) {
 			throw new SyntaxError(`非法的模块函数名：${func}`);
 		} else if (this.childNodes.length > 2) {
-			this.children[2].replaceChildren(...firstElementChild.lastElementChild.childNodes);
+			this.childNodes[2].replaceChildren(...lastChild.childNodes);
 		} else {
-			const {lastChild} = firstElementChild;
-			root.destroy();
-			firstElementChild.destroy();
+			invoke.destroy(true);
 			this.appendChild(lastChild);
 		}
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 是否存在重名参数
+	 * @complexity `n`
+	 * @throws `Error` 仅用于模板
+	 */
 	hasDuplicatedArgs() {
-		if (!this.matches('template, magic-word#invoke')) {
-			throw new Error(`${this.constructor.name}.hasDuplicatedArgs 方法仅供模板使用！`);
+		if (this.isTemplate()) {
+			return this.getAllArgs().length - this.getKeys().length;
 		}
-		return this.getAllArgs().length - this.getKeys().length;
+		throw new Error(`${this.constructor.name}.hasDuplicatedArgs 方法仅供模板使用！`);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取重名参数
+	 * @complexity `n`
+	 * @returns {[string, Set<ParameterToken>][]}
+	 * @throws `Error` 仅用于模板
+	 */
 	getDuplicatedArgs() {
-		if (!this.matches('template, magic-word#invoke')) {
-			throw new Error(`${this.constructor.name}.getDuplicatedArgs 方法仅供模板使用！`);
+		if (this.isTemplate()) {
+			return Object.entries(this.#args).filter(([, {size}]) => size > 1).map(([key, args]) => [key, new Set(args)]);
 		}
-		return Object.entries(this.#args).filter(([, {size}]) => size > 1).map(([key, args]) => [key, new Set(args)]);
+		throw new Error(`${this.constructor.name}.getDuplicatedArgs 方法仅供模板使用！`);
 	}
 
 	/**
+	 * 修复重名参数：
 	 * `aggressive = false`时只移除空参数和全同参数，优先保留匿名参数，否则将所有匿名参数更改为命名。
-	 * `aggressive = true`时还会尝试处理连续的以数字编号的参数
+	 * `aggressive = true`时还会尝试处理连续的以数字编号的参数。
+	 * @param {boolean} aggressive 是否使用有更大风险的修复手段
 	 * @complexity `n²`
 	 */
-	fixDuplication(aggressive = false) {
+	fixDuplication(aggressive) {
 		if (!this.hasDuplicatedArgs()) {
 			return [];
 		}
 		const /** @type {string[]} */ duplicatedKeys = [];
-		let anonCount = this.getAnonArgs().length;
+		let {length: anonCount} = this.getAnonArgs();
 		for (const [key, args] of this.getDuplicatedArgs()) {
 			if (args.size <= 1) {
 				continue;
@@ -553,10 +658,10 @@ class TranscludeToken extends Token {
 			let remaining = args.size - badArgs.length;
 			if (remaining === 1) {
 				continue;
-			} else if (aggressive && (anonCount ? /\D\d+$/ : /(?:^|\D)\d+$/).test(key)) {
+			} else if (aggressive && (anonCount ? /\D\d+$/u : /(?:^|\D)\d+$/u).test(key)) {
 				let /** @type {number} */ last;
-				const str = key.slice(0, -/(?<!\d)\d+$/.exec(key)[0].length),
-					regex = RegExp(`^${escapeRegExp(str)}\\d+$`),
+				const str = key.slice(0, -/(?<!\d)\d+$/u.exec(key)[0].length),
+					regex = new RegExp(`^${escapeRegExp(str)}\\d+$`, 'u'),
 					series = this.getAllArgs().filter(({name}) => regex.test(name)),
 					ordered = series.every(({name}, i) => {
 						const j = Number(name.slice(str.length)),
@@ -565,8 +670,9 @@ class TranscludeToken extends Token {
 						return cmp;
 					});
 				if (ordered) {
-					for (const [i, arg] of series.entries()) {
-						const name = `${str}${i + 1}`;
+					for (let i = 0; i < series.length; i++) {
+						const name = `${str}${i + 1}`,
+							arg = series[i];
 						if (arg.name !== name) {
 							if (arg.name === key) {
 								remaining--;
@@ -579,7 +685,7 @@ class TranscludeToken extends Token {
 			if (remaining > 1) {
 				Parser.error(`${this.type === 'template'
 					? this.name
-					: this.normalizeTitle(this.children[1]?.text() ?? '', 828).title
+					: this.normalizeTitle(this.childNodes[1]?.text() ?? '', 828).title
 				} 还留有 ${remaining} 个重复的 ${key} 参数：${[...this.getArgs(key)].map(arg => {
 					const {top, left} = arg.getBoundingClientRect();
 					return `第 ${top} 行第 ${left} 列`;
@@ -592,25 +698,27 @@ class TranscludeToken extends Token {
 	}
 
 	/**
+	 * 转义模板内的表格
 	 * @returns {TranscludeToken}
 	 * @complexity `n`
+	 * @throws `Error` 转义失败
 	 */
 	escapeTables() {
 		const count = this.hasDuplicatedArgs();
-		if (!/\n[^\S\n]*(?::+\s*)?\{\|[^\n]*\n\s*(?:\S[^\n]*\n\s*)*\|\}/.test(this.text()) || !count) {
+		if (!/\n[^\S\n]*(?::+\s*)?\{\|[^\n]*\n\s*(?:\S[^\n]*\n\s*)*\|\}/u.test(this.text()) || !count) {
 			return this;
 		}
-		const stripped = this.toString().slice(2, -2),
+		const stripped = String(this).slice(2, -2),
 			include = this.getAttribute('include'),
 			config = this.getAttribute('config'),
-			parsed = Parser.parse(stripped, include, 4, config),
-			TableToken = require('./table');
-		for (const table of parsed.children) {
+			parsed = Parser.parse(stripped, include, 4, config);
+		const TableToken = require('./table');
+		for (const table of parsed.childNodes) {
 			if (table instanceof TableToken) {
 				table.escape();
 			}
 		}
-		const {firstChild, childNodes} = Parser.parse(`{{${parsed.toString()}}}`, include, 2, config);
+		const {firstChild, childNodes} = Parser.parse(`{{${String(parsed)}}}`, include, 2, config);
 		if (childNodes.length !== 1 || !(firstChild instanceof TranscludeToken)) {
 			throw new Error('转义表格失败！');
 		}