wikiparser-node 0.11.0-m → 0.11.0

package/src/hasNowiki/index.js

@@ -24,9 +24,21 @@ class HasNowikiToken extends Token {
 			},
 		);
 		super(wikitext, config, true, accum, {
+			AstText: ':', NoincludeToken: ':',
 		});
 		this.type = type;
 	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new HasNowikiToken(undefined, this.type, this.getAttribute('config'));
+			token.append(...cloned);
+			return token;
+		});
+	}
 }
 
+Parser.classes.HasNowikiToken = __filename;
 module.exports = HasNowikiToken;

package/src/hasNowiki/pre.js

@@ -17,12 +17,24 @@ class PreToken extends HasNowikiToken {
 	constructor(wikitext, config = Parser.getConfig(), accum = []) {
 		super(wikitext, 'ext-inner', config, accum);
 		this.setAttribute('stage', Parser.MAX_STAGE - 1);
+		this.setAttribute('acceptable', {AstText: ':', NoincludeToken: ':', ConverterToken: ':'});
 	}
 
 	/** @override */
 	isPlain() {
 		return true;
 	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new PreToken(undefined, this.getAttribute('config'));
+			token.append(...cloned);
+			return token;
+		});
+	}
 }
 
+Parser.classes.PreToken = __filename;
 module.exports = PreToken;

package/src/heading.js

@@ -1,6 +1,8 @@
 'use strict';
 
 const {generateForSelf} = require('../util/lint'),
+	fixedToken = require('../mixin/fixedToken'),
+	sol = require('../mixin/sol'),
 	Parser = require('..'),
 	Token = require('.'),
 	SyntaxToken = require('./syntax');
@@ -9,9 +11,14 @@ const {generateForSelf} = require('../util/lint'),
  * 章节标题
  * @classdesc `{childNodes: [Token, SyntaxToken]}`
  */
-class HeadingToken extends Token {
+class HeadingToken extends fixedToken(sol(Token)) {
 	type = 'heading';
 
+	/** 内部wikitext */
+	get innerText() {
+		return this.firstChild.text();
+	}
+
 	/**
 	 * @param {number} level 标题层级
 	 * @param {string[]} input 标题文字
@@ -22,28 +29,37 @@ class HeadingToken extends Token {
 		this.setAttribute('name', String(level));
 		const token = new Token(input[0], config, true, accum);
 		token.type = 'heading-title';
+		token.setAttribute('name', this.name);
 		token.setAttribute('stage', 2);
 		const trail = new SyntaxToken(input[1], /^[^\S\n]*$/u, 'heading-trail', config, accum, {
+			'Stage-1': ':', '!ExtToken': '',
 		});
 		this.append(token, trail);
 	}
 
 	/**
 	 * @override
+	 * @this {{prependNewLine(): ''|'\n'} & HeadingToken}
+	 * @param {string} selector
 	 * @returns {string}
 	 */
 	toString(selector) {
 		const equals = '='.repeat(Number(this.name));
-		return `${equals}${this.firstChild.toString()}${equals}${this.lastChild.toString()}`;
+		return selector && this.matches(selector)
+			? ''
+			: `${this.prependNewLine()}${equals}${
+				this.firstChild.toString(selector)
+			}${equals}${this.lastChild.toString(selector)}`;
 	}
 
 	/**
 	 * @override
+	 * @this {HeadingToken & {prependNewLine(): ''|'\n'}}
 	 * @returns {string}
 	 */
 	text() {
 		const equals = '='.repeat(Number(this.name));
-		return `${equals}${this.firstChild.text()}${equals}`;
+		return `${this.prependNewLine()}${equals}${this.firstChild.text()}${equals}`;
 	}
 
 	/** @override */
@@ -56,6 +72,12 @@ class HeadingToken extends Token {
 		return Number(this.name);
 	}
 
+	/** @override */
+	print() {
+		const equals = '='.repeat(Number(this.name));
+		return super.print({pre: equals, sep: equals});
+	}
+
 	/**
 	 * @override
 	 * @param {number} start 起始位置
@@ -78,6 +100,35 @@ class HeadingToken extends Token {
 		}
 		return errors;
 	}
+
+	/** @override */
+	cloneNode() {
+		const [title, trail] = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new HeadingToken(Number(this.name), [], this.getAttribute('config'));
+			token.firsthild.safeReplaceWith(title);
+			token.lastChild.safeReplaceWith(trail);
+			return token;
+		});
+	}
+
+	/**
+	 * 设置标题层级
+	 * @param {number} n 标题层级
+	 */
+	setLevel(n) {
+		if (!Number.isInteger(n)) {
+			this.typeError('setLevel', 'Number');
+		}
+		n = Math.min(Math.max(n, 1), 6);
+		this.setAttribute('name', String(n)).firstChild.setAttribute('name', this.name);
+	}
+
+	/** 移除标题后的不可见内容 */
+	removeTrail() {
+		this.lastChild.replaceChildren();
+	}
 }
 
