wikiparser-node 1.17.1 → 1.18.1

package/dist/lib/lsp.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LanguageService = exports.tasks = void 0;
+exports.LanguageService = exports.isAttr = exports.tasks = void 0;
 const common_1 = require("@bhsd/common");
 const sharable_1 = require("../util/sharable");
 const lint_1 = require("../util/lint");
@@ -13,15 +13,19 @@ const index_1 = __importDefault(require("../index"));
 const constants_1 = require("../util/constants");
 /* NOT FOR BROWSER END */
 /* NOT FOR BROWSER ONLY */
+const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const util_1 = __importDefault(require("util"));
+const child_process_1 = require("child_process");
+const crypto_1 = require("crypto");
 const stylelint_1 = require("@bhsd/common/dist/stylelint");
+const config_1 = __importDefault(require("../bin/config"));
 const document_1 = require("./document");
-/* NOT FOR BROWSER ONLY */
 /** @see https://www.npmjs.com/package/stylelint-config-recommended */
 const cssRules = {
     'block-no-empty': null,
     'property-no-unknown': null,
-}, jsonSelector = document_1.jsonTags.map(s => `ext-inner#${s}`).join();
+}, jsonSelector = document_1.jsonTags.map(s => `ext-inner#${s}`).join(), scores = new Map();
 /* 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']), renameTypes = new Set([
@@ -39,11 +43,30 @@ const refTags = new Set(['ref']), referencesTags = new Set(['ref', 'references']
     'heading',
     ...renameTypes,
 ]), plainTypes = new Set(['text', 'comment', 'noinclude', 'include']), cssSelector = ['ext', 'html', 'table'].map(s => `${s}-attr#style`).join();
+/**
+ * Check if a token is a plain attribute.
+ * @param token
+ * @param token.type
+ * @param token.parentNode
+ * @param token.length
+ * @param token.firstChild
+ * @param style whether it is a style attribute
+ */
+const isAttr = ({ type, parentNode, length, firstChild }, style) => type === 'attr-value' && length === 1 && firstChild.type === 'text'
+    && (!style
+        || parentNode.name === 'style'
+            && Boolean(document_1.cssLSP));
+exports.isAttr = isAttr;
+/**
+ * Check if a token is an HTML attribute.
+ * @param token
+ */
+const isHtmlAttr = (token) => token.type === 'html-attr' || token.type === 'table-attr';
 /**
  * Check if all child nodes are plain text or comments.
- * @param childNodes child nodes
+ * @param token
  */
-const isPlain = (childNodes) => childNodes.every(({ type }) => plainTypes.has(type));
+const isPlain = (token) => token.childNodes.every(({ type }) => plainTypes.has(type));
 /**
  * Get the position of a character in the document.
  * @param root root token
@@ -83,28 +106,39 @@ const createNodeRange = (token) => {
  * @param pos.line line number
  * @param pos.character character number
  * @param extra extra text
+ * @param getDoc documentation method
  */
