wikiparser-node 0.11.0 → 1.0.0-beta.0

package/src/parameter.js

@@ -1,239 +0,0 @@
-'use strict';
-
-const {noWrap, extUrlChar, extUrlCharFirst} = require('../util/string'),
-	{generateForChild} = require('../util/lint'),
-	fixedToken = require('../mixin/fixedToken'),
-	Parser = require('..'),
-	Token = require('.');
-
-/**
- * 模板或魔术字参数
- * @classdesc `{childNodes: [Token, Token]}`
- */
-class ParameterToken extends fixedToken(Token) {
-	type = 'parameter';
-
-	/** 是否是匿名参数 */
-	get anon() {
-		return this.firstChild.length === 0;
-	}
-
-	/** getValue()的getter */
-	get value() {
-		return this.getValue();
-	}
-
-	set value(value) {
-		this.setValue(value);
-	}
-
-	/**
-	 * 是否是重复参数
-	 * @this {ParameterToken & {parentNode: TranscludeToken}}
-	 */
-	get duplicated() {
-		const TranscludeToken = require('./transclude');
-		try {
-			return Boolean(this.parentNode?.getDuplicatedArgs()?.some(([key]) => key === this.name));
-		} catch {
-			return false;
-		}
-	}
-
-	/**
-	 * @param {string|number} key 参数名
-	 * @param {string} value 参数值
-	 * @param {import('../typings/token').accum} accum
-	 */
-	constructor(key, value, config = Parser.getConfig(), accum = []) {
-		super(undefined, config, true, accum);
-		const keyToken = new Token(typeof key === 'number' ? undefined : key, config, true, accum, {
-				'Stage-11': ':', '!HeadingToken': '',
-			}),
-			token = new Token(value, config, true, accum);
-		keyToken.type = 'parameter-key';
-		token.type = 'parameter-value';
-		this.append(keyToken, token.setAttribute('stage', 2));
-	}
-
-	/** @override */
-	afterBuild() {
-		if (!this.anon) {
-			const TranscludeToken = require('./transclude');
-			const name = this.firstChild.toString('comment, noinclude, include')
-					.replace(/^[ \t\n\0\v]+|(?<=[^ \t\n\0\v])[ \t\n\0\v]+$/gu, ''),
-				{parentNode} = this;
-			this.setAttribute('name', name);
-			if (parentNode instanceof TranscludeToken) {
-				parentNode.getAttribute('keys').add(name);
-				parentNode.getArgs(name, false, false).add(this);
-			}
-		}
-		const /** @type {import('../typings/event').AstListener} */ parameterListener = ({prevTarget}, data) => {
-			if (!this.anon) { // 匿名参数不管怎么变动还是匿名
-				const {firstChild, name} = this;
-				if (prevTarget === firstChild) {
-					const newKey = firstChild.toString('comment, noinclude, include')
-						.replace(/^[ \t\n\0\v]+|(?<=[^ \t\n\0\v])[ \t\n\0\v]+$/gu, '');
-					data.oldKey = name;
-					data.newKey = newKey;
-					this.setAttribute('name', newKey);
-				}
-			}
-		};
-		this.addEventListener(['remove', 'insert', 'replace', 'text'], parameterListener);
-	}
-
-	/**
-	 * @override
-	 * @param {string} selector
-	 * @returns {string}
-	 */
-	toString(selector) {
-		return this.anon && !(selector && this.matches(selector))
-			? this.lastChild.toString(selector)
-			: super.toString(selector, '=');
-	}
-
-	/**
-	 * @override
-	 * @returns {string}
-	 */
-	text() {
-		return this.anon ? this.lastChild.text() : super.text('=');
-	}
-
-	/** @override */
-	getGaps() {
-		return this.anon ? 0 : 1;
-	}
-
-	/** @override */
-	print() {
-		return super.print({sep: this.anon ? '' : '='});
-	}
-
-	/**
-	 * @override
-	 * @param {number} start 起始位置
-	 */
-	lint(start = this.getAbsoluteIndex()) {
-		const errors = super.lint(start),
-			{firstChild, lastChild} = this,
-			link = new RegExp(`https?://${extUrlCharFirst}${extUrlChar}$`, 'iu')
-				.exec(firstChild.toString('comment, noinclude, include'))?.[0];
-		if (link && new URL(link).search) {
-			const e = generateForChild(firstChild, {start}, 'unescaped query string in an anonymous parameter');
-			errors.push({
-				...e,
-				startIndex: e.endIndex,
-				endIndex: e.endIndex + 1,
-				startLine: e.endLine,
-				startCol: e.endCol,
-				endCol: e.endCol + 1,
-				excerpt: `${String(firstChild).slice(-25)}=${String(lastChild).slice(0, 25)}`,
-			});
-		}
-		return errors;
-	}
-
-	/**
-	 * 获取参数值
-	 * @this {ParameterToken & {parentNode: TranscludeToken}}
-	 */
-	getValue() {
-		const TranscludeToken = require('./transclude');
-		const value = this.lastChild.text();
-		return this.anon && this.parentNode?.isTemplate() ? value : value.trim();
-	}
-
-	/** @override */
-	cloneNode() {
-		const [key, value] = this.cloneChildNodes(),
-			config = this.getAttribute('config');
-		return Parser.run(() => {
-			const token = new ParameterToken(this.anon ? Number(this.name) : undefined, undefined, config);
-			token.firstChild.safeReplaceWith(key);
-			token.lastChild.safeReplaceWith(value);
-			token.afterBuild();
-			return token;
-		});
-	}
-
-	/**
-	 * @override
-	 * @param {ParameterToken} token 待替换的节点
-	 * @complexity `n`
-	 */
-	safeReplaceWith(token) {
-		Parser.warn(`${this.constructor.name}.safeReplaceWith 方法退化到 replaceWith。`);
-		return this.replaceWith(token);
-	}
-
-	/**
-	 * 设置参数值
-	 * @this {ParameterToken & {parentNode: TranscludeToken}}
-	 * @param {string} value 参数值
-	 * @throws `SyntaxError` 非法的模板参数
-	 */
-	setValue(value) {
-		value = String(value);
-		const TranscludeToken = require('./transclude');
-		const templateLike = this.parentNode?.isTemplate(),
-			wikitext = `{{${templateLike ? ':T|' : 'lc:'}${this.anon ? '' : '1='}${value}}}`,
-			root = Parser.parse(wikitext, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{length, firstChild: transclude} = root,
-			/** @type {Token & {lastChild: ParameterToken}} */
-			{lastChild: parameter, type, name, length: transcludeLength} = transclude,
-			targetType = templateLike ? 'template' : 'magic-word',
-			targetName = templateLike ? 'T' : 'lc';
-		if (length !== 1 || type !== targetType || name !== targetName || transcludeLength !== 2
-			|| parameter.anon !== this.anon || parameter.name !== '1'
-		) {
-			throw new SyntaxError(`非法的模板参数：${noWrap(value)}`);
-		}
-		const {lastChild} = parameter;
-		parameter.destroy();
-		this.lastChild.safeReplaceWith(lastChild);
-	}
-
-	/**
-	 * 修改参数名
-	 * @this {ParameterToken & {parentNode: TranscludeToken}}
-	 * @param {string} key 新参数名
-	 * @param {boolean} force 是否无视冲突命名
-	 * @throws `Error` 仅用于模板参数
-	 * @throws `SyntaxError` 非法的模板参数名
-	 * @throws `RangeError` 更名造成重复参数
-	 */
-	rename(key, force) {
-		key = String(key);
-		const TranscludeToken = require('./transclude');
-		const {parentNode} = this;
-		// 必须检测是否是TranscludeToken
-		if (!parentNode?.isTemplate() || !(parentNode instanceof TranscludeToken)) {
-			throw new Error(`${this.constructor.name}.rename 方法仅用于模板参数！`);
-		}
-		const root = Parser.parse(`{{:T|${key}=}}`, this.getAttribute('include'), 2, this.getAttribute('config')),
-			{length, firstChild: template} = root,
-			{type, name, lastChild: parameter, length: templateLength} = template;
-		if (length !== 1 || type !== 'template' || name !== 'T' || templateLength !== 2) {
-			throw new SyntaxError(`非法的模板参数名：${key}`);
-		}
-		const {name: parameterName, firstChild} = parameter;
-		if (this.name === parameterName) {
-			Parser.warn('未改变实际参数名', parameterName);
-		} else if (parentNode.hasArg(parameterName)) {
-			if (force) {
-				Parser.warn('参数更名造成重复参数', parameterName);
-			} else {
-				throw new RangeError(`参数更名造成重复参数：${parameterName}`);
-			}
-		}
-		parameter.destroy();
-		this.firstChild.safeReplaceWith(firstChild);
-	}
-}
-
-Parser.classes.ParameterToken = __filename;
-module.exports = ParameterToken;

package/src/syntax.js

@@ -1,91 +0,0 @@
-'use strict';
-
-const Parser = require('..'),
-	{undo} = require('../util/debug'),
-	{text} = require('../util/string'),
-	Token = require('.');
-
-/**
- * 满足特定语法格式的plain Token
- * @classdesc `{childNodes: ...AstText|Token}`
- */
-class SyntaxToken extends Token {
-	#pattern;
-
-	/**
-	 * @param {string} wikitext 语法wikitext
-	 * @param {RegExp} pattern 语法正则
-	 * @param {string} type Token.type
-	 * @param {import('../typings/token').accum} accum
-	 * @param {import('../typings/token').acceptable} acceptable 可接受的子节点设置
-	 * @throws `RangeError` 含有g修饰符的语法正则
-	 */
-	constructor(wikitext, pattern, type = 'plain', config = Parser.getConfig(), accum = [], acceptable = undefined) {
-		if (pattern.global) {
-			throw new RangeError(`SyntaxToken 的语法正则不能含有 g 修饰符：${pattern}`);
-		}
-		super(wikitext, config, true, accum, acceptable);
-		this.type = type;
-		this.#pattern = pattern;
-	}
-
-	/** @override */
-	cloneNode() {
-		const cloned = this.cloneChildNodes(),
-			config = this.getAttribute('config'),
-			acceptable = this.getAttribute('acceptable');
-		return Parser.run(() => {
-			const token = new SyntaxToken(undefined, this.#pattern, this.type, config, [], acceptable);
-			token.append(...cloned);
-			token.afterBuild();
-			return token;
-		});
-	}
-
-	/** @override */
-	afterBuild() {
-		const /** @type {import('../typings/event').AstListener} */ syntaxListener = (e, data) => {
-			const pattern = this.#pattern;
-			if (!Parser.running && !pattern.test(this.text())) {
-				undo(e, data);
-				Parser.error(`不可修改 ${this.constructor.name} 的语法！`, pattern);
-				throw new Error(`不可修改 ${this.constructor.name} 的语法！`);
-			}
-		};
-		this.addEventListener(['remove', 'insert', 'replace', 'text'], syntaxListener);
-	}
-
-	/**
-	 * @override
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @returns {import('../typings/node').TokenAttribute<T>}
-	 */
-	getAttribute(key) {
-		return key === 'pattern' ? this.#pattern : super.getAttribute(key);
-	}
-
-	/**
-	 * @override
-	 * @param {PropertyKey} key 属性键
-	 */
-	hasAttribute(key) {
-		return key === 'pattern' || super.hasAttribute(key);
-	}
-
-	/**
-	 * @override
-	 * @param {...Token} elements 待替换的子节点
-	 * @complexity `n`
-	 */
-	replaceChildren(...elements) {
-		if (this.#pattern.test(text(elements))) {
-			Parser.run(() => {
-				super.replaceChildren(...elements);
-			});
-		}
-	}
-}
-
-Parser.classes.SyntaxToken = __filename;
-module.exports = SyntaxToken;