wikiparser-node 0.7.0-m → 0.7.0

package/src/magicLink.js

@@ -10,6 +10,34 @@ const {generateForChild} = require('../util/lint'),
  */
 class MagicLinkToken extends Token {
 	type = 'free-ext-link';
+	#protocolRegex;
+
+	/** 协议 */
+	get protocol() {
+		return this.#protocolRegex.exec(this.text())?.[0];
+	}
+
+	set protocol(value) {
+		if (typeof value !== 'string') {
+			this.typeError('protocol', 'String');
+		} else if (!new RegExp(`${this.#protocolRegex.source}$`, 'iu').test(value)) {
+			throw new RangeError(`非法的外链协议：${value}`);
+		}
+		const {link} = this;
+		if (!this.#protocolRegex.test(link)) {
+			throw new Error(`特殊外链无法更改协议！${link}`);
+		}
+		this.replaceChildren(link.replace(this.#protocolRegex, value));
+	}
+
+	/** 和内链保持一致 */
+	get link() {
+		return this.text();
+	}
+
+	set link(url) {
+		this.setTarget(url);
+	}
 
 	/**
 	 * @override
@@ -25,17 +53,15 @@ class MagicLinkToken extends Token {
 				continue;
 			}
 			rect ||= {start, ...this.getRootNode().posFromIndex(start)};
-			const refError = generateForChild(child, rect, '', 'warning'),
-				regex = new RegExp(source, 'gu');
-			for (let mt = regex.exec(str); mt; mt = regex.exec(str)) {
-				const {index, 0: {0: char, length}} = mt,
-					lines = str.slice(0, index).split('\n'),
+			const refError = generateForChild(child, rect, '', 'warning');
+			errors.push(...[...str.matchAll(new RegExp(source, 'gu'))].map(({index, 0: {0: char, length}}) => {
+				const lines = str.slice(0, index).split('\n'),
 					{length: top} = lines,
-					{length: left} = lines[top - 1],
+					{length: left} = lines.at(-1),
 					startIndex = start + index,
 					startLine = refError.startLine + top - 1,
 					startCol = (top > 1 ? 0 : refError.startCol) + left;
-				errors.push({
+				return {
 					...refError,
 					message: `URL中的${char === '|' ? '"|"' : '全角标点'}`,
 					startIndex,
@@ -45,8 +71,8 @@ class MagicLinkToken extends Token {
 					startCol,
 					endCol: startCol + length,
 					excerpt: str.slice(Math.max(0, index - 25), index + 25),
-				});
-			}
+				};
+			}));
 		}
 		return errors;
 	}
@@ -58,11 +84,66 @@ class MagicLinkToken extends Token {
 	 */
 	constructor(url, doubleSlash, config = Parser.getConfig(), accum = []) {
 		super(url, config, true, accum, {
+			'Stage-1': ':', '!ExtToken': '',
 		});
 		if (doubleSlash) {
 			this.type = 'ext-link-url';
 		}
+		this.#protocolRegex = new RegExp(`^(?:${config.protocol}${doubleSlash ? '|//' : ''})`, 'iu');
+	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new MagicLinkToken(undefined, this.type === 'ext-link-url', this.getAttribute('config'));
+			token.append(...cloned);
+			token.afterBuild();
+			return token;
+		});
+	}
+
+	/**
+	 * 获取网址
+	 * @throws `Error` 非标准协议
+	 */
+	getUrl() {
+		let url = this.text();
+		if (url.startsWith('//')) {
+			url = `https:${url}`;
+		}
+		try {
+			return new URL(url);
+		} catch (e) {
+			if (e instanceof TypeError && e.message === 'Invalid URL') {
+				throw new Error(`非标准协议的外部链接：${url}`);
+			}
+			throw e;
+		}
+	}
+
+	/**
+	 * 设置外链目标
+	 * @param {string|URL} url 含协议的网址
+	 * @throws `SyntaxError` 非法的自由外链目标
+	 */
+	setTarget(url) {
+		url = String(url);
+		const root = Parser.parse(url, this.getAttribute('include'), 9, this.getAttribute('config')),
+			{length, firstChild: freeExtLink} = root;
+		if (length !== 1 || freeExtLink.type !== 'free-ext-link') {
+			throw new SyntaxError(`非法的自由外链目标：${url}`);
+		}
+		this.replaceChildren(...freeExtLink.childNodes);
+	}
+
+	/** 是否是模板或魔术字参数 */
+	isParamValue() {
+		const ParameterToken = require('./parameter');
+		const /** @type {ParameterToken} */ parameter = this.closest('parameter');
+		return parameter?.getValue() === this.text();
 	}
 }
 
