wikiparser-node 1.11.0-b → 1.11.0

package/dist/src/link/file.js

@@ -0,0 +1,333 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileToken = void 0;
+const string_1 = require("../../util/string");
+const html_1 = require("../../util/html");
+const lint_1 = require("../../util/lint");
+const rect_1 = require("../../lib/rect");
+const title_1 = require("../../lib/title");
+const debug_1 = require("../../util/debug");
+const constants_1 = require("../../util/constants");
+const index_1 = require("../../index");
+const base_1 = require("./base");
+const imageParameter_1 = require("../imageParameter");
+const frame = new Map([
+    ['manualthumb', 'Thumb'],
+    ['frameless', 'Frameless'],
+    ['framed', 'Frame'],
+    ['thumbnail', 'Thumb'],
+]), 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
+ * @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]}`
+ */
+class FileToken extends base_1.LinkBaseToken {
+    /* NOT FOR BROWSER END */
+    get type() {
+        return 'file';
+    }
+    /** 扩展名 */
+    get extension() {
+        return this.getTitle().extension;
+    }
+    /* NOT FOR BROWSER */
+    /** 图片链接 */
+    get link() {
+        return this.getArg('link')?.link ?? super.link;
+    }
+    set link(value) {
+        this.setValue('link', value);
+    }
+    /** 图片大小 */
+    get size() {
+        const fr = this.getFrame();
+        return fr === 'framed' || fr instanceof title_1.Title ? undefined : this.getArg('width')?.size;
+    }
+    set size(size) {
+        this.setValue('width', size && size.width + (size.height && 'x') + size.height);
+    }
+    /** 图片宽度 */
+    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}`);
+        }
+    }
+    /* NOT FOR BROWSER END */
+    /**
+     * @param link 文件名
+     * @param text 图片参数
+     * @param delimiter `|`
+     */
+    constructor(link, text, config = index_1.default.getConfig(), accum = [], delimiter = '|') {
+        super(link, undefined, config, accum, delimiter);
+        /* NOT FOR BROWSER */
+        this.setAttribute('acceptable', { AtomToken: 0, ImageParameterToken: '1:' });
+        /* NOT FOR BROWSER END */
+        const { extension } = this.getTitle(true);
+        // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+        /-\{|\}-|\|/gu;
+        this.append(...explode('-{', '}-', '|', text).map(
+        // @ts-expect-error abstract class
+        (part) => new imageParameter_1.ImageParameterToken(part, extension, config, accum)));
+    }
+    /** @private */
+    lint(start = this.getAbsoluteIndex(), re) {
+        const errors = super.lint(start, re), 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))], frameKeys = keys.filter(key => frame.has(key)), horizAlignKeys = keys.filter(key => horizAlign.has(key)), vertAlignKeys = keys.filter(key => vertAlign.has(key)), [fr] = frameKeys, unscaled = fr === 'framed' || fr === 'manualthumb', rect = new rect_1.BoundingRect(this, start);
+        if (this.closest('ext-link-text') && this.getValue('link')?.trim() !== '') {
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'nested-link', 'internal link in an external link'));
+        }
+        if (unscaled) {
+            for (const arg of args.filter(({ name }) => name === 'width')) {
+                const e = (0, lint_1.generateForChild)(arg, rect, 'invalid-gallery', 'invalid image parameter');
+                e.fix = { range: [e.startIndex - 1, e.endIndex], text: '' };
+                errors.push(e);
+            }
+        }
+        if (args.length === keys.length
+            && frameKeys.length < 2
+            && horizAlignKeys.length < 2
+            && vertAlignKeys.length < 2) {
+            return errors;
+        }
+        /**
+         * 图片参数到语法错误的映射
+         * @param msg 消息键
+         * @param p1 替换$1
+         */
+        const generate = (msg, p1) => (arg) => (0, lint_1.generateForChild)(arg, rect, 'no-duplicate', index_1.default.msg(`${msg} image $1 parameter`, p1));
+        for (const key of keys) {
+            if (key === 'invalid' || key === 'width' && unscaled) {
+                continue;
+            }
+            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;
+    }
+    /** 获取所有图片参数节点 */
+    getAllArgs() {
+        return this.childNodes.slice(1);
+    }
+    /**
+     * 获取指定图片参数
+     * @param key 参数名
+     */
+    getArgs(key) {
+        return this.getAllArgs().filter(({ name }) => key === name);
+    }
+    /**
+     * 获取生效的指定图片参数
+     * @param key 参数名
+     */
+    getArg(key) {
+        const args = this.getArgs(key);
+        return args[key === 'manualthumb' ? 0 : args.length - 1];
+    }
+    /**
+     * 获取生效的指定图片参数值
+     * @param key 参数名
+     */
+    getValue(key) {
+        return this.getArg(key)?.getValue();
+    }
+    /* NOT FOR BROWSER */
+    /**
+     * 获取特定类型的图片属性参数节点
+     * @param keys 接受的参数名
+     * @param type 类型名
+     */
+    #getTypedArgs(keys, type) {
+        const args = this.getAllArgs().filter(({ name }) => keys.has(name));
+        if (args.length > 1) {
+            index_1.default.warn(`The image ${this.name} has ${args.length} ${type} parameters. Only the last ${args[0].name} will take effect!`);
+        }
+        return args;
+    }
+    /** 获取图片框架属性参数节点 */
+    getFrameArgs() {
+        return this.#getTypedArgs(frame, 'frame');
+    }
+    /** 获取图片水平对齐参数节点 */
+    getHorizAlignArgs() {
+        return this.#getTypedArgs(horizAlign, 'horizontal-align');
+    }
+    /** 获取图片垂直对齐参数节点 */
+    getVertAlignArgs() {
+        return this.#getTypedArgs(vertAlign, 'vertical-align');
+    }
+    /** 获取生效的图片框架属性参数 */
+    getFrame() {
+        const [arg] = this.getFrameArgs(), val = arg?.name;
+        return val === 'manualthumb' ? this.normalizeTitle(arg.getValue(), 6) : val;
+    }
+    /** 获取生效的图片水平对齐参数 */
+    getHorizAlign() {
+        return this.getHorizAlignArgs()[0]?.name;
+    }
+    /** 获取生效的图片垂直对齐参数 */
+    getVertAlign() {
+        return this.getVertAlignArgs()[0]?.name;
+    }
+    /**
+     * 是否具有指定图片参数
+     * @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 参数名
+     * @param value 参数值
+     * @throws `RangeError` 未定义的图片参数
+     */
+    setValue(key, value = false) {
+        if (value === false) {
+            this.removeArg(key);
+            return;
+        }
+        const token = this.getArg(key);
+        if (token) {
+            token.setValue(value);
+            return;
+        }
+        const config = this.getAttribute('config'), syntax = key === 'caption' ? '$1' : Object.entries(config.img).find(([, name]) => name === key)?.[0];
+        if (syntax === undefined) {
+            throw new RangeError(`Unknown image parameter: ${key}`);
+        }
+        const free = syntax.includes('$1');
+        if (value === true && free) {
+            this.typeError('setValue', 'String');
+        }
+        const parameter = debug_1.Shadow.run(
+        // @ts-expect-error abstract class
+        () => new imageParameter_1.ImageParameterToken(syntax.replace('$1', ''), this.extension, config));
+        if (free) {
+            const { childNodes } = index_1.default.parse(value, this.getAttribute('include'), undefined, config);
+            parameter.replaceChildren(...childNodes);
+        }
+        parameter.afterBuild();
+        this.insertAt(parameter);
+    }
+    /**
+     * @override
+     * @throws `Error` 不适用于图片
+     */
+    setLinkText() {
+        throw new Error('LinkBaseToken.setLinkText method is not applicable to images!');
+    }
+    /** @private */
+    toHtmlInternal() {
+        /** @ignore */
+        const isInteger = (n) => Boolean(n && /^\d+$/u.test(n));
+        const { link, width, height } = this, file = this.getAttribute('title'), fr = this.getFrame(), manual = fr instanceof title_1.Title, visibleCaption = manual || fr === 'thumbnail' || fr === 'framed', caption = this.getArg('caption')?.toHtmlInternal(true) ?? '', titleFromCaption = visibleCaption ? '' : (0, string_1.sanitizeAlt)(caption), hasLink = manual || link !== file, title = titleFromCaption || (hasLink && typeof link !== 'string' ? link.getTitleAttr() : ''), titleAttr = title && ` title="${title}"`, alt = (0, string_1.sanitizeAlt)(this.getArg('alt')?.toHtmlInternal(true)) ?? titleFromCaption, horiz = this.getHorizAlign() ?? '', vert = this.getVertAlign() ?? '', className = `${horiz ? `mw-halign-${horiz}` : vert && `mw-valign-${vert}`}${this.getValue('border') ? ' mw-image-border' : ''} ${(0, string_1.sanitizeAlt)(this.getValue('class')) ?? ''}`.trim(), classAttr = className && ` class="${className}"`, img = `<img${alt && ` alt="${alt}"`} src="${(manual ? fr : file).getUrl()}" class="mw-file-element"${isInteger(width) ? ` width="${width}"` : ''}${isInteger(height) ? ` height="${height}"` : ''}>`;
+        let href = '';
+        if (link) {
+            try {
+                href = typeof link === 'string' ? this.getArg('link').getUrl() : link.getUrl();
+                if (link === file) {
+                    const lang = this.getValue('lang'), page = this.getValue('page');
+                    if (lang) {
+                        href += `?lang=${lang}`;
+                    }
+                    else if (page) {
+                        href += `?page=${page}`;
+                    }
+                }
+            }
+            catch { }
+        }
+        const a = link
+            ? `<a${href && ` href="${href}"`}${hasLink ? '' : ` class="mw-file-description"`}${titleAttr}${typeof link === 'string' ? ` rel="nofollow"` : ''}>${img}</a>`
+            : `<span${titleAttr}>${img}</span>`;
+        return (0, html_1.font)(this, horiz || vert || visibleCaption
+            ? `<figure${classAttr} typeof="mw:File${fr ? `/${manual ? 'Thumb' : frame.get(fr)}` : ''}">${a}<figcaption>${caption}</figcaption></figure>`
+            : `<span${classAttr}>${a}</span>`);
+    }
+}
+exports.FileToken = FileToken;
+constants_1.classes['FileToken'] = __filename;

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

