wikiparser-node 0.3.1 → 0.5.0

package/src/table/index.js

@@ -2,26 +2,94 @@
 
 const assert = require('assert/strict'),
 	{noWrap} = require('../../util/string'),
-	/** @type {Parser} */ Parser = require('../..'),
+	{generateForChild} = require('../../util/lint'),
+	Parser = require('../..'),
 	Token = require('..'),
 	TrToken = require('./tr'),
 	TdToken = require('./td'),
 	SyntaxToken = require('../syntax'),
 	AttributeToken = require('../attribute');
 
+const openingPattern = /^(?:\{\||\{\{\{\s*!\s*\}\}|\{\{\s*\(!\s*\}\})$/u,
+	closingPattern = /^\n[^\S\n]*(?:\|\}|\{\{\s*!\s*\}\}\}|\{\{\s*!\)\s*\}\})$/u;
+
 /**
- * @param {TableCoords} coords1
- * @param {TableCoords} coords2
+ * 比较两个表格坐标
+ * @param {TableCoords} coords1 坐标1
+ * @param {TableCoords} coords2 坐标2
  */
 const cmpCoords = (coords1, coords2) => {
 	const diff = coords1.row - coords2.row;
 	return diff === 0 ? coords1.column - coords2.column : diff;
 };
-const isRowEnd = /** @param {Token} */ ({type}) => ['tr', 'table-syntax'].includes(type);
+
+/**
+ * 是否是行尾
+ * @param {Token} cell 表格单元格
+ */
+const isRowEnd = ({type}) => type === 'tr' || type === 'table-syntax';
+
+/**
+ * 是否是合并单元格的第一列
+ * @param {TableCoords[]} rowLayout 行布局
+ * @param {number} i 单元格序号
+ * @param {boolean} oneCol 是否仅有一列
+ */
+const isStartCol = (rowLayout, i, oneCol = false) => {
+	const coords = rowLayout[i];
+	return rowLayout[i - 1] !== coords && (!oneCol || rowLayout[i + 1] !== coords);
+};
+
+/**
+ * 设置表格格式
+ * @param {Map<TdToken, boolean>} cells 单元格
+ * @param {string|Record<string, string|boolean>} attr 属性
+ * @param {boolean} multi 是否对所有单元格设置，或是仅对行首单元格设置
+ * @complexity `n`
+ */
+const format = (cells, attr = {}, multi = false) => {
+	for (const [token, start] of cells) {
+		if (multi || start) {
+			if (typeof attr === 'string') {
+				token.setSyntax(attr);
+			} else {
+				for (const [k, v] of Object.entries(attr)) {
+					token.setAttr(k, v);
+				}
+			}
+		}
+	}
+};
+
+/**
+ * 填补缺失单元格
+ * @param {number} y 行号
+ * @param {TrToken} rowToken 表格行
+ * @param {TableCoords[][]} layout 表格布局
+ * @param {number} maxCol 最大列数
+ * @param {Token} token 待填充的单元格
+ * @complexity `n`
+ */
+const fill = (y, rowToken, layout, maxCol, token) => {
+	const rowLayout = layout[y],
+		{childNodes} = rowToken,
+		lastIndex = childNodes.findLastIndex(child => child instanceof TdToken && child.subtype !== 'caption') + 1
+			|| undefined;
+	Parser.run(() => {
+		for (let i = 0; i < maxCol; i++) {
+			if (!rowLayout[i]) {
+				rowToken.insertAt(token.cloneNode(), lastIndex);
+			}
+		}
+	});
+};
 
 /** @extends {Array<TableCoords[]>} */
 class Layout extends Array {
-	/** @complexity `n` */
+	/**
+	 * 打印表格布局
+	 * @complexity `n`
+	 */
 	print() {
 		const hBorders = new Array(this.length + 1).fill().map((_, i) => {
 				const prev = this[i - 1] ?? [],
@@ -37,10 +105,9 @@ class Layout extends Array {
 				// eslint-disable-next-line no-sparse-arrays
 				border = [' ',,, '┌',, '┐', '─', '┬',, '│', '└', '├', '┘', '┤', '┴', '┼'];
 			for (let j = 0; j <= hBorder.length; j++) {
-				/* eslint-disable no-bitwise */
+				// eslint-disable-next-line no-bitwise
 				const bit = (vBorderTop[j] << 3) + (vBorderBottom[j] << 0) + (hBorder[j - 1] << 2) + (hBorder[j] << 1);
 				out += `${border[bit]}${hBorder[j] ? '─' : ' '}`;
-				/* eslint-enable no-bitwise */
 			}
 			out += '\n';
 		}
@@ -55,52 +122,79 @@ class Layout extends Array {
 class TableToken extends TrToken {
 	type = 'table';
 
-	static openingPattern = /^(?:\{\||\{\{\{\s*!\s*\}\}|\{\{\s*\(!\s*\}\})$/;
-	static closingPattern = /^\n[^\S\n]*(?:\|\}|\{\{\s*!\s*\}\}\}|\{\{\s*!\)\s*\}\})$/;
+	/** 表格是否闭合 */
+	get closed() {
+		return this.lastChild.type === 'table-syntax';
+	}
+
+	set closed(closed) {
+		if (closed === true && !this.closed) {
+			this.close(this.closest('parameter') ? '\n{{!)}}' : '\n|}');
+		}
+	}
 
 	/**
-	 * @param {string} syntax
+	 * @param {string} syntax 表格语法
+	 * @param {string} attr 表格属性
 	 * @param {accum} accum
 	 */
 	constructor(syntax, attr = '', config = Parser.getConfig(), accum = []) {
-		super(syntax, attr, config, accum, TableToken.openingPattern);
+		super(syntax, attr, config, accum, openingPattern);
 		this.setAttribute('acceptable', {
 			Token: 2, SyntaxToken: [0, -1], AttributeToken: 1, TdToken: '2:', TrToken: '2:',
 		});
 	}
 
 	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start);
+		if (!this.closed) {
+			errors.push(generateForChild(this.firstChild, this.getRootNode().posFromIndex(start), '未闭合的表格'));
+		}
+		return errors;
+	}
+
+	/**
+	 * @override
 	 * @template {TrToken|SyntaxToken} T
-	 * @param {T} token
+	 * @param {T} token 待插入的子节点
+	 * @param {number} i 插入位置
 	 * @returns {T}
 	 * @complexity `n`
+	 * @throws `SyntaxError` 表格的闭合部分非法
 	 */
 	insertAt(token, i = this.childNodes.length) {
-		const previous = this.children.at(i - 1),
-			{closingPattern} = TableToken;
+		const previous = this.childNodes.at(i - 1);
 		if (token.type === 'td' && previous.type === 'tr') {
 			Parser.warn('改为将单元格插入当前行。');
 			return previous.appendChild(token);
 		} else if (!Parser.running && i === this.childNodes.length && token instanceof SyntaxToken
 			&& (token.getAttribute('pattern') !== closingPattern || !closingPattern.test(token.text()))
 		) {
-			throw new SyntaxError(`表格的闭合部分不符合语法！${noWrap(token.toString())}`);
+			throw new SyntaxError(`表格的闭合部分不符合语法！${noWrap(String(token))}`);
 		}
 		return super.insertAt(token, i);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 闭合表格语法
+	 * @complexity `n`
+	 * @param {string} syntax 表格结尾语法
+	 * @throws `SyntaxError` 表格的闭合部分不符合语法
+	 */
 	close(syntax = '\n|}', halfParsed = false) {
 		halfParsed &&= Parser.running;
 		const config = this.getAttribute('config'),
 			accum = this.getAttribute('accum'),
 			inner = !halfParsed && Parser.parse(syntax, this.getAttribute('include'), 2, config),
-			{lastElementChild} = this,
-			{closingPattern} = TableToken;
+			{lastChild} = this;
 		if (!halfParsed && !closingPattern.test(inner.text())) {
 			throw new SyntaxError(`表格的闭合部分不符合语法！${noWrap(syntax)}`);
-		} else if (lastElementChild instanceof SyntaxToken) {
-			lastElementChild.replaceChildren(...inner.childNodes);
+		} else if (lastChild instanceof SyntaxToken) {
+			lastChild.replaceChildren(...inner.childNodes);
 		} else {
 			this.appendChild(Parser.run(() => {
 				const token = new SyntaxToken(syntax, closingPattern, 'table-syntax', config, accum, {
@@ -115,27 +209,38 @@ class TableToken extends TrToken {
 	}
 
 	/**
+	 * @override
 	 * @returns {number}
 	 * @complexity `n`
 	 */
 	getRowCount() {
 		return super.getRowCount()
-			+ this.children.filter(child => child.type === 'tr' && child.getRowCount()).length;
+			+ this.childNodes.filter(child => child.type === 'tr' && child.getRowCount()).length;
 	}
 
-	getPreviousRow() {}
+	/** @override */
+	getPreviousRow() { // eslint-disable-line class-methods-use-this
+		return undefined;
+	}
 
-	/** @complexity `n` */
+	/**
+	 * @override
+	 * @complexity `n`
+	 */
 	getNextRow() {
 		return this.getNthRow(super.getRowCount() ? 1 : 0);
 	}
 
 	/**
-	 * @param {number} n
+	 * 获取第n行
+	 * @param {number} n 行号
+	 * @param {boolean} force 是否将表格自身视为第一行
+	 * @param {boolean} insert 是否用于判断插入新行的位置
 	 * @returns {TrToken}
 	 * @complexity `n`
+	 * @throws `RangeError` 不存在该行
 	 */
-	getNthRow(n, force = false, insert = false) {
+	getNthRow(n, force, insert) {
 		if (typeof n !== 'number') {
 			this.typeError('getNthRow', 'Number');
 		}
@@ -149,7 +254,7 @@ class TableToken extends TrToken {
 		} else if (isRow) {
 			n--;
 		}
-		for (const child of this.children.slice(2)) {
+		for (const child of this.childNodes.slice(2)) {
 			if (child.type === 'tr' && child.getRowCount()) {
 				n--;
 				if (n < 0) {
@@ -159,21 +264,24 @@ class TableToken extends TrToken {
 				return child;
 			}
 		}
+		return undefined;
 	}
 
 	/**
+	 * 获取所有行
 	 * @returns {TrToken[]}
 	 * @complexity `n`
 	 */
 	getAllRows() {
 		return [
 			...super.getRowCount() ? [this] : [],
-			...this.children.filter(child => child.type === 'tr' && child.getRowCount()),
+			...this.childNodes.filter(child => child.type === 'tr' && child.getRowCount()),
 		];
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 获取指定坐标的单元格
+	 * @param {TableCoords & TableRenderedCoords} coords 表格坐标
 	 * @complexity `n`
 	 */
 	getNthCell(coords) {
@@ -184,14 +292,15 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} stop
+	 * 获取表格布局
+	 * @param {TableCoords & TableRenderedCoords} stop 中止条件
 	 * @complexity `n`
 	 */
 	getLayout(stop = {}) {
 		const rows = this.getAllRows(),
 			{length} = rows,
 			/** @type {Layout} */ layout = new Layout(length).fill().map(() => []);
-		for (const [i, rowToken] of rows.entries()) {
+		for (let i = 0; i < length; i++) {
 			if (i > (stop.row ?? stop.y)) {
 				break;
 			}
@@ -199,7 +308,7 @@ class TableToken extends TrToken {
 			let j = 0,
 				k = 0,
 				last;
-			for (const cell of rowToken.children.slice(2)) {
+			for (const cell of rows[i].childNodes.slice(2)) {
 				if (cell instanceof TdToken) {
 					if (cell.isIndependent()) {
 						last = cell.subtype !== 'caption';
@@ -233,13 +342,17 @@ class TableToken extends TrToken {
 		return layout;
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 打印表格布局
+	 * @complexity `n`
+	 */
 	printLayout() {
 		this.getLayout().print();
 	}
 
 	/**
-	 * @param {TableCoords}
+	 * 转换为渲染后的表格坐标
+	 * @param {TableCoords} coord wikitext中的表格坐标
 	 * @returns {TableRenderedCoords}
 	 * @complexity `n`
 	 */
@@ -253,7 +366,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableRenderedCoords}
+	 * 转换为wikitext中的表格坐标
+	 * @param {TableRenderedCoords} coord 渲染后的表格坐标
 	 * @complexity `n`
 	 */
 	toRawCoords({x, y}) {
@@ -264,15 +378,17 @@ class TableToken extends TrToken {
 			coords = rowLayout?.[x];
 		if (coords) {
 			return {...coords, start: coords.row === y && rowLayout[x - 1] !== coords};
-		} else if (!rowLayout && y === 0) {
-			return {row: 0, column: 0, start: true};
-		} else if (x === rowLayout?.length) {
-			return {row: y, column: (rowLayout.findLast(({row}) => row === y)?.column ?? -1) + 1, start: true};
+		} else if (rowLayout || y > 0) {
+			return x === rowLayout?.length
+				? {row: y, column: (rowLayout.findLast(({row}) => row === y)?.column ?? -1) + 1, start: true}
+				: undefined;
 		}
+		return {row: 0, column: 0, start: true};
 	}
 
 	/**
-	 * @param {number} y
+	 * 获取完整行
+	 * @param {number} y 行号
 	 * @complexity `n²`
 	 */
 	getFullRow(y) {
@@ -286,7 +402,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
+	 * 获取完整列
+	 * @param {number} x 列号
 	 * @complexity `n`
 	 */
 	getFullCol(x) {
@@ -294,7 +411,7 @@ class TableToken extends TrToken {
 			this.typeError('getFullCol', 'Number');
 		}
 		const layout = this.getLayout(),
-			colLayout = layout.map(row => row[x]).filter(coords => coords),
+			colLayout = layout.map(row => row[x]).filter(Boolean),
 			rows = this.getAllRows();
 		return new Map(
 			colLayout.map(coords => [rows[coords.row].getNthCol(coords.column), layout[coords.row][x - 1] !== coords]),
@@ -302,69 +419,33 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {Map<TdToken, boolean>} cells
-	 * @param {string|Record<string, string|boolean>} attr
-	 * @complexity `n`
-	 */
-	#format(cells, attr = {}, multi = false) {
-		for (const [token, start] of cells) {
-			if (multi || start) {
-				if (typeof attr === 'string') {
-					token.setSyntax(attr);
-				} else {
-					for (const [k, v] of Object.entries(attr)) {
-						token.setAttr(k, v);
-					}
-				}
-			}
-		}
-	}
-
-	/**
-	 * @param {number} y
-	 * @param {string|Record<string, string|boolean>} attry
+	 * 设置行格式
+	 * @param {number} y 行号
+	 * @param {string|Record<string, string|boolean>} attr 表格属性
+	 * @param {boolean} multiRow 是否对所有单元格设置，或是仅对行首单元格设置
 	 * @complexity `n²`
 	 */
 	formatTableRow(y, attr = {}, multiRow = false) {
-		this.#format(this.getFullRow(y), attr, multiRow);
+		format(this.getFullRow(y), attr, multiRow);
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {string|Record<string, string|boolean>} attry
+	 * 设置列格式
+	 * @param {number} x 列号
+	 * @param {string|Record<string, string|boolean>} attr 表格属性
+	 * @param {boolean} multiCol 是否对所有单元格设置，或是仅对行首单元格设置
 	 * @complexity `n`
 	 */
 	formatTableCol(x, attr = {}, multiCol = false) {
-		this.#format(this.getFullCol(x), attr, multiCol);
+		format(this.getFullCol(x), attr, multiCol);
 	}
 
 	/**
-	 * @param {number} y
-	 * @param {TrToken} rowToken
-	 * @param {TableCoords[][]} layout
-	 * @param {number} maxCol
-	 * @param {Token} token
-	 * @complexity `n`
-	 */
-	#fill(y, rowToken, layout, maxCol, token) {
-		const rowLayout = layout[y],
-			{childNodes} = rowToken;
-		let lastIndex = childNodes.findLastIndex(child => child instanceof TdToken && child.subtype !== 'caption');
-		lastIndex = lastIndex === -1 ? undefined : lastIndex - childNodes.length;
-		Parser.run(() => {
-			for (let i = 0; i < maxCol; i++) {
-				if (!rowLayout[i]) {
-					rowToken.insertAt(token.cloneNode(), lastIndex);
-				}
-			}
-		});
-	}
-
-	/**
-	 * @param {number} y
-	 * @param {string|Token} inner
-	 * @param {'td'|'th'|'caption'} subtype
-	 * @param {Record<string, string>} attr
+	 * 填补表格行
+	 * @param {number} y 行号
+	 * @param {string|Token} inner 填充内容
+	 * @param {'td'|'th'|'caption'} subtype 单元格类型
+	 * @param {Record<string, string>} attr 表格属性
 	 * @complexity `n`
 	 */
 	fillTableRow(y, inner, subtype = 'td', attr = {}) {
@@ -372,13 +453,14 @@ class TableToken extends TrToken {
 			layout = this.getLayout({y}),
 			maxCol = Math.max(...layout.map(row => row.length)),
 			token = TdToken.create(inner, subtype, attr, this.getAttribute('include'), this.getAttribute('config'));
-		this.#fill(y, rowToken, layout, maxCol, token);
+		fill(y, rowToken, layout, maxCol, token);
 	}
 
 	/**
-	 * @param {string|Token} inner
-	 * @param {'td'|'th'|'caption'} subtype
-	 * @param {Record<string, string>} attr
+	 * 填补表格
+	 * @param {string|Token} inner 填充内容
+	 * @param {'td'|'th'|'caption'} subtype 单元格类型
+	 * @param {Record<string, string>} attr 表格属性
 	 * @complexity `n`
 	 */
 	fillTable(inner, subtype = 'td', attr = {}) {
@@ -386,18 +468,20 @@ class TableToken extends TrToken {
 			layout = this.getLayout(),
 			maxCol = Math.max(...layout.map(({length}) => length)),
 			token = TdToken.create(inner, subtype, attr, this.getAttribute('include'), this.getAttribute('config'));
-		for (const [y, rowToken] of rowTokens.entries()) {
-			this.#fill(y, rowToken, layout, maxCol, token);
+		for (let y = 0; y < rowTokens.length; y++) {
+			fill(y, rowTokens[y], layout, maxCol, token);
 		}
 	}
 
 	/**
-	 * @param {string|Token} inner
-	 * @param {TableCoords & TableRenderedCoords} coords
-	 * @param {'td'|'th'|'caption'} subtype
-	 * @param {Record<string, string|boolean>} attr
+	 * @override
+	 * @param {string|Token} inner 单元格内部wikitext
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
+	 * @param {'td'|'th'|'caption'} subtype 单元格类型
+	 * @param {Record<string, string|boolean>} attr 单元格属性
 	 * @returns {TdToken}
 	 * @complexity `n`
+	 * @throws `RangeError` 指定的坐标不是单元格起始点
 	 */
 	insertTableCell(inner, coords, subtype = 'td', attr = {}) {
 		if (coords.column === undefined) {
@@ -408,19 +492,21 @@ class TableToken extends TrToken {
 			}
 		}
 		const rowToken = this.getNthRow(coords.row ?? 0, true);
-		if (rowToken === this) {
-			return super.insertTableCell(inner, coords, subtype, attr);
-		}
-		return rowToken.insertTableCell(inner, coords, subtype, attr);
+		return rowToken === this
+			? super.insertTableCell(inner, coords, subtype, attr)
+			: rowToken.insertTableCell(inner, coords, subtype, attr);
 	}
 
-	/** @complexity `n` */
+	/**
+	 * 在开头插入一行
+	 * @complexity `n`
+	 */
 	#prependTableRow() {
 		const row = Parser.run(() => new TrToken('\n|-', undefined, this.getAttribute('config'))),
-			{children} = this,
-			[,, plain] = children,
+			{childNodes} = this,
+			[,, plain] = childNodes,
 			start = plain?.isPlain() ? 3 : 2,
-			/** @type {TdToken[]} */ tdChildren = children.slice(start),
+			/** @type {TdToken[]} */ tdChildren = childNodes.slice(start),
 			index = tdChildren.findIndex(({type}) => type !== 'td');
 		this.insertAt(row, index === -1 ? -1 : index + start);
 		Parser.run(() => {
@@ -434,11 +520,12 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} y
-	 * @param {Record<string, string|boolean>} attr
-	 * @param {string|Token} inner
-	 * @param {'td'|'th'|'caption'} subtype
-	 * @param {Record<string, string|boolean>} attr
+	 * 插入表格行
+	 * @param {number} y 行号
+	 * @param {Record<string, string|boolean>} attr 表格行属性
+	 * @param {string|Token} inner 内部wikitext
+	 * @param {'td'|'th'|'caption'} subtype 单元格类型
+	 * @param {Record<string, string|boolean>} innerAttr 单元格属性
 	 * @complexity `n`
 	 */
 	insertTableRow(y, attr = {}, inner = undefined, subtype = 'td', innerAttr = {}) {
@@ -479,11 +566,13 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {string|Token} inner
-	 * @param {'td'|'th'|'caption'} subtype
-	 * @param {Record<string, string>} attr
+	 * 插入表格列
+	 * @param {number} x 列号
+	 * @param {string|Token} inner 内部wikitext
+	 * @param {'td'|'th'|'caption'} subtype 单元格类型
+	 * @param {Record<string, string>} attr 单元格属性
 	 * @complexity `n²`
+	 * @throws `RangeError` 列号过大
 	 */
 	insertTableCol(x, inner, subtype = 'td', attr = {}) {
 		if (typeof x !== 'number') {
@@ -511,14 +600,17 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} y
+	 * 移除表格行
+	 * @param {number} y 行号
 	 * @complexity `n²`
 	 */
 	removeTableRow(y) {
 		const rows = this.getAllRows(),
 			layout = this.getLayout(),
+			rowLayout = layout[y],
 			/** @type {Set<TableCoords>} */ set = new Set();
-		for (const [x, coords] of [...layout[y].entries()].reverse()) {
+		for (let x = rowLayout.length - 1; x >= 0; x--) {
+			const coords = rowLayout[x];
 			if (set.has(coords)) {
 				continue;
 			}
@@ -546,16 +638,17 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
+	 * 移除表格列
+	 * @param {number} x 列号
 	 * @complexity `n²`
 	 */
 	removeTableCol(x) {
 		for (const [token, start] of this.getFullCol(x)) {
-			const {colspan} = token;
+			const {colspan, lastChild} = token;
 			if (colspan > 1) {
 				token.colspan = colspan - 1;
 				if (start) {
-					token.lastElementChild.replaceChildren();
+					lastChild.replaceChildren();
 				}
 			} else {
 				token.remove();
@@ -564,9 +657,11 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {[number, number]} xlim
-	 * @param {[number, number]} ylim
+	 * 合并单元格
+	 * @param {[number, number]} xlim 列范围
+	 * @param {[number, number]} ylim 行范围
 	 * @complexity `n²`
+	 * @throws `RangeError` 待合并区域与外侧区域有重叠
 	 */
 	mergeCells(xlim, ylim) {
 		if ([...xlim, ...ylim].some(arg => typeof arg !== 'number')) {
@@ -597,9 +692,11 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
-	 * @param {Set<'rowspan'|'colspan'>} dirs
+	 * 分裂单元格
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
+	 * @param {Set<'rowspan'|'colspan'>} dirs 分裂方向
 	 * @complexity `n²`
+	 * @throws `RangeError` 指定的坐标不是单元格起始点
 	 */
 	#split(coords, dirs) {
 		const cell = this.getNthCell(coords),
@@ -634,10 +731,10 @@ class TableToken extends TrToken {
 					try {
 						this.insertTableCell('', {x: i, y: j}, subtype, attr);
 					} catch (e) {
-						if (!(e instanceof RangeError) || !e.message.startsWith('指定的坐标不是单元格起始点：')) {
-							throw e;
+						if (e instanceof RangeError && e.message.startsWith('指定的坐标不是单元格起始点：')) {
+							break;
 						}
-						break;
+						throw e;
 					}
 				}
 			}
@@ -645,7 +742,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 分裂成多行
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
 	 * @complexity `n²`
 	 */
 	splitIntoRows(coords) {
@@ -653,7 +751,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 分裂成多列
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
 	 * @complexity `n²`
 	 */
 	splitIntoCols(coords) {
@@ -661,7 +760,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 分裂成单元格
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
 	 * @complexity `n²`
 	 */
 	splitIntoCells(coords) {
@@ -670,7 +770,7 @@ class TableToken extends TrToken {
 
 	/**
 	 * 复制一行并插入该行之前
-	 * @param {number} row
+	 * @param {number} row 行号
 	 * @complexity `n²`
 	 */
 	replicateTableRow(row) {
@@ -691,7 +791,7 @@ class TableToken extends TrToken {
 
 	/**
 	 * 复制一列并插入该列之前
-	 * @param {number} x
+	 * @param {number} x 列号
 	 * @complexity `n`
 	 */
 	replicateTableCol(x) {
@@ -710,20 +810,23 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} y
-	 * @param {number} before
+	 * 移动表格行
+	 * @param {number} y 行号
+	 * @param {number} before 新位置
 	 * @complexity `n²`
+	 * @throws `RangeError` 无法移动
 	 */
 	moveTableRowBefore(y, before) {
 		if (typeof y !== 'number' || typeof before !== 'number') {
 			this.typeError('moveTableRowBefore', 'Number');
 		}
-		const layout = this.getLayout(),
-			/**
-			 * @type {(i: number) => number[]}
-			 * @complexity `n`
-			 */
-			occupied = i => layout[i].map(({row}, j) => row === i ? j : null).filter(j => j !== null);
+		const layout = this.getLayout();
+
+		/**
+		 * @type {(i: number) => number[]}
+		 * @complexity `n`
+		 */
+		const occupied = i => layout[i].map(({row}, j) => row === i ? j : null).filter(j => j !== null);
 		try {
 			assert.deepStrictEqual(occupied(y), occupied(before));
 		} catch (e) {
@@ -747,9 +850,11 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} y
-	 * @param {number} after
+	 * 移动表格行
+	 * @param {number} y 行号
+	 * @param {number} after 新位置
 	 * @complexity `n²`
+	 * @throws `RangeError` 无法移动
 	 */
 	moveTableRowAfter(y, after) {
 		if (typeof y !== 'number' || typeof after !== 'number') {
@@ -758,14 +863,15 @@ class TableToken extends TrToken {
 		const layout = this.getLayout(),
 			afterToken = this.getNthRow(after),
 			/** @type {TdToken[]} */
-			cells = afterToken.children.filter(child => child instanceof TdToken && child.subtype !== 'caption'),
-			/**
-			 * @type {(i: number, oneRow?: boolean) => number[]}
-			 * @complexity `n`
-			 */
-			occupied = (i, oneRow = false) => layout[i].map(({row, column}, j) =>
-				row === i && (!oneRow || cells[column].rowspan === 1) ? j : null,
-			).filter(j => j !== null);
+			cells = afterToken.childNodes.filter(child => child instanceof TdToken && child.subtype !== 'caption');
+
+		/**
+		 * @type {(i: number, oneRow?: boolean) => number[]}
+		 * @complexity `n`
+		 */
+		const occupied = (i, oneRow = false) => layout[i].map(
+			({row, column}, j) => row === i && (!oneRow || cells[column].rowspan === 1) ? j : null,
+		).filter(j => j !== null);
 		try {
 			assert.deepStrictEqual(occupied(y), occupied(after, true));
 		} catch (e) {
@@ -796,30 +902,29 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {number} reference
+	 * 移动表格列
+	 * @param {number} x 列号
+	 * @param {number} reference 新位置
+	 * @param {boolean} after 在新位置之后或之前
 	 * @complexity `n`
+	 * @throws `RangeError` 无法移动
 	 */
 	#moveCol(x, reference, after = false) {
 		if (typeof x !== 'number' || typeof reference !== 'number') {
 			this.typeError(`moveTableCol${after ? 'After' : 'Before'}`, 'Number');
 		}
-		const layout = this.getLayout(),
-			/** @type {(rowLayout: TableCoords[], i: number, oneCol?: boolean) => boolean} */
-			isStart = (rowLayout, i, oneCol = false) => {
-				const coords = rowLayout[i];
-				return rowLayout[i - 1] !== coords && (!oneCol || rowLayout[i + 1] !== coords);
-			};
-		if (layout.some(rowLayout => isStart(rowLayout, x) !== isStart(rowLayout, reference, after))) {
+		const layout = this.getLayout();
+		if (layout.some(rowLayout => isStartCol(rowLayout, x) !== isStartCol(rowLayout, reference, after))) {
 			throw new RangeError(`第 ${x} 列与第 ${reference} 列的构造不同，无法移动！`);
 		}
 		const /** @type {Set<TableCoords>} */ setX = new Set(),
 			/** @type {Set<TableCoords>} */ setRef = new Set(),
 			rows = this.getAllRows();
-		for (const [i, rowLayout] of layout.entries()) {
-			const coords = rowLayout[x],
+		for (let i = 0; i < layout.length; i++) {
+			const rowLayout = layout[i],
+				coords = rowLayout[x],
 				refCoords = rowLayout[reference],
-				start = isStart(rowLayout, x);
+				start = isStartCol(rowLayout, x);
 			if (refCoords && !start && !setRef.has(refCoords)) {
 				setRef.add(refCoords);
 				rows[refCoords.row].getNthCol(refCoords.column).colspan++;
@@ -834,15 +939,16 @@ class TableToken extends TrToken {
 					if (start) {
 						const original = token;
 						token = token.cloneNode();
-						original.lastElementChild.replaceChildren();
+						original.lastChild.replaceChildren();
 						token.colspan = 1;
 					}
 				}
 				if (start) {
 					const col = rowLayout.slice(reference + Number(after)).find(({row}) => row === i)?.column;
-					rowToken.insertBefore(token, col === undefined && rowToken.type === 'table'
-						? rowToken.children.slice(2).find(isRowEnd)
-						: col !== undefined && rowToken.getNthCol(col),
+					rowToken.insertBefore(
+						token, col === undefined && rowToken.type === 'table'
+							? rowToken.childNodes.slice(2).find(isRowEnd)
+							: col !== undefined && rowToken.getNthCol(col),
 					);
 				}
 			}
@@ -850,8 +956,9 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {number} before
+	 * 移动表格列
+	 * @param {number} x 列号
+	 * @param {number} before 新位置
 	 * @complexity `n`
 	 */
 	moveTableColBefore(x, before) {
@@ -859,8 +966,9 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {number} after
+	 * 移动表格列
+	 * @param {number} x 列号
+	 * @param {number} after 新位置
 	 * @complexity `n`
 	 */
 	moveTableColAfter(x, after) {