wikiparser-node 1.12.5-b → 1.12.6

package/dist/src/imagemap.d.ts

@@ -0,0 +1,47 @@
+import Parser from '../index';
+import { Token } from './index';
+import { NoincludeToken } from './nowiki/noinclude';
+import { GalleryImageToken } from './link/galleryImage';
+import { ImagemapLinkToken } from './imagemapLink';
+import type { LintError } from '../base';
+import type { AstText, AttributesToken, ExtToken, AstNodes } from '../internal';
+/**
+ * `<imagemap>`
+ * @classdesc `{childNodes: ...NoincludeToken, GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)}`
+ */
+export declare abstract class ImagemapToken extends Token {
+    readonly name: 'imagemap';
+    readonly childNodes: readonly (GalleryImageToken | NoincludeToken | ImagemapLinkToken | AstText)[];
+    abstract get firstChild(): NoincludeToken | GalleryImageToken | undefined;
+    abstract get lastChild(): GalleryImageToken | NoincludeToken | ImagemapLinkToken | AstText | undefined;
+    abstract get nextSibling(): undefined;
+    abstract get previousSibling(): AttributesToken;
+    abstract get parentNode(): ExtToken | undefined;
+    abstract get children(): (GalleryImageToken | NoincludeToken | ImagemapLinkToken)[];
+    abstract get firstElementChild(): NoincludeToken | GalleryImageToken | undefined;
+    abstract get lastElementChild(): GalleryImageToken | NoincludeToken | ImagemapLinkToken | undefined;
+    abstract get nextElementSibling(): undefined;
+    abstract get previousElementSibling(): AttributesToken;
+    abstract get parentElement(): ExtToken | undefined;
+    get type(): 'ext-inner';
+    /** 图片 */
+    get image(): GalleryImageToken | undefined;
+    /** @param inner 标签内部wikitext */
+    constructor(inner?: string, config?: Parser.Config, accum?: Token[]);
+    /**
+     * @override
+     * @param token 待插入的节点
+     * @param i 插入位置
+     * @throws `Error` 当前缺少合法图片
+     * @throws `RangeError` 已有一张合法图片
+     */
+    insertAt(token: string, i?: number): AstText;
+    insertAt<T extends AstNodes>(token: T, i?: number): T;
+    /**
+     * @override
+     * @param i 移除位置
+     * @throws `Error` 禁止移除图片
+     */
+    removeAt(i: number): AstNodes;
+    cloneNode(): this;
+}

