wikiparser-node 1.13.0-b → 1.13.0

package/dist/src/arg.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArgToken = void 0;
+const string_1 = require("../util/string");
+const lint_1 = require("../util/lint");
+const rect_1 = require("../lib/rect");
+const index_1 = require("../index");
+const index_2 = require("./index");
+const atom_1 = require("./atom");
+const hidden_1 = require("./hidden");
+/* NOT FOR BROWSER */
+const constants_1 = require("../util/constants");
+const debug_1 = require("../util/debug");
+const html_1 = require("../util/html");
+/* NOT FOR BROWSER END */
+/**
+ * `{{{}}}`包裹的参数
+ * @classdesc `{childNodes: [AtomToken, ?Token, ...HiddenToken]}`
+ */
+class ArgToken extends index_2.Token {
+    /* NOT FOR BROWSER END */
+    get type() {
+        return 'arg';
+    }
+    /** 预设值 */
+    get default() {
+        return this.childNodes[1]?.text() ?? false;
+    }
+    /* NOT FOR BROWSER */
+    set default(value) {
+        this.setDefault(value);
+    }
+    /* NOT FOR BROWSER END */
+    /** @param parts 以'|'分隔的各部分 */
+    constructor(parts, config = index_1.default.getConfig(), accum = []) {
+        super(undefined, config, accum, {
+            AtomToken: 0, Token: 1, HiddenToken: '2:',
+        });
+        for (const [i, part] of parts.entries()) {
+            if (i === 0) {
+                const token = new atom_1.AtomToken(part, 'arg-name', config, accum, {
+                    'Stage-2': ':', '!HeadingToken': '',
+                });
+                super.insertAt(token);
+            }
+            else if (i > 1) {
+                const token = new hidden_1.HiddenToken(part, config, accum);
+                super.insertAt(token);
+            }
+            else {
+                const token = new index_2.Token(part, config, accum);
+                token.type = 'arg-default';
+                token.setAttribute('stage', 2);
+                super.insertAt(token);
+            }
+        }
+        /* NOT FOR BROWSER */
+        this.protectChildren(0);
+    }
+    /** @private */
+    toString(skip) {
+        return `{{{${super.toString(skip, '|')}}}}`;
+    }
+    /** @private */
+    text() {
+        return `{{{${(0, string_1.text)(this.childNodes.slice(0, 2), '|')}}}}`;
+    }
+    /** @private */
+    getAttribute(key) {
+        return key === 'padding' ? 3 : super.getAttribute(key);
+    }
+    /** @private */
+    getGaps() {
+        return 1;
+    }
+    /** 设置name */
+    #setName() {
+        this.setAttribute('name', this.firstChild.toString(true).trim());
+    }
+    /** @private */
+    afterBuild() {
+        this.#setName();
+        super.afterBuild();
+        /* NOT FOR BROWSER */
+        const /** @implements */ argListener = ({ prevTarget }) => {
+            if (prevTarget === this.firstChild) {
+                this.#setName();
+            }
+        };
+        this.addEventListener(['remove', 'insert', 'replace', 'text'], argListener);
+    }
+    /** @private */
+    lint(start = this.getAbsoluteIndex(), re) {
+        const { childNodes: [argName, argDefault, ...rest] } = this;
+        if (!this.getAttribute('include')) {
+            const e = (0, lint_1.generateForSelf)(this, { start }, 'no-arg', 'unexpected template argument');
+            if (argDefault) {
+                e.fix = { range: [start, e.endIndex], text: argDefault.text() };
+            }
+            return [e];
+        }
+        const errors = argName.lint(start + 3, re);
+        if (argDefault) {
+            errors.push(...argDefault.lint(start + 4 + argName.toString().length, re));
+        }
+        if (rest.length > 0) {
+            const rect = new rect_1.BoundingRect(this, start);
+            errors.push(...rest.map(child => {
+                const e = (0, lint_1.generateForChild)(child, rect, 'no-ignored', 'invisible content inside triple braces');
+                e.startIndex--;
+                e.startCol--;
+                e.suggestions = [
+                    {
+                        desc: 'remove',
+                        range: [e.startIndex, e.endIndex],
+                        text: '',
+                    },
+                    {
+                        desc: 'escape',
+                        range: [e.startIndex, e.startIndex + 1],
+                        text: '{{!}}',
+                    },
+                ];
+                return e;
+            }));
+        }
+        return errors;
+    }
+    /** @private */
+    print() {
+        return super.print({ pre: '{{{', post: '}}}', sep: '|' });
+    }
+    /* NOT FOR BROWSER */
+    cloneNode() {
+        const [name, ...cloned] = this.cloneChildNodes();
+        return debug_1.Shadow.run(() => {
+            // @ts-expect-error abstract class
+            const token = new ArgToken([''], this.getAttribute('config'));
+            token.firstChild.safeReplaceWith(name);
+            token.append(...cloned);
+            return token;
+        });
+    }
+    /** 移除无效部分 */
+    removeRedundant() {
+        debug_1.Shadow.run(() => {
+            for (let i = this.length - 1; i > 1; i--) {
+                super.removeAt(i);
+            }
+        });
+    }
+    /**
+     * @override
+     * @param i 移除位置
+     */
+    removeAt(i) {
+        if (i === 1) {
+            this.removeRedundant();
+        }
+        return super.removeAt(i);
+    }
+    /**
+     * @override
+     * @param token 待插入的子节点
+     * @param i 插入位置
+     */
+    insertAt(token, i = this.length) {
+        i += i < 0 ? this.length : 0;
+        if (debug_1.Shadow.running) {
+            //
+        }
+        else if (i > 1) {
+            this.constructorError('cannot insert redundant child nodes');
+        }
+        else if (typeof token === 'string') {
+            this.constructorError('cannot insert text nodes');
+        }
+        super.insertAt(token, i);
+        if (i === 1) {
+            token.type = 'arg-default';
+        }
+        return token;
+    }
+    /**
+     * 设置参数名
+     * @param name 新参数名
+     */
+    setName(name) {
+        const { childNodes } = index_1.default.parse(name, this.getAttribute('include'), 2, this.getAttribute('config'));
+        this.firstChild.replaceChildren(...childNodes);
+    }
+    /**
+     * 设置预设值
+     * @param value 预设值
+     */
+    setDefault(value) {
+        if (value === false) {
+            this.removeAt(1);
+            return;
+        }
+        const root = index_1.default.parse(value, this.getAttribute('include'), undefined, this.getAttribute('config')), { childNodes: [, oldDefault] } = this;
+        if (oldDefault) {
+            oldDefault.replaceChildren(...root.childNodes);
+        }
+        else {
+            root.type = 'arg-default';
+            this.insertAt(root);
+        }
+    }
+    /** @private */
+    toHtmlInternal(nowrap, nocc) {
+        if (this.length === 1) {
+            const html = (0, html_1.font)(this, this.toString());
+            return nowrap ? html.replaceAll('\n', ' ') : html;
+        }
+        return (0, html_1.font)(this, this.childNodes[1].toHtmlInternal(nowrap, nocc));
+    }
+}
+exports.ArgToken = ArgToken;
+constants_1.classes['ArgToken'] = __filename;

