wikiparser-node 1.0.0-beta.4 → 1.0.1-b

package/dist/src/link/file.js

@@ -1,271 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileToken = void 0;
-const string_1 = require("../../util/string");
-const lint_1 = require("../../util/lint");
-const Parser = require("../../index");
-const base_1 = require("./base");
-const imageParameter_1 = require("../imageParameter");
-const frame = new Set(['manualthumb', 'frameless', 'framed', 'thumbnail']), horizAlign = new Set(['left', 'right', 'center', 'none']), vertAlign = new Set(['baseline', 'sub', 'super', 'top', 'text-top', 'middle', 'bottom', 'text-bottom']);
-/**
- * a more sophisticated string-explode function
- * @browser
- * @param start start syntax of a nested AST node
- * @param end end syntax of a nested AST node
- * @param separator syntax for explosion
- * @param str string to be exploded
- */
-const explode = (start, end, separator, str) => {
-    if (str === undefined) {
-        return [];
-    }
-    const regex = new RegExp(`${[start, end, separator].map(string_1.escapeRegExp).join('|')}`, 'gu'), exploded = [];
-    let mt = regex.exec(str), depth = 0, lastIndex = 0;
-    while (mt) {
-        const { 0: match, index } = mt;
-        if (match !== separator) {
-            depth += match === start ? 1 : -1;
-        }
-        else if (depth === 0) {
-            exploded.push(str.slice(lastIndex, index));
-            ({ lastIndex } = regex);
-        }
-        mt = regex.exec(str);
-    }
-    exploded.push(str.slice(lastIndex));
-    return exploded;
-};
-/**
- * 图片
- * @classdesc `{childNodes: [AtomToken, ...ImageParameterToken]}`
- */
-// @ts-expect-error not implementing all abstract methods
-class FileToken extends base_1.LinkBaseToken {
-    /** @browser */
-    type = 'file';
-    /** 图片链接 */
-    get link() {
-        return this.getArg('link')?.link ?? super.link;
-    }
-    set link(value) {
-        this.setValue('link', String(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', height && `x${height}`);
-        }
-    }
-    /**
-     * @browser
-     * @param link 文件名
-     * @param text 图片参数
-     * @param 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 imageParameter_1.ImageParameterToken(part, config, accum)));
-    }
-    /**
-     * @override
-     * @browser
-     */
-    lint(start = this.getAbsoluteIndex()) {
-        const errors = super.lint(start), 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));
-        if (args.length === keys.length
-            && frameKeys.length < 2 && horizAlignKeys.length < 2 && vertAlignKeys.length < 2) {
-            return errors;
-        }
-        const rect = { start, ...this.getRootNode().posFromIndex(start) };
-        /**
-         * 图片参数到语法错误的映射
-         * @param msg 消息键
-         * @param p1 替换$1
-         */
-        const generate = (msg, p1) => (arg) => (0, lint_1.generateForChild)(arg, rect, Parser.msg(`${msg} image $1 parameter`, p1));
-        for (const key of keys) {
-            let relevantArgs = args.filter(({ name }) => name === key);
-            if (key === 'caption') {
-                relevantArgs = [
-                    ...relevantArgs.slice(0, -1).filter(arg => arg.text()),
-                    ...relevantArgs.slice(-1),
-                ];
-            }
-            if (relevantArgs.length > 1) {
-                errors.push(...relevantArgs.map(generate('duplicated', key)));
-            }
-        }
-        if (frameKeys.length > 1) {
-            errors.push(...args.filter(({ name }) => frame.has(name)).map(generate('conflicting', 'frame')));
-        }
-        if (horizAlignKeys.length > 1) {
-            errors.push(...args.filter(({ name }) => horizAlign.has(name)).map(generate('conflicting', 'horizontal-alignment')));
-        }
-        if (vertAlignKeys.length > 1) {
-            errors.push(...args.filter(({ name }) => vertAlign.has(name)).map(generate('conflicting', 'vertical-alignment')));
-        }
-        return errors;
-    }
-    /**
-     * 获取所有图片参数节点
-     * @browser
-     */
-    getAllArgs() {
-        return this.childNodes.slice(1);
-    }
-    /**
-     * 获取指定图片参数
-     * @browser
-     * @param key 参数名
-     */
-    getArgs(key) {
-        return this.getAllArgs().filter(({ name }) => key === name);
-    }
-    /**
-     * 获取特定类型的图片属性参数节点
-     * @browser
-     * @param keys 接受的参数名
-     * @param type 类型名
-     */
-    #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;
-    }
-    /**
-     * 获取图片框架属性参数节点
-     * @browser
-     */
-    getFrameArgs() {
-        return this.#getTypedArgs(frame, '框架');
-    }
-    /**
-     * 获取图片水平对齐参数节点
-     * @browser
-     */
-    getHorizAlignArgs() {
-        return this.#getTypedArgs(horizAlign, '水平对齐');
-    }
-    /**
-     * 获取图片垂直对齐参数节点
-     * @browser
-     */
-    getVertAlignArgs() {
-        return this.#getTypedArgs(vertAlign, '垂直对齐');
-    }
-    /**
-     * 获取生效的指定图片参数
-     * @param key 参数名
-     */
-    getArg(key) {
-        return this.getArgs(key).at(-1);
-    }
-    /**
-     * 是否具有指定图片参数
-     * @param key 参数名
-     */
-    hasArg(key) {
-        return this.getArgs(key).length > 0;
-    }
-    /**
-     * 移除指定图片参数
-     * @param key 参数名
-     */
-    removeArg(key) {
-        for (const token of this.getArgs(key)) {
-            this.removeChild(token);
-        }
-    }
-    /** 获取图片参数名 */
-    getKeys() {
-        return new Set(this.getAllArgs().map(({ name }) => name));
-    }
-    /**
-     * 获取指定的图片参数值
-     * @param key 参数名
-     */
-    getValues(key) {
-        return this.getArgs(key).map(token => token.getValue());
-    }
-    /**
-     * 获取生效的指定图片参数值
-     * @param key 参数名
-     */
-    getValue(key) {
-        return this.getArg(key)?.getValue();
-    }
-    /**
-     * 设置图片参数
-     * @param key 参数名
-     * @param value 参数值
-     * @throws `RangeError` 未定义的图片参数
-     * @throws `SyntaxError` 非法的参数
-     */
-    setValue(key, value = false) {
-        if (value === false) {
-            this.removeArg(key);
-            return;
-        }
-        const token = this.getArg(key);
-        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');
-            }
-            this.insertAt(Parser.run(() => new imageParameter_1.ImageParameterToken(syntax, config)));
-            return;
-        }
-        const wikitext = `[[File:F|${syntax ? syntax.replace('$1', value) : value}]]`, root = Parser.parse(wikitext, this.getAttribute('include'), 6, config), { length, firstChild: file } = root;
-        if (length !== 1 || file.type !== 'file' || file.length !== 2) {
-            throw new SyntaxError(`非法的 ${key} 参数：${(0, string_1.noWrap)(value)}`);
-        }
-        const { name, lastChild: imageParameter } = file;
-        if (name !== 'File:F' || imageParameter.name !== key) {
-            throw new SyntaxError(`非法的 ${key} 参数：${(0, string_1.noWrap)(value)}`);
-        }
-        this.insertAt(imageParameter);
-    }
-}
-exports.FileToken = FileToken;
-Parser.classes['FileToken'] = __filename;

