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

package/dist/src/tagPair/ext.d.ts

@@ -1,55 +0,0 @@
-import * as Parser from '../../index';
-import { Token } from '..';
-import { TagPairToken } from '.';
-import { AttributesToken } from '../attributes';
-import type { LintError } from '../../index';
-declare const ExtToken_base: (abstract new (...args: any[]) => {
-    childNodes: Parser.AstNodes[];
-    readonly "__#4@#attributesChild": Parser.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(omit?: Set<string> | undefined, separator?: string | undefined): string;
-    text(separator?: string | undefined): string;
-    insertAt(token: unknown, i?: number | undefined): unknown;
-}) & typeof TagPairToken;
-/**
- * 扩展标签
- * @classdesc `{childNodes: [AttributesToken, Token]}`
- */
-export declare class ExtToken extends ExtToken_base {
-    readonly type = "ext";
-    childNodes: [AttributesToken, Token];
-    abstract get children(): [AttributesToken, Token];
-    abstract get firstChild(): AttributesToken;
-    abstract get firstElementChild(): AttributesToken;
-    abstract get lastChild(): Token;
-    /** @override */
-    get closed(): boolean;
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param inner 内部wikitext
-     * @param closed 是否封闭
-     */
-    constructor(name: string, attr?: string, inner?: string, closed?: string, config?: Parser.Config, accum?: Token[]);
-    /**
-     * @override
-     * @browser
-     */
-    lint(start?: number): LintError[];
-    /** @override */
-    cloneNode(): this;
-}
-export {};

package/dist/src/tagPair/ext.js

@@ -1,138 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExtToken = void 0;
-const lint_1 = require("../../util/lint");
-const attributesParent_1 = require("../../mixin/attributesParent");
-const Parser = require("../../index");
-const __1 = require("..");
-const _1 = require(".");
-const attributes_1 = require("../attributes");
-/**
- * 从数组中删除指定元素
- * @param arr 数组
- * @param ele 元素
- */
-const del = (arr, ele) => {
-    const set = new Set(arr);
-    set.delete(ele);
-    return [...set];
-};
-/**
- * 扩展标签
- * @classdesc `{childNodes: [AttributesToken, Token]}`
- */
-class ExtToken extends (0, attributesParent_1.attributesParent)(_1.TagPairToken) {
-    type = 'ext';
-    /** @override */
-    // eslint-disable-next-line class-methods-use-this
-    get closed() {
-        return true;
-    }
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param inner 内部wikitext
-     * @param closed 是否封闭
-     */
-    constructor(name, attr, inner, closed, config = Parser.getConfig(), accum = []) {
-        const lcName = name.toLowerCase(), attrToken = new attributes_1.AttributesToken(!attr || attr.trimStart() !== attr ? attr : ` ${attr}`, 'ext-attrs', lcName, config, accum), newConfig = { ...config, ext: del(config.ext, lcName), excludes: [...config.excludes ?? []] };
-        let innerToken;
-        switch (lcName) {
-            case 'tab':
-                newConfig.ext = del(newConfig.ext, 'tabs');
-            // fall through
-            case 'indicator':
-            case 'poem':
-            case 'ref':
-            case 'option':
-            case 'combooption':
-            case 'tabs':
-            case 'poll':
-            case 'seo':
-                if (lcName === 'poem') {
-                    newConfig.excludes.push('heading');
-                }
-                innerToken = new __1.Token(inner, newConfig, true, accum);
-                break;
-            case 'pre': {
-                const { PreToken } = require('../pre');
-                innerToken = new PreToken(inner, newConfig, accum);
-                break;
-            }
-            case 'dynamicpagelist': {
-                const { ParamTagToken } = require('../paramTag');
-                innerToken = new ParamTagToken(inner, newConfig, accum);
-                break;
-            }
-            case 'inputbox': {
-                newConfig.excludes.push('heading');
-                const { InputboxToken } = require('../paramTag/inputbox');
-                innerToken = new InputboxToken(inner, newConfig, accum);
-                break;
-            }
-            case 'references': {
-                const { NestedToken } = require('../nested');
-                innerToken = new NestedToken(inner, /<!--.*?(?:-->|$)|<(ref)(\s[^>]*)?>(.*?)<\/(ref\s*)>/gisu, ['ref'], newConfig, accum);
-                break;
-            }
-            case 'choose': {
-                const { NestedToken } = require('../nested');
-                innerToken = new NestedToken(inner, /<(option|choicetemplate)(\s[^>]*)?>(.*?)<\/(\1)>/gsu, ['option', 'choicetemplate'], newConfig, accum);
-                break;
-            }
-            case 'combobox': {
-                const { NestedToken } = require('../nested');
-                innerToken = new NestedToken(inner, /<(combooption)(\s[^>]*)?>(.*?)<\/(combooption\s*)>/gisu, ['combooption'], newConfig, accum);
-                break;
-            }
-            case 'gallery': {
-                const { GalleryToken } = require('../gallery');
-                innerToken = new GalleryToken(inner, newConfig, accum);
-                break;
-            }
-            case 'imagemap': {
-                const { ImagemapToken } = require('../imagemap');
-                innerToken = new ImagemapToken(inner, newConfig, accum);
-                break;
-            }
-            // 更多定制扩展的代码示例：
-            // ```
-            // case 'extensionName': {
-            //	const {ExtensionToken}: typeof import('../extension') = require('../extension');
-            //	innerToken = new ExtensionToken(inner, newConfig, accum);
-            //	break;
-            // }
-            // ```
-            default: {
-                const { NowikiToken } = require('../nowiki');
-                innerToken = new NowikiToken(inner, newConfig);
-            }
-        }
-        innerToken.setAttribute('name', lcName).type = 'ext-inner';
-        super(name, attrToken, innerToken, closed, config, accum);
-    }
-    /**
-     * @override
-     * @browser
-     */
-    lint(start = this.getAbsoluteIndex()) {
-        const errors = super.lint(start);
-        if (this.name !== 'nowiki' && this.closest('html-attrs, table-attrs')) {
-            const root = this.getRootNode(), excerpt = String(root).slice(Math.max(0, start - 25), start + 25), rect = { start, ...root.posFromIndex(start) };
-            errors.push({ ...(0, lint_1.generateForSelf)(this, rect, 'extension tag in HTML tag attributes'), excerpt });
-        }
-        return errors;
-    }
-    /** @override */
-    cloneNode() {
-        const inner = this.lastChild.cloneNode(), tags = this.getAttribute('tags'), config = this.getAttribute('config'), attr = String(this.firstChild);
-        return Parser.run(() => {
-            const token = new ExtToken(tags[0], attr, '', this.selfClosing ? undefined : tags[1], config);
-            token.lastChild.safeReplaceWith(inner);
-            return token;
-        });
-    }
-}
-exports.ExtToken = ExtToken;
-Parser.classes['ExtToken'] = __filename;

package/dist/src/tagPair/include.d.ts

@@ -1,43 +0,0 @@
-import * as Parser from '../../index';
-import { TagPairToken } from '.';
-import type { AstText, Token } from '../../internal';
-declare const IncludeToken_base: ((abstract new (...args: any[]) => {
-    text(): string;
-    length: number;
-    toString(omit?: Set<string> | undefined, separator?: string | undefined): string;
-    insertAt(token: unknown, i?: number | undefined): unknown;
-}) & {
-    readonly hidden: true; /** @browser */
-}) & typeof TagPairToken;
-/**
- * `<includeonly>`或`<noinclude>`或`<onlyinclude>`
- * @classdesc `{childNodes: [AstText, AstText]}`
- */
-export declare class IncludeToken extends IncludeToken_base {
-    /** @browser */
-    readonly type = "include";
-    childNodes: [AstText, AstText];
-    abstract get children(): [];
-    abstract get firstChild(): AstText;
-    abstract get firstElementChild(): undefined;
-    abstract get lastChild(): AstText;
-    abstract get lastElementChild(): undefined;
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param inner 内部wikitext
-     * @param closed 是否封闭
-     */
-    constructor(name: string, attr?: string, inner?: string, closed?: string, config?: Parser.Config, accum?: Token[]);
-    /** @override */
-    cloneNode(): this;
-    /**
-     * @override
-     * @param str 新文本
-     */
-    setText(str: string): string;
-    /** 清除标签属性 */
-    removeAttr(): void;
-}
-export {};

package/dist/src/tagPair/include.js

@@ -1,42 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.IncludeToken = void 0;
-const hidden_1 = require("../../mixin/hidden");
-const Parser = require("../../index");
-const _1 = require(".");
-/**
- * `<includeonly>`或`<noinclude>`或`<onlyinclude>`
- * @classdesc `{childNodes: [AstText, AstText]}`
- */
-class IncludeToken extends (0, hidden_1.hidden)(_1.TagPairToken) {
-    /** @browser */
-    type = 'include';
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param inner 内部wikitext
-     * @param closed 是否封闭
-     */
-    constructor(name, attr = '', inner, closed, config = Parser.getConfig(), accum = []) {
-        super(name, attr, inner ?? '', inner === undefined ? closed : closed ?? '', config, accum);
-    }
-    /** @override */
-    cloneNode() {
-        const tags = this.getAttribute('tags'), config = this.getAttribute('config'), inner = this.selfClosing ? undefined : this.lastChild.data, closing = this.selfClosing || !this.closed ? undefined : tags[1];
-        return Parser.run(() => new IncludeToken(tags[0], this.firstChild.data, inner, closing, config));
-    }
-    /**
-     * @override
-     * @param str 新文本
-     */
-    setText(str) {
-        return super.setText(str, 1);
-    }
-    /** 清除标签属性 */
-    removeAttr() {
-        super.setText('');
-    }
-}
-exports.IncludeToken = IncludeToken;
-Parser.classes['IncludeToken'] = __filename;

package/dist/src/tagPair/index.d.ts

@@ -1,57 +0,0 @@
-import * as Parser from '../../index';
-import { Token } from '..';
-import type { AstNodes } from '../../lib/node';
-declare const TagPairToken_base: ((abstract new (...args: any[]) => {
-    removeAt(): never;
-    insertAt(token: string, i?: number | undefined): Parser.AstText;
-    insertAt<T extends Parser.AstNodes>(token: T, i?: number | undefined): T;
-    length: number;
-    toString(omit?: Set<string> | undefined, separator?: string | undefined): string;
-    text(separator?: string | undefined): string;
-}) & {
-    readonly fixed: true;
-}) & typeof Parser.Token;
-/** 成对标签 */
-export declare abstract class TagPairToken extends TagPairToken_base {
-    #private;
-    type: 'ext' | 'include';
-    name: string;
-    childNodes: [AstNodes, AstNodes];
-    abstract get firstChild(): AstNodes;
-    abstract get lastChild(): AstNodes;
-    /**
-     * 是否闭合
-     * @browser
-     */
-    get closed(): boolean;
-    set closed(value: boolean);
-    /** 是否自封闭 */
-    get selfClosing(): boolean;
-    set selfClosing(value: boolean);
-    /** 内部wikitext */
-    get innerText(): string | undefined;
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param inner 内部wikitext
-     * @param closed 是否封闭；约定`undefined`表示自封闭，`''`表示未闭合
-     */
-    constructor(name: string, attr: string | Token, inner: string | Token, closed?: string, config?: Parser.Config, accum?: Token[]);
-    /**
-     * @override
-     * @browser
-     */
-    toString(omit?: Set<string>): string;
-    /**
-     * @override
-     * @browser
-     */
-    text(): string;
-    /**
-     * @override
-     * @browser
-     */
-    print(): string;
-}
-export {};

package/dist/src/tagPair/index.js