@@ -0,0 +1,29 @@
+import Parser from '../../index';
+import { Token } from '../index';
+import { FileToken } from './file';
+import type { Title } from '../../lib/title';
+import type { LintError } from '../../base';
+import type { AtomToken, ImageParameterToken } from '../../internal';
+declare type GalleryTypes = 'gallery' | 'imagemap';
+/** 图库图片 */
+export declare abstract class GalleryImageToken extends FileToken {
+    get type(): `${GalleryTypes}-image`;
+    /** 图片链接 */
+    get link(): string | Title;
+    set link(value: string);
+    /**
+     * @param type 图片类型
+     * @param link 图片文件名
+     * @param text 图片参数
+     */
+    constructor(type: GalleryTypes, link: string, text?: string, config?: Parser.Config, accum?: Token[]);
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     * @throws `RangeError` 不可插入多余子节点
+     * @throws `TypeError` 不可插入文本节点
+     */
+    insertAt<T extends AtomToken | ImageParameterToken>(child: T, i?: number): T;
+}
+export {};

package/dist/src/link/galleryImage.js

@@ -0,0 +1,132 @@
+"use strict";
+var __esDecorate = (this && this.__esDecorate) || function (ctor, descriptorIn, decorators, contextIn, initializers, extraInitializers) {
+    function accept(f) { if (f !== void 0 && typeof f !== "function") throw new TypeError("Function expected"); return f; }
+    var kind = contextIn.kind, key = kind === "getter" ? "get" : kind === "setter" ? "set" : "value";
+    var target = !descriptorIn && ctor ? contextIn["static"] ? ctor : ctor.prototype : null;
+    var descriptor = descriptorIn || (target ? Object.getOwnPropertyDescriptor(target, contextIn.name) : {});
+    var _, done = false;
+    for (var i = decorators.length - 1; i >= 0; i--) {
+        var context = {};
+        for (var p in contextIn) context[p] = p === "access" ? {} : contextIn[p];
+        for (var p in contextIn.access) context.access[p] = contextIn.access[p];
+        context.addInitializer = function (f) { if (done) throw new TypeError("Cannot add initializers after decoration has completed"); extraInitializers.push(accept(f || null)); };
+        var result = (0, decorators[i])(kind === "accessor" ? { get: descriptor.get, set: descriptor.set } : descriptor[key], context);
+        if (kind === "accessor") {
+            if (result === void 0) continue;
+            if (result === null || typeof result !== "object") throw new TypeError("Object expected");
+            if (_ = accept(result.get)) descriptor.get = _;
+            if (_ = accept(result.set)) descriptor.set = _;
+            if (_ = accept(result.init)) initializers.unshift(_);
+        }
+        else if (_ = accept(result)) {
+            if (kind === "field") initializers.unshift(_);
+            else descriptor[key] = _;
+        }
+    }
+    if (target) Object.defineProperty(target, contextIn.name, descriptor);
+    done = true;
+};
+var __runInitializers = (this && this.__runInitializers) || function (thisArg, initializers, value) {
+    var useValue = arguments.length > 2;
+    for (var i = 0; i < initializers.length; i++) {
+        value = useValue ? initializers[i].call(thisArg, value) : initializers[i].call(thisArg);
+    }
+    return useValue ? value : void 0;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GalleryImageToken = void 0;
+const lint_1 = require("../../util/lint");
+const constants_1 = require("../../util/constants");
+const singleLine_1 = require("../../mixin/singleLine");
+const index_1 = require("../../index");
+const index_2 = require("../index");
+const file_1 = require("./file");
+const imageParameter_1 = require("../imageParameter");
+/** 图库图片 */
+let GalleryImageToken = (() => {
+    let _classDecorators = [singleLine_1.singleLine];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = file_1.FileToken;
+    var GalleryImageToken = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            GalleryImageToken = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /** @private */
+        privateType = 'imagemap-image';
+        get type() {
+            return this.privateType;
+        }
+        /* NOT FOR BROWSER */
+        /** 图片链接 */
+        get link() {
+            return this.type === 'imagemap-image' ? '' : super.link;
+        }
+        set link(value) {
+            if (this.type !== 'imagemap-image') {
+                super.link = value;
+            }
+        }
+        /* NOT FOR BROWSER END */
+        /**
+         * @param type 图片类型
+         * @param link 图片文件名
+         * @param text 图片参数
+         */
+        constructor(type, link, text, config = index_1.default.getConfig(), accum = []) {
+            let token;
+            if (text !== undefined) {
+                const { length } = accum;
+                token = new index_2.Token(text, config, accum);
+                for (let n = 1; n < constants_1.MAX_STAGE; n++) {
+                    token.parseOnce();
+                }
+                accum.splice(length, 1);
+            }
+            super(link, token?.toString(), config, accum);
+            this.setAttribute('bracket', false);
+            this.privateType = `${type}-image`;
+            this.seal('privateType', true);
+        }
+        /** @private */
+        getTitle() {
+            const imagemap = this.type === 'imagemap-image';
+            return this.normalizeTitle(this.firstChild.toString(), imagemap ? 0 : 6, true, !imagemap);
+        }
+        /** @private */
+        getAttribute(key) {
+            return key === 'padding' ? 0 : super.getAttribute(key);
+        }
+        /** @private */
+        lint(start = this.getAbsoluteIndex(), re) {
+            const errors = super.lint(start, re), { ns, interwiki } = this.getAttribute('title');
+            if (interwiki || ns !== 6) {
+                errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid-gallery', 'invalid gallery image'));
+            }
+            return errors;
+        }
+        /* NOT FOR BROWSER */
+        /**
+         * @override
+         * @param token 待插入的子节点
+         * @param i 插入位置
+         * @throws `RangeError` 不可插入多余子节点
+         * @throws `TypeError` 不可插入文本节点
+         */
+        insertAt(child, i) {
+            if (this.type === 'gallery-image' && child.type === 'image-parameter' && !imageParameter_1.galleryParams.has(child.name)) {
+                child.setAttribute('name', 'invalid');
+            }
+            return super.insertAt(child, i);
+        }
+    };
+    return GalleryImageToken = _classThis;
+})();
+exports.GalleryImageToken = GalleryImageToken;
+constants_1.classes['GalleryImageToken'] = __filename;

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

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

