wikiparser-node 1.31.0 → 1.32.0

package/dist/lib/element.d.ts

@@ -38,12 +38,6 @@ export declare abstract class AstElement extends AstNode {
     /** all templates and modules / 所有模板和模块 */
     get embeds(): TranscludeToken[];
     constructor();
-    /**
-     * Merge adjacent text child nodes
-     *
-     * 合并相邻的文本子节点
-     */
-    normalize(): void;
     /**
      * Remove a child node
      *
@@ -113,13 +107,19 @@ export declare abstract class AstElement extends AstNode {
      * @param start
      */
     json(file?: string, start?: number): AST;
+    /**
+     * Merge adjacent text child nodes
+     *
+     * 合并相邻的文本子节点
+     */
+    normalize(): void;
     /**
      * Check if the current element matches the selector
      *
      * 检查是否符合选择器
      * @param selector selector / 选择器
      */
-    matches<T>(selector?: string): this is T;
+    matches<T>(selector: string): this is T;
     /**
      * Insert a batch of child nodes at the start
      *

package/dist/lib/element.js

@@ -40,7 +40,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AstElement = void 0;
 const string_1 = require("../util/string");
 const debug_1 = require("../util/debug");
-const selector_1 = require("../parser/selector");
+const selector_1 = require("../util/selector");
 const node_1 = require("./node");
 const elementLike_1 = require("../mixin/elementLike");
 /* NOT FOR BROWSER */
@@ -130,45 +130,6 @@ let AstElement = (() => {
         text(separator) {
             return (0, string_1.text)(this.childNodes, separator);
         }
-        /**
-         * Merge adjacent text child nodes
-         *
-         * 合并相邻的文本子节点
-         */
-        normalize() {
-            const childNodes = this.getChildNodes();
-            /**
-             * 移除子节点
-             * @param i 移除位置
-             */
-            const remove = (i) => {
-                /* NOT FOR BROWSER */
-                childNodes[i].setAttribute('parentNode', undefined);
-                /* NOT FOR BROWSER END */
-                childNodes.splice(i, 1);
-                childNodes[i - 1]?.setAttribute('nextSibling', childNodes[i]);
-                childNodes[i]?.setAttribute('previousSibling', childNodes[i - 1]);
-            };
-            for (let i = childNodes.length - 1; i >= 0; i--) {
-                const { type, data } = childNodes[i];
-                if (type !== 'text' || childNodes.length === 1 || this.getGaps(i - (i && 1))) {
-                    //
-                }
-                else if (data === '') {
-                    remove(i);
-                    /* NOT FOR BROWSER */
-                }
-                else {
-                    const prev = childNodes[i - 1];
-                    if (prev?.type === 'text') {
-                        prev.setAttribute('data', prev.data + data);
-                        remove(i);
-                    }
-                    /* NOT FOR BROWSER END */
-                }
-            }
-            this.setAttribute('childNodes', childNodes);
-        }
         /**
          * Remove a child node
          *
@@ -246,7 +207,7 @@ let AstElement = (() => {
                 for (let i = this.length - 1; i >= 0; i--) {
                     this.removeAt(i);
                 }
-                this.safeAppend(elements);
+                this.safeAppend([...elements]);
             }
         }
         /**
@@ -359,15 +320,17 @@ let AstElement = (() => {
         }
         /** @private */
         print(opt = {}) {
-            const cl = opt.class;
-            if (this.toString()) {
-                return (cl === ''
-                    ? ''
-                    : `<span class="wpb-${cl ?? this.type}${this.getAttribute('invalid') ? ' wpb-invalid' : ''}">`)
-                    + (0, string_1.print)(this.childNodes, opt)
-                    + (cl === '' ? '' : '</span>');
+            PRINT: {
+                const cl = opt.class;
+                if (this.toString()) {
+                    return (cl === ''
+                        ? ''
+                        : `<span class="wpb-${cl ?? this.type}${this.getAttribute('invalid') ? ' wpb-invalid' : ''}">`)
+                        + (0, string_1.print)(this.childNodes, opt)
+                        + (cl === '' ? '' : '</span>');
+                }
+                return '';
             }
-            return '';
         }
         /**
          * Save in JSON format
@@ -402,6 +365,41 @@ let AstElement = (() => {
             }
         }
         /* NOT FOR BROWSER */
+        /**
+         * Merge adjacent text child nodes
+         *
+         * 合并相邻的文本子节点
+         */
+        normalize() {
+            const childNodes = this.getChildNodes();
+            /**
+             * 移除子节点
+             * @param i 移除位置
+             */
+            const remove = (i) => {
+                childNodes[i].setAttribute('parentNode', undefined);
+                childNodes.splice(i, 1);
+                childNodes[i - 1]?.setAttribute('nextSibling', childNodes[i]);
+                childNodes[i]?.setAttribute('previousSibling', childNodes[i - 1]);
+            };
+            for (let i = childNodes.length - 1; i >= 0; i--) {
+                const { type, data } = childNodes[i];
+                if (type !== 'text' || childNodes.length === 1 || this.getGaps(i - (i && 1))) {
+                    //
+                }
+                else if (data === '') {
+                    remove(i);
+                }
+                else {
+                    const prev = childNodes[i - 1];
+                    if (prev?.type === 'text') {
+                        prev.setAttribute('data', prev.data + data);
+                        remove(i);
+                    }
+                }
+            }
+            this.setAttribute('childNodes', childNodes);
+        }
         /**
          * Check if the current element matches the selector
          *
@@ -409,7 +407,7 @@ let AstElement = (() => {
          * @param selector selector / 选择器
          */
         matches(selector) {
-            return selector === undefined || (0, selector_1.getCondition)(selector, this)(this);
+            return (0, selector_1.getCondition)(selector, this)(this);
         }
         /**
          * Insert a batch of child nodes at the start

package/dist/lib/lintConfig.js

@@ -306,9 +306,9 @@ class LintConfiguration {
     set rules(config) {
         this.#rules = new Proxy(new LintRuleConfiguration(config), {
             set,
+            /* istanbul ignore next */
             /** @ignore */
             deleteProperty() {
-                /* istanbul ignore next */
                 return false;
             },
         });

package/dist/lib/lsp.js

@@ -10,7 +10,10 @@ const base_1 = require("../base");
 const sharable_1 = require("../util/sharable");
 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 index_1 = __importDefault(require("../index"));
+const index_2 = require("../src/index");
 /* NOT FOR BROWSER ONLY */
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
@@ -19,7 +22,6 @@ const child_process_1 = require("child_process");
 const crypto_1 = require("crypto");
 const stylelint_util_1 = require("@bhsd/stylelint-util");
 const search_1 = __importDefault(require("../util/search"));
-const constants_1 = require("../util/constants");
 const document_1 = require("./document");
 exports.tasks = new WeakMap();
 const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']), nameAttrs = new Set(['name', 'follow']), groupAttrs = new Set(['group']), renameTypes = new Set([
@@ -51,7 +53,7 @@ const getLinkRegex = (0, common_1.getRegex)(protocol => new RegExp(`^(?:${protoc
 const isAttr = ({ type, parentNode, length, firstChild }, style) => type === 'attr-value' && length === 1 && firstChild.type === 'text'
     && (!style
         || parentNode.name === 'style'
-            && Boolean(document_1.cssLSP));
+            && Boolean((0, document_1.loadCssLSP)()));
 /**
  * Check if a token is an HTML attribute.
  * @param token
@@ -227,6 +229,60 @@ const getFixAll = (root, rule) => {
             },
         ];
 };
+/**
+ * Partially parse wikitext.
+ * @param wikitext
+ * @param watch function to watch for changes
+ * @param include
+ * @param config
+ */
+const partialParse = async (wikitext, watch, include, config = index_1.default.getConfig()) => {
+    const set = typeof setImmediate === 'function' ? setImmediate : /* istanbul ignore next */ setTimeout, { running } = debug_1.Shadow;
+    debug_1.Shadow.running = true;
+    /* PRINT ONLY */
+    const { internal } = index_1.default;
+    index_1.default.internal = true;
+    /* PRINT ONLY END */
+    /** restore state before exit */
+    const finish = () => {
+        debug_1.Shadow.running = running;
+        /* PRINT ONLY */
+        index_1.default.internal = internal;
+    };
+    const token = new index_2.Token((0, string_1.tidy)(wikitext), config);
+    token.type = 'root';
+    let i = 0;
+    try {
+        await new Promise(resolve => {
+            const /** @ignore */ check = () => {
+                if (watch() === wikitext) {
+                    i++;
+                    set(parseOnce, 0);
+                }
+                else {
+                    resolve();
+                }
+            }, 
+            /** @ignore */ parseOnce = () => {
+                if (i === constants_1.MAX_STAGE + 1) {
+                    token.afterBuild();
+                    resolve();
+                }
+                else {
+                    token[i === constants_1.MAX_STAGE ? 'build' : 'parseOnce'](i, include);
+                    check();
+                }
+            };
+            set(parseOnce, 0);
+        });
+    }
+    catch (e) /* istanbul ignore next */ {
+        finish();
+        throw e;
+    }
+    finish();
+    return token;
+};
 /* NOT FOR BROWSER ONLY */
 /** @see https://www.npmjs.com/package/stylelint-config-recommended */
 const cssRules = { 'block-no-empty': null }, sources = { 'invalid-css': 'css', 'invalid-math': 'texvc' }, jsonSelector = document_1.jsonTags.map(s => `ext#${s}`).join(), scores = new Map();
@@ -381,7 +437,7 @@ class LanguageService {
         this.config ??= index_1.default.getConfig();
         this.#config = this.config;
         this.#include = this.include;
-        const text = this.#text, root = await index_1.default.partialParse(text, () => this.#text, this.include, this.config);
+        const text = this.#text, root = await partialParse(text, () => this.#text, this.include, this.config);
         if (this.#checkConfig() && this.#text === text) {
             this.#done = root;
             this.#running = undefined;
@@ -419,7 +475,7 @@ class LanguageService {
         this.config ??= index_1.default.getConfig();
         this.#config = this.config;
         this.#include = this.include;
-        const text = this.#text2, root = await index_1.default.partialParse(text, () => this.#text2, this.include, this.config);
+        const text = this.#text2, root = await partialParse(text, () => this.#text2, this.include, this.config);
         if (this.#checkConfig() && this.#text2 === text) {
             this.#done2 = root;
             this.#running2 = undefined;
@@ -461,7 +517,7 @@ class LanguageService {
             }
             else if (isAttr(token, true)) {
                 const textDoc = new document_1.EmbeddedCSSDocument(root, token);
-                return document_1.cssLSP.findDocumentColors(textDoc, textDoc.styleSheet);
+                return (0, document_1.loadCssLSP)().findDocumentColors(textDoc, textDoc.styleSheet);
                 /* NOT FOR BROWSER ONLY END */
             }
             /* NOT FOR BROWSER ONLY */
@@ -489,7 +545,7 @@ class LanguageService {
                         },
                         range: createRange(root, start + from, start + to),
                     };
-                }).filter(Boolean);
+                }).filter(info => info !== false);
             });
         });
     }
