wikiparser-node 1.0.2-b → 1.0.3

package/dist/src/table/base.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableBaseToken = void 0;
+const debug_1 = require("../../util/debug");
+const constants_1 = require("../../util/constants");
+const attributesParent_1 = require("../../mixin/attributesParent");
+const Parser = require("../../index");
+const index_1 = require("../index");
+const syntax_1 = require("../syntax");
+const attributes_1 = require("../attributes");
+/* NOT FOR BROWSER */
+/**
+ * 转义表格语法
+ * @param syntax 表格语法节点
+ */
+const escapeTable = (syntax) => {
+    const wikitext = syntax.childNodes.map(child => child.type === 'text'
+        ? child.data.replaceAll('|', '{{!}}')
+        : String(child)).join(''), { childNodes } = Parser.parse(wikitext, syntax.getAttribute('include'), 2, syntax.getAttribute('config'));
+    syntax.replaceChildren(...childNodes);
+};
+/* NOT FOR BROWSER END */
+/**
+ * 表格行，含开头的换行，不含结尾的换行
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ...Token]}`
+ */
+class TableBaseToken extends (0, attributesParent_1.attributesParent)(index_1.Token, 1) {
+    /**
+     * @param pattern 表格语法正则
+     * @param syntax 表格语法
+     * @param attr 表格属性
+     */
+    constructor(pattern, syntax, attr, config = Parser.getConfig(), accum = [], acceptable = {}) {
+        super(undefined, config, accum, acceptable);
+        this.append(new syntax_1.SyntaxToken(syntax, pattern, 'table-syntax', config, accum, {
+            'Stage-1': ':', '!ExtToken': '', TranscludeToken: ':',
+        }), new attributes_1.AttributesToken(attr, 'table-attrs', this.type, config, accum));
+        this.protectChildren(0, 1);
+    }
+    /* NOT FOR BROWSER */
+    /** @override */
+    cloneNode() {
+        const [syntax, attr, ...cloned] = this.cloneChildNodes();
+        return debug_1.Shadow.run(() => {
+            const { constructor } = this, token = new constructor(undefined, undefined, this.getAttribute('config'));
+            token.firstChild.safeReplaceWith(syntax);
+            token.childNodes[1].safeReplaceWith(attr);
+            if (token.type === 'td') { // TdToken
+                token.childNodes[2].safeReplaceWith(cloned[0]);
+            }
+            else {
+                token.append(...cloned);
+            }
+            return token;
+        });
+    }
+    /** 转义表格语法 */
+    escape() {
+        for (const child of this.childNodes) {
+            if (child instanceof syntax_1.SyntaxToken) {
+                escapeTable(child);
+            }
+            else if (child instanceof TableBaseToken) {
+                child.escape();
+            }
+        }
+    }
+    /** @private */
+    setSyntax(syntax, esc = false) {
+        const { firstChild } = this;
+        firstChild.replaceChildren(syntax);
+        if (esc) {
+            escapeTable(firstChild);
+        }
+    }
+}
+exports.TableBaseToken = TableBaseToken;
+constants_1.classes['TableBaseToken'] = __filename;

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

