wikiparser-node 1.0.0-beta.3 → 1.0.1-b

package/dist/src/html.d.ts

@@ -1,113 +0,0 @@
-import { Token } from '.';
-import type { LintError } from '../index';
-import type { AttributesToken } from '../internal';
-declare const HtmlToken_base: (abstract new (...args: any[]) => {
-    /**
-     * HTML标签
-     * @classdesc `{childNodes: [AttributesToken]}`
-     */
-    childNodes: import("../index").AstNodes[];
-    readonly "__#4@#attributesChild": AttributesToken;
-    readonly attributes: Record<string, string | true>;
-    className: string;
-    readonly classList: Set<string>;
-    id: string;
-    hasAttr(key: string): boolean;
-    getAttr(key: string): string | true | undefined;
-    getAttrNames(): Set<string>;
-    hasAttrs(): boolean;
-    getAttrs(): Record<string, string | true>;
-    setAttr(key: string, value: string | boolean): void;
-    removeAttr(key: string): void;
-    toggleAttr(key: string, force?: boolean | undefined): void;
-    length: number;
-    toString(selector?: string | undefined, separator?: string | undefined): string;
-    text(separator?: string | undefined): string;
-    insertAt(token: unknown, i?: number | undefined): unknown;
-}) & ((abstract new (...args: any[]) => {
-    removeAt(): never;
-    insertAt(token: string, i?: number | undefined): import("../index").AstText;
-    insertAt<T extends import("../index").AstNodes>(token: T, i?: number | undefined): T;
-    length: number;
-    toString(selector?: string | undefined, separator?: string | undefined): string;
-    text(separator?: string | undefined): string;
-}) & {
-    readonly fixed: true;
-}) & typeof Token;
-/**
- * HTML标签
- * @classdesc `{childNodes: [AttributesToken]}`
- */
-export declare abstract class HtmlToken extends HtmlToken_base {
-    #private;
-    /** @browser */
-    readonly type = "html";
-    name: string;
-    childNodes: [AttributesToken];
-    abstract get children(): [AttributesToken];
-    abstract get firstChild(): AttributesToken;
-    abstract get firstElementChild(): AttributesToken;
-    abstract get lastChild(): AttributesToken;
-    abstract get lastElementChild(): AttributesToken;
-    /**
-     * 是否是闭合标签
-     * @browser
-     */
-    get closing(): boolean;
-    /** @throws `Error` 自封闭标签或空标签 */
-    set closing(value: boolean);
-    /** 是否自封闭 */
-    get selfClosing(): boolean;
-    /** @throws `Error` 闭合标签或无效自封闭标签 */
-    set selfClosing(value: boolean);
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param closing 是否闭合
-     * @param selfClosing 是否自封闭
-     */
-    constructor(name: string, attr: AttributesToken, closing: boolean, selfClosing: boolean, config?: import("../index").Config, accum?: Token[]);
-    /**
-     * @override
-     * @browser
-     */
-    toString(selector?: string): string;
-    /**
-     * @override
-     * @browser
-     */
-    text(): string;
-    /**
-     * @override
-     * @browser
-     */
-    print(): string;
-    /**
-     * @override
-     * @browser
-     */
-    lint(start?: number): LintError[];
-    /**
-     * 搜索匹配的标签
-     * @browser
-     * @throws `SyntaxError` 同时闭合和自封闭的标签
-     * @throws `SyntaxError` 无效自封闭标签
-     * @throws `SyntaxError` 未闭合的标签
-     */
-    findMatchingTag(): this | undefined;
-    /** @override */
-    cloneNode(): this;
-    /**
-     * 更换标签名
-     * @param tag 标签名
-     * @throws `RangeError` 非法的HTML标签
-     */
-    replaceTag(tag: string): void;
-    /**
-     * 修复无效自封闭标签
-     * @throws `Error` 无法修复无效自封闭标签
-     */
-    fix(): void;
-}
-export {};

package/dist/src/html.js

