wikiparser-node 1.5.2-b → 1.5.2

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

@@ -0,0 +1,32 @@
+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 {
+    #private;
+    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 */
+    lint(start?: number): LintError[];
+    /**
+     * @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,157 @@
+"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 debug_1 = require("../../util/debug");
+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);
+        }
+        /* 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) {
+                token = new index_2.Token(text, config, accum);
+                token.type = 'plain';
+                for (let n = 1; n < constants_1.MAX_STAGE; n++) {
+                    token.parseOnce();
+                }
+                accum.splice(accum.indexOf(token), 1);
+            }
+            super(link, token?.toString(), config, accum);
+            this.setAttribute('bracket', false);
+            this.type = `${type}-image`;
+        }
+        /** @private */
+        getTitle() {
+            const imagemap = this.type === 'imagemap-image';
+            return this.normalizeTitle(String(this.firstChild), imagemap ? 0 : 6, true, !imagemap);
+        }
+        /** @private */
+        getAttribute(key) {
+            return key === 'padding' ? 0 : super.getAttribute(key);
+        }
+        /** @override */
+        lint(start = this.getAbsoluteIndex()) {
+            const errors = super.lint(start), { ns, interwiki } = this.getAttribute('title');
+            if (interwiki || ns !== 6) {
+                errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid-gallery', 'invalid gallery image'));
+            }
+            return errors;
+        }
+        /**
+         * 设置`#title`
+         * @param title Title对象
+         */
+        #setName(title) {
+            this.setAttribute('title', title);
+            /* NOT FOR BROWSER */
+            this.setAttribute('name', title.title);
+        }
+        /** @private */
+        afterBuild() {
+            this.#setName(this.getTitle());
+            /* NOT FOR BROWSER */
+            const /** @implements */ linkListener = (e, data) => {
+                const { prevTarget } = e;
+                if (prevTarget?.type === 'link-target') {
+                    const name = String(prevTarget), title = this.getTitle(), { interwiki, ns, valid } = title;
+                    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.#setName(title);
+                }
+            };
+            this.addEventListener(['remove', 'insert', 'replace', 'text'], linkListener);
+        }
+        /* 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,56 @@
+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 {
+    #private;
+    readonly type = "link";
+    readonly childNodes: readonly [AtomToken] | readonly [AtomToken, Token];
+    abstract get children(): [AtomToken] | [AtomToken, Token];
+    abstract get link(): Title;
+    abstract set link(link: Title);
+    /** 链接显示文字 */
+    get innerText(): string;
+    set innerText(text: string);
+    /** 是否链接到自身 */
+    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);
+    /** @override */
+    lint(start?: number): LintError[];
+    /** @override */
+    setTarget(link: string): void;
+    /**
+     * 设置跨语言链接
+     * @param lang 语言前缀
+     * @param link 页面标题
+     * @throws `SyntaxError` 仅有fragment
+     */
+    setLangLink(lang: string, link: string): 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

