wikiparser-node 1.11.1 → 1.12.0-b

package/dist/src/attribute.js

@@ -1,480 +0,0 @@
-"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.AttributeToken = void 0;
-const lint_1 = require("../util/lint");
-const rect_1 = require("../lib/rect");
-const string_1 = require("../util/string");
-const debug_1 = require("../util/debug");
-const constants_1 = require("../util/constants");
-const fixed_1 = require("../mixin/fixed");
-const index_1 = require("../index");
-const index_2 = require("./index");
-const atom_1 = require("./atom");
-/* NOT FOR BROWSER */
-const stages = { 'ext-attr': 0, 'html-attr': 2, 'table-attr': 3 };
-/* NOT FOR BROWSER END */
-const commonHtmlAttrs = new Set([
-    'id',
-    'class',
-    'style',
-    'lang',
-    'dir',
-    'title',
-    'tabindex',
-    'aria-describedby',
-    'aria-flowto',
-    'aria-hidden',
-    'aria-label',
-    'aria-labelledby',
-    'aria-level',
-    'aria-owns',
-    'role',
-    'about',
-    'property',
-    'resource',
-    'datatype',
-    'typeof',
-    'itemid',
-    'itemprop',
-    'itemref',
-    'itemscope',
-    'itemtype',
-]), blockAttrs = new Set(['align']), citeAttrs = new Set(['cite']), citeAndAttrs = new Set(['cite', 'datetime']), widthAttrs = new Set(['width']), obsoleteTdAttrs = new Set(['axis', 'align', 'bgcolor', 'height', 'width', 'valign']), tdAttrs = new Set([...obsoleteTdAttrs, 'abbr', 'headers', 'scope', 'rowspan', 'colspan']), typeAttrs = new Set(['type']), obsoleteTableAttrs = new Set(['summary', 'align', 'bgcolor', 'cellpadding', 'cellspacing', 'frame', 'rules', 'width']), brAttrs = new Set(['clear']), trAttrs = new Set(['bgcolor', 'align', 'valign']), htmlAttrs = {
-    div: blockAttrs,
-    h1: blockAttrs,
-    h2: blockAttrs,
-    h3: blockAttrs,
-    h4: blockAttrs,
-    h5: blockAttrs,
-    h6: blockAttrs,
-    blockquote: citeAttrs,
-    q: citeAttrs,
-    p: blockAttrs,
-    br: brAttrs,
-    pre: widthAttrs,
-    ins: citeAndAttrs,
-    del: citeAndAttrs,
-    ul: typeAttrs,
-    ol: new Set(['type', 'start', 'reversed']),
-    li: new Set(['type', 'value']),
-    table: new Set([...obsoleteTableAttrs, 'border']),
-    caption: blockAttrs,
-    tr: trAttrs,
-    td: tdAttrs,
-    th: tdAttrs,
-    img: new Set(['alt', 'src', 'width', 'height', 'srcset']),
-    font: new Set(['size', 'color', 'face']),
-    hr: widthAttrs,
-    data: new Set(['value']),
-    time: new Set(['datetime']),
-    meta: new Set(['itemprop', 'content']),
-    link: new Set(['itemprop', 'href', 'title']),
-    gallery: new Set(['mode', 'showfilename', 'caption', 'perrow', 'widths', 'heights', 'showthumbnails', 'type']),
-    poem: new Set(['compact', 'align']),
-    categorytree: new Set([
-        'align',
-        'hideroot',
-        'onlyroot',
-        'depth',
-        'mode',
-        'hideprefix',
-        'namespaces',
-        'showcount',
-        'notranslations',
-    ]),
-    combooption: new Set(['name', 'for', 'inline', 'align']),
-}, empty = new Set(), extAttrs = {
-    nowiki: empty,
-    indicator: new Set(['name']),
-    langconvert: new Set(['from', 'to']),
-    ref: new Set(['group', 'name', 'extends', 'follow', 'dir']),
-    references: new Set(['group', 'responsive']),
-    charinsert: new Set(['label']),
-    choose: new Set(['uncached', 'before', 'after']),
-    option: new Set(['weight']),
-    imagemap: empty,
-    inputbox: empty,
-    templatestyles: new Set(['src', 'wrapper']),
-    dynamicpagelist: empty,
-    poll: new Set(['id', 'show-results-before-voting']),
-    sm2: typeAttrs,
-    flashmp3: typeAttrs,
-    score: new Set([
-        'line_width_inches',
-        'lang',
-        'override_midi',
-        'raw',
-        'note-language',
-        'override_audio',
-        'override_ogg',
-        'sound',
-        'vorbis',
-    ]),
-    seo: new Set([
-        'title',
-        'title_mode',
-        'title_separator',
-        'keywords',
-        'description',
-        'robots',
-        'google_bot',
-        'image',
-        'image_width',
-        'image_height',
-        'image_alt',
-        'type',
-        'site_name',
-        'locale',
-        'section',
-        'author',
-        'published_time',
-        'twitter_site',
-    ]),
-    tab: new Set([
-        'nested',
-        'name',
-        'index',
-        'class',
-        'block',
-        'inline',
-        'openname',
-        'closename',
-        'collapsed',
-        'dropdown',
-        'style',
-        'bgcolor',
-        'container',
-        'id',
-        'title',
-    ]),
-    tabs: new Set(['plain', 'class', 'container', 'id', 'title', 'style']),
-    combobox: new Set(['placeholder', 'value', 'id', 'class', 'text', 'dropdown', 'style']),
-}, insecureStyle = /expression|(?:accelerator|-o-link(?:-source)?|-o-replace)\s*:|(?:url|image(?:-set)?)\s*\(|attr\s*\([^)]+[\s,]url/u, obsoleteAttrs = {
-    table: obsoleteTableAttrs,
-    td: new Set([...obsoleteTdAttrs, 'scope']),
-    th: obsoleteTdAttrs,
-    br: brAttrs,
-    caption: blockAttrs,
-    div: blockAttrs,
-    hr: widthAttrs,
-    h1: blockAttrs,
-    h2: blockAttrs,
-    h3: blockAttrs,
-    h4: blockAttrs,
-    h5: blockAttrs,
-    h6: blockAttrs,
-    li: typeAttrs,
-    p: blockAttrs,
-    pre: widthAttrs,
-    tr: trAttrs,
-    ul: typeAttrs,
-};
-/**
- * 扩展和HTML标签属性
- * @classdesc `{childNodes: [AtomToken, Token|AtomToken]}`
- */
-let AttributeToken = (() => {
-    let _classDecorators = [fixed_1.fixedToken];
-    let _classDescriptor;
-    let _classExtraInitializers = [];
-    let _classThis;
-    let _classSuper = index_2.Token;
-    var AttributeToken = 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);
-            AttributeToken = _classThis = _classDescriptor.value;
-            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
-            __runInitializers(_classThis, _classExtraInitializers);
-        }
-        #type;
-        #tag;
-        #equal;
-        #quotes;
-        /* NOT FOR BROWSER END */
-        get type() {
-            return this.#type;
-        }
-        /** 标签名 */
-        get tag() {
-            return this.#tag;
-        }
-        /** 引号是否匹配 */
-        get balanced() {
-            return !this.#equal || this.#quotes[0] === this.#quotes[1];
-        }
-        /* NOT FOR BROWSER */
-        set balanced(value) {
-            if (value) {
-                this.close();
-            }
-        }
-        /** getValue()的getter */
-        get value() {
-            return this.getValue();
-        }
-        set value(value) {
-            this.setValue(value);
-        }
-        /* NOT FOR BROWSER END */
-        /**
-         * @param type 标签类型
-         * @param tag 标签名
-         * @param key 属性名
-         * @param equal 等号
-         * @param value 属性值
-         * @param quotes 引号
-         */
-        constructor(type, tag, key, equal = '', value, quotes = [], config = index_1.default.getConfig(), accum = []) {
-            const keyToken = new atom_1.AtomToken(key, 'attr-key', config, accum, type === 'ext-attr' ? { AstText: ':' } : { 'Stage-2': ':', '!ExtToken': '', '!HeadingToken': '' });
-            let valueToken;
-            if (key === 'title' || tag === 'img' && key === 'alt') {
-                valueToken = new index_2.Token(value, config, accum, {
-                    [`Stage-${stages[type]}`]: ':', ConverterToken: ':',
-                });
-                valueToken.type = 'attr-value';
-                valueToken.setAttribute('stage', constants_1.MAX_STAGE - 1);
-            }
-            else if (tag === 'gallery' && key === 'caption'
-                || tag === 'choose' && (key === 'before' || key === 'after')) {
-                const newConfig = {
-                    ...config,
-                    excludes: [...config.excludes, 'heading', 'html', 'table', 'hr', 'list'],
-                };
-                valueToken = new index_2.Token(value, newConfig, accum, {
-                    AstText: ':',
-                    ArgToken: ':',
-                    TranscludeToken: ':',
-                    LinkToken: ':',
-                    FileToken: ':',
-                    CategoryToken: ':',
-                    QuoteToken: ':',
-                    ExtLinkToken: ':',
-                    MagicLinkToken: ':',
-                    ConverterToken: ':',
-                });
-                valueToken.type = 'attr-value';
-                valueToken.setAttribute('stage', 1);
-            }
-            else {
-                valueToken = new atom_1.AtomToken(value, 'attr-value', config, accum, {
-                    [`Stage-${stages[type]}`]: ':',
-                });
-            }
-            super(undefined, config, accum);
-            this.#type = type;
-            this.append(keyToken, valueToken);
-            this.#equal = equal;
-            this.#quotes = [...quotes];
-            this.#tag = tag;
-            this.setAttribute('name', (0, string_1.removeComment)(key).trim().toLowerCase());
-        }
-        /** @private */
-        afterBuild() {
-            if (this.#equal.includes('\0')) {
-                this.#equal = this.buildFromStr(this.#equal, constants_1.BuildMethod.String);
-            }
-            if (this.parentNode) {
-                this.#tag = this.parentNode.name;
-            }
-            this.setAttribute('name', this.firstChild.toString(true).trim().toLowerCase());
-            super.afterBuild();
-        }
-        /** @private */
-        toString(skip) {
-            const [quoteStart = '', quoteEnd = ''] = this.#quotes;
-            return this.#equal ? super.toString(skip, this.#equal + quoteStart) + quoteEnd : this.firstChild.toString(skip);
-        }
-        /** @private */
-        text() {
-            return this.#equal ? `${super.text(`${this.#equal.trim()}"`)}"` : this.firstChild.text();
-        }
-        /** @private */
-        getGaps() {
-            return this.#equal ? this.#equal.length + (this.#quotes[0]?.length ?? 0) : 0;
-        }
-        /** @private */
-        lint(start = this.getAbsoluteIndex(), re) {
-            const errors = super.lint(start, re), { balanced, firstChild, lastChild, type, name, tag } = this, value = this.getValue(), rect = new rect_1.BoundingRect(this, start);
-            if (!balanced) {
-                const e = (0, lint_1.generateForChild)(lastChild, rect, 'unclosed-quote', index_1.default.msg('unclosed $1', 'quotes'), 'warning');
-                e.startIndex--;
-                e.startCol--;
-                const fix = { range: [e.endIndex, e.endIndex], text: this.#quotes[0] };
-                if (lastChild.childNodes.some(({ type: t, data }) => t === 'text' && /\s/u.test(data))) {
-                    e.suggestions = [
-                        {
-                            desc: 'close',
-                            ...fix,
-                        },
-                    ];
-                }
-                else {
-                    e.fix = fix;
-                }
-                errors.push(e);
-            }
-            const attrs = extAttrs[tag];
-            if (attrs && !attrs.has(name)
-                || (type === 'ext-attr' ? tag in htmlAttrs : !/\{\{[^{]+\}\}/u.test(name))
-                    && !htmlAttrs[tag]?.has(name)
-                    && !/^(?:xmlns:[\w:.-]+|data-[^:]*)$/u.test(name)
-                    && (tag === 'meta' || tag === 'link' || !commonHtmlAttrs.has(name))) {
-                errors.push((0, lint_1.generateForChild)(firstChild, rect, 'illegal-attr', 'illegal attribute name'));
-            }
-            else if (obsoleteAttrs[tag]?.has(name)) {
-                errors.push((0, lint_1.generateForChild)(firstChild, rect, 'obsolete-attr', 'obsolete attribute', 'warning'));
-            }
-            else if (name === 'style' && typeof value === 'string' && insecureStyle.test(value)) {
-                errors.push((0, lint_1.generateForChild)(lastChild, rect, 'insecure-style', 'insecure style'));
-            }
-            else if (name === 'tabindex' && typeof value === 'string' && value !== '0') {
-                const e = (0, lint_1.generateForChild)(lastChild, rect, 'illegal-attr', 'nonzero tabindex');
-                e.suggestions = [
-                    {
-                        desc: 'remove',
-                        range: [start, e.endIndex],
-                        text: '',
-                    },
-                    {
-                        desc: '0 tabindex',
-                        range: [e.startIndex, e.endIndex],
-                        text: '0',
-                    },
-                ];
-                errors.push(e);
-            }
-            return errors;
-        }
-        /** 获取属性值 */
-        getValue() {
-            return this.#equal ? this.lastChild.text().trim() : this.type === 'ext-attr' || '';
-        }
-        /** @private */
-        print() {
-            const [quoteStart = '', quoteEnd = ''] = this.#quotes;
-            return this.#equal ? super.print({ sep: (0, string_1.escape)(this.#equal) + quoteStart, post: quoteEnd }) : super.print();
-        }
-        /* NOT FOR BROWSER */
-        cloneNode() {
-            const [key, value] = this.cloneChildNodes(), k = key.toString(), config = this.getAttribute('config');
-            return debug_1.Shadow.run(() => {
-                // @ts-expect-error abstract class
-                const token = new AttributeToken(this.type, this.tag, k, this.#equal, '', this.#quotes, config);
-                token.firstChild.safeReplaceWith(key);
-                token.lastChild.safeReplaceWith(value);
-                return token;
-            });
-        }
-        /** 转义等号 */
-        escape() {
-            this.#equal = '{{=}}';
-        }
-        /** 闭合引号 */
-        close() {
-            const [opening] = this.#quotes;
-            if (opening) {
-                this.#quotes[1] = opening;
-            }
-        }
-        /**
-         * 设置属性值
-         * @param value 参数值
-         * @throws `RangeError` 扩展标签属性不能包含 ">"
-         * @throws `RangeError` 同时包含单引号和双引号
-         */
-        setValue(value) {
-            if (value === false) {
-                this.remove();
-                return;
-            }
-            else if (value === true) {
-                this.#equal = '';
-                return;
-            }
-            else if (this.type === 'ext-attr' && value.includes('>')) {
-                throw new RangeError('Attributes of an extension tag cannot contain ">"!');
-            }
-            else if (value.includes('"') && value.includes(`'`)) {
-                throw new RangeError('Attribute values cannot contain single and double quotes simultaneously!');
-            }
-            const config = this.getAttribute('config'), { childNodes } = index_1.default.parse(value, this.getAttribute('include'), stages[this.type] + 1, config);
-            this.lastChild.replaceChildren(...childNodes);
-            if (value.includes('"')) {
-                this.#quotes = [`'`, `'`];
-            }
-            else if (value.includes(`'`) || !this.#quotes[0]) {
-                this.#quotes = ['"', '"'];
-            }
-            else {
-                this.close();
-            }
-        }
-        /**
-         * 修改属性名
-         * @param key 新属性名
-         * @throws `Error` title和alt属性不能更名
-         */
-        rename(key) {
-            if (this.name === 'title' || this.name === 'alt' && this.tag === 'img') {
-                throw new Error(`${this.name} attribute cannot be renamed!`);
-            }
-            const config = this.getAttribute('config'), { childNodes } = index_1.default.parse(key, this.getAttribute('include'), stages[this.type] + 1, config);
-            this.firstChild.replaceChildren(...childNodes);
-        }
-        /** @private */
-        toHtmlInternal() {
-            const { type, name, tag, lastChild } = this;
-            if (type === 'ext-attr' && !(tag in htmlAttrs)
-                || !htmlAttrs[tag]?.has(name) && (tag === 'meta' || tag === 'link' || !commonHtmlAttrs.has(name))) {
-                return '';
-            }
-            let value = lastChild.toHtmlInternal().trim();
-            if (name === 'style' && insecureStyle.test(value) || name === 'tabindex' && value !== '0') {
-                return '';
-            }
-            else if (name === 'id') {
-                value = value.replace(/\s+/gu, '_');
-            }
-            return `${name}="${(0, string_1.sanitizeAttr)(value)}"`;
-        }
-    };
-    return AttributeToken = _classThis;
-})();
-exports.AttributeToken = AttributeToken;
-constants_1.classes['AttributeToken'] = __filename;

package/dist/src/attributes.d.ts

@@ -1,101 +0,0 @@
-import Parser from '../index';
-import { Token } from './index';
-import { AtomToken } from './atom';
-import { AttributeToken } from './attribute';
-import type { LintError } from '../base';
-import type { ExtToken, HtmlToken, TdToken, TrToken, TableToken } from '../internal';
-import type { AttributeTypes } from './attribute';
-declare type AttributesTypes = `${AttributeTypes}s`;
-/**
- * 扩展和HTML标签属性
- * @classdesc `{childNodes: ...AtomToken|AttributeToken}`
- */
-export declare abstract class AttributesToken extends Token {
-    #private;
-    readonly name: string;
-    readonly childNodes: readonly (AtomToken | AttributeToken)[];
-    abstract get firstChild(): AtomToken | AttributeToken | undefined;
-    abstract get lastChild(): AtomToken | AttributeToken | undefined;
-    abstract get parentNode(): ExtToken | HtmlToken | TableToken | TrToken | TdToken | undefined;
-    abstract get children(): (AtomToken | AttributeToken)[];
-    abstract get firstElementChild(): AtomToken | AttributeToken | undefined;
-    abstract get lastElementChild(): AtomToken | AttributeToken | undefined;
-    abstract get parentElement(): ExtToken | HtmlToken | TableToken | TrToken | TdToken | undefined;
-    get type(): AttributesTypes;
-    /** getAttrs()方法的getter写法 */
-    get attributes(): Record<string, string | true>;
-    set attributes(attrs: Record<string, string | true>);
-    /** 以字符串表示的class属性 */
-    get className(): string;
-    set className(className: string);
-    /** 以Set表示的class属性 */
-    get classList(): Set<string>;
-    /** id属性 */
-    get id(): string;
-    set id(id: string);
-    /** 是否含有无效属性 */
-    get sanitized(): boolean;
-    set sanitized(sanitized: boolean);
-    /**
-     * @param attr 标签属性
-     * @param type 标签类型
-     * @param name 标签名
-     */
-    constructor(attr: string | undefined, type: AttributesTypes, name: string, config?: Parser.Config, accum?: Token[]);
-    /**
-     * 所有指定属性名的AttributeToken
-     * @param key 属性名
-     */
-    getAttrTokens(key?: string): AttributeToken[];
-    /**
-     * 指定属性名的最后一个AttributeToken
-     * @param key 属性名
-     */
-    getAttrToken(key: string): AttributeToken | undefined;
-    /**
-     * 获取指定属性
-     * @param key 属性键
-     */
-    getAttr(key: string): string | true | undefined;
-    /** 清理无效属性 */
-    sanitize(): void;
-    cloneNode(): this;
-    /**
-     * @override
-     * @param token 待插入的子节点
-     * @param i 插入位置
-     * @throws `RangeError` 标签不匹配
-     */
-    insertAt<T extends AttributeToken | AtomToken>(token: T, i?: number): T;
-    /**
-     * 设置指定属性
-     * @param key 属性键
-     * @param value 属性值
-     * @param prop 属性对象
-     * @throws `RangeError` 扩展标签属性不能包含">"
-     */
-    setAttr(key: string, value: string | boolean): void;
-    setAttr(prop: Record<string, string | boolean>): void;
-    /**
-     * 标签是否具有某属性
-     * @param key 属性键
-     */
-    hasAttr(key: string): boolean;
-    /** 获取全部的属性名 */
-    getAttrNames(): Set<string>;
-    /** 获取全部属性 */
-    getAttrs(): Record<string, string | true>;
-    /**
-     * 移除指定属性
-     * @param key 属性键
-     */
-    removeAttr(key: string): void;
-    /**
-     * 开关指定属性
-     * @param key 属性键
-     * @param force 强制开启或关闭
-     * @throws `RangeError` 不为Boolean类型的属性值
-     */
-    toggleAttr(key: string, force?: boolean): void;
-}
-export {};