package/dist/src/link/index.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkToken = void 0;
+const lint_1 = require("../../util/lint");
+const constants_1 = require("../../util/constants");
+const string_1 = require("../../util/string");
+const base_1 = require("./base");
+/**
+ * 内链
+ * @classdesc `{childNodes: [AtomToken, ?Token]}`
+ */
+class LinkToken extends base_1.LinkBaseToken {
+    /* NOT FOR BROWSER END */
+    get type() {
+        return 'link';
+    }
+    /* NOT FOR BROWSER */
+    /** 链接显示文字 */
+    get innerText() {
+        return this.length > 1 ? this.lastChild.text() : (0, string_1.rawurldecode)(this.firstChild.text().replace(/^\s*:?/u, ''));
+    }
+    set innerText(text) {
+        this.setLinkText(text);
+    }
+    /** 是否链接到自身 */
+    get selfLink() {
+        const { link: { title, fragment } } = this;
+        return !title && Boolean(fragment);
+    }
+    set selfLink(selfLink) {
+        if (selfLink) {
+            this.asSelfLink();
+        }
+    }
+    /* NOT FOR BROWSER END */
+    /** @private */
+    lint(start = this.getAbsoluteIndex(), re) {
+        const errors = super.lint(start, re);
+        if (this.closest('ext-link-text')) {
+            errors.push((0, lint_1.generateForSelf)(this, { start }, 'nested-link', 'internal link in an external link'));
+        }
+        return errors;
+    }
+    /* NOT FOR BROWSER */
+    /**
+     * 设置跨语言链接
+     * @param lang 语言前缀
+     * @param link 页面标题
+     * @throws `SyntaxError` 仅有fragment
+     */
+    setLangLink(lang, link) {
+        link = link.trim();
+        if (link.startsWith('#')) {
+            throw new SyntaxError('An interlanguage link cannot be fragment only!');
+        }
+        super.setTarget(lang + (link.startsWith(':') ? '' : ':') + link);
+    }
+    /**
+     * 修改为到自身的链接
+     * @param fragment fragment
+     * @throws `RangeError` 空fragment
+     */
+    asSelfLink(fragment = this.fragment) {
+        if (!fragment?.trim()) {
+            throw new RangeError('LinkToken.asSelfLink method must specify a non-empty fragment!');
+        }
+        this.setTarget(`#${(0, string_1.encode)(fragment)}`);
+    }
+    /**
+     * 自动生成管道符后的链接文字
+     * @throws `Error` 带有"#"或"%"时不可用
+     */
+    pipeTrick() {
+        const linkText = this.firstChild.text();
+        if (linkText.includes('#') || linkText.includes('%')) {
+            throw new Error('Pipe trick cannot be used with "#" or "%"!');
+        }
+        const m1 = /^:?(?:[ \w\x80-\xFF-]+:)?([^(]+?) ?\(.+\)$/u.exec(linkText);
+        if (m1) {
+            this.setLinkText(m1[1]);
+            return;
+        }
+        const m2 = /^:?(?:[ \w\x80-\xFF-]+:)?([^（]+?) ?（.+）$/u.exec(linkText);
+        if (m2) {
+            this.setLinkText(m2[1]);
+            return;
+        }
+        const m3 = /^:?(?:[ \w\x80-\xFF-]+:)?(.+?)(?: ?(?<!\()\(.+\))?(?:(?:, |，|، ).|$)/u
+            .exec(linkText);
+        if (m3) {
+            this.setLinkText(m3[1]);
+            return;
+        }
+        this.setLinkText(linkText);
+    }
+}
+exports.LinkToken = LinkToken;
+constants_1.classes['LinkToken'] = __filename;

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

@@ -0,0 +1,27 @@
+import Parser from '../../index';
+import { LinkBaseToken } from './base';
+import { NoincludeToken } from '../nowiki/noinclude';
+import type { LintError } from '../../base';
+import type { Title } from '../../lib/title';
+import type { Token, AtomToken } from '../../internal';
+/**
+ * 重定向目标
+ * @classdesc `{childNodes: [AtomToken, ?NoincludeToken]}`
+ */
+export declare abstract class RedirectTargetToken extends LinkBaseToken {
+    readonly childNodes: readonly [AtomToken] | readonly [AtomToken, NoincludeToken];
+    abstract get lastChild(): AtomToken | NoincludeToken;
+    abstract get children(): [AtomToken] | [AtomToken, NoincludeToken];
+    abstract get lastElementChild(): AtomToken | NoincludeToken;
+    abstract get link(): Title;
+    abstract set link(link: string);
+    get type(): 'redirect-target';
+    /** 链接显示文字 */
+    get innerText(): string;
+    /**
+     * @param link 链接标题
+     * @param linkText 链接显示文字
+     * @param delimiter `|`
+     */
+    constructor(link: string, linkText?: string, config?: Parser.Config, accum?: Token[]);
+}