wikiparser-node 1.9.2-b → 1.9.2

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,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributesParent = void 0;
+const debug_1 = require("../util/debug");
+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;
+        }
+        set classList(classList) {
+            this.#attributesChild.classList = 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,41 @@
+import type { ConverterFlagsToken } from '../src/converterFlags';
+export interface FlagsParentBase {
+    /** 所有转换类型标记 */
+    flags: Set<string>;
+    /** 获取所有转换类型标记 */
+    getAllFlags(): Set<string>;
+    /** 获取有效的转换类型标记 */
+    getEffectiveFlags(): Set<string>;
+    /** 获取未知的转换类型标记 */
+    getUnknownFlags(): 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,60 @@
+"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 */
+        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,6 @@
+/**
+ * 解析后不可见的类
+ * @param linter 是否覆写 lint 方法
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/hidden.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hiddenToken = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/**
+ * 解析后不可见的类
+ * @param linter 是否覆写 lint 方法
+ * @param constructor 基类
+ * @param _ context
+ */
+const hiddenToken = (linter) => (constructor, _) => {
+    /** 解析后不可见的类 */
+    class AnyHiddenToken extends constructor {
+        /** 没有可见部分 */
+        text() {
+            return '';
+        }
+        /** @private */
+        lint(start) {
+            // @ts-expect-error private argument
+            return linter ? [] : super.lint(start);
+        }
+    }
+    (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,27 @@
+"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 {
+        /** @private */
+        toString() {
+            return super.toString().replace(/\n/gu, ' ');
+        }
+        /** @private */
+        text() {
+            return super.text().replace(/\n/gu, ' ');
+        }
+    }
+    (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,5 @@
+/**
+ * 只能位于行首的类
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/sol.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sol = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/**
+ * 只能位于行首的类
+ * @param constructor 基类
+ * @param _ context
+ */
+const sol = (constructor, _) => {
+    /** 只能位于行首的类 */
+    class SolToken extends constructor {
+        /** @implements */
+        #prependNewLine() {
+            const { previousVisibleSibling, parentNode, type } = this;
+            if (previousVisibleSibling) {
+                return previousVisibleSibling.toString().endsWith('\n') ? '' : '\n';
+            }
+            return parentNode?.type === 'root'
+                || type !== 'heading' && parentNode?.type === 'ext-inner' && parentNode.name === 'poem'
+                ? ''
+                : '\n';
+        }
+        /** @private */
+        toString() {
+            return this.#prependNewLine() + super.toString();
+        }
+        /** @private */
+        getAttribute(key) {
+            return key === 'padding'
+                ? this.#prependNewLine().length + super.getAttribute('padding')
+                : super.getAttribute(key);
+        }
+        /** @private */
+        text() {
+            return this.#prependNewLine() + super.text();
+        }
+    }
+    (0, debug_1.mixin)(SolToken, constructor);
+    return SolToken;
+};
+exports.sol = sol;
+constants_1.mixins['sol'] = __filename;

package/dist/mixin/syntax.d.ts

@@ -0,0 +1,8 @@
+export interface SyntaxBase {
+}
+/**
+ * 满足特定语法格式的Token
+ * @param pattern 语法正则
+ * @param constructor 基类
+ * @param _ context
+ */

package/dist/mixin/syntax.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.syntax = void 0;
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+const string_1 = require("../util/string");
+/**
+ * 满足特定语法格式的Token
+ * @param pattern 语法正则
+ * @param constructor 基类
+ * @param _ context
+ */
+const syntax = (pattern) => (constructor, _) => {
+    /** 满足特定语法格式的Token */
+    class SyntaxToken extends constructor {
+        /** @class */
+        constructor(...args) {
+            super(...args); // eslint-disable-line @typescript-eslint/no-unsafe-argument
+            if (pattern) {
+                this.pattern = pattern;
+            }
+            this.seal('pattern', true);
+        }
+        /** @private */
+        afterBuild() {
+            const /** @implements */ syntaxListener = (e, data) => {
+                if (!debug_1.Shadow.running && !this.pattern.test(this.text())) {
+                    (0, debug_1.undo)(e, data);
+                    this.constructorError('cannot modify the syntax pattern');
+                }
+            };
+            this.addEventListener(['remove', 'insert', 'replace', 'text'], syntaxListener);
+        }
+        /** @private */
+        replaceChildren(...elements) {
+            if (debug_1.Shadow.running || this.pattern.test((0, string_1.text)(elements))) {
+                debug_1.Shadow.run(() => {
+                    super.replaceChildren(...elements);
+                });
+            }
+        }
+    }
+    (0, debug_1.mixin)(SyntaxToken, constructor);
+    return SyntaxToken;
+};
+exports.syntax = syntax;
+constants_1.mixins['syntax'] = __filename;

package/dist/parser/braces.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseBraces = void 0;
+const string_1 = require("../util/string");
+const constants_1 = require("../util/constants");
+const heading_1 = require("../src/heading");
+const transclude_1 = require("../src/transclude");
+const arg_1 = require("../src/arg");
+// eslint-disable-next-line @typescript-eslint/no-unused-expressions
+/\{\{\s*([!=]|!!|\(!|!\)|!-)\s*\}\}(?!\})/gu;
+const closes = {
+    '=': '\n',
+    '{': String.raw `\}{2,}|\|`,
+    '-': String.raw `\}-`,
+    '[': String.raw `\]\]`,
+}, marks = new Map([['!', '!'], ['!!', '+'], ['(!', '{'], ['!)', '}'], ['!-', '-'], ['=', '~']]), re = new RegExp(String.raw `\{\{\s*(${[...marks.keys()].map(string_1.escapeRegExp).join('|')})\s*\}\}(?!\})`, 'gu');
+/**
+ * 解析花括号
+ * @param wikitext
+ * @param config
+ * @param accum
+ * @throws TranscludeToken.constructor()
+ */
+const parseBraces = (wikitext, config, accum) => {
+    const source = String.raw `${config.excludes?.includes('heading') ? '' : String.raw `^(\0\d+c\x7F)*={1,6}|`}\[\[|-\{(?!\{)`, openBraces = String.raw `|\{{2,}`, { parserFunction: [, , , subst] } = config, stack = [];
+    wikitext = wikitext.replace(re, (m, p1) => {
+        // @ts-expect-error abstract class
+        new transclude_1.TranscludeToken(m.slice(2, -2), [], config, accum);
+        return `\0${accum.length - 2}${marks.get(p1)}\x7F`;
+    });
+    const lastBraces = wikitext.lastIndexOf('}}') - wikitext.length;
+    // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+    /^(\0\d+c\x7F)*={1,6}|\[\[|-\{(?!\{)|\{{2,}|[\n|=]|\}{2,}|\}-|\]\]/gmu;
+    let moreBraces = lastBraces + wikitext.length !== -1, regex = new RegExp(source + (moreBraces ? openBraces : ''), 'gmu'), mt = regex.exec(wikitext), lastIndex;
+    while (mt
+        || lastIndex !== undefined && lastIndex <= wikitext.length && stack[stack.length - 1]?.[0]?.startsWith('=')) {
+        if (mt?.[1]) {
+            const [, { length }] = mt;
+            mt[0] = mt[0].slice(length);
+            mt.index += length;
+        }
+        const { 0: syntax, index: curIndex } = mt ?? { 0: '\n', index: wikitext.length }, top = stack.pop() ?? {}, { 0: open, index, parts, findEqual: topFindEqual, pos: topPos } = top, innerEqual = syntax === '=' && topFindEqual;
+        /**
+         * 填入模板内容
+         * @param text wikitext全文
+         */
+        const push = (text) => {
+            parts[parts.length - 1].push(text.slice(topPos, curIndex));
+        };
+        if (syntax === ']]' || syntax === '}-') { // 情形1：闭合内链或转换
+            lastIndex = curIndex + 2;
+        }
+        else if (syntax === '\n') { // 情形2：闭合标题或文末
+            lastIndex = curIndex + 1;
+            const { pos, findEqual } = stack[stack.length - 1] ?? {};
+            if (pos === undefined || findEqual || (0, string_1.removeComment)(wikitext.slice(pos, index)) !== '') {
+                const rmt = /^(={1,6})(.+)\1((?:\s|\0\d+c\x7F)*)$/u
+                    .exec(wikitext.slice(index, curIndex));
+                if (rmt) {
+                    wikitext = `${wikitext.slice(0, index)}\0${accum.length}h\x7F${wikitext.slice(curIndex)}`;
+                    lastIndex = index + 4 + String(accum.length).length;
+                    // @ts-expect-error abstract class
+                    new heading_1.HeadingToken(rmt[1].length, rmt.slice(2), config, accum);
+                }
+            }
+        }
+        else if (syntax === '|' || innerEqual) { // 情形3：模板内部，含行首单个'='
+            lastIndex = curIndex + 1;
+            push(wikitext);
+            if (syntax === '|') {
+                parts.push([]);
+            }
+            top.pos = lastIndex;
+            top.findEqual = syntax === '|';
+            stack.push(top);
+        }
+        else if (syntax.startsWith('}}')) { // 情形4：闭合模板
+            const close = syntax.slice(0, Math.min(open.length, 3)), rest = open.length - close.length, { length } = accum;
+            lastIndex = curIndex + close.length; // 这不是最终的lastIndex
+            push(wikitext);
+            let skip = false, ch = 't';
+            if (close.length === 3) {
+                const argParts = parts.map(part => part.join('=')), str = argParts.length > 1 && (0, string_1.removeComment)(argParts[1]).trim();
+                // @ts-expect-error abstract class
+                new arg_1.ArgToken(argParts, config, accum);
+                if (str && str.endsWith(':') && subst.includes(str.slice(0, -1).toLowerCase())) {
+                    ch = 's';
+                }
+            }
+            else {
+                try {
+                    // @ts-expect-error abstract class
+                    new transclude_1.TranscludeToken(parts[0][0], parts.slice(1), config, accum);
+                    const name = (0, string_1.removeComment)(parts[0][0]).trim();
+                    if (marks.has(name)) {
+                        ch = marks.get(name); // 标记{{!}}等
+                    }
+                    else if (/^(?:filepath|(?:full|canonical)urle?):.|^server$/iu.test(name)) {
+                        ch = 'm';
+                    }
+                    else if (/^#vardefine:./iu.test(name)) {
+                        ch = 'c';
+                    }
+                }
+                catch (e) {
+                    if (e instanceof SyntaxError && e.message === 'Invalid template name') {
+                        skip = true;
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            }
+            if (!skip) {
+                wikitext = `${wikitext.slice(0, index + rest)}\0${length}${ch}\x7F${wikitext.slice(lastIndex)}`;
+                lastIndex = index + rest + 3 + String(length).length;
+                if (rest > 1) {
+                    stack.push({ 0: open.slice(0, rest), index: index, pos: index + rest, parts: [[]] });
+                }
+                else if (rest === 1 && wikitext[index - 1] === '-') {
+                    stack.push({ 0: '-{', index: index - 1, pos: index + 1, parts: [[]] });
+                }
+            }
+        }
+        else { // 情形5：开启
+            lastIndex = curIndex + syntax.length;
+            if (syntax.startsWith('{')) {
+                mt.pos = lastIndex;
+                mt.parts = [[]];
+            }
+            stack.push(...'0' in top ? [top] : [], mt);
+        }
+        let curTop = stack[stack.length - 1];
+        if (moreBraces && lastBraces + wikitext.length < lastIndex) {
+            moreBraces = false;
+            while (curTop?.[0]?.startsWith('{')) {
+                stack.pop();
+                curTop = stack[stack.length - 1];
+            }
+        }
+        regex = new RegExp(source
+            + (moreBraces ? openBraces : '')
+            + (curTop ? `|${closes[curTop[0][0]]}${curTop.findEqual ? '|=' : ''}` : ''), 'gmu');
+        regex.lastIndex = lastIndex;
+        mt = regex.exec(wikitext);
+    }
+    return wikitext;
+};
+exports.parseBraces = parseBraces;
+constants_1.parsers['parseBraces'] = __filename;