@@ -1,107 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TagPairToken = void 0;
-const fixed_1 = require("../../mixin/fixed");
-const Parser = require("../../index");
-const __1 = require("..");
-/** 成对标签 */
-class TagPairToken extends (0, fixed_1.fixed)(__1.Token) {
-    /** @browser */
-    #selfClosing;
-    /** @browser */
-    #closed;
-    /** @browser */
-    #tags;
-    /**
-     * 是否闭合
-     * @browser
-     */
-    get closed() {
-        return this.#closed;
-    }
-    set closed(value) {
-        this.#closed ||= value;
-    }
-    /** 是否自封闭 */
-    get selfClosing() {
-        return this.#selfClosing;
-    }
-    set selfClosing(value) {
-        if (value !== this.#selfClosing && this.lastChild.text()) {
-            Parser.warn(`<${this.name}>标签内部的${value ? '文本将被隐藏' : '原有文本将再次可见'}！`);
-        }
-        this.#selfClosing = value;
-    }
-    /** 内部wikitext */
-    get innerText() {
-        return this.#selfClosing ? undefined : this.lastChild.text();
-    }
-    /**
-     * @browser
-     * @param name 标签名
-     * @param attr 标签属性
-     * @param inner 内部wikitext
-     * @param closed 是否封闭；约定`undefined`表示自封闭，`''`表示未闭合
-     */
-    constructor(name, attr, inner, closed, config = Parser.getConfig(), accum = []) {
-        super(undefined, config, true);
-        this.setAttribute('name', name.toLowerCase());
-        this.#tags = [name, closed || name];
-        this.#selfClosing = closed === undefined;
-        this.#closed = closed !== '';
-        this.append(attr, inner);
-        const index = typeof attr === 'string' ? -1 : accum.indexOf(attr);
-        accum.splice(index === -1 ? Infinity : index, 0, this);
-    }
-    /**
-     * @override
-     * @browser
-     */
-    toString(omit) {
-        const { firstChild, lastChild, nextSibling, name, closed } = this, [opening, closing] = this.#tags;
-        if (omit && this.matchesTypes(omit)) {
-            return '';
-        }
-        else if (!closed && nextSibling) {
-            Parser.error(`自动闭合 <${name}>`, lastChild);
-            this.#closed = true;
-        }
-        return this.#selfClosing
-            ? `<${opening}${firstChild.toString(omit)}/>`
-            : `<${opening}${firstChild.toString(omit)}>${lastChild.toString(omit)}${this.closed ? `</${closing}>` : ''}`;
-    }
-    /**
-     * @override
-     * @browser
-     */
-    text() {
-        const [opening, closing] = this.#tags;
-        return this.#selfClosing
-            ? `<${opening}${this.firstChild.text()}/>`
-            : `<${opening}${super.text('>')}${this.closed ? `</${closing}>` : ''}`;
-    }
-    /** @private */
-    getPadding() {
-        return this.#tags[0].length + 1;
-    }
-    /** @private */
-    getGaps(i) {
-        return i === 0 ? 1 : 1;
-    }
-    /**
-     * @override
-     * @browser
-     */
-    print() {
-        const [opening, closing] = this.#tags;
-        return super.print(this.#selfClosing
-            ? { pre: `&lt;${opening}`, post: '/&gt;' }
-            : { pre: `&lt;${opening}`, sep: '&gt;', post: this.closed ? `&lt;/${closing}&gt;` : '' });
-    }
-    /** @private */
-    getAttribute(key) {
-        return key === 'tags' ? [...this.#tags] : super.getAttribute(key);
-    }
-}
-exports.TagPairToken = TagPairToken;
-Parser.classes['TagPairToken'] = __filename;

package/dist/src/transclude.d.ts

@@ -1,201 +0,0 @@
-import * as Parser from '../index';
-import { Token } from '.';
-import { ParameterToken } from './parameter';
-import { AtomToken } from './atom';
-import { SyntaxToken } from './syntax';
-import type { LintError } from '../index';
-/**
- * 模板或魔术字
- * @classdesc `{childNodes: [AtomToken|SyntaxToken, ...AtomToken, ...ParameterToken]}`
- */
-export declare class TranscludeToken extends Token {
-    #private;
-    /** @browser */
-    type: 'template' | 'magic-word';
-    name: string;
-    /** @browser */
-    modifier: string;
-    childNodes: [AtomToken | SyntaxToken, ...Token[]];
-    abstract get firstChild(): AtomToken | SyntaxToken;
-    abstract get firstElementChild(): AtomToken | SyntaxToken;
-    abstract get lastChild(): AtomToken | SyntaxToken | ParameterToken;
-    abstract get lastElementChild(): AtomToken | SyntaxToken | ParameterToken;
-    /** 是否存在重复参数 */
-    get duplication(): boolean;
-    /**
-     * @browser
-     * @param title 模板标题或魔术字
-     * @param parts 参数各部分
-     * @throws `SyntaxError` 非法的模板名称
-     */
-    constructor(title: string, parts: ([string] | [string | number, string])[], config?: Parser.Config, accum?: Token[]);
-    /**
-     * 设置引用修饰符
-     * @browser
-     * @param modifier 引用修饰符
-     */
-    setModifier(modifier: string): boolean;
-    /**
-     * 是否是模板
-     * @browser
-     */
-    isTemplate(): boolean;
-    /**
-     * @override
-     * @browser
-     */
-    toString(omit?: Set<string>): string;
-    /**
-     * @override
-     * @browser
-     */
-    text(): string;
-    /**
-     * @override
-     * @browser
-     */
-    lint(start?: number): LintError[];
-    /**
-     * @override
-     * @browser
-     * @param token 待插入的子节点
-     * @param i 插入位置
-     */
-    insertAt<T extends ParameterToken>(token: T, i?: number): T;
-    /**
-     * 获取所有参数
-     * @browser
-     */
-    getAllArgs(): ParameterToken[];
-    /**
-     * 获取匿名参数
-     * @browser
-     */
-    getAnonArgs(): ParameterToken[];
-    /**
-     * 获取指定参数
-     * @browser
-     * @param key 参数名
-     * @param exact 是否匹配匿名性
-     * @param copy 是否返回一个备份
-     */
-    getArgs(key: string | number, exact?: boolean, copy?: boolean): Set<ParameterToken>;
-    /**
-     * 获取重名参数
-     * @browser
-     * @throws `Error` 仅用于模板
-     */
-    getDuplicatedArgs(): [string, ParameterToken[]][];
-    /**
-     * 对特定魔术字获取可能的取值
-     * @browser
-     * @throws `Error` 不是可接受的魔术字
-     */
-    getPossibleValues(): Token[];
-    /**
-     * @override
-     * @browser
-     */
-    print(): string;
-    /** @override */
-    cloneNode(): this;
-    /** 替换引用 */
-    subst(): void;
-    /** 安全的替换引用 */
-    safesubst(): void;
-    /**
-     * @override
-     * @param i 移除位置
-     */
-    removeAt(i: number): ParameterToken;
-    /**
-     * 是否具有某参数
-     * @param key 参数名
-     * @param exact 是否匹配匿名性
-     */
-    hasArg(key: string | number, exact?: boolean): boolean;
-    /**
-     * 获取生效的指定参数
-     * @param key 参数名
-     * @param exact 是否匹配匿名性
-     */
-    getArg(key: string | number, exact?: boolean): ParameterToken | undefined;
-    /**
-     * 移除指定参数
-     * @param key 参数名
-     * @param exact 是否匹配匿名性
-     */
-    removeArg(key: string | number, exact?: boolean): void;
-    /** 获取所有参数名 */
-    getKeys(): string[];
-    /**
-     * 获取参数值
-     * @param key 参数名
-     */
-    getValues(key: string | number): string[];
-    /** 获取所有生效的参数值 */
-    getValue(): Record<string, string>;
-    /**
-     * 获取生效的指定参数值
-     * @param key 参数名
-     */
-    getValue(key: string | number): string | undefined;
-    /**
-     * 插入匿名参数
-     * @param val 参数值
-     * @throws `SyntaxError` 非法的匿名参数
-     */
-    newAnonArg(val: string): ParameterToken;
-    /**
-     * 设置参数值
-     * @param key 参数名
-     * @param value 参数值
-     * @throws `Error` 仅用于模板
-     * @throws `SyntaxError` 非法的命名参数
-     */
-    setValue(key: string, value: string): void;
-    /**
-     * 将匿名参数改写为命名参数
-     * @throws `Error` 仅用于模板
-     */
-    anonToNamed(): void;
-    /**
-     * 替换模板名
-     * @param title 模板名
-     * @throws `Error` 仅用于模板
-     * @throws `SyntaxError` 非法的模板名称
-     */
-    replaceTemplate(title: string): void;
-    /**
-     * 替换模块名
-     * @param title 模块名
-     * @throws `Error` 仅用于模块
-     * @throws `SyntaxError` 非法的模块名称
-     */
-    replaceModule(title: string): void;
-    /**
-     * 替换模块函数
-     * @param func 模块函数名
-     * @throws `Error` 仅用于模块
-     * @throws `Error` 尚未指定模块名称
-     * @throws `SyntaxError` 非法的模块函数名
-     */
-    replaceFunction(func: string): void;
-    /**
-     * 是否存在重名参数
-     * @throws `Error` 仅用于模板
-     */
-    hasDuplicatedArgs(): number;
-    /**
-     * 修复重名参数：
-     * `aggressive = false`时只移除空参数和全同参数，优先保留匿名参数，否则将所有匿名参数更改为命名。
-     * `aggressive = true`时还会尝试处理连续的以数字编号的参数。
-     * @param aggressive 是否使用有更大风险的修复手段
-     */
-    fixDuplication(aggressive?: boolean): string[];
-    /**
-     * 转义模板内的表格
-     * @throws `Error` 转义失败
-     */
-    escapeTables(): TranscludeToken;
-}