@@ -539,11 +595,7 @@ class LanguageService {
                     ext,
                     tags,
                     allTags: [...tags, 'onlyinclude', 'includeonly', 'noinclude'],
-                    functions: [
-                        Object.keys(insensitive),
-                        Array.isArray(sensitive) ? /* istanbul ignore next */ sensitive : Object.keys(sensitive),
-                        other,
-                    ].flat(2),
+                    functions: [Object.keys(insensitive), Object.keys(sensitive), other].flat(2),
                     switches: allSwitches.filter(cm_util_1.isUnderscore).map(w => `__${w}__`),
                     jaSwitches: allSwitches.filter(w => !(0, cm_util_1.isUnderscore)(w)),
                     protocols: protocol.split('|'),
@@ -599,7 +651,7 @@ class LanguageService {
                 return getCompletion(root.querySelectorAll('arg').filter(token => token.name && token !== cur)
                     .map(({ name }) => name), 'Variable', match, position);
             }
-            const [insensitive, sensitive] = this.config.parserFunction, isOld = Array.isArray(sensitive), next = curLine.charAt(character), colon = match.startsWith(':'), str = colon ? match.slice(1).trimStart() : match;
+            const [insensitive, sensitive] = this.config.parserFunction, next = curLine.charAt(character), colon = match.startsWith(':'), str = colon ? match.slice(1).trimStart() : match;
             if (mt[2] === '[[') { // link
                 return getCompletion(root.querySelectorAll('link,file,category,redirect-target').filter(token => token !== cur).map(({ name }) => name), 'Folder', str, position);
             }
@@ -619,7 +671,7 @@ class LanguageService {
                     else if (name in insensitive) {
                         name = insensitive[name];
                     }
-                    else if (!isOld && name in sensitive) {
+                    else if (name in sensitive) {
                         name = sensitive[name];
                     }
                     return this.#getParserFunction(name.toLowerCase());
@@ -702,7 +754,8 @@ class LanguageService {
         }
         else if (isAttr(cur, true)) {
             const textDoc = new document_1.EmbeddedCSSDocument(root, cur);
-            return document_1.cssLSP.doComplete(textDoc, position, textDoc.styleSheet).items.map((item) => ({
+            return (0, document_1.loadCssLSP)().doComplete(textDoc, position, textDoc.styleSheet).items
+                .map((item) => ({
                 ...item,
                 textEdit: {
                     range: item.textEdit.range,
@@ -710,9 +763,13 @@ class LanguageService {
                 },
             }));
         }
-        else if (document_1.jsonLSP && type === 'ext-inner' && document_1.jsonTags.includes(cur.name)) {
+        else if (type === 'ext-inner' && document_1.jsonTags.includes(cur.name)) {
+            const jsonLSP = (0, document_1.loadJsonLSP)();
+            if (!jsonLSP) {
+                return undefined;
+            }
             const textDoc = new document_1.EmbeddedJSONDocument(root, cur);
-            return (await document_1.jsonLSP.doComplete(textDoc, position, textDoc.jsonDoc))?.items;
+            return (await jsonLSP.doComplete(textDoc, position, textDoc.jsonDoc))?.items;
         }
         else if (type === 'ext-inner' && cur.name === 'score') {
             const lang = parentNode.getAttr('lang');
@@ -788,15 +845,18 @@ class LanguageService {
                 ...suggestions ? suggestions.map(suggestion => getQuickFix(root, suggestion)) : [],
             ],
         })), 
+        /* NOT FOR BROWSER ONLY */
+        stylelint = await (0, document_1.loadStylelint)(), jsonLSP = (0, document_1.loadJsonLSP)(), 
+        /* NOT FOR BROWSER ONLY END */
         /* eslint-disable @stylistic/operator-linebreak */
-        cssDiagnostics = await document_1.stylelint ?
+        cssDiagnostics = stylelint ?
             await (async () => {
                 NPM: {
                     const tokens = this.findStyleTokens();
                     if (tokens.length === 0) {
                         return [];
                     }
-                    const code = tokens.map(({ type, tag, lastChild }, i) => `${type === 'ext-attr' ? 'div' : tag}#${i}{\n${(0, common_1.sanitizeInlineStyle)(lastChild.toString())}\n}`).join('\n'), cssErrors = await (0, stylelint_util_1.styleLint)((await document_1.stylelint), code, cssRules);
+                    const code = tokens.map(({ type, tag, lastChild }, i) => `${type === 'ext-attr' ? 'div' : tag}#${i}{\n${(0, common_1.sanitizeInlineStyle)(lastChild.toString())}\n}`).join('\n'), cssErrors = await (0, stylelint_util_1.styleLint)(stylelint, code, cssRules);
                     if (cssErrors.length === 0) {
                         return [];
                     }
@@ -833,12 +893,12 @@ class LanguageService {
                     });
                 }
             })() :
-            [], jsonDiagnostics = document_1.jsonLSP ?
+            [], jsonDiagnostics = jsonLSP ?
             await Promise.all(root.querySelectorAll(jsonSelector).map(async ({ name, lastChild, selfClosing }) => {
                 if (selfClosing) {
                     return [];
                 }
-                const textDoc = new document_1.EmbeddedJSONDocument(root, lastChild), severityLevel = name === 'templatedata' ? 'error' : 'ignore', e = (await document_1.jsonLSP.doValidation(textDoc, textDoc.jsonDoc, {
+                const textDoc = new document_1.EmbeddedJSONDocument(root, lastChild), severityLevel = name === 'templatedata' ? 'error' : 'ignore', e = (await jsonLSP.doValidation(textDoc, textDoc.jsonDoc, {
                     comments: severityLevel,
                     trailingCommas: severityLevel,
                 })).map((error) => ({
@@ -972,10 +1032,11 @@ class LanguageService {
             }
         }
         /* NOT FOR BROWSER ONLY */
-        if (document_1.jsonLSP) {
+        const jsonLSP = (0, document_1.loadJsonLSP)();
+        if (jsonLSP) {
             for (const { selfClosing, lastChild } of root.querySelectorAll(jsonSelector)) {
                 if (!selfClosing) {
-                    const foldingRanges = document_1.jsonLSP.getFoldingRanges(new document_1.EmbeddedJSONDocument(root, lastChild));
+                    const foldingRanges = jsonLSP.getFoldingRanges(new document_1.EmbeddedJSONDocument(root, lastChild));
                     if (foldingRanges.length > 0) {
                         Array.prototype.push.apply(ranges, foldingRanges);
                     }
@@ -1085,7 +1146,7 @@ class LanguageService {
                 return false;
             }
         })
-            .filter(Boolean);
+            .filter(link => link !== false);
     }
     /**
      * Provide references
@@ -1241,41 +1302,43 @@ class LanguageService {
         }
         else if (isAttr(offsetNode, true)) {
             const textDoc = new document_1.EmbeddedCSSDocument(root, offsetNode);
-            return document_1.cssLSP.doHover(textDoc, position, textDoc.styleSheet) ?? undefined;
+            return (0, document_1.loadCssLSP)().doHover(textDoc, position, textDoc.styleSheet) ?? undefined;
         }
-        else if (document_1.jsonLSP && type === 'ext-inner' && document_1.jsonTags.includes(name)) {
+        else if (type === 'ext-inner' && document_1.jsonTags.includes(name)) {
+            const jsonLSP = (0, document_1.loadJsonLSP)();
+            if (!jsonLSP) {
+                return undefined;
+            }
             const textDoc = new document_1.EmbeddedJSONDocument(root, offsetNode);
-            return await document_1.jsonLSP.doHover(textDoc, position, textDoc.jsonDoc) ?? undefined;
+            return await jsonLSP.doHover(textDoc, position, textDoc.jsonDoc) ?? undefined;
         }
-        else if (document_1.htmlData) {
-            if (type === 'html' && offset <= offsetNode.getRelativeIndex(0)
-                || type === 'html-attr-dirty' && offset === 0 && parentNode.firstChild === offsetNode) {
-                const token = type === 'html' ? offsetNode : parentNode.parentNode, data = document_1.htmlData.provideTags().find(({ name: n }) => n === token.name);
-                if (data?.description) {
-                    const start = positionAt(root, token.getAbsoluteIndex());
-                    return {
-                        contents: data.description,
-                        range: {
-                            start,
-                            end: {
-                                line: start.line,
-                                character: start.character + token.getRelativeIndex(0),
-                            },
+        else if (type === 'html' && offset <= offsetNode.getRelativeIndex(0)
+            || type === 'html-attr-dirty' && offset === 0 && parentNode.firstChild === offsetNode) {
+            const token = type === 'html' ? offsetNode : parentNode.parentNode, data = (0, document_1.loadHtmlData)()?.provideTags().find(({ name: n }) => n === token.name);
+            if (data?.description) {
+                const start = positionAt(root, token.getAbsoluteIndex());
+                return {
+                    contents: data.description,
+                    range: {
+                        start,
+                        end: {
+                            line: start.line,
+                            character: start.character + token.getRelativeIndex(0),
                         },
-                    };
-                }
+                    },
+                };
             }
-            else if (type === 'attr-key' && isHtmlAttr(parentNode)) {
-                const data = document_1.htmlData.provideAttributes(parentNode.tag).find(({ name: n }) => n === parentNode.name);
-                if (data?.description) {
-                    return {
-                        contents: data.description,
-                        range: createNodeRange(offsetNode),
-                    };
-                }
+        }
+        else if (type === 'attr-key' && isHtmlAttr(parentNode)) {
+            const data = (0, document_1.loadHtmlData)()?.provideAttributes(parentNode.tag).find(({ name: n }) => n === parentNode.name);
+            if (data?.description) {
+                return {
+                    contents: data.description,
+                    range: createNodeRange(offsetNode),
+                };
             }
-            /* NOT FOR BROWSER ONLY END */
         }
+        /* NOT FOR BROWSER ONLY END */
         return info && {
             contents: {
                 kind: 'markdown',
@@ -1395,10 +1458,11 @@ class LanguageService {
         else {
             return [];
         }
-        const root = await this.#queueSignature(selected);
-        const { viewOnly } = index_1.default;
+        const root = await this.#queueSignature(selected), { viewOnly } = index_1.default;
         index_1.default.viewOnly = false;
-        root.escape();
+        debug_1.Shadow.internal(() => {
+            root.escape();
+        }, index_1.default);
         index_1.default.viewOnly = viewOnly;
         return [
             {
@@ -1466,9 +1530,9 @@ class LanguageService {
                 sections[i] = undefined;
             }
             const section = token.text().trim() || ' ', name = names.has(section)
-                ? new Array(names.size).fill('').map((_, i) => `${section.trim()}_${i + 2}`)
+                ? Array.from({ length: names.size }, (_, i) => `${section.trim()}_${i + 2}`)
                     .find(s => !names.has(s))
-                : section, container = sections.slice(0, level - 1).reverse().find(Boolean), selectionRange = {
+                : section, container = sections.slice(0, level - 1).reverse().find(symbol => symbol !== undefined), selectionRange = {
                 start: { line: top, character: left - level },
                 end: (0, lint_1.getEndPos)(top, left, height, width + level),
             }, info = {

package/dist/lib/node.js

@@ -190,7 +190,7 @@ let AstNode = (() => {
             return this.font.italic;
         }
         constructor() {
-            if (!index_1.default.viewOnly) {
+            if (!index_1.default.viewOnly && !index_1.default.internal) {
                 Object.defineProperty(this, 'childNodes', { writable: false });
                 Object.freeze(this.childNodes);
             }
@@ -203,7 +203,7 @@ let AstNode = (() => {
         }
         /** @private */
         getAttribute(key) {
-            return (key === 'padding' ? 0 : this[key]);
+            return (key === 'padding' ? 0 : /* istanbul ignore next */ this[key]);
         }
         /** @private */
         setAttribute(key, value) {
@@ -395,19 +395,25 @@ let AstNode = (() => {
         /* PRINT ONLY */
         /** @private */
         seal(key, permanent) {
-            /* NOT FOR BROWSER */
-            if (!permanent) {
-                this.#optional.add(key);
-            }
-            /* NOT FOR BROWSER END */
-            const enumerable = !permanent && Boolean(this[key]);
-            if (!enumerable || !index_1.default.viewOnly) {
-                Object.defineProperty(this, key, {
-                    enumerable,
-                    configurable: true,
+            LSP: {
+                if (index_1.default.internal) {
+                    return;
                     /* NOT FOR BROWSER */
-                    writable: index_1.default.viewOnly,
-                });
+                }
+                else if (!permanent) {
+                    this.#optional.add(key);
+                    /* NOT FOR BROWSER END */
+                }
+                const enumerable = !permanent && Boolean(this[key]);
+                if (!enumerable
+                    || !index_1.default.viewOnly) {
+                    Object.defineProperty(this, key, {
+                        enumerable,
+                        configurable: true,
+                        /* NOT FOR BROWSER */
+                        writable: index_1.default.viewOnly,
+                    });
+                }
             }
         }
         /* PRINT ONLY END */

package/dist/lib/text.js

@@ -172,7 +172,7 @@ let AstText = (() => {
         /** @param text 包含文本 */
         constructor(text) {
             super();
-            if (index_1.default.viewOnly) {
+            if (index_1.default.viewOnly || index_1.default.internal) {
                 this.data = text;
                 /* NOT FOR BROWSER */
             }
@@ -489,7 +489,7 @@ let AstText = (() => {
         }
         /** @private */
         print() {
-            return (0, string_1.escape)(this.data);
+            PRINT: return (0, string_1.escape)(this.data);
         }
         /* NOT FOR BROWSER */
         /**

package/dist/lib/title.d.ts

@@ -72,6 +72,17 @@ export declare class Title {
      * @since v1.10.0
      */
     getUrl(articlePath?: string): string;
+    /**
+     * Get the URL of the file
+     *
+     * 生成文件URL
+     * @param width width / 宽度
+     * @param height height / 高度
+     * @since v1.32.0
+     * @throws `RangeError` invalid width or height
+     * @throws `Error` not a file
+     */
+    getFileUrl(width?: number | false, height?: number | false): string;
     /**
      * Perform unidirectional language conversion
      *