package/dist/src/imagemap.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ImagemapToken = void 0;
+const lint_1 = require("../util/lint");
+const debug_1 = require("../util/debug");
+const rect_1 = require("../lib/rect");
+const index_1 = require("../index");
+const index_2 = require("./index");
+const noinclude_1 = require("./nowiki/noinclude");
+const galleryImage_1 = require("./link/galleryImage");
+const imagemapLink_1 = require("./imagemapLink");
+/* NOT FOR BROWSER */
+const constants_1 = require("../util/constants");
+const singleLine_1 = require("../mixin/singleLine");
+/* NOT FOR BROWSER END */
+/**
+ * `<imagemap>`
+ * @classdesc `{childNodes: ...NoincludeToken, GalleryImageToken, ...(NoincludeToken|ImagemapLinkToken|AstText)}`
+ */
+class ImagemapToken extends index_2.Token {
+    /* NOT FOR BROWSER END */
+    get type() {
+        return 'ext-inner';
+    }
+    /** 图片 */
+    get image() {
+        return this.childNodes.find((0, debug_1.isToken)('imagemap-image'));
+    }
+    /** @param inner 标签内部wikitext */
+    constructor(inner, config = index_1.default.getConfig(), accum = []) {
+        super(undefined, config, accum, {
+            GalleryImageToken: ':', ImagemapLinkToken: ':', NoincludeToken: ':', AstText: ':',
+        });
+        if (!inner) {
+            return;
+        }
+        const lines = inner.split('\n'), protocols = new Set(config.protocol.split('|')), SingleLineNoincludeToken = (0, singleLine_1.singleLine)(noinclude_1.NoincludeToken);
+        let first = true, error = false;
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (error || !trimmed || trimmed.startsWith('#')) {
+                //
+            }
+            else if (first) {
+                const [file, ...options] = line.split('|'), title = this.normalizeTitle(file, 0, true);
+                if (title.valid && !title.interwiki && title.ns === 6) {
+                    // @ts-expect-error abstract class
+                    const token = new galleryImage_1.GalleryImageToken('imagemap', file, options.length > 0 ? options.join('|') : undefined, config, accum);
+                    super.insertAt(token);
+                    first = false;
+                    continue;
+                }
+                else {
+                    error = true;
+                }
+            }
+            else if (line.trim().split(/[\t ]/u)[0] === 'desc') {
+                super.insertAt(line);
+                continue;
+            }
+            else if (line.includes('[')) {
+                const i = line.indexOf('['), substr = line.slice(i), mtIn = /^\[\[([^|]+)(?:\|([^\]]+))?\]\][\w\s]*$/u
+                    .exec(substr);
+                if (mtIn) {
+                    if (this.normalizeTitle(mtIn[1], 0, true, false, true).valid) {
+                        // @ts-expect-error abstract class
+                        super.insertAt(new imagemapLink_1.ImagemapLinkToken(line.slice(0, i), mtIn.slice(1), substr.slice(substr.indexOf(']]') + 2), config, accum));
+                        continue;
+                    }
+                }
+                else if (protocols.has(substr.slice(1, substr.indexOf(':') + 1))
+                    || protocols.has(substr.slice(1, substr.indexOf('//') + 2))) {
+                    const mtEx = /^\[([^\]\s]+)(?:(\s+(?!\s))([^\]]*))?\][\w\s]*$/u
+                        .exec(substr);
+                    if (mtEx) {
+                        // @ts-expect-error abstract class
+                        super.insertAt(new imagemapLink_1.ImagemapLinkToken(line.slice(0, i), mtEx.slice(1), substr.slice(substr.indexOf(']') + 1), config, accum));
+                        continue;
+                    }
+                }
+            }
+            // @ts-expect-error abstract class
+            super.insertAt(new SingleLineNoincludeToken(line, config, accum));
+        }
+    }
+    /** @private */
+    toString(skip) {
+        return super.toString(skip, '\n');
+    }
+    /** @private */
+    text() {
+        return super.text('\n').replace(/\n{2,}/gu, '\n');
+    }
+    /** @private */
+    getGaps() {
+        return 1;
+    }
+    /** @private */
+    lint(start = this.getAbsoluteIndex(), re) {
+        const errors = super.lint(start, re), rect = new rect_1.BoundingRect(this, start);
+        if (this.image) {
+            errors.push(...this.childNodes.filter(child => {
+                const str = child.toString().trim();
+                return child.type === 'noinclude' && str && !str.startsWith('#');
+            }).map(child => (0, lint_1.generateForChild)(child, rect, 'invalid-imagemap', 'invalid link in <imagemap>')));
+        }
+        else {
+            errors.push((0, lint_1.generateForSelf)(this, rect, 'invalid-imagemap', '<imagemap> without an image'));
+        }
+        return errors;
+    }
+    /** @private */
+    print() {
+        return super.print({ sep: '\n' });
+    }
+    insertAt(token, i) {
+        const { image } = this;
+        if (!image && (typeof token === 'string' || token.type === 'imagemap-link' || token.type === 'text')) {
+            throw new Error('Missing a valid image!');
+        }
+        else if (image && typeof token !== 'string' && token.type === 'imagemap-image') {
+            throw new RangeError('Already have a valid image!');
+        }
+        return super.insertAt(token, i);
+    }
+    /**
+     * @override
+     * @param i 移除位置
+     * @throws `Error` 禁止移除图片
+     */
+    removeAt(i) {
+        if (this.childNodes[i]?.type === 'imagemap-image') {
+            throw new Error('Do not remove the image in <imagemap>!');
+        }
+        return super.removeAt(i);
+    }
+    cloneNode() {
+        const cloned = this.cloneChildNodes();
+        return debug_1.Shadow.run(() => {
+            // @ts-expect-error abstract class
+            const token = new ImagemapToken(undefined, this.getAttribute('config'));
+            token.append(...cloned);
+            return token;
+        });
+    }
+}
+exports.ImagemapToken = ImagemapToken;
+constants_1.classes['ImagemapToken'] = __filename;

package/dist/src/imagemapLink.d.ts

