wikiparser-node 1.12.5-b → 1.12.6

package/dist/src/converterFlags.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConverterFlagsToken = void 0;
+const lint_1 = require("../util/lint");
+const rect_1 = require("../lib/rect");
+const index_1 = require("../index");
+const index_2 = require("./index");
+const atom_1 = require("./atom");
+/* NOT FOR BROWSER */
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/* NOT FOR BROWSER END */
+const definedFlags = new Set(['A', 'T', 'R', 'D', '-', 'H', 'N']);
+/**
+ * 转换flags
+ * @classdesc `{childNodes: ...AtomToken}`
+ */
+class ConverterFlagsToken extends index_2.Token {
+    #flags;
+    /* NOT FOR BROWSER END */
+    get type() {
+        return 'converter-flags';
+    }
+    /* NOT FOR BROWSER */
+    /** 所有转换类型标记 */
+    get flags() {
+        return this.getAllFlags();
+    }
+    set flags(value) {
+        this.replaceChildren();
+        for (const flag of value) {
+            this.#newFlag(flag);
+        }
+    }
+    /* NOT FOR BROWSER END */
+    /** @param flags 转换类型标记 */
+    constructor(flags, config = index_1.default.getConfig(), accum = []) {
+        super(undefined, config, accum, {
+            AtomToken: ':',
+        });
+        this.append(...flags.map(flag => new atom_1.AtomToken(flag, 'converter-flag', config, accum)));
+    }
+    /** @private */
+    afterBuild() {
+        this.#flags = this.childNodes.map(child => child.text().trim());
+        super.afterBuild();
+        /* NOT FOR BROWSER */
+        const /** @implements */ converterFlagsListener = ({ prevTarget }) => {
+            if (prevTarget) {
+                this.#flags[this.childNodes.indexOf(prevTarget)] = prevTarget.text().trim();
+            }
+        };
+        this.addEventListener(['remove', 'insert', 'text', 'replace'], converterFlagsListener);
+    }
+    /** @private */
+    toString(skip) {
+        return super.toString(skip, ';');
+    }
+    /** @private */
+    text() {
+        return super.text(';');
+    }
+    /** @private */
+    getGaps() {
+        return 1;
+    }
+    /** 获取未知的转换类型标记 */
+    getUnknownFlags() {
+        return new Set(this.#flags.filter(flag => /\{{3}[^{}]+\}{3}/u.test(flag)));
+    }
+    /** 获取指定语言变体的转换标记 */
+    getVariantFlags() {
+        const variants = new Set(this.getAttribute('config').variants);
+        return new Set(this.#flags.filter(flag => variants.has(flag)));
+    }
+    /** @private */
+    lint(start = this.getAbsoluteIndex(), re) {
+        const variantFlags = this.getVariantFlags(), unknownFlags = this.getUnknownFlags(), validFlags = new Set(this.#flags.filter(flag => definedFlags.has(flag))), emptyFlagCount = this.#flags.filter(flag => !flag).length, knownFlagCount = this.#flags.length - unknownFlags.size - emptyFlagCount, errors = super.lint(start, re);
+        if (variantFlags.size === knownFlagCount || validFlags.size === knownFlagCount) {
+            return errors;
+        }
+        const rect = new rect_1.BoundingRect(this, start);
+        for (const [i, child] of this.childNodes.entries()) {
+            const flag = child.text().trim();
+            if (flag
+                && !variantFlags.has(flag)
+                && !unknownFlags.has(flag)
+                && (variantFlags.size > 0 || !validFlags.has(flag))) {
+                const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', 'invalid conversion flag');
+                if (variantFlags.size === 0 && definedFlags.has(flag.toUpperCase())) {
+                    e.fix = { range: [e.startIndex, e.endIndex], text: flag.toUpperCase() };
+                }
+                else {
+                    e.suggestions = [
+                        {
+                            desc: 'remove',
+                            range: [e.startIndex - (i && 1), e.endIndex],
+                            text: '',
+                        },
+                    ];
+                }
+                errors.push(e);
+            }
+        }
+        return errors;
+    }
+    /** @private */
+    print() {
+        return super.print({ sep: ';' });
+    }
+    /* NOT FOR BROWSER */
+    cloneNode() {
+        const cloned = this.cloneChildNodes();
+        return debug_1.Shadow.run(() => {
+            // @ts-expect-error abstract class
+            const token = new ConverterFlagsToken([], this.getAttribute('config'));
+            token.append(...cloned);
+            return token;
+        });
+    }
+    /**
+     * @override
+     * @param i 移除位置
+     */
+    removeAt(i) {
+        const token = super.removeAt(i);
+        this.#flags?.splice(i, 1);
+        return token;
+    }
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     */
+    insertAt(token, i = this.length) {
+        super.insertAt(token, i);
+        this.#flags?.splice(i, 0, token.text().trim());
+        return token;
+    }
+    /** 获取所有转换类型标记 */
+    getAllFlags() {
+        return new Set(this.#flags);
+    }
+    /**
+     * 获取转换类型标记节点
+     * @param flag 转换类型标记
+     */
+    getFlagTokens(flag) {
+        return this.#flags.includes(flag) ? this.childNodes.filter(child => child.text().trim() === flag) : [];
+    }
+    /** 获取有效的转换类型标记 */
+    getEffectiveFlags() {
+        const variantFlags = this.getVariantFlags(), unknownFlags = this.getUnknownFlags();
+        const flags = new Set([...this.#flags.filter(flag => definedFlags.has(flag)), ...unknownFlags]);
+        if (flags.size === 0 && variantFlags.size === 0) {
+            return new Set('S');
+        }
+        else if (flags.has('R')) {
+            return new Set('R');
+        }
+        else if (flags.has('N')) {
+            return new Set('N');
+        }
+        else if (flags.has('-')) {
+            return new Set('-');
+        }
+        else if (flags.has('H')) {
+            const hasT = flags.has('T'), hasD = flags.has('D');
+            return hasT && hasD
+                ? new Set(['+', 'H', 'T', 'D'])
+                : new Set(['+', 'H', ...hasT ? ['T'] : [], ...hasD ? ['D'] : [], ...unknownFlags]);
+        }
+        else if (variantFlags.size > 0) {
+            return new Set([...variantFlags, ...unknownFlags]);
+        }
+        if (flags.size === 1 && flags.has('T')) {
+            flags.add('H');
+        }
+        if (flags.has('A')) {
+            flags.add('+');
+            flags.add('S');
+        }
+        if (flags.has('D')) {
+            flags.delete('S');
+        }
+        return flags;
+    }
+    /**
+     * 是否具有某转换类型标记
+     * @param flag 转换类型标记
+     */
+    hasFlag(flag) {
+        return this.#flags.includes(flag);
+    }
+    /**
+     * 是否具有某有效的转换类型标记
+     * @param flag 转换类型标记
+     */
+    hasEffectiveFlag(flag) {
+        return this.getEffectiveFlags().has(flag);
+    }
+    /**
+     * 移除某转换类型标记
+     * @param flag 转换类型标记
+     */
+    removeFlag(flag) {
+        for (const token of this.getFlagTokens(flag)) {
+            token.remove();
+        }
+    }
+    /**
+     * 添加转换类型标记
+     * @param flag 转换类型标记
+     */
+    #newFlag(flag) {
+        this.insertAt(debug_1.Shadow.run(() => new atom_1.AtomToken(flag, 'converter-flag', this.getAttribute('config'))));
+    }
+    /**
+     * 设置转换类型标记
+     * @param flag 转换类型标记
+     */
+    setFlag(flag) {
+        if (!this.#flags.includes(flag)) {
+            this.#newFlag(flag);
+        }
+    }
+    /**
+     * 开关转换类型标记
+     * @param flag 转换类型标记
+     */
+    toggleFlag(flag) {
+        if (this.#flags.includes(flag)) {
+            this.removeFlag(flag);
+        }
+        else {
+            this.#newFlag(flag);
+        }
+    }
+}
+exports.ConverterFlagsToken = ConverterFlagsToken;
+constants_1.classes['ConverterFlagsToken'] = __filename;

package/dist/src/converterRule.d.ts

@@ -0,0 +1,71 @@
+import Parser from '../index';
+import { Token } from './index';
+import { AtomToken } from './atom';
+import type { ConverterToken, ConverterFlagsToken } from '../internal';
+/**
+ * 转换规则
+ * @classdesc `{childNodes: ...AtomToken}`
+ */
+export declare abstract class ConverterRuleToken extends Token {
+    readonly childNodes: readonly [AtomToken] | readonly [AtomToken, AtomToken] | readonly [AtomToken, AtomToken, AtomToken];
+    abstract get firstChild(): AtomToken;
+    abstract get lastChild(): AtomToken;
+    abstract get parentNode(): ConverterToken | undefined;
+    abstract get previousSibling(): ConverterFlagsToken | this;
+    abstract get nextSibling(): this | undefined;
+    abstract get children(): [AtomToken] | [AtomToken, AtomToken] | [AtomToken, AtomToken, AtomToken];
+    abstract get firstElementChild(): AtomToken;
+    abstract get lastElementChild(): AtomToken;
+    abstract get parentElement(): ConverterToken | undefined;
+    abstract get previousElementSibling(): ConverterFlagsToken | this;
+    abstract get nextElementSibling(): this | undefined;
+    get type(): 'converter-rule';
+    /** 语言变体 */
+    get variant(): string;
+    set variant(variant: string);
+    /** 是否是单向转换 */
+    get unidirectional(): boolean;
+    /** @throws `Error` 不能用于将双向转换或不转换更改为单向转换 */
+    set unidirectional(flag: boolean);
+    /** 是否是双向转换 */
+    get bidirectional(): boolean;
+    /** @throws `Error` 不能用于将双向转换更改为单向转换或将不转换更改为双向转换 */
+    set bidirectional(flag: boolean);
+    /**
+     * @param rule 转换规则
+     * @param hasColon 是否带有":"
+     */
+    constructor(rule: string, hasColon?: boolean, config?: Parser.Config, accum?: Token[]);
+    cloneNode(): this;
+    /**
+     * @override
+     * @param i 移除位置
+     */
+    removeAt(i: number): AtomToken;
+    insertAt(): never;
+    /** 修改为不转换 */
+    noConvert(): void;
+    /**
+     * 设置转换目标
+     * @param to 转换目标
+     */
+    setTo(to: string): void;
+    /**
+     * 设置语言变体
+     * @param variant 语言变体
+     */
+    setVariant(variant: string): void;
+    /**
+     * 设置转换原文
+     * @param from 转换原文
+     * @throws `Error` 尚未指定语言变体
+     */
+    setFrom(from: string): void;
+    /**
+     * 修改为单向转换
+     * @param from 转换原文
+     */
+    makeUnidirectional(from: string): void;
+    /** 修改为双向转换 */
+    makeBidirectional(): void;
+}

package/dist/src/converterRule.js

@@ -0,0 +1,218 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConverterRuleToken = void 0;
+const index_1 = require("../index");
+const index_2 = require("./index");
+const atom_1 = require("./atom");
+/* NOT FOR BROWSER */
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+const html_1 = require("../util/html");
+/* NOT FOR BROWSER END */
+/**
+ * 转换规则
+ * @classdesc `{childNodes: ...AtomToken}`
+ */
+class ConverterRuleToken extends index_2.Token {
+    /* NOT FOR BROWSER END */
+    get type() {
+        return 'converter-rule';
+    }
+    /* NOT FOR BROWSER */
+    /** 语言变体 */
+    get variant() {
+        return this.childNodes[this.length - 2]?.text().trim() ?? '';
+    }
+    set variant(variant) {
+        this.setVariant(variant);
+    }
+    /** 是否是单向转换 */
+    get unidirectional() {
+        return this.length === 3;
+    }
+    /** @throws `Error` 不能用于将双向转换或不转换更改为单向转换 */
+    set unidirectional(flag) {
+        const { length } = this;
+        if (length === 3 && !flag) {
+            this.makeBidirectional();
+        }
+        else if (length === 2 && flag) {
+            throw new Error('If you want to change to unidirectional, please use ConverterRuleToken.makeUnidirectional method!');
+        }
+        else if (length === 1 && flag) {
+            throw new Error('If you want to change to unidirectional, '
+                + 'please use ConverterRuleToken.setVariant method to specify the language variant first!');
+        }
+    }
+    /** 是否是双向转换 */
+    get bidirectional() {
+        return this.length === 2;
+    }
+    /** @throws `Error` 不能用于将双向转换更改为单向转换或将不转换更改为双向转换 */
+    set bidirectional(flag) {
+        const { length } = this;
+        if (length === 3 && flag) {
+            this.makeBidirectional();
+        }
+        else if (length === 2 && !flag) {
+            throw new Error('If you want to change to unidirectional, please use ConverterRuleToken.makeUnidirectional method!');
+        }
+        else if (length === 1 && flag) {
+            throw new Error('If you want to change to bidirectional, please use ConverterRuleToken.setVariant method!');
+        }
+    }
+    /* NOT FOR BROWSER END */
+    /**
+     * @param rule 转换规则
+     * @param hasColon 是否带有":"
+     */
+    constructor(rule, hasColon = true, config = index_1.default.getConfig(), accum = []) {
+        super(undefined, config, accum);
+        const i = rule.indexOf(':'), j = rule.slice(0, i).indexOf('=>'), v = j === -1 ? rule.slice(0, i) : rule.slice(j + 2, i);
+        if (hasColon && config.variants.includes(v.trim())) {
+            super.insertAt(new atom_1.AtomToken(v, 'converter-rule-variant', config, accum));
+            super.insertAt(new atom_1.AtomToken(rule.slice(i + 1), 'converter-rule-to', config, accum));
+            if (j !== -1) {
+                super.insertAt(new atom_1.AtomToken(rule.slice(0, j), 'converter-rule-from', config, accum), 0);
+            }
+        }
+        else {
+            super.insertAt(new atom_1.AtomToken(rule, 'converter-rule-to', config, accum));
+        }
+        /* NOT FOR BROWSER */
+        this.protectChildren('1:');
+    }
+    /** @private */
+    toString(skip) {
+        const { childNodes, firstChild, lastChild } = this;
+        return childNodes.length === 3
+            ? `${firstChild.toString(skip)}=>${childNodes[1].toString(skip)}:${lastChild.toString(skip)}`
+            : super.toString(skip, ':');
+    }
+    /** @private */
+    text() {
+        const { childNodes, firstChild, lastChild } = this;
+        return childNodes.length === 3
+            ? `${firstChild.text()}=>${childNodes[1].text()}:${lastChild.text()}`
+            : super.text(':');
+    }
+    /** @private */
+    getGaps(i) {
+        return i === 0 && this.length === 3 ? 2 : 1;
+    }
+    /** @private */
+    print() {
+        const { childNodes } = this;
+        if (childNodes.length === 3) {
+            const [from, variant, to] = childNodes;
+            return `<span class="wpb-converter-rule">${from.print()}=>${variant.print()}:${to.print()}</span>`;
+        }
+        return super.print({ sep: ':' });
+    }
+    /* NOT FOR BROWSER */
+    cloneNode() {
+        const cloned = this.cloneChildNodes(), placeholders = ['', 'zh:', '=>zh:'], placeholder = placeholders[cloned.length - 1];
+        return debug_1.Shadow.run(() => {
+            // @ts-expect-error abstract class
+            const token = new ConverterRuleToken(placeholder, Boolean(placeholder), this.getAttribute('config'));
+            for (let i = 0; i < cloned.length; i++) {
+                token.childNodes[i].safeReplaceWith(cloned[i]);
+            }
+            return token;
+        });
+    }
+    /** @private */
+    afterBuild() {
+        super.afterBuild();
+        const /** @implements */ converterRuleListener = (e, data) => {
+            const { prevTarget } = e;
+            if (this.length > 1 && this.childNodes[this.length - 2] === prevTarget) {
+                const { variant } = this;
+                if (!this.getAttribute('config').variants.includes(variant)) {
+                    (0, debug_1.undo)(e, data);
+                    throw new Error(`Invalid language variant: ${variant}`);
+                }
+            }
+        };
+        this.addEventListener(['remove', 'insert', 'text', 'replace'], converterRuleListener);
+    }
+    /**
+     * @override
+     * @param i 移除位置
+     */
+    removeAt(i) {
+        if (this.length === 1) {
+            this.constructorError('needs at least 1 child node');
+        }
+        return super.removeAt(i);
+    }
+    insertAt() {
+        this.constructorError('has complex syntax. Do not try to insert child nodes manually');
+    }
+    /** 修改为不转换 */
+    noConvert() {
+        const { length } = this;
+        for (let i = 0; i < length - 1; i++) { // ConverterRuleToken只能从前往后删除子节点
+            this.removeAt(0);
+        }
+    }
+    /**
+     * 设置转换目标
+     * @param to 转换目标
+     */
+    setTo(to) {
+        const { childNodes } = index_1.default.parse(to, this.getAttribute('include'), undefined, this.getAttribute('config'));
+        this.lastChild.replaceChildren(...childNodes);
+    }
+    /**
+     * 设置语言变体
+     * @param variant 语言变体
+     */
+    setVariant(variant) {
+        const config = this.getAttribute('config');
+        if (this.length === 1) {
+            super.insertAt(debug_1.Shadow.run(() => new atom_1.AtomToken(variant, 'converter-rule-variant', config)), 0);
+        }
+        else {
+            this.childNodes[this.length - 2].setText(variant);
+        }
+    }
+    /**
+     * 设置转换原文
+     * @param from 转换原文
+     * @throws `Error` 尚未指定语言变体
+     */
+    setFrom(from) {
+        const { variant, unidirectional } = this;
+        if (!variant) {
+            throw new Error('Please specify the language variant first!');
+        }
+        const config = this.getAttribute('config'), { childNodes } = index_1.default.parse(from, this.getAttribute('include'), undefined, config);
+        if (!unidirectional) {
+            super.insertAt(debug_1.Shadow.run(() => new atom_1.AtomToken(undefined, 'converter-rule-from', config)), 0);
+        }
+        this.firstChild.replaceChildren(...childNodes);
+    }
+    /**
+     * 修改为单向转换
+     * @param from 转换原文
+     */
+    makeUnidirectional(from) {
+        this.setFrom(from);
+    }
+    /** 修改为双向转换 */
+    makeBidirectional() {
+        if (this.unidirectional) {
+            this.removeAt(0);
+        }
+    }
+    /** @private */
+    toHtmlInternal(nowrap, nocc) {
+        const { childNodes, firstChild, lastChild } = this;
+        return childNodes.length === 3
+            ? `${firstChild.toHtmlInternal(nowrap, nocc)}=>${childNodes[1].text()}:${lastChild.toHtmlInternal(nowrap, nocc)}`
+            : (0, html_1.html)(childNodes, ':', nowrap, nocc);
+    }
+}
+exports.ConverterRuleToken = ConverterRuleToken;
+constants_1.classes['ConverterRuleToken'] = __filename;

package/dist/src/extLink.d.ts

@@ -0,0 +1,36 @@
+import Parser from '../index';
+import { Token } from './index';
+import { MagicLinkToken } from './magicLink';
+import type { LintError } from '../base';
+import type { MagicLinkParentBase } from '../mixin/magicLinkParent';
+export interface ExtLinkToken extends MagicLinkParentBase {
+}
+/**
+ * 外链
+ * @classdesc `{childNodes: [MagicLinkToken, ?Token]}`
+ */
+export declare abstract class ExtLinkToken extends Token {
+    #private;
+    readonly childNodes: readonly [MagicLinkToken] | readonly [MagicLinkToken, Token];
+    abstract get firstChild(): MagicLinkToken;
+    abstract get lastChild(): Token;
+    abstract get children(): [MagicLinkToken] | [MagicLinkToken, Token];
+    abstract get firstElementChild(): MagicLinkToken;
+    abstract get lastElementChild(): Token;
+    get type(): 'ext-link';
+    /** 链接显示文字 */
+    get innerText(): string;
+    set innerText(text: string);
+    /**
+     * @param url 网址
+     * @param space 空白字符
+     * @param text 链接文字
+     */
+    constructor(url?: string, space?: string, text?: string, config?: Parser.Config, accum?: Token[]);
+    cloneNode(): this;
+    /**
+     * 设置链接显示文字
+     * @param str 链接显示文字
+     */
+    setLinkText(str: string): void;
+}