package/dist/src/atom.d.ts

@@ -0,0 +1,14 @@
+import { Token } from './index';
+import type { Config } from '../base';
+declare const atomTypes: readonly ["arg-name", "attr-key", "attr-value", "ext-attr-dirty", "html-attr-dirty", "table-attr-dirty", "converter-flag", "converter-rule-variant", "converter-rule-to", "converter-rule-from", "invoke-function", "invoke-module", "template-name", "link-target", "param-line"];
+declare type AtomTypes = typeof atomTypes[number];
+/** 不会被继续解析的plain Token */
+export declare class AtomToken extends Token {
+    #private;
+    get type(): AtomTypes;
+    set type(value: AtomTypes);
+    /** @class */
+    constructor(wikitext: string | undefined, type: AtomTypes, config?: Config, accum?: Token[], acceptable?: Acceptable);
+    cloneNode(): this;
+}
+export {};

package/dist/src/atom.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AtomToken = void 0;
+const index_1 = require("./index");
+/* NOT FOR BROWSER */
+const debug_1 = require("../util/debug");
+const constants_1 = require("../util/constants");
+/* NOT FOR BROWSER END */
+const atomTypes = [
+    'arg-name',
+    'attr-key',
+    'attr-value',
+    'ext-attr-dirty',
+    'html-attr-dirty',
+    'table-attr-dirty',
+    'converter-flag',
+    'converter-rule-variant',
+    'converter-rule-to',
+    'converter-rule-from',
+    'invoke-function',
+    'invoke-module',
+    'template-name',
+    'link-target',
+    'param-line',
+];
+/** 不会被继续解析的plain Token */
+class AtomToken extends index_1.Token {
+    #type;
+    get type() {
+        return this.#type;
+    }
+    set type(value) {
+        if (!atomTypes.includes(value)) {
+            throw new RangeError(`"${value}" is not a valid type for AtomToken!`);
+        }
+        this.#type = value;
+    }
+    /** @class */
+    constructor(wikitext, type, config, accum, acceptable) {
+        super(wikitext, config, accum, acceptable);
+        this.#type = type;
+    }
+    /* NOT FOR BROWSER */
+    cloneNode() {
+        const cloned = this.cloneChildNodes(), config = this.getAttribute('config'), acceptable = this.getAcceptable();
+        return debug_1.Shadow.run(() => {
+            const token = new AtomToken(undefined, this.type, config, [], acceptable);
+            token.append(...cloned);
+            return token;
+        });
+    }
+}
+exports.AtomToken = AtomToken;
+constants_1.classes['AtomToken'] = __filename;