+Parser.classes.MagicLinkToken = __filename;
 module.exports = MagicLinkToken;

package/src/nested/choose.js

@@ -20,4 +20,5 @@ class ChooseToken extends NestedToken {
 	}
 }
 
+Parser.classes.ChooseToken = __filename;
 module.exports = ChooseToken;

package/src/nested/combobox.js

@@ -19,4 +19,5 @@ class ComboboxToken extends NestedToken {
 	}
 }
 
+Parser.classes.ComboboxToken = __filename;
 module.exports = ComboboxToken;

package/src/nested/index.js

@@ -13,6 +13,7 @@ const {generateForChild} = require('../../util/lint'),
  */
 class NestedToken extends Token {
 	type = 'ext-inner';
+	#tags;
 
 	/**
 	 * @param {string|undefined} wikitext wikitext
@@ -33,15 +34,17 @@ class NestedToken extends Token {
 				}
 				return str;
 			},
-		)?.replace(/(^|\0\d+[ce]\x7F)(.*?)(?=$|\0\d+[ce]\x7F)/gsu, (_, lead, substr) => {
+		)?.replace(/(?<=^|\0\d+[ce]\x7F).*?(?=$|\0\d+[ce]\x7F)/gsu, substr => {
 			if (substr === '') {
-				return lead;
+				return '';
 			}
 			new NoincludeToken(substr, config, accum);
-			return `${lead}\0${accum.length}c\x7F`;
+			return `\0${accum.length}c\x7F`;
 		});
 		super(text, config, true, accum, {
+			NoincludeToken: ':', ExtToken: ':',
 		});
+		this.#tags = tags;
 	}
 
 	/**
@@ -64,6 +67,30 @@ class NestedToken extends Token {
 			}),
 		];
 	}
+
+	/**
+	 * @override
+	 * @template {string|Token} T
+	 * @param {T} token 待插入的子节点
+	 * @param {number} i 插入位置
+	 */
+	insertAt(token, i = this.length) {
+		return token.type === 'ext' && !this.#tags.includes(token.name)
+			? this.typeError(`${this.constructor.name}只能以${this.#tags.join('或')}标签作为子节点！`)
+			: super.insertAt(token, i);
+	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes(),
+			config = this.getAttribute('config');
+		return Parser.run(() => {
+			const token = new this.constructor(undefined, config);
+			token.append(...cloned);
+			return token;
+		});
+	}
 }
 
+Parser.classes.NestedToken = __filename;
 module.exports = NestedToken;

package/src/nested/references.js

@@ -19,4 +19,5 @@ class ReferencesToken extends NestedToken {
 	}
 }
 
+Parser.classes.ReferencesToken = __filename;
 module.exports = ReferencesToken;

package/src/nowiki/comment.js

@@ -13,6 +13,11 @@ class CommentToken extends hidden(NowikiToken) {
 	type = 'comment';
 	closed;
 
+	/** 内部wikitext */
+	get innerText() {
+		return String(this.firstChild);
+	}
+
 	/**
 	 * @param {string} wikitext wikitext
 	 * @param {boolean} closed 是否闭合
@@ -21,6 +26,7 @@ class CommentToken extends hidden(NowikiToken) {
 	constructor(wikitext, closed = true, config = Parser.getConfig(), accum = []) {
 		super(wikitext, config, accum);
 		this.closed = closed;
+		Object.defineProperty(this, 'closed', {enumerable: false});
 	}
 
 	/** @override */
@@ -28,6 +34,11 @@ class CommentToken extends hidden(NowikiToken) {
 		return 4;
 	}
 
+	/** @override */
+	print() {
+		return super.print({pre: '<!--', post: this.closed ? '-->' : ''});
+	}
+
 	/**
 	 * @override
 	 * @param {number} start 起始位置
@@ -38,10 +49,23 @@ class CommentToken extends hidden(NowikiToken) {
 
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
-		return `<!--${String(this.firstChild)}${this.closed ? '-->' : ''}`;
+		if (!this.closed && this.nextSibling) {
+			Parser.error('自动闭合HTML注释', this);
+			this.closed = true;
+		}
+		return selector && this.matches(selector)
+			? ''
+			: `<!--${String(this.firstChild)}${this.closed ? '-->' : ''}`;
+	}
+
+	/** @override */
+	cloneNode() {
+		return Parser.run(() => new CommentToken(String(this.firstChild), this.closed, this.getAttribute('config')));
 	}
 }
 
