wikilint 2.47.0 → 2.48.0

package/README.md

@@ -97,6 +97,6 @@ repos:
         # You can add any CLI options as needed
         entry: wikilint
         language: node
-        additional_dependencies: ['wikilint@2.47.0']
+        additional_dependencies: ['wikilint@2.48.0']
         files: \.(mediawiki|wiki|wikitext)$
 ```

package/config/default.json

@@ -1023,6 +1023,7 @@
 			"DEFAULTSORT": "defaultsort",
 			"DEFAULTSORTKEY": "defaultsort",
 			"DEFAULTCATEGORYSORT": "defaultsort",
+			"CATEGORYSORT": "categorysort",
 			"分类中页面数": "pagesincategory",
 			"カテゴリ内ページ数": "pagesincategory",
 			"PAGESINCATEGORY": "pagesincategory",

package/config/enwiki.json

@@ -456,6 +456,7 @@
 			"DEFAULTSORT": "defaultsort",
 			"DEFAULTSORTKEY": "defaultsort",
 			"DEFAULTCATEGORYSORT": "defaultsort",
+			"CATEGORYSORT": "categorysort",
 			"PAGESINCATEGORY": "pagesincategory",
 			"PAGESINCAT": "pagesincategory",
 			"PAGESIZE": "pagesize",

package/config/jawiki.json

@@ -546,6 +546,7 @@
 			"DEFAULTSORT": "defaultsort",
 			"DEFAULTSORTKEY": "defaultsort",
 			"DEFAULTCATEGORYSORT": "defaultsort",
+			"CATEGORYSORT": "categorysort",
 			"カテゴリ内ページ数": "pagesincategory",
 			"PAGESINCATEGORY": "pagesincategory",
 			"PAGESINCAT": "pagesincategory",

package/config/zhwiki.json

@@ -682,6 +682,7 @@
 			"默认排序": "defaultsort",
 			"默认排序关键字": "defaultsort",
 			"默认分类排序": "defaultsort",
+			"CATEGORYSORT": "categorysort",
 			"PAGESINCATEGORY": "pagesincategory",
 			"PAGESINCAT": "pagesincategory",
 			"分类中页面数": "pagesincategory",

package/data/signatures.json

@@ -2158,6 +2158,26 @@
 			],
 			"description": "Used for categorizing pages, sets a default [category sort key](https://www.mediawiki.org/wiki/Help:Categories). It can take a second argument of *noerror* or *noreplace* to suppress error messages when multiple defaultsortkeys are used on one page or to make this `defaultsort` do nothing if a `defaultsort` was already specified earlier in the page."
 		},
+		{
+			"aliases": [
+				"categorysort"
+			],
+			"signatures": [
+				[
+					{
+						"label": "TIMESTAMP",
+						"const": true
+					}
+				],
+				[
+					{
+						"label": "RTIMESTAMP",
+						"const": true
+					}
+				]
+			],
+			"description": "When placed on a category page, the category will be sorted based on timestamp of categorization. `{{CATEGORYSORT:TIMESTAMP}}` lists members by the time they were added to the category, oldest first, and `{{CATEGORYSORT:RTIMESTAMP}}` lists the most recently added members first. Readers can still override this with the `cldsort` URL parameter, and the new `cldorder=desc` URL parameter reverses a `cldsort=timestamp` listing."
+		},
 		{
 			"aliases": [
 				"numberofpages"

package/dist/base.d.mts

@@ -117,6 +117,7 @@ export type CompletionItem = Omit<CompletionItemBase, 'kind'> & {
     kind?: CompletionItemKind | keyof typeof CompletionItemKind;
 };
 export interface LanguageService {
+    /** @since v1.17.1 */
     include: boolean;
     /**
      * Destroy the instance
@@ -147,6 +148,14 @@ export interface LanguageService {
      * @param position position / 位置
      */
     provideCompletionItems(text: string, position: Position): Promise<CompletionItem[] | undefined>;
+    /**
+     * Add additional information to a completion item
+     *
+     * 为自动补全项添加额外信息
+     * @param item completion item / 自动补全项
+     * @since v1.48.0
+     */
+    resolveCompletionItem(item: CompletionItem): CompletionItem;
     /**
      * Provide grammar check
      *
@@ -160,6 +169,7 @@ export interface LanguageService {
      *
      * 实现修复全部代码的操作
      * @param action code action / 代码操作
+     * @since v1.24.1
      */
     resolveCodeAction(action: CodeAction): CodeAction;
     /**
@@ -182,6 +192,7 @@ export interface LanguageService {
      * 提供文档高亮
      * @param text source Wikitext / 源代码
      * @param position position / 位置
+     * @since v1.46.1
      */
     provideDocumentHighlights(text: string, position: Position): Promise<DocumentHighlight[] | undefined>;
     /**
@@ -238,6 +249,7 @@ export interface LanguageService {
      *
      * 提供 CodeLens
      * @param text source Wikitext / 源代码
+     * @since v1.16.3
      */
     provideInlayHints(text: string): Promise<InlayHint[]>;
     /**
@@ -246,6 +258,7 @@ export interface LanguageService {
      * 提供重构操作
      * @param text source Wikitext / 源代码
      * @param range range of the refactoring / 重构范围
+     * @since v1.24.1
      */
     provideRefactoringAction(text: string, range?: Range): Promise<CodeAction[]>;
     /**
@@ -268,6 +281,7 @@ export interface LanguageService {
      * 设置目标维基百科
      * @param wiki Wikipedia URL / 维基百科网址
      * @param user URI for wiki userpage or email address of the user / 维基用户页面地址或用户的电子邮件地址
+     * @since v1.18.1
      */
     setTargetWikipedia(wiki: string, user: string): Promise<void>;
     [Symbol.dispose](): void;
@@ -302,6 +316,7 @@ export interface Parser {
      *
      * 获取当前的解析设置
      * @param config unprocessed parser configuration / 未处理的解析设置
+     * @throws `RangeError` if the configuration file path or file name is invalid
      */
     getConfig(config?: ConfigData): Config;
     /**

package/dist/base.d.ts

@@ -117,6 +117,7 @@ export type CompletionItem = Omit<CompletionItemBase, 'kind'> & {
     kind?: CompletionItemKind | keyof typeof CompletionItemKind;
 };
 export interface LanguageService {
+    /** @since v1.17.1 */
     include: boolean;
     /**
      * Destroy the instance
@@ -147,6 +148,14 @@ export interface LanguageService {
      * @param position position / 位置
      */
     provideCompletionItems(text: string, position: Position): Promise<CompletionItem[] | undefined>;
+    /**
+     * Add additional information to a completion item
+     *
+     * 为自动补全项添加额外信息
+     * @param item completion item / 自动补全项
+     * @since v1.48.0
+     */
+    resolveCompletionItem(item: CompletionItem): CompletionItem;
     /**
      * Provide grammar check
      *
@@ -160,6 +169,7 @@ export interface LanguageService {
      *
      * 实现修复全部代码的操作
      * @param action code action / 代码操作
+     * @since v1.24.1
      */
     resolveCodeAction(action: CodeAction): CodeAction;
     /**
@@ -182,6 +192,7 @@ export interface LanguageService {
      * 提供文档高亮
      * @param text source Wikitext / 源代码
      * @param position position / 位置
+     * @since v1.46.1
      */
     provideDocumentHighlights(text: string, position: Position): Promise<DocumentHighlight[] | undefined>;
     /**
@@ -238,6 +249,7 @@ export interface LanguageService {
      *
      * 提供 CodeLens
      * @param text source Wikitext / 源代码
+     * @since v1.16.3
      */
     provideInlayHints(text: string): Promise<InlayHint[]>;
     /**
@@ -246,6 +258,7 @@ export interface LanguageService {
      * 提供重构操作
      * @param text source Wikitext / 源代码
      * @param range range of the refactoring / 重构范围
+     * @since v1.24.1
      */
     provideRefactoringAction(text: string, range?: Range): Promise<CodeAction[]>;
     /**
@@ -268,6 +281,7 @@ export interface LanguageService {
      * 设置目标维基百科
      * @param wiki Wikipedia URL / 维基百科网址
      * @param user URI for wiki userpage or email address of the user / 维基用户页面地址或用户的电子邮件地址
+     * @since v1.18.1
      */
     setTargetWikipedia(wiki: string, user: string): Promise<void>;
     [Symbol.dispose](): void;
@@ -302,6 +316,7 @@ export interface Parser {
      *
      * 获取当前的解析设置
      * @param config unprocessed parser configuration / 未处理的解析设置
+     * @throws `RangeError` if the configuration file path or file name is invalid
      */
     getConfig(config?: ConfigData): Config;
     /**

package/dist/bin/cli.js

@@ -285,11 +285,10 @@ if (recursive) {
         if (!fs_1.default.existsSync(file)) {
             return [];
         }
-        if (fs_1.default.statSync(file).isFile()) {
-            return file;
-        }
-        return fs_1.default.readdirSync(file, { recursive: true, withFileTypes: true }).filter(dir => dir.isFile())
-            .map(dir => path_1.default.join(dir.parentPath, dir.name));
+        return fs_1.default.statSync(file).isFile()
+            ? file
+            : fs_1.default.readdirSync(file, { recursive: true, withFileTypes: true }).filter(dir => dir.isFile())
+                .map(dir => path_1.default.join(dir.parentPath, dir.name));
     });
 }
 if (exts.length > 0) {

package/dist/bin/config.js

@@ -41,7 +41,7 @@ const filterGadget = (id) => {
     const n = Number(id);
     return n < 2300 || n > 2303; // Gadget, Gadget talk, Gadget definition, Gadget definition talk
 };
-const pkg = 'wikilint', version = '2.47.0';
+const pkg = 'wikilint', version = '2.48.0';
 /**
  * Get the parser configuration for a Wikimedia Foundation project.
  * @param site site nickname
@@ -49,6 +49,7 @@ const pkg = 'wikilint', version = '2.47.0';
  * @param user URI for wiki userpage or email address of the user
  * @param force whether to overwrite the existing configuration
  * @param internal for internal use
+ * @throws `RangeError` if the site nickname or script path is missing, or Extension:CodeMirror is not installed
  */
 exports.default = async (site, url, user, force, internal) => {
     // wrong calls

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import type { TitleOptions } from './lib/title';
 import type { LanguageService, QuickFixData } from './lib/lsp';
 import type { Token } from './internal';
 declare interface Parser extends ParserBase {
-    default: Parser;
+    default: this;
     /** @since v1.5.1 */
     readonly rules: readonly LintError.Rule[];
     configPaths: string[];
@@ -33,6 +33,7 @@ declare interface Parser extends ParserBase {
      *
      * 获取一个WMF网站的名称
      * @param url script path
+     * @throws `RangeError` if the URL is not a recognizable WMF site
      * @since v1.22.0
      */
     getWMFSite(url: string): [string, string];
@@ -43,6 +44,7 @@ declare interface Parser extends ParserBase {
      * @param site site nickname / 网站别名
      * @param url script path / 脚本路径
      * @param user URI for wiki userpage or email address of the user / 维基用户页面地址或用户的电子邮件地址
+     * @throws `RangeError` if Extension:CodeMirror is not installed
      * @since v1.18.4
      */
     fetchConfig(site: string, url: string, user?: string): Promise<Config>;

package/dist/index.js

@@ -20,7 +20,7 @@ const re = new RegExp(String.raw `^https?:\/\/([^./]+)\.(${common_1.wmf})\.org`,
 /**
  * require一个JSON文件
  * @param file 文件名
- * @throws {RangeError} 仅支持JSON文件
+ * @throws `RangeError` 仅支持JSON文件
  */
 const jsonRequire = (file) => {
     const fullPath = require.resolve(file);
@@ -159,7 +159,7 @@ const Parser = {
                 for (const key of keys) {
                     const str = t[key];
                     if (str?.includes('\0')) {
-                        const s = root.buildFromStr(str, constants_1.BuildMethod.Text);
+                        const s = root.buildFromStr(str, 1 /* BuildMethod.Text */);
                         if (key === 'main') {
                             t.main = s;
                         }

package/dist/lib/lsp.d.ts

@@ -1,6 +1,6 @@
 import Parser from '../index';
 import { Token } from '../src/index';
-import type { Range, Position, ColorInformation, ColorPresentation, FoldingRange, DocumentLink, Location, DocumentHighlight, WorkspaceEdit, Diagnostic as DiagnosticBase, TextEdit, Hover, SignatureHelp, InlayHint, CodeAction, DocumentSymbol } from 'vscode-languageserver-types';
+import type { Range, Position, ColorInformation, ColorPresentation, CompletionItem as CompletionItemBase, FoldingRange, DocumentLink, Location, DocumentHighlight, WorkspaceEdit, Diagnostic as DiagnosticBase, TextEdit, Hover, SignatureHelp, InlayHint, CodeAction, DocumentSymbol } from 'vscode-languageserver-types';
 import type { Config, LanguageService as LanguageServiceBase, CompletionItem, SignatureData } from '../base';
 import type { AttributeToken } from '../internal';
 import type { TokenTypeMap, SelectedTokenTypes } from '../map';
@@ -41,6 +41,14 @@ export declare class LanguageService implements LanguageServiceBase {
      * @param position position / 位置
      */
     provideCompletionItems(text: string, position: Position): Promise<CompletionItem[] | undefined>;
+    /**
+     * Add additional information to a completion item
+     *
+     * 为自动补全项添加额外信息
+     * @param item completion item / 自动补全项
+     * @since v1.48.0
+     */
+    resolveCompletionItem<T extends CompletionItem | CompletionItemBase>(item: T): T;
     /**
      * Provide grammar check
      *

package/dist/lib/lsp.js

@@ -106,28 +106,33 @@ 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 = '', 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,
-        },
-        ...doc && {
-            documentation: {
-                kind: 'markdown',
-                value: doc,
-            },
+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 },
         },
-    };
-});
+        newText: w + extra,
+    },
+}));
+/**
+ * Normalize a magic word.
+ * @param word magic word
+ * @param insensitive dictionary of insensitive magic words
+ * @param sensitive dictionary of sensitive magic words
+ */
+const normalizeMagicWord = (word, insensitive, sensitive) => {
+    if (Object.hasOwn(insensitive, word)) {
+        word = insensitive[word];
+    }
+    else if (Object.hasOwn(sensitive, word)) {
+        word = sensitive[word];
+    }
+    return word.toLowerCase();
+};
 /**
  * Get the caret position at the position from a word.
  * @param root root token
@@ -380,30 +385,42 @@ class LanguageService {
     /** @private */
     config;
     /** @private */
-    data;
+    static data;
     /* NOT FOR BROWSER ONLY */
     /** @private */
     // @ts-expect-error lazy initialization
     lilypond;
     #lilypondData;
     #mathData;
+    static {
+        this.data = require(path_1.default.join('..', '..', 'data', 'signatures.json'));
+    }
     /* NOT FOR BROWSER ONLY END */
+    /**
+     * 检索状态开关
+     * @param name 魔术字名
+     */
+    static #getBehaviorSwitch(name) {
+        return this.data.behaviorSwitches.find(({ aliases }) => aliases.includes(name));
+    }
+    /**
+     * 检索解析器函数
+     * @param name 函数名
+     */
+    static #getParserFunction(name) {
+        return this.data.parserFunctions
+            .find(({ aliases }) => aliases.some(alias => alias.replace(/^#/u, '') === name));
+    }
     /** @param uri 任务标识 */
     constructor(uri) {
         exports.tasks.set(uri, this);
+        Object.defineProperties(this, {
+            config: { enumerable: false },
+        });
         /* NOT FOR BROWSER ONLY */
         const dataDir = path_1.default.join('..', '..', 'data'), extDir = path_1.default.join(dataDir, 'ext');
         this.#lilypondData = require(path_1.default.join(extDir, 'score.json'));
         this.#mathData = require(path_1.default.join(extDir, 'math.json'));
-        /* NOT FOR BROWSER ONLY END */
-        Object.defineProperties(this, {
-            config: { enumerable: false },
-            data: {
-                enumerable: false,
-                /* NOT FOR BROWSER ONLY */
-                value: require(path_1.default.join(dataDir, 'signatures.json')),
-            },
-        });
     }
     /** @implements */
     async destroy() {
@@ -608,28 +625,14 @@ class LanguageService {
      * @param position position / 位置
      */
     async provideCompletionItems(text, position) {
-        const { re, allTags, functions, switches, jaSwitches, 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;
+        const { re, allTags, functions, switches, jaSwitches, 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
             const closing = mt[1].startsWith('/');
             return getCompletion(allTags, 'Class', mt[1].slice(closing ? 1 : 0), position, closing && !curLine?.slice(character).trimStart().startsWith('>') ? '>' : '');
         }
         else if (mt?.[4] || mt?.[5] && jaSwitches.length > 0) { // behavior switch
             const isJa = mt[5] !== undefined;
-            return getCompletion(isJa ? jaSwitches : switches, 'Constant', mt[isJa ? 5 : 4], position, '', name => {
-                if (!this.data) {
-                    return undefined;
-                }
-                else if (!isJa) {
-                    name = name.slice(2, -2);
-                }
-                if (Object.hasOwn(iAlias, name)) {
-                    name = iAlias[name];
-                }
-                else if (Object.hasOwn(sAlias, name)) {
-                    name = sAlias[name];
-                }
-                return this.#getBehaviorSwitch(name.toLowerCase());
-            });
+            return getCompletion(isJa ? jaSwitches : switches, 'Constant', mt[isJa ? 5 : 4], position);
         }
         else if (mt?.[6] !== undefined) { // protocol
             return getCompletion(protocols, 'Reference', mt[6], position);
@@ -643,7 +646,7 @@ class LanguageService {
                 return getCompletion(root.querySelectorAll('arg').filter(token => token.name && token !== cur)
                     .map(({ name }) => name), 'Variable', match, position);
             }
-            const [insensitive, sensitive] = this.config.parserFunction, colon = match.startsWith(':'), str = colon ? match.slice(1).trimStart() : match;
+            const colon = match.startsWith(':'), str = colon ? match.slice(1).trimStart() : match;
             if (mt[2] === '[[') { // link
                 return getCompletion(root.querySelectorAll('link,file,category,redirect-target').filter(token => token !== cur).map(({ name }) => name), 'Folder', str, position);
             }
@@ -657,18 +660,7 @@ class LanguageService {
                 words = functions.filter(s => s.endsWith('：')).map(s => s.slice(0, -1));
             }
             return [
-                ...getCompletion(words, 'Function', match, position, '', name => {
-                    if (!this.data) {
-                        return undefined;
-                    }
-                    else if (Object.hasOwn(insensitive, name)) {
-                        name = insensitive[name];
-                    }
-                    else if (Object.hasOwn(sensitive, name)) {
-                        name = sensitive[name];
-                    }
-                    return this.#getParserFunction(name.toLowerCase());
-                }),
+                ...getCompletion(words, 'Function', match, position),
                 ...match.startsWith('#')
                     ? []
                     : getCompletion(root.querySelectorAll('template').filter(token => token !== cur).map(token => {
@@ -806,6 +798,36 @@ class LanguageService {
         }
         return undefined;
     }
+    /**
+     * Add additional information to a completion item
+     *
+     * 为自动补全项添加额外信息
+     * @param item completion item / 自动补全项
+     * @since v1.48.0
+     */
+    resolveCompletionItem(item) {
+        if (!LanguageService.data) {
+            return item;
+        }
+        this.config ??= index_1.default.getConfig();
+        const { kind } = item, Constant = 21, Function = 3;
+        let { label } = item, doc;
+        if (kind === 'Constant' || kind === Constant) {
+            const [, , insensitive, sensitive] = this.config.doubleUnderscore;
+            if (label.endsWith('_')) {
+                label = label.slice(2, -2);
+            }
+            doc = LanguageService.#getBehaviorSwitch(normalizeMagicWord(label, insensitive, sensitive));
+        }
+        else if ((kind === 'Function' || kind === Function) && !label.startsWith('/')) {
+            const [insensitive, sensitive] = this.config.parserFunction;
+            doc = LanguageService.#getParserFunction(normalizeMagicWord(label, insensitive, sensitive));
+        }
+        if (doc?.description) {
+            item.documentation = { kind: 'markdown', value: doc.description };
+        }
+        return item;
+    }
     /**
      * Provide grammar check
      *
@@ -1157,26 +1179,25 @@ class LanguageService {
      */
     async provideDocumentHighlights(text, position) {
         const root = await this.#queue(text), index = root.indexFromPos(position.line, position.character), node = root.elementFromIndex(index), type = node?.type;
-        if (!node || (type === 'ext' || type === 'html') && !/\w/u.test(text.charAt(index))) {
-            return undefined;
-        }
-        return getMatchingTokens(root, node, highlightTypes)?.map((token) => {
-            const range = createNodeRange(token);
-            if (type === 'ext' || type === 'html') {
-                const { start } = range;
-                start.character += token.closing ? 2 : 1;
-                return {
-                    range: {
-                        start,
-                        end: {
-                            line: start.line,
-                            character: start.character + token.name.length,
+        return !node || (type === 'ext' || type === 'html') && !/\w/u.test(text.charAt(index))
+            ? undefined
+            : getMatchingTokens(root, node, highlightTypes)?.map((token) => {
+                const range = createNodeRange(token);
+                if (type === 'ext' || type === 'html') {
+                    const { start } = range;
+                    start.character += token.closing ? 2 : 1;
+                    return {
+                        range: {
+                            start,
+                            end: {
+                                line: start.line,
+                                character: start.character + token.name.length,
+                            },
                         },
-                    },
-                };
-            }
-            return { range };
-        });
+                    };
+                }
+                return { range };
+            });
     }
     /**
      * Provide references
@@ -1281,21 +1302,6 @@ class LanguageService {
                 },
             };
     }
-    /**
-     * 检索状态开关
-     * @param name 魔术字名
-     */
-    #getBehaviorSwitch(name) {
-        return this.data.behaviorSwitches.find(({ aliases }) => aliases.includes(name));
-    }
-    /**
-     * 检索解析器函数
-     * @param name 函数名
-     */
-    #getParserFunction(name) {
-        return this.data.parserFunctions
-            .find(({ aliases }) => aliases.some(alias => alias.replace(/^#/u, '') === name));
-    }
     /**
      * Provide hover information
      *
@@ -1305,7 +1311,7 @@ class LanguageService {
      */
     async provideHover(text, position) {
         /* c8 ignore next 3 */
-        if (!this.data) {
+        if (!LanguageService.data) {
             return undefined;
         }
         const root = await this.#queue(text);
@@ -1317,23 +1323,23 @@ class LanguageService {
         const { type, parentNode, length, name } = offsetNode;
         let info, f, colon, range;
         if (offsetNode.is('double-underscore') && offset > 0) {
-            info = this.#getBehaviorSwitch(offsetNode.name);
+            info = LanguageService.#getBehaviorSwitch(offsetNode.name);
         }
         else if (type === 'magic-word-name') {
-            info = this.#getParserFunction(parentNode.name);
+            info = LanguageService.#getParserFunction(parentNode.name);
             f = offsetNode.text().trim();
             colon = parentNode.getAttribute('colon');
         }
         else if (length === 1 && offsetNode.is('magic-word') && !offsetNode.modifier
             && (offset > 0 || root.posFromIndex(offsetNode.getAbsoluteIndex()).left === position.character)) {
-            info = this.#getParserFunction(name);
+            info = LanguageService.#getParserFunction(name);
             f = offsetNode.firstChild.text().trim();
             colon = offsetNode.getAttribute('colon');
         }
         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());
+            info = LanguageService.#getParserFunction(f.toLowerCase());
             colon = ':';
             if (info) {
                 const aIndex = offsetNode.getAbsoluteIndex();
@@ -1403,14 +1409,14 @@ class LanguageService {
      */
     async provideSignatureHelp(text, position) {
         /* c8 ignore next 3 */
-        if (!this.data) {
+        if (!LanguageService.data) {
             return undefined;
         }
         const { line, character } = position, curLine = text.split(/\r?\n/u, line + 1)[line], { lastChild } = await this.#queueSignature(`${curLine.slice(0, character + (0, common_1.numLeadingSpaces)(curLine.slice(character), /[{}<]|$/u))}}}`);
         if (!lastChild.is('magic-word') || lastChild.length === 1) {
             return undefined;
         }
-        const { name, childNodes, firstChild } = lastChild, info = this.#getParserFunction(name);
+        const { name, childNodes, firstChild } = lastChild, info = LanguageService.#getParserFunction(name);
         if (!info?.signatures) {
             return undefined;
         }

package/dist/lib/node.js

@@ -90,7 +90,7 @@ let AstNode = (() => {
         /** @private */
         getChildNodes() {
             const { childNodes } = this;
-            if (Object.isFrozen(childNodes)) {
+            if (Object.isFrozen(childNodes)) { // NOT FOR TEMPLATE
                 return [...childNodes];
             }
             return childNodes;

package/dist/lib/text.d.ts

@@ -24,8 +24,7 @@ export declare class AstText extends AstNode {
      *
      * 将文本子节点分裂为两部分
      * @param offset position to be splitted at / 分裂位置
-     * @throws `RangeError` 错误的断开位置
-     * @throws `Error` 没有父节点
+     * @throws `Error` if the text node has no parent node
      */
     splitText(offset: number): AstText;
     /**
@@ -33,7 +32,7 @@ export declare class AstText extends AstNode {
      *
      * 转义 `=` 和 `|`
      * @since v1.1.4
-     * @throws `Error` 没有父节点
+     * @throws `Error` if the text node has no parent node
      */
     escape(): void;
 }

package/dist/lib/text.js

@@ -70,7 +70,7 @@ class AstText extends node_1.AstNode {
     }
     /** @private */
     toString(skip) {
-        if (skip && !this.parentNode?.getAttribute('built')) {
+        if (skip && !this.parentNode?.getAttribute('built')) { // NOT FOR TEMPLATE
             return (0, string_1.removeComment)(this.data);
         }
         return this.data;
@@ -249,7 +249,7 @@ class AstText extends node_1.AstNode {
                     if (!/(?:^|[^=])=+\s*(?:\S\s*)?$/u.test(line)) {
                         continue;
                     }
-                    if (lineEnd === -1) {
+                    else if (lineEnd === -1) {
                         endIndex = sibling.getAbsoluteIndex() + line.length;
                         ({ top: endLine, left: endCol } = root.posFromIndex(endIndex));
                     }
@@ -322,8 +322,7 @@ class AstText extends node_1.AstNode {
      *
      * 将文本子节点分裂为两部分
      * @param offset position to be splitted at / 分裂位置
-     * @throws `RangeError` 错误的断开位置
-     * @throws `Error` 没有父节点
+     * @throws `Error` if the text node has no parent node
      */
     splitText(offset) {
         LSP: {
@@ -343,7 +342,7 @@ class AstText extends node_1.AstNode {
      *
      * 转义 `=` 和 `|`
      * @since v1.1.4
-     * @throws `Error` 没有父节点
+     * @throws `Error` if the text node has no parent node
      */
     escape() {
         LSP: {

package/dist/parser/braces.js

@@ -57,8 +57,7 @@ const getSymbol = (s) => {
  * @param wikitext
  * @param config
  * @param accum
- * @throws `RangeError` Maximum iteration exceeded
- * @throws `TranscludeToken.constructor()`
+ * @throws `RangeError` if maximum iteration exceeded
  */
 const parseBraces = (wikitext, config, accum) => {
     const source = String.raw `${config.excludes.includes('heading') ? '' : String.raw `^((?:\0\d+[cno]\x7F)*)={1,6}|`}\[\[|-\{(?!\{)`, [, , , subst] = config.parserFunction, stack = [], linkStack = [];
@@ -91,7 +90,7 @@ const parseBraces = (wikitext, config, accum) => {
                 }
                 catch (e) {
                     /* c8 ignore next 3 */
-                    if (!(e instanceof SyntaxError) || e.message !== 'Invalid template name') {
+                    if (!(e instanceof SyntaxError) || e.message !== transclude_1.invalidTemplateMsg) {
                         throw e;
                     }
                 }
@@ -170,7 +169,7 @@ const parseBraces = (wikitext, config, accum) => {
                 }
                 catch (e) {
                     /* c8 ignore next 3 */
-                    if (!(e instanceof SyntaxError && e.message === 'Invalid template name')) {
+                    if (!(e instanceof SyntaxError && e.message === transclude_1.invalidTemplateMsg)) {
                         throw e;
                     }
                     skip = true;

package/dist/src/attribute.js

@@ -99,7 +99,7 @@ class AttributeToken extends index_2.Token {
     /** @private */
     afterBuild() {
         if (this.#equal.includes('\0')) {
-            this.#equal = this.buildFromStr(this.#equal, constants_1.BuildMethod.String);
+            this.#equal = this.buildFromStr(this.#equal, 0 /* BuildMethod.String */);
         }
         if (this.parentNode) {
             this.#tag = this.parentNode.name;

package/dist/src/converterFlags.js

@@ -126,21 +126,22 @@ let ConverterFlagsToken = (() => {
                     const rect = new rect_1.BoundingRect(this, start), { childNodes, length } = this;
                     for (let i = length - 1; i >= 0; i--) {
                         const child = childNodes[i], flag = child.text().trim();
-                        if (flag
-                            && !variantFlags.has(flag.toLowerCase())
-                            && !unknownFlags.has(flag)
-                            && (variantFlags.size > 0 || !definedFlags.has(flag))) {
-                            const e = (0, lint_1.generateForChild)(child, rect, rule, 'invalid-conversion-flag', s);
-                            if (computeEditInfo || fix) {
-                                if (variantFlags.size === 0 && definedFlags.has(flag.toUpperCase())) {
-                                    e.fix = (0, lint_1.fixByUpper)(e, flag);
-                                }
-                                else if (computeEditInfo) {
-                                    e.suggestions = [(0, lint_1.fixByRemove)(e, i && -1)];
-                                }
+                        if (!flag
+                            || variantFlags.has(flag.toLowerCase())
+                            || unknownFlags.has(flag)
+                            || variantFlags.size === 0 && definedFlags.has(flag)) {
+                            continue;
+                        }
+                        const e = (0, lint_1.generateForChild)(child, rect, rule, 'invalid-conversion-flag', s);
+                        if (computeEditInfo || fix) {
+                            if (variantFlags.size === 0 && definedFlags.has(flag.toUpperCase())) {
+                                e.fix = (0, lint_1.fixByUpper)(e, flag);
+                            }
+                            else if (computeEditInfo) {
+                                e.suggestions = [(0, lint_1.fixByRemove)(e, i && -1)];
                             }
-                            errors.push(e);
                         }
+                        errors.push(e);
                     }
                 }
                 return errors;

package/dist/src/extLink.js

@@ -91,6 +91,7 @@ let ExtLinkToken = (() => {
         }
         /** @private */
         toString(skip) {
+            // eslint-disable-next-line unicorn/prefer-ternary
             if (this.length === 1) {
                 return `[${super.toString(skip)}${this.#space}]`;
             }

package/dist/src/index.js

@@ -175,10 +175,10 @@ class Token extends element_1.AstElement {
             const n = Number(s.slice(0, -1));
             return this.#accum[n];
         }).filter(node => node !== '');
-        if (type === constants_1.BuildMethod.String) {
+        if (type === 0 /* BuildMethod.String */) {
             return nodes.map(String).join('');
         }
-        else if (type === constants_1.BuildMethod.Text) {
+        else if (type === 1 /* BuildMethod.Text */) {
             return (0, string_1.text)(nodes);
         }
         return nodes;

package/dist/src/link/base.js

@@ -103,7 +103,7 @@ let LinkBaseToken = (() => {
         afterBuild() {
             this.#title = this.getTitle();
             if (this.#delimiter.includes('\0')) {
-                this.#delimiter = this.buildFromStr(this.#delimiter, constants_1.BuildMethod.String);
+                this.#delimiter = this.buildFromStr(this.#delimiter, 0 /* BuildMethod.String */);
             }
             this.#setName();
             super.afterBuild();
@@ -124,7 +124,7 @@ let LinkBaseToken = (() => {
         /** @private */
         toString(skip) {
             const str = super.toString(skip, this.#delimiter);
-            if (this.#bracket) {
+            if (this.#bracket) { // NOT FOR TEMPLATE
                 return `[[${str}]]`;
             }
             return str;
@@ -137,7 +137,7 @@ let LinkBaseToken = (() => {
                     'trim']()
                 : `${target.trim()}|${(0, string_1.text)(childNodes.slice(1)
                     .filter(({ type: t, name }) => t !== 'image-parameter' || name !== 'invalid'), '|')}`;
-            if (this.#bracket) {
+            if (this.#bracket) { // NOT FOR TEMPLATE
                 return `[[${str}]]`;
             }
             return str;

package/dist/src/link/categorytree.js

@@ -80,10 +80,9 @@ let CategorytreeToken = (() => {
         lint(start = this.getAbsoluteIndex()) {
             LINT: {
                 const rule = 'no-ignored', s = index_1.default.lintConfig.getSeverity(rule, 'categorytree');
-                if (s && this.#lint()) {
-                    return [(0, lint_1.generateForSelf)(this, { start }, rule, 'invalid-category', s)];
-                }
-                return super.lint(start, false);
+                return s && this.#lint()
+                    ? [(0, lint_1.generateForSelf)(this, { start }, rule, 'invalid-category', s)]
+                    : super.lint(start, false);
             }
         }
         /** 无效的分类名 */

package/dist/src/link/file.js

@@ -177,14 +177,15 @@ class FileToken extends base_1.LinkBaseToken {
                         ...relevantArgs.slice(-1),
                     ];
                 }
-                if (relevantArgs.length > 1) {
-                    let severity = !isCaption || !extension || constants_1.extensions.has(extension);
-                    if (isCaption && severity) {
-                        const plainArgs = filterArgs(relevantArgs, transclusion);
-                        severity = plainArgs.length > 1 && ((arg) => plainArgs.includes(arg));
-                    }
-                    Array.prototype.push.apply(errors, generate(relevantArgs, 'duplicate', key, severity));
+                if (relevantArgs.length < 2) {
+                    continue;
+                }
+                let severity = !isCaption || !extension || constants_1.extensions.has(extension);
+                if (isCaption && severity) {
+                    const plainArgs = filterArgs(relevantArgs, transclusion);
+                    severity = plainArgs.length > 1 && ((arg) => plainArgs.includes(arg));
                 }
+                Array.prototype.push.apply(errors, generate(relevantArgs, 'duplicate', key, severity));
             }
             if (frameKeys.length > 1) {
                 Array.prototype.push.apply(errors, generate(args.filter(({ name }) => frame.has(name)), 'conflicting', 'frame'));

package/dist/src/table/index.d.ts

@@ -55,5 +55,5 @@ export declare abstract class TableToken extends TrBaseToken {
      * 获取第n行
      * @param n row number / 行号
      */
-    getNthRow(n: number, force?: boolean, insert?: false): TrToken | this | undefined;
+    getNthRow(n: number, force?: boolean, insert?: false): TrToken | this;
 }

package/dist/src/table/td.js

@@ -43,7 +43,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TdToken = void 0;
 const lint_1 = require("../../util/lint");
-const constants_1 = require("../../util/constants");
 const rect_1 = require("../../lib/rect");
 const cached_1 = require("../../mixin/cached");
 const index_1 = __importDefault(require("../../index"));
@@ -124,7 +123,7 @@ let TdToken = (() => {
         /** @private */
         afterBuild() {
             if (this.#innerSyntax.includes('\0')) {
-                this.#innerSyntax = this.buildFromStr(this.#innerSyntax, constants_1.BuildMethod.String);
+                this.#innerSyntax = this.buildFromStr(this.#innerSyntax, 0 /* BuildMethod.String */);
             }
             super.afterBuild();
         }
@@ -140,6 +139,7 @@ let TdToken = (() => {
         }
         /** @private */
         getGaps(i) {
+            // eslint-disable-next-line unicorn/prefer-ternary
             if (i === 1) {
                 return this.#innerSyntax.length;
             }

package/dist/src/transclude.d.ts

@@ -3,6 +3,7 @@ import { ParameterToken } from './parameter';
 import { AtomToken } from './atom';
 import { SyntaxToken } from './syntax';
 import type { Config, LintError } from '../base';
+export declare const invalidTemplateMsg = "Invalid template name";
 /**
  * template or magic word
  *
@@ -78,7 +79,7 @@ export declare abstract class TranscludeToken extends Token {
      * Get possible values of some magic words
      *
      * 对特定魔术字获取可能的取值
-     * @throws `Error` 不是可接受的魔术字
+     * @throws `Error` if not a supported magic word
      */
     getPossibleValues(): Token[];
 }

package/dist/src/transclude.js

@@ -37,11 +37,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TranscludeToken = void 0;
+exports.TranscludeToken = exports.invalidTemplateMsg = void 0;
 const string_1 = require("../util/string");
 const lint_1 = require("../util/lint");
 const debug_1 = require("../util/debug");
-const constants_1 = require("../util/constants");
 const rect_1 = require("../lib/rect");
 const gapped_1 = require("../mixin/gapped");
 const noEscape_1 = require("../mixin/noEscape");
@@ -50,6 +49,8 @@ const index_2 = require("./index");
 const parameter_1 = require("./parameter");
 const atom_1 = require("./atom");
 const syntax_1 = require("./syntax");
+exports.invalidTemplateMsg = 'Invalid template name';
+const sortArgs = /** @ignore */ ({ childNodes }, args) => [...args].sort((a, b) => childNodes.indexOf(a) - childNodes.indexOf(b));
 /**
  * template or magic word
  *
@@ -159,7 +160,7 @@ let TranscludeToken = (() => {
                 const name = (0, string_1.removeComment)(title).trim();
                 if (!this.normalizeTitle(name, 10, { halfParsed: true, temporary: true }).valid) {
                     accum.pop();
-                    throw new SyntaxError('Invalid template name');
+                    throw new SyntaxError(exports.invalidTemplateMsg);
                 }
                 const token = new atom_1.AtomToken(title, 'template-name', config, accum, {});
                 super.insertAt(token);
@@ -226,7 +227,7 @@ let TranscludeToken = (() => {
         /** @private */
         afterBuild() {
             if (this.modifier.includes('\0')) {
-                this.setAttribute('modifier', this.buildFromStr(this.modifier, constants_1.BuildMethod.String));
+                this.setAttribute('modifier', this.buildFromStr(this.modifier, 0 /* BuildMethod.String */));
             }
             super.afterBuild();
             if (this.isTemplate()) {
@@ -371,6 +372,9 @@ let TranscludeToken = (() => {
                 args = new Set();
                 this.#args.set(keyStr, args);
             }
+            if (copy) {
+                args = new Set(sortArgs(this, args));
+            }
             return args;
         }
         /**
@@ -382,7 +386,7 @@ let TranscludeToken = (() => {
             LINT: {
                 const isTemplate = this.isTemplate();
                 const duplicatedArgs = [...this.#args].filter(([, { size }]) => size > 1)
-                    .map(([key, args]) => [key, [...args]]);
+                    .map(([key, args]) => [key, sortArgs(this, args)]);
                 return isTemplate
                     ? duplicatedArgs
                     : duplicatedArgs
@@ -394,7 +398,7 @@ let TranscludeToken = (() => {
          * Get possible values of some magic words
          *
          * 对特定魔术字获取可能的取值
-         * @throws `Error` 不是可接受的魔术字
+         * @throws `Error` if not a supported magic word
          */
         getPossibleValues() {
             const { type, name, childNodes, length: l } = this;

package/dist/util/constants.js

@@ -1,12 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mathTags = exports.jsonTags = exports.extensions = exports.galleryParams = exports.enMsg = exports.BuildMethod = exports.MAX_STAGE = void 0;
+exports.mathTags = exports.jsonTags = exports.extensions = exports.galleryParams = exports.enMsg = exports.MAX_STAGE = void 0;
 exports.MAX_STAGE = 11;
-var BuildMethod;
-(function (BuildMethod) {
-    BuildMethod[BuildMethod["String"] = 0] = "String";
-    BuildMethod[BuildMethod["Text"] = 1] = "Text";
-})(BuildMethod || (exports.BuildMethod = BuildMethod = {}));
 exports.enMsg = (() => {
     LSP: return require(
     // eslint-disable-next-line n/no-missing-require

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "wikilint",
-	"version": "2.47.0",
+	"version": "2.48.0",
 	"description": "A Node.js linter for MediaWiki markup",
 	"keywords": [
 		"mediawiki",
@@ -46,7 +46,7 @@
 		"build": "npm run build:core",
 		"diff": "bash diff.sh",
 		"diff:stat": "f() { git diff --stat -w --color=always $1 $2 -- . | grep '\\.ts'; }; f",
-		"lint:ts": "tsc --noEmit && eslint --cache .",
+		"lint:ts": "[ ! -f dist/bin/config.js ] && npm run build:core; tsc --noEmit && eslint --cache .",
 		"lint:json": "v8r -s config/.schema.json config/*.json && v8r -s data/.schema.json data/*.json && testUtil dist/test/json.js",
 		"lint:md": "markdownlint-cli2 '*.md'",
 		"lint": "npm run lint:ts && npm run lint:json && npm run lint:md",
@@ -102,26 +102,26 @@
 		"@bhsd/common": "^4.1.0",
 		"@bhsd/stylelint-util": "^1.1.0",
 		"culori": "^4.0.2",
-		"entities": "^8.0.0",
+		"entities": "^8.1.0",
 		"vscode-languageserver-types": "^3.18.3"
 	},
 	"devDependencies": {
-		"@bhsd/code-standard": "^4.2.0",
+		"@bhsd/code-standard": "^4.3.0",
 		"@bhsd/nodejs": "^1.2.1",
-		"@bhsd/test-util": "^3.2.0",
+		"@bhsd/test-util": "^3.2.1",
 		"c8": "^12.0.0",
 		"diff2html-cli": "^5.2.15",
 		"esbuild": "^0.28.2",
-		"eslint": "^10.10.0",
-		"markdownlint-cli2": "^0.23.2",
+		"eslint": "^10.11.0",
+		"markdownlint-cli2": "^0.23.3",
 		"mathoid-texvcjs": "^0.6.0",
-		"stylelint": "^17.15.0",
+		"stylelint": "^17.16.0",
 		"typescript": "^6.0.3",
 		"v8r": "^6.1.0",
 		"vscode-css-languageservice": "^6.3.10",
 		"vscode-html-languageservice": "^5.6.2",
 		"vscode-json-languageservice": "^5.7.2",
-		"vscode-languageserver-textdocument": "^1.0.14"
+		"vscode-languageserver-textdocument": "^1.0.15"
 	},
 	"engines": {
 		"node": "^20.19.0 || ^22.13.0 || >=24.11.0"