Merge remote-tracking branch 'upstream/master' into function-field-show-params

Author: hahn-kev

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -0,0 +1,95 @@
+name: Bug Report
+description: Report a bug with the lua-language-server
+body:
+  - type: markdown
+    attributes:
+      value: >
+        **Please check for similar issues before continuing!**
+  - type: dropdown
+    id: client
+    attributes:
+      label: How are you using the lua-language-server?
+      options:
+        - Visual Studio Code Extension (sumneko.lua)
+        - NeoVim
+        - Kakoune
+        - Command Line
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: OS
+    attributes:
+      label: Which OS are you using?
+      options:
+        - Windows
+        - Linux
+        - MacOS
+        - Windows WSL
+        - Other
+    validations:
+      required: true
+  - type: dropdown
+    id: type
+    attributes:
+      label: What is the issue affecting?
+      description: Please select all of the areas affected by this issue.
+      multiple: true
+      options:
+        - Annotations
+        - Type Checking
+        - Completion
+        - Diagnostics/Syntax Checking
+        - Hover
+        - Libraries
+        - Formatting
+        - Spell Checking
+        - Plugins
+        - Other
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behaviour
+      description: What is the expected behaviour?
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behaviour
+      description: What is actually happening that is an error?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Reproduction steps
+      description: >
+        Please provide steps to reproduce the error. The more detail the better
+        as it helps us fully understand the issue.
+      value: |
+        1. Go to '...'
+        2. Click '...'
+        3. See error '...'
+    validations:
+      required: true
+  - type: textarea
+    id: additional-notes
+    attributes:
+      label: Additional Notes
+      description: >
+        Please provide any additional notes, context,
+        and media you have.
+  - type: textarea
+    id: log-file
+    attributes:
+      label: Log File
+      description: >
+        Please provide your log file. Refer to the wiki to find your log file:
+        https://github.com/sumneko/lua-language-server/wiki/FAQ#where-can-i-find-the-log-file
+  - type: markdown
+    attributes:
+      value: |
+        Thank you very much for helping improve the language server! ❤️

.github/ISSUE_TEMPLATE/bug_report.md

@@ -40,5 +40,8 @@
             "/meta"
         ],
         "checkThirdParty": false
+    },
+    "type": {
+        "castNumberToInteger": false
     }
 }

.luarc.json

@@ -28,12 +28,21 @@
 			"address": "127.0.0.1:11427",
 			"outputCapture": [
 			],
