wikiparser-node 0.8.1 → 0.9.0-m

package/src/table/td.js

@@ -1,21 +1,15 @@
 'use strict';
 
 const {generateForChild} = require('../../util/lint'),
-	fixedToken = require('../../mixin/fixedToken'),
-	{typeError} = require('../../util/debug'),
-	{isPlainObject} = require('../../util/base'),
 	Parser = require('../..'),
 	Token = require('..'),
 	TrToken = require('./tr');
 
-const aliases = {td: '\n|', th: '\n!', caption: '\n|+'},
-	openingPattern = /^(?:\n[\S\n]*(?:[|!]|\|\+|\{\{\s*!\s*\}\}\+?)|(?:\||\{\{\s*!\s*\}\}){2}|!!|\{\{\s*!!\s*\}\})$/u;
-
 /**
  * `<td>`、`<th>`和`<caption>`
  * @classdesc `{childNodes: [SyntaxToken, AttributesToken, Token]}`
  */
-class TdToken extends fixedToken(TrToken) {
+class TdToken extends TrToken {
 	type = 'td';
 	#innerSyntax = '';
 
@@ -27,46 +21,13 @@ class TdToken extends fixedToken(TrToken) {
 		return this.getSyntax().subtype;
 	}
 
-	set subtype(subtype) {
-		this.setSyntax(subtype);
-	}
-
-	/** rowspan */
-	get rowspan() {
-		return this.getAttr('rowspan');
-	}
-
-	set rowspan(rowspan) {
-		this.setAttr('rowspan', rowspan);
-	}
-
-	/** colspan */
-	get colspan() {
-		return this.getAttr('colspan');
-	}
-
-	set colspan(colspan) {
-		this.setAttr('colspan', colspan);
-	}
-
-	/** 内部wikitext */
-	get innerText() {
-		return this.lastChild.text();
-	}
-
-	/** 是否位于行首 */
-	isIndependent() {
-		return this.firstChild.text()[0] === '\n';
-	}
-
 	/**
 	 * 获取单元格语法信息
-	 * @returns {{subtype: 'td'|'th'|'caption', escape: boolean, correction: boolean}}
+	 * @returns {{subtype: 'td'|'th'|'caption'}}
 	 * @complexity `n`
 	 */
 	getSyntax() {
 		const syntax = this.firstChild.text(),
-			esc = syntax.includes('{{'),
 			char = syntax.at(-1);
 		let subtype = 'td';
 		if (char === '!') {
@@ -74,23 +35,7 @@ class TdToken extends fixedToken(TrToken) {
 		} else if (char === '+') {
 			subtype = 'caption';
 		}
-		if (this.isIndependent()) {
-			return {subtype, escape: esc, correction: false};
-		}
-		const {previousSibling} = this;
-		if (previousSibling?.type !== 'td') {
-			return {subtype, escape: esc, correction: true};
-		}
-		const result = previousSibling.getSyntax();
-		result.escape ||= esc;
-		result.correction = previousSibling.lastChild
-			.toString('comment, ext, include, noinclude, arg, template, magic-word')
-			.includes('\n');
-		if (subtype === 'th' && result.subtype !== 'th') {
-			result.subtype = 'th';
-			result.correction = true;
-		}
-		return result;
+		return {subtype};
 	}
 
 	/**
@@ -105,7 +50,7 @@ class TdToken extends fixedToken(TrToken) {
 			innerSyntax = undefined;
 			attr = '';
 		}
-		super(syntax, attr, config, accum, openingPattern);
+		super(syntax, attr, config, accum);
 		if (innerSyntax) {
 			[this.#innerSyntax] = innerSyntax;
 		}
@@ -113,8 +58,6 @@ class TdToken extends fixedToken(TrToken) {
 		const innerToken = new Token(inner?.slice(innerSyntax?.index + this.#innerSyntax.length), config, true, accum);
 		innerToken.type = 'td-inner';
 		this.insertAt(innerToken.setAttribute('stage', 4));
-		this.setAttribute('acceptable', {SyntaxToken: 0, AttributesToken: 1, Token: 2})
-			.seal(['getRowCount', 'getNthCol', 'insertTableCell'], true);
 	}
 
 	/** @override */
@@ -126,16 +69,12 @@ class TdToken extends fixedToken(TrToken) {
 
 	/**
 	 * @override
-	 * @param {string} selector
 	 * @returns {string}
 	 * @complexity `n`
 	 */
 	toString(selector) {
-		this.#correct();
 		const {childNodes: [syntax, attr, inner]} = this;
-		return selector && this.matches(selector)
-			? ''
-			: `${syntax.toString(selector)}${attr.toString(selector)}${this.#innerSyntax}${inner.toString(selector)}`;
+		return `${syntax.toString()}${attr.toString()}${this.#innerSyntax}${inner.toString()}`;
 	}
 
 	/**
@@ -144,7 +83,6 @@ class TdToken extends fixedToken(TrToken) {
 	 * @complexity `n`
 	 */
 	text() {
-		this.#correct();
 		const {childNodes: [syntax, attr, inner]} = this;
 		return `${syntax.text()}${attr.text()}${this.#innerSyntax}${inner.text()}`;
 	}
@@ -156,7 +94,6 @@ class TdToken extends fixedToken(TrToken) {
 	getGaps(i = 0) {
 		i = i < 0 ? i + this.length : i;
 		if (i === 1) {
-			this.#correct();
 			return this.#innerSyntax.length;
 		}
 		return 0;
@@ -166,174 +103,16 @@ class TdToken extends fixedToken(TrToken) {
 	 * @override
 	 * @param {number} start 起始位置
 	 */
-	lint(start = 0) {
-		const errors = super.lint(start),
-			{lastChild} = this;
+	lint(start = this.getAbsoluteIndex()) {
+		const errors = super.lint(start);
 		start += this.getRelativeIndex(-1);
-		for (const child of lastChild.childNodes) {
+		for (const child of this.lastChild.childNodes) {
 			if (child.type === 'text' && child.data.includes('|')) {
-				errors.push(generateForChild(child, {start}, '表格单元格中多余的"|"', 'warning'));
+				errors.push(generateForChild(child, {start}, 'additional "|" in a table cell', 'warning'));
 			}
 		}
 		return errors;
 	}
-
-	/** @override */
-	print() {
-		const {childNodes: [syntax, attr, inner]} = this;
-		return `<span class="wpb-td">${syntax.print()}${attr.print()}${this.#innerSyntax}${inner.print()}</span>`;
-	}
-
-	/** @override */
-	cloneNode() {
-		const /** @type {TdToken} */ token = super.cloneNode();
-		token.setAttribute('innerSyntax', this.#innerSyntax);
-		return token;
-	}
-
-	/**
-	 * 创建新的单元格
-	 * @param {string|Token} inner 内部wikitext
-	 * @param {'td'|'th'|'caption'} subtype 单元格类型
-	 * @param {Record<string, string>} attr 单元格属性
-	 * @param {boolean} include 是否嵌入
-	 * @throws `RangeError` 非法的单元格类型
-	 */
-	static create(inner, subtype = 'td', attr = {}, include = false, config = Parser.getConfig()) {
-		if (typeof inner !== 'string' && inner?.constructor !== Token || !isPlainObject(attr)) {
-			typeError(this, 'create', 'String', 'Token', 'Object');
-		} else if (subtype !== 'td' && subtype !== 'th' && subtype !== 'caption') {
-			throw new RangeError('单元格的子类型只能为 "td"、"th" 或 "caption"！');
-		} else if (typeof inner === 'string') {
-			inner = Parser.parse(inner, include, undefined, config);
-		}
-		const token = Parser.run(() => new TdToken('\n|', undefined, config));
-		token.setSyntax(subtype);
-		token.lastChild.safeReplaceWith(inner);
-		for (const [k, v] of Object.entries(attr)) {
-			token.setAttr(k, v);
-		}
-		return token;
-	}
-
-	/**
-	 * @override
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @returns {TokenAttribute<T>}
-	 */
-	getAttribute(key) {
-		return key === 'innerSyntax' ? this.#innerSyntax : super.getAttribute(key);
-	}
-
-	/**
-	 * @override
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @param {TokenAttribute<T>} value 属性值
-	 * @returns {this}
-	 */
-	setAttribute(key, value) {
-		if (key === 'innerSyntax') {
-			this.#innerSyntax = String(value);
-			return this;
-		}
-		return super.setAttribute(key, value);
-	}
-
-	/**
-	 * @override
-	 * @param {string} syntax 表格语法
-	 * @param {boolean} esc 是否需要转义
-	 */
-	setSyntax(syntax, esc) {
-		super.setSyntax(aliases[syntax] ?? syntax, esc);
-	}
-
-	/**
-	 * 修复\<td\>语法
-	 * @complexity `n`
-	 */
-	#correct() {
-		if (String(this.childNodes[1])) {
-			this.#innerSyntax ||= '|';
-		}
-		const {subtype, escape, correction} = this.getSyntax();
-		if (correction) {
-			this.setSyntax(subtype, escape);
-		}
-	}
-
-	/**
-	 * 改为独占一行
-	 * @complexity `n`
-	 */
-	independence() {
-		if (!this.isIndependent()) {
-			const {subtype, escape} = this.getSyntax();
-			this.setSyntax(subtype, escape);
-		}
-	}
-
-	/**
-	 * 获取单元格属性
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @returns {T extends 'rowspan'|'colspan' ? number : string|true}
-	 */
-	getAttr(key) {
-		const /** @type {string|true} */ value = super.getAttr(key);
-		key = key?.toLowerCase()?.trim();
-		return key === 'rowspan' || key === 'colspan' ? Number(value) || 1 : value;
-	}
-
-	/**
-	 * 获取全部单元格属性
-	 * @returns {{rowspan: number, colspan: number, [key: string]: string|true}}
-	 */
-	getAttrs() {
-		const /** @type {record<string, string|true>} */ attr = super.getAttrs();
-		if ('rowspan' in attr) {
-			attr.rowspan = Number(attr.rowspan);
-		}
-		if ('colspan' in attr) {
-			attr.colspan = Number(attr.colspan);
-		}
-		return attr;
-	}
-
-	/**
-	 * 设置单元格属性
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @param {T extends 'rowspan'|'colspan' ? number : string|boolean} value 属性值
-	 */
-	setAttr(key, value) {
-		if (typeof key !== 'string') {
-			this.typeError('setAttr', 'String');
-		}
-		key = key.toLowerCase().trim();
-		if (typeof value === 'number' && (key === 'rowspan' || key === 'colspan')) {
-			value = value === 1 ? false : String(value);
-		}
-		const /** @type {boolean} */ result = super.setAttr(key, value);
-		if (!String(this.childNodes[1])) {
-			this.#innerSyntax = '';
-		}
-		return result;
-	}
-
-	/** @override */
-	escape() {
-		super.escape();
-		if (String(this.childNodes[1])) {
-			this.#innerSyntax ||= '{{!}}';
-		}
-		if (this.#innerSyntax === '|') {
-			this.#innerSyntax = '{{!}}';
-		}
-	}
 }
 
-Parser.classes.TdToken = __filename;
 module.exports = TdToken;

package/src/table/tr.js

@@ -1,35 +1,16 @@
 'use strict';
 
 const {generateForChild} = require('../../util/lint'),
-	attributeParent = require('../../mixin/attributeParent'),
 	Parser = require('../..'),
-	AstText = require('../../lib/text'),
 	Token = require('..'),
 	SyntaxToken = require('../syntax'),
 	AttributesToken = require('../attributes');
 
-const openingPattern = /^\n[^\S\n]*(?:\|-+|\{\{\s*!\s*\}\}-+|\{\{\s*!-\s*\}\}-*)$/u;
-
-/**
- * 转义表格语法
- * @param {SyntaxToken} syntax 表格语法节点
- */
-const escapeTable = syntax => {
-	const templates = {'{|': '(!', '|}': '!)', '||': '!!', '|': '!'},
-		wikitext = syntax.childNodes.map(
-			child => child.type === 'text'
-				? String(child).replace(/\{\||\|\}|\|{2}|\|/gu, p => `{{${templates[p]}}}`)
-				: String(child),
-		).join(''),
-		token = Parser.parse(wikitext, syntax.getAttribute('include'), 2, syntax.getAttribute('config'));
-	syntax.replaceChildren(...token.childNodes);
-};
-
 /**
  * 表格行，含开头的换行，不含结尾的换行
  * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken]}`
  */
-class TrToken extends attributeParent(Token, 1) {
+class TrToken extends Token {
 	type = 'tr';
 
 	/**
@@ -38,24 +19,21 @@ class TrToken extends attributeParent(Token, 1) {
 	 * @param {accum} accum
 	 * @param {RegExp} pattern 表格语法正则
 	 */
-	constructor(syntax, attr = '', config = Parser.getConfig(), accum = [], pattern = openingPattern) {
+	constructor(syntax, attr = '', config = Parser.getConfig(), accum = [], pattern = undefined) {
 		super(undefined, config, true, accum, {
-			Token: 2, SyntaxToken: 0, AttributesToken: 1, TdToken: '2:',
 		});
 		this.append(
 			new SyntaxToken(syntax, pattern, 'table-syntax', config, accum, {
-				'Stage-1': ':', '!ExtToken': '', TranscludeToken: ':',
 			}),
 			new AttributesToken(attr, 'table-attrs', this.type, config, accum),
 		);
-		this.getAttribute('protectChildren')(0, 1);
 	}
 
 	/**
 	 * @override
 	 * @param {number} start 起始位置
 	 */
-	lint(start = 0) {
+	lint(start = this.getAbsoluteIndex()) {
 		const TranscludeToken = require('../transclude'),
 			ArgToken = require('../arg');
 		const errors = super.lint(start),
@@ -75,7 +53,7 @@ class TrToken extends attributeParent(Token, 1) {
 				}
 			} catch {}
 		}
-		const error = generateForChild(inter, {start}, '将被移出表格的内容');
+		const error = generateForChild(inter, {start}, 'content to be moved out from the table');
 		errors.push({
 			...error,
 			startIndex: error.startIndex + 1,
@@ -88,232 +66,9 @@ class TrToken extends attributeParent(Token, 1) {
 
 	/** @override */
 	text() {
-		this.#correct();
 		const str = super.text();
 		return this.type === 'tr' && !str.trim().includes('\n') ? '' : str;
 	}
-
-	/**
-	 * @override
-	 * @this {TrToken & {constructor: typeof TrToken}}
-	 */
-	cloneNode() {
-		const [syntax, attr, inner, ...cloned] = this.cloneChildNodes();
-		return Parser.run(() => {
-			const token = new this.constructor(undefined, undefined, this.getAttribute('config'));
-			token.firstChild.safeReplaceWith(syntax);
-			token.childNodes[1].safeReplaceWith(attr);
-			if (token.type === 'td') { // TdToken
-				token.childNodes[2].safeReplaceWith(inner);
-			} else if (inner !== undefined) {
-				token.insertAt(inner);
-			}
-			token.append(...cloned);
-			return token;
-		});
-	}
-
-	/** 修复简单的表格语法错误 */
-	#correct() {
-		const {childNodes: [,, child]} = this;
-		if (child?.constructor === Token) {
-			const /** @type {{firstChild: AstText}} */ {firstChild} = child;
-			if (firstChild.type !== 'text') {
-				child.prepend('\n');
-			} else if (firstChild.data[0] !== '\n') {
-				firstChild.insertData(0, '\n');
-			}
-		}
-	}
-
-	/**
-	 * @override
-	 * @param {string} selector
-	 */
-	toString(selector) {
-		this.#correct();
-		return super.toString(selector);
-	}
-
-	/**
-	 * 转义表格语法
-	 * @complexity `n`
-	 */
-	escape() {
-		for (const child of this.childNodes) {
-			if (child instanceof SyntaxToken) {
-				escapeTable(child);
-			} else if (child instanceof TrToken) {
-				child.escape();
-			}
-		}
-	}
-
-	/**
-	 * 设置表格语法
-	 * @param {string} syntax 表格语法
-	 * @param {boolean} esc 是否需要转义
-	 */
-	setSyntax(syntax, esc) {
-		const {firstChild} = this;
-		firstChild.replaceChildren(syntax);
-		if (esc) {
-			escapeTable(firstChild);
-		}
-	}
-
-	/**
-	 * @override
-	 * @param {number} i 移除位置
-	 * @complexity `n`
-	 */
-	removeAt(i) {
-		const TdToken = require('./td');
-		const child = this.childNodes.at(i);
-		if (child instanceof TdToken && child.isIndependent()) {
-			const {nextSibling} = child;
-			if (nextSibling?.type === 'td') {
-				nextSibling.independence();
-			}
-		}
-		return super.removeAt(i);
-	}
-
-	/**
-	 * @override
-	 * @template {AstText|Token} T
-	 * @param {T} token 待插入的子节点
-	 * @param {number} i 插入位置
-	 * @returns {T}
-	 * @complexity `n`
-	 */
-	insertAt(token, i = this.length) {
-		if (!Parser.running && !(token instanceof TrToken)) {
-			this.typeError('insertAt', 'TrToken');
-		}
-		const TdToken = require('./td');
-		const child = this.childNodes.at(i);
-		if (token instanceof TdToken && token.isIndependent() && child instanceof TdToken) {
-			child.independence();
-		}
-		return super.insertAt(token, i);
-	}
-
-	/**
-	 * 获取行数
-	 * @returns {0|1}
-	 * @complexity `n`
-	 */
-	getRowCount() {
-		const TdToken = require('./td');
-		return Number(this.childNodes.some(
-			child => child instanceof TdToken && child.isIndependent() && child.firstChild.text().at(-1) !== '+',
-		));
-	}
-
-	/**
-	 * 获取相邻行
-	 * @param {(childNodes: Token[], index: number) => Token[]} subset 筛选兄弟节点的方法
-	 * @complexity `n`
-	 */
-	#getSiblingRow(subset) {
-		const {parentNode} = this;
-		if (!parentNode) {
-			return undefined;
-		}
-		const {childNodes} = parentNode,
-			index = childNodes.indexOf(this);
-		for (const child of subset(childNodes, index)) {
-			if (child instanceof TrToken && child.getRowCount()) {
-				return child;
-			}
-		}
-		return undefined;
-	}
-
-	/**
-	 * 获取下一行
-	 * @complexity `n`
-	 */
-	getNextRow() {
-		return this.#getSiblingRow((childNodes, index) => childNodes.slice(index + 1));
-	}
-
-	/**
-	 * 获取前一行
-	 * @complexity `n`
-	 */
-	getPreviousRow() {
-		return this.#getSiblingRow((childNodes, index) => childNodes.slice(0, index).reverse());
-	}
-
-	/**
-	 * 获取列数
-	 * @complexity `n`
-	 */
-	getColCount() {
-		const TdToken = require('./td');
-		let count = 0,
-			last = 0;
-		for (const child of this.childNodes) {
-			if (child instanceof TdToken) {
-				last = child.isIndependent() ? Number(child.subtype !== 'caption') : last;
-				count += last;
-			}
-		}
-		return count;
-	}
-
-	/**
-	 * 获取第n列
-	 * @param {number} n 列号
-	 * @param {boolean} insert 是否用于判断插入新列的位置
-	 * @returns {TdToken}
-	 * @complexity `n`
-	 * @throws `RangeError` 不存在对应单元格
-	 */
-	getNthCol(n, insert) {
-		if (!Number.isInteger(n)) {
-			this.typeError('getNthCol', 'Number');
-		}
-		const nCols = this.getColCount();
-		n = n < 0 ? n + nCols : n;
-		if (n < 0 || n > nCols || n === nCols && !insert) {
-			throw new RangeError(`不存在第 ${n} 个单元格！`);
-		}
-		const TdToken = require('./td');
-		let last = 0;
-		for (const child of this.childNodes.slice(2)) {
-			if (child instanceof TdToken) {
-				if (child.isIndependent()) {
-					last = Number(child.subtype !== 'caption');
-				}
-				n -= last;
-				if (n < 0) {
-					return child;
-				}
-			} else if (child.type === 'tr' || child.type === 'table-syntax') {
-				return child;
-			}
-		}
-		return undefined;
-	}
-
-	/**
-	 * 插入新的单元格
-	 * @param {string|Token} inner 单元格内部wikitext
-	 * @param {TableCoords} coord 单元格坐标
-	 * @param {'td'|'th'|'caption'} subtype 单元格类型
-	 * @param {Record<string, string|boolean>} attr 单元格属性
-	 * @returns {TdToken}
-	 * @complexity `n`
-	 */
-	insertTableCell(inner, {column}, subtype = 'td', attr = {}) {
-		const TdToken = require('./td');
-		const token = TdToken.create(inner, subtype, attr, this.getAttribute('include'), this.getAttribute('config'));
-		return this.insertBefore(token, this.getNthCol(column, true));
-	}
 }
 
-Parser.classes.TrToken = __filename;
 module.exports = TrToken;

package/src/tagPair/ext.js

@@ -1,8 +1,6 @@
 'use strict';
 
 const {generateForSelf} = require('../../util/lint'),
-	attributeParent = require('../../mixin/attributeParent'),
-	path = require('path'),
 	Parser = require('../..'),
 	Token = require('..'),
 	TagPairToken = require('.'),
@@ -12,7 +10,7 @@ const {generateForSelf} = require('../../util/lint'),
  * 扩展标签
  * @classdesc `{childNodes: [AttributesToken, NowikiToken|Token]}`
  */
-class ExtToken extends attributeParent(TagPairToken) {
+class ExtToken extends TagPairToken {
 	type = 'ext';
 	closed = true;
 
@@ -60,17 +58,19 @@ class ExtToken extends attributeParent(TagPairToken) {
 				innerToken = new PreToken(inner, newConfig, accum);
 				break;
 			}
-			case 'charinsert': {
-				const CharinsertToken = require('../charinsert');
-				innerToken = new CharinsertToken(inner, newConfig, accum);
+			case 'references': {
+				const ReferencesToken = require('../nested/references');
+				innerToken = new ReferencesToken(inner, newConfig, accum);
+				break;
+			}
+			case 'choose': {
+				const ChooseToken = require('../nested/choose');
+				innerToken = new ChooseToken(inner, newConfig, accum);
 				break;
 			}
-			case 'references':
-			case 'choose':
 			case 'combobox': {
-				const NestedToken = require('../nested'),
-					/** @type {typeof NestedToken} */ NestedExtToken = require(path.join('..', 'nested', lcName));
-				innerToken = new NestedExtToken(inner, newConfig, accum);
+				const ComboboxToken = require('../nested/combobox');
+				innerToken = new ComboboxToken(inner, newConfig, accum);
 				break;
 			}
 			case 'imagemap': {
@@ -113,30 +113,16 @@ class ExtToken extends attributeParent(TagPairToken) {
 	 * @override
 	 * @param {number} start 起始位置
 	 */
-	lint(start = 0) {
+	lint(start = this.getAbsoluteIndex()) {
 		const errors = super.lint(start);
 		if (this.name !== 'nowiki' && this.closest('html-attrs, table-attrs')) {
 			const root = this.getRootNode(),
 				excerpt = String(root).slice(Math.max(0, start - 25), start + 25),
 				rect = {start, ...root.posFromIndex(start)};
-			errors.push({...generateForSelf(this, rect, 'HTML标签属性中的扩展标签'), excerpt});
+			errors.push({...generateForSelf(this, rect, 'extension tag in HTML tag attributes'), excerpt});
 		}
 		return errors;
 	}
-
-	/** @override */
-	cloneNode() {
-		const inner = this.lastChild.cloneNode(),
-			tags = this.getAttribute('tags'),
-			config = this.getAttribute('config'),
-			attr = String(this.firstChild);
-		return Parser.run(() => {
-			const token = new ExtToken(tags[0], attr, '', this.selfClosing ? undefined : tags[1], config);
-			token.lastChild.safeReplaceWith(inner);
-			return token;
-		});
-	}
 }
 
-Parser.classes.ExtToken = __filename;
 module.exports = ExtToken;