@@ -0,0 +1,229 @@
+import * as Parser from '../../index';
+import { TrBaseToken } from './trBase';
+import { SyntaxToken } from '../syntax';
+import type { LintError } from '../../index';
+import type { AttributesToken, TdToken, TrToken, Token } from '../../internal';
+import type { TableCoords } from './trBase';
+import type { TdAttrs, TdSubtypes } from './td';
+import type { Layout } from '../../addon/table';
+export interface TableRenderedCoords {
+    row?: undefined;
+    column?: undefined;
+    x: number;
+    y: number;
+}
+/**
+ * 表格
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken, ...TrToken, ?SyntaxToken]}`
+ */
+export declare class TableToken extends TrBaseToken {
+    readonly type = "table";
+    childNodes: [SyntaxToken, AttributesToken, ...(TdToken | TrToken)[], SyntaxToken] | [SyntaxToken, AttributesToken, ...(TdToken | TrToken)[]];
+    abstract get children(): [SyntaxToken, AttributesToken, ...(TdToken | TrToken)[], SyntaxToken] | [SyntaxToken, AttributesToken, ...(TdToken | TrToken)[]];
+    abstract get lastChild(): AttributesToken | TdToken | TrToken | SyntaxToken;
+    abstract get lastElementChild(): AttributesToken | TdToken | TrToken | SyntaxToken;
+    /** 表格是否闭合 */
+    get closed(): boolean;
+    set closed(closed: boolean);
+    /**
+     * @param syntax 表格语法
+     * @param attr 表格属性
+     */
+    constructor(syntax: string, attr?: string, config?: Parser.Config, accum?: Token[]);
+    /** @override */
+    lint(start?: number): LintError[];
+    /**
+     * 闭合表格语法
+     * @param syntax 表格结尾语法
+     * @param halfParsed
+     */
+    close(syntax?: string, halfParsed?: boolean): void;
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     * @throws `SyntaxError` 表格的闭合部分非法
+     */
+    insertAt<T extends Token>(token: T, i?: number): T;
+    /** @override */
+    getRowCount(): number;
+    /** 获取下一行 */
+    getNextRow(): TrToken | undefined;
+    /**
+     * 获取第n行
+     * @param n 行号
+     * @param force 是否将表格自身视为第一行
+     * @param insert 是否用于判断插入新行的位置
+     * @throws `RangeError` 不存在该行
+     */
+    getNthRow(n: number, force?: boolean, insert?: false): TrToken | this | undefined;
+    /** @ignore */
+    getNthRow(n: number, force: boolean, insert: true): TrToken | this | SyntaxToken | undefined;
+    /** 获取所有行 */
+    getAllRows(): (TrToken | this)[];
+    /**
+     * 获取指定坐标的单元格
+     * @param coords 表格坐标
+     */
+    getNthCell(coords: TableCoords | TableRenderedCoords): TdToken | undefined;
+    /**
+     * 获取表格布局
+     * @param stop 中止条件
+     * @param stop.row 中止行
+     * @param stop.column 中止列
+     * @param stop.x 中止行
+     * @param stop.y 中止列
+     */
+    getLayout(stop?: {
+        row?: number;
+        column?: number;
+        x?: number;
+        y?: number;
+    }): Layout;
+    /** 打印表格布局 */
+    printLayout(): void;
+    /**
+     * 转换为渲染后的表格坐标
+     * @param {TableCoords} coord wikitext中的表格坐标
+     */
+    toRenderedCoords(coord: TableCoords): TableRenderedCoords | undefined;
+    /**
+     * 转换为wikitext中的表格坐标
+     * @param {TableRenderedCoords} coord 渲染后的表格坐标
+     */
+    toRawCoords(coord: TableRenderedCoords): TableCoords | undefined;
+    /**
+     * 获取完整行
+     * @param y 行号
+     */
+    getFullRow(y: number): Map<TdToken, boolean>;
+    /**
+     * 获取完整列
+     * @param x 列号
+     */
+    getFullCol(x: number): Map<TdToken, boolean>;
+    /**
+     * 设置行格式
+     * @param y 行号
+     * @param attr 表格属性
+     * @param multiRow 是否对所有单元格设置，或是仅对行首单元格设置
+     */
+    formatTableRow(y: number, attr?: TdAttrs | string, multiRow?: boolean): void;
+    /**
+     * 设置列格式
+     * @param x 列号
+     * @param attr 表格属性
+     * @param multiCol 是否对所有单元格设置，或是仅对行首单元格设置
+     */
+    formatTableCol(x: number, attr?: TdAttrs | string, multiCol?: boolean): void;
+    /**
+     * 填补表格行
+     * @param y 行号
+     * @param inner 填充内容
+     * @param subtype 单元格类型
+     * @param attr 表格属性
+     */
+    fillTableRow(y: number, inner: string | Token, subtype?: TdSubtypes, attr?: TdAttrs): void;
+    /**
+     * 填补表格
+     * @param inner 填充内容
+     * @param subtype 单元格类型
+     * @param attr 表格属性
+     */
+    fillTable(inner: string | Token, subtype?: TdSubtypes, attr?: TdAttrs): void;
+    /**
+     * @override
+     * @param inner 单元格内部wikitext
+     * @param coords 单元格坐标
+     * @param subtype 单元格类型
+     * @param attr 单元格属性
+     * @throws `RangeError` 指定的坐标不是单元格起始点
+     */
+    insertTableCell(inner: string | Token, coords: TableCoords | TableRenderedCoords, subtype?: TdSubtypes, attr?: TdAttrs): TdToken;
+    /**
+     * 插入表格行
+     * @param y 行号
+     * @param attr 表格行属性
+     * @param inner 内部wikitext
+     * @param subtype 单元格类型
+     * @param innerAttr 单元格属性
+     */
+    insertTableRow(y: number, attr?: Record<string, string | true>, inner?: string | Token, subtype?: TdSubtypes, innerAttr?: TdAttrs): TrToken;
+    /**
+     * 插入表格列
+     * @param x 列号
+     * @param inner 内部wikitext
+     * @param subtype 单元格类型
+     * @param attr 单元格属性
+     * @throws `RangeError` 列号过大
+     */
+    insertTableCol(x: number, inner: string | Token, subtype?: TdSubtypes, attr?: TdAttrs): void;
+    /**
+     * 移除表格行
+     * @param y 行号
+     */
+    removeTableRow(y: number): TrToken;
+    /**
+     * 移除表格列
+     * @param x 列号
+     */
+    removeTableCol(x: number): void;
+    /**
+     * 合并单元格
+     * @param xlim 列范围
+     * @param ylim 行范围
+     * @throws `RangeError` 待合并区域与外侧区域有重叠
+     */
+    mergeCells(xlim: [number, number], ylim: [number, number]): TdToken;
+    /**
+     * 分裂成多行
+     * @param coords 单元格坐标
+     */
+    splitIntoRows(coords: TableCoords | TableRenderedCoords): void;
+    /**
+     * 分裂成多列
+     * @param coords 单元格坐标
+     */
+    splitIntoCols(coords: TableCoords | TableRenderedCoords): void;
+    /**
+     * 分裂成单元格
+     * @param coords 单元格坐标
+     */
+    splitIntoCells(coords: TableCoords | TableRenderedCoords): void;
+    /**
+     * 复制一行并插入该行之前
+     * @param row 行号
+     */
+    replicateTableRow(row: number): TrToken;
+    /**
+     * 复制一列并插入该列之前
+     * @param x 列号
+     */
+    replicateTableCol(x: number): TdToken[];
+    /**
+     * 移动表格行
+     * @param y 行号
+     * @param before 新位置
+     * @throws `RangeError` 无法移动
+     */
+    moveTableRowBefore(y: number, before: number): TrToken;
+    /**
+     * 移动表格行
+     * @param y 行号
+     * @param after 新位置
+     * @throws `RangeError` 无法移动
+     */
+    moveTableRowAfter(y: number, after: number): TrToken;
+    /**
+     * 移动表格列
+     * @param x 列号
+     * @param before 新位置
+     */
+    moveTableColBefore(x: number, before: number): void;
+    /**
+     * 移动表格列
+     * @param x 列号
+     * @param after 新位置
+     */
+    moveTableColAfter(x: number, after: number): void;
+}

