Add configuration value for what auto-require adds

Auto-require always adds the `require` function specifically. However,
it's common in projects to have their own special `require` functions,
like `import` or `include` -- so this PR adds a configuration option
which lets you change what it imports.

Author: NyakoFox

changelog.md

@@ -8,6 +8,7 @@
 * `FIX` Prevent class methods from triggering missing-fields diagnostics
 * `ADD` missing locale
 * `FIX` updates the EmmyLuaCodeStyle submodule reference to a newer commit, ensuring compatibility with GCC 15
+* `NEW` Setting: `Lua.completion.requireFunction`: What the auto-require completion should add (e.g. `import` instead of `require`)
 
 ## 3.14.0
 `2025-4-7`

doc/en-us/config.md

@@ -148,6 +148,22 @@ string
 "@"
 ```
 
+# completion.requireFunction
+
+The function to insert when an auto-require is triggered.
+
+## type
+
+```ts
+string
+```
+
+## default
+
+```jsonc
+"require"
+```
+
 # completion.requireSeparator
 
 The separator used when `require`.

doc/pt-br/config.md

@@ -148,6 +148,22 @@ string
 "@"
 ```
 
+# completion.requireFunction
+
+The function to insert when an auto-require is triggered.
+
+## type
+
+```ts
+string
+```
+
+## default
+
+```jsonc
+"require"
+```
+
 # completion.requireSeparator
 
 The separator used when `require`.

doc/zh-cn/config.md

@@ -148,6 +148,22 @@ string
 "@"
 ```
 
+# completion.requireFunction
+
+The function to insert when an auto-require is triggered.
+
+## type
+
+```ts
+string
+```
+
+## default
+
+```jsonc
+"require"
+```
+
 # completion.requireSeparator
 
 `require` 时使用的分隔符。

doc/zh-tw/config.md

@@ -148,6 +148,22 @@ string
 "@"
 ```
 
+# completion.requireFunction
+
+The function to insert when an auto-require is triggered.
+
+## type
+
+```ts
+string
+```
+
+## default
+
+```jsonc
+"require"
+```
+
 # completion.requireSeparator
 
 `require` 時使用的分隔符。

locale/en-us/setting.lua

@@ -180,6 +180,8 @@ config.completion.autoRequire            =
 "When the input looks like a file name, automatically `require` this file."
 config.completion.showParams             =
 "Display parameters in completion list. When the function has multiple definitions, they will be displayed separately."
+config.completion.requireFunction        =
+"The function to insert when an auto-require is triggered."
 config.completion.requireSeparator       =
 "The separator used when `require`."
 config.completion.postfix                =

locale/es-419/setting.lua

@@ -182,6 +182,8 @@ config.completion.autoRequire            =
 "Agrega automáticamente el `require` correspondiente cuando la entrada se parece a un nombre de archivo."
 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.requireFunction        = -- TODO: need translate!
+"The function to insert when an auto-require is triggered."
 config.completion.requireSeparator       =
 "Separador usado en `require`."
 config.completion.postfix                =

locale/ja-jp/setting.lua

@@ -180,6 +180,8 @@ config.completion.autoRequire            = -- TODO: need translate!
 "When the input looks like a file name, automatically `require` this file."
 config.completion.showParams             = -- TODO: need translate!
 "Display parameters in completion list. When the function has multiple definitions, they will be displayed separately."
+config.completion.requireFunction        = -- TODO: need translate!
+"The function to insert when an auto-require is triggered."
 config.completion.requireSeparator       = -- TODO: need translate!
 "The separator used when `require`."
 config.completion.postfix                = -- TODO: need translate!

locale/pt-br/setting.lua

@@ -180,6 +180,8 @@ config.completion.autoRequire            = -- TODO: need translate!
 "When the input looks like a file name, automatically `require` this file."
 config.completion.showParams             = -- TODO: need translate!
 "Display parameters in completion list. When the function has multiple definitions, they will be displayed separately."
+config.completion.requireFunction        = -- TODO: need translate!
+"The function to insert when an auto-require is triggered."
 config.completion.requireSeparator       = -- TODO: need translate!
 "The separator used when `require`."
 config.completion.postfix                = -- TODO: need translate!

locale/zh-cn/setting.lua

@@ -179,6 +179,8 @@ config.completion.autoRequire            =
 "输入内容看起来是个文件名时，自动 `require` 此文件。"
 config.completion.showParams             =
 "在建议列表中显示函数的参数信息，函数拥有多个定义时会分开显示。"
+config.completion.requireFunction        = -- TODO: need translate!
+"The function to insert when an auto-require is triggered."
 config.completion.requireSeparator       =
 "`require` 时使用的分隔符。"
 config.completion.postfix                =