wikiparser-node 0.5.0 → 0.6.1

package/src/extLink.js

@@ -52,38 +52,17 @@ class ExtLinkToken extends Token {
 	 * @param {accum} accum
 	 */
 	constructor(url, space, text, config = Parser.getConfig(), accum = []) {
-		super(undefined, config, true, accum, {AtomToken: 0, Token: 1});
-		this.appendChild(new MagicLinkToken(url, true, config, accum));
+		super(undefined, config, true, accum, {MagicLinkToken: 0, Token: 1});
+		this.insertAt(new MagicLinkToken(url, true, config, accum));
 		this.#space = space;
 		if (text) {
 			const inner = new Token(text, config, true, accum, {'Stage-7': ':', ConverterToken: ':'});
 			inner.type = 'ext-link-text';
-			this.appendChild(inner.setAttribute('stage', Parser.MAX_STAGE - 1));
+			this.insertAt(inner.setAttribute('stage', Parser.MAX_STAGE - 1));
 		}
 		this.getAttribute('protectChildren')(0);
 	}
 
-	/** @override */
-	cloneNode() {
-		const [url, text] = this.cloneChildNodes(),
-			token = Parser.run(() => new ExtLinkToken(undefined, '', '', this.getAttribute('config')));
-		token.firstChild.safeReplaceWith(url);
-		if (text) {
-			token.appendChild(text);
-		}
-		return token;
-	}
-
-	/** 修正空白字符 */
-	#correct() {
-		if (!this.#space && this.childNodes.length > 1
-			// 都替换成`<`肯定不对，但无妨
-			&& /^[^[\]<>"{\0-\x1F\x7F\p{Zs}\uFFFD]/u.test(this.lastChild.text().replace(/&[lg]t;/u, '<'))
-		) {
-			this.#space = ' ';
-		}
-	}
-
 	/**
 	 * @override
 	 * @param {string} selector
@@ -112,10 +91,33 @@ class ExtLinkToken extends Token {
 
 	/** @override */
 	print() {
-		const {childNodes: {length}} = this;
+		const {length} = this;
 		return super.print(length > 1 ? {pre: '[', sep: this.#space, post: ']'} : {pre: '[', post: `${this.#space}]`});
 	}
 
+	/** @override */
+	cloneNode() {
+		const [url, text] = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new ExtLinkToken(undefined, '', '', this.getAttribute('config'));
+			token.firstChild.safeReplaceWith(url);
+			if (text) {
+				token.insertAt(text);
+			}
+			return token;
+		});
+	}
+
+	/** 修正空白字符 */
+	#correct() {
+		if (!this.#space && this.childNodes.length > 1
+			// 都替换成`<`肯定不对，但无妨
+			&& /^[^[\]<>"{\0-\x1F\x7F\p{Zs}\uFFFD]/u.test(this.lastChild.text().replace(/&[lg]t;/u, '<'))
+		) {
+			this.#space = ' ';
+		}
+	}
+
 	/** @override */
 	text() {
 		normalizeSpace(this.childNodes[1]);
@@ -138,7 +140,7 @@ class ExtLinkToken extends Token {
 	setTarget(url) {
 		url = String(url);
 		const root = Parser.parse(`[${url}]`, this.getAttribute('include'), 8, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: extLink} = root;
+			{length, firstChild: extLink} = root;
 		if (length !== 1 || extLink.type !== 'ext-link' || extLink.childNodes.length !== 1) {
 			throw new SyntaxError(`非法的外链目标：${url}`);
 		}
@@ -155,13 +157,13 @@ class ExtLinkToken extends Token {
 	setLinkText(text) {
 		text = String(text);
 		const root = Parser.parse(`[//url ${text}]`, this.getAttribute('include'), 8, this.getAttribute('config')),
-			{childNodes: {length}, firstChild: extLink} = root;
+			{length, firstChild: extLink} = root;
 		if (length !== 1 || extLink.type !== 'ext-link' || extLink.childNodes.length !== 2) {
 			throw new SyntaxError(`非法的外链文字：${noWrap(text)}`);
 		}
 		const {lastChild} = extLink;
 		if (this.childNodes.length === 1) {
-			this.appendChild(lastChild);
+			this.insertAt(lastChild);
 		} else {
 			this.lastChild.safeReplaceWith(lastChild);
 		}

package/src/gallery.js

@@ -13,16 +13,23 @@ class GalleryToken extends Token {
 	type = 'ext-inner';
 	name = 'gallery';
 
+	/** 所有图片 */
+	get images() {
+		return this.childNodes.filter(({type}) => type === 'gallery-image');
+	}
+
 	/**
 	 * @param {string} inner 标签内部wikitext
 	 * @param {accum} accum
 	 */
 	constructor(inner, config = Parser.getConfig(), accum = []) {
-		super(undefined, config, true, accum, {AstText: ':', GalleryImageToken: ':'});
+		super(undefined, config, true, accum, {AstText: ':', GalleryImageToken: ':', HiddenToken: ':'});
+		const newConfig = structuredClone(config);
+		newConfig.img = Object.fromEntries(Object.entries(config.img).filter(([, param]) => param !== 'width'));
 		for (const line of inner?.split('\n') ?? []) {
 			const matches = /^([^|]+)(?:\|(.*))?/u.exec(line);
 			if (!matches) {
-				this.appendChild(line.trim() ? new HiddenToken(line, undefined, config, [], {AstText: ':'}) : line);
+				super.insertAt(line.trim() ? new HiddenToken(line, undefined, config, [], {AstText: ':'}) : line);
 				continue;
 			}
 			const [, file, alt] = matches;
@@ -33,21 +40,13 @@ class GalleryToken extends Token {
 				title = this.normalizeTitle(file, 6, true);
 			}
 			if (title.valid) {
-				this.appendChild(new GalleryImageToken(file, alt, title, config, accum));
+				super.insertAt(new GalleryImageToken(file, alt, title, newConfig, accum));
 			} else {
-				this.appendChild(new HiddenToken(line, undefined, config, [], {AstText: ':'}));
+				super.insertAt(new HiddenToken(line, undefined, config, [], {AstText: ':'}));
 			}
 		}
 	}
 
-	/** @override */
-	cloneNode() {
-		const cloned = this.cloneChildNodes(),
-			token = Parser.run(() => new GalleryToken(undefined, this.getAttribute('config')));
-		token.append(...cloned);
-		return token;
-	}
-
 	/**
 	 * @override
 	 * @param {string} selector
@@ -66,6 +65,43 @@ class GalleryToken extends Token {
 		return super.print({sep: '\n'});
 	}
 
+	/**
+	 * @override
+	 * @param {number} start 起始位置
+	 */
+	lint(start = 0) {
+		const {top, left} = this.getRootNode().posFromIndex(start),
+			/** @type {LintError[]} */ errors = [];
+		for (let i = 0, cur = start; i < this.childNodes.length; i++) {
+			const child = this.childNodes[i],
+				str = String(child),
+				trimmed = str.trim();
+			if (child.type === 'hidden' && trimmed && !/^<!--.*-->$/u.test(trimmed)) {
+				errors.push({
+					message: '图库中的无效内容',
+					startLine: top + i,
+					endLine: top + i,
+					startCol: i ? 0 : left,
+					endCol: i ? str.length : left + str.length,
+				});
+			} else if (child.type !== 'hidden' && child.type !== 'text') {
+				errors.push(...child.lint(cur));
+			}
+			cur += str.length + 1;
+		}
+		return errors;
+	}
+
+	/** @override */
+	cloneNode() {
+		const cloned = this.cloneChildNodes();
+		return Parser.run(() => {
+			const token = new GalleryToken(undefined, this.getAttribute('config'));
+			token.append(...cloned);
+			return token;
+		});
+	}
+
 	/** @override */
 	text() {
 		return super.text('\n').replaceAll(/\n\s*\n/gu, '\n');
@@ -93,28 +129,16 @@ class GalleryToken extends Token {
 
 	/**
 	 * @override
-	 * @param {number} start 起始位置
+	 * @template {string|Token} T
+	 * @param {T} token 待插入的节点
+	 * @param {number} i 插入位置
+	 * @throws `RangeError` 插入不可见内容
 	 */
-	lint(start = 0) {
-		const {top, left} = this.getRootNode().posFromIndex(start),
-			/** @type {LintError[]} */ errors = [];
-		for (let i = 0, cur = start; i < this.childNodes.length; i++) {
-			const child = this.childNodes[i],
-				str = String(child);
-			if (child.type === 'hidden' && str.trim() && !/^<!--.*-->$/u.test(str)) {
-				errors.push({
-					message: '图库中的无效内容',
-					startLine: top + i,
-					endLine: top + i,
-					startCol: i ? 0 : left,
-					endCol: i ? str.length : left + str.length,
-				});
-			} else if (child.type !== 'hidden' && child.type !== 'text') {
-				errors.push(...child.lint(cur));
-			}
-			cur += str.length + 1;
+	insertAt(token, i = 0) {
+		if (typeof token === 'string' && token.trim() || token instanceof HiddenToken) {
+			throw new RangeError('请勿向图库中插入不可见内容！');
 		}
-		return errors;
+		return super.insertAt(token, i);
 	}
 }
 

package/src/hasNowiki/index.js

@@ -0,0 +1,42 @@
+'use strict';
+
+const Parser = require('../..'),
+	Token = require('..');
+
+/**
+ * `<pre>`
+ * @classdesc `{childNodes: [...AstText|NoincludeToken]}`
+ */
+class HasNowikiToken extends Token {
+	/**
+	 * @param {string} wikitext wikitext
+	 * @param {string} type type
+	 * @param {accum} accum
+	 */
+	constructor(wikitext, type, config = Parser.getConfig(), accum = []) {
+		const NoincludeToken = require('../nowiki/noinclude');
+		wikitext = wikitext.replaceAll(
+			/(<nowiki>)(.*?)(<\/nowiki>)/giu,
+			/** @type {function(...string): string} */ (_, opening, inner, closing) => {
+				new NoincludeToken(opening, config, accum);
+				new NoincludeToken(closing, config, accum);
+				return `\0${accum.length - 1}c\x7F${inner}\0${accum.length}c\x7F`;
+			},
+		);
+		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

@@ -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

@@ -28,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': '',
@@ -36,19 +37,11 @@ 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.firsthild.safeReplaceWith(title);
-		token.lastChild.safeReplaceWith(trail);
-		return token;
-	}
-
 	/**
 	 * @override
 	 * @this {{prependNewLine(): ''|'\n', appendNewLine(): ''|'\n'} & HeadingToken}
 	 * @param {string} selector
+	 * @returns {string}
 	 */
 	toString(selector) {
 		const equals = '='.repeat(Number(this.name));
@@ -87,6 +80,17 @@ class HeadingToken extends fixedToken(sol(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;
+		});
+	}
+
 	/**
 	 * @override
 	 * @this {HeadingToken & {prependNewLine(): ''|'\n', appendNewLine(): ''|'\n'}}
@@ -102,7 +106,7 @@ 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);

package/src/html.js

@@ -28,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;
 	}
@@ -66,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
@@ -133,24 +116,6 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 		return errors;
 	}
 
-	/** @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;
-	}
-
 	/**
 	 * 搜索匹配的标签
 	 * @complexity `n`
@@ -190,6 +155,41 @@ class HtmlToken extends attributeParent(fixedToken(Token)) {
 		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;
+	}
+
 	/** 局部闭合 */
 	#localMatch() {
 		this.#selfClosing = false;

package/src/imageParameter.js

@@ -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';
@@ -146,35 +152,11 @@ class ImageParameterToken extends Token {
 		this.setAttribute('name', 'caption').setAttribute('stage', 7);
 	}
 
-	/** @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;
-	}
-
-	/**
-	 * @override
-	 * @template {string} T
-	 * @param {T} key 属性键
-	 * @returns {TokenAttribute<T>}
-	 */
-	getAttribute(key) {
-		return key === 'syntax' ? this.#syntax : super.getAttribute(key);
-	}
-
 	/** @override */
 	isPlain() {
 		return true;
 	}
 
-	/** 是否是不可变参数 */
-	#isVoid() {
-		return this.#syntax && !this.#syntax.includes('$1');
-	}
-
 	/**
 	 * @override
 	 * @param {string} selector
@@ -197,6 +179,40 @@ class ImageParameterToken extends Token {
 			: 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 {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 */
 	text() {
 		return this.#syntax ? this.#syntax.replace('$1', super.text()).trim() : super.text().trim();
@@ -245,8 +261,8 @@ 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}, firstChild: file} = root,
-			{lastChild: imageParameter, type, name, childNodes: {length: fileLength}} = file;
+			{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
 		) {