+			"sourceFormat": "string",
 			"sourceMaps": [
 				[
-					"./*",
-					"${workspaceFolder}/*"
+					"script/*",
+					"${workspaceFolder}/script/*"
 				]
-			]
+			],
+			"windows": {
+				"sourceMaps": [
+					[
+						"script\\*",
+						"${workspaceFolder}/script/*"
+					]
+				],
+			},
 		},
 		{
 			"name": "🍉build-3rd-meta",

.vscode/launch.json

@@ -1,80 +1,107 @@
 # lua-language-server
 
 ![build](https://github.com/sumneko/lua-language-server/workflows/build/badge.svg)
-![version](https://vsmarketplacebadge.apphb.com/version-short/sumneko.lua.svg)
+[![version](https://vsmarketplacebadge.apphb.com/version-short/sumneko.lua.svg)](https://marketplace.visualstudio.com/items?itemName=sumneko.lua)
 ![installs](https://vsmarketplacebadge.apphb.com/installs-short/sumneko.lua.svg)
 ![downloads](https://vsmarketplacebadge.apphb.com/downloads-short/sumneko.lua.svg)
+[![Average time to resolve an issue](https://isitmaintained.com/badge/resolution/sumneko/lua-language-server.svg)](https://github.com/sumneko/lua-language-server/issues "Average time to resolve an issue")
 
-## Install In VSCode
-https://marketplace.visualstudio.com/items?itemName=sumneko.lua
 
-![avatar](https://github.com/sumneko/vscode-lua/raw/master/images//Install%20In%20VSCode.gif)
+***Lua development just got a whole lot better*** 🧠
 
-## Change Log
-https://github.com/sumneko/lua-language-server/blob/master/changelog.md
+The Lua language server provides various language features for Lua to make development easier and faster. With around half a million installs on Visual Studio Code, it is the most popular extension for Lua language support.
 
-## Wiki
-https://github.com/sumneko/lua-language-server/wiki
+## Features
 
-## Feature
+- 📄 Over 20 supported [annotations](https://github.com/sumneko/lua-language-server/wiki/Annotations) for documenting your code
+- ↪ Go to definition
+- 🦺 Dynamic [type checking](https://github.com/sumneko/lua-language-server/wiki/Type-Checking)
+- 🔍 Find references
+- ⚠️ [Diagnostics/Warnings](https://github.com/sumneko/lua-language-server/wiki/Diagnostics)
+- 🕵️ [Syntax checking](https://github.com/sumneko/lua-language-server/wiki/Syntax-Errors)
+- 📝 Element renaming
+- 🗨️ Hover to view details on variables, functions, and more
+- 🖊️ Autocompletion
+- 📚 Support for [libraries](https://github.com/sumneko/lua-language-server/wiki/Libraries)
+- 💅 [Code formatting](https://github.com/sumneko/lua-language-server/wiki/Formatter)
+- 💬 [Spell checking](https://github.com/sumneko/lua-language-server/wiki/Formatter)
+- 🛠️ Custom [plugins](https://github.com/sumneko/lua-language-server/wiki/Plugins)
 
-- [x] Goto Definition
-- [x] Find All References
-- [x] Hover
-- [x] Diagnostics
-- [x] Rename
-- [x] Auto Completion
-- [x] IntelliSense
-- [x] Signature Help
-- [x] Document Symbols
-- [x] Workspace Symbols
-- [x] Syntax Check
-- [x] Highlight
-- [x] Code Action
-- [x] EmmyLua Annotation
-- [x] Multi Workspace
-- [x] Semantic Tokens
-- [x] Formatter
+## Install
 
-## Version
+The language server can easily be installed for use in VS Code, but it can also be used by other clients using the command line.
 
-- [x] Lua 5.1
-- [x] Lua 5.2
-- [x] Lua 5.3
-- [x] Lua 5.4
-- [x] LuaJIT
+### Visual Studio Code
+[![Install in VS Code](https://img.shields.io/badge/Install%20For-VS%20Code-blue?style=for-the-badge&logo=visualstudiocode "Install in VS Code")](https://marketplace.visualstudio.com/items?itemName=sumneko.lua)
 
-If you find any mistakes, please [tell me][issues] or use [Pull Requests][@meta] to fix them directly.
+The language server and Visual Studio Code client can be installed from [the VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=sumneko.lua).
 
-如果你发现了任何错误，请[告诉我][issues]或使用[Pull Requests][@meta]来直接修复。
+![](https://github.com/sumneko/vscode-lua/raw/master/images//Install%20In%20VSCode.gif)
+
+### Command Line
+[![Install for command line](https://img.shields.io/badge/Install%20For-Command%20Line-blue?style=for-the-badge&logo=windowsterminal "Install for command line")](https://github.com/sumneko/lua-language-server/wiki/Getting-Started#command-line)
+
+Check the [wiki for a guide](https://github.com/sumneko/lua-language-server/wiki/Getting-Started#command-line) to install the language server for use on the command line. This allows the language server to be used for NeoVim and other clients that follow the language server protocol.
+
+## Supported Lua Versions
+| Version |    Supported   |
+| :-----: | :------------: |
+| Lua 5.1 | ![][checkmark] |
+| Lua 5.2 | ![][checkmark] |
+| Lua 5.3 | ![][checkmark] |
+| Lua 5.4 | ![][checkmark] |
+| LuaJIT  | ![][checkmark] |
+
+## Links
+- [Changelog](https://github.com/sumneko/lua-language-server/blob/master/changelog.md)
+- [Wiki](https://github.com/sumneko/lua-language-server/wiki)
+- [FAQ](https://github.com/sumneko/lua-language-server/wiki/FAQ)
+- [Report an issue][issues]
+- [Suggest a feature][issues]
+- [Discuss](https://github.com/sumneko/lua-language-server/discussions)
+
+> If you find any mistakes, please [report it][issues] or open a [pull request][pulls] if you have a fix of your own ❤️
+>
+> 如果你发现了任何错误，请[告诉我][issues]或使用[Pull Requests][pulls]来直接修复。❤️
 
 [issues]: https://github.com/sumneko/lua-language-server/issues
-[@meta]: https://github.com/sumneko/lua-language-server/tree/master/meta/template
+[pulls]: https://github.com/sumneko/lua-language-server/pulls
+
+## Available Languages
 
-## Locale
+- `en-us` 🇺🇸
+- `zh-cn` 🇨🇳
+- `zh-tw` 🇹🇼
+- `pt-br` 🇧🇷
 
-- [x] en-us
-- [x] zh-cn
-- [x] zh-tw (thanks [AlexCai2019](https://github.com/AlexCai2019))
-- [x] pt-br (thanks [Jeferson Ferreira](https://github.com/jefersonf))
 
-Please [help me][en-US] improve the quality of `en-US`.
+> ℹ Note: All translations are provided and collaborated on by the community. If you find an inappropriate or harmful translation, [please report it immediately](https://github.com/sumneko/lua-language-server/issues).
+
+Are you able to [provide a translation](https://github.com/sumneko/lua-language-server/wiki/Translations)? It would be greatly appreciated!
+
+Thank you to [all contributors of translations](https://github.com/sumneko/lua-language-server/commits/master/locale)!
 
 [en-US]: https://github.com/sumneko/lua-language-server/tree/master/locale/en-us
 
-## Build
-The extensions in the VSCode market already come with pre-compiled binary files, usually you don't need to compile them.
+## Configuration
+Configuration of the server can be done in a number of ways, which are explained more in-depth in the [wiki](https://github.com/sumneko/lua-language-server/wiki/Configuration-File).
+
+### Visual Studio Code
+You can use the [settings editor](https://code.visualstudio.com/docs/getstarted/settings#_settings-editor) or edit the [raw JSON file](https://code.visualstudio.com/docs/getstarted/settings#_settingsjson).
 
-Other clients can first try to download and use [pre-compiled binary files](https://github.com/sumneko/lua-language-server/wiki/PreCompiled-Binaries).
+### Other
+See the [configuration file wiki page](https://github.com/sumneko/lua-language-server/wiki/Configuration-File).
 
-If you need to compile by yourself, please refer to [here](https://github.com/sumneko/lua-language-server/wiki/Build-and-Run)
 
-## Setting
+## Privacy
+This language server has **opt-in** telemetry that collects usage data and sends it to the development team to help improve the extension. Read our [privacy policy](https://github.com/sumneko/lua-language-server/wiki/Home#privacy) to learn more.
 
-* In VSCode: Just use the setting of VSCode.
-* Standalone: See https://github.com/sumneko/lua-language-server/wiki/Setting
+
+## Contributors
+![GitHub Contributors Image](https://contrib.rocks/image?repo=sumneko/lua-language-server)
 
 ## Credit
+Software that the language server (or the development of it) uses:
 
 * [bee.lua](https://github.com/actboy168/bee.lua)
 * [luamake](https://github.com/actboy168/luamake)
@@ -91,27 +118,5 @@ If you need to compile by yourself, please refer to [here](https://github.com/su
 * [EmmyLuaCodeStyle](https://github.com/CppCXY/EmmyLuaCodeStyle)
 * [inspect.lua](https://github.com/kikito/inspect.lua)
 
-## Acknowledgement
-
-* [actboy168](https://github.com/actboy168)
-* [Dmitry Sannikov](https://github.com/dasannikov)
-* [Jayden Charbonneau](https://github.com/Reshiram110)
-* [Stjepan Bakrac](https://github.com/z16)
-* [Peter Young](https://github.com/young40)
-* [Li Xiaobin](https://github.com/Xiaobin0860)
-* [Fedora7](https://github.com/Fedora7)
-* [Allen Shaw](https://github.com/shuxiao9058)
-* [Bartel](https://github.com/Letrab)
-* [Ruin0x11](https://github.com/Ruin0x11)
-* [uhziel](https://github.com/uhziel)
-* [火凌之](https://github.com/PhoenixZeng)
-* [CppCXY](https://github.com/CppCXY)
-* [Ketho](https://github.com/Ketho)
-* [Folke Lemaitre](https://github.com/folke)
-* [Vikas Raj](https://github.com/numToStr)
-* [kevinhwang91](https://github.com/kevinhwang91)
-* [Cassolette](https://github.com/Cassolette)
-
-## Telemetry
-
-This language server collects usage data and sends it to the development team to help improve the extension. Read our [privacy policy](https://github.com/sumneko/lua-language-server/wiki/Privacy-Policy) to learn more and how to disable any telemetry.
+
+[checkmark]: https://gist.githubusercontent.com/carsakiller/362482775731de88cdafeeca9f6a392e/raw/cd3976e92a85aafe1f33e3f9fe3d0e0bd451902c/checkmark.svg

3rd/EmmyLuaCodeStyle

@@ -1,5 +1,29 @@
 # changelog
 
+## 3.5.2
+`2022-8-1`
+* `FIX` [#1395](https://github.com/sumneko/lua-language-server/issues/1395)
+* `FIX` [#1403](https://github.com/sumneko/lua-language-server/issues/1403)
+* `FIX` [#1405](https://github.com/sumneko/lua-language-server/issues/1405)
+* `FIX` [#1406](https://github.com/sumneko/lua-language-server/issues/1406)
+* `FIX` [#1418](https://github.com/sumneko/lua-language-server/issues/1418)
+
+## 3.5.1
+`2022-7-26`
+* `NEW` supports [color](https://github.com/sumneko/lua-language-server/pull/1379)
+* `NEW` setting `Lua.runtime.pluginArgs`
+* `CHG` setting `type.castNumberToInteger` default by `true`
+* `CHG` improve supports for multi-workspace
+* `FIX` [#1354](https://github.com/sumneko/lua-language-server/issues/1354)
+* `FIX` [#1355](https://github.com/sumneko/lua-language-server/issues/1355)
+* `FIX` [#1363](https://github.com/sumneko/lua-language-server/issues/1363)
+* `FIX` [#1365](https://github.com/sumneko/lua-language-server/issues/1365)
+* `FIX` [#1367](https://github.com/sumneko/lua-language-server/issues/1367)
+* `FIX` [#1368](https://github.com/sumneko/lua-language-server/issues/1368)
+* `FIX` [#1370](https://github.com/sumneko/lua-language-server/issues/1370)
+* `FIX` [#1375](https://github.com/sumneko/lua-language-server/issues/1375)
+* `FIX` [#1391](https://github.com/sumneko/lua-language-server/issues/1391)
+
 ## 3.5.0
 `2022-7-19`
 * `NEW` `LuaDoc`: `---@operator`: