release 0.9.20

Author: CppCXY

CHANGELOG.md

@@ -2,6 +2,81 @@
 
 [中文Log](CHANGELOG_CN.md)
 
+# 0.9.20
+
+`FIX` Fix a crash issue
+
+`NEW` Support `@return_cast` for functions. When a function's return value is boolean (must be annotated as boolean), you can add an additional annotation `---@return_cast <param> <cast op>`, indicating that when the function returns true, the parameter `<param>` will be transformed to the corresponding type according to the cast. For example:
+```lua
+---@return boolean
+---@return_cast n integer
+local function isInteger(n)
+    return n == math.floor(n)
+end
+
+local a ---@type integer | string
+
+if isInteger(a) then
+    print(a) -- a: integer
+else
+    print(a) -- a: string
+end
+```
+
+`@return_cast` support self param. For example:
+```lua
+---@class My2
+
+---@class My1
+
+---@class My3:My2,My1
+local m = {}
+
+
+---@return boolean
+---@return_cast self My1
+function m:isMy1()
+end
+
+---@return boolean
+---@return_cast self My2
+function m:isMy2()
+end
+
+if m:isMy1() then
+    print(m) -- m: My1
+elseif m:isMy2() then
+    print(m) -- m: My2
+end
+```
+
+`CHG` Remove diagnostic `lua-syntax-error`, it merges into `syntax-error`, add `doc-syntax-error` for doc syntax error
+
+`FIX` Fix format issue, Now When exist `syntax-error`, the format never return value
+
+`FIX` Fix a performance issue: prevent large union types when functions return tables
+
+`CHG` When an object returned by require function is a class/enum, defining new members on it is prohibited, while tables are not restricted
+
+`NEW` Support `Lua 5.5` global decl grammar
+
+`NEW` Support `TypeGuard<T>` as return type. For example:
+```lua
+
+---@return TypeGuard<string>
+local function is_string(value)
+    return type(value) == "string"
+end
+
+local a
+
+if is_string(a) then
+    print(a:sub(1, 1))
+else
+    print("a is not a string")
+end
+```
+
 # 0.9.19
 
 `FIX` Fix reading configuration file encoded with UTF-8 BOM
@@ -10,9 +85,9 @@
 
 `NEW` Support new tag `@internal` for members or declarations. When a member or declaration is marked as `@internal`, it is only visible within its current library. This means that if you use `@internal` in one library, you cannot access this member or declaration from other libraries or workspace.
 
-`NEW` Support `Goto to implementation`
+`NEW` Support `Go to implementation`
 
-`NEW` Support `@nodisacrd` with reason
+`NEW` Support `@nodiscard` with reason
 
 `FIX` Fix Some performance issue
 

CHANGELOG_CN.md

@@ -1,5 +1,79 @@
 # Change Log
 
+# 0.9.20
+
+`FIX` 修复一个崩溃问题
+
+`NEW` 支持函数的`@return_cast`注解。当函数的返回值是布尔值（必须标注为布尔值）时，可以添加额外的注解`---@return_cast <param> <cast op>`，表示当函数返回true时，参数`<param>`将根据转换操作转为相应类型。例如：
+```lua
+---@return boolean
+---@return_cast n integer
+local function isInteger(n)
+  return n == math.floor(n)
+end
+
+local a ---@type integer | string
+
+if isInteger(a) then
+  print(a) -- a: integer
+else
+  print(a) -- a: string
+end
+```
+
+`@return_cast`支持self参数。例如：
+```lua
+---@class My2
+
+---@class My1
+
+---@class My3:My2,My1
+local m = {}
+
+
+---@return boolean
+---@return_cast self My1
+function m:isMy1()
+end
+
+---@return boolean
+---@return_cast self My2
+function m:isMy2()
+end
+
+if m:isMy1() then
+  print(m) -- m: My1
+elseif m:isMy2() then
+  print(m) -- m: My2
+end
+```
+
+`CHG` 移除诊断`lua-syntax-error`，合并到`syntax-error`中，并添加`doc-syntax-error`用于文档语法错误
+
+`FIX` 修复格式化问题，现在当存在`syntax-error`时，格式化将不返回值
+
+`FIX` 修复性能问题：防止函数返回表时产生大量联合类型
+
+`CHG` 当require函数返回的对象是类/枚举时，禁止在其上定义新成员，而表则不受限制
+
+`NEW` 支持`Lua 5.5`全局声明语法
+
+`NEW` 支持`TypeGuard<T>`作为返回类型。例如：
+```lua
+
+---@return TypeGuard<string>
+local function is_string(value)
+  return type(value) == "string"
+end
+
+local a
+
+if is_string(a) then
+  print(a:sub(1, 1))
+else
+  print("a is not a string")
+end
+```
 
 # 0.9.19
 
@@ -11,7 +85,7 @@
 
 `NEW` 支持`转到实现`功能
 
-`NEW` 支持 `@nodisacrd` 并可提供原因
+`NEW` 支持 `@nodiscard` 并可提供原因
 
 `FIX` 修复一些性能问题
 

build/config.js

@@ -1,6 +1,6 @@
 exports.default = {
     emmyDebuggerVersion: '1.8.5',
     emmyDebuggerUrl: 'https://github.com/EmmyLua/EmmyLuaDebugger/releases/download',
-    newLanguageServerVersion: "0.7.2",
+    newLanguageServerVersion: "0.7.3",
     newLanguageServerUrl: "https://github.com/CppCXY/emmylua-analyzer-rust/releases/download"
 }

package.json

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