-const getCompletion = (words, kind, mt, { line, character }, extra) => [...new Set(words)].map((w) => ({
-    label: w,
-    kind,
-    textEdit: {
-        range: {
-            start: { line, character: character - mt.length },
-            end: { line, character },
+const getCompletion = (words, kind, mt, { line, character }, extra, getDoc) => [...new Set(words)].map((w) => {
+    const doc = getDoc?.(w)?.description;
+    return {
+        label: w,
+        kind,
+        textEdit: {
+            range: {
+                start: { line, character: character - mt.length },
+                end: { line, character },
+            },
+            newText: w + (extra ?? ''),
         },
-        newText: w + (extra ?? ''),
-    },
-}));
+        ...doc && {
+            documentation: {
+                kind: 'markdown',
+                value: doc,
+            },
+        },
+    };
+});
 /**
  * Get the caret position at the position from a word.
  * @param root root token
+ * @param text source code
  * @param pos position
  * @param pos.line line number
  * @param pos.character character number
  */
-const caretPositionFromWord = (root, { line, character }) => {
+const caretPositionFromWord = (root, text, { line, character }) => {
     const index = root.indexFromPos(line, character);
-    return root.caretPositionFromIndex(index + Number(/\w/u.test(root.toString().charAt(index))));
+    return root.caretPositionFromIndex(index + Number(/\w/u.test(text.charAt(index))));
 };
 /**
  * Get the attribute of a `<ref>` tag.
@@ -170,15 +204,13 @@ const getQuickFix = (root, fix, preferred = false) => ({
 });
 /* NOT FOR BROWSER ONLY */
 /**
- * Get the position of a Stylelint error
- * @param rect bounding client rect of the token
- * @param bottom bottom of the style block
- * @param line line number
- * @param column column number
+ * Correct the position of an error.
+ * @param height
+ * @param width
+ * @param line 0-based line number
+ * @param column 0-based column number
  */
-const getStylelintPos = (rect, bottom, line, column) => {
-    const { top, left, height, width } = rect, start = bottom - height - 1;
-    line -= start;
+const adjustPos = (height, width, line, column) => {
     if (line === 0) {
         line = 1;
         column = 0;
@@ -187,8 +219,39 @@ const getStylelintPos = (rect, bottom, line, column) => {
         line = height;
         column = width;
     }
+    return [line, column];
+};
+/**
+ * Get the position of a Stylelint error.
+ * @param rect bounding client rect of the token
+ * @param bottom bottom of the style block
+ * @param line line number
+ * @param column column number
+ */
+const getStylelintPos = (rect, bottom, line, column) => {
+    const { top, left, height, width } = rect, start = bottom - height - 1;
+    line -= start;
+    [line, column] = adjustPos(height, width, line, column);
     return (0, lint_1.getEndPos)(top, left, line, column);
 };
+/**
+ * Convert LilyPond errors to VSCode diagnostics.
+ * @param root root token
+ * @param token `<score>` extension token
+ * @param errors LilyPond errors
+ */
+const getLilyPondDiagnostics = (root, token, errors) => {
+    const { top, left } = root.posFromIndex(token.lastChild.getAbsoluteIndex());
+    return errors.map(({ line, col, message }) => {
+        const pos = (0, lint_1.getEndPos)(top, left, line, col);
+        return {
+            range: { start: pos, end: pos },
+            severity: 1,
+            source: 'LilyPond',
+            message,
+        };
+    });
+};
 /**
  * Get the end position of a section.
  * @param section section
@@ -215,23 +278,49 @@ class LanguageService {
     #completionConfig;
     include = true;
     /** @private */
+    config;
+    /** @private */
     data;
+    /* NOT FOR BROWSER ONLY */
+    lilypond;
+    /** @private */
+    lilypondData;
+    /* NOT FOR BROWSER ONLY END */
     /** @param uri 任务标识 */
     constructor(uri) {
         exports.tasks.set(uri, this);
-        /* NOT FOR BROWSER ONLY */
-        Object.defineProperty(this, 'data', {
-            value: require(path_1.default.join('..', '..', 'data', 'signatures')),
-            enumerable: false,
+        Object.defineProperties(this, {
+            config: { enumerable: false },
+            /* NOT FOR BROWSER ONLY */
+            data: {
+                value: require(path_1.default.join('..', '..', 'data', 'signatures')),
+                enumerable: false,
+            },
+            lilypondData: {
+                value: require(path_1.default.join('..', '..', 'data', 'ext', 'score')),
+                enumerable: false,
+            },
         });
     }
     /** @implements */
     destroy() {
         Object.setPrototypeOf(this, null);
+        /* NOT FOR BROWSER ONLY */
+        const dir = path_1.default.join(__dirname, 'lilypond');
+        if (fs_1.default.existsSync(dir)) {
+            for (const file of fs_1.default.readdirSync(dir)) {
+                (async () => {
+                    try {
+                        await fs_1.default.promises.unlink(path_1.default.join(dir, file));
+                    }
+                    catch { }
+                })();
+            }
+        }
     }
     /** 检查解析设置有无更新 */
     #checkConfig() {
-        return this.#config === index_1.default.config && this.#include === this.include;
+        return this.#config === this.config && this.#include === this.include;
     }
     /**
      * 提交解析任务
@@ -257,10 +346,10 @@ class LanguageService {
      * - 总是返回最新的解析结果
      */
     async #parse() {
-        const config = index_1.default.getConfig();
-        this.#config = index_1.default.config;
+        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, config);
+        const text = this.#text, root = await index_1.default.partialParse(text, () => this.#text, this.include, this.config);
         if (this.#checkConfig() && this.#text === text) {
             this.#done = root;
             this.#running = undefined;
@@ -295,10 +384,10 @@ class LanguageService {
      * - 总是返回最新的解析结果
      */
     async #parseSignature() {
-        const config = index_1.default.getConfig();
-        this.#config = index_1.default.config;
+        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, config);
+        const text = this.#text2, root = await index_1.default.partialParse(text, () => this.#text2, this.include, this.config);
         if (this.#checkConfig() && this.#text2 === text) {
             this.#done2 = root;
             this.#running2 = undefined;
@@ -319,14 +408,38 @@ class LanguageService {
      */
     async provideDocumentColors(rgba, text, hsl = true) {
         const root = await this.#queue(text);
+        /* NOT FOR BROWSER ONLY */
+        let colors;
+        try {
+            colors = new RegExp(String.raw `\b${Object.keys((await import('color-name')).default).join('|')}\b`, 'giu');
+        }
+        catch { }
+        /* NOT FOR BROWSER ONLY END */
         return root.querySelectorAll('attr-value,parameter-value,arg-default').reverse()
-            .flatMap(({ type, childNodes }) => {
-            if (type !== 'attr-value' && !isPlain(childNodes)) {
+            .flatMap(token => {
+            const { type, childNodes, 
+            /* NOT FOR BROWSER ONLY */
+            parentNode, } = token;
+            if (type !== 'attr-value' && !isPlain(token)) {
                 return [];
+                /* NOT FOR BROWSER ONLY */
             }
+            else if ((0, exports.isAttr)(token, true)) {
+                const textDoc = new document_1.EmbeddedCSSDocument(root, token);
+                return document_1.cssLSP.findDocumentColors(textDoc, textDoc.styleSheet);
+                /* NOT FOR BROWSER ONLY END */
+            }
+            /* NOT FOR BROWSER ONLY */
+            const isStyle = colors && type === 'attr-value' && parentNode.name === 'style';
+            /* NOT FOR BROWSER ONLY END */
             return childNodes.filter((child) => child.type === 'text').reverse()
                 .flatMap(child => {
-                const parts = (0, common_1.splitColors)(child.data, hsl).filter(([, , , isColor]) => isColor);
+                const { data } = child, parts = (0, common_1.splitColors)(data, hsl).filter(([, , , isColor]) => isColor);
+                /* NOT FOR BROWSER ONLY */
+                if (isStyle) {
+                    parts.push(...[...data.matchAll(colors)].map(({ index, 0: s }) => [s, index, index + s.length, true]));
+                }
+                /* NOT FOR BROWSER ONLY END */
                 if (parts.length === 0) {
                     return [];
                 }
@@ -364,8 +477,9 @@ 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));
+        if (!this.#completionConfig || this.#completionConfig[1] !== this.config) {
+            this.config ??= index_1.default.getConfig();
+            const { nsid, ext, html, parserFunction: [insensitive, sensitive, ...other], doubleUnderscore, protocol, img, } = this.config, tags = new Set([ext, html].flat(2));
             // 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
@@ -382,23 +496,27 @@ class LanguageService {
                 // attribute key
                 + String.raw `<(\w+)(?:\s(?:[^<>{}|=\s]+(?:\s*=\s*(?:[^\s"']\S*|(["']).*?\8))?(?=\s))*)?\s(\w*)`
                 + ')$', 'iu');
-            this.#completionConfig = {
-                re,
-                ext,
-                tags,
-                allTags: [...tags, 'onlyinclude', 'includeonly', 'noinclude'],
-                functions: [
-                    Object.keys(insensitive),
-                    Array.isArray(sensitive) ? /* istanbul ignore next */ sensitive : Object.keys(sensitive),
-                    other,
-                ].flat(2),
-                switches: doubleUnderscore.slice(0, 2).flat().map(w => `__${w}__`),
-                protocols: protocol.split('|'),
-                params: Object.keys(img).filter(k => k.endsWith('$1') || !k.includes('$1'))
-                    .map(k => k.replace(/\$1$/u, '')),
-            };
+            this.#completionConfig = [
+                {
+                    re,
+                    ext,
+                    tags,
+                    allTags: [...tags, 'onlyinclude', 'includeonly', 'noinclude'],
+                    functions: [
+                        Object.keys(insensitive),
+                        Array.isArray(sensitive) ? /* istanbul ignore next */ sensitive : Object.keys(sensitive),
+                        other,
+                    ].flat(2),
+                    switches: doubleUnderscore.slice(0, 2).flat().map(w => `__${w}__`),
+                    protocols: protocol.split('|'),
+                    params: Object.keys(img)
+                        .filter(k => k.endsWith('$1') || !k.includes('$1'))
+                        .map(k => k.replace(/\$1$/u, '')),
+                },
+                this.config,
+            ];
         }
-        return this.#completionConfig;
+        return this.#completionConfig[0];
     }
     /**
      * Provide auto-completion
@@ -408,13 +526,25 @@ class LanguageService {
      * @param position 位置
      */
     async provideCompletionItems(text, position) {
-        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) ?? '');
+        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) ?? ''), [, , iAlias = {}, sAlias = {}] = this.config.doubleUnderscore;
         if (mt?.[1] !== undefined) { // tag
             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);
+            return getCompletion(switches, 'Constant', mt[4], position, '', name => {
+                if (!this.data) {
+                    return undefined;
+                }
+                name = name.slice(2, -2);
+                if (name in iAlias) {
+                    name = iAlias[name];
+                }
+                else if (name in sAlias) {
+                    name = sAlias[name];
+                }
+                return this.#getBehaviorSwitch(name.toLowerCase());
+            });
         }
         else if (mt?.[5] !== undefined) { // protocol
             return getCompletion(protocols, 'Reference', mt[5], position);
@@ -428,12 +558,23 @@ class LanguageService {
                 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;
+            const [insensitive, sensitive] = this.config.parserFunction, isOld = Array.isArray(sensitive), colon = match.startsWith(':'), str = colon ? match.slice(1).trimStart() : match;
             return mt[2] === '[['
                 ? getCompletion(// link
                 root.querySelectorAll('link,file,category,redirect-target').filter(token => token !== cur).map(({ name }) => name), 'Folder', str, position)
                 : [
-                    ...getCompletion(functions, 'Function', match, position),
+                    ...getCompletion(functions, 'Function', match, position, '', name => {
+                        if (!this.data) {
+                            return undefined;
+                        }
+                        else if (name in insensitive) {
+                            name = insensitive[name];
+                        }
+                        else if (!isOld && name in sensitive) {
+                            name = sensitive[name];
+                        }
+                        return this.#getParserFunction(name.toLowerCase());
+                    }),
                     ...match.startsWith('#')
                         ? []
                         : getCompletion(root.querySelectorAll('template').filter(token => token !== cur)
@@ -493,7 +634,7 @@ class LanguageService {
             if (t === 'magic-word' && n !== 'invoke') {
                 return undefined;
             }
-            const index = root.indexFromPos(line, character), key = this.#text.slice(cur.getAbsoluteIndex(), index).trimStart(), [module, func] = t === 'magic-word' ? transclusion.getModule() : [];
+            const key = this.#text.slice(cur.getAbsoluteIndex(), root.indexFromPos(line, character)).trimStart(), [module, func] = t === 'magic-word' ? transclusion.getModule() : [];
             return key
                 ? getCompletion(root.querySelectorAll('parameter').filter(token => {
                     if (token === parentNode
@@ -511,7 +652,7 @@ class LanguageService {
                 : undefined;
             /* NOT FOR BROWSER ONLY */
         }
-        else if (document_1.cssLSP && type === 'attr-value' && parentNode.name === 'style' && cur.length === 1) {
+        else if ((0, exports.isAttr)(cur, true)) {
             const textDoc = new document_1.EmbeddedCSSDocument(root, cur);
             return document_1.cssLSP.doComplete(textDoc, position, textDoc.styleSheet).items.map((item) => ({
                 ...item,
@@ -524,8 +665,37 @@ class LanguageService {
         else if (document_1.jsonLSP && type === 'ext-inner' && document_1.jsonTags.includes(cur.name)) {
             const textDoc = new document_1.EmbeddedJSONDocument(root, cur);
             return (await document_1.jsonLSP.doComplete(textDoc, position, textDoc.jsonDoc))?.items;
+        }
+        else if (type === 'ext-inner' && cur.name === 'score') {
+            const lang = parentNode.getAttr('lang');
+            if (lang !== undefined && lang !== 'lilypond') {
+                return undefined;
+            }
+            const before = this.#text.slice(cur.getAbsoluteIndex(), root.indexFromPos(line, character)), comment = before.lastIndexOf('%');
+            if (comment !== -1
+                && (before.charAt(comment + 1) === '{' || !before.slice(comment).includes('\n'))) {
+                return undefined;
+            }
+            const word = /\\?\b(?:\w|\b(?:->?|\.)|\bly:)+$/u.exec(curLine.slice(0, character))?.[0];
+            if (word) {
+                const { lilypondData } = this;
+                return word.startsWith('\\')
+                    ? getCompletion(lilypondData.filter(w => w.startsWith('\\')), 'Function', word, position)
+                    : [
+                        ...getCompletion(lilypondData.filter(w => /^[a-z]/u.test(w)), 'Variable', word, position),
+                        ...getCompletion(lilypondData.filter(w => /^[A-Z]/u.test(w)), 'Class', word, position),
+                    ];
+            }
             /* NOT FOR BROWSER ONLY END */
         }
+        else if ((0, exports.isAttr)(cur) && isHtmlAttr(parentNode)) {
+            const data = lint_1.htmlData.provideValues(parentNode.tag, parentNode.name);
+            if (data.length === 0) {
+                return undefined;
+            }
+            const val = this.#text.slice(cur.getAbsoluteIndex(), root.indexFromPos(line, character)).trimStart();
+            return getCompletion(data.map(({ name }) => name), 'Value', val, position);
+        }
         return undefined;
     }
     /**
@@ -559,13 +729,13 @@ class LanguageService {
             ],
         })), 
         /* eslint-disable @stylistic/operator-linebreak */
-        cssDiagnostics = document_1.stylelint ?
+        cssDiagnostics = await document_1.stylelint ?
             await (async () => {
                 const tokens = this.findStyleTokens();
                 if (tokens.length === 0) {
                     return [];
                 }
-                const cssErrors = await (0, stylelint_1.styleLint)(await document_1.stylelint, tokens.map(({ type, tag, lastChild }, i) => `${type === 'ext-attr' ? 'div' : tag}#${i}{\n${(0, common_1.sanitizeInlineStyle)(lastChild.toString())}\n}`).join('\n'), cssRules);
+                const cssErrors = await (0, stylelint_1.styleLint)((await document_1.stylelint), tokens.map(({ type, tag, lastChild }, i) => `${type === 'ext-attr' ? 'div' : tag}#${i}{\n${(0, common_1.sanitizeInlineStyle)(lastChild.toString())}\n}`).join('\n'), cssRules);
                 if (cssErrors.length === 0) {
                     return [];
                 }
@@ -602,7 +772,58 @@ class LanguageService {
             })) :
             [];
         /* eslint-enable @stylistic/operator-linebreak */
-        return [diagnostics, cssDiagnostics, jsonDiagnostics].flat(2);
+        /* NOT FOR BROWSER ONLY */
+        let lilypondDiagnostics = [];
+        if (this.lilypond) {
+            const tokens = root.querySelectorAll('ext#score').filter(token => {
+                const lang = token.getAttr('lang');
+                return (lang === undefined || lang === 'lilypond') && token.innerText;
+            });
+            if (tokens.length > 0) {
+                const dir = path_1.default.join(__dirname, 'lilypond');
+                if (!fs_1.default.existsSync(dir)) {
+                    fs_1.default.mkdirSync(dir);
+                }
+                lilypondDiagnostics = await Promise.all(tokens.map(async (token) => {
+                    const { innerText } = token, score = `showLastLength = R1${token.getAttr('raw') === undefined ? ` \\score {\n${innerText}\n}` : `\n${innerText}`}`;
+                    if (scores.has(score)) {
+                        return getLilyPondDiagnostics(root, token, scores.get(score));
+                    }
+                    const hash = (0, crypto_1.createHash)('sha256');
+                    hash.update(score);
+                    const file = path_1.default.join(dir, `${hash.digest('hex')}.ly`);
+                    fs_1.default.writeFileSync(file, score);
+                    try {
+                        await util_1.default.promisify(child_process_1.execFile)(this.lilypond, ['-s', '-o', dir, file]);
+                        scores.set(score, []);
+                    }
+                    catch (e) {
+                        const { stderr } = e;
+                        if (stderr) {
+                            const re = new RegExp(String.raw `^${file}:(\d+):(\d+): error: (.+)$`, 'gmu'), lilypondErrors = [...stderr.matchAll(re)].map(([, line, col, msg]) => {
+                                const { offsetHeight, offsetWidth } = token.lastChild, pos = adjustPos(offsetHeight, offsetWidth, Number(line) - 1, Number(col) - 1);
+                                return {
+                                    line: pos[0],
+                                    col: pos[1],
+                                    message: msg,
+                                };
+                            });
+                            scores.set(score, lilypondErrors);
+                            return getLilyPondDiagnostics(root, token, lilypondErrors);
+                        }
+                    }
+                    return [];
+                }));
+            }
+        }
+        /* NOT FOR BROWSER ONLY END */
+        return [
+            diagnostics,
+            cssDiagnostics,
+            jsonDiagnostics,
+            /* NOT FOR BROWSER ONLY */
+            lilypondDiagnostics,
+        ].flat(2);
     }
     /**
      * Provide folding ranges
@@ -668,8 +889,9 @@ class LanguageService {
      * @param text source Wikitext / 源代码
      */
     async provideLinks(text) {
+        this.config ??= index_1.default.getConfig();
         /^(?:http:\/\/|\/\/)/iu; // eslint-disable-line @typescript-eslint/no-unused-expressions
-        const { articlePath, protocol } = index_1.default.getConfig(), absolute = articlePath?.includes('//'), protocolRegex = new RegExp(`^(?:${protocol}|//)`, 'iu');
+        const { articlePath, protocol } = this.config, 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()
@@ -678,7 +900,7 @@ class LanguageService {
             if (!(type !== 'attr-value'
                 || name === 'src' && ['templatestyles', 'img'].includes(tag)
                 || name === 'cite' && ['blockquote', 'del', 'ins', 'q'].includes(tag))
-                || !isPlain(childNodes)) {
+                || !isPlain(token)) {
                 return false;
             }
             let target = childNodes.filter((node) => node.type === 'text')
@@ -718,8 +940,7 @@ class LanguageService {
                     else if (type === 'invoke-module') {
                         ns = 828;
                     }
-                    const title = index_1.default
-                        .normalizeTitle(target, ns, false, undefined, true);
+                    const title = index_1.default.normalizeTitle(target, ns, false, this.config, true);
                     /* istanbul ignore if */
                     if (!title.valid) {
                         return false;
@@ -756,7 +977,7 @@ class LanguageService {
      * @param position 位置
      */
     async provideReferences(text, position) {
-        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')
+        const root = await this.#queue(text), { offsetNode, offset } = caretPositionFromWord(root, this.#text, 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)) {
@@ -836,6 +1057,13 @@ class LanguageService {
                 },
             };
     }
+    /**
+     * 检索状态开关
+     * @param name 魔术字名
+     */
+    #getBehaviorSwitch(name) {
+        return this.data.behaviorSwitches.find(({ aliases }) => aliases.includes(name));
+    }
     /**
      * 检索解析器函数
      * @param name 函数名
@@ -856,40 +1084,74 @@ class LanguageService {
         if (!this.data) {
             return undefined;
         }
-        const root = await this.#queue(text), { offsetNode, offset } = caretPositionFromWord(root, position), token = offsetNode.type === 'text' ? offsetNode.parentNode : offsetNode, { type, parentNode, length, name } = token;
+        const root = await this.#queue(text);
+        let { offsetNode, offset } = caretPositionFromWord(root, this.#text, position);
+        if (offsetNode.type === 'text') {
+            offset += offsetNode.getRelativeIndex();
+            offsetNode = offsetNode.parentNode;
+        }
+        const { type, parentNode, length, name } = offsetNode;
         let info, f, range;
-        if (token.is('double-underscore') && offset > 0) {
-            info = this.data.behaviorSwitches.find(({ aliases }) => aliases.includes(token.innerText.toLowerCase()));
+        if (offsetNode.is('double-underscore') && offset > 0) {
+            info = this.#getBehaviorSwitch(offsetNode.name);
         }
         else if (type === 'magic-word-name') {
             info = this.#getParserFunction(parentNode.name);
-            f = token.toString(true).trim();
+            f = offsetNode.toString(true).trim();
         }
-        else if (token.is('magic-word') && !token.modifier && length === 1
-            && (offset > 0 || root.posFromIndex(token.getAbsoluteIndex()).left === position.character)) {
+        else if (offsetNode.is('magic-word') && !offsetNode.modifier && length === 1
+            && (offset > 0 || root.posFromIndex(offsetNode.getAbsoluteIndex()).left === position.character)) {
             info = this.#getParserFunction(name);
-            f = token.firstChild.toString(true).trim();
+            f = offsetNode.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);
+        else if ((offsetNode.is('magic-word') || offsetNode.is('template'))
+            && offsetNode.modifier && offset >= 2 && offsetNode.getRelativeIndex(0) > offset) {
+            f = offsetNode.modifier.trim().slice(0, -1);
             info = this.#getParserFunction(f.toLowerCase());
             if (info) {
-                const aIndex = token.getAbsoluteIndex();
+                const aIndex = offsetNode.getAbsoluteIndex();
                 range = {
                     start: positionAt(root, aIndex + 2),
-                    end: positionAt(root, aIndex + token.modifier.trimEnd().length + 1),
+                    end: positionAt(root, aIndex + offsetNode.modifier.trimEnd().length + 1),
                 };
             }
             /* NOT FOR BROWSER ONLY */
         }
-        else if (document_1.cssLSP && type === 'attr-value' && length === 1 && parentNode.name === 'style') {
-            const textDoc = new document_1.EmbeddedCSSDocument(root, token);
+        else if ((0, exports.isAttr)(offsetNode, true)) {
+            const textDoc = new document_1.EmbeddedCSSDocument(root, offsetNode);
             return document_1.cssLSP.doHover(textDoc, position, textDoc.styleSheet) ?? undefined;
         }
         else if (document_1.jsonLSP && type === 'ext-inner' && document_1.jsonTags.includes(name)) {
-            const textDoc = new document_1.EmbeddedJSONDocument(root, token);
+            const textDoc = new document_1.EmbeddedJSONDocument(root, offsetNode);
             return await document_1.jsonLSP.doHover(textDoc, position, textDoc.jsonDoc) ?? undefined;
+        }
+        else if (lint_1.htmlData.provideTags && lint_1.htmlData.provideAttributes) {
+            if (type === 'html' && offset <= offsetNode.getRelativeIndex(0)
+                || type === 'html-attr-dirty' && offset === 0 && parentNode.firstChild === offsetNode) {
+                const token = type === 'html' ? offsetNode : parentNode.parentNode, data = lint_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 === 'attr-key' && isHtmlAttr(parentNode)) {
+                const data = lint_1.htmlData.provideAttributes(parentNode.tag).find(({ name: n }) => n === parentNode.name);
+                if (data?.description) {
+                    return {
+                        contents: data.description,
+                        range: createNodeRange(offsetNode),
+                    };
+                }
+            }
             /* NOT FOR BROWSER ONLY END */
         }
         return info && {
@@ -900,7 +1162,7 @@ class LanguageService {
                     : '')
                     + info.description,
             },
-            range: range ?? createNodeRange(token),
+            range: range ?? createNodeRange(offsetNode),
         };
     }
     /**
@@ -973,8 +1235,7 @@ class LanguageService {
     }
     /** @private */
     findStyleTokens() {
-        return this.#done.querySelectorAll(cssSelector)
-            .filter(({ lastChild: { length, firstChild } }) => length === 1 && firstChild.type === 'text');
+        return this.#done.querySelectorAll(cssSelector).filter(({ lastChild }) => (0, exports.isAttr)(lastChild));
     }
     /* NOT FOR BROWSER ONLY */
     /**
@@ -1036,6 +1297,28 @@ class LanguageService {
         }
         return symbols;
     }
+    /**
+     * Set the target Wikipedia
+     *
+     * 设置目标维基百科
+     * @param wiki Wikipedia URL / 维基百科网址
+     * @throws `RangeError` 不是有效的维基百科网址
+     */
+    async setTargetWikipedia(wiki) {
+        const mt = /^https?:\/\/([^./]+)\.wikipedia\.org/iu.exec(wiki);
+        if (!mt) {
+            throw new RangeError('Invalid Wikipedia URL!');
+        }
+        const site = `${mt[1].toLowerCase()}wiki`;
+        try {
+            const config = require(path_1.default.join('..', '..', 'config', site));
+            this.config = index_1.default.getConfig(config);
+        }
+        catch {
+            this.config = index_1.default.getConfig(await (0, config_1.default)(site, `${mt[0]}/w`));
+        }
+        Object.assign(this.config, { articlePath: `${mt[0]}/wiki/` });
+    }
 }
 exports.LanguageService = LanguageService;
 constants_1.classes['LanguageService'] = __filename;