wikiparser-node 0.4.0 → 0.6.1

package/src/hasNowiki/pre.js

@@ -0,0 +1,40 @@
+'use strict';
+
+const Parser = require('../..'),
+	HasNowikiToken = require('.');
+
+/**
+ * `<pre>`
+ * @classdesc `{childNodes: [...AstText|NoincludeToken|ConverterToken]}`
+ */
+class PreToken extends HasNowikiToken {
+	name = 'pre';
+
+	/**
+	 * @param {string} wikitext wikitext
+	 * @param {accum} accum
+	 */
+	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,7 @@
 'use strict';
 
-const fixedToken = require('../mixin/fixedToken'),
+const {generateForSelf} = require('../util/lint'),
+	fixedToken = require('../mixin/fixedToken'),
 	sol = require('../mixin/sol'),
 	Parser = require('..'),
 	Token = require('.');
@@ -14,7 +15,7 @@ class HeadingToken extends fixedToken(sol(Token)) {
 
 	/** 内部wikitext */
 	get innerText() {
-		return this.firstElementChild.text();
+		return this.firstChild.text();
 	}
 
 	/**
@@ -27,7 +28,8 @@ class HeadingToken extends fixedToken(sol(Token)) {
 		this.setAttribute('name', String(level));
 		const token = new Token(input[0], config, true, accum);
 		token.type = 'heading-title';
-		token.setAttribute('name', this.name).setAttribute('stage', 2);
+		token.setAttribute('name', this.name);
+		token.setAttribute('stage', 2);
 		const SyntaxToken = require('./syntax');
 		const trail = new SyntaxToken(input[1], /^[^\S\n]*$/u, 'heading-trail', config, accum, {
 			'Stage-1': ':', '!ExtToken': '',
@@ -35,27 +37,19 @@ class HeadingToken extends fixedToken(sol(Token)) {
 		this.append(token, trail);
 	}
 
-	/** @override */
-	cloneNode() {
-		const [title, trail] = this.cloneChildNodes(),
-			token = Parser.run(() => new HeadingToken(Number(this.name), [], this.getAttribute('config')));
-		token.firstElementChild.safeReplaceWith(title);
-		token.lastElementChild.safeReplaceWith(trail);
-		return token;
-	}
-
 	/**
 	 * @override
 	 * @this {{prependNewLine(): ''|'\n', appendNewLine(): ''|'\n'} & HeadingToken}
 	 * @param {string} selector
+	 * @returns {string}
 	 */
 	toString(selector) {
 		const equals = '='.repeat(Number(this.name));
 		return selector && this.matches(selector)
 			? ''
 			: `${this.prependNewLine()}${equals}${
-				this.firstElementChild.toString(selector)
-			}${equals}${this.lastElementChild.toString(selector)}${this.appendNewLine()}`;
+				this.firstChild.toString(selector)
+			}${equals}${this.lastChild.toString(selector)}${this.appendNewLine()}`;
 	}
 
 	/** @override */
@@ -68,6 +62,35 @@ class HeadingToken extends fixedToken(sol(Token)) {
 		return Number(this.name);
 	}
 
+	/** @override */
+	print() {
+		const equals = '='.repeat(Number(this.name));
+		return super.print({pre: equals, sep: equals});
+	}
+
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const errors = super.lint(start);
+		if (this.name === '1') {
+			errors.push(generateForSelf(this, this.getRootNode().posFromIndex(start), '<h1>'));
+		}
+		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;
+		});
+	}
+
 	/**
 	 * @override
 	 * @this {HeadingToken & {prependNewLine(): ''|'\n', appendNewLine(): ''|'\n'}}
@@ -75,7 +98,7 @@ class HeadingToken extends fixedToken(sol(Token)) {
 	 */
 	text() {
 		const equals = '='.repeat(Number(this.name));
-		return `${this.prependNewLine()}${equals}${this.firstElementChild.text()}${equals}${this.appendNewLine()}`;
+		return `${this.prependNewLine()}${equals}${this.firstChild.text()}${equals}${this.appendNewLine()}`;
 	}
 
 	/**
@@ -83,16 +106,16 @@ class HeadingToken extends fixedToken(sol(Token)) {
 	 * @param {number} n 标题层级
 	 */
 	setLevel(n) {
-		if (typeof n !== 'number') {
+		if (!Number.isInteger(n)) {
 			this.typeError('setLevel', 'Number');
 		}
 		n = Math.min(Math.max(n, 1), 6);
-		this.setAttribute('name', String(n)).firstElementChild.setAttribute('name', this.name);
+		this.setAttribute('name', String(n)).firstChild.setAttribute('name', this.name);
 	}
 
 	/** 移除标题后的不可见内容 */
 	removeTrail() {
-		this.lastElementChild.replaceChildren();
+		this.lastChild.replaceChildren();
 	}
 }
 

package/src/html.js

@@ -1,6 +1,7 @@
 'use strict';
 
 const {noWrap} = require('../util/string'),
+	{generateForSelf} = require('../util/lint'),
 	fixedToken = require('../mixin/fixedToken'),
 	attributeParent = require('../mixin/attributeParent'),
 	Parser = require('..'),
@@ -27,11 +28,11 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 			this.#closing = false;
 			return;
 		} else if (this.#selfClosing) {
-			throw new Error(`这是一个自闭合标签！`);
+			throw new Error('这是一个自闭合标签！');
 		}
 		const {html: [,, tags]} = this.getAttribute('config');
 		if (tags.includes(this.name)) {
-			throw new Error(`这是一个空标签！`);
+			throw new Error('这是一个空标签！');
 		}
 		this.#closing = true;
 	}
@@ -65,30 +66,13 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 	 */
 	constructor(name, attr, closing, selfClosing, config = Parser.getConfig(), accum = []) {
 		super(undefined, config, true, accum);
-		this.appendChild(attr);
+		this.insertAt(attr);
 		this.setAttribute('name', name.toLowerCase());
 		this.#closing = closing;
 		this.#selfClosing = selfClosing;
 		this.#tag = name;
 	}
 
-	/** @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 {TokenAttribute<T>}
-	 */
-	getAttribute(key) {
-		return key === 'tag' ? this.#tag : super.getAttribute(key);
-	}
-
 	/**
 	 * @override
 	 * @param {string} selector
@@ -105,21 +89,31 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 	}
 
 	/** @override */
-	text() {
-		return `<${this.#closing ? '/' : ''}${this.#tag}${super.text()}${this.#selfClosing ? '/' : ''}>`;
+	print() {
+		return super.print({
+			pre: `&lt;${this.#closing ? '/' : ''}${this.#tag}`, post: `${this.#selfClosing ? '/' : ''}&gt;`,
+		});
 	}
 
 	/**
-	 * 更换标签名
-	 * @param {string} tag 标签名
-	 * @throws `RangeError` 非法的HTML标签
+	 * @override
+	 * @param {number} start 起始位置
 	 */
-	replaceTag(tag) {
-		const name = tag.toLowerCase();
-		if (!this.getAttribute('config').html.flat().includes(name)) {
-			throw new RangeError(`非法的HTML标签：${tag}`);
+	lint(start = 0) {
+		const errors = super.lint(start);
+		let /** @type {LintError} */ refError;
+		if (this.name === 'h1' && !this.#closing) {
+			refError = generateForSelf(this, this.getRootNode().posFromIndex(start), '<h1>');
+			errors.push(refError);
 		}
-		this.setAttribute('name', name).#tag = tag;
+		try {
+			this.findMatchingTag();
+		} catch ({message: errorMsg}) {
+			const [message] = errorMsg.split('：');
+			refError ||= generateForSelf(this, this.getRootNode().posFromIndex(start), '');
+			errors.push({...refError, message, severity: message === '未闭合的标签' ? 'warning' : 'error'});
+		}
+		return errors;
 	}
 
 	/**
@@ -131,24 +125,23 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 	 */
 	findMatchingTag() {
 		const {html} = this.getAttribute('config'),
-			{name, parentNode, closing, selfClosing} = this,
+			{name: tagName, parentNode} = this,
 			string = noWrap(String(this));
-		if (closing && selfClosing) {
+		if (this.#closing && this.#selfClosing) {
 			throw new SyntaxError(`同时闭合和自封闭的标签：${string}`);
-		} else if (html[2].includes(name) || selfClosing && html[1].includes(name)) { // 自封闭标签
+		} else if (html[2].includes(tagName) || this.#selfClosing && html[1].includes(tagName)) { // 自封闭标签
 			return this;
-		} else if (selfClosing && html[0].includes(name)) {
+		} else if (this.#selfClosing && html[0].includes(tagName)) {
 			throw new SyntaxError(`无效自封闭标签：${string}`);
 		} else if (!parentNode) {
 			return undefined;
 		}
-		const {children} = parentNode,
-			i = children.indexOf(this),
-			selector = `html#${name}`,
-			siblings = closing
-				? children.slice(0, i).reverse().filter(child => child.matches(selector))
-				: children.slice(i + 1).filter(child => child.matches(selector));
-		let imbalance = closing ? -1 : 1;
+		const {childNodes} = parentNode,
+			i = childNodes.indexOf(this),
+			siblings = this.#closing
+				? childNodes.slice(0, i).reverse().filter(({type, name}) => type === 'html' && name === tagName)
+				: childNodes.slice(i + 1).filter(({type, name}) => type === 'html' && name === tagName);
+		let imbalance = this.#closing ? -1 : 1;
 		for (const token of siblings) {
 			if (token.closing) {
 				imbalance--;
@@ -159,7 +152,42 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 				return token;
 			}
 		}
-		throw new SyntaxError(`未${closing ? '匹配的闭合' : '闭合的'}标签：${string}`);
+		throw new SyntaxError(`未${this.#closing ? '匹配的闭合' : '闭合的'}标签：${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 {TokenAttribute<T>}
+	 */
+	getAttribute(key) {
+		return key === 'tag' ? this.#tag : super.getAttribute(key);
+	}
+
+	/** @override */
+	text() {
+		return `<${this.#closing ? '/' : ''}${this.#tag}${super.text()}${this.#selfClosing ? '/' : ''}>`;
+	}
+
+	/**
+	 * 更换标签名
+	 * @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;
 	}
 
 	/** 局部闭合 */
@@ -176,17 +204,17 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 	 */
 	fix() {
 		const config = this.getAttribute('config'),
-			{parentNode, name, firstElementChild} = this;
-		if (!parentNode || !this.#selfClosing || !config.html[0].includes(name)) {
+			{parentNode, name: tagName, firstChild} = this;
+		if (!parentNode || !this.#selfClosing || !config.html[0].includes(tagName)) {
 			return;
-		} else if (firstElementChild.text().trim()) {
+		} else if (firstChild.text().trim()) {
 			this.#localMatch();
 			return;
 		}
-		const {children} = parentNode,
-			i = children.indexOf(this),
+		const {childNodes} = parentNode,
+			i = childNodes.indexOf(this),
 			/** @type {HtmlToken[]} */
-			prevSiblings = children.slice(0, i).filter(child => child.matches(`html#${name}`)),
+			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;

package/src/imageParameter.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const {text, noWrap, extUrlChar} = require('../util/string'),
+const {text, noWrap, print, extUrlChar} = require('../util/string'),
 	Parser = require('..'),
 	Token = require('.'),
 	AstText = require('../lib/text');
@@ -21,30 +21,36 @@ class ImageParameterToken extends Token {
 	 */
 	static #validate(key, value, config = Parser.getConfig(), halfParsed = false) {
 		value = value.replaceAll(/\0\d+t\x7F/gu, '').trim();
-		if (key === 'width') {
-			return /^\d*(?:x\d*)?$/u.test(value);
-		} else if (['alt', 'class', 'manualthumb', 'frameless', 'framed', 'thumbnail'].includes(key)) {
-			return true;
-		} else if (key === 'link') {
-			if (!value) {
-				return this.noLink;
-			}
-			const regex = new RegExp(`(?:${config.protocol}|//)${extUrlChar}(?=\0\\d+t\x7F|$)`, 'iu');
-			if (regex.test(value)) {
-				return value;
-			}
-			if (value.startsWith('[[') && value.endsWith(']]')) {
-				value = value.slice(2, -2);
-			}
-			if (value.includes('%')) {
-				try {
-					value = decodeURIComponent(value);
-				} catch {}
+		switch (key) {
+			case 'width':
+				return /^\d*(?:x\d*)?$/u.test(value);
+			case 'link': {
+				if (!value) {
+					return this.noLink;
+				}
+				const regex = new RegExp(`(?:${config.protocol}|//)${extUrlChar}(?=\0\\d+t\x7F|$)`, 'iu');
+				if (regex.test(value)) {
+					return value;
+				} else if (value.startsWith('[[') && value.endsWith(']]')) {
+					value = value.slice(2, -2);
+				}
+				if (value.includes('%')) {
+					try {
+						value = decodeURIComponent(value);
+					} catch {}
+				}
+				const title = Parser.normalizeTitle(value, 0, false, config, halfParsed);
+				return title.valid && String(title);
 			}
-			const title = Parser.normalizeTitle(value, 0, false, config, halfParsed);
-			return title.valid && String(title);
+			case 'lang':
+				return config.variants.includes(value);
+			case 'alt':
+			case 'class':
+			case 'manualthumb':
+				return true;
+			default:
+				return !isNaN(value);
 		}
-		return !isNaN(value);
 	}
 
 	type = 'image-parameter';
@@ -89,7 +95,6 @@ class ImageParameterToken extends Token {
 			}
 			str.splitText(str.data.indexOf('x'));
 			str.nextSibling.splitText(1);
-			// eslint-disable-next-line unicorn/consistent-destructuring
 			return {width: text(token.childNodes.slice(0, i + 1)), height: text(token.childNodes.slice(i + 2))};
 		}
 		return undefined;
@@ -147,13 +152,42 @@ class ImageParameterToken extends Token {
 		this.setAttribute('name', 'caption').setAttribute('stage', 7);
 	}
 
+	/** @override */
+	isPlain() {
+		return true;
+	}
+
+	/**
+	 * @override
+	 * @param {string} selector
+	 */
+	toString(selector) {
+		return this.#syntax && !(selector && this.matches(selector))
+			? this.#syntax.replace('$1', super.toString(selector))
+			: super.toString(selector);
+	}
+
+	/** @override */
+	getPadding() {
+		return Math.max(0, this.#syntax.indexOf('$1'));
+	}
+
+	/** @override */
+	print() {
+		return this.#syntax
+			? `<span class="wpb-image-parameter">${this.#syntax.replace('$1', print(this.childNodes))}</span>`
+			: super.print({class: 'image-caption'});
+	}
+
 	/** @override */
 	cloneNode() {
 		const cloned = this.cloneChildNodes(),
-			config = this.getAttribute('config'),
-			token = Parser.run(() => new ImageParameterToken(this.#syntax.replace('$1', ''), config));
-		token.replaceChildren(...cloned);
-		return token;
+			config = this.getAttribute('config');
+		return Parser.run(() => {
+			const token = new ImageParameterToken(this.#syntax.replace('$1', ''), config);
+			token.replaceChildren(...cloned);
+			return token;
+		});
 	}
 
 	/**
@@ -166,29 +200,17 @@ class ImageParameterToken extends Token {
 		return key === 'syntax' ? this.#syntax : super.getAttribute(key);
 	}
 
-	/** @override */
-	isPlain() {
-		return true;
-	}
-
-	/** 是否是不可变参数 */
-	#isVoid() {
-		return this.#syntax && !this.#syntax.includes('$1');
-	}
-
 	/**
 	 * @override
-	 * @param {string} selector
+	 * @param {PropertyKey} key 属性键
 	 */
-	toString(selector) {
-		return this.#syntax && !(selector && this.matches(selector))
-			? this.#syntax.replace('$1', super.toString(selector))
-			: super.toString(selector);
+	hasAttribute(key) {
+		return key === 'syntax' || super.hasAttribute(key);
 	}
 
-	/** @override */
-	getPadding() {
-		return Math.max(0, this.#syntax.indexOf('$1'));
+	/** 是否是不可变参数 */
+	#isVoid() {
+		return this.#syntax && !this.#syntax.includes('$1');
 	}
 
 	/** @override */
@@ -239,14 +261,14 @@ class ImageParameterToken extends Token {
 		const root = Parser.parse(`[[File:F|${
 				this.#syntax ? this.#syntax.replace('$1', value) : value
 			}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root,
-			param = firstElementChild?.lastElementChild;
-		if (length !== 1 || !firstElementChild?.matches('file#File\\:F')
-			|| firstElementChild.childNodes.length !== 2 || param.name !== this.name
+			{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(...param.childNodes);
+		this.replaceChildren(...imageParameter.childNodes);
 	}
 }