wikiparser-node 1.13.1-b → 1.13.1

package/dist/lib/title.js

@@ -0,0 +1,251 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Title = void 0;
+const string_1 = require("../util/string");
+/* NOT FOR BROWSER */
+const constants_1 = require("../util/constants");
+const index_1 = require("../index");
+/* NOT FOR BROWSER END */
+/** MediaWiki页面标题对象 */
+class Title {
+    #main;
+    #namespaces;
+    #ns;
+    #fragment;
+    interwiki = '';
+    valid;
+    /** @private */
+    encoded = false;
+    /* NOT FOR BROWSER */
+    #redirectFragment;
+    #path;
+    /** @private */
+    conversionTable = new Map();
+    /** @private */
+    redirects = new Map();
+    /* NOT FOR BROWSER END */
+    /** 命名空间 */
+    get ns() {
+        return this.#ns;
+    }
+    /** 片段标识符 */
+    get fragment() {
+        return this.#fragment;
+    }
+    /** 不含命名空间的标题主体部分 */
+    get main() {
+        return this.#main;
+    }
+    set main(title) {
+        title = title.replace(/_/gu, ' ').trim();
+        this.#main = title && title[0].toUpperCase() + title.slice(1);
+    }
+    /** 命名空间前缀 */
+    get prefix() {
+        const namespace = this.#namespaces[this.ns];
+        return namespace + (namespace && ':');
+    }
+    /** 完整标题 */
+    get title() {
+        return this.getRedirection()[1];
+    }
+    /** 扩展名 */
+    get extension() {
+        const { main } = this, i = main.lastIndexOf('.');
+        return i === -1 ? undefined : main.slice(i + 1).toLowerCase();
+    }
+    /* NOT FOR BROWSER */
+    set extension(extension) {
+        extension ??= '';
+        const { main } = this, i = main.lastIndexOf('.');
+        this.main = (i === -1 ? main : main.slice(0, i)) + (extension && '.') + extension;
+    }
+    /** @throws `RangeError` undefined namespace */
+    set ns(ns) {
+        if (!(this.ns in this.#namespaces)) {
+            throw new RangeError('Undefined namespace!');
+        }
+        this.#ns = Number(ns);
+    }
+    set fragment(fragment) {
+        if (fragment === undefined) {
+            this.#fragment = undefined;
+        }
+        else {
+            if (fragment.includes('%')) {
+                try {
+                    fragment = (0, string_1.rawurldecode)(fragment);
+                }
+                catch { }
+            }
+            this.#fragment = (0, string_1.decodeHtml)(fragment).replace(/[_ ]+/gu, ' ').trimEnd().replaceAll(' ', '_');
+        }
+    }
+    /* NOT FOR BROWSER END */
+    /**
+     * @see MediaWikiTitleCodec::splitTitleString
+     *
+     * @param title 标题（含或不含命名空间前缀）
+     * @param defaultNs 命名空间
+     * @param decode 是否需要解码
+     * @param selfLink 是否允许selfLink
+     */
+    constructor(title, defaultNs, config, decode, selfLink) {
+        const subpage = title.trim().startsWith('../');
+        if (decode && title.includes('%')) {
+            try {
+                const encoded = /%(?!21|3[ce]|5[bd]|7[b-d])[\da-f]{2}/iu.test(title);
+                title = (0, string_1.rawurldecode)(title);
+                this.encoded = encoded;
+            }
+            catch { }
+        }
+        title = (0, string_1.decodeHtml)(title).replace(/[_ ]+/gu, ' ').trim();
+        if (subpage) {
+            this.#ns = 0;
+        }
+        else {
+            let ns = defaultNs;
+            if (title.startsWith(':')) {
+                ns = 0;
+                title = title.slice(1).trim();
+            }
+            /* NOT FOR BROWSER */
+            const iw = defaultNs ? null : index_1.default.isInterwiki(title, config);
+            if (iw) {
+                this.interwiki = iw[1].toLowerCase();
+                title = title.slice(iw.indices[0][1]);
+            }
+            /* NOT FOR BROWSER END */
+            const m = title.split(':');
+            if (m.length > 1) {
+                const k = m[0].trim().toLowerCase(), id = Object.prototype.hasOwnProperty.call(config.nsid, k) && config.nsid[k];
+                if (id) {
+                    ns = id;
+                    title = m.slice(1).join(':').trim();
+                }
+            }
+            this.#ns = ns;
+        }
+        const i = title.indexOf('#');
+        if (i !== -1) {
+            let fragment = title.slice(i + 1).trimEnd();
+            if (fragment.includes('%')) {
+                try {
+                    fragment = (0, string_1.rawurldecode)(fragment);
+                }
+                catch { }
+            }
+            this.#fragment = fragment.replace(/ /gu, '_');
+            title = title.slice(0, i).trim();
+        }
+        this.valid = Boolean(title || this.interwiki || selfLink && this.ns === 0 && this.#fragment !== undefined)
+            && (0, string_1.decodeHtml)(title) === title
+            && !/^:|\0\d+[eh!+-]\x7F|[<>[\]{}|\n]|%[\da-f]{2}|(?:^|\/)\.{1,2}(?:$|\/)/iu.test(subpage ? /^(?:\.\.\/)+(.*)/u.exec(title)[1] : title);
+        this.main = title;
+        Object.defineProperties(this, {
+            encoded: { enumerable: false, writable: false },
+            /* NOT FOR BROWSER */
+            valid: { writable: false },
+            conversionTable: { enumerable: false },
+            redirects: { enumerable: false },
+        });
+        this.#namespaces = config.namespaces;
+        this.#path = config.articlePath || '/wiki/$1';
+    }
+    /** @private */
+    toString(display) {
+        return `${display ? this.title.replace(/_/gu, ' ') : this.title}${this.#fragment === undefined
+            && this.#redirectFragment === undefined
+            ? ''
+            : `#${this.#fragment
+                ?? this.#redirectFragment}`}`;
+    }
+    /** 检测是否是重定向 */
+    getRedirection() {
+        const prefix = this.interwiki + (this.interwiki && ':') + this.prefix;
+        let title = (prefix + this.main).replace(/ /gu, '_');
+        /* NOT FOR BROWSER */
+        let redirected = this.#redirect(title);
+        if (redirected) {
+            return [true, redirected];
+        }
+        this.autoConvert();
+        title = (prefix + this.main).replaceAll(' ', '_');
+        redirected = this.#redirect(title);
+        if (redirected) {
+            return [true, redirected];
+        }
+        /* NOT FOR BROWSER END */
+        return [false, title];
+    }
+    /** @private */
+    setFragment(fragment) {
+        this.#fragment = fragment;
+    }
+    /* NOT FOR BROWSER */
+    /**
+     * 处理重定向
+     * @param title 原标题
+     */
+    #redirect(title) {
+        const media = title.startsWith('Media:');
+        if (media) {
+            title = `File:${title.slice(6)}`;
+        }
+        const redirected = this.redirects.get(title);
+        if (redirected) {
+            [title, this.#redirectFragment] = redirected.split('#', 2);
+            return media ? title.replace(/^File:/u, 'Media:') : title;
+        }
+        return '';
+    }
+    /** 执行单向转换 */
+    autoConvert() {
+        const { conversionTable } = this;
+        if (conversionTable.size > 0) {
+            const regex = new RegExp([...conversionTable.keys()].sort().reverse().map(string_1.escapeRegExp).join('|'), 'gu');
+            this.main = this.main.replace(regex, p => conversionTable.get(p));
+        }
+    }
+    /** 转换为主页面 */
+    toSubjectPage() {
+        if (this.isTalkPage()) {
+            this.#ns--;
+        }
+    }
+    /** 转换为讨论页面 */
+    toTalkPage() {
+        if (!this.isTalkPage()) {
+            this.#ns++;
+        }
+    }
+    /** 是否是讨论页 */
+    isTalkPage() {
+        return this.ns % 2 === 1;
+    }
+    /** 转换为上一级页面 */
+    toBasePage() {
+        this.main = this.main.replace(/\/[^/]*$/u, '');
+    }
+    /** 转换为根页面 */
+    toRootPage() {
+        this.main = this.main.replace(/\/.*/u, '');
+    }
+    /** 生成URL */
+    getUrl() {
+        const { title, fragment } = this;
+        if (title) {
+            return this.#path.replace('$1', `${encodeURIComponent(title)}${fragment === undefined && this.#redirectFragment === undefined
+                ? ''
+                : `#${encodeURIComponent(fragment ?? this.#redirectFragment)}`}`);
+        }
+        return fragment === undefined ? '' : `#${encodeURIComponent(fragment)}`;
+    }
+    /** @private */
+    getTitleAttr() {
+        return this.title.replace(/^Media:/u, '').replace(/["_]/gu, p => p === '"' ? '&quot;' : ' ');
+    }
+}
+exports.Title = Title;
+constants_1.classes['Title'] = __filename;

package/dist/mixin/attributesParent.d.ts

@@ -0,0 +1,49 @@
+export interface AttributesParentBase {
+    /** getAttrs()方法的getter写法 */
+    attributes: Record<string, string | true>;
+    /** 以字符串表示的class属性 */
+    className: string;
+    /** 以Set表示的class属性 */
+    classList: Set<string>;
+    /** id属性 */
+    id: string;
+    /**
+     * 获取AttributesToken子节点的属性
+     * @param key 属性键
+     */
+    getAttr(key: string): string | true | undefined;
+    /**
+     * AttributesToken子节点是否具有某属性
+     * @param key 属性键
+     */
+    hasAttr(key: string): boolean;
+    /** 列举AttributesToken子节点的属性键 */
+    getAttrNames(): Set<string>;
+    /** 获取AttributesToken子节点的全部标签属性 */
+    getAttrs(): Record<string, string | true>;
+    /**
+     * 对AttributesToken子节点设置属性
+     * @param key 属性键
+     * @param value 属性值
+     * @param prop 属性对象
+     */
+    setAttr(key: string, value: string | boolean): void;
+    setAttr(prop: Record<string, string | boolean>): void;
+    /**
+     * 移除AttributesToken子节点的某属性
+     * @param key 属性键
+     */
+    removeAttr(key: string): void;
+    /**
+     * 开关AttributesToken子节点的某属性
+     * @param key 属性键
+     * @param force 强制开启或关闭
+     */
+    toggleAttr(key: string, force?: boolean): void;
+}
+/**
+ * 子节点含有AttributesToken的类
+ * @param i AttributesToken子节点的位置
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/attributesParent.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributesParent = void 0;
+const debug_1 = require("../util/debug");
+/* NOT FOR BROWSER */
+const constants_1 = require("../util/constants");
+/**
+ * 子节点含有AttributesToken的类
+ * @param i AttributesToken子节点的位置
+ * @param constructor 基类
+ * @param _ context
+ */
+const attributesParent = (i = 0) => (constructor, _) => {
+    /** 子节点含有AttributesToken的类 */
+    class AttributesParent extends constructor {
+        /** AttributesToken子节点 */
+        get #attributesChild() {
+            return this.childNodes[i];
+        }
+        /* NOT FOR BROWSER */
+        /** @implements */
+        get attributes() {
+            return this.#attributesChild.attributes;
+        }
+        set attributes(attributes) {
+            this.#attributesChild.attributes = attributes;
+        }
+        /** @implements */
+        get className() {
+            return this.#attributesChild.className;
+        }
+        set className(className) {
+            this.#attributesChild.className = className;
+        }
+        /** @implements */
+        get classList() {
+            return this.#attributesChild.classList;
+        }
+        /** @implements */
+        get id() {
+            return this.#attributesChild.id;
+        }
+        set id(id) {
+            this.#attributesChild.id = id;
+        }
+        /* NOT FOR BROWSER END */
+        /** @implements */
+        getAttr(key) {
+            return this.#attributesChild.getAttr(key);
+        }
+        /* NOT FOR BROWSER */
+        /** @implements */
+        hasAttr(key) {
+            return this.#attributesChild.hasAttr(key);
+        }
+        /** @implements */
+        getAttrNames() {
+            return this.#attributesChild.getAttrNames();
+        }
+        /** @implements */
+        getAttrs() {
+            return this.#attributesChild.getAttrs();
+        }
+        setAttr(keyOrProp, value) {
+            this.#attributesChild.setAttr(keyOrProp, value);
+        }
+        /** @implements */
+        removeAttr(key) {
+            this.#attributesChild.removeAttr(key);
+        }
+        /** @implements */
+        toggleAttr(key, force) {
+            this.#attributesChild.toggleAttr(key, force);
+        }
+    }
+    (0, debug_1.mixin)(AttributesParent, constructor);
+    return AttributesParent;
+};
+exports.attributesParent = attributesParent;
+constants_1.mixins['attributesParent'] = __filename;

package/dist/mixin/fixed.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 不可增删子节点的类
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/fixed.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fixedToken = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/**
+ * 不可增删子节点的类
+ * @param constructor 基类
+ * @param _ context
+ */
+const fixedToken = (constructor, _) => {
+    /** 不可增删子节点的类 */
+    class FixedToken extends constructor {
+        /** @private */
+        get fixed() {
+            return true;
+        }
+        /** @override */
+        removeAt() {
+            this.constructorError('cannot remove child nodes');
+        }
+        insertAt(token, i) {
+            return debug_1.Shadow.running
+                ? super.insertAt(token, i)
+                : this.constructorError('cannot insert child nodes');
+        }
+    }
+    (0, debug_1.mixin)(FixedToken, constructor);
+    return FixedToken;
+};
+exports.fixedToken = fixedToken;
+constants_1.mixins['fixedToken'] = __filename;

package/dist/mixin/flagsParent.d.ts

@@ -0,0 +1,43 @@
+import type { ConverterFlagsToken } from '../src/converterFlags';
+export interface FlagsParentBase {
+    /** 所有转换类型标记 */
+    flags: Set<string>;
+    /** 获取所有转换类型标记 */
+    getAllFlags(): Set<string>;
+    /** 获取有效的转换类型标记 */
+    getEffectiveFlags(): Set<string>;
+    /** 获取未知的转换类型标记 */
+    getUnknownFlags(): Set<string>;
+    /** 获取指定语言变体的转换标记 */
+    getVariantFlags(): Set<string>;
+    /**
+     * 是否具有某转换类型标记
+     * @param flag 转换类型标记
+     */
+    hasFlag(flag: string): boolean;
+    /**
+     * 是否具有某有效的转换类型标记
+     * @param flag 转换类型标记
+     */
+    hasEffectiveFlag(flag: string): boolean;
+    /**
+     * 移除转换类型标记
+     * @param flag 转换类型标记
+     */
+    removeFlag(flag: string): void;
+    /**
+     * 设置转换类型标记
+     * @param flag 转换类型标记
+     */
+    setFlag(flag: string): void;
+    /**
+     * 开关某转换类型标记
+     * @param flag 转换类型标记
+     */
+    toggleFlag(flag: string): void;
+}
+/**
+ * ConverterToken
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/flagsParent.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flagsParent = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/* NOT FOR BROWSER END */
+/**
+ * ConverterToken
+ * @param constructor 基类
+ * @param _ context
+ */
+const flagsParent = (constructor, _) => {
+    /** 子节点含有ConverterFlagsToken的类 */
+    class FlagsParent extends constructor {
+        /* NOT FOR BROWSER */
+        /** @implements */
+        get flags() {
+            return this.firstChild.flags;
+        }
+        set flags(value) {
+            this.firstChild.flags = value;
+        }
+        /** @implements */
+        getAllFlags() {
+            return this.firstChild.getAllFlags();
+        }
+        /** @implements */
+        getEffectiveFlags() {
+            return this.firstChild.getEffectiveFlags();
+        }
+        /** @implements */
+        getUnknownFlags() {
+            return this.firstChild.getUnknownFlags();
+        }
+        /** @implements */
+        getVariantFlags() {
+            return this.firstChild.getVariantFlags();
+        }
+        /** @implements */
+        hasFlag(flag) {
+            return this.firstChild.hasFlag(flag);
+        }
+        /** @implements */
+        hasEffectiveFlag(flag) {
+            return this.firstChild.hasEffectiveFlag(flag);
+        }
+        /** @implements */
+        removeFlag(flag) {
+            this.firstChild.removeFlag(flag);
+        }
+        /** @implements */
+        setFlag(flag) {
+            this.firstChild.setFlag(flag);
+        }
+        /** @implements */
+        toggleFlag(flag) {
+            this.firstChild.toggleFlag(flag);
+        }
+    }
+    (0, debug_1.mixin)(FlagsParent, constructor);
+    return FlagsParent;
+};
+exports.flagsParent = flagsParent;
+constants_1.mixins['flagsParent'] = __filename;

package/dist/mixin/hidden.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 解析后不可见的类
+ * @param linter 是否覆写 lint 方法
+ * @param html 是否覆写 toHtml 方法
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/hidden.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hiddenToken = void 0;
+const debug_1 = require("../util/debug");
+/* NOT FOR BROWSER */
+const constants_1 = require("../util/constants");
+/* NOT FOR BROWSER END */
+/**
+ * 解析后不可见的类
+ * @param linter 是否覆写 lint 方法
+ * @param html 是否覆写 toHtml 方法
+ * @param constructor 基类
+ * @param _ context
+ */
+const hiddenToken = (linter = true, html = true) => (constructor, _) => {
+    /** 解析后不可见的类 */
+    class AnyHiddenToken extends constructor {
+        /** 没有可见部分 */
+        text() {
+            return '';
+        }
+        lint(start) {
+            // @ts-expect-error private argument
+            return linter ? [] : super.lint(start);
+        }
+        /* NOT FOR BROWSER */
+        /** @private */
+        dispatchEvent() {
+            //
+        }
+        toHtmlInternal() {
+            return html ? '' : super.toHtmlInternal();
+        }
+    }
+    (0, debug_1.mixin)(AnyHiddenToken, constructor);
+    return AnyHiddenToken;
+};
+exports.hiddenToken = hiddenToken;
+constants_1.mixins['hiddenToken'] = __filename;

package/dist/mixin/magicLinkParent.d.ts

@@ -0,0 +1,19 @@
+import type { MagicLinkToken } from '../src/magicLink';
+export interface MagicLinkParentBase {
+    /** 协议 */
+    protocol: string | undefined;
+    /** 和内链保持一致 */
+    link: string;
+    /** 获取网址 */
+    getUrl(): URL;
+    /**
+     * 设置链接目标
+     * @param url 网址
+     */
+    setTarget(url: string): void;
+}
+/**
+ * ExtLinkToken
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/magicLinkParent.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.magicLinkParent = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/* NOT FOR BROWSER END */
+/**
+ * ExtLinkToken
+ * @param constructor 基类
+ * @param _ context
+ */
+const magicLinkParent = (constructor, _) => {
+    /** 子节点含有MagicLinkParent的类 */
+    class MagicLinkParent extends constructor {
+        /* NOT FOR BROWSER */
+        /** @implements */
+        get protocol() {
+            return this.firstChild.protocol;
+        }
+        set protocol(value) {
+            this.firstChild.protocol = value;
+        }
+        /** @implements */
+        get link() {
+            return this.firstChild.link;
+        }
+        set link(url) {
+            this.firstChild.link = url;
+        }
+        /** @implements */
+        getUrl() {
+            return this.firstChild.getUrl();
+        }
+        /** @implements */
+        setTarget(url) {
+            this.firstChild.setTarget(url);
+        }
+    }
+    (0, debug_1.mixin)(MagicLinkParent, constructor);
+    return MagicLinkParent;
+};
+exports.magicLinkParent = magicLinkParent;
+constants_1.mixins['magicLinkParent'] = __filename;

package/dist/mixin/singleLine.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 不可包含换行符的类
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/singleLine.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.singleLine = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/**
+ * 不可包含换行符的类
+ * @param constructor 基类
+ * @param _ context
+ */
+const singleLine = (constructor, _) => {
+    /** 不可包含换行符的类 */
+    class SingleLineToken extends constructor {
+        toString(skip) {
+            return super.toString(skip).replaceAll('\n', ' ');
+        }
+        text() {
+            return super.text().replaceAll('\n', ' ');
+        }
+    }
+    (0, debug_1.mixin)(SingleLineToken, constructor);
+    return SingleLineToken;
+};
+exports.singleLine = singleLine;
+constants_1.mixins['singleLine'] = __filename;

package/dist/mixin/sol.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 只能位于行首的类
+ * @param self 是否允许同类节点相邻
+ * @param constructor 基类
+ * @param _ context
+ */