@@ -0,0 +1,35 @@
+import Parser from '../index';
+import { Token } from './index';
+import { NoincludeToken } from './nowiki/noinclude';
+import { LinkToken } from './link/index';
+import { ExtLinkToken } from './extLink';
+import type { AstText, ImagemapToken, GalleryImageToken } from '../internal';
+import type { Title } from '../lib/title';
+/**
+ * `<imagemap>`内的链接
+ * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
+ */
+export declare abstract class ImagemapLinkToken extends Token {
+    readonly childNodes: readonly [AstText, LinkToken | ExtLinkToken, NoincludeToken];
+    abstract get firstChild(): AstText;
+    abstract get lastChild(): NoincludeToken;
+    abstract get parentNode(): ImagemapToken | undefined;
+    abstract get previousSibling(): GalleryImageToken | this | NoincludeToken | AstText;
+    abstract get nextSibling(): this | NoincludeToken | AstText | undefined;
+    abstract get children(): [LinkToken | ExtLinkToken, NoincludeToken];
+    abstract get firstElementChild(): LinkToken | ExtLinkToken;
+    abstract get lastElementChild(): NoincludeToken;
+    abstract get parentElement(): ImagemapToken | undefined;
+    abstract get previousElementSibling(): GalleryImageToken | this | NoincludeToken;
+    abstract get nextElementSibling(): this | NoincludeToken | undefined;
+    get type(): 'imagemap-link';
+    /** 内外链接 */
+    get link(): string | Title;
+    set link(link: string);
+    /**
+     * @param pre 链接前的文本
+     * @param linkStuff 内外链接
+     * @param post 链接后的文本
+     */
+    constructor(pre: string, linkStuff: readonly [string, string | undefined, string | undefined] | readonly [string, string | undefined], post: string, config?: Parser.Config, accum?: Token[]);
+}

package/dist/src/imagemapLink.js

@@ -0,0 +1,99 @@
+"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.ImagemapLinkToken = void 0;
+const index_1 = require("../index");
+const index_2 = require("./index");
+const noinclude_1 = require("./nowiki/noinclude");
+const index_3 = require("./link/index");
+const extLink_1 = require("./extLink");
+/* NOT FOR BROWSER */
+const constants_1 = require("../util/constants");
+const fixed_1 = require("../mixin/fixed");
+const singleLine_1 = require("../mixin/singleLine");
+/* NOT FOR BROWSER END */
+/**
+ * `<imagemap>`内的链接
+ * @classdesc `{childNodes: [AstText, LinkToken|ExtLinkToken, NoincludeToken]}`
+ */
+let ImagemapLinkToken = (() => {
+    let _classDecorators = [fixed_1.fixedToken, singleLine_1.singleLine];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = index_2.Token;
+    var ImagemapLinkToken = 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);
+            ImagemapLinkToken = _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 type() {
+            return 'imagemap-link';
+        }
+        /* NOT FOR BROWSER */
+        /** 内外链接 */
+        get link() {
+            return this.childNodes[1].link;
+        }
+        set link(link) {
+            this.childNodes[1].link = link;
+        }
+        /* NOT FOR BROWSER END */
+        /**
+         * @param pre 链接前的文本
+         * @param linkStuff 内外链接
+         * @param post 链接后的文本
+         */
+        constructor(pre, linkStuff, post, config = index_1.default.getConfig(), accum = []) {
+            super(undefined, config, accum);
+            this.append(pre, linkStuff.length === 2
+                // @ts-expect-error abstract class
+                ? new index_3.LinkToken(...linkStuff, config, accum)
+                // @ts-expect-error abstract class
+                : new extLink_1.ExtLinkToken(...linkStuff, config, accum), 
+            // @ts-expect-error abstract class
+            new noinclude_1.NoincludeToken(post, config, accum));
+        }
+    };
+    return ImagemapLinkToken = _classThis;
+})();
+exports.ImagemapLinkToken = ImagemapLinkToken;
+constants_1.classes['ImagemapLinkToken'] = __filename;

package/dist/src/index.d.ts