package/dist/src/link/galleryImage.d.ts

@@ -1,37 +0,0 @@
-import * as Parser from '../../index';
-import { Token } from '..';
-import type { Title } from '../../lib/title';
-import type { LintError } from '../../index';
-declare const GalleryImageToken_base: (abstract new (...args: any[]) => {
-    toString(omit?: Set<string> | undefined): string;
-    text(): string;
-    length: number;
-    insertAt(token: unknown, i?: number | undefined): unknown;
-}) & typeof Parser.FileToken;
-/** 图库图片 */
-export declare class GalleryImageToken extends GalleryImageToken_base {
-    #private;
-    type: 'gallery-image' | 'imagemap-image';
-    /** 图片链接 */
-    get link(): string | Title;
-    set link(value: string | Title);
-    /**
-     * @browser
-     * @param type 图片类型
-     * @param link 图片文件名
-     * @param text 图片参数
-     */
-    constructor(type: 'gallery' | 'imagemap', link: string, text?: string, config?: Parser.Config, accum?: Token[]);
-    /**
-     * @override
-     * @browser
-     */
-    lint(start?: number): LintError[];
-    /**
-     * @override
-     * @param link 链接目标
-     * @throws `SyntaxError` 非法的链接目标
-     */
-    setTarget(link: string): void;
-}
-export {};

package/dist/src/link/galleryImage.js

@@ -1,101 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GalleryImageToken = void 0;
-const lint_1 = require("../../util/lint");
-const debug_1 = require("../../util/debug");
-const singleLine_1 = require("../../mixin/singleLine");
-const Parser = require("../../index");
-const __1 = require("..");
-const file_1 = require("./file");
-/** 图库图片 */
-// @ts-expect-error not implementing all abstract methods
-class GalleryImageToken extends (0, singleLine_1.singleLine)(file_1.FileToken) {
-    /** @browser */
-    #invalid = false;
-    /** 图片链接 */
-    get link() {
-        return this.type === 'imagemap-image' ? '' : super.link;
-    }
-    set link(value) {
-        if (this.type !== 'imagemap-image') {
-            super.link = value;
-        }
-    }
-    /**
-     * @browser
-     * @param type 图片类型
-     * @param link 图片文件名
-     * @param text 图片参数
-     */
-    constructor(type, link, text, config = Parser.getConfig(), accum = []) {
-        let token;
-        if (text !== undefined) {
-            token = new __1.Token(text, config, true, accum);
-            token.type = 'plain';
-            for (let n = 1; n < Parser.MAX_STAGE; n++) {
-                token.parseOnce();
-            }
-            accum.splice(accum.indexOf(token), 1);
-        }
-        super(link, token?.toString(), config, accum);
-        this.setAttribute('bracket', false).type = `${type}-image`;
-    }
-    /** @private */
-    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 = Boolean(titleObj.interwiki) || titleObj.ns !== 6; // 只用于gallery-image的首次解析
-        const /** @implements */ 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) {
-                    (0, debug_1.undo)(e, data);
-                    throw new Error(`非法的图片文件名：${name}`);
-                }
-                else if (interwiki || ns !== 6) {
-                    (0, debug_1.undo)(e, data);
-                    throw new Error(`图片链接不可更改命名空间：${name}`);
-                }
-                this.setAttribute('name', title);
-                this.#invalid = false;
-            }
-        };
-        this.addEventListener(['remove', 'insert', 'replace', 'text'], linkListener);
-    }
-    /** @private */
-    getPadding() {
-        return 0;
-    }
-    /**
-     * @override
-     * @browser
-     */
-    lint(start = this.getAbsoluteIndex()) {
-        const errors = super.lint(start);
-        if (this.#invalid) {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid gallery image'));
-        }
-        return errors;
-    }
-    /**
-     * @override
-     * @param link 链接目标
-     * @throws `SyntaxError` 非法的链接目标
-     */
-    setTarget(link) {
-        const include = this.getAttribute('include'), config = this.getAttribute('config'), root = Parser.parse(`<gallery>${link}</gallery>`, include, 1, config), { length, firstChild: ext } = root;
-        if (length !== 1 || ext.type !== 'ext') {
-            throw new SyntaxError(`非法的图库文件名：${link}`);
-        }
-        const { lastChild: gallery } = ext, { firstChild: image } = gallery;
-        if (gallery.length !== 1 || image.type !== 'gallery-image') {
-            throw new SyntaxError(`非法的图库文件名：${link}`);
-        }
-        const { firstChild } = image;
-        image.destroy();
-        this.firstChild.safeReplaceWith(firstChild);
-    }
-}
-exports.GalleryImageToken = GalleryImageToken;
-Parser.classes['GalleryImageToken'] = __filename;

