Merge branch 'master' into max-fields-count

Author: sumneko

.pre-commit-hooks.yaml

@@ -0,0 +1,12 @@
+---
+- id: lua-language-server-check
+  language: lua
+  name: lua language server check
+  description: >
+    use lua language server to check lua files
+  entry: lua-language-server
+  types:
+    - lua
+  args:
+    - --check
+    - .

README.md

@@ -14,7 +14,7 @@ The Lua language server provides various language features for Lua to make devel
 
 ## Features
 
-- ⚙️ Supports `Lua 5.4`, `Lua 5.3`, `Lua 5.2`, `Lua 5.1`, and `LuaJIT`
+- ⚙️ Supports `Lua 5.5`, `Lua 5.4`, `Lua 5.3`, `Lua 5.2`, `Lua 5.1`, and `LuaJIT`
 - 📄 Over 20 supported [annotations](https://luals.github.io/wiki/annotations/) for documenting your code
 - ↪ Go to definition
 - 🦺 Dynamic [type checking](https://luals.github.io/wiki/type-checking/)
@@ -65,6 +65,8 @@ The install methods below are maintained by community members.
 - `zh-cn` 🇨🇳
 - `zh-tw` 🇹🇼
 - `pt-br` 🇧🇷
+- `ja-jp` 🇯🇵
+- `es-419` 🇪🇸
 
 
 > **Note**

changelog.md

@@ -2,6 +2,7 @@
 
 ## Unreleased
 <!-- Add all new changes here. They will be moved under a version at release -->
+* `FIX` Plugin virtual comment style and behavior issues
 * `NEW` Support Lua 5.5
 * `FIX` Incorrect generation of function signatures with tuple-parameters
 * `NEW` Doc output now contains file paths for `@alias` and `@enum` types
@@ -12,6 +13,7 @@
 * `FIX` Typed `@field` (eg `---@field [string] boolean`) should not override other defined field [#2171](https://github.com/LuaLS/lua-language-server/issues/2171), [#2711](https://github.com/LuaLS/lua-language-server/issues/2711)
 * `FIX` don't return empty hover doc when luals failed to find definition
 * `FIX` Prevent stack overflow when attempting to resolve function return values. [#3246](https://github.com/LuaLS/lua-language-server/issues/3246)
+* `FIX` Fix type annotations for `string.buffer` module
 
 ## 3.15.0
 `2025-6-25`

lua

@@ -0,0 +1 @@
+script

lua-language-server

@@ -0,0 +1,16 @@
+#!/usr/bin/env lua
+local f = '%q'
+local args = {
+    'bee',
+    debug.getinfo(1).source:match("@?(.*/)[^/]+/") .. 'main.lua',
+}
+for _, v in ipairs(arg) do
+    table.insert(args, f:format(v))
+end
+local isok, reason, ret = os.execute(table.concat(args, ' '))
+if type(isok) == type(0) then
+    ret = isok
+end
+if ret ~= 0 then
+    os.exit(1)
+end

lua-language-server-scm-1.rockspec

@@ -0,0 +1,39 @@
+local git_ref = '3.15.1'
+local modrev = 'scm'
+local specrev = '1'
+
+rockspec_format = '3.0'
+package = 'lua-language-server'
+version = modrev .. '-' .. specrev
+
+local repo_url = 'https://github.com/LuaLS/lua-language-server'
+
+description = {
+  summary = 'A language server that offers Lua language support - programmed in Lua',
+  detailed =
+  [[The Lua language server provides various language features for Lua to make development easier and faster. With nearly a million installs in Visual Studio Code, it is the most popular extension for Lua language support.]],
+  labels = { 'lua', 'language-server', 'lpeg', 'hacktoberfest', 'lsp', 'lsp-server', 'lpeglabel' },
+  homepage = repo_url,
+  license = 'MIT'
+}
+
+source = {
+  url = repo_url .. '/archive/' .. git_ref .. '.zip',
+  dir = package .. '-' .. git_ref,
+}
+
+dependencies = { 'lpeglabel', 'EmmyLuaCodeStyle', 'bee.lua' }
+
+build = {
+  type = 'builtin',
+  copy_directories = { 'meta', 'locale' },
+  install = {
+    bin = {
+      [package] = package,
+    },
+    conf = {
+      ['../main.lua'] = 'main.lua',
+      ['../debugger.lua'] = 'debugger.lua',
+    },
+  }
+}

meta/template/string.buffer.lua

@@ -262,7 +262,7 @@ function buf:ref() end
 --- Serializes (encodes) the Lua object to the buffer
 ---
 --- This function may throw an error when attempting to serialize unsupported object types, circular references or deeply nested tables.
----@param obj string.buffer.data
+---@param obj any
 ---@return string.buffer
 function buf:encode(obj) end
 
@@ -277,14 +277,14 @@ function buf:encode(obj) end
 ---
 --- Attempting to de-serialize an FFI type will throw an error, if the FFI library is not built-in or has not been loaded, yet.
 ---
----@return string.buffer.data|nil obj
+---@return any obj
 function buf:decode() end
 
 
 --- Serializes (encodes) the Lua object obj
 ---
 --- This function may throw an error when attempting to serialize unsupported object types, circular references or deeply nested tables.
----@param obj string.buffer.data
+---@param obj any
 ---@return string
 function buffer.encode(obj) end
 
@@ -298,7 +298,7 @@ function buffer.encode(obj) end
 --- Attempting to de-serialize an FFI type will throw an error, if the FFI library is not built-in or has not been loaded, yet.
 ---
 ---@param str string
----@return string.buffer.data|nil obj
+---@return any obj
 function buffer.decode(str) end
 
 

script/core/diagnostics/unused-vararg.lua

@@ -25,7 +25,7 @@ return function (uri, callback)
 
         for _, arg in ipairs(args) do
             if arg.type == '...' then
-                if not arg.ref then
+                if not arg.ref and not arg.name then
                     callback {
                         start   = arg.start,
                         finish  = arg.finish,

script/core/find-source.lua

@@ -15,6 +15,9 @@ return function (state, position, accept)
     local len = math.huge
     local result
     guide.eachSourceContain(state.ast, position, function (source)
+        if source.virtual then
+            return
+        end
         if source.type == 'function' then
             if not isValidFunctionPos(source, position) then
                 return

script/files.lua

@@ -70,6 +70,9 @@ local function getRealParent(path)
         return path
     end
     local res = sys.fullpath(path)
+    if not res then
+        return path
+    end
     return getRealParent(parent) / res:filename()
 end