@@ -0,0 +1,136 @@
+import Parser from '../index';
+import { AstElement } from '../lib/element';
+import { AstText } from '../lib/text';
+import type { LintError, TokenTypes } from '../base';
+import type { Title } from '../lib/title';
+import type { AstNodes, IncludeToken, HtmlToken, ExtToken, TranscludeToken, CommentToken, FileToken, LinkToken, RedirectTargetToken, ExtLinkToken, MagicLinkToken, ImageParameterToken } from '../internal';
+import { Ranges } from '../lib/ranges';
+import { AstRange } from '../lib/range';
+import type { Range } from '../lib/ranges';
+import type { CaretPosition } from '../lib/node';
+export type TagToken = IncludeToken | ExtToken | HtmlToken;
+/**
+ * 所有节点的基类
+ * @classdesc `{childNodes: ...(AstText|Token)}`
+ */
+export declare class Token extends AstElement {
+    #private;
+    get type(): TokenTypes;
+    set type(value: TokenTypes);
+    /** 所有图片，包括图库 */
+    get images(): FileToken[];
+    /** 所有内链、外链和自由外链 */
+    get links(): (LinkToken | RedirectTargetToken | ExtLinkToken | MagicLinkToken | ImageParameterToken)[];
+    /** 所有模板和模块 */
+    get embeds(): TranscludeToken[];
+    /** @class */
+    constructor(wikitext?: string, config?: Parser.Config, accum?: Token[], acceptable?: Acceptable);
+    /**
+     * @override
+     * @param child 待插入的子节点
+     * @param i 插入位置
+     */
+    insertAt(child: string, i?: number): AstText;
+    insertAt<T extends AstNodes>(child: T, i?: number): T;
+    /**
+     * @override
+     * @param i 移除位置
+     */
+    removeAt(i: number): AstNodes;
+    /**
+     * 替换为同类节点
+     * @param token 待替换的节点
+     * @throws `Error` 不存在父节点
+     */
+    safeReplaceWith(token: this): void;
+    /**
+     * 创建HTML注释
+     * @param data 注释内容
+     */
+    createComment(data?: string): CommentToken;
+    /**
+     * 创建标签
+     * @param tagName 标签名
+     * @param options 选项
+     * @param options.selfClosing 是否自封闭
+     * @param options.closing 是否是闭合标签
+     * @throws `RangeError` 非法的标签名
+     */
+    createElement(tagName: string, options?: {
+        selfClosing?: boolean;
+        closing?: boolean;
+    }): TagToken;
+    /**
+     * 创建纯文本节点
+     * @param data 文本内容
+     */
+    createTextNode(data?: string): AstText;
+    /** 创建AstRange对象 */
+    createRange(): AstRange;
+    /**
+     * 找到给定位置
+     * @param index 位置
+     */
+    caretPositionFromIndex(index?: number): CaretPosition | undefined;
+    /**
+     * 找到给定位置
+     * @param x 列数
+     * @param y 行数
+     */
+    caretPositionFromPoint(x: number, y: number): CaretPosition | undefined;
+    /**
+     * 找到给定位置所在的最外层节点
+     * @param index 位置
+     */
+    elementFromIndex(index?: number): AstNodes | undefined;
+    /**
+     * 找到给定位置所在的最外层节点
+     * @param x 列数
+     * @param y 行数
+     */
+    elementFromPoint(x: number, y: number): AstNodes | undefined;
+    /**
+     * 找到给定位置所在的所有节点
+     * @param index 位置
+     */
+    elementsFromIndex(index?: number): AstNodes[];
+    /**
+     * 找到给定位置所在的所有节点
+     * @param x 列数
+     * @param y 行数
+     */
+    elementsFromPoint(x: number, y: number): AstNodes[];
+    /**
+     * 判断标题是否是跨维基链接
+     * @param title 标题
+     */
+    isInterwiki(title: string): RegExpExecArray | null;
+    /** 深拷贝节点 */
+    cloneNode(): this;
+    /** 获取全部章节 */
+    sections(): AstRange[] | undefined;
+    /**
+     * 获取指定章节
+     * @param n 章节序号
+     */
+    section(n: number): AstRange | undefined;
+    /**
+     * 获取指定的外层HTML标签
+     * @param tag HTML标签名
+     * @throws `RangeError` 非法的标签或空标签
+     */
+    findEnclosingHtml(tag?: string): AstRange | undefined;
+    /** 获取全部分类 */
+    getCategories(): [string, string | undefined][];
+    /**
+     * 展开模板
+     * @param context 模板调用环境
+     */
+    expand(): Token;
+    /** 解析部分魔术字 */
+    solveConst(): Token;
+    /** 合并普通节点的普通子节点 */
+    flatten(): void;
+    /** 生成HTML */
+    toHtml(): string;
+}