wikiparser-node 0.5.0 → 0.6.1

package/src/transclude.js

@@ -14,8 +14,13 @@ const {removeComment, escapeRegExp, text, noWrap, print} = require('../util/stri
 class TranscludeToken extends Token {
 	type = 'template';
 	modifier = '';
-	/** @type {Set<string>} */ #keys = new Set();
 	/** @type {Record<string, Set<ParameterToken>>} */ #args = {};
+	/** @type {Set<string>} */ #keys = new Set();
+
+	/** 是否存在重复参数 */
+	get duplication() {
+		return this.isTemplate() && Boolean(this.hasDuplicatedArgs());
+	}
 
 	/**
 	 * 设置引用修饰符
@@ -69,7 +74,7 @@ class TranscludeToken extends Token {
 					token = new SyntaxToken(magicWord, pattern, 'magic-word-name', config, accum, {
 						'Stage-1': ':', '!ExtToken': '',
 					});
-				this.appendChild(token);
+				this.insertAt(token);
 				if (arg.length > 0) {
 					parts.unshift([arg.join(':')]);
 				}
@@ -83,7 +88,7 @@ class TranscludeToken extends Token {
 						const invoke = new AtomToken(part.join('='), `invoke-${
 							i ? 'function' : 'module'
 						}`, config, accum, {'Stage-1': ':', '!ExtToken': ''});
-						this.appendChild(invoke);
+						this.insertAt(invoke);
 					}
 					this.getAttribute('protectChildren')('1:3');
 				}
@@ -95,9 +100,8 @@ class TranscludeToken extends Token {
 				accum.pop();
 				throw new SyntaxError(`非法的模板名称：${name}`);
 			}
-			this.setAttribute('name', this.normalizeTitle(name, 10, true).title);
 			const token = new AtomToken(title, 'template-name', config, accum, {'Stage-2': ':', '!HeadingToken': ''});
-			this.appendChild(token);
+			this.insertAt(token);
 		}
 		const templateLike = this.isTemplate();
 		let i = 1;
@@ -110,85 +114,11 @@ class TranscludeToken extends Token {
 				part.unshift(i);
 				i++;
 			}
-			this.appendChild(new ParameterToken(...part, config, accum));
+			this.insertAt(new ParameterToken(...part, config, accum));
 		}
 		this.getAttribute('protectChildren')(0);
 	}
 
-	/** @override */
-	cloneNode() {
-		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.firstChild.safeReplaceWith(first);
-			token.afterBuild();
-			token.append(...cloned);
-			return token;
-		});
-	}
-
-	/** @override */
-	afterBuild() {
-		if (this.name.includes('\0')) {
-			this.setAttribute('name', text(this.getAttribute('buildFromStr')(this.name)));
-		}
-		if (this.isTemplate()) {
-			/**
-			 * 当事件bubble到`parameter`时，将`oldKey`和`newKey`保存进AstEventData。
-			 * 当继续bubble到`template`时，处理并删除`oldKey`和`newKey`。
-			 * @type {AstListener}
-			 */
-			const transcludeListener = (e, data) => {
-				const {prevTarget} = e,
-					{oldKey, newKey} = data ?? {};
-				if (typeof oldKey === 'string') {
-					delete data.oldKey;
-					delete data.newKey;
-				}
-				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 = this.getArgs(oldKey, false, false);
-					oldArgs.delete(prevTarget);
-					this.getArgs(newKey, false, false).add(prevTarget);
-					this.#keys.add(newKey);
-					if (oldArgs.size === 0) {
-						this.#keys.delete(oldKey);
-					}
-				}
-			};
-			this.addEventListener(['remove', 'insert', 'replace', 'text'], transcludeListener);
-		}
-		return this;
-	}
-
-	/** 替换引用 */
-	subst() {
-		this.setModifier('subst');
-	}
-
-	/** 安全的替换引用 */
-	safesubst() {
-		this.setModifier('safesubst');
-	}
-
-	/**
-	 * @override
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @returns {TokenAttribute<T>}
-	 */
-	getAttribute(key) {
-		if (key === 'args') {
-			return {...this.#args};
-		} else if (key === 'keys') {
-			return !Parser.debugging && externalUse('getAttribute') ? new Set(this.#keys) : this.#keys;
-		}
-		return super.getAttribute(key);
-	}
-
 	/**
 	 * @override
 	 * @param {string} selector
@@ -249,20 +179,6 @@ class TranscludeToken extends Token {
 		return this.type === 'template' || this.type === 'magic-word' && this.name === 'invoke';
 	}
 
-	/**
-	 * @override
-	 * @returns {string}
-	 * @complexity `n`
-	 */
-	text() {
-		const {childNodes, firstChild, modifier} = this;
-		return `{{${modifier}${modifier && ':'}${
-			this.type === 'magic-word'
-				? `${firstChild.text()}${childNodes.length > 1 ? ':' : ''}${text(childNodes.slice(1), '|')}`
-				: super.text('|')
-		}}}`;
-	}
-
 	/**
 	 * 处理匿名参数更改
 	 * @param {number|ParameterToken} addedToken 新增的参数
@@ -291,25 +207,6 @@ class TranscludeToken extends Token {
 		}
 	}
 
-	/**
-	 * @override
-	 * @param {number} i 移除位置
-	 * @complexity `n`
-	 */
-	removeAt(i) {
-		const /** @type {ParameterToken} */ token = super.removeAt(i);
-		if (token.anon) {
-			this.#handleAnonArgChange(Number(token.name));
-		} else {
-			const args = this.getArgs(token.name, false, false);
-			args.delete(token);
-			if (args.size === 0) {
-				this.#keys.delete(token.name);
-			}
-		}
-		return token;
-	}
-
 	/**
 	 * @override
 	 * @param {ParameterToken} token 待插入的子节点
@@ -357,8 +254,10 @@ class TranscludeToken extends Token {
 		}
 		copy ||= !Parser.debugging && externalUse('getArgs');
 		const keyStr = String(key).trim();
-		let args = this.#args[keyStr];
-		if (!args) {
+		let args;
+		if (Object.hasOwn(this.#args, keyStr)) {
+			args = this.#args[keyStr];
+		} else {
 			args = new Set(this.getAllArgs().filter(({name}) => keyStr === name));
 			this.#args[keyStr] = args;
 		}
@@ -370,6 +269,135 @@ class TranscludeToken extends Token {
 		return args;
 	}
 
+	/**
+	 * 获取重名参数
+	 * @complexity `n`
+	 * @returns {[string, Set<ParameterToken>][]}
+	 * @throws `Error` 仅用于模板
+	 */
+	getDuplicatedArgs() {
+		if (this.isTemplate()) {
+			return Object.entries(this.#args).filter(([, {size}]) => size > 1)
+				.map(([key, args]) => [key, new Set(args)]);
+		}
+		throw new Error(`${this.constructor.name}.getDuplicatedArgs 方法仅供模板使用！`);
+	}
+
+	/** @override */
+	cloneNode() {
+		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.firstChild.safeReplaceWith(first);
+			token.afterBuild();
+			token.append(...cloned);
+			return token;
+		});
+	}
+
+	/** @override */
+	afterBuild() {
+		if (this.type === 'template') {
+			this.setAttribute('name', this.normalizeTitle(this.firstChild.text(), 10).title);
+		}
+		if (this.isTemplate()) {
+			/**
+			 * 当事件bubble到`parameter`时，将`oldKey`和`newKey`保存进AstEventData。
+			 * 当继续bubble到`template`时，处理并删除`oldKey`和`newKey`。
+			 * @type {AstListener}
+			 */
+			const transcludeListener = (e, data) => {
+				const {prevTarget} = e,
+					{oldKey, newKey} = data ?? {};
+				if (typeof oldKey === 'string') {
+					delete data.oldKey;
+					delete data.newKey;
+				}
+				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 = this.getArgs(oldKey, false, false);
+					oldArgs.delete(prevTarget);
+					this.getArgs(newKey, false, false).add(prevTarget);
+					this.#keys.add(newKey);
+					if (oldArgs.size === 0) {
+						this.#keys.delete(oldKey);
+					}
+				}
+			};
+			this.addEventListener(['remove', 'insert', 'replace', 'text'], transcludeListener);
+		}
+		return this;
+	}
+
+	/** 替换引用 */
+	subst() {
+		this.setModifier('subst');
+	}
+
+	/** 安全的替换引用 */
+	safesubst() {
+		this.setModifier('safesubst');
+	}
+
+	/**
+	 * @override
+	 * @param {PropertyKey} key 属性键
+	 */
+	hasAttribute(key) {
+		return key === 'keys' || super.hasAttribute(key);
+	}
+
+	/**
+	 * @override
+	 * @template {string} T
+	 * @param {T} key 属性键
+	 * @returns {TokenAttribute<T>}
+	 */
+	getAttribute(key) {
+		if (key === 'args') {
+			return {...this.#args};
+		} else if (key === 'keys') {
+			return !Parser.debugging && externalUse('getAttribute') ? new Set(this.#keys) : this.#keys;
+		}
+		return super.getAttribute(key);
+	}
+
+	/**
+	 * @override
+	 * @returns {string}
+	 * @complexity `n`
+	 */
+	text() {
+		const {childNodes, firstChild, modifier} = this;
+		return `{{${modifier}${modifier && ':'}${
+			this.type === 'magic-word'
+				? `${firstChild.text()}${childNodes.length > 1 ? ':' : ''}${text(childNodes.slice(1), '|')}`
+				: super.text('|')
+		}}}`;
+	}
+
+	/**
+	 * @override
+	 * @param {number} i 移除位置
+	 * @complexity `n`
+	 */
+	removeAt(i) {
+		const /** @type {ParameterToken} */ token = super.removeAt(i);
+		if (token.anon) {
+			this.#handleAnonArgChange(Number(token.name));
+		} else {
+			const args = this.getArgs(token.name, false, false);
+			args.delete(token);
+			if (args.size === 0) {
+				this.#keys.delete(token.name);
+			}
+		}
+		return token;
+	}
+
 	/**
 	 * 是否具有某参数
 	 * @param {string|number} key 参数名
@@ -431,7 +459,7 @@ class TranscludeToken extends Token {
 	 * 获取生效的参数值
 	 * @template {string|number|undefined} T
 	 * @param {T} key 参数名
-	 * @returns {T extends undefined ? Object<string, string> : string}
+	 * @returns {T extends undefined ? Record<string, string> : string}
 	 * @complexity `n`
 	 */
 	getValue(key) {
@@ -452,13 +480,13 @@ class TranscludeToken extends Token {
 		const templateLike = this.isTemplate(),
 			wikitext = `{{${templateLike ? ':T|' : 'lc:'}${val}}}`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: transclude} = root,
+			{length, firstChild: transclude} = root,
 			/** @type {Token & {lastChild: ParameterToken}} */
-			{type, name, childNodes: {length: transcludeLength}, lastChild} = transclude,
+			{type, name, 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.insertAt(lastChild);
 		}
 		throw new SyntaxError(`非法的匿名参数：${noWrap(val)}`);
 	}
@@ -485,12 +513,12 @@ class TranscludeToken extends Token {
 		}
 		const wikitext = `{{:T|${key}=${value}}}`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: template} = root,
-			{type, name, childNodes: {length: templateLength}, lastChild: parameter} = template;
+			{length, firstChild: template} = root,
+			{type, name, 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(parameter);
+		this.insertAt(parameter);
 	}
 
 	/**
@@ -520,7 +548,7 @@ class TranscludeToken extends Token {
 			this.typeError('replaceTemplate', 'String');
 		}
 		const root = Parser.parse(`{{${title}}}`, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: template} = root;
+			{length, firstChild: template} = root;
 		if (length !== 1 || template.type !== 'template' || template.childNodes.length !== 1) {
 			throw new SyntaxError(`非法的模板名称：${title}`);
 		}
@@ -540,15 +568,15 @@ class TranscludeToken extends Token {
 			this.typeError('replaceModule', 'String');
 		}
 		const root = Parser.parse(`{{#invoke:${title}}}`, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: invoke} = root,
-			{type, name, childNodes: {length: invokeLength}, lastChild} = invoke;
+			{length, firstChild: invoke} = root,
+			{type, name, 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.childNodes[1].replaceChildren(...lastChild.childNodes);
 		} else {
 			invoke.destroy(true);
-			this.appendChild(lastChild);
+			this.insertAt(lastChild);
 		}
 	}
 
@@ -570,15 +598,15 @@ class TranscludeToken extends Token {
 		const root = Parser.parse(
 				`{{#invoke:M|${func}}}`, this.getAttribute('include'), 2, this.getAttribute('config'),
 			),
-			{childNodes: {length}, firstChild: invoke} = root,
-			{type, name, childNodes: {length: invokeLength}, lastChild} = invoke;
+			{length, firstChild: invoke} = root,
+			{type, name, 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.childNodes[2].replaceChildren(...lastChild.childNodes);
 		} else {
 			invoke.destroy(true);
-			this.appendChild(lastChild);
+			this.insertAt(lastChild);
 		}
 	}
 
@@ -594,19 +622,6 @@ class TranscludeToken extends Token {
 		throw new Error(`${this.constructor.name}.hasDuplicatedArgs 方法仅供模板使用！`);
 	}
 
-	/**
-	 * 获取重名参数
-	 * @complexity `n`
-	 * @returns {[string, Set<ParameterToken>][]}
-	 * @throws `Error` 仅用于模板
-	 */
-	getDuplicatedArgs() {
-		if (this.isTemplate()) {
-			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`时只移除空参数和全同参数，优先保留匿名参数，否则将所有匿名参数更改为命名。
@@ -627,7 +642,7 @@ class TranscludeToken extends Token {
 			const /** @type {Record<string, ParameterToken[]>} */ values = {};
 			for (const arg of args) {
 				const val = arg.getValue().trim();
-				if (val in values) {
+				if (Object.hasOwn(values, val)) {
 					values[val].push(arg);
 				} else {
 					values[val] = [arg];