wikiparser-node 0.8.1-m → 0.9.0

package/src/link/file.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const {explode} = require('../../util/string'),
+const {explode, noWrap} = require('../../util/string'),
 	{generateForChild} = require('../../util/lint'),
 	Parser = require('../..'),
 	LinkToken = require('.'),
@@ -17,6 +17,48 @@ const frame = new Set(['manualthumb', 'frameless', 'framed', 'thumbnail']),
 class FileToken extends LinkToken {
 	type = 'file';
 
+	/** 图片链接 */
+	get link() {
+		return this.getArg('link')?.link;
+	}
+
+	set link(value) {
+		this.setValue('link', value);
+	}
+
+	/** 图片大小 */
+	get size() {
+		return this.getArg('width')?.size;
+	}
+
+	/** 图片宽度 */
+	get width() {
+		return this.size?.width;
+	}
+
+	set width(width) {
+		const arg = this.getArg('width');
+		if (arg) {
+			arg.width = width;
+		} else {
+			this.setValue('width', width);
+		}
+	}
+
+	/** 图片高度 */
+	get height() {
+		return this.size?.height;
+	}
+
+	set height(height) {
+		const arg = this.getArg('width');
+		if (arg) {
+			arg.height = height;
+		} else {
+			this.setValue('width', `x${height}`);
+		}
+	}
+
 	/**
 	 * @param {string} link 文件名
 	 * @param {string|undefined} text 图片参数
@@ -24,19 +66,27 @@ class FileToken extends LinkToken {
 	 * @param {string} delimiter `|`
 	 * @complexity `n`
 	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = [], delimiter = '|') {
-		super(link, undefined, title, config, accum, delimiter);
+	constructor(link, text, config = Parser.getConfig(), accum = [], delimiter = '|') {
+		super(link, undefined, config, accum, delimiter);
+		this.setAttribute('acceptable', {AtomToken: 0, ImageParameterToken: '1:'});
 		this.append(...explode('-{', '}-', '|', text).map(part => new ImageParameterToken(part, config, accum)));
+		this.seal(
+			['selfLink', 'interwiki', 'setLangLink', 'setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick'],
+			true,
+		);
 	}
 
 	/**
 	 * @override
 	 * @param {number} start 起始位置
 	 */
-	lint(start = 0) {
+	lint(start = this.getAbsoluteIndex()) {
 		const errors = super.lint(start),
-			args = this.getAllArgs(),
-			keys = [...new Set(args.map(({name}) => name))],
+			args = this.getAllArgs().filter(({childNodes}) => {
+				const visibleNodes = childNodes.filter(node => node.text().trim());
+				return visibleNodes.length !== 1 || visibleNodes[0].type !== 'arg';
+			}),
+			keys = [...new Set(args.map(({name}) => name))].filter(key => key !== 'invalid'),
 			frameKeys = keys.filter(key => frame.has(key)),
 			horizAlignKeys = keys.filter(key => horizAlign.has(key)),
 			vertAlignKeys = keys.filter(key => vertAlign.has(key));
@@ -55,24 +105,28 @@ class FileToken extends LinkToken {
 				];
 			}
 			if (relevantArgs.length > 1) {
-				errors.push(...relevantArgs.map(arg => generateForChild(arg, rect, `重复的图片${key}参数`)));
+				errors.push(...relevantArgs.map(
+					arg => generateForChild(arg, rect, Parser.msg('duplicated image $1 parameter', key)),
+				));
 			}
 		}
 		if (frameKeys.size > 1) {
 			errors.push(
-				...args.filter(({name}) => frame.has(name)).map(arg => generateForChild(arg, rect, '冲突的图片框架参数')),
+				...args.filter(({name}) => frame.has(name)).map(
+					arg => generateForChild(arg, rect, 'conflicting image $1 parameter', 'frame'),
+				),
 			);
 		}
 		if (horizAlignKeys.size > 1) {
 			errors.push(
 				...args.filter(({name}) => horizAlign.has(name))
-					.map(arg => generateForChild(arg, rect, '冲突的图片水平对齐参数')),
+					.map(arg => generateForChild(arg, rect, 'conflicting image $1 parameter', 'horizontal-alignment')),
 			);
 		}
 		if (vertAlignKeys.size > 1) {
 			errors.push(
 				...args.filter(({name}) => vertAlign.has(name))
-					.map(arg => generateForChild(arg, rect, '冲突的图片垂直对齐参数')),
+					.map(arg => generateForChild(arg, rect, 'conflicting image $1 parameter', 'vertical-alignment')),
 			);
 		}
 		return errors;
@@ -92,7 +146,9 @@ class FileToken extends LinkToken {
 	 * @complexity `n`
 	 */
 	getArgs(key) {
-		return this.getAllArgs().filter(({name}) => key === name);
+		return typeof key === 'string'
+			? this.getAllArgs().filter(({name}) => key === name)
+			: this.typeError('getArgs', 'String');
 	}
 
 	/**
@@ -103,6 +159,9 @@ class FileToken extends LinkToken {
 	 */
 	#getTypedArgs(keys, type) {
 		const args = this.getAllArgs().filter(({name}) => keys.has(name));
+		if (args.length > 1) {
+			Parser.warn(`图片 ${this.name} 带有 ${args.length} 个${type}参数，只有最后 1 个 ${args[0].name} 会生效！`);
+		}
 		return args;
 	}
 
@@ -120,6 +179,109 @@ class FileToken extends LinkToken {
 	getVertAlignArgs() {
 		return this.#getTypedArgs(vertAlign, '垂直对齐');
 	}
+
+	/**
+	 * 获取生效的指定图片参数
+	 * @param {string} key 参数名
+	 * @complexity `n`
+	 */
+	getArg(key) {
+		return this.getArgs(key).at(-1);
+	}
+
+	/**
+	 * 是否具有指定图片参数
+	 * @param {string} key 参数名
+	 * @complexity `n`
+	 */
+	hasArg(key) {
+		return this.getArgs(key).length > 0;
+	}
+
+	/**
+	 * 移除指定图片参数
+	 * @param {string} key 参数名
+	 * @complexity `n`
+	 */
+	removeArg(key) {
+		for (const token of this.getArgs(key)) {
+			this.removeChild(token);
+		}
+	}
+
+	/**
+	 * 获取图片参数名
+	 * @complexity `n`
+	 */
+	getKeys() {
+		return this.getAllArgs().map(({name}) => name);
+	}
+
+	/**
+	 * 获取指定的图片参数值
+	 * @param {string} key 参数名
+	 * @complexity `n`
+	 */
+	getValues(key) {
+		return this.getArgs(key).map(token => token.getValue());
+	}
+
+	/**
+	 * 获取生效的指定图片参数值
+	 * @param {string} key 参数名
+	 * @complexity `n`
+	 */
+	getValue(key) {
+		return this.getArg(key)?.getValue();
+	}
+
+	/**
+	 * 设置图片参数
+	 * @param {string} key 参数名
+	 * @param {string|boolean} value 参数值
+	 * @complexity `n`
+	 * @throws `RangeError` 未定义的图片参数
+	 * @throws `SyntaxError` 非法的参数
+	 */
+	setValue(key, value) {
+		if (typeof key !== 'string') {
+			this.typeError('setValue', 'String');
+		} else if (value === false) {
+			this.removeArg(key);
+			return;
+		}
+		const token = this.getArg(key);
+		value = value === true ? value : String(value);
+		if (token) {
+			token.setValue(value);
+			return;
+		}
+		let syntax = '';
+		const config = this.getAttribute('config');
+		if (key !== 'caption') {
+			syntax = Object.entries(config.img).find(([, name]) => name === key)?.[0];
+			if (!syntax) {
+				throw new RangeError(`未定义的图片参数： ${key}`);
+			}
+		}
+		if (value === true) {
+			if (syntax.includes('$1')) {
+				this.typeError('setValue', 'Boolean');
+			}
+			const newArg = Parser.run(() => new ImageParameterToken(syntax, config));
+			this.insertAt(newArg);
+			return;
+		}
+		const wikitext = `[[File:F|${syntax ? syntax.replace('$1', value) : value}]]`,
+			root = Parser.parse(wikitext, this.getAttribute('include'), 6, config),
+			{length, firstChild: file} = root,
+			{name, type, length: fileLength, lastChild: imageParameter} = file;
+		if (length !== 1 || type !== 'file' || name !== 'File:F' || fileLength !== 2 || imageParameter.name !== key) {
+			throw new SyntaxError(`非法的 ${key} 参数：${noWrap(value)}`);
+		}
+		this.insertAt(imageParameter);
+	}
 }
 
+Parser.classes.FileToken = __filename;
 module.exports = FileToken;

package/src/link/galleryImage.js

@@ -1,6 +1,8 @@
 'use strict';
 
 const {generateForSelf} = require('../../util/lint'),
+	{undo} = require('../../util/debug'),
+	singleLine = require('../../mixin/singleLine'),
 	Parser = require('../..'),
 	Token = require('..'),
 	FileToken = require('./file');
@@ -9,16 +11,27 @@ const {generateForSelf} = require('../../util/lint'),
  * 图片
  * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken]}`
  */
-class GalleryImageToken extends FileToken {
+class GalleryImageToken extends singleLine(FileToken) {
 	type = 'gallery-image';
 	#invalid = false;
 
+	/** 图片链接 */
+	get link() {
+		return this.type === 'imagemap-image' ? undefined : super.link;
+	}
+
+	set link(value) {
+		if (this.type !== 'imagemap-image') {
+			super.link = value;
+		}
+	}
+
 	/**
 	 * @param {string} link 图片文件名
 	 * @param {string|undefined} text 图片参数
 	 * @param {accum} accum
 	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
+	constructor(link, text, config = Parser.getConfig(), accum = []) {
 		let token;
 		if (text !== undefined) {
 			token = new Token(text, config, true, accum);
@@ -28,17 +41,41 @@ class GalleryImageToken extends FileToken {
 			}
 			accum.splice(accum.indexOf(token), 1);
 		}
-		super(link, token?.toString(), title, config, accum);
+		super(link, token?.toString(), config, accum);
 		this.setAttribute('bracket', false);
+		if (!Object.values(config.img).includes('width')) {
+			this.seal(['size', 'width', 'height'], true);
+		}
 	}
 
 	/**
 	 * @override
+	 * @throws `Error` 非法的内链目标
+	 * @throws `Error` 不可更改命名空间
 	 */
 	afterBuild() {
 		const initImagemap = this.type === 'imagemap-image',
 			titleObj = this.normalizeTitle(String(this.firstChild), initImagemap ? 0 : 6, true, !initImagemap);
+		this.setAttribute('name', titleObj.title);
 		this.#invalid = titleObj.interwiki || titleObj.ns !== 6; // 只用于gallery-image的首次解析
+		const /** @type {AstListener} */ linkListener = (e, data) => {
+			const {prevTarget} = e;
+			if (prevTarget?.type === 'link-target') {
+				const name = String(prevTarget),
+					imagemap = this.type === 'imagemap-image',
+					{title, interwiki, ns, valid} = this.normalizeTitle(name, imagemap ? 0 : 6, true, !imagemap);
+				if (!valid) {
+					undo(e, data);
+					throw new Error(`非法的图片文件名：${name}`);
+				} else if (interwiki || ns !== 6) {
+					undo(e, data);
+					throw new Error(`图片链接不可更改命名空间：${name}`);
+				}
+				this.setAttribute('name', title);
+				this.#invalid = false;
+			}
+		};
+		this.addEventListener(['remove', 'insert', 'replace', 'text'], linkListener);
 	}
 
 	/** @override */
@@ -50,13 +87,34 @@ class GalleryImageToken extends FileToken {
 	 * @override
 	 * @param {number} start 起始位置
 	 */
-	lint(start = 0) {
+	lint(start = this.getAbsoluteIndex()) {
 		const errors = super.lint(start);
 		if (this.#invalid) {
-			errors.push(generateForSelf(this, {start}, '无效的图库图片'));
+			errors.push(generateForSelf(this, {start}, 'invalid gallery image'));
 		}
 		return errors;
 	}
+
+	/**
+	 * @override
+	 * @param {string} link 链接目标
+	 * @throws `SyntaxError` 非法的链接目标
+	 */
+	setTarget(link) {
+		link = String(link);
+		const include = this.getAttribute('include'),
+			config = this.getAttribute('config'),
+			root = Parser.parse(`<gallery>${link}</gallery>`, include, 1, config),
+			{length, firstChild: gallery} = root,
+			{type, lastChild: {length: galleryLength, firstChild: image}} = gallery;
+		if (length !== 1 || type !== 'ext' || galleryLength !== 1 || image.type !== 'gallery-image') {
+			throw new SyntaxError(`非法的图库文件名：${link}`);
+		}
+		const {firstChild} = image;
+		image.destroy(true);
+		this.firstChild.safeReplaceWith(firstChild);
+	}
 }
 
+Parser.classes.GalleryImageToken = __filename;
 module.exports = GalleryImageToken;