package/dist/src/table/index.js

@@ -0,0 +1,364 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TableToken = void 0;
+const lint_1 = require("../../util/lint");
+const string_1 = require("../../util/string");
+const debug_1 = require("../../util/debug");
+const constants_1 = require("../../util/constants");
+const Parser = require("../../index");
+const trBase_1 = require("./trBase");
+const syntax_1 = require("../syntax");
+const closingPattern = /^\n[^\S\n]*(?:\|\}|\{\{\s*!\s*\}\}\}|\{\{\s*!\)\s*\}\})$/u;
+/**
+ * 表格
+ * @classdesc `{childNodes: [SyntaxToken, AttributesToken, ?Token, ...TdToken, ...TrToken, ?SyntaxToken]}`
+ */
+// @ts-expect-error not implementing all abstract methods
+class TableToken extends trBase_1.TrBaseToken {
+    type = 'table';
+    /** 表格是否闭合 */
+    get closed() {
+        return this.lastChild.type === 'table-syntax';
+    }
+    /* NOT FOR BROWSER */
+    set closed(closed) {
+        if (closed && !this.closed) {
+            this.close(this.closest('parameter') ? '\n{{!}}}' : '\n|}');
+        }
+    }
+    /* NOT FOR BROWSER END */
+    /**
+     * @param syntax 表格语法
+     * @param attr 表格属性
+     */
+    constructor(syntax, attr, config = Parser.getConfig(), accum = []) {
+        super(/^(?:\{\||\{\{\{\s*!\s*\}\}|\{\{\s*\(!\s*\}\})$/u, syntax, attr, config, accum, {
+            Token: 2, SyntaxToken: [0, -1], AttributesToken: 1, TdToken: '2:', TrToken: '2:',
+        });
+    }
+    /** @override */
+    lint(start = this.getAbsoluteIndex()) {
+        const errors = super.lint(start);
+        if (!this.closed) {
+            const { firstChild, lastChild: tr, } = this, { lastChild } = tr, error = (0, lint_1.generateForChild)(firstChild, { start }, 'unclosed table');
+            errors.push({ ...error, excerpt: String(lastChild?.type === 'td' ? lastChild : tr).slice(0, 50) });
+        }
+        return errors;
+    }
+    /**
+     * 闭合表格语法
+     * @param syntax 表格结尾语法
+     * @param halfParsed
+     */
+    close(syntax = '\n|}', halfParsed = false) {
+        const config = this.getAttribute('config'), accum = this.getAttribute('accum'), inner = halfParsed ? [syntax] : Parser.parse(syntax, this.getAttribute('include'), 2, config).childNodes;
+        if (!(this.lastChild instanceof syntax_1.SyntaxToken)) {
+            const token = debug_1.Shadow.run(() => super.insertAt(new syntax_1.SyntaxToken(undefined, closingPattern, 'table-syntax', config, accum, {
+                'Stage-1': ':', '!ExtToken': '', TranscludeToken: ':',
+            })));
+            if (!halfParsed) {
+                token.afterBuild();
+            }
+        }
+        this.lastChild.replaceChildren(...inner);
+    }
+    /* NOT FOR BROWSER */
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     * @throws `SyntaxError` 表格的闭合部分非法
+     */
+    insertAt(token, i = this.length) {
+        const previous = this.childNodes.at(i - 1);
+        if (typeof token !== 'string' && token.type === 'td' && previous?.type === 'tr') {
+            Parser.warn('改为将单元格插入当前行。');
+            return previous.insertAt(token);
+        }
+        else if (i > 0 && token instanceof syntax_1.SyntaxToken && token.getAttribute('pattern') !== closingPattern) {
+            throw new SyntaxError(`表格的闭合部分不符合语法：${(0, string_1.noWrap)(String(token))}`);
+        }
+        return super.insertAt(token, i);
+    }
+    /** @override */
+    getRowCount() {
+        return super.getRowCount() + this.childNodes.filter(child => child.type === 'tr' && child.getRowCount()).length;
+    }
+    /** 获取下一行 */
+    getNextRow() {
+        return this.getNthRow(super.getRowCount() ? 1 : 0, false, false);
+    }
+    /** @ignore */
+    getNthRow(n, force = false, insert = false) {
+        const nRows = this.getRowCount(), isRow = super.getRowCount();
+        n += n < 0 ? nRows : 0;
+        if (n === 0 && (isRow || force && nRows === 0)) {
+            return this;
+        }
+        else if (n < 0 || n > nRows || n === nRows && !insert) {
+            throw new RangeError(`不存在第 ${n} 行！`);
+        }
+        else if (isRow) {
+            n--;
+        }
+        for (const child of this.childNodes.slice(2)) {
+            if (child.type === 'tr' && child.getRowCount()) {
+                n--;
+                if (n < 0) {
+                    return child;
+                }
+            }
+            else if (child.type === 'table-syntax') {
+                return child;
+            }
+        }
+        return undefined;
+    }
+    /** 获取所有行 */
+    getAllRows() {
+        return [
+            ...super.getRowCount() ? [this] : [],
+            ...this.childNodes.slice(1).filter(child => child.type === 'tr' && child.getRowCount()),
+        ];
+    }
+    /**
+     * 获取指定坐标的单元格
+     * @param coords 表格坐标
+     */
+    getNthCell(coords) {
+        require('../../addon/table');
+        return this.getNthCell(coords);
+    }
+    /**
+     * 获取表格布局
+     * @param stop 中止条件
+     * @param stop.row 中止行
+     * @param stop.column 中止列
+     * @param stop.x 中止行
+     * @param stop.y 中止列
+     */
+    getLayout(stop) {
+        require('../../addon/table');
+        return this.getLayout(stop);
+    }
+    /** 打印表格布局 */
+    printLayout() {
+        require('../../addon/table');
+        this.printLayout();
+    }
+    /**
+     * 转换为渲染后的表格坐标
+     * @param {TableCoords} coord wikitext中的表格坐标
+     */
+    toRenderedCoords(coord) {
+        require('../../addon/table');
+        return this.toRenderedCoords(coord);
+    }
+    /**
+     * 转换为wikitext中的表格坐标
+     * @param {TableRenderedCoords} coord 渲染后的表格坐标
+     */
+    toRawCoords(coord) {
+        require('../../addon/table');
+        return this.toRawCoords(coord);
+    }
+    /**
+     * 获取完整行
+     * @param y 行号
+     */
+    getFullRow(y) {
+        require('../../addon/table');
+        return this.getFullRow(y);
+    }
+    /**
+     * 获取完整列
+     * @param x 列号
+     */
+    getFullCol(x) {
+        require('../../addon/table');
+        return this.getFullCol(x);
+    }
+    /**
+     * 设置行格式
+     * @param y 行号
+     * @param attr 表格属性
+     * @param multiRow 是否对所有单元格设置，或是仅对行首单元格设置
+     */
+    formatTableRow(y, attr = {}, multiRow = false) {
+        require('../../addon/table');
+        this.formatTableRow(y, attr, multiRow);
+    }
+    /**
+     * 设置列格式
+     * @param x 列号
+     * @param attr 表格属性
+     * @param multiCol 是否对所有单元格设置，或是仅对行首单元格设置
+     */
+    formatTableCol(x, attr = {}, multiCol = false) {
+        require('../../addon/table');
+        this.formatTableCol(x, attr, multiCol);
+    }
+    /**
+     * 填补表格行
+     * @param y 行号
+     * @param inner 填充内容
+     * @param subtype 单元格类型
+     * @param attr 表格属性
+     */
+    fillTableRow(y, inner, subtype = 'td', attr = {}) {
+        require('../../addon/table');
+        this.fillTableRow(y, inner, subtype, attr);
+    }
+    /**
+     * 填补表格
+     * @param inner 填充内容
+     * @param subtype 单元格类型
+     * @param attr 表格属性
+     */
+    fillTable(inner, subtype = 'td', attr = {}) {
+        require('../../addon/table');
+        this.fillTable(inner, subtype, attr);
+    }
+    /**
+     * @override
+     * @param inner 单元格内部wikitext
+     * @param coords 单元格坐标
+     * @param subtype 单元格类型
+     * @param attr 单元格属性
+     * @throws `RangeError` 指定的坐标不是单元格起始点
+     */
+    insertTableCell(inner, coords, subtype = 'td', attr = {}) {
+        require('../../addon/table');
+        return this.insertTableCell(inner, coords, subtype, attr);
+    }
+    /**
+     * 插入表格行
+     * @param y 行号
+     * @param attr 表格行属性
+     * @param inner 内部wikitext
+     * @param subtype 单元格类型
+     * @param innerAttr 单元格属性
+     */
+    insertTableRow(y, attr = {}, inner, subtype = 'td', innerAttr = {}) {
+        require('../../addon/table');
+        return this.insertTableRow(y, attr, inner, subtype, innerAttr);
+    }
+    /**
+     * 插入表格列
+     * @param x 列号
+     * @param inner 内部wikitext
+     * @param subtype 单元格类型
+     * @param attr 单元格属性
+     * @throws `RangeError` 列号过大
+     */
+    insertTableCol(x, inner, subtype = 'td', attr = {}) {
+        require('../../addon/table');
+        this.insertTableCol(x, inner, subtype, attr);
+    }
+    /**
+     * 移除表格行
+     * @param y 行号
+     */
+    removeTableRow(y) {
+        require('../../addon/table');
+        return this.removeTableRow(y);
+    }
+    /**
+     * 移除表格列
+     * @param x 列号
+     */
+    removeTableCol(x) {
+        require('../../addon/table');
+        this.removeTableCol(x);
+    }
+    /**
+     * 合并单元格
+     * @param xlim 列范围
+     * @param ylim 行范围
+     * @throws `RangeError` 待合并区域与外侧区域有重叠
+     */
+    mergeCells(xlim, ylim) {
+        require('../../addon/table');
+        return this.mergeCells(xlim, ylim);
+    }
+    /**
+     * 分裂成多行
+     * @param coords 单元格坐标
+     */
+    splitIntoRows(coords) {
+        require('../../addon/table');
+        this.splitIntoRows(coords);
+    }
+    /**
+     * 分裂成多列
+     * @param coords 单元格坐标
+     */
+    splitIntoCols(coords) {
+        require('../../addon/table');
+        this.splitIntoCols(coords);
+    }
+    /**
+     * 分裂成单元格
+     * @param coords 单元格坐标
+     */
+    splitIntoCells(coords) {
+        require('../../addon/table');
+        this.splitIntoCells(coords);
+    }
+    /**
+     * 复制一行并插入该行之前
+     * @param row 行号
+     */
+    replicateTableRow(row) {
+        require('../../addon/table');
+        return this.replicateTableRow(row);
+    }
+    /**
+     * 复制一列并插入该列之前
+     * @param x 列号
+     */
+    replicateTableCol(x) {
+        require('../../addon/table');
+        return this.replicateTableCol(x);
+    }
+    /**
+     * 移动表格行
+     * @param y 行号
+     * @param before 新位置
+     * @throws `RangeError` 无法移动
+     */
+    moveTableRowBefore(y, before) {
+        require('../../addon/table');
+        return this.moveTableRowBefore(y, before);
+    }
+    /**
+     * 移动表格行
+     * @param y 行号
+     * @param after 新位置
+     * @throws `RangeError` 无法移动
+     */
+    moveTableRowAfter(y, after) {
+        require('../../addon/table');
+        return this.moveTableRowAfter(y, after);
+    }
+    /**
+     * 移动表格列
+     * @param x 列号
+     * @param before 新位置
+     */
+    moveTableColBefore(x, before) {
+        require('../../addon/table');
+        this.moveTableColBefore(x, before);
+    }
+    /**
+     * 移动表格列
+     * @param x 列号
+     * @param after 新位置
+     */
+    moveTableColAfter(x, after) {
+        require('../../addon/table');
+        this.moveTableColAfter(x, after);
+    }
+}
+exports.TableToken = TableToken;
+constants_1.classes['TableToken'] = __filename;