package/dist/src/attribute.d.ts

@@ -0,0 +1,64 @@
+import Parser from '../index';
+import { Token } from './index';
+import { AtomToken } from './atom';
+import type { LintError } from '../base';
+import type { AttributesToken } from '../internal';
+export type AttributeTypes = 'ext-attr' | 'html-attr' | 'table-attr';
+/**
+ * 扩展和HTML标签属性
+ * @classdesc `{childNodes: [AtomToken, Token|AtomToken]}`
+ */
+export declare abstract class AttributeToken extends Token {
+    #private;
+    readonly name: string;
+    readonly childNodes: readonly [AtomToken, Token];
+    abstract get firstChild(): AtomToken;
+    abstract get lastChild(): Token;
+    abstract get parentNode(): AttributesToken | undefined;
+    abstract get nextSibling(): AtomToken | this | undefined;
+    abstract get previousSibling(): AtomToken | this | undefined;
+    abstract get children(): [AtomToken, Token];
+    abstract get firstElementChild(): AtomToken;
+    abstract get lastElementChild(): Token;
+    abstract get parentElement(): AttributesToken | undefined;
+    abstract get nextElementSibling(): AtomToken | this | undefined;
+    abstract get previousElementSibling(): AtomToken | this | undefined;
+    get type(): AttributeTypes;
+    /** 标签名 */
+    get tag(): string;
+    /** 引号是否匹配 */
+    get balanced(): boolean;
+    set balanced(value: boolean);
+    /** getValue()的getter */
+    get value(): string | true;
+    set value(value: string | true);
+    /**
+     * @param type 标签类型
+     * @param tag 标签名
+     * @param key 属性名
+     * @param equal 等号
+     * @param value 属性值
+     * @param quotes 引号
+     */
+    constructor(type: AttributeTypes, tag: string, key: string, equal?: string, value?: string, quotes?: readonly [string?, string?], config?: Parser.Config, accum?: Token[]);
+    /** 获取属性值 */
+    getValue(): string | true;
+    cloneNode(): this;
+    /** 转义等号 */
+    escape(): void;
+    /** 闭合引号 */
+    close(): void;
+    /**
+     * 设置属性值
+     * @param value 参数值
+     * @throws `RangeError` 扩展标签属性不能包含 ">"
+     * @throws `RangeError` 同时包含单引号和双引号
+     */
+    setValue(value: string | boolean): void;
+    /**
+     * 修改属性名
+     * @param key 新属性名
+     * @throws `Error` title和alt属性不能更名
+     */
+    rename(key: string): void;
+}