wikiparser-node 1.32.0 → 1.34.0

package/dist/src/index.js

@@ -181,6 +181,7 @@ let Token = (() => {
                 'converter-rule-to',
                 'converter-rule-from',
             ];
+            /* istanbul ignore if */
             if (!plainTypes.includes(value)) {
                 throw new RangeError(`"${value}" is not a valid type for ${this.constructor.name}!`);
             }
@@ -222,7 +223,7 @@ let Token = (() => {
             if (n < this.#stage || this.length !== 1 || !this.isPlain()) {
                 return this;
             }
-            else if (this.#stage >= constants_1.MAX_STAGE) {
+            else /* istanbul ignore if */ if (this.#stage >= constants_1.MAX_STAGE) {
                 /* NOt FOR BROWSER */
                 if (this.type === 'root') {
                     index_1.default.error('Fully parsed!');
@@ -285,9 +286,12 @@ let Token = (() => {
                 if (i % 2 === 0) {
                     return s && new text_1.AstText(s);
                 }
-                else if (isNaN(s.slice(-1))) {
-                    return this.#accum[Number(s.slice(0, -1))];
+                const n = Number(s.slice(0, -1));
+                if (isNaN(s.slice(-1))
+                    && Number.isInteger(n) && n >= 0 && n < this.#accum.length) {
+                    return this.#accum[n];
                 }
+                /* istanbul ignore next */
                 throw new Error(`Failed to build! Unrecognized token: ${s}`);
             }).filter(node => node !== '');
             if (type === constants_1.BuildMethod.String) {
@@ -336,7 +340,7 @@ let Token = (() => {
         #parseRedirect() {
             const { parseRedirect } = require('../parser/redirect');
             const wikitext = this.firstChild.toString(), parsed = parseRedirect(wikitext, this.#config, this.#accum);
-            if (parsed) {
+            if (parsed !== false) {
                 this.setText(parsed);
             }
             return Boolean(parsed);
@@ -392,9 +396,6 @@ let Token = (() => {
          * @param tidy 是否整理
          */
         #parseQuotes(tidy) {
-            if (this.#config.excludes.includes('quote')) {
-                return;
-            }
             const { parseQuotes } = require('../parser/quotes');
             const lines = this.firstChild.toString().split('\n');
             for (let i = 0; i < lines.length; i++) {
@@ -404,17 +405,11 @@ let Token = (() => {
         }
         /** 解析外部链接 */
         #parseExternalLinks() {
-            if (this.#config.excludes.includes('extLink')) {
-                return;
-            }
             const { parseExternalLinks } = require('../parser/externalLinks');
             this.setText(parseExternalLinks(this.firstChild.toString(), this.#config, this.#accum));
         }
         /** 解析自由外链 */
         #parseMagicLinks() {
-            if (this.#config.excludes.includes('magicLink')) {
-                return;
-            }
             const { parseMagicLinks } = require('../parser/magicLinks');
             this.setText(parseMagicLinks(this.firstChild.toString(), this.#config, this.#accum));
         }
@@ -453,6 +448,7 @@ let Token = (() => {
                     return this.#accum;
                 case 'built':
                     return this.#built;
+                /* istanbul ignore next */
                 case 'stage':
                     return this.#stage;
                 /* PRINT ONLY */
@@ -490,12 +486,12 @@ let Token = (() => {
             }
         }
         insertAt(child, i = this.length) {
-            const token = typeof child === 'string' ? new text_1.AstText(child) : child;
+            const token = typeof child === 'string' ? new text_1.AstText(child) : child, { length } = this;
+            i += i < 0 ? length : 0;
             /* NOT FOR BROWSER */
             const acceptable = this.getAcceptable();
             if (!debug_1.Shadow.running && acceptable) {
-                const { length, childNodes } = this, nodesAfter = childNodes.slice(i), insertedName = token.constructor.name;
-                i += i < 0 ? length : 0;
+                const nodesAfter = this.childNodes.slice(i), insertedName = token.constructor.name;
                 if (!acceptable[insertedName]?.has(i, length + 1)) {
                     this.constructorError(`cannot insert a ${insertedName} at position ${i}`);
                 }
@@ -510,7 +506,7 @@ let Token = (() => {
             constructor, } = token;
             /* NOT FOR BROWSER */
             const e = new Event('insert', { bubbles: true });
-            this.dispatchEvent(e, { type: 'insert', position: i < 0 ? i + this.length - 1 : i });
+            this.dispatchEvent(e, { type: 'insert', position: i });
             if (type !== 'list-range' && constructor === Token && this.isPlain()) {
                 index_1.default.warn('You are inserting a plain token as a child of another plain token. '
                     + 'Consider calling Token.flatten method afterwards.');
@@ -521,7 +517,14 @@ let Token = (() => {
             }
             return token;
         }
-        /** @private */
+        // eslint-disable-next-line jsdoc/require-param
+        /**
+         * Normalize page title
+         *
+         * 规范化页面标题
+         * @param title title (with or without the namespace prefix) / 标题（含或不含命名空间前缀）
+         * @param defaultNs default namespace number / 命名空间
+         */
         normalizeTitle(title, defaultNs = 0, opt) {
             return index_1.default.normalizeTitle(title, defaultNs, this.getAttribute('include'), this.#config, { page: this.pageName, ...opt });
         }
@@ -582,8 +585,12 @@ let Token = (() => {
                         let mt = regex.exec(wikitext);
                         while (mt) {
                             const { 1: type, index } = mt, detail = mt[2]?.trim();
+                            let line;
+                            if (type === 'disable-line' || type === 'disable-next-line') {
+                                line = this.posFromIndex(index).top + (type === 'disable-line' ? 0 : 1);
+                            }
                             ignores.push({
-                                line: this.posFromIndex(index).top + (type === 'disable-line' ? 0 : 1),
+                                line,
                                 from: type === 'disable' ? regex.lastIndex : undefined,
                                 to: type === 'enable' ? regex.lastIndex : undefined,
                                 rules: detail ? new Set(detail.split(',').map(rule => rule.trim())) : undefined,
@@ -593,13 +600,13 @@ let Token = (() => {
                         errors = errors.filter(({ rule, startLine, startIndex }) => {
                             const nearest = { pos: 0 };
                             for (const { line, from, to, rules } of ignores) {
-                                if (line > startLine + 1) {
+                                if (line && line > startLine + 1) {
                                     break;
                                 }
                                 else if (rules && !rules.has(rule)) {
                                     continue;
                                 }
-                                else if (line === startLine && from === undefined && to === undefined) {
+                                else if (line === startLine) {
                                     return false;
                                 }
                                 else if (from <= startIndex && from > nearest.pos) {
@@ -713,12 +720,14 @@ let Token = (() => {
          */
         safeReplaceWith(token) {
             const { parentNode } = this;
+            /* istanbul ignore next */
             if (!parentNode) {
                 throw new Error('The node does not have a parent node!');
             }
             else if (token.constructor !== this.constructor) {
                 this.typeError('safeReplaceWith', this.constructor.name);
             }
+            /* istanbul ignore next */
             try {
                 strict_1.default.deepEqual(token.getAcceptable(), this.getAcceptable());
             }
@@ -737,6 +746,7 @@ let Token = (() => {
             const e = new Event('replace', { bubbles: true });
             token.dispatchEvent(e, { type: 'replace', position: i, oldToken: this });
         }
+        /* istanbul ignore next */
         /**
          * Create an HTML comment
          *
@@ -797,6 +807,7 @@ let Token = (() => {
          * 深拷贝节点
          */
         cloneNode() {
+            /* istanbul ignore if */
             if (this.constructor !== Token) {
                 this.constructorError('does not specify a cloneNode method');
             }
@@ -813,6 +824,7 @@ let Token = (() => {
                 return token;
             });
         }
+        /* istanbul ignore next */
         /**
          * Get all sections
          *
@@ -831,6 +843,7 @@ let Token = (() => {
         section(n) {
             return this.sections()?.[n];
         }
+        /* istanbul ignore next */
         /**
          * Get the enclosing HTML tags
          *

package/dist/src/link/base.d.ts

@@ -11,7 +11,7 @@ import type { Title } from '../../lib/title';
 export declare abstract class LinkBaseToken extends Token {
     #private;
     readonly name: string;
-    abstract get type(): 'link' | 'category' | 'file' | 'gallery-image' | 'imagemap-image' | 'redirect-target';
+    abstract get type(): 'link' | 'category' | 'file' | 'gallery-image' | 'imagemap-image' | 'redirect-target' | 'ext-inner';
     readonly childNodes: readonly [AtomToken, ...Token[]];
     abstract get firstChild(): AtomToken;
     abstract get lastChild(): Token;

package/dist/src/link/base.js

@@ -137,24 +137,31 @@ let LinkBaseToken = (() => {
             /* NOT FOR BROWSER */
             this.protectChildren(0);
         }
+        /** 更新name */
+        #setName() {
+            if (this.type !== 'ext-inner') {
+                this.setAttribute('name', this.#title.title);
+            }
+        }
         /** @private */
         afterBuild() {
             this.#title = this.getTitle();
             if (this.#delimiter.includes('\0')) {
                 this.#delimiter = this.buildFromStr(this.#delimiter, constants_1.BuildMethod.String);
             }
-            this.setAttribute('name', this.#title.title);
+            this.#setName();
             super.afterBuild();
             /* NOT FOR BROWSER */
             const /** @implements */ linkListener = (e, data) => {
                 const { prevTarget } = e, { type } = this;
-                if (prevTarget?.is('link-target')) {
-                    const name = prevTarget.text(), titleObj = this.getTitle(), { title, interwiki, ns, valid } = titleObj;
+                if (prevTarget?.is('link-target')
+                    && !(this.is('ext-inner') && this.parentNode?.selfClosing)) {
+                    const name = prevTarget.text(), titleObj = this.getTitle(), { interwiki, ns, valid } = titleObj;
                     if (!valid) {
                         (0, debug_1.undo)(e, data);
                         throw new Error(`Invalid link target: ${name}`);
                     }
-                    else if (type === 'category' && (interwiki || ns !== 14)
+                    else if ((type === 'category' || type === 'ext-inner') && (interwiki || ns !== 14)
                         || (type === 'file' || type === 'gallery-image' || type === 'imagemap-image')
                             && (interwiki || ns !== 6)) {
                         (0, debug_1.undo)(e, data);
@@ -171,7 +178,7 @@ let LinkBaseToken = (() => {
                         }
                     }
                     this.#title = titleObj;
-                    this.setAttribute('name', title);
+                    this.#setName();
                 }
             };
             this.addEventListener(['remove', 'insert', 'replace', 'text'], linkListener);

package/dist/src/link/categorytree.d.ts

@@ -0,0 +1,25 @@
+import { LinkBaseToken } from './base';
+import type { Config, LintError } from '../../base';
+import type { Title } from '../../lib/title';
+import type { Token, AtomToken, AttributesToken, ExtToken, AstNodes } from '../../internal';
+/**
+ * `<categorytree>`
+ * @classdesc `{childNodes: [AtomToken]}`
+ */
+export declare abstract class CategorytreeToken extends LinkBaseToken {
+    readonly childNodes: readonly [AtomToken];
+    abstract get lastChild(): AtomToken;
+    abstract get nextSibling(): undefined;
+    abstract get previousSibling(): AttributesToken | undefined;
+    abstract get parentNode(): ExtToken | undefined;
+    abstract get link(): Title;
+    abstract get children(): [AtomToken];
+    abstract get lastElementChild(): AtomToken;
+    abstract get previousElementSibling(): AttributesToken | undefined;
+    abstract get nextElementSibling(): undefined;
+    abstract get parentElement(): ExtToken | undefined;
+    abstract set link(link: string);
+    get type(): 'ext-inner';
+    /** @param link 链接标题 */
+    constructor(link: string, linkText?: undefined, config?: Config, accum?: Token[]);
+}

package/dist/src/link/categorytree.js

@@ -0,0 +1,126 @@
+"use strict";
+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;
+};
+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 __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategorytreeToken = void 0;
+const lint_1 = require("../../util/lint");
+const padded_1 = require("../../mixin/padded");
+const index_1 = __importDefault(require("../../index"));
+const base_1 = require("./base");
+/* NOT FOR BROWSER */
+const constants_1 = require("../../util/constants");
+const cached_1 = require("../../mixin/cached");
+const fixed_1 = require("../../mixin/fixed");
+/* NOT FOR BROWSER END */
+/**
+ * `<categorytree>`
+ * @classdesc `{childNodes: [AtomToken]}`
+ */
+let CategorytreeToken = (() => {
+    let _classDecorators = [fixed_1.fixedToken, (0, padded_1.padded)('')];
+    let _classDescriptor;
+    let _classExtraInitializers = [];
+    let _classThis;
+    let _classSuper = base_1.LinkBaseToken;
+    let _instanceExtraInitializers = [];
+    let _toHtmlInternal_decorators;
+    var CategorytreeToken = class extends _classSuper {
+        static { _classThis = this; }
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _toHtmlInternal_decorators = [(0, cached_1.cached)()];
+            __esDecorate(this, null, _toHtmlInternal_decorators, { kind: "method", name: "toHtmlInternal", static: false, private: false, access: { has: obj => "toHtmlInternal" in obj, get: obj => obj.toHtmlInternal }, metadata: _metadata }, null, _instanceExtraInitializers);
+            __esDecorate(null, _classDescriptor = { value: _classThis }, _classDecorators, { kind: "class", name: _classThis.name, metadata: _metadata }, null, _classExtraInitializers);
+            CategorytreeToken = _classThis = _classDescriptor.value;
+            if (_metadata) Object.defineProperty(_classThis, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+            __runInitializers(_classThis, _classExtraInitializers);
+        }
+        /* NOT FOR BROWSER END */
+        get type() {
+            return 'ext-inner';
+        }
+        /** @param link 链接标题 */
+        constructor(link, linkText, config, accum = []) {
+            super(link, linkText, config, accum);
+            __runInitializers(this, _instanceExtraInitializers);
+            this.setAttribute('bracket', false);
+            /* NOT FOR BROWSER */
+            // @ts-expect-error abstract getter override
+            this.firstChild.setAttribute('acceptable', { AstText: 0 });
+        }
+        /** @private */
+        getTitle() {
+            const target = this.firstChild.toString().trim(), opt = { halfParsed: true }, title = this.normalizeTitle(target, 14, opt);
+            return title.valid && title.ns === 14
+                && !title.interwiki
+                ? title
+                : this.normalizeTitle(`Category:${target}`, 0, opt);
+        }
+        /** @private */
+        lint(start = this.getAbsoluteIndex()) {
+            LINT: {
+                const rule = 'no-ignored', s = index_1.default.lintConfig.getSeverity(rule, 'categorytree');
+                if (s) {
+                    const { link } = this;
+                    if (!link.valid || link.ns !== 14
+                        || link.interwiki) {
+                        return [(0, lint_1.generateForSelf)(this, { start }, rule, 'invalid-category', s)];
+                    }
+                }
+                return super.lint(start, false);
+            }
+        }
+        /* NOT FOR BROWSER */
+        /** @private */
+        toHtmlInternal() {
+            return '';
+        }
+        /** @private */
+        safeReplaceChildren(elements) {
+            if (elements.length === 0) {
+                this.firstChild.replaceChildren();
+            }
+            else {
+                super.safeReplaceChildren(elements);
+            }
+        }
+    };
+    return CategorytreeToken = _classThis;
+})();
+exports.CategorytreeToken = CategorytreeToken;
+constants_1.classes['CategorytreeToken'] = __filename;

package/dist/src/link/file.d.ts

@@ -1,6 +1,6 @@
 import { LinkBaseToken } from './base';
 import { ImageParameterToken } from '../imageParameter';
-import type { Config, LintError, AST } from '../../base';
+import type { TokenTypes, Config, LintError, AST } from '../../base';
 import type { Token, AtomToken } from '../../internal';
 import { Title } from '../../lib/title';
 /**
@@ -45,8 +45,9 @@ export declare abstract class FileToken extends LinkBaseToken {
      * @param link 文件名
      * @param text 图片参数
      * @param delimiter `|`
+     * @param type 节点类型
      */
-    constructor(link: string, text?: string, config?: Config, accum?: Token[], delimiter?: string);
+    constructor(link: string, text?: string, config?: Config, accum?: Token[], delimiter?: string, type?: TokenTypes);
     /**
      * Get all image parameter tokens
      *

package/dist/src/link/file.js

@@ -173,8 +173,9 @@ let FileToken = (() => {
          * @param link 文件名
          * @param text 图片参数
          * @param delimiter `|`
+         * @param type 节点类型
          */
-        constructor(link, text, config, accum = [], delimiter = '|') {
+        constructor(link, text, config, accum = [], delimiter = '|', type) {
             super(link, undefined, config, accum, delimiter);
             __runInitializers(this, _instanceExtraInitializers);
             /* NOT FOR BROWSER */
@@ -184,7 +185,7 @@ let FileToken = (() => {
             /-\{|\}-|\|/gu; // eslint-disable-line @typescript-eslint/no-unused-expressions
             this.safeAppend(explode(text).map(
             // @ts-expect-error abstract class
-            (part) => new imageParameter_1.ImageParameterToken(part, extension, config, accum)));
+            (part) => new imageParameter_1.ImageParameterToken(part, extension, type, config, accum)));
         }
         /** @private */
         lint(start = this.getAbsoluteIndex(), re) {
@@ -470,7 +471,7 @@ let FileToken = (() => {
             }
             const parameter = debug_1.Shadow.run(() => 
             // @ts-expect-error abstract class
-            new imageParameter_1.ImageParameterToken(syntax.replace('$1', key === 'width' ? '1' : ''), this.extension, config));
+            new imageParameter_1.ImageParameterToken(syntax.replace('$1', key === 'width' ? '1' : ''), this.extension, this.type, config));
             if (free) {
                 const { childNodes } = index_1.default.parseWithRef(value, this);
                 parameter.safeReplaceChildren(childNodes);

package/dist/src/link/galleryImage.js

@@ -99,9 +99,10 @@ let GalleryImageToken = (() => {
                 }
                 accum.splice(length, 1);
             }
-            super(link, token?.firstChild.toString(), config, accum);
+            const privateType = `${type}-image`;
+            super(link, token?.firstChild.toString(), config, accum, undefined, privateType);
             this.setAttribute('bracket', false);
-            this.privateType = `${type}-image`;
+            this.privateType = privateType;
             /* PRINT ONLY */
             this.seal('privateType', true);
         }
@@ -112,11 +113,9 @@ let GalleryImageToken = (() => {
         }
         /** 判定无效的图片 */
         #lint() {
-            const { ns, 
-            /* NOT FOR BROWSER */
-            interwiki, } = this.getAttribute('title');
-            return ns !== 6
-                || Boolean(interwiki);
+            const title = this.getAttribute('title');
+            return title.ns !== 6
+                || Boolean(title.interwiki);
         }
         /** @private */
         lint(start = this.getAbsoluteIndex(), re) {

package/dist/src/multiLine/gallery.d.ts

@@ -4,9 +4,7 @@ import { CommentLineToken } from '../nowiki/commentLine';
 import type { Config, LintError, AST } from '../../base';
 import type { AstText, Token, AstNodes } from '../../internal';
 /**
- * gallery tag
- *
- * gallery标签
+ * `<gallery>`
  * @classdesc `{childNodes: (GalleryImageToken|CommentLineToken|AstText)[]}`
  */
 export declare abstract class GalleryToken extends MultiLineToken {
@@ -36,7 +34,6 @@ export declare abstract class GalleryToken extends MultiLineToken {
     get heights(): number;
     /** @param inner 标签内部wikitext */
     constructor(inner?: string, config?: Config, accum?: Token[]);
-    cloneNode(): this;
     /**
      * Insert an image
      *

package/dist/src/multiLine/gallery.js

@@ -47,26 +47,20 @@ const commentLine_1 = require("../nowiki/commentLine");
 const debug_1 = require("../../util/debug");
 const constants_1 = require("../../util/constants");
 const html_1 = require("../../util/html");
-const clone_1 = require("../../mixin/clone");
 const cached_1 = require("../../mixin/cached");
 /* NOT FOR BROWSER END */
 /**
- * gallery tag
- *
- * gallery标签
+ * `<gallery>`
  * @classdesc `{childNodes: (GalleryImageToken|CommentLineToken|AstText)[]}`
  */
 let GalleryToken = (() => {
     let _classSuper = index_2.MultiLineToken;
     let _instanceExtraInitializers = [];
-    let _cloneNode_decorators;
     let _toHtmlInternal_decorators;
     return class GalleryToken extends _classSuper {
         static {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
-            _cloneNode_decorators = [clone_1.clone];
             _toHtmlInternal_decorators = [(0, cached_1.cached)()];
-            __esDecorate(this, null, _cloneNode_decorators, { kind: "method", name: "cloneNode", static: false, private: false, access: { has: obj => "cloneNode" in obj, get: obj => obj.cloneNode }, metadata: _metadata }, null, _instanceExtraInitializers);
             __esDecorate(this, null, _toHtmlInternal_decorators, { kind: "method", name: "toHtmlInternal", static: false, private: false, access: { has: obj => "toHtmlInternal" in obj, get: obj => obj.toHtmlInternal }, metadata: _metadata }, null, _instanceExtraInitializers);
             if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         }
@@ -194,10 +188,6 @@ let GalleryToken = (() => {
         }
         /* PRINT ONLY END */
         /* NOT FOR BROWSER */
-        cloneNode() {
-            // @ts-expect-error abstract class
-            return new GalleryToken(undefined, this.getAttribute('config'));
-        }
         /**
          * Insert an image
          *

package/dist/src/multiLine/imagemap.d.ts

@@ -21,5 +21,4 @@ export declare abstract class ImagemapToken extends MultiLineToken {
     get image(): GalleryImageToken | undefined;
     /** @param inner 标签内部wikitext */
     constructor(inner?: string, config?: Parser.Config, accum?: Token[]);
-    cloneNode(): this;
 }