package/dist/src/link/index.d.ts

@@ -1,50 +0,0 @@
-import { LinkBaseToken } from './base';
-import type { Title } from '../../lib/title';
-import type { Token, AtomToken } from '../../internal';
-/**
- * 内链
- * @classdesc `{childNodes: [AtomToken, ?Token]}`
- */
-export declare class LinkToken extends LinkBaseToken {
-    #private;
-    /** @browser */
-    readonly type: 'link' | 'category';
-    childNodes: [AtomToken] | [AtomToken, Token];
-    abstract get children(): [AtomToken] | [AtomToken, Token];
-    abstract get link(): Title;
-    abstract set link(link: Title);
-    /** 是否链接到自身 */
-    get selfLink(): boolean;
-    set selfLink(selfLink: boolean);
-    /** @override */
-    get fragment(): string | undefined;
-    set fragment(fragment: string | undefined);
-    /** interwiki */
-    get interwiki(): string;
-    /** @throws `RangeError` 非法的跨维基前缀 */
-    set interwiki(interwiki: string);
-    /**
-     * 设置跨语言链接
-     * @param lang 语言前缀
-     * @param link 页面标题
-     * @throws `SyntaxError` 仅有fragment
-     * @throws `SyntaxError` 非法的跨语言链接
-     */
-    setLangLink(lang: string, link: string | Title): void;
-    /**
-     * 设置fragment
-     * @param fragment fragment
-     */
-    setFragment(fragment?: string): void;
-    /**
-     * 修改为到自身的链接
-     * @param fragment fragment
-     * @throws `RangeError` 空fragment
-     */
-    asSelfLink(fragment?: string | undefined): void;
-    /**
-     * 自动生成管道符后的链接文字
-     * @throws `Error` 带有"#"或"%"时不可用
-     */
-    pipeTrick(): void;
-}

package/dist/src/link/index.js

