wikiparser-node 1.9.1-b → 1.9.1

package/dist/src/magicLink.js

@@ -0,0 +1,271 @@
+"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 rect_1 = require("../lib/rect");
+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");
+// eslint-disable-next-line @typescript-eslint/no-unused-expressions
+/(?:[\p{Zs}\t]|&nbsp;|&#0*160;|&#[xX]0*[aA]0;)+/gu;
+const space = String.raw `(?:[\p{Zs}\t]|&nbsp;|&#0*160;|&#[xX]0*[aA]0;)`, spaceRegex = new RegExp(`${space}+`, 'gu');
+/* eslint-disable @typescript-eslint/no-unused-expressions */
+/^(ISBN)[\p{Zs}\t]+(?:97[89][\p{Zs}\t-]?)?(?:\d[\p{Zs}\t-]?){9}[\dxX]$/u;
+/^(RFC|PMID)[\p{Zs}\t]+\d+$/u;
+/* eslint-enable @typescript-eslint/no-unused-expressions */
+const spdash = String.raw `(?:[\p{Zs}\t-]|&nbsp;|&#0*160;|&#[xX]0*[aA]0;)`, isbnPattern = new RegExp(String.raw `^(ISBN)${space}+(?:97[89]${spdash}?)?(?:\d${spdash}?){9}[\dxX]$`, 'u'), rfcPattern = new RegExp(String.raw `^(RFC|PMID)${space}+\d+$`, 'u');
+/** 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);
+        }
+        /* NOT FOR BROWSER END */
+        /** 和内链保持一致 */
+        get link() {
+            const map = { '!': '|', '=': '=' };
+            let link = (0, string_1.text)(this.childNodes.map(child => {
+                const { type, name } = child;
+                return type === 'magic-word' && String(name) in map ? map[name] : child;
+            }));
+            if (this.type === 'magic-link') {
+                link = link.replace(spaceRegex, ' ');
+                if (link.startsWith('ISBN')) {
+                    link = `ISBN ${link.slice(5).replace(/[- ]/gu, '').replace(/x$/u, 'X')}`;
+                }
+            }
+            return link;
+        }
+        /* NOT FOR BROWSER */
+        set link(url) {
+            this.setTarget(url);
+        }
+        /** 协议 */
+        get protocol() {
+            return this.pattern.exec(this.text())?.[1];
+        }
+        /** @throws `Error` 特殊外链无法更改协议n */
+        set protocol(value) {
+            const { link, pattern, type } = this;
+            if (type === 'magic-link' || !pattern.test(link)) {
+                throw new Error(`Special external link cannot change protocol: ${link}`);
+            }
+            this.setTarget(link.replace(pattern, value));
+        }
+        /* NOT FOR BROWSER END */
+        /**
+         * @param url 网址
+         * @param type 类型
+         */
+        constructor(url, type = 'free-ext-link', config = index_1.default.getConfig(), accum) {
+            super(url, config, accum, {
+                'Stage-1': '1:', '!ExtToken': '', AstText: ':', TranscludeToken: ':',
+            });
+            this.type = type;
+            /* NOT FOR BROWSER */
+            let pattern;
+            if (type === 'magic-link') {
+                pattern = url?.startsWith('ISBN') ? isbnPattern : rfcPattern;
+            }
+            else {
+                // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+                /^(ftp:\/\/|\/\/)/iu;
+                pattern = new RegExp(`^(${config.protocol}${type === 'ext-link-url' ? '|//' : ''})`, 'iu');
+            }
+            this.setAttribute('pattern', pattern);
+        }
+        /** @private */
+        lint(start = this.getAbsoluteIndex(), re) {
+            const errors = super.lint(start, re), rect = new rect_1.BoundingRect(this, start);
+            if (this.type === 'magic-link') {
+                const { link } = this;
+                if (link.startsWith('ISBN')) {
+                    // eslint-disable-next-line unicorn/no-useless-spread
+                    const digits = [...link.slice(5)].map(s => s === 'X' ? 10 : Number(s));
+                    if (digits.length === 10 && digits.reduce((sum, d, i) => sum + d * (10 - i), 0) % 11
+                        || digits.length === 13 && (digits[12] === 10
+                            || digits.reduce((sum, d, i) => sum + d * (i % 2 ? 3 : 1), 0) % 10)) {
+                        errors.push((0, lint_1.generateForSelf)(this, rect, 'invalid-isbn', 'invalid ISBN'));
+                    }
+                }
+                return errors;
+            }
+            // eslint-disable-next-line @typescript-eslint/no-unused-expressions
+            /[，；。：！？（）]+|\|+/gu;
+            const source = `[，；。：！？（）]+${this.type === 'ext-link-url' ? String.raw `|\|+` : ''}`, regex = new RegExp(source, 'u'), regexGlobal = new RegExp(source, 'gu');
+            for (const child of this.childNodes) {
+                const { type, data } = child;
+                if (type !== 'text' || !regex.test(data)) {
+                    continue;
+                }
+                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, 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('cannot insert a template');
+                }
+                else if (!debug_1.Shadow.running && type === 'magic-word' && name !== '!' && name !== '=') {
+                    this.constructorError('cannot insert magic words other than "{{!}}" or "{{=}}"');
+                }
+            }
+            return super.insertAt(token, i);
+        }
+        /**
+         * 获取网址
+         * @throws `Error` ISBN
+         * @throws `Error` 非标准协议
+         */
+        getUrl() {
+            const { type, protocol } = this;
+            let { link } = this;
+            if (type === 'magic-link') {
+                if (protocol === 'ISBN') {
+                    throw new Error(`MagicLinkToken.getUrl method does not support ISBN links: ${link}`);
+                }
+                link = protocol === 'RFC'
+                    ? `https://tools.ietf.org/html/rfc${link.slice(4)}`
+                    : `https://pubmed.ncbi.nlm.nih.gov/${link.slice(5)}`;
+            }
+            else if (protocol === '//') {
+                link = `https:${link}`;
+            }
+            try {
+                return new URL(link);
+            }
+            catch (e) {
+                if (e instanceof TypeError && e.message === 'Invalid URL') {
+                    throw new Error(`External link with a non-standard protocol: ${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;

package/dist/src/nested.d.ts

@@ -0,0 +1,41 @@
+import Parser from '../index';
+import { Token } from './index';
+import { ExtToken } from './tagPair/ext';
+import { NoincludeToken } from './nowiki/noinclude';
+import { CommentToken } from './nowiki/comment';
+import type { LintError } from '../base';
+import type { AttributesToken } from './attributes';
+/**
+ * 嵌套式的扩展标签
+ * @classdesc `{childNodes: ...ExtToken|NoincludeToken|CommentToken}`
+ */
+export declare abstract class NestedToken extends Token {
+    #private;
+    readonly type = "ext-inner";
+    readonly name: string;
+    readonly childNodes: readonly (ExtToken | NoincludeToken | CommentToken)[];
+    abstract get firstChild(): ExtToken | NoincludeToken | CommentToken | undefined;
+    abstract get lastChild(): ExtToken | NoincludeToken | CommentToken | undefined;
+    abstract get nextSibling(): undefined;
+    abstract get previousSibling(): AttributesToken;
+    abstract get parentNode(): ExtToken | undefined;
+    abstract get children(): (ExtToken | NoincludeToken | CommentToken)[];
+    abstract get firstElementChild(): ExtToken | NoincludeToken | CommentToken | undefined;
+    abstract get lastElementChild(): ExtToken | NoincludeToken | CommentToken | undefined;
+    abstract get previousElementSibling(): AttributesToken;
+    abstract get nextElementSibling(): undefined;
+    abstract get parentElement(): ExtToken | undefined;
+    /**
+     * @param regex 内层正则
+     * @param tags 内层标签名
+     */
+    constructor(wikitext: string | undefined, regex: RegExp, tags: readonly string[], config?: Parser.Config, accum?: Token[]);
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     */
+    insertAt<T extends Token>(token: T, i?: number): T;
+    /** @override */
+    cloneNode(): this;
+}

package/dist/src/nested.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NestedToken = void 0;
+const lint_1 = require("../util/lint");
+const rect_1 = require("../lib/rect");
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+const index_1 = require("../index");
+const index_2 = require("./index");
+const ext_1 = require("./tagPair/ext");
+const noinclude_1 = require("./nowiki/noinclude");
+const comment_1 = require("./nowiki/comment");
+/**
+ * 嵌套式的扩展标签
+ * @classdesc `{childNodes: ...ExtToken|NoincludeToken|CommentToken}`
+ */
+class NestedToken extends index_2.Token {
+    type = 'ext-inner';
+    /* NOT FOR BROWSER */
+    #tags;
+    #regex;
+    /* NOT FOR BROWSER END */
+    /**
+     * @param regex 内层正则
+     * @param tags 内层标签名
+     */
+    constructor(wikitext, regex, tags, config = index_1.default.getConfig(), accum = []) {
+        wikitext = wikitext?.replace(regex, (comment, name, attr, inner, closing) => {
+            const str = `\0${accum.length + 1}${name ? 'e' : 'c'}\x7F`;
+            if (name) {
+                // @ts-expect-error abstract class
+                new ext_1.ExtToken(name, attr, inner, closing, config, accum);
+            }
+            else {
+                const closed = comment.endsWith('-->');
+                // @ts-expect-error abstract class
+                new comment_1.CommentToken(comment.slice(4, closed ? -3 : undefined), closed, config, accum);
+            }
+            return str;
+        }).replace(/(^|\0\d+[ce]\x7F)([^\0]+)(?=$|\0\d+[ce]\x7F)/gu, (_, lead, substr) => {
+            // @ts-expect-error abstract class
+            new noinclude_1.NoincludeToken(substr, config, accum);
+            return `${lead}\0${accum.length}c\x7F`;
+        });
+        super(wikitext, config, accum, {
+            NoincludeToken: ':', ExtToken: ':',
+        });
+        /* NOT FOR BROWSER */
+        this.#tags = [...tags];
+        this.#regex = regex;
+    }
+    /** @private */
+    lint(start = this.getAbsoluteIndex(), re) {
+        const rect = new rect_1.BoundingRect(this, start);
+        return [
+            ...super.lint(start, re),
+            ...this.childNodes.filter(child => {
+                if (child.type === 'ext' || child.type === 'comment') {
+                    return false;
+                }
+                const str = child.toString().trim();
+                return str && !/^<!--.*-->$/su.test(str);
+            }).map(child => {
+                const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', index_1.default.msg('invalid content in <$1>', this.name));
+                e.suggestions = [
+                    {
+                        desc: 'remove',
+                        range: [e.startIndex, e.endIndex],
+                        text: '',
+                    },
+                    {
+                        desc: 'comment',
+                        range: [e.startIndex, e.startIndex],
+                        text: `<!--${child.toString()}-->`,
+                    },
+                ];
+                return e;
+            }),
+        ];
+    }
+    /* NOT FOR BROWSER */
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     */
+    insertAt(token, i) {
+        if (typeof token !== 'string' && token.type === 'ext' && !this.#tags.includes(token.name)) {
+            this.constructorError(`can only have ${this.#tags.join(' or ')} tags as child nodes`);
+        }
+        return super.insertAt(token, i);
+    }
+    /** @override */
+    cloneNode() {
+        const cloned = this.cloneChildNodes(), config = this.getAttribute('config');
+        return debug_1.Shadow.run(() => {
+            // @ts-expect-error abstract class
+            const token = new NestedToken(undefined, this.#regex, this.#tags, config);
+            token.append(...cloned);
+            return token;
+        });
+    }
+}
+exports.NestedToken = NestedToken;
+constants_1.classes['NestedToken'] = __filename;

package/dist/src/nowiki/base.d.ts

@@ -0,0 +1,31 @@
+import { Token } from '../index';
+import type { Config } from '../../base';
+import type { AstText } from '../../lib/text';
+declare type NowikiTypes = 'ext-inner' | 'comment' | 'dd' | 'double-underscore' | 'hr' | 'list' | 'noinclude' | 'quote';
+/**
+ * 纯文字Token，不会被解析
+ * @classdesc `{childNodes: [AstText]}`
+ */
+export declare abstract class NowikiBaseToken extends Token {
+    type: NowikiTypes;
+    readonly childNodes: readonly [AstText];
+    abstract get firstChild(): AstText;
+    abstract get lastChild(): AstText;
+    abstract get children(): [];
+    abstract get firstElementChild(): undefined;
+    abstract get lastElementChild(): undefined;
+    /** 纯文本部分 */
+    get innerText(): string;
+    /** @param wikitext default: `''` */
+    constructor(wikitext?: string, config?: Config, accum?: Token[]);
+    /** @override */
+    cloneNode(this: this & {
+        constructor: new (...args: any[]) => unknown;
+    }): this;
+    /**
+     * @override
+     * @param str 新文本
+     */
+    setText(str: string): string;
+}
+export {};

package/dist/src/nowiki/base.js

@@ -0,0 +1,92 @@
+"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.NowikiBaseToken = void 0;
+const debug_1 = require("../../util/debug");
+const constants_1 = require("../../util/constants");
+const fixed_1 = require("../../mixin/fixed");
+const index_1 = require("../index");
+/**
+ * 纯文字Token，不会被解析
+ * @classdesc `{childNodes: [AstText]}`
+ */
+let NowikiBaseToken = (() => {
+    let _classDecorators = [fixed_1.fixedToken];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = index_1.Token;
+    var NowikiBaseToken = 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);
+            NowikiBaseToken = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /* NOT FOR BROWSER END */
+        /** 纯文本部分 */
+        get innerText() {
+            return this.firstChild.data;
+        }
+        /** @param wikitext default: `''` */
+        constructor(wikitext = '', config, accum) {
+            super(wikitext, config, accum);
+        }
+        /* NOT FOR BROWSER */
+        /** @override */
+        cloneNode() {
+            const { constructor, firstChild: { data }, type } = this;
+            return debug_1.Shadow.run(() => {
+                const token = new constructor(data, this.getAttribute('config'));
+                token.type = type;
+                token.afterBuild();
+                return token;
+            });
+        }
+        /**
+         * @override
+         * @param str 新文本
+         */
+        setText(str) {
+            return super.setText(str, 0);
+        }
+    };
+    return NowikiBaseToken = _classThis;
+})();
+exports.NowikiBaseToken = NowikiBaseToken;
+constants_1.classes['NowikiBaseToken'] = __filename;

package/dist/src/nowiki/comment.d.ts

@@ -0,0 +1,15 @@
+import { NowikiBaseToken } from './base';
+import type { LintError, Config } from '../../base';
+import type { Token } from '../index';
+/** HTML注释，不可见 */
+export declare abstract class CommentToken extends NowikiBaseToken {
+    readonly type = "comment";
+    closed: boolean;
+    /** 内部文本 */
+    get innerText(): string;
+    set innerText(text: string);
+    /** @param closed 是否闭合 */
+    constructor(wikitext: string, closed?: boolean, config?: Config, accum?: Token[]);
+    /** @override */
+    cloneNode(): this;
+}