+Parser.classes.HeadingToken = __filename;
 module.exports = HeadingToken;

package/src/html.js

@@ -1,6 +1,9 @@
 'use strict';
 
 const {generateForSelf} = require('../util/lint'),
+	{noWrap} = require('../util/string'),
+	fixedToken = require('../mixin/fixedToken'),
+	attributeParent = require('../mixin/attributeParent'),
 	Parser = require('..'),
 	Token = require('.');
 
@@ -10,7 +13,7 @@ const magicWords = new Set(['if', 'ifeq', 'ifexpr', 'ifexist', 'iferror', 'switc
  * HTML标签
  * @classdesc `{childNodes: [AttributesToken]}`
  */
-class HtmlToken extends Token {
+class HtmlToken extends attributeParent(fixedToken(Token)) {
 	type = 'html';
 	#closing;
 	#selfClosing;
@@ -21,6 +24,41 @@ class HtmlToken extends Token {
 		return this.#closing;
 	}
 
+	/** @throws `Error` 自闭合标签或空标签 */
+	set closing(value) {
+		if (!value) {
+			this.#closing = false;
+			return;
+		} else if (this.#selfClosing) {
+			throw new Error('这是一个自闭合标签！');
+		}
+		const {html: [,, tags]} = this.getAttribute('config');
+		if (tags.includes(this.name)) {
+			throw new Error('这是一个空标签！');
+		}
+		this.#closing = true;
+	}
+
+	/** getter */
+	get selfClosing() {
+		return this.#selfClosing;
+	}
+
+	/** @throws `Error` 闭合标签或无效自闭合标签 */
+	set selfClosing(value) {
+		if (!value) {
+			this.#selfClosing = false;
+			return;
+		} else if (this.#closing) {
+			throw new Error('这是一个闭合标签！');
+		}
+		const {html: [tags]} = this.getAttribute('config');
+		if (tags.includes(this.name)) {
+			throw new Error(`<${this.name}>标签自闭合无效！`);
+		}
+		this.#selfClosing = true;
+	}
+
 	/**
 	 * @param {string} name 标签名
 	 * @param {AttributesToken} attr 标签属性
@@ -39,9 +77,12 @@ class HtmlToken extends Token {
 
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
-		return `<${this.#closing ? '/' : ''}${this.#tag}${super.toString()}${this.#selfClosing ? '/' : ''}>`;
+		return selector && this.matches(selector)
+			? ''
+			: `<${this.#closing ? '/' : ''}${this.#tag}${super.toString(selector)}${this.#selfClosing ? '/' : ''}>`;
 	}
 
 	/** @override */
@@ -56,6 +97,14 @@ class HtmlToken extends Token {
 		return this.#tag.length + (this.#closing ? 2 : 1);
 	}
 
+	/** @override */
+	print() {
+		return super.print({
+			pre: `&lt;${this.#closing ? '/' : ''}${this.#tag}`,
+			post: `${this.#selfClosing ? '/' : ''}&gt;`,
+		});
+	}
+
 	/**
 	 * @override
 	 * @param {number} start 起始位置
@@ -106,7 +155,7 @@ class HtmlToken extends Token {
 	findMatchingTag() {
 		const {html} = this.getAttribute('config'),
 			{name: tagName, parentNode} = this,
-			string = String(this);
+			string = noWrap(String(this));
 		if (this.#closing && (this.#selfClosing || html[2].includes(tagName))) {
 			throw new SyntaxError(`tag that is both closing and self-closing: ${string}`);
 		} else if (html[2].includes(tagName) || this.#selfClosing && html[1].includes(tagName)) { // 自封闭标签
@@ -134,6 +183,72 @@ class HtmlToken extends Token {
 		}
 		throw new SyntaxError(`${this.#closing ? 'unmatched closing' : 'unclosed'} tag: ${string}`);
 	}
+
+	/** @override */
+	cloneNode() {
+		const [attr] = this.cloneChildNodes(),
+			config = this.getAttribute('config');
+		return Parser.run(() => new HtmlToken(this.#tag, attr, this.#closing, this.#selfClosing, config));
+	}
+
+	/**
+	 * @override
+	 * @template {string} T
+	 * @param {T} key 属性键
+	 * @returns {import('../typings/node').TokenAttribute<T>}
+	 */
+	getAttribute(key) {
+		return key === 'tag' ? this.#tag : super.getAttribute(key);
+	}
+
+	/**
+	 * 更换标签名
+	 * @param {string} tag 标签名
+	 * @throws `RangeError` 非法的HTML标签
+	 */
+	replaceTag(tag) {
+		const name = tag.toLowerCase();
+		if (!this.getAttribute('config').html.flat().includes(name)) {
+			throw new RangeError(`非法的HTML标签：${tag}`);
+		}
+		this.setAttribute('name', name).#tag = tag;
+	}
+
+	/** 局部闭合 */
+	#localMatch() {
+		this.#selfClosing = false;
+		const root = Parser.parse(`</${this.name}>`, false, 3, this.getAttribute('config'));
+		this.after(root.firstChild);
+	}
+
+	/**
+	 * 修复无效自封闭标签
+	 * @complexity `n`
+	 * @throws `Error` 无法修复无效自封闭标签
+	 */
+	fix() {
+		const config = this.getAttribute('config'),
+			{parentNode, name: tagName, firstChild} = this;
+		if (!parentNode || !this.#selfClosing || !config.html[0].includes(tagName)) {
+			return;
+		} else if (firstChild.text().trim()) {
+			this.#localMatch();
+			return;
+		}
+		const {childNodes} = parentNode,
+			i = childNodes.indexOf(this),
+			/** @type {HtmlToken[]} */
+			prevSiblings = childNodes.slice(0, i).filter(({type, name}) => type === 'html' && name === tagName),
+			imbalance = prevSiblings.reduce((acc, {closing}) => acc + (closing ? 1 : -1), 0);
+		if (imbalance < 0) {
+			this.#selfClosing = false;
+			this.#closing = true;
+		} else {
+			Parser.warn('无法修复无效自封闭标签', noWrap(String(this)));
+			throw new Error(`无法修复无效自封闭标签：前文共有 ${imbalance} 个未匹配的闭合标签`);
+		}
+	}
 }
 
+Parser.classes.HtmlToken = __filename;
 module.exports = HtmlToken;

package/src/imageParameter.js

@@ -1,9 +1,10 @@
 'use strict';
 
-const {extUrlChar, extUrlCharFirst} = require('../util/string'),
+const {text, noWrap, print, extUrlChar, extUrlCharFirst} = require('../util/string'),
 	{generateForSelf} = require('../util/lint'),
 	Title = require('../lib/title'),
 	Parser = require('..'),
+	AstText = require('../lib/text'),
 	Token = require('.');
 
 const params = new Set(['alt', 'link', 'lang', 'page', 'caption']);
@@ -61,6 +62,66 @@ class ImageParameterToken extends Token {
 		return this.name === 'link' ? validate('link', super.text(), this.getAttribute('config')) : undefined;
 	}
 
+	set link(value) {
+		if (this.name === 'link') {
+			this.setValue(value);
+		}
+	}
+
+	/** getValue()的getter */
+	get value() {
+		return this.getValue();
+	}
+
+	set value(value) {
+		this.setValue(value);
+	}
+
+	/** 图片大小 */
+	get size() {
+		if (this.name === 'width') {
+			const /** @type {string} */ size = this.getValue().trim();
+			if (!size.includes('{{')) {
+				const [width, height = ''] = size.split('x');
+				return {width, height};
+			}
+			const /** @type {{childNodes: AstText[]}} */ token = Parser.parse(size, false, 2, this.getAttribute('config')),
+				i = token.childNodes.findIndex(({type, data}) => type === 'text' && data.includes('x')),
+				str = token.childNodes[i];
+			if (i === -1) {
+				return {width: size, height: ''};
+			}
+			str.splitText(str.data.indexOf('x'));
+			str.nextSibling.splitText(1);
+			return {width: text(token.childNodes.slice(0, i + 1)), height: text(token.childNodes.slice(i + 2))};
+		}
+		return undefined;
+	}
+
+	/** 图片宽度 */
+	get width() {
+		return this.size?.width;
+	}
+
+	set width(width) {
+		if (this.name === 'width') {
+			const {height} = this;
+			this.setValue(`${String(width || '')}${height && 'x'}${height}`);
+		}
+	}
+
+	/** 图片高度 */
+	get height() {
+		return this.size?.height;
+	}
+
+	set height(height) {
+		height = String(height || '');
+		if (this.name === 'width') {
+			this.setValue(`${this.width}${height && 'x'}${height}`);
+		}
+	}
+
 	/**
 	 * @param {string} str 图片参数
 	 * @param {import('../typings/token').accum} accum
@@ -81,6 +142,7 @@ class ImageParameterToken extends Token {
 				this.#syntax = str;
 			} else {
 				super(mt[2], config, true, accum, {
+					'Stage-2': ':', '!HeadingToken': ':',
 				});
 				this.#syntax = `${mt[1]}${param[0]}${mt[3]}`;
 			}
@@ -105,9 +167,10 @@ class ImageParameterToken extends Token {
 
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
-		return this.#syntax
+		return this.#syntax && !(selector && this.matches(selector))
 			? this.#syntax.replace('$1', super.toString(selector))
 			: super.toString(selector);
 	}
@@ -136,6 +199,105 @@ class ImageParameterToken extends Token {
 		}
 		return errors;
 	}
+
+	/** @override */
+	print() {
+		return this.#syntax
+			? `<span class="wpb-image-parameter">${
+				this.#syntax.replace('$1', `<span class="wpb-image-caption">${print(this.childNodes)}</span>`)
+			}</span>`
+			: super.print({class: 'image-caption'});
+	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes(),
+			config = this.getAttribute('config');
+		return Parser.run(() => {
+			const token = new ImageParameterToken(this.#syntax.replace('$1', ''), config);
+			token.replaceChildren(...cloned);
+			return token;
+		});
+	}
+
+	/**
+	 * @override
+	 * @template {string} T
+	 * @param {T} key 属性键
+	 * @returns {import('../typings/node').TokenAttribute<T>}
+	 */
+	getAttribute(key) {
+		return key === 'syntax' ? this.#syntax : super.getAttribute(key);
+	}
+
+	/**
+	 * @override
+	 * @param {PropertyKey} key 属性键
+	 */
+	hasAttribute(key) {
+		return key === 'syntax' || super.hasAttribute(key);
+	}
+
+	/** 是否是不可变参数 */
+	#isVoid() {
+		return this.#syntax && !this.#syntax.includes('$1');
+	}
+
+	/**
+	 * @override
+	 * @template {Token} T
+	 * @param {T} token 待插入的子节点
+	 * @param {number} i 插入位置
+	 * @complexity `n`
+	 * @throws `Error` 不接受自定义输入的图片参数
+	 */
+	insertAt(token, i = this.length) {
+		if (!Parser.running && this.#isVoid()) {
+			throw new Error(`图片参数 ${this.name} 不接受自定义输入！`);
+		}
+		return super.insertAt(token, i);
+	}
+
+	/**
+	 * 获取参数值
+	 * @complexity `n`
+	 */
+	getValue() {
+		return this.name === 'invalid' ? this.text() : this.#isVoid() || super.text();
+	}
+
+	/**
+	 * 设置参数值
+	 * @param {string|boolean} value 参数值
+	 * @complexity `n`
+	 * @throws	SyntaxError` 非法的参数值
+	 */
+	setValue(value) {
+		if (this.name === 'invalid') {
+			throw new Error('无效的图片参数！');
+		} else if (this.#isVoid()) {
+			if (typeof value !== 'boolean') {
+				this.typeError('setValue', 'Boolean');
+			} else if (value === false) {
+				this.remove();
+			}
+			return;
+		} else if (typeof value !== 'string') {
+			this.typeError('setValue', 'String');
+		}
+		const root = Parser.parse(`[[File:F|${
+				this.#syntax ? this.#syntax.replace('$1', value) : value
+			}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
+			{length, firstChild: file} = root,
+			{lastChild: imageParameter, type, name, length: fileLength} = file;
+		if (length !== 1 || type !== 'file' || name !== 'File:F' || fileLength !== 2
+			|| imageParameter.name !== this.name
+		) {
+			throw new SyntaxError(`非法的 ${this.name} 参数：${noWrap(value)}`);
+		}
+		this.replaceChildren(...imageParameter.childNodes);
+	}
 }
 
+Parser.classes.ImageParameterToken = __filename;
 module.exports = ImageParameterToken;

package/src/imagemap.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const {generateForSelf, generateForChild} = require('../util/lint'),
+	singleLine = require('../mixin/singleLine'),
 	Parser = require('..'),
 	Token = require('.'),
 	NoincludeToken = require('./nowiki/noinclude'),
@@ -23,6 +24,14 @@ class ImagemapToken extends Token {
 		return this.childNodes.find(({type}) => type === 'imagemap-image');
 	}
 
+	/**
+	 * 链接
+	 * @returns {ImagemapLinkToken[]}
+	 */
+	get links() {
+		return this.childNodes.filter(({type}) => type === 'imagemap-link');
+	}
+
 	/**
 	 * @param {string} inner 标签内部wikitext
 	 * @param {import('../typings/token').accum} accum
@@ -30,13 +39,14 @@ class ImagemapToken extends Token {
 	 */
 	constructor(inner, config = Parser.getConfig(), accum = []) {
 		super(undefined, config, true, accum, {
+			GalleryImageToken: ':', ImagemapLinkToken: ':', SingleLineNoincludeToken: ':', AstText: ':',
 		});
 		if (!inner) {
 			return;
 		}
 		const lines = inner.split('\n'),
 			protocols = new Set(config.protocol.split('|')),
-			SingleLineNoincludeToken = NoincludeToken,
+			SingleLineNoincludeToken = singleLine(NoincludeToken),
 			fallback = /** @param {string} line 一行文本 */ line => {
 				super.insertAt(new SingleLineNoincludeToken(line, config, accum));
 			};
@@ -49,7 +59,7 @@ class ImagemapToken extends Token {
 			} else if (first) {
 				const [file, ...options] = line.split('|'),
 					title = this.normalizeTitle(file, 0, true);
-				if (title.valid && title.ns === 6) {
+				if (title.valid && !title.interwiki && title.ns === 6) {
 					const token = new GalleryImageToken(
 						file, options.length > 0 ? options.join('|') : undefined, config, accum,
 					);
@@ -58,6 +68,7 @@ class ImagemapToken extends Token {
 					first = false;
 					continue;
 				} else {
+					Parser.error('<imagemap>标签内必须先包含一张合法图片！', line);
 					error = true;
 				}
 			} else if (line.trim().split(/[\t ]/u)[0] === 'desc') {
@@ -101,6 +112,7 @@ class ImagemapToken extends Token {
 
 	/**
 	 * @override
+	 * @param {string} selector
 	 */
 	toString(selector) {
 		return super.toString(selector, '\n');
@@ -116,6 +128,11 @@ class ImagemapToken extends Token {
 		return 1;
 	}
 
+	/** @override */
+	print() {
+		return super.print({sep: '\n'});
+	}
+
 	/**
 	 * @override
 	 * @param {number} start 起始位置
@@ -135,6 +152,48 @@ class ImagemapToken extends Token {
 		}
 		return errors;
 	}
+
+	/**
+	 * @override
+	 * @template {string|Token} T
+	 * @param {T} token 待插入的节点
+	 * @param {number} i 插入位置
+	 * @throws `Error` 当前缺少合法图片
+	 * @throws `RangeError` 已有一张合法图片
+	 */
+	insertAt(token, i = 0) {
+		const {image} = this;
+		if (!image && (token.type === 'imagemap-link' || token.type === 'text')) {
+			throw new Error('当前缺少一张合法图片！');
+		} else if (image && token.type === 'imagemap-image') {
+			throw new RangeError('已有一张合法图片！');
+		}
+		return super.insertAt(token, i);
+	}
+
+	/**
+	 * @override
+	 * @param {number} i 移除位置
+	 * @throws `Error` 禁止移除图片
+	 */
+	removeAt(i) {
+		const child = this.childNodes[i];
+		if (child.type === 'imagemap-image') {
+			throw new Error('禁止移除<imagemap>内的图片！');
+		}
+		return super.removeAt(i);
+	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new ImagemapToken(undefined, this.getAttribute('config'));
+			token.append(...cloned);
+			return token;
+		});
+	}
 }
 
+Parser.classes.ImagemapToken = __filename;
 module.exports = ImagemapToken;

package/src/imagemapLink.js

@@ -1,6 +1,9 @@
 'use strict';
 
 const Title = require('../lib/title'),
+	fixedToken = require('../mixin/fixedToken'),
+	singleLine = require('../mixin/singleLine'),
+	Parser = require('..'),
 	Token = require('.'),
 	NoincludeToken = require('./nowiki/noinclude'),
 	LinkToken = require('./link'),
@@ -10,9 +13,17 @@ const Title = require('../lib/title'),
  * `<imagemap>`内的链接
  * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
  */
-class ImagemapLinkToken extends Token {
+class ImagemapLinkToken extends fixedToken(singleLine(Token)) {
 	type = 'imagemap-link';
 
+	/**
+	 * 内外链接
+	 * @this {{childNodes: (LinkToken|ExtLinkToken)[]}}
+	 */
+	get link() {
+		return this.childNodes[1].link;
+	}
+
 	/**
 	 * @param {string} pre 链接前的文本
 	 * @param {[string, string, string|Title]} linkStuff 内外链接
@@ -26,4 +37,5 @@ class ImagemapLinkToken extends Token {
 	}
 }
 
+Parser.classes.ImagemapLinkToken = __filename;
 module.exports = ImagemapLinkToken;