wikiparser-node 1.16.3 → 1.16.5

package/dist/lib/lsp.js

@@ -5,17 +5,32 @@ const path = require("path");
 const common_1 = require("@bhsd/common");
 const sharable_1 = require("../util/sharable");
 const lint_1 = require("../util/lint");
+const string_1 = require("../util/string");
 const index_1 = require("../index");
-const element_1 = require("../lib/element");
 /* NOT FOR BROWSER */
 const constants_1 = require("../util/constants");
+/* NOT FOR BROWSER ONLY END */
 exports.tasks = new WeakMap();
-const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']), nameAttrs = new Set(['name', 'extends', 'follow']), groupAttrs = new Set(['group']);
+const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']), nameAttrs = new Set(['name', 'extends', 'follow']), groupAttrs = new Set(['group']), renameTypes = new Set([
+    'arg-name',
+    'template-name',
+    'magic-word-name',
+    'link-target',
+    'parameter-key',
+]), referenceTypes = new Set([
+    'ext',
+    'html',
+    'attr-key',
+    'image-parameter',
+    'heading-title',
+    'heading',
+    ...renameTypes,
+]), plainTypes = new Set(['text', 'comment', 'noinclude', 'include']);
 /**
  * Check if all child nodes are plain text or comments.
  * @param childNodes child nodes
  */
-const isPlain = (childNodes) => childNodes.every(({ type }) => ['text', 'comment', 'noinclude', 'include'].includes(type));
+const isPlain = (childNodes) => childNodes.every(({ type }) => plainTypes.has(type));
 /**
  * Get the position of a character in the document.
  * @param root root token
@@ -54,8 +69,9 @@ const createNodeRange = (token) => {
  * @param pos position
  * @param pos.line line number
  * @param pos.character character number
+ * @param extra extra text
  */