@@ -1,136 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LinkToken = void 0;
-const Parser = require("../../index");
-const base_1 = require("./base");
-/**
- * 内链
- * @classdesc `{childNodes: [AtomToken, ?Token]}`
- */
-// @ts-expect-error not implementing all abstract methods
-class LinkToken extends base_1.LinkBaseToken {
-    /** @browser */
-    type = 'link';
-    /** 是否链接到自身 */
-    get selfLink() {
-        const { link: { title, fragment } } = this;
-        return !title && Boolean(fragment);
-    }
-    set selfLink(selfLink) {
-        if (selfLink) {
-            this.asSelfLink();
-        }
-    }
-    /** @override */
-    get fragment() {
-        return super.fragment;
-    }
-    set fragment(fragment) {
-        this.#setFragment(fragment);
-    }
-    /** interwiki */
-    get interwiki() {
-        return this.link.interwiki;
-    }
-    /** @throws `RangeError` 非法的跨维基前缀 */
-    set interwiki(interwiki) {
-        const { link: { prefix, main, fragment } } = this, link = `${interwiki}:${prefix}${main}${fragment === undefined ? '' : `#${fragment}`}`;
-        if (interwiki && !this.isInterwiki(link)) {
-            throw new RangeError(`${interwiki} 不是合法的跨维基前缀!`);
-        }
-        this.setTarget(link);
-    }
-    /**
-     * 设置跨语言链接
-     * @param lang 语言前缀
-     * @param link 页面标题
-     * @throws `SyntaxError` 仅有fragment
-     * @throws `SyntaxError` 非法的跨语言链接
-     */
-    setLangLink(lang, link) {
-        let strLink = String(link).trim();
-        const [char] = strLink;
-        if (char === '#') {
-            throw new SyntaxError('跨语言链接不能仅为fragment！');
-        }
-        else if (char === ':') {
-            strLink = strLink.slice(1);
-        }
-        const config = this.getAttribute('config'), include = this.getAttribute('include'), root = Parser.parse(`[[${lang}:${strLink}]]`, include, 6, config), { length, firstChild: wikiLink } = root;
-        if (length !== 1 || !(wikiLink instanceof LinkToken) || wikiLink.length !== 1) {
-            throw new SyntaxError(`非法的跨语言链接目标：${lang}:${strLink}`);
-        }
-        const { interwiki, firstChild } = wikiLink;
-        if (interwiki !== lang.toLowerCase()) {
-            throw new SyntaxError(`非法的跨语言链接目标：${lang}:${strLink}`);
-        }
-        wikiLink.destroy();
-        this.firstChild.safeReplaceWith(firstChild);
-    }
-    /**
-     * 设置fragment
-     * @param fragment fragment
-     * @param page 是否是其他页面
-     * @throws `SyntaxError` 非法的fragment
-     */
-    #setFragment(fragment, page = true) {
-        fragment &&= fragment.replace(/[<>[\]#|=]/gu, p => encodeURIComponent(p));
-        const include = this.getAttribute('include'), config = this.getAttribute('config'), root = Parser.parse(`[[${page ? `:${this.name}` : ''}${fragment === undefined ? '' : `#${fragment}`}]]`, include, 6, config), { length, firstChild: wikiLink } = root;
-        if (length !== 1 || !(wikiLink instanceof LinkToken) || wikiLink.length !== 1) {
-            throw new SyntaxError(`非法的 fragment：${fragment ?? ''}`);
-        }
-        else if (page) {
-            Parser.warn(`${this.constructor.name}.setFragment 方法会同时规范化页面名！`);
-        }
-        const { firstChild } = wikiLink;
-        wikiLink.destroy();
-        this.firstChild.safeReplaceWith(firstChild);
-    }
-    /**
-     * 设置fragment
-     * @param fragment fragment
-     */
-    setFragment(fragment) {
-        this.#setFragment(fragment);
-    }
-    /**
-     * 修改为到自身的链接
-     * @param fragment fragment
-     * @throws `RangeError` 空fragment
-     */
-    asSelfLink(fragment = this.fragment) {
-        if (!fragment?.trim()) {
-            throw new RangeError(`${this.constructor.name}.asSelfLink 方法必须指定非空的 fragment！`);
-        }
-        this.#setFragment(fragment, false);
-    }
-    /**
-     * 自动生成管道符后的链接文字
-     * @throws `Error` 带有"#"或"%"时不可用
-     */
-    pipeTrick() {
-        const linkText = this.firstChild.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);
-    }
-}
-exports.LinkToken = LinkToken;
-Parser.classes['LinkToken'] = __filename;

package/dist/src/magicLink.d.ts

@@ -1,47 +0,0 @@
-import * as Parser from '../index';
-import { Token } from '.';
-import type { LintError } from '../index';
-/**
- * 自由外链
- * @classdesc `{childNodes: ...AstText|CommentToken|IncludeToken|NoincludeToken}`
- */
-export declare class MagicLinkToken extends Token {
-    #private;
-    type: 'free-ext-link' | 'ext-link-url';
-    /** 协议 */
-    get protocol(): string | undefined;
-    /**
-     * @throws `RangeError` 非法协议
-     * @throws `Error` 特殊外链无法更改协议
-     */
-    set protocol(value: string | undefined);
-    /** 和内链保持一致 */
-    get link(): string;
-    set link(url: string);
-    /**
-     * @browser
-     * @param url 网址
-     * @param doubleSlash 是否接受"//"作为协议
-     */
-    constructor(url?: string, doubleSlash?: boolean, config?: Parser.Config, accum?: Token[]);
-    /**
-     * @override
-     * @browser
-     */
-    lint(start?: number): LintError[];
-    /** @override */
-    cloneNode(): this;
-    /**
-     * 获取网址
-     * @throws `Error` 非标准协议
-     */
-    getUrl(): URL;
-    /**
-     * 设置外链目标
-     * @param url 含协议的网址
-     * @throws `SyntaxError` 非法的自由外链目标
-     */
-    setTarget(url: string): void;
-    /** 是否是模板或魔术字参数 */
-    isParamValue(): boolean;
-}