wikiparser-node 0.4.0 → 0.6.2-b

package/src/link/category.js

@@ -1,53 +0,0 @@
-'use strict';
-
-const Title = require('../../lib/title'),
-	Parser = require('../..'),
-	LinkToken = require('.'),
-	Token = require('..');
-
-/**
- * 分类
- * @classdesc `{childNodes: [AtomToken, ?Token]}`
- */
-class CategoryToken extends LinkToken {
-	type = 'category';
-
-	setLangLink = undefined;
-	setFragment = undefined;
-	asSelfLink = undefined;
-	pipeTrick = undefined;
-
-	/** 分类排序关键字 */
-	get sortkey() {
-		return this.children[1]?.text()
-			?.replaceAll(/&#(\d+);/gu, /** @param {string} p */ (_, p) => String.fromCodePoint(Number(p)))
-			?.replaceAll(/&#x([\da-f]+);/giu, /** @param {string} p */ (_, p) => String.fromCodePoint(parseInt(p, 16)))
-			?.replaceAll('\n', '') ?? '';
-	}
-
-	set sortkey(text) {
-		this.setSortkey(text);
-	}
-
-	/**
-	 * @param {string} link 分类名
-	 * @param {string|undefined} text 排序关键字
-	 * @param {Title} title 分类页面标题对象
-	 * @param {accum} accum
-	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
-		super(link, text, title, config, accum);
-		this.seal(['setFragment', 'asSelfLink', 'pipeTrick'], true);
-	}
-
-	/**
-	 * 设置排序关键字
-	 * @param {string} text 排序关键字
-	 */
-	setSortkey(text) {
-		this.setLinkText(text);
-	}
-}
-
-Parser.classes.CategoryToken = __filename;
-module.exports = CategoryToken;

package/src/link/file.js

@@ -1,265 +0,0 @@
-'use strict';
-
-const Title = require('../../lib/title'),
-	{explode, noWrap} = require('../../util/string'),
-	{externalUse} = require('../../util/debug'),
-	Parser = require('../..'),
-	LinkToken = require('.'),
-	ImageParameterToken = require('../imageParameter');
-
-/**
- * 图片
- * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken]}`
- */
-class FileToken extends LinkToken {
-	type = 'file';
-	/** @type {Set<string>} */ #keys = new Set();
-	/** @type {Record<string, Set<ImageParameterToken>>} */ #args = {};
-
-	setLangLink = undefined;
-	setFragment = undefined;
-	asSelfLink = undefined;
-	setLinkText = undefined;
-	pipeTrick = undefined;
-
-	/** 图片链接 */
-	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 图片参数
-	 * @param {Title} title 文件标题对象
-	 * @param {accum} accum
-	 * @complexity `n`
-	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
-		super(link, undefined, title, config, accum);
-		this.setAttribute('acceptable', {AtomToken: 0, ImageParameterToken: '1:'});
-		this.append(...explode('-{', '}-', '|', text).map(part => new ImageParameterToken(part, config, accum)));
-		this.seal(['setLangLink', 'setFragment', 'asSelfLink', 'setLinkText', 'pipeTrick'], true);
-	}
-
-	/**
-	 * @override
-	 * @param {number} i 移除位置
-	 * @complexity `n`
-	 */
-	removeAt(i) {
-		const /** @type {ImageParameterToken} */ token = super.removeAt(i),
-			args = this.getArgs(token.name, false, false);
-		args.delete(token);
-		if (args.size === 0) {
-			this.#keys.delete(token.name);
-		}
-		return token;
-	}
-
-	/**
-	 * @override
-	 * @param {ImageParameterToken} token 待插入的子节点
-	 * @param {number} i 插入位置
-	 * @complexity `n`
-	 */
-	insertAt(token, i = this.childNodes.length) {
-		if (!Parser.running) {
-			this.getArgs(token.name, false, false).add(token);
-			this.#keys.add(token.name);
-		}
-		return super.insertAt(token, i);
-	}
-
-	/**
-	 * 获取所有图片参数节点
-	 * @returns {ImageParameterToken[]}
-	 */
-	getAllArgs() {
-		return this.childNodes.slice(1);
-	}
-
-	/**
-	 * 获取图片框架属性参数节点
-	 * @complexity `n`
-	 */
-	getFrameArgs() {
-		const args = this.getAllArgs()
-			.filter(({name}) => ['manualthumb', 'frameless', 'framed', 'thumbnail'].includes(name));
-		if (args.length > 1) {
-			Parser.error(`图片 ${this.name} 带有 ${args.length} 个框架参数，只有第 1 个 ${args[0].name} 会生效！`);
-		}
-		return args;
-	}
-
-	/**
-	 * 获取指定图片参数
-	 * @param {string} key 参数名
-	 * @param {boolean} copy 是否返回备份
-	 * @complexity `n`
-	 */
-	getArgs(key, copy = true) {
-		if (typeof key !== 'string') {
-			this.typeError('getArgs', 'String');
-		}
-		copy ||= !Parser.debugging && externalUse('getArgs');
-		let args = this.#args[key];
-		if (!args) {
-			args = new Set(this.getAllArgs().filter(({name}) => key === name));
-			this.#args[key] = args;
-		}
-		return copy ? new Set(args) : args;
-	}
-
-	/**
-	 * 是否具有指定图片参数
-	 * @param {string} key 参数名
-	 * @complexity `n`
-	 */
-	hasArg(key) {
-		return this.getArgs(key, false).size > 0;
-	}
-
-	/**
-	 * 获取生效的指定图片参数
-	 * @param {string} key 参数名
-	 * @complexity `n`
-	 */
-	getArg(key) {
-		return [...this.getArgs(key, false)].sort((a, b) => a.compareDocumentPosition(b)).at(-1);
-	}
-
-	/**
-	 * 移除指定图片参数
-	 * @param {string} key 参数名
-	 * @complexity `n`
-	 */
-	removeArg(key) {
-		for (const token of this.getArgs(key, false)) {
-			this.removeChild(token);
-		}
-	}
-
-	/**
-	 * 获取图片参数名
-	 * @complexity `n`
-	 */
-	getKeys() {
-		const args = this.getAllArgs();
-		if (this.#keys.size === 0 && args.length > 0) {
-			for (const {name} of args) {
-				this.#keys.add(name);
-			}
-		}
-		return [...this.#keys];
-	}
-
-	/**
-	 * 获取指定的图片参数值
-	 * @param {string} key 参数名
-	 * @complexity `n`
-	 */
-	getValues(key) {
-		return [...this.getArgs(key, false)].map(token => token.getValue());
-	}
-
-	/**
-	 * 获取生效的指定图片参数值
-	 * @template {string|undefined} T
-	 * @param {T} key 参数名
-	 * @returns {T extends undefined ? Object<string, string> : string|true}
-	 * @complexity `n`
-	 */
-	getValue(key) {
-		return key === undefined
-			? Object.fromEntries(this.getKeys().map(k => [k, this.getValue(k)]))
-			: 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.appendChild(newArg);
-			return;
-		}
-		const wikitext = `[[File:F|${syntax ? syntax.replace('$1', value) : value}]]`,
-			root = Parser.parse(wikitext, this.getAttribute('include'), 6, config),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || !firstElementChild?.matches('file#File\\:F')
-			|| firstElementChild.childNodes.length !== 2 || firstElementChild.lastElementChild.name !== key
-		) {
-			throw new SyntaxError(`非法的 ${key} 参数：${noWrap(value)}`);
-		}
-		this.appendChild(firstElementChild.lastChild);
-	}
-}
-
-Parser.classes.FileToken = __filename;
-module.exports = FileToken;