+Parser.classes.CommentToken = __filename;
 module.exports = CommentToken;

package/src/nowiki/dd.js

@@ -1,6 +1,7 @@
 'use strict';
 
-const NowikiToken = require('.');
+const Parser = require('../..'),
+	NowikiToken = require('.');
 
 /**
  * :
@@ -8,6 +9,51 @@ const NowikiToken = require('.');
  */
 class DdToken extends NowikiToken {
 	type = 'dd';
+
+	/** 是否包含<dt> */
+	get dt() {
+		return String(this).includes(';');
+	}
+
+	/** 是否包含<ul> */
+	get ul() {
+		return String(this).includes('*');
+	}
+
+	/** 是否包含<ol> */
+	get ol() {
+		return String(this).includes('#');
+	}
+
+	/** 缩进数 */
+	get indent() {
+		return String(this).split(':').length - 1;
+	}
+
+	set indent(indent) {
+		if (this.type === 'dd') {
+			if (!Number.isInteger(indent)) {
+				this.typeError('set indent', 'Number');
+			} else if (indent < 0) {
+				throw new RangeError(`indent 应为自然数！${indent}`);
+			}
+			this.setText(':'.repeat(indent));
+		}
+	}
+
+	/**
+	 * @override
+	 * @param {string} str 新文本
+	 * @throws `RangeError` 错误的列表语法
+	 */
+	setText(str) {
+		const src = this.type === 'dd' ? ':' : ';:*#';
+		if (new RegExp(`[^${src}]`, 'u').test(str)) {
+			throw new RangeError(`${this.constructor.name} 仅能包含${[...src].map(c => `"${c}"`).join('、')}！`);
+		}
+		return super.setText(str);
+	}
 }
 
+Parser.classes.DdToken = __filename;
 module.exports = DdToken;

package/src/nowiki/doubleUnderscore.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const hidden = require('../../mixin/hidden'),
+	Parser = require('../..'),
 	NowikiToken = require('.');
 
 /**
@@ -15,12 +16,41 @@ class DoubleUnderscoreToken extends hidden(NowikiToken) {
 		return 2;
 	}
 
+	/** @override */
+	print() {
+		return super.print({pre: '__', post: '__'});
+	}
+
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
-		return `__${String(this.firstChild)}__`;
+		return selector && this.matches(selector) ? '' : `__${String(this.firstChild)}__`;
+	}
+
+	/**
+	 * @param {string} word 状态开关名
+	 * @param {accum} accum
+	 */
+	constructor(word, config = Parser.getConfig(), accum = []) {
+		super(word, config, accum);
+		this.setAttribute('name', word.toLowerCase());
+	}
+
+	/** @override */
+	cloneNode() {
+		return Parser.run(() => new DoubleUnderscoreToken(String(this.firstChild), this.getAttribute('config')));
+	}
+
+	/**
+	 * @override
+	 * @throws `Error` 禁止修改
+	 */
+	setText() {
+		throw new Error(`禁止修改 ${this.constructor.name}！`);
 	}
 }
 
+Parser.classes.DoubleUnderscoreToken = __filename;
 module.exports = DoubleUnderscoreToken;

package/src/nowiki/hr.js

@@ -1,13 +1,14 @@
 'use strict';
 
 const Parser = require('../..'),
+	sol = require('../../mixin/sol'),
 	NowikiToken = require('.');
 
 /**
  * `<hr>`
  * @classdesc `{childNodes: [AstText]}`
  */