-const getCompletion = (words, kind, mt, { line, character }) => [...new Set(words)].map((w) => ({
+const getCompletion = (words, kind, mt, { line, character }, extra) => [...new Set(words)].map((w) => ({
     label: w,
     kind,
     textEdit: {
@@ -63,38 +79,19 @@ const getCompletion = (words, kind, mt, { line, character }) => [...new Set(word
             start: { line, character: character - mt.length },
             end: { line, character },
         },
-        newText: w,
+        newText: w + (extra ?? ''),
     },
 }));
 /**
- * Create the URL of a page.
- * @param page page name
- * @param ns namespace
- * @throws `RangeError` Invalid page name.
- * @throws `Error` Article path is not set.
- */
-const getUrl = (page, ns) => {
-    const { title, fragment, valid } = index_1.default.normalizeTitle(page, ns), { articlePath } = index_1.default.getConfig();
-    /* istanbul ignore next */
-    if (!valid) {
-        throw new RangeError('Invalid page name.');
-    }
-    else if (!articlePath) {
-        throw new Error('Article path is not set.');
-    }
-    const encoded = encodeURIComponent(title) + (fragment === undefined ? '' : `#${encodeURIComponent(fragment)}`);
-    return articlePath.includes('$1')
-        ? articlePath.replace('$1', encoded)
-        : articlePath + (articlePath.endsWith('/') ? '' : '/') + encoded;
-};
-/**
- * Get the token at the position from a word.
+ * Get the caret position at the position from a word.
  * @param root root token
  * @param pos position
+ * @param pos.line line number
+ * @param pos.character character number
  */
-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);
+const caretPositionFromWord = (root, { line, character }) => {
+    const index = root.indexFromPos(line, character);
+    return root.caretPositionFromIndex(index + Number(/\w/u.test(root.toString().charAt(index))));
 };
 /**
  * Get the attribute of a `<ref>` tag.
@@ -116,6 +113,15 @@ const getRefName = (token) => getRefAttr(token, refTags, nameAttrs);
  * @param token `group` attribute token
  */
 const getRefGroup = (token) => getRefAttr(token, referencesTags, groupAttrs);
+/**
+ * Get the attribute of a `<ref>` tag.
+ * @param token extension token
+ * @param target attribute name
+ */
+const getRefTagAttr = (token, target) => {
+    const attr = token?.getAttr(target);
+    return attr !== true && attr || false;
+};
 /**
  * Get the effective name of a token.
  * @param token
@@ -138,6 +144,18 @@ const getName = (token) => {
     }
 };
 /* NOT FOR BROWSER ONLY */
+/**
+ * Get the quick fix data.
+ * @param root root token
+ * @param fix lint error fix
+ * @param preferred whether it is a preferred fix
+ */
+const getQuickFix = (root, fix, preferred = false) => ({
+    range: createRange(root, ...fix.range),
+    newText: fix.text,
+    title: `${preferred ? 'Fix' : 'Suggestion'}: ${fix.desc}`,
+    fix: preferred,
+});
 /**
  * Get the end position of a section.
  * @param section section
@@ -180,7 +198,7 @@ class LanguageService {
      * - 否则开始新的解析
      */
     async #queue(text) {
-        text = text.replace(/\r$/gmu, '');
+        text = (0, string_1.tidy)(text);
         if (this.#text === text && this.#config === index_1.default.config && !this.#running) {
             return this.#done;
         }
@@ -195,23 +213,18 @@ class LanguageService {
      * - 总是返回最新的解析结果
      */
     async #parse() {
-        return new Promise(resolve => {
-            (typeof setImmediate === 'function' ? setImmediate : /* istanbul ignore next */ setTimeout)(() => {
-                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);
-                    return;
-                }
-                /* istanbul ignore next */
-                this.#running = this.#parse();
-                /* istanbul ignore next */
-                resolve(this.#running);
-            }, 0);
-        });
+        const config = index_1.default.getConfig();
+        this.#config = index_1.default.config;
+        const text = this.#text, root = await index_1.default.partialParse(text, () => this.#text, true, config);
+        if (this.#text === text && this.#config === index_1.default.config) {
+            this.#done = root;
+            this.#running = undefined;
+            return root;
+        }
+        /* istanbul ignore next */
+        this.#running = this.#parse();
+        /* istanbul ignore next */
+        return this.#running;
     }
     /**
      * 检查是否为签名语言服务器
@@ -224,10 +237,12 @@ class LanguageService {
         }
     }
     /**
+     * Provide color decorators
+     *
      * 提供颜色指示
-     * @param rgba 颜色解析函数
-     * @param text 源代码
-     * @param hsl 是否允许HSL颜色
+     * @param rgba color parser / 颜色解析函数
+     * @param text source Wikitext / 源代码
+     * @param hsl whether HSL colors are treated / 是否允许HSL颜色
      */
     async provideDocumentColors(rgba, text, hsl = true) {
         this.#checkSignature();
@@ -237,7 +252,7 @@ class LanguageService {
             if (type !== 'attr-value' && !isPlain(childNodes)) {
                 return [];
             }
-            return childNodes.filter((child) => child.type === 'text')
+            return childNodes.filter((child) => child.type === 'text').reverse()
                 .flatMap(child => {
                 const parts = (0, common_1.splitColors)(child.data, hsl).filter(([, , , isColor]) => isColor);
                 if (parts.length === 0) {
@@ -259,10 +274,15 @@ class LanguageService {
             });
         });
     }
-    /** @implements */
-    provideColorPresentations(// eslint-disable-line @typescript-eslint/class-methods-use-this
-    { color: { red, green, blue, alpha }, range }) {
-        const newText = `#${(0, common_1.numToHex)(red)}${(0, common_1.numToHex)(green)}${(0, common_1.numToHex)(blue)}${alpha < 1 ? (0, common_1.numToHex)(alpha) : ''}`;
+    /**
+     * Provide color pickers
+     *
+     * 颜色选择器
+     * @param color color information / 颜色信息
+     */
+    // eslint-disable-next-line @typescript-eslint/class-methods-use-this
+    provideColorPresentations(color) {
+        const { color: { red, green, blue, alpha }, range } = color, newText = `#${(0, common_1.numToHex)(red)}${(0, common_1.numToHex)(green)}${(0, common_1.numToHex)(blue)}${alpha < 1 ? (0, common_1.numToHex)(alpha) : ''}`;
         return [
             {
                 label: newText,
@@ -277,7 +297,7 @@ class LanguageService {
             // eslint-disable-next-line @typescript-eslint/no-unused-expressions, es-x/no-regexp-unicode-property-escapes
             /(?:<\/?(\w*)|(\{{2,4}|\[\[)\s*([^|{}<>[\]\s][^|{}<>[\]#]*)?|(__(?:(?!__)[\p{L}\d_])*)|(?<!\[)\[([a-z:/]*)|\[\[\s*(?:file|image)\s*:[^[\]{}<>]+\|([^[\]{}<>|=]*)|<(\w+)(?:\s(?:[^<>{}|=\s]+(?:\s*=\s*(?:[^\s"']\S*|(["']).*?\8))?(?=\s))*)?\s(\w*))$/iu;
             const re = new RegExp('(?:' // eslint-disable-line prefer-template
-                + String.raw `<\/?(\w*)` // tag
+                + String.raw `<(\/?\w*)` // tag
                 + '|'
                 + String.raw `(\{{2,4}|\[\[)\s*([^|{}<>[\]\s][^|{}<>[\]#]*)?` // braces and brackets
                 + '|'
@@ -309,15 +329,18 @@ class LanguageService {
         return this.#completionConfig;
     }
     /**
+     * Provide auto-completion
+     *
      * 提供自动补全
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      * @param position 位置
      */
     async provideCompletionItems(text, position) {
         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) ?? '');
+        const { re, allTags, functions, switches, protocols, params, tags, ext } = this.#prepareCompletionConfig(), { line, character } = position, curLine = text.split(/\r?\n/u, line + 1)[line], mt = re.exec(curLine?.slice(0, character) ?? '');
         if (mt?.[1] !== undefined) { // tag
-            return getCompletion(allTags, 'Class', mt[1], position);
+            const closing = mt[1].startsWith('/');
+            return getCompletion(allTags, 'Class', mt[1].slice(closing ? 1 : 0), position, closing && !curLine?.slice(character).trim().startsWith('>') ? '>' : '');
         }
         else if (mt?.[4]) { // behavior switch
             return getCompletion(switches, 'Constant', mt[4], position);
@@ -326,34 +349,54 @@ class LanguageService {
             return getCompletion(protocols, 'Reference', mt[5], position);
         }
         const root = await this.#queue(text);
+        let cur;
         if (mt?.[2]) {
+            cur = root.elementFromPoint(mt.index + mt[2].length - 1, line);
             const match = mt[3] ?? '';
             if (mt[2] === '{{{') { // argument
-                return getCompletion(root.querySelectorAll('arg').map(({ name }) => name).filter(Boolean), 'Variable', match, position);
+                return getCompletion(root.querySelectorAll('arg').filter(token => token.name && token !== cur)
+                    .map(({ name }) => name), 'Variable', match, 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)
+                root.querySelectorAll('link,file,category,redirect-target').filter(token => token !== cur).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),
+                        : getCompletion(root.querySelectorAll('template').filter(token => token !== cur)
+                            .map(token => {
+                            const { name } = token;
+                            if (colon) {
+                                return name;
+                            }
+                            const { ns } = token.getAttribute('title');
+                            if (ns === 0) {
+                                return `:${name}`;
+                            }
+                            return ns === 10 ? name.slice(9) : name;
+                        }), 'Folder', str, position),
                 ];
         }
-        const token = root.elementFromPoint(character, line), { type, parentNode } = token;
+        let type, parentNode;
+        if (mt?.[7] === undefined) {
+            cur = root.elementFromPoint(character, line);
+            ({ type, parentNode } = cur);
+        }
         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();
+            const index = root.indexFromPos(line, character), match = mt?.[6]?.trimStart()
+                ?? this.#text.slice(cur.getAbsoluteIndex(), index).trimStart(), equal = this.#text.charAt(index) === '=';
             return [
-                ...getCompletion(params, 'Property', match, position),
-                ...getCompletion(root.querySelectorAll('image-parameter#width').map(width => width.text()), 'Unit', match, position),
+                ...getCompletion(params, 'Property', match, position)
+                    .filter(({ label }) => !equal || !/[= ]$/u.test(label)),
+                ...getCompletion(root.querySelectorAll('image-parameter#width')
+                    .filter(token => token !== cur)
+                    .map(width => width.text()), 'Unit', match, position),
             ];
         }
         else if (mt?.[7] !== undefined || type === 'attr-key') { // attribute key
-            const tag = mt?.[7]?.toLowerCase() ?? parentNode.tag, key = mt?.[9] ?? token.toString();
+            const tag = mt?.[7]?.toLowerCase() ?? parentNode.tag, key = mt?.[9] ?? cur.toString();
             if (!tags.has(tag)) {
                 return undefined;
             }
@@ -372,24 +415,41 @@ class LanguageService {
                     ...getCompletion(['xmlns:'], 'Interface', key, position),
                 ];
         }
-        else if ((type === 'parameter-key' || type === 'parameter-value' && parentNode.anon)
-            && parentNode.parentNode.type === 'template') { // parameter key
-            const key = token.toString().trimStart();
+        else if (type === 'parameter-key' || type === 'parameter-value' && parentNode.anon) {
+            // parameter key
+            const transclusion = parentNode.parentNode, { type: t, name: n } = transclusion;
+            if (t === 'magic-word' && n !== 'invoke') {
+                return undefined;
+            }
+            const key = cur.toString().trimStart(), [module, func] = t === 'magic-word' ? transclusion.getModule() : [];
             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)
+                ? getCompletion(root.querySelectorAll('parameter').filter(token => {
+                    if (token === parentNode
+                        || token.anon
+                        || token.parentNode.type !== t
+                        || token.parentNode.name !== n) {
+                        return false;
+                    }
+                    else if (t === 'template') {
+                        return true;
+                    }
+                    const [m, f] = token.parentNode.getModule();
+                    return m === module && f === func;
+                }).map(({ name }) => name), 'Variable', key, position, type === 'parameter-value' ? '=' : '')
                 : undefined;
         }
         return undefined;
     }
     /**
-     * 提供语法诊断
-     * @param wikitext 源代码
-     * @param warning 是否提供警告
+     * Provide grammar check
+     *
+     * 提供语法检查
+     * @param text source Wikitext / 源代码
+     * @param warning whether to include warnings / 是否包含警告
      */
-    async provideDiagnostics(wikitext, warning = true) {
+    async provideDiagnostics(text, warning = true) {
         this.#checkSignature();
-        const root = await this.#queue(wikitext), errors = root.lint();
+        const root = await this.#queue(text), errors = root.lint();
         return (warning ? errors : errors.filter(({ severity }) => severity === 'error'))
             .map(({ startLine, startCol, endLine, endCol, severity, rule, message, fix, suggestions }) => ({
             range: {
@@ -400,86 +460,43 @@ class LanguageService {
             source: 'WikiLint',
             code: rule,
             message,
+            /* NOT FOR BROWSER ONLY */
             data: [
-                ...fix
-                    ? [
-                        {
-                            range: createRange(root, ...fix.range),
-                            newText: fix.text,
-                            title: `Fix: ${fix.desc}`,
-                            fix: true,
-                        },
-                    ]
-                    : [],
-                ...suggestions
-                    ? suggestions.map(({ range, text, desc }) => ({
-                        range: createRange(root, ...range),
-                        newText: text,
-                        title: `Suggestion: ${desc}`,
-                        fix: false,
-                    }))
-                    : [],
+                ...fix ? [getQuickFix(root, fix, true)] : [],
+                ...suggestions ? suggestions.map(suggestion => getQuickFix(root, suggestion)) : [],
             ],
         }));
     }
-    async #provideFoldingRangesOrDocumentSymbols(text, fold = true) {
+    /**
+     * Provide folding ranges
+     *
+     * 提供折叠范围
+     * @param text source Wikitext / 源代码
+     */
+    async provideFoldingRanges(text) {
         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 = root.getLines(), { length } = lines, levels = new Array(6), tokens = root.querySelectorAll(fold ? 'heading-title,table,template,magic-word' : 'heading-title');
+        const root = await this.#queue(text), { length } = root.getLines(), ranges = [], levels = new Array(6), tokens = root.querySelectorAll('heading-title,table,template,magic-word');
+        for (const token of [...tokens].reverse()) { // 提高 getBoundingClientRect 的性能
+            token.getRelativeIndex();
+        }
         for (const token of tokens) {
-            const { top, height, 
-            /* NOT FOR BROWSER ONLY */
-            left, width, } = token.getBoundingClientRect();
+            const { top, height } = token.getBoundingClientRect();
             if (token.type === 'heading-title') {
                 const { level } = token.parentNode;
-                if (fold) {
-                    for (let i = level - 1; i < 6; i++) {
-                        const startLine = levels[i];
-                        if (startLine !== undefined && startLine < top - 1) {
-                            ranges.push({
-                                startLine,
-                                endLine: top - 1,
-                                kind: 'region',
-                            });
-                        }
-                        levels[i] = undefined;
-                    }
-                    levels[level - 1] = top + height - 1; // 从标题的最后一行开始折叠
-                    /* NOT FOR BROWSER ONLY */
-                }
-                else {
-                    for (let i = level - 1; i < 6; i++) {
-                        getSectionEnd(sections[i], lines, top - 1);
-                        sections[i] = undefined;
-                    }
-                    const section = token.text().trim() || ' ', name = names.has(section)
-                        ? new Array(names.size).fill('').map((_, i) => `${section.trim()}_${i + 2}`)
-                            .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, height, width + level),
-                    }, info = {
-                        name,
-                        kind: 15,
-                        range: { start: selectionRange.start },
-                        selectionRange,
-                    };
-                    names.add(name);
-                    sections[level - 1] = info;
-                    if (container) {
-                        container.children ??= [];
-                        container.children.push(info);
+                for (let i = level - 1; i < 6; i++) {
+                    const startLine = levels[i];
+                    if (startLine !== undefined && startLine < top - 1) {
+                        ranges.push({
+                            startLine,
+                            endLine: top - 1,
+                            kind: 'region',
+                        });
                     }
-                    else {
-                        symbols.push(info);
-                    }
-                    /* NOT FOR BROWSER ONLY END */
+                    levels[i] = undefined;
                 }
+                levels[level - 1] = top + height - 1; // 从标题的最后一行开始折叠
             }
-            else if (fold && height > 2) {
+            else if (height > 2) {
                 ranges.push({
                     startLine: top, // 从表格或模板的第一行开始折叠
                     endLine: top + height - 2,
@@ -487,208 +504,206 @@ class LanguageService {
                 });
             }
         }
-        if (fold) {
-            for (const startLine of levels) {
-                if (startLine !== undefined && startLine < length - 1) {
-                    ranges.push({
-                        startLine,
-                        endLine: length - 1,
-                        kind: 'region',
-                    });
-                }
-            }
-            /* NOT FOR BROWSER ONLY */
-        }
-        else {
-            for (const section of sections) {
-                getSectionEnd(section, lines, length - 1);
+        for (const startLine of levels) {
+            if (startLine !== undefined && startLine < length - 1) {
+                ranges.push({
+                    startLine,
+                    endLine: length - 1,
+                    kind: 'region',
+                });
             }
-            /* NOT FOR BROWSER ONLY END */
         }
-        return fold ? ranges : symbols;
-    }
-    /**
-     * 提供折叠范围
-     * @param text 源代码
-     */
-    async provideFoldingRanges(text) {
-        return this.#provideFoldingRangesOrDocumentSymbols(text);
+        return ranges;
     }
     /**
+     * Provide links
+     *
      * 提供链接
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      */
     async provideLinks(text) {
         this.#checkSignature();
         /^(?:http:\/\/|\/\/)/iu; // eslint-disable-line @typescript-eslint/no-unused-expressions
-        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) => {
+        const { articlePath, protocol } = index_1.default.getConfig(), absolute = articlePath?.includes('//'), protocolRegex = new RegExp(`^(?:${protocol}|//)`, 'iu');
+        return (await this.#queue(text))
+            .querySelectorAll(`magic-link,ext-link-url,free-ext-link,attr-value,image-parameter#link${absolute ? ',link-target,template-name,invoke-module' : ''}`).reverse()
+            .map((token) => {
             const { type, parentNode, firstChild, lastChild, childNodes } = token, { name, tag } = parentNode;
             if (!(type !== 'attr-value'
                 || name === 'src' && ['templatestyles', 'img'].includes(tag)
                 || name === 'cite' && ['blockquote', 'del', 'ins', 'q'].includes(tag))
                 || !isPlain(childNodes)) {
-                return [];
+                return false;
+            }
+            let target = childNodes.filter((node) => node.type === 'text')
+                .map(({ data }) => data).join('').trim();
+            if (!target) {
+                return false;
             }
-            let target = type === 'image-parameter'
-                ? element_1.AstElement.prototype.toString.call(token, true).trim()
-                : token.toString(true).trim();
             try {
-                if (type === 'magic-link') {
-                    if (target.startsWith('ISBN')) {
-                        target = getUrl(`Special:Booksources/${target.slice(4).replace(/[\p{Zs}\t-]/gu, '')}`);
-                    }
-                    else {
-                        target = target.startsWith('RFC')
-                            ? `https://tools.ietf.org/html/rfc${target.slice(3).trim()}`
-                            : `https://pubmed.ncbi.nlm.nih.gov/${target.slice(4).trim()}`;
+                if (token.is('magic-link')
+                    || token.is('ext-link-url')
+                    || token.is('free-ext-link')) {
+                    target = token.getUrl(articlePath);
+                }
+                else if (type === 'link-target' && (parentNode.is('link')
+                    || parentNode.is('redirect-target')
+                    || parentNode.is('category'))) {
+                    if (target.startsWith('/')) {
+                        return false;
                     }
+                    target = parentNode.link.getUrl(articlePath);
+                }
+                else if (type === 'template-name') {
+                    target = parentNode.getAttribute('title').getUrl(articlePath);
                 }
-                else if (['link-target', 'template-name', 'invoke-module'].includes(type)
+                else if (['link-target', 'invoke-module'].includes(type)
                     || type === 'attr-value' && name === 'src' && tag === 'templatestyles'
                     || type === 'image-parameter' && !protocolRegex.test(target)) {
-                    if (target.startsWith('/')) {
-                        return [];
+                    if (!absolute || target.startsWith('/')) {
+                        return false;
                     }
                     let ns = 0;
-                    if (type === 'template-name' || type === 'attr-value') {
+                    if (type === 'attr-value') {
                         ns = 10;
                     }
                     else if (type === 'invoke-module') {
                         ns = 828;
                     }
-                    target = getUrl(target, ns);
+                    const title = index_1.default
+                        .normalizeTitle(target, ns, false, undefined, true);
+                    /* istanbul ignore if */
+                    if (!title.valid) {
+                        return false;
+                    }
+                    target = title.getUrl();
                 }
-                if (target.startsWith('//')) {
+                if (typeof target === 'string' && target.startsWith('//')) {
                     target = `https:${target}`;
                 }
                 target = new URL(target).href;
                 if (type === 'image-parameter') {
-                    const rect = firstChild.getBoundingClientRect(), { top, left, height, width } = lastChild.getBoundingClientRect();
-                    return [
-                        {
-                            range: {
-                                start: { line: rect.top, character: rect.left },
-                                end: (0, lint_1.getEndPos)(top, left, height, width),
-                            },
-                            target,
+                    const { top, left, height, width } = lastChild.getBoundingClientRect(), rect = firstChild.getBoundingClientRect();
+                    return {
+                        range: {
+                            start: { line: rect.top, character: rect.left },
+                            end: (0, lint_1.getEndPos)(top, left, height, width),
                         },
-                    ];
+                        target,
+                    };
                 }
-                return [{ range: createNodeRange(token), target }];
+                return { range: createNodeRange(token), target };
             }
             catch {
-                return [];
+                return false;
             }
-        });
+        }).filter(Boolean);
     }
-    async #provideReferencesOrDefinition(text, position, usage) {
+    /**
+     * Provide references
+     *
+     * 提供引用
+     * @param text source Wikitext / 源代码
+     * @param position 位置
+     */
+    async provideReferences(text, position) {
         this.#checkSignature();
-        const renameTypes = [
-            'arg-name',
-            'template-name',
-            'magic-word-name',
-            'link-target',
-            'parameter-key',
-        ], types = [
-            'ext',
-            'html',
-            'attr-key',
-            'image-parameter',
-            'heading-title',
-            'heading',
-            ...renameTypes,
-        ], root = await this.#queue(text), node = elementFromWord(root, position), { type } = node, refName = getRefName(node), refGroup = getRefGroup(node);
-        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)))) {
+        const root = await this.#queue(text), { offsetNode, offset } = caretPositionFromWord(root, position), element = offsetNode.type === 'text' ? offsetNode.parentNode : offsetNode, node = offset === 0 && (element.type === 'ext-attr-dirty' || element.type === 'html-attr-dirty')
+            ? element.parentNode.parentNode
+            : element, { type } = node, refName = getRefName(node), refGroup = getRefGroup(node);
+        if (!refName && !refGroup && !referenceTypes.has(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) {
-                return getRefName(token) === refName
-                    && n === 'name' && parentNode.parentNode.innerText;
-            }
-            return type === 'attr-value'
-                ? getRefName(token) === refName || getRefGroup(token) === refGroup
-                : getName(token) === name;
-        }).map((token) => ({
+        const name = getName(node), refs = root.querySelectorAll(type === 'heading-title' ? 'heading' : type).filter(token => type === 'attr-value'
+            ? getRefName(token) === refName || getRefGroup(token) === refGroup
+            : getName(token) === name).map((token) => ({
             range: createNodeRange(token.type === 'parameter-key' ? token.parentNode : token),
         }));
         return refs.length === 0 ? undefined : refs;
     }
     /**
-     * 提供引用
-     * @param text 源代码
-     * @param position 位置
-     */
-    async provideReferences(text, position) {
-        return this.#provideReferencesOrDefinition(text, position, 0);
-    }
-    /**
+     * Provide definitions
+     *
      * 提供定义
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      * @param position 位置
      */
     async provideDefinition(text, position) {
-        return this.#provideReferencesOrDefinition(text, position, 1);
+        this.#checkSignature();
+        const root = await this.#queue(text), node = root.elementFromPoint(position.character, position.line), ext = node.is('ext') && node.name === 'ref'
+            ? node
+            : node.closest('ext#ref'), refName = getRefTagAttr(ext, 'name');
+        if (!refName) {
+            return undefined;
+        }
+        const refGroup = getRefTagAttr(ext, 'group'), refs = root.querySelectorAll('ext#ref').filter(token => token.innerText
+            && getRefTagAttr(token, 'name') === refName
+            && getRefTagAttr(token, 'group') === refGroup).map(({ lastChild }) => ({
+            range: createNodeRange(lastChild),
+        }));
+        return refs.length === 0 ? undefined : refs;
     }
     /**
+     * Provide locations for renaming
+     *
      * 提供变量更名准备
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      * @param position 位置
      */
     async resolveRenameLocation(text, position) {
-        return this.#provideReferencesOrDefinition(text, position, 2);
+        this.#checkSignature();
+        const root = await this.#queue(text), node = root.elementFromPoint(position.character, position.line), { type } = node, refName = getRefName(node), refGroup = getRefGroup(node);
+        return !refName && !refGroup && (!renameTypes.has(type)
+            || type === 'parameter-key' && /^[1-9]\d*$/u.test(node.parentNode.name)
+            || type === 'link-target' && !['link', 'redirect-target'].includes(node.parentNode.type))
+            ? undefined
+            : createNodeRange(node);
     }
     /**
+     * Provide rename edits
+     *
      * 变量更名
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      * @param position 位置
-     * @param newName 新名称
+     * @param newName new name / 新名称
      */
     async provideRenameEdits(text, position, 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 root = await this.#queue(text), node = root.elementFromPoint(position.character, position.line), { type } = node, refName = getRefName(node), refNameGroup = refName && getRefTagAttr(node.parentNode.parentNode, 'group'), refGroup = getRefGroup(node), 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
+                ? getRefGroup(token) === refGroup
+                    || getRefName(token) === refName
+                        && getRefTagAttr(token.parentNode.parentNode, 'group') === refNameGroup
                 : getName(token) === name;
         });
-        if (refs.length === 0) {
-            return undefined;
-        }
-        return {
-            changes: {
-                '': refs.map((ref) => ({
-                    range: createNodeRange(ref),
-                    newText: newName,
-                })),
-            },
-        };
+        return refs.length === 0
+            ? undefined
+            : {
+                changes: {
+                    '': refs.map((ref) => ({
+                        range: createNodeRange(ref),
+                        newText: newName,
+                    })),
+                },
+            };
     }
     /**
      * 检索解析器函数
      * @param name 函数名
      */
     #getParserFunction(name) {
-        return this.data.parserFunctions.find(({ aliases }) => aliases.some(alias => alias.replace(/^#/u, '') === name));
+        return this.data.parserFunctions
+            .find(({ aliases }) => aliases.some(alias => alias.replace(/^#/u, '') === name));
     }
     /**
+     * Provide hover information
+     *
      * 提供悬停信息
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      * @param position 位置
      */
     async provideHover(text, position) {
@@ -697,14 +712,31 @@ class LanguageService {
             return undefined;
         }
         this.#checkSignature();
-        const token = elementFromWord(await this.#queue(text), position);
-        let info, f;
-        if (token.is('double-underscore')) {
+        const root = await this.#queue(text), { offsetNode, offset } = caretPositionFromWord(root, position), token = offsetNode.type === 'text' ? offsetNode.parentNode : offsetNode, { type, parentNode, length, name } = token;
+        let info, f, range;
+        if (token.is('double-underscore') && offset > 0) {
             info = this.data.behaviorSwitches.find(({ aliases }) => aliases.includes(token.innerText.toLowerCase()));
         }
-        else if (token.type === 'magic-word-name') {
-            info = this.#getParserFunction(token.parentNode.name);
-            f = token.text().trim();
+        else if (type === 'magic-word-name') {
+            info = this.#getParserFunction(parentNode.name);
+            f = token.toString(true).trim();
+        }
+        else if (token.is('magic-word') && !token.modifier && length === 1
+            && (offset > 0 || token.getBoundingClientRect().left === position.character)) {
+            info = this.#getParserFunction(name);
+            f = token.firstChild.toString(true).trim();
+        }
+        else if ((token.is('magic-word') || token.is('template'))
+            && token.modifier && offset >= 2 && token.getRelativeIndex(0) > offset) {
+            f = token.modifier.trim().slice(0, -1);
+            info = this.#getParserFunction(f.toLowerCase());
+            if (info) {
+                const aIndex = token.getAbsoluteIndex();
+                range = {
+                    start: positionAt(root, aIndex + 2),
+                    end: positionAt(root, aIndex + token.modifier.trimEnd().length + 1),
+                };
+            }
         }
         return info && {
             contents: {
@@ -714,12 +746,14 @@ class LanguageService {
                     : '')
                     + info.description,
             },
-            range: createNodeRange(token),
+            range: range ?? createNodeRange(token),
         };
     }
     /**
+     * Provide signature help for magic words
+     *
      * 提供魔术字帮助
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      * @param position 位置
      */
     async provideSignatureHelp(text, position) {
@@ -732,36 +766,47 @@ 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 + 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') {
+        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)}}}`);
+        if (!lastChild.is('magic-word') || lastChild.length === 1) {
             return undefined;
         }
-        const info = this.#getParserFunction(name);
+        const { name, childNodes, firstChild } = lastChild, info = this.#getParserFunction(name);
         if (!info?.signatures) {
             return undefined;
         }
-        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)
+        const n = childNodes.length - 1, candidates = 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());
-            })).map((params) => ({
-            label: `{{${f}${params.length === 0 ? '' : ':'}${params.map(({ label }) => label).join('|')}}}`,
-            parameters: params.map(({ label, const: c }) => ({
-                label,
-                ...c ? { documentation: 'Predefined parameter' } : undefined,
+                const p = c && i < n && childNodes[i + 1]?.toString(true).trim();
+                return !p || label.toLowerCase().includes(p.toLowerCase());
+            }));
+        if (candidates.length === 0) {
+            return undefined;
+        }
+        let j = -1;
+        for (let cur = lastChild.getAbsoluteIndex() + lastChild.getAttribute('padding'); j < n; j++) {
+            cur += childNodes[j + 1].toString().length + 1;
+            if (cur > character) {
+                break;
+            }
+        }
+        const f = firstChild.toString(true).trim();
+        return {
+            signatures: candidates.map((params) => ({
+                label: `{{${f}${params.length === 0 ? '' : ':'}${params.map(({ label }) => label).join('|')}}}`,
+                parameters: params.map(({ label, const: c }) => ({
+                    label,
+                    ...c ? { documentation: 'Predefined parameter' } : undefined,
+                })),
+                ...params.length < n ? { activeParameter: Math.min(j, params.length - 1) } : undefined,
             })),
-            ...params.length < n ? { activeParameter: Math.min(activeParameter, params.length - 1) } : undefined,
-        }));
-        return { signatures, activeParameter };
+            activeParameter: j,
+        };
     }
     /**
+     * Provide CodeLens
+     *
      * 提供 CodeLens
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      */
     async provideInlayHints(text) {
         this.#checkSignature();
@@ -769,7 +814,7 @@ class LanguageService {
         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) => ({
+                .reverse().map((parameter) => ({
                 position: positionAt(root, parameter.getAbsoluteIndex()),
                 label: `${parameter.name}=`,
                 kind: 2,
@@ -778,7 +823,12 @@ class LanguageService {
         return hints;
     }
     /* NOT FOR BROWSER ONLY */
-    /** @implements */
+    /**
+     * Provide quick fixes
+     *
+     * 提供快速修复建议
+     * @param diagnostics grammar diagnostics / 语法诊断信息
+     */
     // eslint-disable-next-line @typescript-eslint/class-methods-use-this
     provideCodeAction(diagnostics) {
         return diagnostics.flatMap(diagnostic => diagnostic.data.map((data) => ({
@@ -792,11 +842,52 @@ class LanguageService {
         })));
     }
     /**
+     * Provide document sections
+     *
      * 提供章节
-     * @param text 源代码
+     * @param text source Wikitext / 源代码
      */
     async provideDocumentSymbols(text) {
-        return this.#provideFoldingRangesOrDocumentSymbols(text, false);
+        this.#checkSignature();
+        const root = await this.#queue(text), lines = root.getLines(), { length } = lines, symbols = [], names = new Set(), sections = new Array(6), tokens = root.querySelectorAll('heading-title');
+        for (const token of [...tokens].reverse()) { // 提高 getBoundingClientRect 的性能
+            token.getRelativeIndex();
+        }
+        for (const token of tokens) {
+            const { top, height, left, width } = token.getBoundingClientRect();
+            if (token.type === 'heading-title') {
+                const { level } = token.parentNode;
+                for (let i = level - 1; i < 6; i++) {
+                    getSectionEnd(sections[i], lines, top - 1);
+                    sections[i] = undefined;
+                }
+                const section = token.text().trim() || ' ', name = names.has(section)
+                    ? new Array(names.size).fill('').map((_, i) => `${section.trim()}_${i + 2}`)
+                        .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, height, width + level),
+                }, info = {
+                    name,
+                    kind: 15,
+                    range: { start: selectionRange.start },
+                    selectionRange,
+                };
+                names.add(name);
+                sections[level - 1] = info;
+                if (container) {
+                    container.children ??= [];
+                    container.children.push(info);
+                }
+                else {
+                    symbols.push(info);
+                }
+            }
+        }
+        for (const section of sections) {
+            getSectionEnd(section, lines, length - 1);
+        }
+        return symbols;
     }
 }
 exports.LanguageService = LanguageService;