package/src/link/galleryImage.js

@@ -1,61 +0,0 @@
-'use strict';
-
-const Title = require('../../lib/title'),
-	Parser = require('../..'),
-	Token = require('..'),
-	FileToken = require('./file');
-
-/**
- * 图片
- * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken]}`
- */
-class GalleryImageToken extends FileToken {
-	type = 'gallery-image';
-
-	size = undefined;
-	width = undefined;
-	height = undefined;
-
-	/**
-	 * @param {string} link 图片文件名
-	 * @param {string|undefined} text 图片参数
-	 * @param {Title} title 图片文件标题对象
-	 * @param {accum} accum
-	 */
-	constructor(link, text, title, config = Parser.getConfig(), accum = []) {
-		let token;
-		if (text !== undefined) {
-			token = new Token(text, config, true, accum);
-			token.type = 'temp';
-			for (let n = 1; n < Parser.MAX_STAGE; n++) {
-				token.getAttribute('parseOnce')();
-			}
-			accum.splice(accum.indexOf(token), 1);
-		}
-		const newConfig = structuredClone(config);
-		newConfig.img = Object.fromEntries(Object.entries(config.img).filter(([, param]) => param !== 'width'));
-		super(link, token?.toString(), title, newConfig, accum);
-		this.seal(['size', 'width', 'height'], true);
-	}
-
-	/** @override */
-	getPadding() {
-		return 0;
-	}
-
-	/**
-	 * @override
-	 * @param {string} selector
-	 */
-	toString(selector) {
-		return super.toString(selector).replaceAll('\n', ' ');
-	}
-
-	/** @override */
-	text() {
-		return super.text().replaceAll('\n', ' ');
-	}
-}
-
-Parser.classes.GalleryImageToken = __filename;
-module.exports = GalleryImageToken;

