wikiparser-node 0.4.0 → 0.5.0

package/src/converterRule.js

@@ -15,7 +15,7 @@ class ConverterRuleToken extends Token {
 
 	/** 语言变体 */
 	get variant() {
-		return this.children.at(-2)?.text()?.trim() ?? '';
+		return this.childNodes.at(-2)?.text()?.trim() ?? '';
 	}
 
 	set variant(variant) {
@@ -72,7 +72,7 @@ class ConverterRuleToken extends Token {
 			placeholder = placeholders[cloned.length - 1],
 			token = Parser.run(() => new ConverterRuleToken(placeholder, placeholder, this.getAttribute('config')));
 		for (let i = 0; i < cloned.length; i++) {
-			token.children[i].safeReplaceWith(cloned[i]);
+			token.childNodes[i].safeReplaceWith(cloned[i]);
 		}
 		token.afterBuild();
 		return token;
@@ -128,7 +128,7 @@ class ConverterRuleToken extends Token {
 	 */
 	toString(selector) {
 		if (this.childNodes.length === 3 && !(selector && this.matches(selector))) {
-			const {children: [from, variant, to]} = this;
+			const {childNodes: [from, variant, to]} = this;
 			return `${from.toString(selector)}=>${variant.toString(selector)}:${to.toString(selector)}`;
 		}
 		return super.toString(selector, ':');
@@ -144,13 +144,22 @@ class ConverterRuleToken extends Token {
 		return i === 0 && length === 3 ? 2 : 1;
 	}
 
+	/** @override */
+	print() {
+		if (this.childNodes.length === 3) {
+			const {childNodes: [from, variant, to]} = this;
+			return `<span class="wpb-converter-rule">${from.print()}=>${variant.print()}:${to.print()}</span>`;
+		}
+		return super.print({sep: ':'});
+	}
+
 	/**
 	 * @override
 	 * @returns {string}
 	 */
 	text() {
 		if (this.childNodes.length === 3) {
-			const {children: [from, variant, to]} = this;
+			const {childNodes: [from, variant, to]} = this;
 			return `${from.text()}=>${variant.text()}:${to.text()}`;
 		}
 		return super.text(':');
@@ -174,16 +183,14 @@ class ConverterRuleToken extends Token {
 		to = String(to);
 		const config = this.getAttribute('config'),
 			root = Parser.parse(`-{|${config.variants[0]}:${to}}-`, this.getAttribute('include'), undefined, config),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild.type !== 'converter' || firstElementChild.childNodes.length !== 2
-			|| firstElementChild.lastElementChild.childNodes.length !== 2
-		) {
+			{childNodes: {length}, firstChild: converter} = root,
+			{lastChild: converterRule, type, childNodes: {length: converterLength}} = converter;
+		if (length !== 1 || type !== 'converter' || converterLength !== 2 || converterRule.childNodes.length !== 2) {
 			throw new SyntaxError(`非法的转换目标：${noWrap(to)}`);
 		}
-		const {lastElementChild} = firstElementChild,
-			{lastChild} = lastElementChild;
-		lastElementChild.destroy(true);
-		this.lastElementChild.safeReplaceWith(lastChild);
+		const {lastChild} = converterRule;
+		converterRule.destroy(true);
+		this.lastChild.safeReplaceWith(lastChild);
 	}
 
 	/**
@@ -202,7 +209,7 @@ class ConverterRuleToken extends Token {
 		} else if (this.childNodes.length === 1) {
 			super.insertAt(Parser.run(() => new AtomToken(variant, 'converter-rule-variant', config)), 0);
 		} else {
-			this.children.at(-2).setText(variant);
+			this.childNodes.at(-2).setText(variant);
 		}
 	}
 
@@ -220,16 +227,15 @@ class ConverterRuleToken extends Token {
 		from = String(from);
 		const config = this.getAttribute('config'),
 			root = Parser.parse(`-{|${from}=>${variant}:}-`, this.getAttribute('include'), undefined, config),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild.type !== 'converter' || firstElementChild.childNodes.length !== 2
-			|| firstElementChild.lastElementChild.childNodes.length !== 3
-		) {
+			{childNodes: {length}, firstChild: converter} = root,
+			{type, childNodes: {length: converterLength}, lastChild: converterRule} = converter;
+		if (length !== 1 || type !== 'converter' || converterLength !== 2 || converterRule.childNodes.length !== 3) {
 			throw new SyntaxError(`非法的转换原文：${noWrap(from)}`);
 		}
 		if (unidirectional) {
-			this.firstElementChild.safeReplaceWith(firstElementChild.lastElementChild.firstChild);
+			this.firstChild.safeReplaceWith(converterRule.firstChild);
 		} else {
-			super.insertAt(firstElementChild.lastElementChild.firstChild, 0);
+			super.insertAt(converterRule.firstChild, 0);
 		}
 	}
 

package/src/extLink.js

@@ -41,7 +41,7 @@ class ExtLinkToken extends Token {
 	/** 链接显示文字 */
 	get innerText() {
 		return this.childNodes.length > 1
-			? this.lastElementChild.text()
+			? this.lastChild.text()
 			: `[${this.getRootNode().querySelectorAll('ext-link[childElementCount=1]').indexOf(this) + 1}]`;
 	}
 
@@ -67,7 +67,7 @@ class ExtLinkToken extends Token {
 	cloneNode() {
 		const [url, text] = this.cloneChildNodes(),
 			token = Parser.run(() => new ExtLinkToken(undefined, '', '', this.getAttribute('config')));
-		token.firstElementChild.safeReplaceWith(url);
+		token.firstChild.safeReplaceWith(url);
 		if (text) {
 			token.appendChild(text);
 		}
@@ -78,7 +78,7 @@ class ExtLinkToken extends Token {
 	#correct() {
 		if (!this.#space && this.childNodes.length > 1
 			// 都替换成`<`肯定不对，但无妨
-			&& /^[^[\]<>"{\0-\x1F\x7F\p{Zs}\uFFFD]/u.test(this.lastElementChild.text().replace(/&[lg]t;/u, '<'))
+			&& /^[^[\]<>"{\0-\x1F\x7F\p{Zs}\uFFFD]/u.test(this.lastChild.text().replace(/&[lg]t;/u, '<'))
 		) {
 			this.#space = ' ';
 		}
@@ -95,7 +95,7 @@ class ExtLinkToken extends Token {
 			return `[${super.toString(selector)}${this.#space}]`;
 		}
 		this.#correct();
-		normalizeSpace(this.lastElementChild);
+		normalizeSpace(this.lastChild);
 		return `[${super.toString(selector, this.#space)}]`;
 	}
 
@@ -110,9 +110,15 @@ class ExtLinkToken extends Token {
 		return this.#space.length;
 	}
 
+	/** @override */
+	print() {
+		const {childNodes: {length}} = this;
+		return super.print(length > 1 ? {pre: '[', sep: this.#space, post: ']'} : {pre: '[', post: `${this.#space}]`});
+	}
+
 	/** @override */
 	text() {
-		normalizeSpace(this.children[1]);
+		normalizeSpace(this.childNodes[1]);
 		return `[${super.text(' ')}]`;
 	}
 
@@ -132,13 +138,13 @@ class ExtLinkToken extends Token {
 	setTarget(url) {
 		url = String(url);
 		const root = Parser.parse(`[${url}]`, this.getAttribute('include'), 8, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild?.type !== 'ext-link' || firstElementChild.childNodes.length !== 1) {
+			{childNodes: {length}, firstChild: extLink} = root;
+		if (length !== 1 || extLink.type !== 'ext-link' || extLink.childNodes.length !== 1) {
 			throw new SyntaxError(`非法的外链目标：${url}`);
 		}
-		const {firstChild} = firstElementChild;
-		firstElementChild.destroy(true);
-		this.firstElementChild.safeReplaceWith(firstChild);
+		const {firstChild} = extLink;
+		extLink.destroy(true);
+		this.firstChild.safeReplaceWith(firstChild);
 	}
 
 	/**
@@ -149,15 +155,15 @@ class ExtLinkToken extends Token {
 	setLinkText(text) {
 		text = String(text);
 		const root = Parser.parse(`[//url ${text}]`, this.getAttribute('include'), 8, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild?.type !== 'ext-link' || firstElementChild.childNodes.length !== 2) {
+			{childNodes: {length}, firstChild: extLink} = root;
+		if (length !== 1 || extLink.type !== 'ext-link' || extLink.childNodes.length !== 2) {
 			throw new SyntaxError(`非法的外链文字：${noWrap(text)}`);
 		}
-		const {lastChild} = firstElementChild;
+		const {lastChild} = extLink;
 		if (this.childNodes.length === 1) {
 			this.appendChild(lastChild);
 		} else {
-			this.lastElementChild.safeReplaceWith(lastChild);
+			this.lastChild.safeReplaceWith(lastChild);
 		}
 		this.#space ||= ' ';
 	}

package/src/gallery.js

@@ -61,6 +61,11 @@ class GalleryToken extends Token {
 		return 1;
 	}
 
+	/** @override */
+	print() {
+		return super.print({sep: '\n'});
+	}
+
 	/** @override */
 	text() {
 		return super.text('\n').replaceAll(/\n\s*\n/gu, '\n');
@@ -79,11 +84,37 @@ class GalleryToken extends Token {
 		} catch {
 			title = this.normalizeTitle(file, 6, true);
 		}
-		if (!title.valid) {
-			throw new SyntaxError(`非法的文件名：${file}`);
+		if (title.valid) {
+			const token = Parser.run(() => new GalleryImageToken(file, undefined, title, this.getAttribute('config')));
+			return this.insertAt(token, i);
+		}
+		throw new SyntaxError(`非法的文件名：${file}`);
+	}
+
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const {top, left} = this.getRootNode().posFromIndex(start),
+			/** @type {LintError[]} */ errors = [];
+		for (let i = 0, cur = start; i < this.childNodes.length; i++) {
+			const child = this.childNodes[i],
+				str = String(child);
+			if (child.type === 'hidden' && str.trim() && !/^<!--.*-->$/u.test(str)) {
+				errors.push({
+					message: '图库中的无效内容',
+					startLine: top + i,
+					endLine: top + i,
+					startCol: i ? 0 : left,
+					endCol: i ? str.length : left + str.length,
+				});
+			} else if (child.type !== 'hidden' && child.type !== 'text') {
+				errors.push(...child.lint(cur));
+			}
+			cur += str.length + 1;
 		}
-		const token = Parser.run(() => new GalleryImageToken(file, undefined, title, this.getAttribute('config')));
-		return this.insertAt(token, i);
+		return errors;
 	}
 }
 

package/src/heading.js

@@ -1,6 +1,7 @@
 'use strict';
 
-const fixedToken = require('../mixin/fixedToken'),
+const {generateForSelf} = require('../util/lint'),
+	fixedToken = require('../mixin/fixedToken'),
 	sol = require('../mixin/sol'),
 	Parser = require('..'),
 	Token = require('.');
@@ -14,7 +15,7 @@ class HeadingToken extends fixedToken(sol(Token)) {
 
 	/** 内部wikitext */
 	get innerText() {
-		return this.firstElementChild.text();
+		return this.firstChild.text();
 	}
 
 	/**
@@ -39,8 +40,8 @@ class HeadingToken extends fixedToken(sol(Token)) {
 	cloneNode() {
 		const [title, trail] = this.cloneChildNodes(),
 			token = Parser.run(() => new HeadingToken(Number(this.name), [], this.getAttribute('config')));
-		token.firstElementChild.safeReplaceWith(title);
-		token.lastElementChild.safeReplaceWith(trail);
+		token.firsthild.safeReplaceWith(title);
+		token.lastChild.safeReplaceWith(trail);
 		return token;
 	}
 
@@ -54,8 +55,8 @@ class HeadingToken extends fixedToken(sol(Token)) {
 		return selector && this.matches(selector)
 			? ''
 			: `${this.prependNewLine()}${equals}${
-				this.firstElementChild.toString(selector)
-			}${equals}${this.lastElementChild.toString(selector)}${this.appendNewLine()}`;
+				this.firstChild.toString(selector)
+			}${equals}${this.lastChild.toString(selector)}${this.appendNewLine()}`;
 	}
 
 	/** @override */
@@ -68,6 +69,24 @@ class HeadingToken extends fixedToken(sol(Token)) {
 		return Number(this.name);
 	}
 
+	/** @override */
+	print() {
+		const equals = '='.repeat(Number(this.name));
+		return super.print({pre: equals, sep: equals});
+	}
+
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start);
+		if (this.name === '1') {
+			errors.push(generateForSelf(this, this.getRootNode().posFromIndex(start), '<h1>'));
+		}
+		return errors;
+	}
+
 	/**
 	 * @override
 	 * @this {HeadingToken & {prependNewLine(): ''|'\n', appendNewLine(): ''|'\n'}}
@@ -75,7 +94,7 @@ class HeadingToken extends fixedToken(sol(Token)) {
 	 */
 	text() {
 		const equals = '='.repeat(Number(this.name));
-		return `${this.prependNewLine()}${equals}${this.firstElementChild.text()}${equals}${this.appendNewLine()}`;
+		return `${this.prependNewLine()}${equals}${this.firstChild.text()}${equals}${this.appendNewLine()}`;
 	}
 
 	/**
@@ -87,12 +106,12 @@ class HeadingToken extends fixedToken(sol(Token)) {
 			this.typeError('setLevel', 'Number');
 		}
 		n = Math.min(Math.max(n, 1), 6);
-		this.setAttribute('name', String(n)).firstElementChild.setAttribute('name', this.name);
+		this.setAttribute('name', String(n)).firstChild.setAttribute('name', this.name);
 	}
 
 	/** 移除标题后的不可见内容 */
 	removeTrail() {
-		this.lastElementChild.replaceChildren();
+		this.lastChild.replaceChildren();
 	}
 }
 

package/src/html.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const {noWrap} = require('../util/string'),
+	{generateForSelf} = require('../util/lint'),
 	fixedToken = require('../mixin/fixedToken'),
 	attributeParent = require('../mixin/attributeParent'),
 	Parser = require('..'),
@@ -104,6 +105,34 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 		return this.#tag.length + (this.#closing ? 2 : 1);
 	}
 
+	/** @override */
+	print() {
+		return super.print({
+			pre: `<${this.#closing ? '/' : ''}${this.#tag}`, post: `${this.#selfClosing ? '/' : ''}>`,
+		});
+	}
+
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start);
+		let /** @type {LintError} */ refError;
+		if (this.name === 'h1' && !this.#closing) {
+			refError = generateForSelf(this, this.getRootNode().posFromIndex(start), '<h1>');
+			errors.push(refError);
+		}
+		try {
+			this.findMatchingTag();
+		} catch ({message: errorMsg}) {
+			const [message] = errorMsg.split('：');
+			refError ||= generateForSelf(this, this.getRootNode().posFromIndex(start), '');
+			errors.push({...refError, message, severity: message === '未闭合的标签' ? 'warning' : 'error'});
+		}
+		return errors;
+	}
+
 	/** @override */
 	text() {
 		return `<${this.#closing ? '/' : ''}${this.#tag}${super.text()}${this.#selfClosing ? '/' : ''}>`;
@@ -131,24 +160,23 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 	 */
 	findMatchingTag() {
 		const {html} = this.getAttribute('config'),
-			{name, parentNode, closing, selfClosing} = this,
+			{name: tagName, parentNode} = this,
 			string = noWrap(String(this));
-		if (closing && selfClosing) {
+		if (this.#closing && this.#selfClosing) {
 			throw new SyntaxError(`同时闭合和自封闭的标签：${string}`);
-		} else if (html[2].includes(name) || selfClosing && html[1].includes(name)) { // 自封闭标签
+		} else if (html[2].includes(tagName) || this.#selfClosing && html[1].includes(tagName)) { // 自封闭标签
 			return this;
-		} else if (selfClosing && html[0].includes(name)) {
+		} else if (this.#selfClosing && html[0].includes(tagName)) {
 			throw new SyntaxError(`无效自封闭标签：${string}`);
 		} else if (!parentNode) {
 			return undefined;
 		}
-		const {children} = parentNode,
-			i = children.indexOf(this),
-			selector = `html#${name}`,
-			siblings = closing
-				? children.slice(0, i).reverse().filter(child => child.matches(selector))
-				: children.slice(i + 1).filter(child => child.matches(selector));
-		let imbalance = closing ? -1 : 1;
+		const {childNodes} = parentNode,
+			i = childNodes.indexOf(this),
+			siblings = this.#closing
+				? childNodes.slice(0, i).reverse().filter(({type, name}) => type === 'html' && name === tagName)
+				: childNodes.slice(i + 1).filter(({type, name}) => type === 'html' && name === tagName);
+		let imbalance = this.#closing ? -1 : 1;
 		for (const token of siblings) {
 			if (token.closing) {
 				imbalance--;
@@ -159,7 +187,7 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 				return token;
 			}
 		}
-		throw new SyntaxError(`未${closing ? '匹配的闭合' : '闭合的'}标签：${string}`);
+		throw new SyntaxError(`未${this.#closing ? '匹配的闭合' : '闭合的'}标签：${string}`);
 	}
 
 	/** 局部闭合 */
@@ -176,17 +204,17 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 	 */
 	fix() {
 		const config = this.getAttribute('config'),
-			{parentNode, name, firstElementChild} = this;
-		if (!parentNode || !this.#selfClosing || !config.html[0].includes(name)) {
+			{parentNode, name: tagName, firstChild} = this;
+		if (!parentNode || !this.#selfClosing || !config.html[0].includes(tagName)) {
 			return;
-		} else if (firstElementChild.text().trim()) {
+		} else if (firstChild.text().trim()) {
 			this.#localMatch();
 			return;
 		}
-		const {children} = parentNode,
-			i = children.indexOf(this),
+		const {childNodes} = parentNode,
+			i = childNodes.indexOf(this),
 			/** @type {HtmlToken[]} */
-			prevSiblings = children.slice(0, i).filter(child => child.matches(`html#${name}`)),
+			prevSiblings = childNodes.slice(0, i).filter(({type, name}) => type === 'html' && name === tagName),
 			imbalance = prevSiblings.reduce((acc, {closing}) => acc + (closing ? 1 : -1), 0);
 		if (imbalance < 0) {
 			this.#selfClosing = false;

package/src/imageParameter.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const {text, noWrap, extUrlChar} = require('../util/string'),
+const {text, noWrap, print, extUrlChar} = require('../util/string'),
 	Parser = require('..'),
 	Token = require('.'),
 	AstText = require('../lib/text');
@@ -89,7 +89,6 @@ class ImageParameterToken extends Token {
 			}
 			str.splitText(str.data.indexOf('x'));
 			str.nextSibling.splitText(1);
-			// eslint-disable-next-line unicorn/consistent-destructuring
 			return {width: text(token.childNodes.slice(0, i + 1)), height: text(token.childNodes.slice(i + 2))};
 		}
 		return undefined;
@@ -191,6 +190,13 @@ class ImageParameterToken extends Token {
 		return Math.max(0, this.#syntax.indexOf('$1'));
 	}
 
+	/** @override */
+	print() {
+		return this.#syntax
+			? `<span class="wpb-image-parameter">${this.#syntax.replace('$1', print(this.childNodes))}</span>`
+			: super.print({class: 'image-caption'});
+	}
+
 	/** @override */
 	text() {
 		return this.#syntax ? this.#syntax.replace('$1', super.text()).trim() : super.text().trim();
@@ -239,14 +245,14 @@ class ImageParameterToken extends Token {
 		const root = Parser.parse(`[[File:F|${
 				this.#syntax ? this.#syntax.replace('$1', value) : value
 			}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root,
-			param = firstElementChild?.lastElementChild;
-		if (length !== 1 || !firstElementChild?.matches('file#File\\:F')
-			|| firstElementChild.childNodes.length !== 2 || param.name !== this.name
+			{childNodes: {length}, firstChild: file} = root,
+			{lastChild: imageParameter, type, name, childNodes: {length: fileLength}} = file;
+		if (length !== 1 || type !== 'file' || name !== 'File:F' || fileLength !== 2
+			|| imageParameter.name !== this.name
 		) {
 			throw new SyntaxError(`非法的 ${this.name} 参数：${noWrap(value)}`);
 		}
-		this.replaceChildren(...param.childNodes);
+		this.replaceChildren(...imageParameter.childNodes);
 	}
 }
 

package/src/index.js

@@ -3,7 +3,7 @@
 /*
  * PHP解析器的步骤：
  * -1. 替换签名和`{{subst:}}`，参见Parser::preSaveTransform；这在revision中不可能保留，可以跳过
- * 0. 移除特定字符`\0`和`\x7f`，参见Parser::parse
+ * 0. 移除特定字符`\0`和`\x7F`，参见Parser::parse
  * 1. 注释/扩展标签（'<'相关），参见Preprocessor_Hash::buildDomTreeArrayFromText和Sanitizer::decodeTagAttributes
  * 2. 模板/模板变量/标题，注意rightmost法则，以及`-{`和`[[`可以破坏`{{`或`{{{`语法，
  *    参见Preprocessor_Hash::buildDomTreeArrayFromText
@@ -19,7 +19,7 @@
  */
 
 /*
- * \0\d+.\x7f标记Token：
+ * \0\d+.\x7F标记Token：
  * e: ExtToken
  * c: CommentToken、NoIncludeToken和IncludeToken
  * !: `{{!}}`专用
@@ -58,7 +58,7 @@ class Token extends AstElement {
 	type = 'root';
 	#stage = 0; // 解析阶段，参见顶部注释。只对plain Token有意义。
 	#config;
-	// 这个数组起两个作用：1. 数组中的Token会在build时替换`/\0\d+.\x7f/`标记；2. 数组中的Token会依次执行parseOnce和build方法。
+	// 这个数组起两个作用：1. 数组中的Token会在build时替换`/\0\d+.\x7F/`标记；2. 数组中的Token会依次执行parseOnce和build方法。
 	#accum;
 	/** @type {Record<string, Ranges>} */ #acceptable;
 	#protectedChildren = new Ranges();
@@ -167,7 +167,7 @@ class Token extends AstElement {
 	constructor(wikitext, config = Parser.getConfig(), halfParsed = false, accum = [], acceptable = null) {
 		super();
 		if (typeof wikitext === 'string') {
-			this.appendChild(halfParsed ? wikitext : wikitext.replaceAll('\0', '').replaceAll('\x7F', ''));
+			this.appendChild(halfParsed ? wikitext : wikitext.replaceAll(/[\0\x7F]/gu, ''));
 		}
 		this.#config = config;
 		this.#accum = accum;
@@ -521,27 +521,28 @@ class Token extends AstElement {
 		if (!parentNode) {
 			return undefined;
 		}
-		const {children} = parentNode,
-			index = children.indexOf(this);
+		const {childNodes} = parentNode,
+			index = childNodes.indexOf(this);
 		let i;
 		for (i = index - 1; i >= 0; i--) {
-			if (children[i].matches(`html${tag && '#'}${tag ?? ''}[selfClosing=false][closing=false]`)) {
+			const {type, name, selfClosing, closing} = childNodes[i];
+			if (type === 'html' && (!tag || name === tag) && selfClosing === false && closing === false) {
 				break;
 			}
 		}
 		if (i === -1) {
 			return parentNode.findEnclosingHtml(tag);
 		}
-		const opening = children[i],
-			{name} = opening;
-		for (i = index + 1; i < children.length; i++) {
-			if (children[i].matches(`html#${name}[selfClosing=false][closing=true]`)) {
+		const opening = childNodes[i];
+		for (i = index + 1; i < childNodes.length; i++) {
+			const {type, name, selfClosing, closing} = childNodes[i];
+			if (type === 'html' && name === opening.name && selfClosing === false && closing === true) {
 				break;
 			}
 		}
-		return i === children.length
+		return i === childNodes.length
 			? parentNode.findEnclosingHtml(tag)
-			: [opening, children[i]];
+			: [opening, childNodes[i]];
 	}
 
 	/**
@@ -654,7 +655,9 @@ class Token extends AstElement {
 	/** 解析花括号 */
 	#parseBrackets() {
 		const parseBrackets = require('../parser/brackets');
-		this.setText(parseBrackets(String(this), this.#config, this.#accum));
+		const str = this.type === 'root' ? String(this) : `\0${String(this)}`,
+			parsed = parseBrackets(str, this.#config, this.#accum);
+		this.setText(this.type === 'root' ? parsed : parsed.slice(1));
 	}
 
 	/** 解析HTML标签 */
@@ -718,9 +721,13 @@ class Token extends AstElement {
 
 	/** 解析列表 */
 	#parseList() {
+		if (this.type === 'image-parameter') {
+			return;
+		}
 		const parseList = require('../parser/list');
 		const lines = String(this).split('\n');
-		for (let i = this.type === 'root' ? 0 : 1; i < lines.length; i++) {
+		let i = this.type === 'root' || this.type === 'ext-inner' && this.type === 'poem' ? 0 : 1;
+		for (; i < lines.length; i++) {
 			lines[i] = parseList(lines[i], this.#config, this.#accum);
 		}
 		this.setText(lines.join('\n'));

package/src/link/category.js

@@ -2,8 +2,7 @@
 
 const Title = require('../../lib/title'),
 	Parser = require('../..'),
-	LinkToken = require('.'),
-	Token = require('..');
+	LinkToken = require('.');
 
 /**
  * 分类
@@ -19,10 +18,11 @@ class CategoryToken extends LinkToken {
 
 	/** 分类排序关键字 */
 	get sortkey() {
-		return this.children[1]?.text()
-			?.replaceAll(/&#(\d+);/gu, /** @param {string} p */ (_, p) => String.fromCodePoint(Number(p)))
-			?.replaceAll(/&#x([\da-f]+);/giu, /** @param {string} p */ (_, p) => String.fromCodePoint(parseInt(p, 16)))
-			?.replaceAll('\n', '') ?? '';
+		return this.childNodes[1]?.text()?.replaceAll(
+			/&#(\d+|x[\da-f]+);|\n/gu,
+			/** @param {string} p */
+			(_, p) => p ? String.fromCodePoint(p[0] === 'x' ? parseInt(p.slice(1), 16) : Number(p)) : '',
+		);
 	}
 
 	set sortkey(text) {

package/src/link/file.js

@@ -3,6 +3,7 @@
 const Title = require('../../lib/title'),
 	{explode, noWrap} = require('../../util/string'),
 	{externalUse} = require('../../util/debug'),
+	{generateForChild} = require('../../util/lint'),
 	Parser = require('../..'),
 	LinkToken = require('.'),
 	ImageParameterToken = require('../imageParameter');
@@ -78,6 +79,26 @@ class FileToken extends LinkToken {
 		this.seal(['setLangLink', 'setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick'], true);
 	}
 
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start),
+			frameArgs = this.getFrameArgs(),
+			captions = this.getArgs('caption');
+		if (frameArgs.length > 1 || captions.size > 1) {
+			const rect = this.getRootNode().posFromIndex(start);
+			if (frameArgs.length > 1) {
+				errors.push(...frameArgs.map(arg => generateForChild(arg, rect, '重复或冲突的图片框架参数')));
+			}
+			if (captions.size > 1) {
+				errors.push(...[...captions].map(arg => generateForChild(arg, rect, '重复的图片说明')));
+			}
+		}
+		return errors;
+	}
+
 	/**
 	 * @override
 	 * @param {number} i 移除位置
@@ -251,13 +272,12 @@ class FileToken extends LinkToken {
 		}
 		const wikitext = `[[File:F|${syntax ? syntax.replace('$1', value) : value}]]`,
 			root = Parser.parse(wikitext, this.getAttribute('include'), 6, config),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches('file#File\\:F')
-			|| firstElementChild.childNodes.length !== 2 || firstElementChild.lastElementChild.name !== key
-		) {
+			{childNodes: {length}, firstChild: file} = root,
+			{name, type, childNodes: {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(firstElementChild.lastChild);
+		this.appendChild(imageParameter);
 	}
 }