-class HrToken extends NowikiToken {
+class HrToken extends sol(NowikiToken) {
 	type = 'hr';
 
 	/**
@@ -17,6 +18,24 @@ class HrToken extends NowikiToken {
 	constructor(n, config = Parser.getConfig(), accum = []) {
 		super('-'.repeat(n), config, accum);
 	}
+
+	/** @override */
+	cloneNode() {
+		return Parser.run(() => new HrToken(String(this).length, this.getAttribute('config')));
+	}
+
+	/**
+	 * @override
+	 * @param {string} str 新文本
+	 * @throws `RangeError` 错误的\<hr\>语法
+	 */
+	setText(str) {
+		if (str.length < 4 || /[^-]/u.test(str)) {
+			throw new RangeError('<hr>总是写作不少于4个的连续"-"！');
+		}
+		return super.setText(str);
+	}
 }
 
+Parser.classes.HrToken = __filename;
 module.exports = HrToken;

package/src/nowiki/index.js

@@ -1,14 +1,16 @@
 'use strict';
 
 const {generateForSelf} = require('../../util/lint'),
+	fixedToken = require('../../mixin/fixedToken'),
 	Parser = require('../..'),
+	AstText = require('../../lib/text'),
 	Token = require('..');
 
 /**
  * 纯文字Token，不会被解析
  * @classdesc `{childNodes: [AstText]}`
  */
-class NowikiToken extends Token {
+class NowikiToken extends fixedToken(Token) {
 	type = 'ext-inner';
 
 	/**
@@ -29,6 +31,26 @@ class NowikiToken extends Token {
 			? [generateForSelf(this, {start}, `<${name}>标签内不应有任何内容`)]
 			: super.lint(start);
 	}
+
+	/**
+	 * @override
+	 * @this {NowikiToken & {firstChild: AstText, constructor: typeof NowikiToken}}
+	 */
+	cloneNode() {
+		const {constructor, firstChild: {data}, type} = this,
+			token = Parser.run(() => new constructor(data, this.getAttribute('config')));
+		token.type = type;
+		return token;
+	}
+
+	/**
+	 * @override
+	 * @param {string} str 新文本
+	 */
+	setText(str) {
+		return super.setText(str, 0);
+	}
 }
 
+Parser.classes.NowikiToken = __filename;
 module.exports = NowikiToken;

package/src/nowiki/list.js

@@ -1,13 +1,16 @@
 'use strict';
 
-const DdToken = require('./dd');
+const sol = require('../../mixin/sol'),
+	Parser = require('../..'),
+	DdToken = require('./dd');
 
 /**
  * ;:*#
  * @classdesc `{childNodes: [AstText]}`
  */
-class ListToken extends DdToken {
+class ListToken extends sol(DdToken) {
 	type = 'list';
 }
 
+Parser.classes.ListToken = __filename;
 module.exports = ListToken;

package/src/nowiki/noinclude.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const hidden = require('../../mixin/hidden'),
+	Parser = require('../..'),
 	NowikiToken = require('.');
 
 /**
@@ -9,6 +10,19 @@ const hidden = require('../../mixin/hidden'),
  */
 class NoincludeToken extends hidden(NowikiToken) {
 	type = 'noinclude';
+
+	/**
+	 * @override
+	 * @param {string} str 新文本
+	 * @throws `Error` 不可更改
+	 */
+	setText(str) {
+		if (/^<\/?(?:(?:no|only)include|includeonly)(?:\s.*)?\/?>$/isu.test(String(this))) {
+			throw new Error(`${this.constructor.name} 不可更改文字内容！`);
+		}
+		return super.setText(str);
+	}
 }
 
+Parser.classes.NoincludeToken = __filename;
 module.exports = NoincludeToken;

package/src/nowiki/quote.js

@@ -18,6 +18,7 @@ class QuoteToken extends NowikiToken {
 	 */
 	constructor(n, config = Parser.getConfig(), accum = []) {
 		super("'".repeat(n), config, accum);
+		this.setAttribute('name', String(n));
 	}
 
 	/**
@@ -30,11 +31,11 @@ class QuoteToken extends NowikiToken {
 			message = `孤立的"'"`,
 			/** @type {LintError[]} */ errors = [];
 		let refError, wikitext;
-		if (previousSibling?.type === 'text' && previousSibling.data.endsWith("'")) {
+		if (previousSibling?.type === 'text' && previousSibling.data.at(-1) === "'") {
 			refError = generateForSelf(this, {start}, message);
 			wikitext = String(this.getRootNode());
 			const {startIndex: endIndex, startLine: endLine, startCol: endCol} = refError,
-				[, {length}] = previousSibling.data.match(/(?:^|[^'])('+)$/u),
+				[{length}] = previousSibling.data.match(/(?<!')'+$/u),
 				startIndex = start - length,
 				excerpt = wikitext.slice(startIndex, startIndex + 50);
 			errors.push({...refError, startIndex, endIndex, startCol: endCol - length, endLine, endCol, excerpt});
@@ -50,6 +51,19 @@ class QuoteToken extends NowikiToken {
 		}
 		return errors;
 	}
+
+	/**
+	 * @override
+	 * @param {string} str 新文本
+	 * @throws `RangeError` 错误的单引号语法
+	 */
+	setText(str) {
+		if (str === "''" || str === "'''" || str === "'''''") {
+			return super.setText(str);
+		}
+		throw new RangeError(`${this.constructor.name} 的内部文本只能为连续 2/3/5 个"'"！`);
+	}
 }
 
+Parser.classes.QuoteToken = __filename;
 module.exports = QuoteToken;

package/src/onlyinclude.js

@@ -10,6 +10,11 @@ const Parser = require('..'),
 class OnlyincludeToken extends Token {
 	type = 'onlyinclude';
 
+	/** 内部wikitext */
+	get innerText() {
+		return this.text();
+	}
+
 	/**
 	 * @param {string} inner 标签内部wikitext
 	 * @param {accum} accum
@@ -20,9 +25,10 @@ class OnlyincludeToken extends Token {
 
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
-		return `<onlyinclude>${super.toString()}</onlyinclude>`;
+		return selector && this.matches(selector) ? '' : `<onlyinclude>${super.toString(selector)}</onlyinclude>`;
 	}
 
 	/** @override */
@@ -30,10 +36,29 @@ class OnlyincludeToken extends Token {
 		return 13;
 	}
 
+	/** @override */
+	print() {
+		return super.print({
+			pre: '<span class="wpb-ext">&lt;onlyinclude&gt;</span>',
+			post: '<span class="wpb-ext">&lt;/onlyinclude&gt;</span>',
+		});
+	}
+
 	/** @override */
 	isPlain() {
 		return true;
 	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new OnlyincludeToken(undefined, this.getAttribute('config'));
+			token.append(...cloned);
+			return token;
+		});
+	}
 }
 
+Parser.classes.OnlyincludeToken = __filename;
 module.exports = OnlyincludeToken;

package/src/paramTag/index.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const {generateForChild} = require('../../util/lint'),
+	singleLine = require('../../mixin/singleLine'),
 	Parser = require('../..'),
 	Token = require('..'),
 	AtomToken = require('../atom');
@@ -18,11 +19,13 @@ class ParamTagToken extends Token {
 	 */
 	constructor(wikitext, config = Parser.getConfig(), accum = []) {
 		super(undefined, config, true, accum, {
+			SingleLineAtomToken: ':',
 		});
 		if (wikitext) {
-			const SingleLineAtomToken = AtomToken;
+			const SingleLineAtomToken = singleLine(AtomToken);
 			this.append(
 				...wikitext.split('\n').map(line => new SingleLineAtomToken(line, 'param-line', config, accum, {
+					AstText: ':',
 				})),
 			);
 		}
@@ -30,6 +33,7 @@ class ParamTagToken extends Token {
 
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
 		return super.toString(selector, '\n');
@@ -45,6 +49,11 @@ class ParamTagToken extends Token {
 		return 1;
 	}
 
+	/** @override */
+	print() {
+		return super.print({sep: '\n'});
+	}
+
 	/**
 	 * @override
 	 * @param {number} start 起始位置
@@ -61,6 +70,20 @@ class ParamTagToken extends Token {
 			return generateForChild(child, rect, `${this.name}的无效参数`);
 		});
 	}
+
+	/**
+	 * @override
+	 * @this {ParamTagToken & {constructor: typeof ParamTagToken}}
+	 */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new this.constructor(undefined, this.getAttribute('config'));
+			token.append(...cloned);
+			return token;
+		});
+	}
 }
 
+Parser.classes.ParamTagToken = __filename;
 module.exports = ParamTagToken;