wikilint 2.16.1 → 2.16.3

package/dist/lib/lsp.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LanguageService = exports.tasks = void 0;
 const path = require("path");
 const common_1 = require("@bhsd/common");
-const debug_1 = require("../util/debug");
 const sharable_1 = require("../util/sharable");
 const lint_1 = require("../util/lint");
 const index_1 = require("../index");
 const element_1 = require("../lib/element");
 exports.tasks = new WeakMap();
+const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']), nameAttrs = new Set(['name', 'extends', 'follow']), groupAttrs = new Set(['group']);
 /**
  * Check if all child nodes are plain text or comments.
  * @param childNodes child nodes
@@ -41,7 +41,7 @@ const createNodeRange = (token) => {
     const { top, left, height, width } = token.getBoundingClientRect();
     return {
         start: { line: top, character: left },
-        end: (0, lint_1.getEndPos)(top, left, width, height),
+        end: (0, lint_1.getEndPos)(top, left, height, width),
     };
 };
 /**
@@ -53,7 +53,7 @@ const createNodeRange = (token) => {
  * @param pos.line line number
  * @param pos.character character number
  */
-const getCompletion = (words, kind, mt, { line, character }) => [...new Set(words)].map(w => ({
+const getCompletion = (words, kind, mt, { line, character }) => [...new Set(words)].map((w) => ({
     label: w,
     kind,
     textEdit: {
@@ -86,59 +86,34 @@ const getUrl = (page, ns) => {
         : articlePath + (articlePath.endsWith('/') ? '' : '/') + encoded;
 };
 /**
- * Get the token at the position.
+ * Get the token at the position from a word.
  * @param root root token
  * @param pos position
  */
-const elementFromPoint = (root, pos) => {
-    const { line, character } = pos;
-    let offset = root.indexFromPos(line, character), node = root;
-    while (true) { // eslint-disable-line no-constant-condition
-        // eslint-disable-next-line @typescript-eslint/no-loop-func
-        const child = node.childNodes.find(ch => {
-            const i = ch.getRelativeIndex();
-            if (i < offset && i + ch.toString().length >= offset) {
-                offset -= i;
-                return true;
-            }
-            return false;
-        });
-        if (!child || child.type === 'text') {
-            break;
-        }
-        node = child;
-    }
-    return node;
+const elementFromWord = (root, pos) => {
+    const { line, character } = pos, index = root.indexFromPos(line, character), offset = Number(/[\w!#]/u.test(root.toString().charAt(index)));
+    return root.elementFromIndex(index + offset);
 };
 /**
- * Get the token at the position from a word.
- * @param root root token
- * @param pos position
+ * Get the attribute of a `<ref>` tag.
+ * @param token attribute token
+ * @param tags tag names
+ * @param names attribute names
  */
-const elementFromWord = (root, pos) => {
-    const { line, character } = pos, offset = Number(/\w/u.test(root.toString().charAt(root.indexFromPos(line, character))));
-    return elementFromPoint(root, { line, character: character + offset });
+const getRefAttr = (token, tags, names) => {
+    const { type, parentNode = {} } = token, { name, tag } = parentNode;
+    return type === 'attr-value' && tags.has(tag) && names.has(name) ? token.toString().trim() : NaN;
 };
 /**
  * Get the `name` attribute of a `<ref>` tag.
  * @param token `name` attribute token
  */
-const getRefName = (token) => {
-    const { type, parentNode = {} } = token, { name, tag } = parentNode;
-    return type === 'attr-value' && tag === 'ref' && ['name', 'extends', 'follow'].includes(name)
-        ? token.toString().trim()
-        : NaN;
-};
+const getRefName = (token) => getRefAttr(token, refTags, nameAttrs);
 /**
  * Get the `group` attribute of a `<ref>` or `<references>` tag.
  * @param token `group` attribute token
  */
-const getRefGroup = (token) => {
-    const { type, parentNode = {} } = token, { name, tag } = parentNode;
-    return type === 'attr-value' && name === 'group' && (tag === 'ref' || tag === 'references')
-        ? token.toString().trim()
-        : NaN;
-};
+const getRefGroup = (token) => getRefAttr(token, referencesTags, groupAttrs);
 /**
  * Get the effective name of a token.
  * @param token
@@ -169,7 +144,8 @@ const getName = (token) => {
  */
 const getSectionEnd = (section, lines, line) => {
     if (section) {
-        section.range.end = { line, character: lines[line].length };
+        const [, start, end] = lines[line];
+        section.range.end = { line, character: end - start };
     }
 };
 /* NOT FOR BROWSER ONLY END */
@@ -178,6 +154,7 @@ class LanguageService {
     #text;
     #running;
     #done;
+    #config;
     #completionConfig;
     #signature;
     /** @private */
@@ -201,14 +178,11 @@ class LanguageService {
      * - 否则开始新的解析
      */
     async #queue(text) {
-        /* istanbul ignore if */
-        if (typeof text !== 'string') {
-            return (0, debug_1.typeError)(this.constructor, 'queue', 'String');
-        }
-        else if (this.#text === text && !this.#running && this.#done) {
+        text = text.replace(/\r$/gmu, '');
+        if (this.#text === text && this.#config === index_1.default.config && !this.#running) {
             return this.#done;
         }
-        this.#text = text.replace(/\r$/gmu, '');
+        this.#text = text;
         this.#running ??= this.#parse(); // 不要提交多个解析任务
         return this.#running;
     }
@@ -221,8 +195,10 @@ class LanguageService {
     async #parse() {
         return new Promise(resolve => {
             (typeof setImmediate === 'function' ? setImmediate : /* istanbul ignore next */ setTimeout)(() => {
-                const text = this.#text, root = index_1.default.parse(text, true);
-                if (this.#text === text) {
+                const config = index_1.default.getConfig();
+                this.#config = index_1.default.config;
+                const text = this.#text, root = index_1.default.parse(text, true, undefined, config);
+                if (this.#text === text && this.#config === index_1.default.config) {
                     this.#done = root;
                     this.#running = undefined;
                     resolve(root);
@@ -235,6 +211,16 @@ class LanguageService {
             }, 0);
         });
     }
+    /**
+     * 检查是否为签名语言服务器
+     * @throws `Error` 是签名语言服务器
+     */
+    #checkSignature() {
+        /* istanbul ignore if */
+        if (this.#signature) {
+            throw new Error('This is a signature language server!');
+        }
+    }
     /**
      * 提供颜色指示
      * @param rgba 颜色解析函数
@@ -242,16 +228,15 @@ class LanguageService {
      * @param hsl 是否允许HSL颜色
      */
     async provideDocumentColors(rgba, text, hsl = true) {
-        /* istanbul ignore if */
-        if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
+        this.#checkSignature();
         const root = await this.#queue(text);
-        return root.querySelectorAll('attr-value,parameter-value,arg-default').flatMap(({ type, childNodes }) => {
+        return root.querySelectorAll('attr-value,parameter-value,arg-default')
+            .flatMap(({ type, childNodes }) => {
             if (type !== 'attr-value' && !isPlain(childNodes)) {
                 return [];
             }
-            return childNodes.filter((child) => child.type === 'text').flatMap(child => {
+            return childNodes.filter((child) => child.type === 'text')
+                .flatMap(child => {
                 const parts = (0, common_1.splitColors)(child.data, hsl).filter(([, , , isColor]) => isColor);
                 if (parts.length === 0) {
                     return [];
@@ -287,21 +272,22 @@ class LanguageService {
     #prepareCompletionConfig() {
         if (!this.#completionConfig) {
             const { nsid, ext, html, parserFunction: [insensitive, sensitive, ...other], doubleUnderscore, protocol, img, } = index_1.default.getConfig(), tags = new Set([ext, html].flat(2));
+            const re = new RegExp('(?:' // eslint-disable-line prefer-template
+                + String.raw `<\/?(\w*)` // tag
+                + '|'
+                + String.raw `(\{{2,4}|\[\[)\s*([^|{}<>[\]\s][^|{}<>[\]#]*)?` // braces and brackets
+                + '|'
+                + String.raw `(__(?:(?!__)[\p{L}\d_])*)` // behavior switch
+                + '|'
+                + String.raw `(?<!\[)\[([a-z:/]*)` // protocol
+                + '|'
+                + String.raw `\[\[\s*(?:${Object.entries(nsid).filter(([, v]) => v === 6).map(([k]) => k).join('|')})\s*:[^[\]{}<>]+\|([^[\]{}<>|=]*)` // image parameter
+                + '|'
+                // attribute key
+                + String.raw `<(\w+)(?:\s(?:[^<>{}|=\s]+(?:\s*=\s*(?:[^\s"']\S*|(["']).*?\8))?(?=\s))*)?\s(\w*)`
+                + ')$', 'iu');
             this.#completionConfig = {
-                re: new RegExp('(?:' // eslint-disable-line prefer-template
-                    + String.raw `<\/?(\w+)` // tag
-                    + '|'
-                    + String.raw `(\{{2,4}|\[\[)\s*([^|{}<>[\]\s][^|{}<>[\]#]*)` // braces and brackets
-                    + '|'
-                    + String.raw `(__(?:(?!__)[\p{L}\d_])+)` // behavior switch
-                    + '|'
-                    + String.raw `(?<!\[)\[([a-z:/]+)` // protocol
-                    + '|'
-                    + String.raw `\[\[\s*(?:${Object.entries(nsid).filter(([, v]) => v === 6).map(([k]) => k).join('|')})\s*:[^[\]{}<>]+\|([^[\]{}<>|=]+)` // image parameter
-                    + '|'
-                    // attribute key
-                    + String.raw `<(\w+)(?:\s(?:[^<>{}|=\s]+(?:\s*=\s*(?:[^\s"']\S*|(["']).*?\8))?(?=\s))*)?\s(\w+)`
-                    + ')$', 'iu'),
+                re,
                 ext,
                 tags,
                 allTags: [...tags, 'onlyinclude', 'includeonly', 'noinclude'],
@@ -324,39 +310,37 @@ class LanguageService {
      * @param position 位置
      */
     async provideCompletionItems(text, position) {
-        /* istanbul ignore if */
-        if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
-        const { re, allTags, functions, switches, protocols, params, tags, ext } = this.#prepareCompletionConfig(), { line, character } = position, mt = re.exec(text.split(/\r?\n/u)[line]?.slice(0, character) ?? '');
-        if (mt?.[1]) { // tag
+        this.#checkSignature();
+        const { re, allTags, functions, switches, protocols, params, tags, ext } = this.#prepareCompletionConfig(), { line, character } = position, mt = re.exec(text.split(/\r?\n/u, line + 1)[line]?.slice(0, character) ?? '');
+        if (mt?.[1] !== undefined) { // tag
             return getCompletion(allTags, 'Class', mt[1], position);
         }
         else if (mt?.[4]) { // behavior switch
             return getCompletion(switches, 'Constant', mt[4], position);
         }
-        else if (mt?.[5]) { // protocol
+        else if (mt?.[5] !== undefined) { // protocol
             return getCompletion(protocols, 'Reference', mt[5], position);
         }
         const root = await this.#queue(text);
-        if (mt?.[2] === '{{{') { // argument
-            return getCompletion(root.querySelectorAll('arg').map(({ name }) => name), 'Variable', mt[3], position);
-        }
-        else if (mt?.[3]) { // parser function, template or link
-            const colon = mt[3].startsWith(':'), str = colon ? mt[3].slice(1).trimStart() : mt[3];
-            if (mt[2] === '[[') {
-                return getCompletion(root.querySelectorAll('link,file,category').map(({ name }) => name), 'Folder', str, position);
+        if (mt?.[2]) {
+            const match = mt[3] ?? '';
+            if (mt[2] === '{{{') { // argument
+                return getCompletion(root.querySelectorAll('arg').map(({ name }) => name).filter(Boolean), 'Variable', match, position);
             }
-            return [
-                ...getCompletion(functions, 'Function', mt[3], position),
-                ...mt[3].startsWith('#')
-                    ? []
-                    : getCompletion(root.querySelectorAll('template')
-                        .map(({ name }) => colon ? name : name.replace(/^Template:/u, '')), 'Folder', str, position),
-            ];
+            const colon = match.startsWith(':'), str = colon ? match.slice(1).trimStart() : match;
+            return mt[2] === '[['
+                ? getCompletion(// link
+                root.querySelectorAll('link,file,category,redirect-target').map(({ name }) => name), 'Folder', str, position)
+                : [
+                    ...getCompletion(functions, 'Function', match, position),
+                    ...match.startsWith('#')
+                        ? []
+                        : getCompletion(root.querySelectorAll('template')
+                            .map(({ name }) => colon ? name : name.replace(/^Template:/u, '')), 'Folder', str, position),
+                ];
         }
-        const token = elementFromPoint(root, position), { type, parentNode } = token;
-        if (mt?.[6]?.trim() || type === 'image-parameter') { // image parameter
+        const token = root.elementFromPoint(character, line), { type, parentNode } = token;
+        if (mt?.[6] !== undefined || type === 'image-parameter') { // image parameter
             const match = mt?.[6]?.trimStart()
                 ?? this.#text.slice(token.getAbsoluteIndex(), root.indexFromPos(position.line, position.character)).trimStart();
             return [
@@ -364,12 +348,12 @@ class LanguageService {
                 ...getCompletion(root.querySelectorAll('image-parameter#width').map(width => width.text()), 'Unit', match, position),
             ];
         }
-        else if (mt?.[7] || type === 'attr-key') { // attribute key
-            const tag = mt?.[7]?.toLowerCase() ?? parentNode.tag;
+        else if (mt?.[7] !== undefined || type === 'attr-key') { // attribute key
+            const tag = mt?.[7]?.toLowerCase() ?? parentNode.tag, key = mt?.[9] ?? token.toString();
             if (!tags.has(tag)) {
                 return undefined;
             }
-            const key = mt?.[9] ?? token.toString(), thisHtmlAttrs = sharable_1.htmlAttrs[tag], thisExtAttrs = sharable_1.extAttrs[tag], extCompletion = thisExtAttrs && getCompletion(thisExtAttrs, 'Field', key, position);
+            const thisHtmlAttrs = sharable_1.htmlAttrs[tag], thisExtAttrs = sharable_1.extAttrs[tag], extCompletion = thisExtAttrs && getCompletion(thisExtAttrs, 'Field', key, position);
             return ext.includes(tag) && !thisHtmlAttrs
                 ? extCompletion
                 : [
@@ -386,22 +370,23 @@ class LanguageService {
         }
         else if ((type === 'parameter-key' || type === 'parameter-value' && parentNode.anon)
             && parentNode.parentNode.type === 'template') { // parameter key
-            return getCompletion(root.querySelectorAll('parameter').filter(({ anon, parentNode: parent }) => !anon && parent.type === 'template'
-                && parent.name === parentNode.parentNode.name).map(({ name }) => name), 'Variable', token.toString().trimStart(), position);
+            const key = token.toString().trimStart();
+            return key
+                ? getCompletion(root.querySelectorAll('parameter').filter(({ anon, parentNode: parent }) => !anon && parent.type === 'template'
+                    && parent.name === parentNode.parentNode.name).map(({ name }) => name), 'Variable', key, position)
+                : undefined;
         }
         return undefined;
     }
     /**
      * 提供语法诊断
      * @param wikitext 源代码
+     * @param warning 是否提供警告
      */
-    async provideDiagnostics(wikitext) {
-        /* istanbul ignore if */
-        if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
-        const root = await this.#queue(wikitext);
-        return root.lint().filter(({ severity }) => severity === 'error')
+    async provideDiagnostics(wikitext, warning = true) {
+        this.#checkSignature();
+        const root = await this.#queue(wikitext), errors = root.lint();
+        return (warning ? errors : errors.filter(({ severity }) => severity === 'error'))
             .map(({ startLine, startCol, endLine, endCol, severity, rule, message, fix, suggestions }) => ({
             range: {
                 start: { line: startLine, character: startCol },
@@ -434,15 +419,12 @@ class LanguageService {
         }));
     }
     async #provideFoldingRangesOrDocumentSymbols(text, fold = true) {
-        /* istanbul ignore if */
-        if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
+        this.#checkSignature();
         const ranges = [], symbols = [], 
         /* NOT FOR BROWSER ONLY */
         names = new Set(), sections = new Array(6), 
         /* NOT FOR BROWSER ONLY END */
-        root = await this.#queue(text), lines = this.#text.split('\n'), { length } = lines, levels = new Array(6), tokens = root.querySelectorAll(fold ? 'heading-title,table,template,magic-word' : 'heading-title');
+        root = await this.#queue(text), lines = root.getLines(), { length } = lines, levels = new Array(6), tokens = root.querySelectorAll(fold ? 'heading-title,table,template,magic-word' : 'heading-title');
         for (const token of tokens) {
             const { top, height, 
             /* NOT FOR BROWSER ONLY */
@@ -474,7 +456,7 @@ class LanguageService {
                             .find(s => !names.has(s))
                         : section, container = sections.slice(0, level - 1).reverse().find(Boolean), selectionRange = {
                         start: { line: top, character: left - level },
-                        end: (0, lint_1.getEndPos)(top, left, width + level, height),
+                        end: (0, lint_1.getEndPos)(top, left, height, width + level),
                     }, info = {
                         name,
                         kind: 15,
@@ -533,13 +515,10 @@ class LanguageService {
      * @param text 源代码
      */
     async provideLinks(text) {
-        /* istanbul ignore if */
-        if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
+        this.#checkSignature();
         const protocolRegex = new RegExp(`^(?:${index_1.default.getConfig().protocol}|//)`, 'iu'), selector = 'link-target,template-name,invoke-module,magic-link,ext-link-url,free-ext-link,attr-value,'
             + 'image-parameter#link';
-        return (await this.#queue(text)).querySelectorAll(selector).flatMap(token => {
+        return (await this.#queue(text)).querySelectorAll(selector).flatMap((token) => {
             const { type, parentNode, firstChild, lastChild, childNodes } = token, { name, tag } = parentNode;
             if (!(type !== 'attr-value'
                 || name === 'src' && ['templatestyles', 'img'].includes(tag)
@@ -586,7 +565,7 @@ class LanguageService {
                         {
                             range: {
                                 start: { line: rect.top, character: rect.left },
-                                end: (0, lint_1.getEndPos)(top, left, width, height),
+                                end: (0, lint_1.getEndPos)(top, left, height, width),
                             },
                             target,
                         },
@@ -599,11 +578,8 @@ class LanguageService {
             }
         });
     }
-    async #provideReferencesOrDefinition(text, position, usage, newName) {
-        /* istanbul ignore if */
-        if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
+    async #provideReferencesOrDefinition(text, position, usage) {
+        this.#checkSignature();
         const renameTypes = [
             'arg-name',
             'template-name',
@@ -619,40 +595,30 @@ class LanguageService {
             'heading',
             ...renameTypes,
         ], root = await this.#queue(text), node = elementFromWord(root, position), { type } = node, refName = getRefName(node), refGroup = getRefGroup(node);
-        if (usage > 1 && type === 'parameter-key' && /^[1-9]\d*$/u.test(node.parentNode.name)
+        if (usage === 2 && type === 'parameter-key' && /^[1-9]\d*$/u.test(node.parentNode.name)
             || !refName && (usage === 1
                 || !refGroup && (usage === 0
                     ? !types.includes(type)
                     : !renameTypes.includes(type)
-                        || type === 'link-target' && ['link', 'redirect-target'].includes(node.parentNode.type)))) {
+                        || type === 'link-target' && !['link', 'redirect-target'].includes(node.parentNode.type)))) {
             return undefined;
         }
         else if (usage === 2) {
             return createNodeRange(node);
         }
         const name = getName(node), refs = root.querySelectorAll(type === 'heading-title' ? 'heading' : type).filter(token => {
+            const { name: n, parentNode } = token.parentNode;
             if (usage === 1) {
-                const { name: n, parentNode } = token.parentNode;
                 return getRefName(token) === refName
                     && n === 'name' && parentNode.parentNode.innerText;
             }
             return type === 'attr-value'
                 ? getRefName(token) === refName || getRefGroup(token) === refGroup
                 : getName(token) === name;
-        }).map(token => usage !== 3 && token.type === 'parameter-key' ? token.parentNode : token);
-        if (refs.length === 0) {
-            return undefined;
-        }
-        return usage === 3
-            ? {
-                changes: {
-                    '': refs.map(ref => ({
-                        range: createNodeRange(ref),
-                        newText: newName,
-                    })),
-                },
-            }
-            : refs.map((ref) => ({ range: createNodeRange(ref) }));
+        }).map((token) => ({
+            range: createNodeRange(token.type === 'parameter-key' ? token.parentNode : token),
+        }));
+        return refs.length === 0 ? undefined : refs;
     }
     /**
      * 提供引用
@@ -685,7 +651,28 @@ class LanguageService {
      * @param newName 新名称
      */
     async provideRenameEdits(text, position, newName) {
-        return this.#provideReferencesOrDefinition(text, position, 3, newName);
+        this.#checkSignature();
+        const root = await this.#queue(text), node = elementFromWord(root, position), { type } = node, refName = getRefName(node), refGroup = getRefGroup(node);
+        const name = getName(node), refs = root.querySelectorAll(type).filter(token => {
+            const { type: t } = token.parentNode;
+            if (type === 'link-target' && t !== 'link' && t !== 'redirect-target') {
+                return false;
+            }
+            return type === 'attr-value'
+                ? getRefName(token) === refName || getRefGroup(token) === refGroup
+                : getName(token) === name;
+        });
+        if (refs.length === 0) {
+            return undefined;
+        }
+        return {
+            changes: {
+                '': refs.map((ref) => ({
+                    range: createNodeRange(ref),
+                    newText: newName,
+                })),
+            },
+        };
     }
     /**
      * 检索解析器函数
@@ -704,12 +691,10 @@ class LanguageService {
         if (!this.data) {
             return undefined;
         }
-        else if (this.#signature) {
-            throw new Error('This is a signature language server!');
-        }
+        this.#checkSignature();
         const token = elementFromWord(await this.#queue(text), position);
         let info, f;
-        if (token.type === 'double-underscore') {
+        if (token.is('double-underscore')) {
             info = this.data.behaviorSwitches.find(({ aliases }) => aliases.includes(token.innerText.toLowerCase()));
         }
         else if (token.type === 'magic-word-name') {
@@ -727,7 +712,6 @@ class LanguageService {
             range: createNodeRange(token),
         };
     }
-    /* NOT FOR BROWSER ONLY */
     /**
      * 提供魔术字帮助
      * @param text 源代码
@@ -743,7 +727,7 @@ class LanguageService {
             throw new Error('This is a regular language server!');
         }
         this.#signature = true;
-        const { line, character } = position, curLine = text.split(/\r?\n/u)[line], { lastChild } = await this.#queue(`${curLine.slice(0, character + /^[^{}<]*/u.exec(curLine.slice(character))[0].length)}}}`), { type, name, childNodes, firstChild } = lastChild;
+        const { line, character } = position, curLine = text.split(/\r?\n/u, line + 1)[line], { lastChild } = await this.#queue(`${curLine.slice(0, character + /^[^{}<]*/u.exec(curLine.slice(character))[0].length)}}}`), { type, name, childNodes, firstChild } = lastChild;
         if (type !== 'magic-word') {
             return undefined;
         }
@@ -751,7 +735,12 @@ class LanguageService {
         if (!info?.signatures) {
             return undefined;
         }
-        const f = firstChild.text().trim(), n = childNodes.length - 1, start = lastChild.getAbsoluteIndex(), activeParameter = childNodes.findLastIndex(child => child.getRelativeIndex() <= character - start) - 1, signatures = info.signatures.filter(params => (params.length >= n || params.at(-1)?.rest)
+        const f = firstChild.text().trim(), n = childNodes.length - 1, start = lastChild.getAbsoluteIndex();
+        let activeParameter = childNodes.findIndex(child => child.getRelativeIndex() > character - start) - 2;
+        if (activeParameter === -3) {
+            activeParameter = n - 1;
+        }
+        const signatures = info.signatures.filter(params => (params.length >= n || params[params.length - 1]?.rest)
             && params.every(({ label, const: c }, i) => {
                 const p = c && i < n && childNodes[i + 1]?.text().trim();
                 return !p || label.startsWith(p) || label.startsWith(p.toLowerCase());
@@ -765,10 +754,29 @@ class LanguageService {
         }));
         return { signatures, activeParameter };
     }
+    /**
+     * 提供 CodeLens
+     * @param text 源代码
+     */
+    async provideInlayHints(text) {
+        this.#checkSignature();
+        const hints = [], root = await this.#queue(text);
+        for (const template of root.querySelectorAll('template,magic-word#invoke')) {
+            const { type, childNodes } = template;
+            hints.push(...childNodes.slice(type === 'template' ? 1 : 3).filter(({ anon }) => anon)
+                .map((parameter) => ({
+                position: positionAt(root, parameter.getAbsoluteIndex()),
+                label: `${parameter.name}=`,
+                kind: 2,
+            })));
+        }
+        return hints;
+    }
+    /* NOT FOR BROWSER ONLY */
     /** @implements */
     // eslint-disable-next-line @typescript-eslint/class-methods-use-this
     provideCodeAction(diagnostics) {
-        return diagnostics.filter(({ data }) => data).flatMap(diagnostic => diagnostic.data.map((data) => ({
+        return diagnostics.flatMap(diagnostic => diagnostic.data.map((data) => ({
             title: data.title,
             kind: 'quickfix',
             diagnostics: [diagnostic],

package/dist/lib/node.d.ts

@@ -64,4 +64,6 @@ export declare abstract class AstNode implements AstNodeBase {
      * @param type 节点类型
      */
     is<T extends Token>(type: string): this is T;
+    /** 获取所有行的wikitext和起止位置 */
+    getLines(): [string, number, number][];
 }