@@ -0,0 +1,133 @@
+"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 base_1 = require("./base");
+/**
+ * 内链
+ * @classdesc `{childNodes: [AtomToken, ?Token]}`
+ */
+class LinkToken extends base_1.LinkBaseToken {
+    type = 'link';
+    /** 链接显示文字 */
+    get innerText() {
+        return this.length > 1 ? this.lastChild.text() : 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();
+        }
+    }
+    /** @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);
+    }
+    /* NOT FOR BROWSER END */
+    /** @override */
+    lint(start = this.getAbsoluteIndex()) {
+        const errors = super.lint(start);
+        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 */
+    /** @override */
+    setTarget(link) {
+        super.setTarget(`${/^\s*[:#]/u.test(link) ? '' : ':'}${link}`);
+    }
+    /**
+     * 设置跨语言链接
+     * @param lang 语言前缀
+     * @param link 页面标题
+     * @throws `SyntaxError` 仅有fragment
+     */
+    setLangLink(lang, link) {
+        link = link.trim();
+        if (link.startsWith('#')) {
+            throw new SyntaxError('跨语言链接不能仅为fragment！');
+        }
+        super.setTarget(`${lang}${link.startsWith(':') ? '' : ':'}${link}`);
+    }
+    /**
+     * 设置fragment
+     * @param fragment fragment
+     * @param page 是否是其他页面
+     */
+    #setFragment(fragment, page = true) {
+        fragment &&= fragment.replace(/[<>[\]#|=]/gu, p => encodeURIComponent(p));
+        this.setTarget(`${page ? this.name : ''}${fragment === undefined ? '' : `#${fragment}`}`);
+    }
+    /**
+     * 设置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('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;
+        }
+        // eslint-disable-next-line es-x/no-regexp-lookbehind-assertions
+        const m3 = /^:?(?:[ \w\x80-\xFF-]+:)?(.+?)(?:(?<!\()\(.+\))?(?:, |，|، )./u
+            .exec(linkText);
+        if (m3) {
+            this.setLinkText(m3[1].trim());
+            return;
+        }
+        this.setLinkText(linkText);
+    }
+}
+exports.LinkToken = LinkToken;
+constants_1.classes['LinkToken'] = __filename;

package/dist/src/magicLink.d.ts

@@ -0,0 +1,59 @@
+import Parser from '../index';
+import { Token } from './index';
+import type { LintError } from '../base';
+import type { SyntaxBase } from '../mixin/syntax';
+import type { AstText, CommentToken, IncludeToken, NoincludeToken, TranscludeToken, AstNodes } from '../internal';
+/** NOT FOR BROWSER */
+export interface MagicLinkToken extends SyntaxBase {
+}
+/** NOT FOR BROWSER END */
+/**
+ * 自由外链
+ * @classdesc `{childNodes: ...AstText|CommentToken|IncludeToken|NoincludeToken}`
+ */
+export declare abstract class MagicLinkToken extends Token {
+    type: 'free-ext-link' | 'ext-link-url';
+    readonly childNodes: readonly (AstText | CommentToken | IncludeToken | NoincludeToken | TranscludeToken)[];
+    abstract get firstChild(): AstText | TranscludeToken;
+    abstract get lastChild(): AstText | CommentToken | IncludeToken | NoincludeToken | TranscludeToken;
+    abstract get children(): (CommentToken | IncludeToken | NoincludeToken | TranscludeToken)[];
+    abstract get firstElementChild(): CommentToken | IncludeToken | NoincludeToken | TranscludeToken | undefined;
+    abstract get lastElementChild(): CommentToken | IncludeToken | NoincludeToken | TranscludeToken | undefined;
+    /** 协议 */
+    get protocol(): string | undefined;
+    /** @throws `Error` 特殊外链无法更改协议n */
+    set protocol(value: string | undefined);
+    /** 和内链保持一致 */
+    get link(): string;
+    set link(url: string);
+    /**
+     * @param url 网址
+     * @param doubleSlash 是否接受"//"作为协议
+     */
+    constructor(url?: string, doubleSlash?: boolean, config?: Parser.Config, accum?: Token[]);
+    /** @override */
+    lint(start?: number): LintError[];
+    /** @override */
+    cloneNode(): this;
+    /**
+     * @override
+     * @param token 待插入的节点
+     * @param i 插入位置
+     */
+    insertAt(token: string, i?: number): AstText;
+    insertAt<T extends AstNodes>(token: T, i?: number): T;
+    /**
+     * 获取网址
+     * @throws `Error` 非标准协议
+     */
+    getUrl(): URL;
+    /**
+     * 设置外链目标
+     * @param url 含协议的网址
+     */
+    setTarget(url: string): void;
+    /** 是否是模板或魔术字参数 */
+    isParamValue(): boolean;
+    /** 转义 `=` */
+    escape(): void;
+}

package/dist/src/magicLink.js

@@ -0,0 +1,223 @@
+"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.MagicLinkToken = void 0;
+const lint_1 = require("../util/lint");
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+const string_1 = require("../util/string");
+const syntax_1 = require("../mixin/syntax");
+const index_1 = require("../index");
+const index_2 = require("./index");
+/** NOT FOR BROWSER END */
+/**
+ * 自由外链
+ * @classdesc `{childNodes: ...AstText|CommentToken|IncludeToken|NoincludeToken}`
+ */
+let MagicLinkToken = (() => {
+    let _classDecorators = [(0, syntax_1.syntax)()];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = index_2.Token;
+    var MagicLinkToken = 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);
+            MagicLinkToken = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /** 协议 */
+        get protocol() {
+            return this.pattern.exec(this.text())?.[0];
+        }
+        /** @throws `Error` 特殊外链无法更改协议n */
+        set protocol(value) {
+            if (typeof value !== 'string') {
+                this.typeError('protocol', 'String');
+            }
+            const { link, pattern } = this;
+            if (!pattern.test(link)) {
+                throw new Error(`特殊外链无法更改协议：${link}`);
+            }
+            this.setTarget(link.replace(pattern, value));
+        }
+        /** 和内链保持一致 */
+        get link() {
+            const map = { '!': '|', '=': '=' };
+            return (0, string_1.text)(this.childNodes.map(child => {
+                const { type, name } = child;
+                return type === 'magic-word' && name in map ? map[name] : child;
+            }));
+        }
+        set link(url) {
+            this.setTarget(url);
+        }
+        /* NOT FOR BROWSER END */
+        /**
+         * @param url 网址
+         * @param doubleSlash 是否接受"//"作为协议
+         */
+        constructor(url, doubleSlash = false, config = index_1.default.getConfig(), accum = []) {
+            super(url, config, accum, {
+                'Stage-1': '1:', '!ExtToken': '', AstText: ':', TranscludeToken: ':',
+            });
+            this.type = doubleSlash ? 'ext-link-url' : 'free-ext-link';
+            /* NOT FOR BROWSER */
+            this.setAttribute('pattern', new RegExp(`^(?:${config.protocol}${doubleSlash ? '|//' : ''})`, 'iu'));
+        }
+        /** @override */
+        lint(start = this.getAbsoluteIndex()) {
+            const errors = super.lint(start), source = `[，；。：！？（）]+${this.type === 'ext-link-url' ? '|\\|+' : ''}`, regex = new RegExp(source, 'u'), regexGlobal = new RegExp(source, 'gu');
+            let rect;
+            for (const child of this.childNodes) {
+                const { type, data } = child;
+                if (type !== 'text' || !regex.test(data)) {
+                    continue;
+                }
+                rect ??= { start, ...this.getRootNode().posFromIndex(start) };
+                const refError = (0, lint_1.generateForChild)(child, rect, 'unterminated-url', '', 'warning');
+                regexGlobal.lastIndex = 0;
+                for (let mt = regexGlobal.exec(data); mt; mt = regexGlobal.exec(data)) {
+                    const { index, 0: s } = mt, lines = data.slice(0, index).split('\n'), top = lines.length, left = lines[top - 1].length, startIndex = refError.startIndex + index, startLine = refError.startLine + top - 1, startCol = top === 1 ? refError.startCol + left : left, pipe = s.startsWith('|');
+                    const e = {
+                        ...refError,
+                        message: index_1.default.msg('$1 in URL', pipe ? '"|"' : 'full-width punctuation'),
+                        startIndex,
+                        endIndex: startIndex + s.length,
+                        startLine,
+                        endLine: startLine,
+                        startCol,
+                        endCol: startCol + s.length,
+                    };
+                    if (!pipe) {
+                        e.suggestions = [
+                            {
+                                desc: 'whitespace',
+                                range: [startIndex, startIndex],
+                                text: ' ',
+                            },
+                            {
+                                desc: 'escape',
+                                range: [startIndex, e.endIndex],
+                                text: encodeURI(s),
+                            },
+                        ];
+                    }
+                    else if (s.length === 1) {
+                        e.suggestions = [
+                            {
+                                desc: 'whitespace',
+                                range: [startIndex, startIndex + 1],
+                                text: ' ',
+                            },
+                        ];
+                    }
+                    errors.push(e);
+                }
+            }
+            return errors;
+        }
+        /* NOT FOR BROWSER */
+        /** @override */
+        cloneNode() {
+            const cloned = this.cloneChildNodes();
+            return debug_1.Shadow.run(() => {
+                // @ts-expect-error abstract class
+                const token = new MagicLinkToken(undefined, this.type === 'ext-link-url', this.getAttribute('config'));
+                token.append(...cloned);
+                token.afterBuild();
+                return token;
+            });
+        }
+        insertAt(token, i) {
+            if (typeof token !== 'string') {
+                const { type, name } = token;
+                if (type === 'template') {
+                    this.constructorError('不可插入模板');
+                }
+                else if (!debug_1.Shadow.running && type === 'magic-word' && name !== '!' && name !== '=') {
+                    this.constructorError('不可插入 "{{!}}" 或 "{{=}}" 以外的魔术字');
+                }
+            }
+            return super.insertAt(token, i);
+        }
+        /**
+         * 获取网址
+         * @throws `Error` 非标准协议
+         */
+        getUrl() {
+            let { link } = this;
+            if (link.startsWith('//')) {
+                link = `https:${link}`;
+            }
+            try {
+                return new URL(link);
+            }
+            catch (e) {
+                if (e instanceof TypeError && e.message === 'Invalid URL') {
+                    throw new Error(`非标准协议的外部链接：${link}`);
+                }
+                throw e;
+            }
+        }
+        /**
+         * 设置外链目标
+         * @param url 含协议的网址
+         */
+        setTarget(url) {
+            const { childNodes } = index_1.default.parse(url, this.getAttribute('include'), 2, this.getAttribute('config'));
+            this.replaceChildren(...childNodes);
+        }
+        /** 是否是模板或魔术字参数 */
+        isParamValue() {
+            return this.closest('parameter')?.getValue() === this.text();
+        }
+        /** 转义 `=` */
+        escape() {
+            for (const child of this.childNodes) {
+                if (child.type === 'text') {
+                    child.escape();
+                }
+            }
+        }
+    };
+    return MagicLinkToken = _classThis;
+})();
+exports.MagicLinkToken = MagicLinkToken;
+constants_1.classes['MagicLinkToken'] = __filename;