package/src/link/index.js

@@ -1,322 +0,0 @@
-'use strict';
-
-const Title = require('../../lib/title'),
-	{noWrap} = require('../../util/string'),
-	{undo} = require('../../util/debug'),
-	Parser = require('../..'),
-	AstText = require('../../lib/text'),
-	Token = require('..');
-
-/**
- * 内链
- * @classdesc `{childNodes: [AtomToken, ?Token]}`
- */
-class LinkToken extends Token {
-	type = 'link';
-
-	/** 完整链接，和FileToken保持一致 */
-	get link() {
-		return String(this.#getTitle());
-	}
-
-	set link(link) {
-		this.setTarget(link);
-	}
-
-	/** 是否链接到自身 */
-	get selfLink() {
-		return !this.#getTitle().title;
-	}
-
-	set selfLink(selfLink) {
-		if (selfLink === true) {
-			this.asSelfLink();
-		}
-	}
-
-	/** fragment */
-	get fragment() {
-		return this.#getTitle().fragment;
-	}
-
-	set fragment(fragment) {
-		this.setFragment(fragment);
-	}
-
-	/** interwiki */
-	get interwiki() {
-		return this.#getTitle().interwiki;
-	}
-
-	set interwiki(interwiki) {
-		if (typeof interwiki !== 'string') {
-			this.typeError('set interwiki', 'String');
-		}
-		const {prefix, main, fragment} = this.#getTitle(),
-			link = `${interwiki}:${prefix}${main}${fragment && '#'}${fragment}`;
-		if (interwiki && !this.isInterwiki(link)) {
-			throw new RangeError(`${interwiki} 不是合法的跨维基前缀!`);
-		}
-		this.setTarget(link);
-	}
-
-	/** 链接显示文字 */
-	get innerText() {
-		if (this.type !== 'link') {
-			return undefined;
-		}
-		return this.childNodes.length > 1
-			? this.lastElementChild.text()
-			: this.firstElementChild.text().replace(/^\s*:/u, '');
-	}
-
-	/**
-	 * @param {string} link 链接标题
-	 * @param {string|undefined} linkText 链接显示文字
-	 * @param {Title} title 链接标题对象
-	 * @param {accum} accum
-	 */
-	constructor(link, linkText, title, config = Parser.getConfig(), accum = []) {
-		super(undefined, config, true, accum, {AtomToken: 0, Token: 1});
-		const AtomToken = require('../atom');
-		this.appendChild(new AtomToken(link, 'link-target', config, accum, {
-			'Stage-2': ':', '!ExtToken': '', '!HeadingToken': '',
-		}));
-		if (linkText !== undefined) {
-			const inner = new Token(linkText, config, true, accum, {'Stage-5': ':', ConverterToken: ':'});
-			inner.type = 'link-text';
-			this.appendChild(inner.setAttribute('stage', Parser.MAX_STAGE - 1));
-		}
-		this.setAttribute('name', title.title).getAttribute('protectChildren')(0);
-	}
-
-	/** 生成Title对象 */
-	#getTitle() {
-		return this.normalizeTitle(this.firstElementChild.text());
-	}
-
-	/** @override */
-	cloneNode() {
-		const [link, ...linkText] = this.cloneChildNodes();
-		return Parser.run(() => {
-			/** @type {this & {constructor: typeof LinkToken}} */
-			const {constructor} = this,
-				token = new constructor('', undefined, this.#getTitle(), this.getAttribute('config'));
-			token.firstElementChild.safeReplaceWith(link);
-			token.append(...linkText);
-			return token.afterBuild();
-		});
-	}
-
-	/**
-	 * @override
-	 * @throws `Error` 非法的内链目标
-	 * @throws `Error` 不可更改命名空间
-	 */
-	afterBuild() {
-		const /** @type {AstListener} */ linkListener = (e, data) => {
-			const {prevTarget} = e;
-			if (prevTarget?.type === 'link-target') {
-				const name = prevTarget.text(),
-					{title, interwiki, ns, valid} = this.normalizeTitle(name);
-				if (!valid) {
-					undo(e, data);
-					throw new Error(`非法的内链目标：${name}`);
-				} else if (this.type === 'category' && (interwiki || ns !== 14)
-					|| this.type === 'file' && (interwiki || ns !== 6)
-				) {
-					undo(e, data);
-					throw new Error(`${this.type === 'file' ? '文件' : '分类'}链接不可更改命名空间：${name}`);
-				} else if (this.type === 'link' && !interwiki && (ns === 6 || ns === 14) && name.trim()[0] !== ':') {
-					const /** @type {{firstChild: AstText}} */ {firstChild} = prevTarget;
-					if (firstChild.type === 'text') {
-						firstChild.insertData(0, ':');
-					} else {
-						prevTarget.prepend(':');
-					}
-				}
-				this.setAttribute('name', title);
-			}
-		};
-		this.addEventListener(['remove', 'insert', 'replace', 'text'], linkListener);
-		return this;
-	}
-
-	/**
-	 * @override
-	 * @param {string} selector
-	 */
-	toString(selector) {
-		const str = super.toString(selector, '|');
-		return this.type === 'gallery-image' || selector && this.matches(selector) ? str : `[[${str}]]`;
-	}
-
-	/** @override */
-	getPadding() {
-		return 2;
-	}
-
-	/** @override */
-	getGaps() {
-		return 1;
-	}
-
-	/** @override */
-	text() {
-		const str = super.text('|');
-		return this.type === 'gallery-image' ? str : `[[${str}]]`;
-	}
-
-	/**
-	 * 设置链接目标
-	 * @param {string} link 链接目标
-	 * @throws `SyntaxError` 非法的链接目标
-	 */
-	setTarget(link) {
-		link = String(link);
-		if (this.type === 'link' && !/^\s*[:#]/u.test(link)) {
-			link = `:${link}`;
-		}
-		const root = Parser.parse(`[[${link}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild?.type !== this.type || firstElementChild.childNodes.length !== 1) {
-			const msgs = {link: '内链', file: '文件链接', category: '分类', 'gallery-image': '文件链接'};
-			throw new SyntaxError(`非法的${msgs[this.type]}目标：${link}`);
-		}
-		const {firstChild} = firstElementChild;
-		firstElementChild.destroy(true);
-		this.firstElementChild.safeReplaceWith(firstChild);
-	}
-
-	/**
-	 * 设置跨语言链接
-	 * @param {string} lang 语言前缀
-	 * @param {string} link 页面标题
-	 * @throws `SyntaxError` 非法的跨语言链接
-	 */
-	setLangLink(lang, link) {
-		if (typeof lang !== 'string') {
-			this.typeError('setLangLink', 'String');
-		}
-		link = String(link).trim();
-		const [char] = link;
-		if (char === '#') {
-			throw new SyntaxError(`跨语言链接不能仅为fragment！`);
-		} else if (char === ':') {
-			link = link.slice(1);
-		}
-		const root = Parser.parse(`[[${lang}:${link}]]`, this.getAttribute('include'), 6, this.getAttribute('config')),
-			/** @type {Token & {firstElementChild: LinkToken}} */ {childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild?.type !== 'link' || firstElementChild.childNodes.length !== 1
-			|| firstElementChild.interwiki !== lang.toLowerCase()
-		) {
-			throw new SyntaxError(`非法的跨语言链接目标：${lang}:${link}`);
-		}
-		const {firstChild} = firstElementChild;
-		firstElementChild.destroy(true);
-		this.firstElementChild.safeReplaceWith(firstChild);
-	}
-
-	/**
-	 * 设置fragment
-	 * @param {string} fragment fragment
-	 * @param {boolean} page 是否是其他页面
-	 * @throws `SyntaxError` 非法的fragment
-	 */
-	#setFragment(fragment, page = true) {
-		fragment = String(fragment).replaceAll(/[<>[\]#|=]/gu, p => encodeURIComponent(p));
-		const include = this.getAttribute('include'),
-			config = this.getAttribute('config'),
-			root = Parser.parse(`[[${page ? `:${this.name}` : ''}#${fragment}]]`, include, 6, config),
-			{childNodes: {length}, firstElementChild} = root;
-		if (length !== 1 || firstElementChild?.type !== 'link' || firstElementChild.childNodes.length !== 1) {
-			throw new SyntaxError(`非法的 fragment：${fragment}`);
-		}
-		if (page) {
-			Parser.warn(`${this.constructor.name}.setFragment 方法会同时规范化页面名！`);
-		}
-		const {firstChild} = firstElementChild;
-		firstElementChild.destroy(true);
-		this.firstElementChild.safeReplaceWith(firstChild);
-	}
-
-	/**
-	 * 设置fragment
-	 * @param {string} fragment fragment
-	 */
-	setFragment(fragment) {
-		this.#setFragment(fragment);
-	}
-
-	/**
-	 * 修改为到自身的链接
-	 * @param {string} fragment fragment
-	 * @throws `RangeError` 空fragment
-	 */
-	asSelfLink(fragment = this.fragment) {
-		fragment = String(fragment);
-		if (!fragment.trim()) {
-			throw new RangeError(`${this.constructor.name}.asSelfLink 方法必须指定非空的 fragment！`);
-		}
-		this.#setFragment(fragment, false);
-	}
-
-	/**
-	 * 设置链接显示文字
-	 * @param {string} linkText 链接显示文字
-	 * @throws `SyntaxError` 非法的链接显示文字
-	 */
-	setLinkText(linkText = '') {
-		linkText = String(linkText);
-		let lastElementChild;
-		const config = this.getAttribute('config');
-		if (linkText) {
-			const root = Parser.parse(`[[${
-					this.type === 'category' ? 'Category:' : ''
-				}L|${linkText}]]`, this.getAttribute('include'), 6, config),
-				{childNodes: {length}, firstElementChild} = root;
-			if (length !== 1 || firstElementChild?.type !== this.type || firstElementChild.childNodes.length !== 2) {
-				throw new SyntaxError(`非法的${this.type === 'link' ? '内链文字' : '分类关键字'}：${noWrap(linkText)}`);
-			}
-			({lastElementChild} = firstElementChild);
-		} else {
-			lastElementChild = Parser.run(() => new Token('', config));
-			lastElementChild.setAttribute('stage', 7).type = 'link-text';
-		}
-		if (this.childNodes.length === 1) {
-			this.appendChild(lastElementChild);
-		} else {
-			this.lastElementChild.safeReplaceWith(lastElementChild);
-		}
-	}
-
-	/**
-	 * 自动生成管道符后的链接文字
-	 * @throws `Error` 带有"#"或"%"时不可用
-	 */
-	pipeTrick() {
-		const linkText = this.firstElementChild.text();
-		if (linkText.includes('#') || linkText.includes('%')) {
-			throw new Error('Pipe trick 不能用于带有"#"或"%"的场合！');
-		}
-		const m1 = /^:?(?:[ \w\x80-\xFF-]+:)?([^(]+)\(.+\)$/u.exec(linkText);
-		if (m1) {
-			this.setLinkText(m1[1].trim());
-			return;
-		}
-		const m2 = /^:?(?:[ \w\x80-\xFF-]+:)?([^（]+)（.+）$/u.exec(linkText);
-		if (m2) {
-			this.setLinkText(m2[1].trim());
-			return;
-		}
-		const m3 = /^:?(?:[ \w\x80-\xFF-]+:)?(.+?)(?:(?<!\()\(.+\))?(?:, |，|، )./u.exec(linkText);
-		if (m3) {
-			this.setLinkText(m3[1].trim());
-			return;
-		}
-		this.setLinkText(linkText);
-	}
-}
-
-Parser.classes.LinkToken = __filename;
-module.exports = LinkToken;