wikiparser-node 1.4.3-b → 1.4.4

package/dist/src/table/td.d.ts

@@ -0,0 +1,92 @@
+import Parser from '../../index';
+import { Token } from '../index';
+import { TableBaseToken } from './base';
+import type { LintError, AST } from '../../base';
+import type { SyntaxToken, AttributesToken, TrToken, TableToken } from '../../internal';
+export type TdSubtypes = 'td' | 'th' | 'caption';
+export interface TdSpanAttrs {
+    rowspan?: number;
+    colspan?: number;
+}
+declare type TdAttrGetter<T extends string> = T extends keyof TdSpanAttrs ? number : string | true | undefined;
+declare type TdAttrSetter<T extends string> = T extends keyof TdSpanAttrs ? number : string | boolean;
+export type TdAttrs = Record<string, string | true> & TdSpanAttrs;
+/**
+ * `<td>`、`<th>`和`<caption>`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, Token]}`
+ */
+export declare abstract class TdToken extends TableBaseToken {
+    #private;
+    readonly type = "td";
+    readonly childNodes: readonly [SyntaxToken, AttributesToken, Token];
+    abstract get parentNode(): TrToken | TableToken | undefined;
+    abstract get nextSibling(): this | TrToken | SyntaxToken | undefined;
+    abstract get previousSibling(): Token | undefined;
+    abstract get children(): [SyntaxToken, AttributesToken, Token];
+    abstract get parentElement(): TrToken | TableToken | undefined;
+    abstract get nextElementSibling(): this | TrToken | SyntaxToken | undefined;
+    /** 单元格类型 */
+    get subtype(): TdSubtypes;
+    set subtype(subtype: TdSubtypes);
+    /** rowspan */
+    get rowspan(): number;
+    set rowspan(rowspan: number);
+    /** colspan */
+    get colspan(): number;
+    set colspan(colspan: number);
+    /** 内部wikitext */
+    get innerText(): string;
+    set innerText(text: string);
+    /**
+     * @param syntax 单元格语法
+     * @param inner 内部wikitext
+     */
+    constructor(syntax: string, inner?: string, config?: Parser.Config, accum?: Token[]);
+    /** @override */
+    text(): string;
+    /** @override */
+    lint(start?: number): LintError[];
+    /** @override */
+    print(): string;
+    /** @override */
+    json(): AST;
+    /** 是否位于行首 */
+    isIndependent(): boolean;
+    /** @override */
+    cloneNode(): this;
+    /**
+     * @override
+     * @param syntax 表格语法
+     * @param esc 是否需要转义
+     */
+    setSyntax(syntax: string, esc?: boolean): void;
+    /** 改为独占一行 */
+    independence(): void;
+    /**
+     * @override
+     * @param key 属性键
+     */
+    getAttr<T extends string>(key: T): TdAttrGetter<T>;
+    /** @override */
+    getAttrs(): TdAttrs;
+    /**
+     * @override
+     * @param key 属性键
+     * @param value 属性值
+     * @param prop 属性对象
+     */
+    setAttr<T extends string>(key: T, value: TdAttrSetter<T>): void;
+    setAttr(prop: Record<string, string | number | boolean>): void;
+    /** @override */
+    escape(): void;
+}
+/**
+ * 创建新的单元格
+ * @param inner 内部wikitext
+ * @param subtype 单元格类型
+ * @param attr 单元格属性
+ * @param include 是否嵌入
+ * @param config
+ */
+export declare const createTd: (inner: string | Token, subtype?: TdSubtypes, attr?: TdAttrs, include?: boolean, config?: Parser.Config) => TdToken;
+export {};

package/dist/src/table/td.js

