update version

Author: CppCXY

CHANGELOG.md

@@ -2,6 +2,66 @@
 
 [中文Log](CHANGELOG_CN.md)
 
+## [0.9.29] - 2025-9-19
+
+### 🔧 Changed
+
+- **Refactor LSP Handler**: Refactored LSP handler to improve performance and maintainability.
+- **Refactor Folding Range**: Refactored folding range to support `Intellij`
+- **Add More Semantic Token**: Added more semantic tokens to improve syntax highlighting.
+- **Parser Optimization**: The parser now reports syntax errors more accurately and has improved error recovery.
+- **@type Support for Return Statements**: You can now use `@type` above a return statement to specify the return value type, for example:
+```lua
+---@return vim.lsp.Config
+return {}
+```
+- **Type Checking Optimization**: Improved type checking algorithms for better performance.
+
+### 🐛 Fixed
+- **Fix create progress**: Fixed an issue with the `window/workDoneProgress/create` protocol; it must be sent as a request, not a notification.
+- **Fix Function Overload Algorithm**: Rewrote the function overload algorithm to better handle variadic function parameters.
+- **LSP Handler Order**: Fixed an issue where LSP request donot handle during initialization.it will be handle after initialization complete.
+
+### ✨ Added
+- **Support @link in comment**: You can now use `@link` in comments to create clickable links. For example:
+```lua
+--- This is a link to {@link string.format}
+```
+- **Support `--editor` directive**: You can now use the `--editor` directive to specify the editor type. For example:
+```shell
+emmylua_ls --editor intellij
+```
+- **Support range foramt for external tool**: You can now use the `rangeFormat` request to format a specific range of code using an external tool. This feature can be enabled with the following configuration:
+```json
+{
+  "format": {
+    "externalToolRangeFormat": {
+        "program": "stylua",
+        "args": [
+            "-",
+            "--stdin-filepath",
+            "${file}",
+            "--indent-width=${indent_size}",
+            "--indent-type",
+            "${use_tabs?Tabs:Spaces}",
+            "--range-start=${start_offset}",
+            "--range-end=${end_offset}"
+        ],
+        "timeout": 5000
+    }
+  }
+}
+```
+for more information, please refer to [External Formatter Options](https://github.com/EmmyLuaLs/emmylua-analyzer-rust/blob/main/docs/external_format/external_formatter_options_EN.md).
+- **Add Basic EmmyLua Annotation Documentation**: Added more documentation for EmmyLua annotations, please refer to [EmmyLua Annotation Documentation](https://github.com/EmmyLuaLs/emmylua-analyzer-rust/blob/main/docs/emmylua_doc/annotations_EN/README.md).
+
+- **SARIF Format for emmyLua_check**: `emmyLua_check` now supports SARIF format output, enabled via the `--format sarif` command line option.
+- **Generic List Supports T... Syntax**: Generic lists now support the `T...` syntax, for example:
+```lua
+---@alias MyTuple<T...> [T...]
+```
+
+
 ## [0.9.28] - 2025-8-22
 
 ### 🐛 Fixed

CHANGELOG_CN.md

@@ -1,5 +1,65 @@
 # 🚀 Change Log
 
+## [0.9.29] - 2025-9-19
+
+### 🔧 变更
+
+- **重构 LSP 处理器**：重构了 LSP 处理器以提升性能和可维护性。
+- **重构折叠区间**：折叠区间功能已重构，现支持 `Intellij`。
+- **新增语义标记**：增加了更多语义标记以提升语法高亮效果。
+- **解析器优化**：解析器现在能更准确地报告语法错误，并提升了错误恢复能力。
+- **支持返回语句上的 @type**：现在可以在 return 语句上方使用 `@type` 指定返回值类型，例如：
+```lua
+---@return vim.lsp.Config
+return {}
+```
+- **类型检查优化**：优化了类型检查算法，提升了性能。
+
+### 🐛 问题修复
+- **修复进度创建协议**：修复了 `window/workDoneProgress/create` 协议，必须以请求方式发送而非通知。
+- **修复函数重载算法**：重写了函数重载算法，更好地处理可变参数函数。
+- **LSP 处理顺序修复**：修复了初始化期间 LSP 请求未处理的问题，现会在初始化完成后处理。
+
+### ✨ 新增功能
+- **支持注释中的 @link**：现在可以在注释中使用 `@link` 创建可点击链接，例如：
+```lua
+--- 这是一个指向 {@link string.format} 的链接
+```
+- **支持 `--editor` 指令**：现在可以使用 `--editor` 指定编辑器类型，例如：
+```shell
+emmylua_ls --editor intellij
+```
+- **支持外部工具区间格式化**：现在可以通过 `rangeFormat` 请求，使用外部工具格式化指定代码区间。可通过如下配置启用：
+```json
+{
+  "format": {
+    "externalToolRangeFormat": {
+        "program": "stylua",
+        "args": [
+            "-",
+            "--stdin-filepath",
+            "${file}",
+            "--indent-width=${indent_size}",
+            "--indent-type",
+            "${use_tabs?Tabs:Spaces}",
+            "--range-start=${start_offset}",
+            "--range-end=${end_offset}"
+        ],
+        "timeout": 5000
+    }
+  }
+}
+```
+更多信息请参考 [外部格式化工具选项](https://github.com/EmmyLuaLs/emmylua-analyzer-rust/blob/main/docs/external_format/external_formatter_options_CN.md)。
+- **新增 EmmyLua 注解文档**：补充了 EmmyLua 注解相关文档，详见 [EmmyLua 注解文档](https://github.com/EmmyLuaLs/emmylua-analyzer-rust/blob/main/docs/emmylua_doc/annotations_CN/README.md)。
+
+- **emmyLua_check 支持 SARIF 格式**：`emmyLua_check` 现支持 SARIF 格式输出，可通过命令行参数 `--format sarif` 启用。
+- **泛型列表支持 T... 语法**：泛型列表现已支持 `T...` 语法，例如：
+```lua
+---@alias MyTuple<T...> [T...]
+```
+
+
 ## [0.9.28] - 2025-8-22
 
 ### 🐛 问题修复

build/config.json

@@ -1,7 +1,7 @@
 {
     "emmyDebuggerVersion": "1.8.7",
     "emmyDebuggerUrl": "https://github.com/EmmyLua/EmmyLuaDebugger/releases/download",
-    "newLanguageServerVersion": "0.12.0",
+    "newLanguageServerVersion": "0.14.0",
     "newLanguageServerUrl": "https://github.com/CppCXY/emmylua-analyzer-rust/releases/download",
     "newLanguageServerSchemaUrl": "https://raw.githubusercontent.com/EmmyLuaLs/emmylua-analyzer-rust/refs/tags/{{tag}}/crates/emmylua_code_analysis/resources/schema.json"
 }

package.json

@@ -2,7 +2,7 @@
     "name": "emmylua",
     "displayName": "EmmyLua",
     "description": "EmmyLua for vscode",
-    "version": "0.9.28",
+    "version": "0.9.29",
     "icon": "res/icon.png",
     "publisher": "tangzx",
     "engines": {

src/emmyContext.ts

@@ -1,6 +1,6 @@
 import * as vscode from 'vscode';
 import { LanguageClient } from 'vscode-languageclient/node';
-import { IProgressReport, ServerStatusParams } from './lspExtension';
+import { ServerStatusParams } from './lspExtension';
 
 type ServerHealth = 'ok' | 'warning' | 'error' | 'stop';
 
@@ -16,18 +16,15 @@ export class EmmyContext implements vscode.Disposable {
 
     private _client?: LanguageClient;
     private readonly _statusBar: vscode.StatusBarItem;
-    private readonly _loadBar: vscode.StatusBarItem;
     private readonly _disposables: vscode.Disposable[] = [];
 
     constructor(
         public readonly debugMode: boolean,
         public readonly vscodeContext: vscode.ExtensionContext,
     ) {
         this._statusBar = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Left);
-        this._loadBar = vscode.window.createStatusBarItem(vscode.StatusBarAlignment.Left);
-        
-        this._disposables.push(this._statusBar, this._loadBar);
 
+        this._disposables.push(this._statusBar);
         this.setServerStatus({ health: "ok" });
     }
 
@@ -37,9 +34,6 @@ export class EmmyContext implements vscode.Disposable {
 
     set client(value: LanguageClient | undefined) {
         this._client = value;
-        if (value) {
-            this.registerProtocol();
-        }
     }
 
     setServerStatus(status: ServerStatusParams): void {
@@ -102,31 +96,6 @@ export class EmmyContext implements vscode.Disposable {
         return tooltip;
     }
 
-    private registerProtocol(): void {
-        if (!this._client) return;
-
-        this._disposables.push(
-            this._client.onNotification("emmy/progressReport", (data: IProgressReport) => {
-                this.handleProgressReport(data);
-            }),
-            
-            this._client.onNotification("emmy/setServerStatus", (param: ServerStatusParams) => {
-                this.setServerStatus(param);
-            })
-        );
-    }
-
-    private handleProgressReport(data: IProgressReport): void {
-        this._loadBar.show();
-        this._loadBar.text = `$(sync~spin) ${data.text}`;
-        
-        if (data.percent >= 1) {
-            setTimeout(() => {
-                this._loadBar.hide();
-            }, 1000);
-        }
-    }
-
     stopServer(): void {
         this._client?.stop();
         this.setServerStatus({ health: "stop" });

src/extension.ts

@@ -144,6 +144,7 @@ function onDidChangeActiveTextEditor(editor: vscode.TextEditor | undefined): voi
 
 async function startServer(): Promise<void> {
     try {
+        extensionContext.setServerStatus({ health: 'ok'});
         await doStartServer();
         onDidChangeActiveTextEditor(vscode.window.activeTextEditor);
     } catch (reason) {

syntaxes/schema.json

@@ -64,6 +64,7 @@
       "$ref": "#/$defs/EmmyrcReformat",
       "default": {
         "externalTool": null,
+        "externalToolRangeFormat": null,
         "useDiff": false
       }
     },
@@ -82,6 +83,7 @@
     "hover": {
       "$ref": "#/$defs/EmmyrcHover",
       "default": {
+        "customDetail": null,
         "enable": true
       }
     },
@@ -678,6 +680,7 @@
           "default": ""
         },
         "timeout": {
+          "description": "The timeout for the external tool in milliseconds.",
           "type": "integer",
           "format": "uint64",
           "default": 5000,
@@ -717,6 +720,17 @@
     "EmmyrcHover": {
       "type": "object",
       "properties": {
+        "customDetail": {
+          "description": "The detail number of hover information.\nDefault is `None`, which means using the default detail level.\nYou can set it to a number between `1` and `255` to customize",
+          "type": [
+            "integer",
+            "null"
+          ],
+          "format": "uint8",
+          "default": null,
+          "maximum": 255,
+          "minimum": 0
+        },
         "enable": {
           "description": "Enable showing documentation on hover.",
           "type": "boolean",
@@ -873,7 +887,19 @@
       "type": "object",
       "properties": {
         "externalTool": {
-          "description": "Whether to enable internal code reformatting.",
+          "description": "Whether to enable external tool formatting.",
+          "anyOf": [
+            {
+              "$ref": "#/$defs/EmmyrcExternalTool"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "externalToolRangeFormat": {
+          "description": "Whether to enable external tool range formatting.",
           "anyOf": [
             {
               "$ref": "#/$defs/EmmyrcExternalTool"
@@ -1122,4 +1148,4 @@
       ]
     }
   }
-}
+}