wikiparser-node 0.5.0 → 0.6.1

package/src/link/category.js

@@ -11,11 +11,6 @@ const Title = require('../../lib/title'),
 class CategoryToken extends LinkToken {
 	type = 'category';
 
-	setLangLink = undefined;
-	setFragment = undefined;
-	asSelfLink = undefined;
-	pipeTrick = undefined;
-
 	/** 分类排序关键字 */
 	get sortkey() {
 		return this.childNodes[1]?.text()?.replaceAll(
@@ -34,10 +29,11 @@ class CategoryToken extends LinkToken {
 	 * @param {string|undefined} text 排序关键字
 	 * @param {Title} title 分类页面标题对象
 	 * @param {accum} accum
+	 * @param {string} delimiter `|`
 	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
-		super(link, text, title, config, accum);
-		this.seal(['setFragment', 'asSelfLink', 'pipeTrick'], true);
+	constructor(link, text, title, config = Parser.getConfig(), accum = [], delimiter = '|') {
+		super(link, text, title, config, accum, delimiter);
+		this.seal(['selfLink', 'interwiki', 'setLangLink', 'setFragment', 'asSelfLink', 'pipeTrick'], true);
 	}
 
 	/**

package/src/link/file.js

@@ -17,12 +17,6 @@ class FileToken extends LinkToken {
 	/** @type {Set<string>} */ #keys = new Set();
 	/** @type {Record<string, Set<ImageParameterToken>>} */ #args = {};
 
-	setLangLink = undefined;
-	setFragment = undefined;
-	asSelfLink = undefined;
-	setLinkText = undefined;
-	pipeTrick = undefined;
-
 	/** 图片链接 */
 	get link() {
 		return this.getArg('link')?.link;
@@ -70,13 +64,17 @@ class FileToken extends LinkToken {
 	 * @param {string|undefined} text 图片参数
 	 * @param {Title} title 文件标题对象
 	 * @param {accum} accum
+	 * @param {string} delimiter `|`
 	 * @complexity `n`
 	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
-		super(link, undefined, title, config, accum);
+	constructor(link, text, title, config = Parser.getConfig(), accum = [], delimiter = '|') {
+		super(link, undefined, title, config, accum, delimiter);
 		this.setAttribute('acceptable', {AtomToken: 0, ImageParameterToken: '1:'});
 		this.append(...explode('-{', '}-', '|', text).map(part => new ImageParameterToken(part, config, accum)));
-		this.seal(['setLangLink', 'setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick'], true);
+		this.seal(
+			['selfLink', 'interwiki', 'setLangLink', 'setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick'],
+			true,
+		);
 	}
 
 	/**
@@ -86,12 +84,20 @@ class FileToken extends LinkToken {
 	lint(start = 0) {
 		const errors = super.lint(start),
 			frameArgs = this.getFrameArgs(),
+			horizAlignArgs = this.getHorizAlignArgs(),
+			vertAlignArgs = this.getVertAlignArgs(),
 			captions = this.getArgs('caption');
-		if (frameArgs.length > 1 || captions.size > 1) {
+		if (frameArgs.length > 1 || horizAlignArgs.length > 1 || vertAlignArgs.length > 1 || captions.size > 1) {
 			const rect = this.getRootNode().posFromIndex(start);
 			if (frameArgs.length > 1) {
 				errors.push(...frameArgs.map(arg => generateForChild(arg, rect, '重复或冲突的图片框架参数')));
 			}
+			if (horizAlignArgs.length > 1) {
+				errors.push(...horizAlignArgs.map(arg => generateForChild(arg, rect, '重复或冲突的图片水平对齐参数')));
+			}
+			if (vertAlignArgs.length > 1) {
+				errors.push(...vertAlignArgs.map(arg => generateForChild(arg, rect, '重复或冲突的图片垂直对齐参数')));
+			}
 			if (captions.size > 1) {
 				errors.push(...[...captions].map(arg => generateForChild(arg, rect, '重复的图片说明')));
 			}
@@ -100,40 +106,32 @@ class FileToken extends LinkToken {
 	}
 
 	/**
-	 * @override
-	 * @param {number} i 移除位置
-	 * @complexity `n`
+	 * 获取所有图片参数节点
+	 * @returns {ImageParameterToken[]}
 	 */
-	removeAt(i) {
-		const /** @type {ImageParameterToken} */ token = super.removeAt(i),
-			args = this.getArgs(token.name, false, false);
-		args.delete(token);
-		if (args.size === 0) {
-			this.#keys.delete(token.name);
-		}
-		return token;
+	getAllArgs() {
+		return this.childNodes.slice(1);
 	}
 
 	/**
-	 * @override
-	 * @param {ImageParameterToken} token 待插入的子节点
-	 * @param {number} i 插入位置
+	 * 获取指定图片参数
+	 * @param {string} key 参数名
+	 * @param {boolean} copy 是否返回备份
 	 * @complexity `n`
 	 */
-	insertAt(token, i = this.childNodes.length) {
-		if (!Parser.running) {
-			this.getArgs(token.name, false, false).add(token);
-			this.#keys.add(token.name);
+	getArgs(key, copy = true) {
+		if (typeof key !== 'string') {
+			this.typeError('getArgs', 'String');
 		}
-		return super.insertAt(token, i);
-	}
-
-	/**
-	 * 获取所有图片参数节点
-	 * @returns {ImageParameterToken[]}
-	 */
-	getAllArgs() {
-		return this.childNodes.slice(1);
+		copy ||= !Parser.debugging && externalUse('getArgs');
+		let args;
+		if (Object.hasOwn(this.#args, key)) {
+			args = this.#args[key];
+		} else {
+			args = new Set(this.getAllArgs().filter(({name}) => key === name));
+			this.#args[key] = args;
+		}
+		return copy ? new Set(args) : args;
 	}
 
 	/**
@@ -150,31 +148,31 @@ class FileToken extends LinkToken {
 	}
 
 	/**
-	 * 获取指定图片参数
-	 * @param {string} key 参数名
-	 * @param {boolean} copy 是否返回备份
+	 * 获取图片水平对齐参数节点
 	 * @complexity `n`
 	 */
-	getArgs(key, copy = true) {
-		if (typeof key !== 'string') {
-			this.typeError('getArgs', 'String');
-		}
-		copy ||= !Parser.debugging && externalUse('getArgs');
-		let args = this.#args[key];
-		if (!args) {
-			args = new Set(this.getAllArgs().filter(({name}) => key === name));
-			this.#args[key] = args;
+	getHorizAlignArgs() {
+		const args = this.getAllArgs()
+			.filter(({name}) => ['left', 'right', 'center', 'none'].includes(name));
+		if (args.length > 1) {
+			Parser.error(`图片 ${this.name} 带有 ${args.length} 个水平对齐参数，只有第 1 个 ${args[0].name} 会生效！`);
 		}
-		return copy ? new Set(args) : args;
+		return args;
 	}
 
 	/**
-	 * 是否具有指定图片参数
-	 * @param {string} key 参数名
+	 * 获取图片垂直对齐参数节点
 	 * @complexity `n`
 	 */
-	hasArg(key) {
-		return this.getArgs(key, false).size > 0;
+	getVertAlignArgs() {
+		const args = this.getAllArgs().filter(
+			({name}) => ['baseline', 'sub', 'super', 'top', 'text-top', 'middle', 'bottom', 'text-bottom']
+				.includes(name),
+		);
+		if (args.length > 1) {
+			Parser.error(`图片 ${this.name} 带有 ${args.length} 个垂直对齐架参数，只有第 1 个 ${args[0].name} 会生效！`);
+		}
+		return args;
 	}
 
 	/**
@@ -186,6 +184,15 @@ class FileToken extends LinkToken {
 		return [...this.getArgs(key, false)].sort((a, b) => a.compareDocumentPosition(b)).at(-1);
 	}
 
+	/**
+	 * 是否具有指定图片参数
+	 * @param {string} key 参数名
+	 * @complexity `n`
+	 */
+	hasArg(key) {
+		return this.getArgs(key, false).size > 0;
+	}
+
 	/**
 	 * 移除指定图片参数
 	 * @param {string} key 参数名
@@ -224,7 +231,7 @@ class FileToken extends LinkToken {
 	 * 获取生效的指定图片参数值
 	 * @template {string|undefined} T
 	 * @param {T} key 参数名
-	 * @returns {T extends undefined ? Object<string, string> : string|true}
+	 * @returns {T extends undefined ? Record<string, string> : string|true}
 	 * @complexity `n`
 	 */
 	getValue(key) {
@@ -267,17 +274,46 @@ class FileToken extends LinkToken {
 				this.typeError('setValue', 'Boolean');
 			}
 			const newArg = Parser.run(() => new ImageParameterToken(syntax, config));
-			this.appendChild(newArg);
+			this.insertAt(newArg);
 			return;
 		}
 		const wikitext = `[[File:F|${syntax ? syntax.replace('$1', value) : value}]]`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 6, config),
-			{childNodes: {length}, firstChild: file} = root,
-			{name, type, childNodes: {length: fileLength}, lastChild: imageParameter} = file;
+			{length, firstChild: file} = root,
+			{name, type, length: fileLength, lastChild: imageParameter} = file;
 		if (length !== 1 || type !== 'file' || name !== 'File:F' || fileLength !== 2 || imageParameter.name !== key) {
 			throw new SyntaxError(`非法的 ${key} 参数：${noWrap(value)}`);
 		}
-		this.appendChild(imageParameter);
+		this.insertAt(imageParameter);
+	}
+
+	/**
+	 * @override
+	 * @param {number} i 移除位置
+	 * @complexity `n`
+	 */
+	removeAt(i) {
+		const /** @type {ImageParameterToken} */ token = super.removeAt(i),
+			args = this.getArgs(token.name, false, false);
+		args.delete(token);
+		if (args.size === 0) {
+			this.#keys.delete(token.name);
+		}
+		return token;
+	}
+
+	/**
+	 * @override
+	 * @param {ImageParameterToken} token 待插入的子节点
+	 * @param {number} i 插入位置
+	 * @complexity `n`
+	 */
+	insertAt(token, i = this.childNodes.length) {
+		if (!Parser.running) {
+			this.getArgs(token.name, false, false).add(token);
+			this.#keys.add(token.name);
+		}
+		return super.insertAt(token, i);
 	}
 }
 

package/src/link/galleryImage.js

@@ -1,8 +1,9 @@
 'use strict';
 
-const Title = require('../../lib/title'),
+const {undo} = require('../../util/debug'),
+	{generateForSelf} = require('../../util/lint'),
+	Title = require('../../lib/title'),
 	Parser = require('../..'),
-	Token = require('..'),
 	FileToken = require('./file');
 
 /**
@@ -11,10 +12,7 @@ const Title = require('../../lib/title'),
  */
 class GalleryImageToken extends FileToken {
 	type = 'gallery-image';
-
-	size = undefined;
-	width = undefined;
-	height = undefined;
+	#invalid = false;
 
 	/**
 	 * @param {string} link 图片文件名
@@ -25,6 +23,7 @@ class GalleryImageToken extends FileToken {
 	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
 		let token;
 		if (text !== undefined) {
+			const Token = require('..');
 			token = new Token(text, config, true, accum);
 			token.type = 'temp';
 			for (let n = 1; n < Parser.MAX_STAGE; n++) {
@@ -32,10 +31,43 @@ class GalleryImageToken extends FileToken {
 			}
 			accum.splice(accum.indexOf(token), 1);
 		}
-		const newConfig = structuredClone(config);
-		newConfig.img = Object.fromEntries(Object.entries(config.img).filter(([, param]) => param !== 'width'));
-		super(link, token?.toString(), title, newConfig, accum);
-		this.seal(['size', 'width', 'height'], true);
+		super(link, token?.toString(), title, config, accum);
+		this.setAttribute('bracket', false);
+		if (!Object.values(config.img).includes('width')) {
+			this.seal(['size', 'width', 'height'], true);
+		}
+	}
+
+	/**
+	 * @override
+	 * @throws `Error` 非法的内链目标
+	 * @throws `Error` 不可更改命名空间
+	 */
+	afterBuild() {
+		const {
+			title: initTitle, interwiki: initInterwiki, ns: initNs,
+		} = this.normalizeTitle(String(this.firstChild), this.type === 'imagemap-image' ? 0 : 6, true);
+		this.setAttribute('name', initTitle);
+		this.#invalid = initInterwiki || initNs !== 6; // 只用于gallery-image的首次解析
+		const /** @type {AstListener} */ linkListener = (e, data) => {
+			const {prevTarget} = e;
+			if (prevTarget?.type === 'link-target') {
+				const name = String(prevTarget),
+					defaultNs = this.type === 'imagemap-image' ? 0 : 6,
+					{title, interwiki, ns, valid} = this.normalizeTitle(name, defaultNs, true);
+				if (!valid) {
+					undo(e, data);
+					throw new Error(`非法的图片文件名：${name}`);
+				} else if (interwiki || ns !== 6) {
+					undo(e, data);
+					throw new Error(`图片链接不可更改命名空间：${name}`);
+				}
+				this.setAttribute('name', title);
+				this.#invalid = false;
+			}
+		};
+		this.addEventListener(['remove', 'insert', 'replace', 'text'], linkListener);
+		return this;
 	}
 
 	/** @override */
@@ -43,6 +75,18 @@ class GalleryImageToken extends FileToken {
 		return 0;
 	}
 
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start);
+		if (this.#invalid) {
+			errors.push(generateForSelf(this, this.getRootNode().posFromIndex(start), '无效的图库图片'));
+		}
+		return errors;
+	}
+
 	/**
 	 * @override
 	 * @param {string} selector
@@ -55,6 +99,26 @@ class GalleryImageToken extends FileToken {
 	text() {
 		return super.text().replaceAll('\n', ' ');
 	}
+
+	/**
+	 * @override
+	 * @param {string} link 链接目标
+	 * @throws `SyntaxError` 非法的链接目标
+	 */
+	setTarget(link) {
+		link = String(link);
+		const include = this.getAttribute('include'),
+			config = this.getAttribute('config'),
+			root = Parser.parse(`<gallery>${link}</gallery>`, include, 1, config),
+			{length, firstChild: gallery} = root,
+			{type, lastChild: {length: galleryLength, firstChild: image}} = gallery;
+		if (length !== 1 || type !== 'ext' || galleryLength !== 1 || image.type !== 'gallery-image') {
+			throw new SyntaxError(`非法的图库文件名：${link}`);
+		}
+		const {firstChild} = image;
+		image.destroy(true);
+		this.firstChild.safeReplaceWith(firstChild);
+	}
 }
 
 Parser.classes.GalleryImageToken = __filename;

package/src/link/index.js

@@ -13,6 +13,8 @@ const Title = require('../../lib/title'),
  */
 class LinkToken extends Token {
 	type = 'link';
+	#bracket = true;
+	#delimiter;
 
 	/** 完整链接，和FileToken保持一致 */
 	get link() {
@@ -75,37 +77,21 @@ class LinkToken extends Token {
 	 * @param {string|undefined} linkText 链接显示文字
 	 * @param {Title} title 链接标题对象
 	 * @param {accum} accum
+	 * @param {string} delimiter `|`
 	 */
-	constructor(link, linkText, title, config = Parser.getConfig(), accum = []) {
+	constructor(link, linkText, title, config = Parser.getConfig(), accum = [], delimiter = '|') {
 		super(undefined, config, true, accum, {AtomToken: 0, Token: 1});
 		const AtomToken = require('../atom');
-		this.appendChild(new AtomToken(link, 'link-target', config, accum, {
+		this.insertAt(new AtomToken(link, 'link-target', config, accum, {
 			'Stage-2': ':', '!ExtToken': '', '!HeadingToken': '',
 		}));
 		if (linkText !== undefined) {
 			const inner = new Token(linkText, config, true, accum, {'Stage-5': ':', ConverterToken: ':'});
 			inner.type = 'link-text';
-			this.appendChild(inner.setAttribute('stage', Parser.MAX_STAGE - 1));
+			this.insertAt(inner.setAttribute('stage', Parser.MAX_STAGE - 1));
 		}
-		this.setAttribute('name', title.title).getAttribute('protectChildren')(0);
-	}
-
-	/** 生成Title对象 */
-	#getTitle() {
-		return this.normalizeTitle(this.firstChild.text());
-	}
-
-	/** @override */
-	cloneNode() {
-		const [link, ...linkText] = this.cloneChildNodes();
-		return Parser.run(() => {
-			/** @type {this & {constructor: typeof LinkToken}} */
-			const {constructor} = this,
-				token = new constructor('', undefined, this.#getTitle(), this.getAttribute('config'));
-			token.firstChild.safeReplaceWith(link);
-			token.append(...linkText);
-			return token.afterBuild();
-		});
+		this.#delimiter = delimiter;
+		this.getAttribute('protectChildren')(0);
 	}
 
 	/**
@@ -114,6 +100,10 @@ class LinkToken extends Token {
 	 * @throws `Error` 不可更改命名空间
 	 */
 	afterBuild() {
+		this.setAttribute('name', this.normalizeTitle(this.firstChild.text()).title);
+		if (this.#delimiter?.includes('\0')) {
+			this.#delimiter = this.getAttribute('buildFromStr')(this.#delimiter).map(String).join('');
+		}
 		const /** @type {AstListener} */ linkListener = (e, data) => {
 			const {prevTarget} = e;
 			if (prevTarget?.type === 'link-target') {
@@ -142,13 +132,27 @@ class LinkToken extends Token {
 		return this;
 	}
 
+	/**
+	 * @override
+	 * @template {string} T
+	 * @param {T} key 属性键
+	 * @param {TokenAttribute<T>} value 属性值
+	 */
+	setAttribute(key, value) {
+		if (key === 'bracket') {
+			this.#bracket = Boolean(value);
+			return this;
+		}
+		return super.setAttribute(key, value);
+	}
+
 	/**
 	 * @override
 	 * @param {string} selector
 	 */
 	toString(selector) {
-		const str = super.toString(selector, '|');
-		return this.type === 'gallery-image' || selector && this.matches(selector) ? str : `[[${str}]]`;
+		const str = super.toString(selector, this.#delimiter);
+		return this.#bracket && !(selector && this.matches(selector)) ? `[[${str}]]` : str;
 	}
 
 	/** @override */
@@ -158,18 +162,37 @@ class LinkToken extends Token {
 
 	/** @override */
 	getGaps() {
-		return 1;
+		return this.#delimiter.length;
 	}
 
 	/** @override */
 	print() {
-		return super.print(this.type === 'gallery-image' ? {sep: '|'} : {pre: '[[', post: ']]', sep: '|'});
+		return super.print(this.#bracket ? {pre: '[[', post: ']]', sep: this.#delimiter} : {sep: this.#delimiter});
+	}
+
+	/** 生成Title对象 */
+	#getTitle() {
+		return this.normalizeTitle(this.firstChild.text());
+	}
+
+	/**
+	 * @override
+	 * @this {LinkToken & {constructor: typeof LinkToken}}
+	 */
+	cloneNode() {
+		const [link, ...linkText] = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new this.constructor('', undefined, this.#getTitle(), this.getAttribute('config'));
+			token.firstChild.safeReplaceWith(link);
+			token.append(...linkText);
+			return token.afterBuild();
+		});
 	}
 
 	/** @override */
 	text() {
 		const str = super.text('|');
-		return this.type === 'gallery-image' ? str : `[[${str}]]`;
+		return this.#bracket ? `[[${str}]]` : str;
 	}
 
 	/**
@@ -183,10 +206,10 @@ class LinkToken extends Token {
 			link = `:${link}`;
 		}
 		const root = Parser.parse(`[[${link}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: wikiLink} = root,
-			{type, firstChild, childNodes: {length: linkLength}} = wikiLink;
+			{length, firstChild: wikiLink} = root,
+			{type, firstChild, length: linkLength} = wikiLink;
 		if (length !== 1 || type !== this.type || linkLength !== 1) {
-			const msgs = {link: '内链', file: '文件链接', category: '分类', 'gallery-image': '文件链接'};
+			const msgs = {link: '内链', file: '文件链接', category: '分类'};
 			throw new SyntaxError(`非法的${msgs[this.type]}目标：${link}`);
 		}
 		wikiLink.destroy(true);
@@ -206,13 +229,13 @@ class LinkToken extends Token {
 		link = String(link).trim();
 		const [char] = link;
 		if (char === '#') {
-			throw new SyntaxError(`跨语言链接不能仅为fragment！`);
+			throw new SyntaxError('跨语言链接不能仅为fragment！');
 		} else if (char === ':') {
 			link = link.slice(1);
 		}
 		const root = Parser.parse(`[[${lang}:${link}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
-			/** @type {Token & {firstChild: LinkToken}} */ {childNodes: {length}, firstChild: wikiLink} = root,
-			{type, childNodes: {length: linkLength}, interwiki, firstChild} = wikiLink;
+			/** @type {Token & {firstChild: LinkToken}} */ {length, firstChild: wikiLink} = root,
+			{type, length: linkLength, interwiki, firstChild} = wikiLink;
 		if (length !== 1 || type !== 'link' || linkLength !== 1 || interwiki !== lang.toLowerCase()) {
 			throw new SyntaxError(`非法的跨语言链接目标：${lang}:${link}`);
 		}
@@ -231,12 +254,11 @@ class LinkToken extends Token {
 		const include = this.getAttribute('include'),
 			config = this.getAttribute('config'),
 			root = Parser.parse(`[[${page ? `:${this.name}` : ''}#${fragment}]]`, include, 6, config),
-			{childNodes: {length}, firstChild: wikiLink} = root,
-			{type, childNodes: {length: linkLength}, firstChild} = wikiLink;
+			{length, firstChild: wikiLink} = root,
+			{type, length: linkLength, firstChild} = wikiLink;
 		if (length !== 1 || type !== 'link' || linkLength !== 1) {
 			throw new SyntaxError(`非法的 fragment：${fragment}`);
-		}
-		if (page) {
+		} else if (page) {
 			Parser.warn(`${this.constructor.name}.setFragment 方法会同时规范化页面名！`);
 		}
 		wikiLink.destroy(true);
@@ -277,7 +299,7 @@ class LinkToken extends Token {
 			const root = Parser.parse(`[[${
 					this.type === 'category' ? 'Category:' : ''
 				}L|${linkText}]]`, this.getAttribute('include'), 6, config),
-				{childNodes: {length}, firstChild: wikiLink} = root;
+				{length, firstChild: wikiLink} = root;
 			if (length !== 1 || wikiLink.type !== this.type || wikiLink.childNodes.length !== 2) {
 				throw new SyntaxError(`非法的${this.type === 'link' ? '内链文字' : '分类关键字'}：${noWrap(linkText)}`);
 			}
@@ -287,7 +309,7 @@ class LinkToken extends Token {
 			lastChild.setAttribute('stage', 7).type = 'link-text';
 		}
 		if (this.childNodes.length === 1) {
-			this.appendChild(lastChild);
+			this.insertAt(lastChild);
 		} else {
 			this.lastChild.safeReplaceWith(lastChild);
 		}

package/src/magicLink.js

@@ -2,7 +2,6 @@
 
 const {generateForChild} = require('../util/lint'),
 	Parser = require('..'),
-	AstText = require('../lib/text'),
 	Token = require('.');
 
 /**
@@ -21,11 +20,14 @@ class MagicLinkToken extends Token {
 	set protocol(value) {
 		if (typeof value !== 'string') {
 			this.typeError('protocol', 'String');
-		}
-		if (!new RegExp(`${this.#protocolRegex.source}$`, 'iu').test(value)) {
+		} else if (!new RegExp(`${this.#protocolRegex.source}$`, 'iu').test(value)) {
 			throw new RangeError(`非法的外链协议：${value}`);
 		}
-		this.replaceChildren(this.text().replace(this.#protocolRegex, value));
+		const {link} = this;
+		if (!this.#protocolRegex.test(link)) {
+			throw new Error(`特殊外链无法更改协议！${link}`);
+		}
+		this.replaceChildren(link.replace(this.#protocolRegex, value));
 	}
 
 	/** 和内链保持一致 */
@@ -76,25 +78,15 @@ class MagicLinkToken extends Token {
 		return errors;
 	}
 
-	/** @override */
-	afterBuild() {
-		const ParameterToken = require('./parameter');
-		const /** @type {ParameterToken} */ parameter = this.closest('parameter');
-		if (parameter?.getValue() === this.text()) {
-			this.replaceWith(...this.childNodes);
-		}
-		return this;
-	}
-
 	/** @override */
 	cloneNode() {
-		const cloned = this.cloneChildNodes(),
-			token = Parser.run(() => new MagicLinkToken(
-				undefined, this.type === 'ext-link-url', this.getAttribute('config'),
-			));
-		token.append(...cloned);
-		token.afterBuild();
-		return token;
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new MagicLinkToken(undefined, this.type === 'ext-link-url', this.getAttribute('config'));
+			token.append(...cloned);
+			token.afterBuild();
+			return token;
+		});
 	}
 
 	/**
@@ -124,12 +116,19 @@ class MagicLinkToken extends Token {
 	setTarget(url) {
 		url = String(url);
 		const root = Parser.parse(url, this.getAttribute('include'), 9, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: freeExtLink} = root;
+			{length, firstChild: freeExtLink} = root;
 		if (length !== 1 || freeExtLink.type !== 'free-ext-link') {
 			throw new SyntaxError(`非法的自由外链目标：${url}`);
 		}
 		this.replaceChildren(...freeExtLink.childNodes);
 	}
+
+	/** 是否是模板或魔术字参数 */
+	isParamValue() {
+		const ParameterToken = require('./parameter');
+		const /** @type {ParameterToken} */ parameter = this.closest('parameter');
+		return parameter?.getValue() === this.text();
+	}
 }
 
 Parser.classes.MagicLinkToken = __filename;