wikiparser-node 0.3.1 → 0.5.0

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
  * !: `{{!}}`专用
@@ -42,31 +42,132 @@
  */
 
 const {externalUse} = require('../util/debug'),
+	{text} = require('../util/string'),
 	Ranges = require('../lib/ranges'),
-	AstElement = require('../lib/element'),
 	assert = require('assert/strict'),
-	/** @type {Parser} */ Parser = require('..'),
-	{MAX_STAGE} = Parser;
+	Parser = require('..'),
+	AstElement = require('../lib/element'),
+	AstText = require('../lib/text');
+const {MAX_STAGE, aliases} = Parser;
 
+/**
+ * 所有节点的基类
+ * @classdesc `{childNodes: ...(AstText|Token)}`
+ */
 class Token extends AstElement {
 	type = 'root';
-	/** 解析阶段，参见顶部注释。只对plain Token有意义。 */ #stage = 0;
+	#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();
 	/** @type {boolean} */ #include;
 
 	/**
-	 * @param {?string} wikitext
+	 * 保护部分子节点不被移除
+	 * @param {...string|number|Range} args 子节点范围
+	 */
+	#protectChildren = (...args) => {
+		this.#protectedChildren.push(...new Ranges(args));
+	};
+
+	/**
+	 * 将维基语法替换为占位符
+	 * @param {number} n 解析阶段
+	 * @param {boolean} include 是否嵌入
+	 */
+	#parseOnce = (n = this.#stage, include = false) => {
+		if (n < this.#stage || !this.isPlain() || this.childNodes.length === 0) {
+			return this;
+		}
+		switch (n) {
+			case 0:
+				if (this.type === 'root') {
+					this.#accum.shift();
+				}
+				this.#parseCommentAndExt(include);
+				break;
+			case 1:
+				this.#parseBrackets();
+				break;
+			case 2:
+				this.#parseHtml();
+				break;
+			case 3:
+				this.#parseTable();
+				break;
+			case 4:
+				this.#parseHrAndDoubleUndescore();
+				break;
+			case 5:
+				this.#parseLinks();
+				break;
+			case 6:
+				this.#parseQuotes();
+				break;
+
+			case 7:
+				this.#parseExternalLinks();
+				break;
+			case 8:
+				this.#parseMagicLinks();
+				break;
+			case 9:
+				this.#parseList();
+				break;
+			case 10:
+				this.#parseConverter();
+				// no default
+		}
+		if (this.type === 'root') {
+			for (const token of this.#accum) {
+				token.getAttribute('parseOnce')(n, include);
+			}
+		}
+		this.#stage++;
+		return this;
+	};
+
+	/**
+	 * 重建wikitext
+	 * @param {string} str 半解析的字符串
+	 * @complexity `n`
+	 * @returns {(Token|AstText)[]}
+	 */
+	#buildFromStr = str => str.split(/[\0\x7F]/u).map((s, i) => {
+		if (i % 2 === 0) {
+			return new AstText(s);
+		} else if (isNaN(s.at(-1))) {
+			return this.#accum[Number(s.slice(0, -1))];
+		}
+		throw new Error(`解析错误！未正确标记的 Token：${s}`);
+	});
+
+	/** 所有图片，包括图库 */
+	get images() {
+		return this.querySelectorAll('file, gallery-image');
+	}
+
+	/** 所有内链、外链和自由外链 */
+	get links() {
+		return this.querySelectorAll('link, ext-link, free-ext-link');
+	}
+
+	/** 所有模板和模块 */
+	get embeds() {
+		return this.querySelectorAll('template, magic-word#invoke');
+	}
+
+	/**
+	 * @param {string} wikitext wikitext
 	 * @param {accum} accum
-	 * @param {acceptable} acceptable
+	 * @param {acceptable} acceptable 可接受的子节点设置
 	 */
 	constructor(wikitext, config = Parser.getConfig(), halfParsed = false, accum = [], acceptable = null) {
 		super();
 		if (typeof wikitext === 'string') {
-			this.appendChild(halfParsed ? wikitext : wikitext.replace(/[\0\x7f]/g, ''));
+			this.appendChild(halfParsed ? wikitext : wikitext.replaceAll(/[\0\x7F]/gu, ''));
 		}
 		this.#config = config;
 		this.#accum = accum;
@@ -74,32 +175,38 @@ class Token extends AstElement {
 		accum.push(this);
 	}
 
-	/** @complexity `n` */
-	cloneChildren() {
-		if (!Parser.debugging && externalUse('cloneChildren')) {
-			this.debugOnly('cloneChildren');
-		}
-		return this.childNodes.map(child => typeof child === 'string' ? child : child.cloneNode());
+	/**
+	 * 深拷贝所有子节点
+	 * @complexity `n`
+	 * @returns {(AstText|Token)[]}
+	 */
+	cloneChildNodes() {
+		return this.childNodes.map(child => child.cloneNode());
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 深拷贝节点
+	 * @complexity `n`
+	 * @throws `Error` 未定义复制方法
+	 */
 	cloneNode() {
 		if (!this.isPlain()) {
 			throw new Error(`未定义 ${this.constructor.name} 的复制方法！`);
 		}
-		const cloned = this.cloneChildren();
+		const cloned = this.cloneChildNodes();
 		return Parser.run(() => {
 			const token = new Token(undefined, this.#config, false, [], this.#acceptable);
 			token.type = this.type;
 			token.append(...cloned);
-			token.protectChildren(...this.#protectedChildren);
+			token.getAttribute('protectChildren')(...this.#protectedChildren);
 			return token;
 		});
 	}
 
 	/**
+	 * @override
 	 * @template {string} T
-	 * @param {T} key
+	 * @param {T} key 属性键
 	 * @returns {TokenAttribute<T>}
 	 */
 	getAttribute(key) {
@@ -112,18 +219,28 @@ class Token extends AstElement {
 				return this.#accum;
 			case 'acceptable':
 				return this.#acceptable ? {...this.#acceptable} : null;
+			case 'protectChildren':
+				return this.#protectChildren;
 			case 'protectedChildren':
 				return new Ranges(this.#protectedChildren);
+			case 'parseOnce':
+				return this.#parseOnce;
+			case 'buildFromStr':
+				return this.#buildFromStr;
 			case 'include': {
 				if (this.#include !== undefined) {
 					return this.#include;
 				}
-				const includeToken = this.querySelector('include');
+				const root = this.getRootNode();
+				if (root.type === 'root' && root !== this) {
+					return root.getAttribute('include');
+				}
+				const includeToken = root.querySelector('include');
 				if (includeToken) {
 					return includeToken.name === 'noinclude';
 				}
-				const noincludeToken = this.querySelector('noinclude');
-				return Boolean(noincludeToken) && !/^<\/?noinclude(?:\s[^>]*)?\/?>$/i.test(noincludeToken.toString());
+				const noincludeToken = root.querySelector('noinclude');
+				return Boolean(noincludeToken) && !/^<\/?noinclude(?:\s[^>]*)?\/?>$/iu.test(String(noincludeToken));
 			}
 			default:
 				return super.getAttribute(key);
@@ -131,14 +248,16 @@ class Token extends AstElement {
 	}
 
 	/**
+	 * @override
 	 * @template {string} T
-	 * @param {T} key
-	 * @param {TokenAttribute<T>} value
+	 * @param {T} key 属性键
+	 * @param {TokenAttribute<T>} value 属性值
+	 * @throws `RangeError` 禁止手动指定私有属性
 	 */
 	setAttribute(key, value) {
-		if (key === 'include' || !Parser.running && ['config', 'accum'].includes(key)) {
+		if (key === 'include' || !Parser.running && (key === 'config' || key === 'accum')) {
 			throw new RangeError(`禁止手动指定私有的 #${key} 属性！`);
-		} else if (!Parser.debugging && ['stage', 'acceptable', 'protectedChildren'].includes(key)
+		} else if (!Parser.debugging && (key === 'stage' || key === 'acceptable' || key === 'protectedChildren')
 			&& externalUse('setAttribute')
 		) {
 			throw new RangeError(`使用 ${this.constructor.name}.setAttribute 方法设置私有属性 #${key} 仅用于代码调试！`);
@@ -165,11 +284,11 @@ class Token extends AstElement {
 					for (const [k, v] of Object.entries(value)) {
 						if (k.startsWith('Stage-')) {
 							for (let i = 0; i <= Number(k.slice(6)); i++) {
-								for (const type of Parser.aliases[i]) {
+								for (const type of aliases[i]) {
 									acceptable[type] = new Ranges(v);
 								}
 							}
-						} else if (k.startsWith('!')) { // `!`项必须放在最后
+						} else if (k[0] === '!') { // `!`项必须放在最后
 							delete acceptable[k.slice(1)];
 						} else {
 							acceptable[k] = new Ranges(v);
@@ -184,22 +303,17 @@ class Token extends AstElement {
 		}
 	}
 
+	/** 是否是普通节点 */
 	isPlain() {
 		return this.constructor === Token;
 	}
 
-	/** @param {...string|number|Range} args */
-	protectChildren(...args) {
-		if (!Parser.debugging && externalUse('protectChildren')) {
-			this.debugOnly('protectChildren');
-		}
-		this.#protectedChildren.push(...new Ranges(args));
-	}
-
 	/**
-	 * @param {number} i
-	 * @returns {string|Token}
+	 * @override
+	 * @param {number} i 移除位置
+	 * @returns {Token}
 	 * @complexity `n`
+	 * @throws `Error` 不可移除的子节点
 	 */
 	removeAt(i) {
 		if (typeof i !== 'number') {
@@ -225,18 +339,25 @@ class Token extends AstElement {
 	}
 
 	/**
+	 * @override
 	 * @template {string|Token} T
-	 * @param {T} token
+	 * @param {T} token 待插入的子节点
+	 * @param {number} i 插入位置
 	 * @complexity `n`
+	 * @returns {T extends Token ? Token : AstText}
+	 * @throws `RangeError` 不可插入的子节点
 	 */
 	insertAt(token, i = this.childNodes.length) {
+		if (typeof token === 'string') {
+			token = new AstText(token);
+		}
 		if (!Parser.running && this.#acceptable) {
 			const acceptableIndices = Object.fromEntries(
 					Object.entries(this.#acceptable)
 						.map(([str, ranges]) => [str, ranges.applyTo(this.childNodes.length + 1)]),
 				),
 				nodesAfter = this.childNodes.slice(i),
-				insertedName = token.constructor.name,
+				{constructor: {name: insertedName}} = token,
 				k = i < 0 ? i + this.childNodes.length : i;
 			if (!acceptableIndices[insertedName].includes(k)) {
 				throw new RangeError(`${this.constructor.name} 的第 ${k} 个子节点不能为 ${insertedName}！`);
@@ -245,15 +366,18 @@ class Token extends AstElement {
 			}
 		}
 		super.insertAt(token, i);
-		if (token instanceof Token && token.type === 'root') {
+		if (token.type === 'root') {
 			token.type = 'plain';
 		}
 		return token;
 	}
 
 	/**
-	 * @param {Token} token
+	 * 替换为同类节点
+	 * @param {Token} token 待替换的节点
 	 * @complexity `n`
+	 * @throws `Error` 不存在父节点
+	 * @throws `Error` 待替换的节点具有不同属性
 	 */
 	safeReplaceWith(token) {
 		const {parentNode} = this;
@@ -280,28 +404,78 @@ class Token extends AstElement {
 		token.dispatchEvent(e, {position: i, oldToken: this, newToken: token});
 	}
 
-	/** @param {string} title */
+	/**
+	 * 创建HTML注释
+	 * @param {string} data 注释内容
+	 */
+	createComment(data = '') {
+		if (typeof data === 'string') {
+			const CommentToken = require('./nowiki/comment');
+			const config = this.getAttribute('config');
+			return Parser.run(() => new CommentToken(data.replaceAll('-->', '--&gt;'), true, config));
+		}
+		return this.typeError('createComment', 'String');
+	}
+
+	/**
+	 * 创建标签
+	 * @param {string} tagName 标签名
+	 * @param {{selfClosing: boolean, closing: boolean}} options 选项
+	 * @throws `RangeError` 非法的标签名
+	 */
+	createElement(tagName, {selfClosing, closing} = {}) {
+		if (typeof tagName !== 'string') {
+			this.typeError('createElement', 'String');
+		}
+		const config = this.getAttribute('config'),
+			include = this.getAttribute('include');
+		if (tagName === (include ? 'noinclude' : 'includeonly')) {
+			const IncludeToken = require('./tagPair/include');
+			return Parser.run(
+				() => new IncludeToken(tagName, '', undefined, selfClosing ? undefined : tagName, config),
+			);
+		} else if (config.ext.includes(tagName)) {
+			const ExtToken = require('./tagPair/ext');
+			return Parser.run(() => new ExtToken(tagName, '', '', selfClosing ? undefined : '', config));
+		} else if (config.html.flat().includes(tagName)) {
+			const HtmlToken = require('./html');
+			return Parser.run(() => new HtmlToken(tagName, '', closing, selfClosing, config));
+		}
+		throw new RangeError(`非法的标签名！${tagName}`);
+	}
+
+	/**
+	 * 判断标题是否是跨维基链接
+	 * @param {string} title 标题
+	 */
 	isInterwiki(title) {
 		return Parser.isInterwiki(title, this.#config);
 	}
 
-	/** @param {string} title */
+	/**
+	 * 规范化页面标题
+	 * @param {string} title 标题（含或不含命名空间前缀）
+	 * @param {number} defaultNs 命名空间
+	 */
 	normalizeTitle(title, defaultNs = 0, halfParsed = false) {
 		return Parser.normalizeTitle(title, defaultNs, this.#include, this.#config, halfParsed);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取全部章节
+	 * @complexity `n`
+	 */
 	sections() {
 		if (this.type !== 'root') {
-			return;
+			return undefined;
 		}
 		const {childNodes} = this,
-			headings = [...childNodes.entries()]
-				.filter(([, child]) => child instanceof Token && child.type === 'heading')
-				.map(/** @param {[number, Token]} */ ([i, {name}]) => [i, Number(name)]),
-			lastHeading = [-1, -1, -1, -1, -1, -1];
-		const /** @type {(string|Token)[][]} */ sections = new Array(headings.length);
-		for (const [i, [index, level]] of headings.entries()) {
+			headings = [...childNodes.entries()].filter(([, {type}]) => type === 'heading')
+				.map(([i, {name}]) => [i, Number(name)]),
+			lastHeading = [-1, -1, -1, -1, -1, -1],
+			/** @type {(AstText|Token)[][]} */ sections = new Array(headings.length);
+		for (let i = 0; i < headings.length; i++) {
+			const [index, level] = headings[i];
 			for (let j = level; j < 6; j++) {
 				const last = lastHeading[j];
 				if (last >= 0) {
@@ -320,20 +494,20 @@ class Token extends AstElement {
 	}
 
 	/**
-	 * @param {number} n
+	 * 获取指定章节
+	 * @param {number} n 章节序号
 	 * @complexity `n`
 	 */
 	section(n) {
-		if (typeof n !== 'number') {
-			this.typeError('section', 'Number');
-		}
-		return this.sections()[n];
+		return typeof n === 'number' ? this.sections()?.[n] : this.typeError('section', 'Number');
 	}
 
 	/**
-	 * @param {string|undefined} tag
+	 * 获取指定的外层HTML标签
+	 * @param {string|undefined} tag HTML标签名
 	 * @returns {[Token, Token]}
 	 * @complexity `n`
+	 * @throws `RangeError` 非法的标签或空标签
 	 */
 	findEnclosingHtml(tag) {
 		if (tag !== undefined && typeof tag !== 'string') {
@@ -343,38 +517,46 @@ class Token extends AstElement {
 		if (tag !== undefined && !this.#config.html.slice(0, 2).flat().includes(tag)) {
 			throw new RangeError(`非法的标签或空标签：${tag}`);
 		}
-		const {parentElement} = this;
-		if (!parentElement) {
-			return;
+		const {parentNode} = this;
+		if (!parentNode) {
+			return undefined;
 		}
-		const {children} = parentElement,
-			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 parentElement.findEnclosingHtml(tag);
+			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
-			? parentElement.findEnclosingHtml(tag)
-			: [opening, children[i]];
+		return i === childNodes.length
+			? parentNode.findEnclosingHtml(tag)
+			: [opening, childNodes[i]];
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 获取全部分类
+	 * @complexity `n`
+	 */
 	getCategories() {
 		return this.querySelectorAll('category').map(({name, sortkey}) => [name, sortkey]);
 	}
 
+	/**
+	 * 重新解析单引号
+	 * @throws `Error` 不接受QuoteToken作为子节点
+	 */
 	redoQuotes() {
 		const acceptable = this.getAttribute('acceptable');
 		if (acceptable && !acceptable.QuoteToken?.some(
@@ -383,24 +565,24 @@ class Token extends AstElement {
 			throw new Error(`${this.constructor.name} 不接受 QuoteToken 作为子节点！`);
 		}
 		for (const quote of this.childNodes) {
-			if (quote instanceof Token && quote.type === 'quote') {
-				quote.replaceWith(quote.firstChild);
+			if (quote.type === 'quote') {
+				quote.replaceWith(String(quote));
 			}
 		}
 		this.normalize();
-		/** @type {[number, string][]} */
-		const textNodes = [...this.childNodes.entries()].filter(([, child]) => typeof child === 'string'),
+		/** @type {[number, AstText][]} */
+		const textNodes = [...this.childNodes.entries()].filter(([, {type}]) => type === 'text'),
 			indices = textNodes.map(([i]) => this.getRelativeIndex(i)),
 			token = Parser.run(() => {
-				const root = new Token(textNodes.map(([, str]) => str).join(''), this.getAttribute('config'));
+				const root = new Token(text(textNodes.map(([, str]) => str)), this.getAttribute('config'));
 				return root.setAttribute('stage', 6).parse(7);
 			});
 		for (const quote of token.children.reverse()) {
 			if (quote.type === 'quote') {
 				const index = quote.getRelativeIndex(),
 					n = indices.findLastIndex(textIndex => textIndex <= index);
-				this.splitText(n, index - indices[n]);
-				this.splitText(n + 1, Number(quote.name));
+				this.childNodes[n].splitText(index - indices[n]);
+				this.childNodes[n + 1].splitText(Number(quote.name));
 				this.removeAt(n + 1);
 				this.insertAt(quote, n + 1);
 			}
@@ -408,82 +590,6 @@ class Token extends AstElement {
 		this.normalize();
 	}
 
-	/**
-	 * 将维基语法替换为占位符
-	 * @this {Token & {firstChild: string}}
-	 */
-	parseOnce(n = this.#stage, include = false) {
-		if (!Parser.debugging && externalUse('parseOnce')) {
-			this.debugOnly('parseOnce');
-		} else if (n < this.#stage || !this.isPlain() || this.childNodes.length === 0) {
-			return this;
-		}
-		switch (n) {
-			case 0:
-				if (this.type === 'root') {
-					this.#accum.shift();
-				}
-				this.#parseCommentAndExt(include);
-				break;
-			case 1:
-				this.#parseBrackets();
-				break;
-			case 2:
-				this.#parseHtml();
-				break;
-			case 3:
-				this.#parseTable();
-				break;
-			case 4:
-				this.#parseHrAndDoubleUndescore();
-				break;
-			case 5:
-				this.#parseLinks();
-				break;
-			case 6: {
-				this.#parseQuotes();
-				break;
-			}
-			case 7:
-				this.#parseExternalLinks();
-				break;
-			case 8:
-				this.#parseMagicLinks();
-				break;
-			case 9:
-				this.#parseList();
-				break;
-			case 10:
-				this.#parseConverter();
-				// no default
-		}
-		if (this.type === 'root') {
-			for (const token of this.#accum) {
-				token.parseOnce(n, include);
-			}
-		}
-		this.#stage++;
-		return this;
-	}
-
-	/**
-	 * @param {string} str
-	 * @complexity `n`
-	 */
-	buildFromStr(str) {
-		if (!Parser.debugging && externalUse('buildFromStr')) {
-			this.debugOnly('buildFromStr');
-		}
-		return str.split(/[\0\x7f]/).map((s, i) => {
-			if (i % 2 === 0) {
-				return s;
-			} else if (!isNaN(s.at(-1))) {
-				throw new Error(`解析错误！未正确标记的 Token：${s}`);
-			}
-			return this.#accum[Number(s.slice(0, -1))];
-		});
-	}
-
 	/**
 	 * 将占位符替换为子Token
 	 * @complexity `n`
@@ -493,15 +599,15 @@ class Token extends AstElement {
 			this.debugOnly('build');
 		}
 		this.#stage = MAX_STAGE;
-		const {childNodes: {length}, firstChild} = this;
-		if (length !== 1 || typeof firstChild !== 'string' || !firstChild.includes('\0')) {
-			return this;
-		}
-		this.replaceChildren(...this.buildFromStr(firstChild));
-		this.normalize();
-		if (this.type === 'root') {
-			for (const token of this.#accum) {
-				token.build();
+		const {childNodes: {length}, firstChild} = this,
+			str = String(firstChild);
+		if (length === 1 && firstChild.type === 'text' && str.includes('\0')) {
+			this.replaceChildren(...this.#buildFromStr(str));
+			this.normalize();
+			if (this.type === 'root') {
+				for (const token of this.#accum) {
+					token.build();
+				}
 			}
 		}
 		return this;
@@ -519,35 +625,48 @@ class Token extends AstElement {
 		return this;
 	}
 
-	/** 解析、重构、生成部分Token的`name`属性 */
+	/**
+	 * 解析、重构、生成部分Token的`name`属性
+	 * @param {number} n 最大解析层级
+	 * @param {boolean} include 是否嵌入
+	 */
 	parse(n = MAX_STAGE, include = false) {
 		if (typeof n !== 'number') {
 			this.typeError('parse', 'Number');
-		} else if (n < MAX_STAGE && !Parser.debugging && externalUse('parse')) {
+		} else if (n < MAX_STAGE && !Parser.debugging && Parser.warning && externalUse('parse')) {
 			Parser.warn('指定解析层级的方法仅供熟练用户使用！');
 		}
 		this.#include = Boolean(include);
 		while (this.#stage < n) {
-			this.parseOnce(this.#stage, include);
+			this.#parseOnce(this.#stage, include);
 		}
 		return n ? this.build().afterBuild() : this;
 	}
 
-	#parseCommentAndExt(includeOnly = false) {
+	/**
+	 * 解析HTML注释和扩展标签
+	 * @param {boolean} includeOnly 是否嵌入
+	 */
+	#parseCommentAndExt(includeOnly) {
 		const parseCommentAndExt = require('../parser/commentAndExt');
-		this.setText(parseCommentAndExt(this.firstChild, this.#config, this.#accum, includeOnly));
+		this.setText(parseCommentAndExt(String(this), this.#config, this.#accum, includeOnly));
 	}
 
+	/** 解析花括号 */
 	#parseBrackets() {
 		const parseBrackets = require('../parser/brackets');
-		this.setText(parseBrackets(this.firstChild, 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标签 */
 	#parseHtml() {
 		const parseHtml = require('../parser/html');
-		this.setText(parseHtml(this.firstChild, this.#config, this.#accum));
+		this.setText(parseHtml(String(this), this.#config, this.#accum));
 	}
 
+	/** 解析表格 */
 	#parseTable() {
 		const parseTable = require('../parser/table'),
 			TableToken = require('./table');
@@ -555,7 +674,7 @@ class Token extends AstElement {
 		for (const table of this.#accum) {
 			if (table instanceof TableToken && table.type !== 'td') {
 				table.normalize();
-				const [, child] = table.childNodes;
+				const {childNodes: [, child]} = table;
 				if (typeof child === 'string' && child.includes('\0')) {
 					table.removeAt(1);
 					const inner = new Token(child, this.#config, true, this.#accum);
@@ -566,49 +685,58 @@ class Token extends AstElement {
 		}
 	}
 
+	/** 解析\<hr\>和状态开关 */
 	#parseHrAndDoubleUndescore() {
 		const parseHrAndDoubleUnderscore = require('../parser/hrAndDoubleUnderscore');
-		this.setText(parseHrAndDoubleUnderscore(this.firstChild, this.#config, this.#accum));
+		this.setText(parseHrAndDoubleUnderscore(this, this.#config, this.#accum));
 	}
 
+	/** 解析内部链接 */
 	#parseLinks() {
 		const parseLinks = require('../parser/links');
-		this.setText(parseLinks(this.firstChild, this.#config, this.#accum));
+		this.setText(parseLinks(String(this), this.#config, this.#accum));
 	}
 
-	/** @this {Token & {firstChild: string}} */
+	/** 解析单引号 */
 	#parseQuotes() {
-		const parseQuotes = require('../parser/quotes'),
-			lines = this.firstChild.split('\n');
+		const parseQuotes = require('../parser/quotes');
+		const lines = String(this).split('\n');
 		for (let i = 0; i < lines.length; i++) {
 			lines[i] = parseQuotes(lines[i], this.#config, this.#accum);
 		}
 		this.setText(lines.join('\n'));
 	}
 
+	/** 解析外部链接 */
 	#parseExternalLinks() {
 		const parseExternalLinks = require('../parser/externalLinks');
-		this.setText(parseExternalLinks(this.firstChild, this.#config, this.#accum));
+		this.setText(parseExternalLinks(String(this), this.#config, this.#accum));
 	}
 
+	/** 解析自由外链 */
 	#parseMagicLinks() {
 		const parseMagicLinks = require('../parser/magicLinks');
-		this.setText(parseMagicLinks(this.firstChild, this.#config, this.#accum));
+		this.setText(parseMagicLinks(String(this), this.#config, this.#accum));
 	}
 
-	/** @this {Token & {firstChild: string}} */
+	/** 解析列表 */
 	#parseList() {
-		const parseList = require('../parser/list'),
-			lines = this.firstChild.split('\n');
-		for (let i = this.type === 'root' ? 0 : 1; i < lines.length; i++) {
+		if (this.type === 'image-parameter') {
+			return;
+		}
+		const parseList = require('../parser/list');
+		const lines = String(this).split('\n');
+		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'));
 	}
 
+	/** 解析语言变体转换 */
 	#parseConverter() {
 		const parseConverter = require('../parser/converter');
-		this.setText(parseConverter(this.firstChild, this.#config, this.#accum));
+		this.setText(parseConverter(String(this), this.#config, this.#accum));
 	}
 }