wikiparser-node 0.3.0 → 0.4.0

package/src/table/index.js

@@ -2,26 +2,93 @@
 
 const assert = require('assert/strict'),
 	{noWrap} = require('../../util/string'),
-	/** @type {Parser} */ Parser = require('../..'),
+	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 +104,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,48 +121,63 @@ 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.lastElementChild.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
 	 * @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.children.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;
+			{lastElementChild} = this;
 		if (!halfParsed && !closingPattern.test(inner.text())) {
 			throw new SyntaxError(`表格的闭合部分不符合语法！${noWrap(syntax)}`);
 		} else if (lastElementChild instanceof SyntaxToken) {
@@ -115,6 +196,7 @@ class TableToken extends TrToken {
 	}
 
 	/**
+	 * @override
 	 * @returns {number}
 	 * @complexity `n`
 	 */
@@ -123,19 +205,29 @@ class TableToken extends TrToken {
 			+ this.children.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');
 		}
@@ -159,9 +251,11 @@ class TableToken extends TrToken {
 				return child;
 			}
 		}
+		return undefined;
 	}
 
 	/**
+	 * 获取所有行
 	 * @returns {TrToken[]}
 	 * @complexity `n`
 	 */
@@ -173,7 +267,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 获取指定坐标的单元格
+	 * @param {TableCoords & TableRenderedCoords} coords 表格坐标
 	 * @complexity `n`
 	 */
 	getNthCell(coords) {
@@ -184,14 +279,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 +295,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].children.slice(2)) {
 				if (cell instanceof TdToken) {
 					if (cell.isIndependent()) {
 						last = cell.subtype !== 'caption';
@@ -233,13 +329,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 +353,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableRenderedCoords}
+	 * 转换为wikitext中的表格坐标
+	 * @param {TableRenderedCoords} coord 渲染后的表格坐标
 	 * @complexity `n`
 	 */
 	toRawCoords({x, y}) {
@@ -266,13 +367,15 @@ class TableToken extends TrToken {
 			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};
 		}
+		return x === rowLayout?.length
+			? {row: y, column: (rowLayout.findLast(({row}) => row === y)?.column ?? -1) + 1, start: true}
+			: undefined;
 	}
 
 	/**
-	 * @param {number} y
+	 * 获取完整行
+	 * @param {number} y 行号
 	 * @complexity `n²`
 	 */
 	getFullRow(y) {
@@ -286,7 +389,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
+	 * 获取完整列
+	 * @param {number} x 列号
 	 * @complexity `n`
 	 */
 	getFullCol(x) {
@@ -294,7 +398,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 +406,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 +440,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,35 +455,39 @@ 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) {
 			const {x, y} = coords;
 			coords = this.toRawCoords(coords);
-			if (!coords?.start) {
+			if (!coords?.start) { // eslint-disable-line unicorn/consistent-destructuring
 				throw new RangeError(`指定的坐标不是单元格起始点：(${x}, ${y})`);
 			}
 		}
 		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,
@@ -434,11 +507,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 +553,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 +587,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 +625,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, lastElementChild} = token;
 			if (colspan > 1) {
 				token.colspan = colspan - 1;
 				if (start) {
-					token.lastElementChild.replaceChildren();
+					lastElementChild.replaceChildren();
 				}
 			} else {
 				token.remove();
@@ -564,9 +644,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 +679,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),
@@ -619,7 +703,7 @@ class TableToken extends TrToken {
 		if (x !== undefined) {
 			coords = this.toRawCoords(coords);
 		}
-		if (coords.start === false || x === undefined) {
+		if (coords.start === false || x === undefined) { // eslint-disable-line unicorn/consistent-destructuring
 			({x, y} = this.toRenderedCoords(coords));
 		}
 		const splitting = {rowspan: 1, colspan: 1};
@@ -634,10 +718,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 +729,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 分裂成多行
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
 	 * @complexity `n²`
 	 */
 	splitIntoRows(coords) {
@@ -653,7 +738,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 分裂成多列
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
 	 * @complexity `n²`
 	 */
 	splitIntoCols(coords) {
@@ -661,7 +747,8 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {TableCoords & TableRenderedCoords} coords
+	 * 分裂成单元格
+	 * @param {TableCoords & TableRenderedCoords} coords 单元格坐标
 	 * @complexity `n²`
 	 */
 	splitIntoCells(coords) {
@@ -670,7 +757,7 @@ class TableToken extends TrToken {
 
 	/**
 	 * 复制一行并插入该行之前
-	 * @param {number} row
+	 * @param {number} row 行号
 	 * @complexity `n²`
 	 */
 	replicateTableRow(row) {
@@ -691,7 +778,7 @@ class TableToken extends TrToken {
 
 	/**
 	 * 复制一列并插入该列之前
-	 * @param {number} x
+	 * @param {number} x 列号
 	 * @complexity `n`
 	 */
 	replicateTableCol(x) {
@@ -710,20 +797,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 +837,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 +850,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.children.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 +889,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++;
@@ -840,9 +932,10 @@ class TableToken extends TrToken {
 				}
 				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.children.slice(2).find(isRowEnd)
+							: col !== undefined && rowToken.getNthCol(col),
 					);
 				}
 			}
@@ -850,8 +943,9 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {number} before
+	 * 移动表格列
+	 * @param {number} x 列号
+	 * @param {number} before 新位置
 	 * @complexity `n`
 	 */
 	moveTableColBefore(x, before) {
@@ -859,8 +953,9 @@ class TableToken extends TrToken {
 	}
 
 	/**
-	 * @param {number} x
-	 * @param {number} after
+	 * 移动表格列
+	 * @param {number} x 列号
+	 * @param {number} after 新位置
 	 * @complexity `n`
 	 */
 	moveTableColAfter(x, after) {