wikiparser-node 0.5.0 → 0.6.2-b

package/src/table/td.js

@@ -1,314 +0,0 @@
-'use strict';
-
-const fixedToken = require('../../mixin/fixedToken'),
-	{externalUse, typeError} = require('../../util/debug'),
-	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, AttributeToken, Token]}`
- */
-class TdToken extends fixedToken(TrToken) {
-	type = 'td';
-	#innerSyntax = '';
-
-	/**
-	 * 单元格类型
-	 * @complexity `n`
-	 */
-	get subtype() {
-		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}}
-	 * @complexity `n`
-	 */
-	getSyntax() {
-		const syntax = this.firstChild.text(),
-			esc = syntax.includes('{{'),
-			char = syntax.at(-1);
-		let subtype = 'td';
-		if (char === '!') {
-			subtype = 'th';
-		} 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, html')
-			.includes('\n');
-		if (subtype === 'th' && result.subtype !== 'th') {
-			result.subtype = 'th';
-			result.correction = true;
-		}
-		return result;
-	}
-
-	getRowCount = undefined;
-	getNthCol = undefined;
-	insertTableCell = undefined;
-
-	/**
-	 * @param {string} syntax 单元格语法
-	 * @param {string} inner 内部wikitext
-	 * @param {accum} accum
-	 */
-	constructor(syntax, inner, config = Parser.getConfig(), accum = []) {
-		let innerSyntax = inner?.match(/\||\0\d+!\x7F/u),
-			attr = innerSyntax ? inner.slice(0, innerSyntax.index) : '';
-		if (/\[\[|-\{/u.test(attr)) {
-			innerSyntax = null;
-			attr = '';
-		}
-		super(syntax, attr, config, accum, openingPattern);
-		if (innerSyntax) {
-			[this.#innerSyntax] = innerSyntax;
-		}
-		// eslint-disable-next-line no-unsafe-optional-chaining
-		const innerToken = new Token(inner?.slice(innerSyntax?.index + this.#innerSyntax.length), config, true, accum);
-		innerToken.type = 'td-inner';
-		this.setAttribute('acceptable', {SyntaxToken: 0, AttributeToken: 1, Token: 2})
-			.seal(['getRowCount', 'getNthCol', 'insertTableCell'], true)
-			.appendChild(innerToken.setAttribute('stage', 4));
-	}
-
-	/** @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 instanceof Token) || !inner.isPlain()) || typeof attr !== 'object') {
-			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}
-	 * @throws `RangeError` 仅用于代码调试
-	 */
-	setAttribute(key, value) {
-		if (key !== 'innerSyntax') {
-			return super.setAttribute(key, value);
-		} else if (!Parser.debugging && externalUse('setAttribute')) {
-			throw new RangeError(`使用 ${this.constructor.name}.setAttribute 方法设置私有属性 #${key} 仅用于代码调试！`);
-		}
-		this.#innerSyntax = String(value);
-		return this;
-	}
-
-	/** @override */
-	afterBuild() {
-		if (this.#innerSyntax.includes('\0')) {
-			this.#innerSyntax = this.getAttribute('buildFromStr')(this.#innerSyntax).map(String).join('');
-		}
-		return this;
-	}
-
-	/**
-	 * @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);
-		}
-	}
-
-	/**
-	 * @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)}`;
-	}
-
-	/**
-	 * @override
-	 * @param {number} i 子节点位置
-	 */
-	getGaps(i = 0) {
-		i = i < 0 ? i + this.childNodes.length : i;
-		if (i === 1) {
-			this.#correct();
-			return this.#innerSyntax.length;
-		}
-		return 0;
-	}
-
-	/** @override */
-	print() {
-		const {childNodes: [syntax, attr, inner]} = this;
-		return `<span class="wpb-td">${syntax.print()}${attr.print()}${this.#innerSyntax}${inner.print()}</span>`;
-	}
-
-	/**
-	 * @override
-	 * @returns {string}
-	 * @complexity `n`
-	 */
-	text() {
-		this.#correct();
-		const {childNodes: [syntax, attr, inner]} = this;
-		return `${syntax.text()}${attr.text()}${this.#innerSyntax}${inner.text()}`;
-	}
-
-	/**
-	 * 获取单元格属性
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @returns {T extends 'rowspan'|'colspan' ? number : Record<string, 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;
-	}
-
-	/**
-	 * 设置单元格属性
-	 * @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,299 +0,0 @@
-'use strict';
-
-const {generateForChild} = require('../../util/lint'),
-	attributeParent = require('../../mixin/attributeParent'),
-	Parser = require('../..'),
-	AstText = require('../../lib/text'),
-	Token = require('..'),
-	SyntaxToken = require('../syntax'),
-	AttributeToken = require('../attribute');
-
-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).replaceAll(/\{\||\|\}|\|{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, AttributeToken, ?Token, ...TdToken]}`
- */
-class TrToken extends attributeParent(Token, 1) {
-	type = 'tr';
-
-	/**
-	 * @param {string} syntax 表格语法
-	 * @param {string} attr 表格属性
-	 * @param {accum} accum
-	 * @param {RegExp} pattern 表格语法正则
-	 */
-	constructor(syntax, attr = '', config = Parser.getConfig(), accum = [], pattern = openingPattern) {
-		super(undefined, config, true, accum, {Token: 2, SyntaxToken: 0, AttributeToken: 1, TdToken: '2:'});
-		this.append(
-			new SyntaxToken(syntax, pattern, 'table-syntax', config, accum, {
-				'Stage-1': ':', '!ExtToken': '', TranscludeToken: ':',
-			}),
-			new AttributeToken(attr, 'table-attr', 'tr', config, accum),
-		);
-		this.getAttribute('protectChildren')(0, 1);
-	}
-
-	/**
-	 * @override
-	 * @param {number} start 起始位置
-	 */
-	lint(start = 0) {
-		const errors = super.lint(start),
-			inter = this.childNodes.find(({type}) => type === 'table-inter'),
-			str = String(inter).trim();
-		if (inter && str && !/^<!--.*-->$/u.test(str)) {
-			const error = generateForChild(inter, this.getRootNode().posFromIndex(start), '将被移出表格的内容');
-			error.startLine++;
-			error.startCol = 0;
-			errors.push(error);
-		}
-		return errors;
-	}
-
-	/**
-	 * @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.appendChild(inner);
-			}
-			token.append(...cloned);
-			return token;
-		});
-	}
-
-	/** 修复简单的表格语法错误 */
-	#correct() {
-		const {childNodes: [,, child]} = this;
-		if (child?.isPlain()) {
-			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);
-	}
-
-	/** @override */
-	text() {
-		this.#correct();
-		const str = super.text();
-		return this.type === 'tr' && !str.trim().includes('\n') ? '' : str;
-	}
-
-	/**
-	 * 转义表格语法
-	 * @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.childNodes.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 (typeof n !== 'number') {
-			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,104 +0,0 @@
-'use strict';
-
-const attributeParent = require('../../mixin/attributeParent'),
-	Parser = require('../..'),
-	TagPairToken = require('.');
-
-/**
- * 扩展标签
- * @classdesc `{childNodes: [AttributeToken, NowikiToken|Token]}`
- */
-class ExtToken extends attributeParent(TagPairToken) {
-	type = 'ext';
-
-	/** @override */
-	get closed() {
-		return super.closed;
-	}
-
-	/**
-	 * @param {string} name 标签名
-	 * @param {string} attr 标签属性
-	 * @param {string} inner 内部wikitext
-	 * @param {string|undefined} closed 是否封闭
-	 * @param {accum} accum
-	 */
-	constructor(name, attr = '', inner = '', closed = undefined, config = Parser.getConfig(), accum = []) {
-		attr = !attr || attr.trimStart() !== attr ? attr : ` ${attr}`;
-		const AttributeToken = require('../attribute');
-		const lcName = name.toLowerCase(),
-			attrToken = new AttributeToken(attr, 'ext-attr', lcName, config, accum),
-			newConfig = structuredClone(config),
-			ext = new Set(newConfig.ext);
-		let /** @type {acceptable} */ acceptable, /** @type {Token} */ innerToken;
-		switch (lcName) {
-			case 'choose':
-			case 'option':
-			case 'ref':
-			case 'poem':
-			case 'indicator':
-			case 'tab':
-			case 'tabs':
-			case 'pre':
-			case 'combobox':
-			case 'combooption': {
-				ext.delete(lcName);
-				newConfig.ext = [
-					...ext,
-					...lcName === 'choose' ? ['option'] : [],
-					...lcName === 'combobox' ? ['combooption'] : [],
-				];
-				const Token = require('..');
-				acceptable = {AttributeToken: 0, Token: 1};
-				innerToken = new Token(inner, newConfig, true, accum);
-				break;
-			}
-			case 'gallery': {
-				ext.delete(lcName);
-				newConfig.ext = [...ext];
-				const GalleryToken = require('../gallery');
-				acceptable = {AttributeToken: 0, GalleryToken: 1};
-				innerToken = new GalleryToken(inner, newConfig, accum);
-				break;
-			}
-
-			/*
-			 * 更多定制扩展的代码示例：
-			 * ```
-			 * case 'extensionName': {
-			 * 	ext.delete(lcName);
-			 * 	newConfig.ext = [...ext];
-			 * 	const ExtensionToken = require('../extension');
-			 * 	acceptable = {AttributeToken: 0, ExtensionToken: 1};
-			 * 	innerToken = new ExtensionToken(inner, newConfig, accum);
-			 * 	break;
-			 * }
-			 * ```
-			 */
-			default: {
-				const NowikiToken = require('../nowiki');
-				acceptable = {AttributeToken: 0, NowikiToken: 1};
-				innerToken = new NowikiToken(inner, config);
-			}
-		}
-		innerToken.setAttribute('name', lcName).type = 'ext-inner';
-		if (lcName === 'pre') {
-			innerToken.setAttribute('stage', Parser.MAX_STAGE - 1);
-		}
-		super(name, attrToken, innerToken, closed, config, accum, acceptable);
-	}
-
-	/** @override */
-	cloneNode() {
-		const inner = this.lastChild.cloneNode(),
-			tags = this.getAttribute('tags'),
-			config = this.getAttribute('config'),
-			attr = String(this.firstChild),
-			token = Parser.run(() => new ExtToken(tags[0], attr, '', this.selfClosing ? undefined : tags[1], config));
-		token.lastChild.safeReplaceWith(inner);
-		return token;
-	}
-}
-
-Parser.classes.ExtToken = __filename;
-module.exports = ExtToken;