@@ -1,245 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.HtmlToken = void 0;
-const lint_1 = require("../util/lint");
-const string_1 = require("../util/string");
-const fixed_1 = require("../mixin/fixed");
-const attributesParent_1 = require("../mixin/attributesParent");
-const index_1 = require("../index");
-const _1 = require(".");
-const magicWords = new Set(['if', 'ifeq', 'ifexpr', 'ifexist', 'iferror', 'switch']);
-/**
- * HTML标签
- * @classdesc `{childNodes: [AttributesToken]}`
- */
-class HtmlToken extends (0, attributesParent_1.attributesParent)((0, fixed_1.fixed)(_1.Token)) {
-    /** @browser */
-    type = 'html';
-    /** @browser */
-    #closing;
-    /** @browser */
-    #selfClosing;
-    /** @browser */
-    #tag;
-    /**
-     * 是否是闭合标签
-     * @browser
-     */
-    get closing() {
-        return this.#closing;
-    }
-    /** @throws `Error` 自封闭标签或空标签 */
-    set closing(value) {
-        if (!value) {
-            this.#closing = false;
-            return;
-        }
-        else if (this.#selfClosing) {
-            throw new Error('这是一个自封闭标签！');
-        }
-        const { html: [, , tags] } = this.getAttribute('config');
-        if (tags.includes(this.name)) {
-            throw new Error('这是一个空标签！');
-        }
-        this.#closing = true;
-    }
-    /** 是否自封闭 */
-    get selfClosing() {
-        return this.#selfClosing;
-    }
-    /** @throws `Error` 闭合标签或无效自封闭标签 */
-    set selfClosing(value) {
-        if (!value) {
-            this.#selfClosing = false;
-            return;
-        }
-        else if (this.#closing) {
-            throw new Error('这是一个闭合标签！');
-        }
-        const { html: [tags] } = this.getAttribute('config');
-        if (tags.includes(this.name)) {
-            throw new Error(`<${this.name}>标签自封闭无效！`);
-        }
-        this.#selfClosing = true;
-    }
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param closing 是否闭合
-     * @param selfClosing 是否自封闭
-     */
-    constructor(name, attr, closing, selfClosing, config = index_1.default.getConfig(), accum = []) {
-        super(undefined, config, true, accum);
-        this.insertAt(attr);
-        this.setAttribute('name', name.toLowerCase());
-        this.#closing = closing;
-        this.#selfClosing = selfClosing;
-        this.#tag = name;
-    }
-    /**
-     * @override
-     * @browser
-     */
-    toString(selector) {
-        return selector && this.matches(selector)
-            ? ''
-            : `<${this.#closing ? '/' : ''}${this.#tag}${super.toString(selector)}${this.#selfClosing ? '/' : ''}>`;
-    }
-    /**
-     * @override
-     * @browser
-     */
-    text() {
-        return `<${this.#closing ? '/' : ''}${this.#tag}${this.#closing ? '' : super.text()}${this.#selfClosing ? '/' : ''}>`;
-    }
-    /** @private */
-    getPadding() {
-        return this.#tag.length + (this.#closing ? 2 : 1);
-    }
-    /**
-     * @override
-     * @browser
-     */
-    print() {
-        return super.print({
-            pre: `&lt;${this.#closing ? '/' : ''}${this.#tag}`,
-            post: `${this.#selfClosing ? '/' : ''}&gt;`,
-        });
-    }
-    /**
-     * @override
-     * @browser
-     */
-    lint(start = this.getAbsoluteIndex()) {
-        const errors = super.lint(start);
-        let wikitext, refError;
-        if (this.name === 'h1' && !this.#closing) {
-            wikitext = String(this.getRootNode());
-            refError = (0, lint_1.generateForSelf)(this, { start }, '<h1>');
-            errors.push({ ...refError, excerpt: wikitext.slice(start, start + 50) });
-        }
-        if (this.closest('table-attrs')) {
-            wikitext ??= String(this.getRootNode());
-            refError ??= (0, lint_1.generateForSelf)(this, { start }, '');
-            const excerpt = wikitext.slice(Math.max(0, start - 25), start + 25);
-            errors.push({ ...refError, message: index_1.default.msg('HTML tag in table attributes'), excerpt });
-        }
-        try {
-            this.findMatchingTag();
-        }
-        catch (e) {
-            if (e instanceof SyntaxError) {
-                const { message: errorMsg } = e;
-                wikitext ??= String(this.getRootNode());
-                refError ??= (0, lint_1.generateForSelf)(this, { start }, '');
-                const [msg] = errorMsg.split(':'), error = { ...refError, message: index_1.default.msg(msg) };
-                if (msg === 'unclosed tag') {
-                    error.severity = 'warning';
-                    error.excerpt = wikitext.slice(start, start + 50);
-                }
-                else if (msg === 'unmatched closing tag') {
-                    const end = start + String(this).length, ancestor = this.closest('magic-word');
-                    error.excerpt = wikitext.slice(Math.max(0, end - 50), end);
-                    if (ancestor && magicWords.has(ancestor.name)) {
-                        error.severity = 'warning';
-                    }
-                }
-                errors.push(error);
-            }
-        }
-        return errors;
-    }
-    /**
-     * 搜索匹配的标签
-     * @browser
-     * @throws `SyntaxError` 同时闭合和自封闭的标签
-     * @throws `SyntaxError` 无效自封闭标签
-     * @throws `SyntaxError` 未闭合的标签
-     */
-    findMatchingTag() {
-        const { html } = this.getAttribute('config'), { name: tagName, parentNode } = this, string = (0, string_1.noWrap)(String(this));
-        if (this.#closing && (this.#selfClosing || html[2].includes(tagName))) {
-            throw new SyntaxError(`tag that is both closing and self-closing: ${string}`);
-        }
-        else if (html[2].includes(tagName) || this.#selfClosing && html[1].includes(tagName)) { // 自封闭标签
-            return this;
-        }
-        else if (this.#selfClosing && html[0].includes(tagName)) {
-            throw new SyntaxError(`invalid self-closing tag: ${string}`);
-        }
-        else if (!parentNode) {
-            return undefined;
-        }
-        const { childNodes } = parentNode, i = childNodes.indexOf(this), siblings = this.#closing
-            ? childNodes.slice(0, i).reverse().filter(({ type, name }) => type === 'html' && name === tagName)
-            : childNodes.slice(i + 1).filter(({ type, name }) => type === 'html' && name === tagName);
-        let imbalance = this.#closing ? -1 : 1;
-        for (const token of siblings) {
-            if (token.closing) {
-                imbalance--;
-            }
-            else {
-                imbalance++;
-            }
-            if (imbalance === 0) {
-                return token;
-            }
-        }
-        throw new SyntaxError(`${this.#closing ? 'unmatched closing' : 'unclosed'} tag: ${string}`);
-    }
-    /** @override */
-    cloneNode() {
-        const [attr] = this.cloneChildNodes(), config = this.getAttribute('config');
-        // @ts-expect-error abstract class
-        return index_1.default.run(() => new HtmlToken(this.#tag, attr, this.#closing, this.#selfClosing, config));
-    }
-    /** @private */
-    getAttribute(key) {
-        return key === 'tag' ? this.#tag : super.getAttribute(key);
-    }
-    /**
-     * 更换标签名
-     * @param tag 标签名
-     * @throws `RangeError` 非法的HTML标签
-     */
-    replaceTag(tag) {
-        const name = tag.toLowerCase();
-        if (!this.getAttribute('config').html.flat().includes(name)) {
-            throw new RangeError(`非法的HTML标签：${tag}`);
-        }
-        this.setAttribute('name', name).#tag = tag;
-    }
-    /** 局部闭合 */
-    #localMatch() {
-        this.#selfClosing = false;
-        const root = index_1.default.parse(`</${this.name}>`, false, 3, this.getAttribute('config'));
-        this.after(root.firstChild);
-    }
-    /**
-     * 修复无效自封闭标签
-     * @throws `Error` 无法修复无效自封闭标签
-     */
-    fix() {
-        const config = this.getAttribute('config'), { parentNode, name: tagName, firstChild } = this;
-        if (!parentNode || !this.#selfClosing || !config.html[0].includes(tagName)) {
-            return;
-        }
-        else if (firstChild.text().trim()) {
-            this.#localMatch();
-            return;
-        }
-        const { childNodes } = parentNode, i = childNodes.indexOf(this), prevSiblings = childNodes.slice(0, i)
-            .filter(({ type, name }) => type === 'html' && name === tagName), imbalance = prevSiblings.reduce((acc, { closing }) => acc + (closing ? 1 : -1), 0);
-        if (imbalance < 0) {
-            this.#selfClosing = false;
-            this.#closing = true;
-        }
-        else {
-            index_1.default.warn('无法修复无效自封闭标签', (0, string_1.noWrap)(String(this)));
-            throw new Error(`无法修复无效自封闭标签：前文共有 ${imbalance} 个未匹配的闭合标签`);
-        }
-    }
-}
-exports.HtmlToken = HtmlToken;
-index_1.default.classes['HtmlToken'] = __filename;

package/dist/src/imageParameter.d.ts

@@ -1,82 +0,0 @@
-import { Token } from '.';
-import type { LintError, Config } from '../index';
-import type { Title } from '../lib/title';
-import type { AstNodes, AstText, AtomToken, FileToken } from '../internal';
-/** 图片参数 */
-export declare abstract class ImageParameterToken extends Token {
-    #private;
-    /** @browser */
-    readonly type = "image-parameter";
-    name: string;
-    abstract get parentNode(): FileToken;
-    abstract get parentElement(): FileToken;
-    abstract get nextSibling(): this | undefined;
-    abstract get nextElementSibling(): this | undefined;
-    abstract get previousSibling(): AtomToken | this;
-    abstract get previousElementSibling(): AtomToken | this;
-    /**
-     * 图片链接
-     * @browser
-     */
-    get link(): string | Title | undefined;
-    set link(value: string | Title | undefined);
-    /** getValue()的getter */
-    get value(): string | true;
-    set value(value: string | true);
-    /** 图片大小 */
-    get size(): {
-        width: string;
-        height: string;
-    } | undefined;
-    /** 图片宽度 */
-    get width(): string | undefined;
-    set width(width: string | undefined);
-    /** 图片高度 */
-    get height(): string | undefined;
-    set height(height: string | undefined);
-    /**
-     * @browser
-     * @param str 图片参数
-     */
-    constructor(str: string, config?: Config, accum?: Token[]);
-    /**
-     * @override
-     * @browser
-     */
-    toString(selector?: string): string;
-    /**
-     * @override
-     * @browser
-     */
-    text(): string;
-    /**
-     * @override
-     * @browser
-     */
-    lint(start?: number): LintError[];
-    /**
-     * @override
-     * @browser
-     */
-    print(): string;
-    /** @override */
-    cloneNode(): this;
-    /**
-     * @override
-     * @param token 待插入的子节点
-     * @param i 插入位置
-     * @throws `Error` 不接受自定义输入的图片参数
-     */
-    insertAt(token: string, i?: number): AstText;
-    /** @ignore */
-    insertAt<T extends AstNodes>(token: T, i?: number): T;
-    /** 获取参数值 */
-    getValue(): string | true;
-    /**
-     * 设置参数值
-     * @param value 参数值
-     * @throws `Error` 无效参数
-     * @throws	SyntaxError` 非法的参数值
-     */
-    setValue(value: string | boolean): void;
-}

package/dist/src/imageParameter.js

@@ -1,256 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ImageParameterToken = void 0;
-const string_1 = require("../util/string");
-const lint_1 = require("../util/lint");
-const index_1 = require("../index");
-const _1 = require(".");
-const params = new Set(['alt', 'link', 'lang', 'page', 'caption']);
-/** @ignore */
-function validate(key, val, config = index_1.default.getConfig(), halfParsed = false) {
-    const trimmedVal = val.trim();
-    let value = trimmedVal.replace(/\0\d+t\x7F/gu, '').trim();
-    switch (key) {
-        case 'width':
-            return /^(?:\d+x?|\d*x\d+)$/u.test(value);
-        case 'link': {
-            if (!value) {
-                return trimmedVal;
-            }
-            const regex = new RegExp(`^(?:(?:${config.protocol}|//)${string_1.extUrlCharFirst}|\0\\d+m\x7F)${string_1.extUrlChar}$`, 'iu');
-            if (regex.test(value)) {
-                return trimmedVal;
-            }
-            else if (value.startsWith('[[') && value.endsWith(']]')) {
-                value = value.slice(2, -2);
-            }
-            const title = index_1.default.normalizeTitle(value, 0, false, config, halfParsed, true, true);
-            return title.valid && title;
-        }
-        case 'lang':
-            return config.variants.includes(value);
-        case 'alt':
-        case 'class':
-        case 'manualthumb':
-            return true;
-        default:
-            // @ts-expect-error isNaN
-            return !isNaN(value);
-    }
-}
-/** 图片参数 */
-class ImageParameterToken extends _1.Token {
-    /** @browser */
-    type = 'image-parameter';
-    /** @browser */
-    #syntax = '';
-    /**
-     * 图片链接
-     * @browser
-     */
-    get link() {
-        return this.name === 'link' ? validate('link', super.text(), this.getAttribute('config')) : undefined;
-    }
-    set link(value) {
-        if (this.name === 'link') {
-            this.setValue(String(value));
-        }
-    }
-    /** getValue()的getter */
-    get value() {
-        return this.getValue();
-    }
-    set value(value) {
-        this.setValue(value);
-    }
-    /** 图片大小 */
-    get size() {
-        if (this.name === 'width') {
-            const size = this.getValue().trim();
-            if (!size.includes('{{')) {
-                const [width, height = ''] = size.split('x');
-                return { width, height };
-            }
-            const token = index_1.default.parse(size, false, 2, this.getAttribute('config')), i = token.childNodes.findIndex(child => child.type === 'text' && child.data.includes('x')), str = token.childNodes[i];
-            if (i === -1) {
-                return { width: size, height: '' };
-            }
-            str.splitText(str.data.indexOf('x'));
-            str.nextSibling.splitText(1);
-            return { width: (0, string_1.text)(token.childNodes.slice(0, i + 1)), height: (0, string_1.text)(token.childNodes.slice(i + 2)) };
-        }
-        return undefined;
-    }
-    /** 图片宽度 */
-    get width() {
-        return this.size?.width;
-    }
-    set width(width) {
-        if (this.name === 'width') {
-            const { height } = this;
-            this.setValue(`${width || ''}${height && 'x'}${height}`);
-        }
-    }
-    /** 图片高度 */
-    get height() {
-        return this.size?.height;
-    }
-    set height(height) {
-        if (this.name === 'width') {
-            this.setValue(`${this.width}${height ? `x${height}` : ''}`);
-        }
-    }
-    /**
-     * @browser
-     * @param str 图片参数
-     */
-    constructor(str, config = index_1.default.getConfig(), accum = []) {
-        let mt;
-        const regexes = Object.entries(config.img).map(([syntax, param]) => [
-            syntax,
-            param,
-            new RegExp(`^(\\s*)${syntax.replace('$1', '(.*)')}(\\s*)$`, 'u'),
-        ]), param = regexes.find(([, key, regex]) => {
-            mt = regex.exec(str);
-            return mt
-                && (mt.length !== 4 || validate(key, mt[2], config, true) !== false);
-        });
-        // @ts-expect-error mt already assigned
-        if (param && mt) {
-            if (mt.length === 3) {
-                super(undefined, config, true, accum);
-                this.#syntax = str;
-            }
-            else {
-                super(mt[2], config, true, accum, {
-                    'Stage-2': ':', '!HeadingToken': ':',
-                });
-                this.#syntax = `${mt[1]}${param[0]}${mt[3]}`;
-            }
-            this.setAttribute('name', param[1]);
-            return;
-        }
-        super(str, { ...config, excludes: [...config.excludes ?? [], 'list'] }, true, accum);
-        this.setAttribute('name', 'caption').setAttribute('stage', 7);
-    }
-    /** @private */
-    afterBuild() {
-        if (this.parentNode.type === 'gallery-image' && !params.has(this.name)) {
-            this.setAttribute('name', 'invalid');
-        }
-    }
-    /** @private */
-    isPlain() {
-        return this.name === 'caption';
-    }
-    /**
-     * @override
-     * @browser
-     */
-    toString(selector) {
-        return this.#syntax && !(selector && this.matches(selector))
-            ? this.#syntax.replace('$1', super.toString(selector))
-            : super.toString(selector);
-    }
-    /**
-     * @override
-     * @browser
-     */
-    text() {
-        return this.#syntax ? this.#syntax.replace('$1', super.text()).trim() : super.text().trim();
-    }
-    /** @private */
-    getPadding() {
-        return Math.max(0, this.#syntax.indexOf('$1'));
-    }
-    /**
-     * @override
-     * @browser
-     */
-    lint(start = this.getAbsoluteIndex()) {
-        const errors = super.lint(start), { link } = this;
-        if (this.name === 'invalid') {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'invalid gallery image parameter'));
-        }
-        else if (typeof link === 'object' && link.encoded) {
-            errors.push((0, lint_1.generateForSelf)(this, { start }, 'unnecessary URL encoding in an internal link'));
-        }
-        return errors;
-    }
-    /**
-     * @override
-     * @browser
-     */
-    print() {
-        return this.#syntax
-            ? `<span class="wpb-image-parameter">${this.#syntax.replace('$1', `<span class="wpb-image-caption">${(0, string_1.print)(this.childNodes)}</span>`)}</span>`
-            : super.print({ class: 'image-caption' });
-    }
-    /** @override */
-    cloneNode() {
-        const cloned = this.cloneChildNodes(), config = this.getAttribute('config');
-        return index_1.default.run(() => {
-            // @ts-expect-error abstract class
-            const token = new ImageParameterToken(this.#syntax.replace('$1', ''), config);
-            token.replaceChildren(...cloned);
-            return token;
-        });
-    }
-    /** @private */
-    getAttribute(key) {
-        return key === 'syntax' ? this.#syntax : super.getAttribute(key);
-    }
-    /** @private */
-    hasAttribute(key) {
-        return key === 'syntax' || super.hasAttribute(key);
-    }
-    /** 是否是不可变参数 */
-    #isVoid() {
-        return this.#syntax && !this.#syntax.includes('$1');
-    }
-    /** @ignore */
-    insertAt(token, i = this.length) {
-        if (!index_1.default.running && this.#isVoid()) {
-            throw new Error(`图片参数 ${this.name} 不接受自定义输入！`);
-        }
-        return super.insertAt(token, i);
-    }
-    /** 获取参数值 */
-    getValue() {
-        return this.name === 'invalid' ? this.text() : this.#isVoid() || super.text();
-    }
-    /**
-     * 设置参数值
-     * @param value 参数值
-     * @throws `Error` 无效参数
-     * @throws	SyntaxError` 非法的参数值
-     */
-    setValue(value) {
-        if (this.name === 'invalid') {
-            throw new Error('无效的图片参数！');
-        }
-        else if (this.#isVoid()) {
-            if (typeof value !== 'boolean') {
-                this.typeError('setValue', 'Boolean');
-            }
-            else if (!value) {
-                this.remove();
-            }
-            return;
-        }
-        else if (typeof value !== 'string') {
-            this.typeError('setValue', 'String');
-        }
-        const root = index_1.default.parse(`[[File:F|${this.#syntax ? this.#syntax.replace('$1', value) : value}]]`, this.getAttribute('include'), 6, this.getAttribute('config')), { length, firstChild: file } = root;
-        if (length !== 1 || file.type !== 'file' || file.length !== 2) {
-            throw new SyntaxError(`非法的 ${this.name} 参数：${(0, string_1.noWrap)(value)}`);
-        }
-        const { lastChild: imageParameter, name } = file;
-        if (name !== 'File:F' || imageParameter.name !== this.name) {
-            throw new SyntaxError(`非法的 ${this.name} 参数：${(0, string_1.noWrap)(value)}`);
-        }
-        this.replaceChildren(...imageParameter.childNodes);
-    }
-}
-exports.ImageParameterToken = ImageParameterToken;
-index_1.default.classes['ImageParameterToken'] = __filename;