@@ -0,0 +1,337 @@
+"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.createTd = exports.TdToken = void 0;
+const lint_1 = require("../../util/lint");
+const constants_1 = require("../../util/constants");
+const debug_1 = require("../../util/debug");
+const fixed_1 = require("../../mixin/fixed");
+const index_1 = require("../../index");
+const index_2 = require("../index");
+const base_1 = require("./base");
+/**
+ * `<td>`、`<th>`和`<caption>`
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, Token]}`
+ */
+let TdToken = (() => {
+    var _a;
+    let _classDecorators = [fixed_1.fixedToken];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = base_1.TableBaseToken;
+    var TdToken = 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);
+            TdToken = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        type = 'td';
+        #innerSyntax = '';
+        /* NOT FOR BROWSER END */
+        /** 单元格类型 */
+        get subtype() {
+            return this.#getSyntax().subtype;
+        }
+        /* NOT FOR BROWSER */
+        set subtype(subtype) {
+            this.setSyntax(subtype);
+        }
+        /** rowspan */
+        get rowspan() {
+            return this.getAttr('rowspan');
+        }
+        set rowspan(rowspan) {
+            this.setAttr('rowspan', rowspan);
+        }
+        /** colspan */
+        get colspan() {
+            return this.getAttr('colspan');
+        }
+        set colspan(colspan) {
+            this.setAttr('colspan', colspan);
+        }
+        /** 内部wikitext */
+        get innerText() {
+            return this.lastChild.text();
+        }
+        set innerText(text) {
+            this.lastChild.replaceChildren(...index_1.default.parse(text, true, undefined, this.getAttribute('config')).childNodes);
+        }
+        /* NOT FOR BROWSER END */
+        /**
+         * @param syntax 单元格语法
+         * @param inner 内部wikitext
+         */
+        constructor(syntax, inner, config = index_1.default.getConfig(), accum = []) {
+            let innerSyntax = /\||\0\d+!\x7F/u.exec(inner ?? ''), attr = innerSyntax ? inner.slice(0, innerSyntax.index) : '';
+            if (/\[\[|-\{/u.test(attr)) {
+                innerSyntax = null;
+                attr = '';
+            }
+            super(/^(?:\n[^\S\n]*(?:[|!]|\|\+|\{\{\s*!\s*\}\}\+?)|(?:\||\{\{\s*!\s*\}\}){2}|!!|\{\{\s*!!\s*\}\})$/u, syntax, attr, config, accum, { SyntaxToken: 0, AttributesToken: 1, Token: 2 });
+            if (innerSyntax) {
+                [this.#innerSyntax] = innerSyntax;
+            }
+            const innerToken = new index_2.Token(inner?.slice((innerSyntax?.index ?? NaN) + this.#innerSyntax.length), config, accum);
+            innerToken.type = 'td-inner';
+            innerToken.setAttribute('stage', 4);
+            this.insertAt(innerToken);
+        }
+        /** 表格语法信息 */
+        #getSyntax() {
+            const syntax = this.firstChild.text(), 
+            /* NOT FOR BROWSER */
+            esc = syntax.includes('{{'), 
+            /* NOT FOR BROWSER END */
+            char = syntax.slice(-1);
+            let subtype = 'td';
+            if (char === '!') {
+                subtype = 'th';
+            }
+            else if (char === '+') {
+                subtype = 'caption';
+            }
+            if (this.isIndependent()) {
+                return {
+                    subtype,
+                    /* NOT FOR BROWSER */
+                    escape: esc,
+                    correction: false,
+                };
+            }
+            /* NOT FOR BROWSER */
+            const { previousSibling } = this;
+            if (!(previousSibling instanceof TdToken)) {
+                return { subtype, escape: esc, correction: true };
+            }
+            const result = previousSibling.#getSyntax(), str = String(previousSibling.lastChild);
+            result.escape ||= esc;
+            result.correction = str.includes('\n') && debug_1.Shadow.run(() => {
+                const config = this.getAttribute('config'), include = this.getAttribute('include');
+                return String(new index_2.Token(str, config).parseOnce(0, include).parseOnce()).includes('\n');
+            });
+            if (subtype === 'th' && result.subtype !== 'th') {
+                result.subtype = 'th';
+                result.correction = true;
+            }
+            return result;
+        }
+        /** @private */
+        afterBuild() {
+            if (this.#innerSyntax.includes('\0')) {
+                this.#innerSyntax = this.buildFromStr(this.#innerSyntax, constants_1.BuildMethod.String);
+            }
+        }
+        /** @private */
+        toString() {
+            /* NOT FOR BROWSER */
+            this.#correct();
+            /* NOT FOR BROWSER END */
+            const { childNodes: [syntax, attr, inner] } = this;
+            return `${String(syntax)}${String(attr)}${this.#innerSyntax}${String(inner)}`;
+        }
+        /** @override */
+        text() {
+            /* NOT FOR BROWSER */
+            this.#correct();
+            /* NOT FOR BROWSER END */
+            const { childNodes: [syntax, attr, inner] } = this;
+            return `${syntax.text()}${attr.text()}${this.#innerSyntax}${inner.text()}`;
+        }
+        /** @private */
+        getGaps(i) {
+            if (i === 1) {
+                /* NOT FOR BROWSER */
+                this.#correct();
+                /* NOT FOR BROWSER END */
+                return this.#innerSyntax.length;
+            }
+            return 0;
+        }
+        /** @override */
+        lint(start = this.getAbsoluteIndex()) {
+            const errors = super.lint(start);
+            start += this.getRelativeIndex(this.length - 1);
+            for (const child of this.lastChild.childNodes) {
+                if (child.type === 'text') {
+                    const { data } = child;
+                    if (data.includes('|')) {
+                        errors.push((0, lint_1.generateForChild)(child, { start }, 'additional "|" in a table cell', data.includes('||') ? 'error' : 'warning'));
+                    }
+                }
+            }
+            return errors;
+        }
+        /** @override */
+        print() {
+            const { childNodes: [syntax, attr, inner] } = this;
+            return `<span class="wpb-td">${syntax.print()}${attr.print()}${this.#innerSyntax}${inner.print()}</span>`;
+        }
+        /** @override */
+        json() {
+            const json = super.json();
+            json['subtype'] = this.subtype;
+            return json;
+        }
+        /* NOT FOR BROWSER */
+        /** 是否位于行首 */
+        isIndependent() {
+            return this.firstChild.text().startsWith('\n');
+        }
+        /** @override */
+        cloneNode() {
+            const token = super.cloneNode();
+            token.setAttribute('innerSyntax', this.#innerSyntax);
+            return token;
+        }
+        /** @private */
+        getAttribute(key) {
+            return key === 'innerSyntax' ? this.#innerSyntax : super.getAttribute(key);
+        }
+        /** @private */
+        setAttribute(key, value) {
+            if (key === 'innerSyntax') {
+                this.#innerSyntax = value ?? '';
+            }
+            else {
+                super.setAttribute(key, value);
+            }
+        }
+        /**
+         * @override
+         * @param syntax 表格语法
+         * @param esc 是否需要转义
+         */
+        setSyntax(syntax, esc = false) {
+            const aliases = { td: '\n|', th: '\n!', caption: '\n|+' };
+            super.setSyntax(aliases[syntax] ?? syntax, esc);
+        }
+        /** 修复\<td\>语法 */
+        #correct() {
+            if (String(this.childNodes[1])) {
+                this.#innerSyntax ||= '|';
+            }
+            const { subtype, escape, correction } = this.#getSyntax();
+            if (correction) {
+                this.setSyntax(subtype, escape);
+            }
+        }
+        /** 改为独占一行 */
+        independence() {
+            if (!this.isIndependent()) {
+                const { subtype, escape } = this.#getSyntax();
+                this.setSyntax(subtype, escape);
+            }
+        }
+        /**
+         * @override
+         * @param key 属性键
+         */
+        getAttr(key) {
+            const value = super.getAttr(key);
+            key = key.toLowerCase().trim();
+            return (key === 'rowspan' || key === 'colspan' ? Number(value) || 1 : value);
+        }
+        /** @override */
+        getAttrs() {
+            const attr = super.getAttrs();
+            if ('rowspan' in attr) {
+                attr.rowspan = Number(attr.rowspan);
+            }
+            if ('colspan' in attr) {
+                attr.colspan = Number(attr.colspan);
+            }
+            return attr;
+        }
+        setAttr(keyOrProp, value) {
+            if (typeof keyOrProp !== 'string') {
+                for (const [key, val] of Object.entries(keyOrProp)) {
+                    this.setAttr(key, val);
+                }
+                return;
+            }
+            const key = keyOrProp.toLowerCase().trim();
+            let v;
+            if (typeof value === 'number' && (key === 'rowspan' || key === 'colspan')) {
+                v = value === 1 ? false : String(value);
+            }
+            else {
+                v = value;
+            }
+            super.setAttr(key, v);
+            if (!String(this.childNodes[1])) {
+                this.#innerSyntax = '';
+            }
+        }
+        /** @override */
+        escape() {
+            super.escape();
+            if (String(this.childNodes[1])) {
+                this.#innerSyntax ||= '{{!}}';
+            }
+            if (this.#innerSyntax === '|') {
+                this.#innerSyntax = '{{!}}';
+            }
+        }
+    };
+    return TdToken = _classThis;
+})();
+exports.TdToken = TdToken;
+/* NOT FOR BROWSER */
+/**
+ * 创建新的单元格
+ * @param inner 内部wikitext
+ * @param subtype 单元格类型
+ * @param attr 单元格属性
+ * @param include 是否嵌入
+ * @param config
+ */
+const createTd = (inner, subtype = 'td', attr = {}, include = false, config = index_1.default.getConfig()) => {
+    const innerToken = typeof inner === 'string' ? index_1.default.parse(inner, include, undefined, config) : inner, 
+    // @ts-expect-error abstract class
+    token = debug_1.Shadow.run(() => new TdToken('\n|', undefined, config));
+    token.setSyntax(subtype);
+    token.lastChild.safeReplaceWith(innerToken);
+    token.setAttr(attr);
+    return token;
+};
+exports.createTd = createTd;
+/* NOT FOR BROWSER END */
+constants_1.classes['TdToken'] = __filename;

package/dist/src/table/tr.d.ts

@@ -0,0 +1,32 @@
+import Parser from '../../index';
+import { TrBaseToken } from './trBase';
+import type { Token, TdToken, TableToken, SyntaxToken, AttributesToken } from '../../internal';
+/**
+ * 表格行，含开头的换行，不含结尾的换行
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken]}`
+ */
+export declare abstract class TrToken extends TrBaseToken {
+    #private;
+    readonly type = "tr";
+    readonly childNodes: readonly [SyntaxToken, AttributesToken, ...TdToken[]];
+    abstract get lastChild(): AttributesToken | TdToken;
+    abstract get parentNode(): TableToken | undefined;
+    abstract get nextSibling(): this | SyntaxToken | undefined;
+    abstract get previousSibling(): Token;
+    abstract get children(): [SyntaxToken, AttributesToken, ...TdToken[]];
+    abstract get lastElementChild(): AttributesToken | TdToken;
+    abstract get parentElement(): TableToken | undefined;
+    abstract get nextElementSibling(): this | SyntaxToken | undefined;
+    abstract get previousElementSibling(): Token;
+    /**
+     * @param syntax 表格语法
+     * @param attr 表格属性
+     */
+    constructor(syntax: string, attr?: string, config?: Parser.Config, accum?: Token[]);
+    /** @override */
+    text(): string;
+    /** 获取下一行 */
+    getNextRow(): TrToken | undefined;
+    /** 获取前一行 */
+    getPreviousRow(): TrToken | undefined;
+}

package/dist/src/table/tr.js

@@ -0,0 +1,58 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrToken = void 0;
+const constants_1 = require("../../util/constants");
+const index_1 = require("../../index");
+const trBase_1 = require("./trBase");
+/**
+ * 表格行，含开头的换行，不含结尾的换行
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken]}`
+ */
+class TrToken extends trBase_1.TrBaseToken {
+    type = 'tr';
+    /* NOT FOR BROWSER END */
+    /**
+     * @param syntax 表格语法
+     * @param attr 表格属性
+     */
+    constructor(syntax, attr, config = index_1.default.getConfig(), accum = []) {
+        super(/^\n[^\S\n]*(?:\|-+|\{\{\s*!\s*\}\}-+|\{\{\s*!-\s*\}\}-*)$/u, syntax, attr, config, accum, {
+            Token: 2, SyntaxToken: 0, AttributesToken: 1, TdToken: '2:',
+        });
+    }
+    /* NOT FOR BROWSER */
+    /** @override */
+    text() {
+        const str = super.text();
+        return str.trim().includes('\n') ? str : '';
+    }
+    /**
+     * 获取相邻行
+     * @param subset 筛选兄弟节点的方法
+     */
+    #getSiblingRow(subset) {
+        const { parentNode } = this;
+        if (!parentNode) {
+            return undefined;
+        }
+        const { childNodes } = parentNode, index = childNodes.indexOf(this);
+        for (const child of subset(childNodes, index)) {
+            if (child instanceof _a && child.getRowCount()) {
+                return child;
+            }
+        }
+        return undefined;
+    }
+    /** 获取下一行 */
+    getNextRow() {
+        return this.#getSiblingRow((childNodes, index) => childNodes.slice(index + 1));
+    }
+    /** 获取前一行 */
+    getPreviousRow() {
+        return this.#getSiblingRow((childNodes, index) => childNodes.slice(0, index).reverse());
+    }
+}
+exports.TrToken = TrToken;
+_a = TrToken;
+constants_1.classes['TrToken'] = __filename;

package/dist/src/table/trBase.d.ts

@@ -0,0 +1,53 @@
+import { Token } from '..';
+import { TableBaseToken } from './base';
+import { TdToken } from './td';
+import type { LintError } from '../../base';
+import type { AstNodes, SyntaxToken, TrToken } from '../../internal';
+import type { TdAttrs, TdSubtypes } from './td';
+export interface TableCoords {
+    readonly row: number;
+    readonly column: number;
+    readonly x?: undefined;
+    readonly y?: undefined;
+    readonly start?: boolean;
+}
+/** 表格行或表格 */
+export declare abstract class TrBaseToken extends TableBaseToken {
+    #private;
+    type: 'table' | 'tr';
+    /** @override */
+    lint(start?: number): LintError[];
+    /** @override */
+    text(): string;
+    /**
+     * @override
+     * @param i 移除位置
+     */
+    removeAt(i: number): AstNodes;
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     */
+    insertAt<T extends Token>(token: T, i?: number): T;
+    /** 获取行数 */
+    getRowCount(): number;
+    /** 获取列数 */
+    getColCount(): number;
+    /**
+     * 获取第n列
+     * @param n 列号
+     * @param insert 是否用于判断插入新列的位置
+     * @throws `RangeError` 不存在对应单元格
+     */
+    getNthCol(n: number, insert?: false): TdToken | undefined;
+    getNthCol(n: number, insert: true): TdToken | TrToken | SyntaxToken | undefined;
+    /**
+     * 插入新的单元格
+     * @param inner 单元格内部wikitext
+     * @param {TableCoords} coord 单元格坐标
+     * @param subtype 单元格类型
+     * @param attr 单元格属性
+     */
+    insertTableCell(inner: string | Token, { column }: TableCoords, subtype?: TdSubtypes, attr?: TdAttrs): TdToken;
+}