3.19.2

Author: sumneko

changelog.md

@@ -3,6 +3,18 @@
 ## Unreleased
 <!-- Add all new changes here. They will be moved under a version at release -->
 
+## 3.19.2
+`2026-10-13`
+* `NEW` Setting `Lua.completion.requireFunction` to choose what the auto-require completion inserts (e.g. `import` instead of `require`)
+* `FIX` Support 6-digit hex color codes (with and without `#`) in `textDocument/documentColor`, and correct the `alpha` of `#RRGGBB` colors to the LSP range `0..1`
+* `FIX` Resolve unbound class generic parameters to `any` instead of leaving the parameter as the field type [#3442](https://github.com/LuaLS/lua-language-server/pull/3442)
+* `FIX` LuaJIT nil-coalescing `??` now strips the optional `?` from the left-hand type (e.g. `integer? ?? 2` infers `integer`) [#3459](https://github.com/LuaLS/lua-language-server/issues/3459)
+* `FIX` Literal string `"async"` in LuaDoc types (e.g. `---@field mode "async" | "sync"`) is no longer mis-parsed as the `async fun` prefix [#3402](https://github.com/LuaLS/lua-language-server/issues/3402)
+* `FIX` A `.gitignore` line containing only whitespace no longer ignores the entire workspace [#3458](https://github.com/LuaLS/lua-language-server/issues/3458)
+* `FIX` `need-check-nil` diagnostic is no longer reported on safe navigation access (e.g. `x?.field`, `f?.()`, `t?.[key]`), since the optional access itself already handles the nil check. Note that a non-safe access chained after a safe one (e.g. `x.upper()?.field`) still reports, because the safe access only protects its own result.
+* `FIX` Prevent hover and enum completion responses from containing invalid UTF-8 when escaped string literals decode to arbitrary bytes (e.g. `"\xC2"`).
+* `FIX` Fields accessed on a value typed as a constrained generic (e.g. `---@generic T: SomeClass` with `---@param self T`) are now looked up on the constraint, so existing fields no longer report `undefined-field` (unknown fields still do) [#2640](https://github.com/LuaLS/lua-language-server/discussions/2640)
+
 ## 3.19.1
 `2026-08-14`
 * `NEW` LuaJIT 3.0 extension syntax can now also be enabled individually via `Lua.runtime.nonstandardSymbol` (`?.`, `??`, `ternary`, `~>>`, `~>>=`, `..=`, `~=`, `const`, `->`, `number_underscore`), independent of `Lua.runtime.version` and without the `Lua.runtime.enableLuaJITExtensions` master switch. Note that `~=` enables the bitwise-xor compound assignment only in statement context (e.g. `a ~= b` on its own line).

package.json

@@ -142,6 +142,12 @@
 					"scope": "resource",
 					"type": "string"
 				},
+				"Lua.completion.requireFunction": {
+					"default": "require",
+					"markdownDescription": "%config.completion.requireFunction%",
+					"scope": "resource",
+					"type": "string"
+				},
 				"Lua.completion.requireSeparator": {
 					"default": ".",
 					"markdownDescription": "%config.completion.requireSeparator%",
@@ -3676,5 +3682,5 @@
 	"sponsor": {
 		"url": "https://github.com/LuaLS/lua-language-server/issues/484"
 	},
-	"version": "3.19.1"
+	"version": "3.19.2"
 }

package.nls.es-419.json

@@ -26,6 +26,7 @@
     "config.completion.keywordSnippet.Replace": "Solo muestra `snippet de sintaxis`.",
     "config.completion.maxSuggestCount": "Número máximo de campos a analizar para autocompletar. Cuando un objeto tiene más campos que este límite, las sugerencias requerirán una entrada más específica para aparecer.",
     "config.completion.postfix": "El símbolo usado para lanzar la sugerencia posfija.",
+    "config.completion.requireFunction": "La función que se inserta cuando se activa el auto-require.",
     "config.completion.requireSeparator": "Separador usado en `require`.",
     "config.completion.showParams": "Muestra los parámetros en la lista de completado. Cuando la función tiene múltiples definiciones, se mostrarán por separado.",
     "config.completion.showWord": "Muestra palabras contextuales en las sugerencias.",

package.nls.ja-jp.json

@@ -26,6 +26,7 @@
     "config.completion.keywordSnippet.Replace": "構文スニペットのみを表示します。",
     "config.completion.maxSuggestCount": "補完用に分析するフィールドの最大数。オブジェクトがこの制限より多くのフィールドを持つ場合、補完が表示されるにはより具体的な入力が必要になります。",
     "config.completion.postfix": "後置提案をトリガーするために使用されるシンボル。",
+    "config.completion.requireFunction": "自動`require`時に挿入される関数。",
     "config.completion.requireSeparator": "`require`時に使用される区切り文字。",
     "config.completion.showParams": "補完リストにパラメータを表示します。関数に複数の定義がある場合、個別に表示されます。",
     "config.completion.showWord": "提案内にコンテキストワードを表示します。",

package.nls.json

@@ -26,6 +26,7 @@
     "config.completion.keywordSnippet.Replace": "Only shows `syntax snippet`.",
     "config.completion.maxSuggestCount": "Maximum number of fields to analyze for completions. When an object has more fields than this limit, completions will require more specific input to appear.",
     "config.completion.postfix": "The symbol used to trigger the postfix suggestion.",
+    "config.completion.requireFunction": "The function to insert when an auto-require is triggered.",
     "config.completion.requireSeparator": "The separator used when `require`.",
     "config.completion.showParams": "Display parameters in completion list. When the function has multiple definitions, they will be displayed separately.",
     "config.completion.showWord": "Show contextual words in suggestions.",

package.nls.pt-br.json

@@ -26,6 +26,7 @@
     "config.completion.keywordSnippet.Replace": "Mostra apenas o `trecho de sintaxe`.",
     "config.completion.maxSuggestCount": "Número máximo de campos analisados para autocompletar. Se um objeto tiver mais campos que esse limite, serão necessárias entradas mais específicas para que as sugestões apareçam.",
     "config.completion.postfix": "Símbolo usado para acionar sugestões de pós-fixo.",
+    "config.completion.requireFunction": "A função inserida quando o auto-require é acionado.",
     "config.completion.requireSeparator": "Separador usado em `require`.",
     "config.completion.showParams": "Mostrar parâmetros na lista de conclusão. Se a função tiver várias definições, elas serão exibidas separadamente.",
     "config.completion.showWord": "Mostrar palavras de contexto nas sugestões.",

package.nls.zh-cn.json

@@ -26,6 +26,7 @@
     "config.completion.keywordSnippet.Replace": "只显示 `语法片段`。",
     "config.completion.maxSuggestCount": "自动完成时最多分析的字段数量。当对象字段超过此上限时，需要更精确的输入才会显示补全。",
     "config.completion.postfix": "用于触发后缀建议的符号。",
+    "config.completion.requireFunction": "触发自动 `require` 时插入的函数名。",
     "config.completion.requireSeparator": "`require` 时使用的分隔符。",
     "config.completion.showParams": "在建议列表中显示函数的参数信息，函数拥有多个定义时会分开显示。",
     "config.completion.showWord": "在建议中显示上下文单词。",

package.nls.zh-tw.json

@@ -26,6 +26,7 @@
     "config.completion.keywordSnippet.Replace": "只顯示 `語法片段`。",
     "config.completion.maxSuggestCount": "自動完成時最多分析的欄位數量。若物件欄位超過此上限，必須提供更精確的輸入才會顯示建議。",
     "config.completion.postfix": "用於觸發後綴建議的符號。",
+    "config.completion.requireFunction": "觸發自動 `require` 時插入的函式名稱。",
     "config.completion.requireSeparator": "`require` 時使用的分隔符。",
     "config.completion.showParams": "在建議列表中顯示函式的參數資訊，函式擁有多個定義時會分開顯示。",
     "config.completion.showWord": "在建議中顯示上下文單詞。",

package/build.lua

@@ -1,6 +1,6 @@
 local json = require 'json-beautify'
 
-local VERSION = "3.19.1"
+local VERSION = "3.19.2"
 
 local fsu     = require 'fs-utility'
 local package = json.decode(fsu.loadFile(ROOT / 'package.json'))