chore(build): auto-generate vimdoc, schemas and annotations

README.md

@@ -248,7 +248,6 @@ local my_settings = Neoconf.get("neodev", defaults)
 - [x] [ltex](https://github.com/valentjn/vscode-ltex/tree/develop/package.json)
 - [x] [lua_ls](https://github.com/LuaLS/vscode-lua/tree/master/package.json)
 - [x] [luau_lsp](https://github.com/JohnnyMorganz/luau-lsp/tree/main/editors/code/package.json)
-- [x] [nickel_ls](https://github.com/tweag/nickel/tree/master/lsp/client-extension/package.json)
 - [x] [omnisharp](https://github.com/OmniSharp/omnisharp-vscode/tree/master/package.json)
 - [x] [perlls](https://github.com/richterger/Perl-LanguageServer/tree/master/clients/vscode/perl/package.json)
 - [x] [perlnavigator](https://github.com/bscan/PerlNavigator/tree/main/package.json)

schemas/denols.json

@@ -8,6 +8,16 @@
       "scope": "window",
       "type": "string"
     },
+    "deno.cacheOnSave": {
+      "default": false,
+      "examples": [
+        true,
+        false
+      ],
+      "markdownDescription": "Controls if the extension should cache the active document's dependencies on save.",
+      "scope": "resource",
+      "type": "boolean"
+    },
     "deno.certificateStores": {
       "default": null,
       "items": {

schemas/elixirls.json

@@ -1,6 +1,6 @@
 {
   "$schema": "http://json-schema.org/draft-07/schema#",
-  "description": "Elixir support with debugger, autocomplete, and more. Powered by ElixirLS.",
+  "description": "Elixir support with debugger, autocomplete, and more - Powered by ElixirLS.",
   "properties": {
     "elixirLS.additionalWatchedExtensions": {
       "default": [],
@@ -14,19 +14,19 @@
     },
     "elixirLS.autoBuild": {
       "default": true,
-      "description": "Trigger ElixirLS build when code is saved",
+      "description": "Trigger ElixirLS build when code is saved.",
       "scope": "resource",
       "type": "boolean"
     },
     "elixirLS.autoInsertRequiredAlias": {
       "default": true,
-      "description": "Enable auto-insert required alias. By default, it's true, which means enabled.",
+      "description": "Enable auto-insert required alias. This is true (enabled) by default.",
       "scope": "window",
       "type": "boolean"
     },
     "elixirLS.dialyzerEnabled": {
       "default": true,
-      "description": "Run ElixirLS's rapid Dialyzer when code is saved",
+      "description": "Run ElixirLS's rapid Dialyzer when code is saved.",
       "scope": "resource",
       "type": "boolean"
     },
@@ -48,7 +48,7 @@
     },
     "elixirLS.dialyzerWarnOpts": {
       "default": [],
-      "description": "Dialyzer options to enable or disable warnings. See Dialyzer's documentation for options. Note that the \"race_conditions\" option is unsupported",
+      "description": "Dialyzer options to enable or disable warnings - See Dialyzer's documentation for options. Note that the \"race_conditions\" option is unsupported",
       "items": {
         "enum": [
           "error_handling",
@@ -82,7 +82,7 @@
     },
     "elixirLS.enableTestLenses": {
       "default": false,
-      "description": "Show code lenses to run tests in terminal",
+      "description": "Show code lenses to run tests in terminal.",
       "scope": "resource",
       "type": "boolean"
     },
@@ -94,12 +94,12 @@
     },
     "elixirLS.fetchDeps": {
       "default": false,
-      "description": "Automatically fetch project dependencies when compiling",
+      "description": "Automatically fetch project dependencies when compiling.",
       "scope": "resource",
       "type": "boolean"
     },
     "elixirLS.languageServerOverridePath": {
-      "description": "Absolute path to alternative ElixirLS release that will override packaged release.",
+      "description": "Absolute path to alternative ElixirLS release that will override the packaged release",
       "minLength": 0,
       "scope": "resource",
       "type": "string"
@@ -126,13 +126,13 @@
     },
     "elixirLS.signatureAfterComplete": {
       "default": true,
-      "description": "Show signature help after confirming autocomplete",
+      "description": "Show signature help after confirming autocomplete.",
       "scope": "resource",
       "type": "boolean"
     },
     "elixirLS.suggestSpecs": {
       "default": true,
-      "description": "Suggest @spec annotations inline using Dialyzer's inferred success typings (Requires Dialyzer)",
+      "description": "Suggest @spec annotations inline using Dialyzer's inferred success typings (Requires Dialyzer).",
       "scope": "resource",
       "type": "boolean"
     },

schemas/fsautocomplete.json

@@ -126,6 +126,7 @@
     },
     "FSharp.fsac.conserveMemory": {
       "default": false,
+      "deprecationMessage": "This setting is deprecated. Use FSharp.fsac.gc.conserveMemory instead.",
       "description": "Configures FsAutoComplete with settings intended to reduce memory consumption. Requires restart.",
       "type": "boolean"
     },
@@ -137,6 +138,25 @@
       },
       "type": "array"
     },
+    "FSharp.fsac.gc.conserveMemory": {
+      "markdownDescription": "Configures the garbage collector to [conserve memory](https://learn.microsoft.com/en-us/dotnet/core/runtime-config/garbage-collector#conserve-memory) at the expense of more frequent garbage collections and possibly longer pause times. Acceptable values are 0-9. Any non-zero value will allow the [Large Object Heap](https://learn.microsoft.com/en-us/dotnet/standard/garbage-collection/large-object-heap) to be compacted automatically if it has too much fragmentation. Requires restart.",
+      "maximum": 9,
+      "minimum": 0,
+      "type": "integer"
+    },
+    "FSharp.fsac.gc.heapCount": {
+      "default": 2,
+      "markdownDescription": "Limits the number of [heaps](https://learn.microsoft.com/en-us/dotnet/standard/garbage-collection/fundamentals#the-managed-heap) created by the garbage collector. Applies to server garbage collection only. See [Middle Ground between Server and Workstation GC](https://devblogs.microsoft.com/dotnet/middle-ground-between-server-and-workstation-gc/) for more details. This can allow FSAC to still benefit from Server garbage collection while still limiting the number of heaps. [Only available on .NET 7 or higher](https://github.com/ionide/ionide-vscode-fsharp/issues/1899#issuecomment-1649009462). Requires restart.",
+      "required": [
+        "FSharp.fsac.gc.server"
+      ],
+      "type": "integer"
+    },
+    "FSharp.fsac.gc.server": {
+      "default": true,
+      "markdownDescription": "Configures whether the application uses workstation garbage collection or server garbage collection. See [Workstation vs Server Garbage Collection](https://devblogs.microsoft.com/premier-developer/understanding-different-gc-modes-with-concurrency-visualizer/#workstation-gc-vs-server-gc) for more details. Workstation will use less memory but Server will have more throughput. Requires restart.",
+      "type": "boolean"
+    },
     "FSharp.fsac.netCoreDllPath": {
       "default": "",
       "description": "The path to the 'fsautocomplete.dll', a directory containing TFM-specific versions of fsautocomplete.dll, or a directory containing fsautocomplete.dll. Useful for debugging a self-built FSAC. If a DLL is specified, uses it directly. If a directory is specified and it contains TFM-specific folders (net6.0, net7.0, etc) then that directory will be probed for the best TFM to use for the current runtime. This is useful when working with a local copy of FSAC, you can point directly to the bin/Debug or bin/Release folder and it'll Just Work. Finally, if a directory is specified and there are no TFM paths, then fsautocomplete.dll from that directory is used. Requires restart.",
@@ -156,6 +176,14 @@
       },
       "type": "array"
     },
+    "FSharp.fsac.sourceTextImplementation": {
+      "default": "NamedText",
+      "description": "EXPERIMENTAL. Enables the use of a new source text implementation. This may have better memory characteristics. Requires restart.",
+      "enum": [
+        "NamedText",
+        "RoslynSourceText"
+      ]
+    },
     "FSharp.fsiExtraParameters": {
       "default": [],
       "markdownDescription": "An array of additional command line parameters to pass to FSI when it is started. See [the Microsoft documentation](https://docs.microsoft.com/en-us/dotnet/fsharp/language-reference/fsharp-interactive-options) for an exhaustive list.",
@@ -300,7 +328,7 @@
     },
     "FSharp.openTelemetry.enabled": {
       "default": false,
-      "description": "Enables OpenTelemetry exporter. See https://opentelemetry.io/docs/reference/specification/protocol/exporter/ for environment variables to configure for the exporter. Requires Restart.",
+      "markdownDescription": "Enables OpenTelemetry exporter. See [OpenTelemetry Protocol Exporter](https://opentelemetry.io/docs/reference/specification/protocol/exporter/) for environment variables to configure for the exporter. Requires Restart.",
       "type": "boolean"
     },
     "FSharp.pipelineHints.enabled": {
@@ -353,6 +381,20 @@
       "description": "Enables detection of cases when names of functions and values can be simplified",
       "type": "boolean"
     },
+    "FSharp.simplifyNameAnalyzerExclusions": {
+      "default": [
+        ".*\\.g\\.fs",
+        ".*\\.cg\\.fs"
+      ],
+      "description": "A set of regex patterns to exclude from the simplify name analyzer",
+      "items": {
+        "type": "string"
+      },
+      "required": [
+        "FSharp.simplifyNameAnalyzer"
+      ],
+      "type": "array"
+    },
     "FSharp.smartIndent": {
       "default": false,
       "description": "Enables smart indent feature",
@@ -394,11 +436,39 @@
       "description": "Enables detection of unused declarations",
       "type": "boolean"
     },
+    "FSharp.unusedDeclarationsAnalyzerExclusions": {
+      "default": [
+        ".*\\.g\\.fs",
+        ".*\\.cg\\.fs"
+      ],
+      "description": "A set of regex patterns to exclude from the unused declarations analyzer",
+      "items": {
+        "type": "string"
+      },
+      "required": [
+        "FSharp.unusedDeclarationsAnalyzer"
+      ],
+      "type": "array"
+    },
     "FSharp.unusedOpensAnalyzer": {
       "default": true,
       "description": "Enables detection of unused opens",
       "type": "boolean"
     },
+    "FSharp.unusedOpensAnalyzerExclusions": {
+      "default": [
+        ".*\\.g\\.fs",
+        ".*\\.cg\\.fs"
+      ],
+      "description": "A set of regex patterns to exclude from the unused opens analyzer",
+      "items": {
+        "type": "string"
+      },
+      "required": [
+        "FSharp.unusedOpensAnalyzer"
+      ],
+      "type": "array"
+    },
     "FSharp.verboseLogging": {
       "default": false,
       "description": "Logs additional information to F# output channel. This is equivalent to passing the `--verbose` flag to FSAC. Requires restart.",
@@ -413,6 +483,14 @@
       "description": "Path to the directory or solution file that should be loaded as a workspace. If set, no workspace probing or discovery is done by Ionide at all.",
       "scope": "window",
       "type": "string"
+    },
+    "Fsharp.fsac.gc.noAffinitize": {
+      "default": true,
+      "markdownDescription": "Specifies whether to [affinitize](https://learn.microsoft.com/en-us/dotnet/core/runtime-config/garbage-collector#affinitize) garbage collection threads with processors. To affinitize a GC thread means that it can only run on its specific CPU.. Applies to server garbage collection only. See [GCNoAffinitize](https://learn.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/runtime/gcnoaffinitize-element#remarks) for more details. [Only available on .NET 7 or higher](https://github.com/ionide/ionide-vscode-fsharp/issues/1899#issuecomment-1649009462). Requires restart.",
+      "required": [
+        "FSharp.fsac.gc.server"
+      ],
+      "type": "boolean"
     }
   }
 }

schemas/hie.json

@@ -78,6 +78,12 @@
       "scope": "resource",
       "type": "boolean"
     },
+    "haskell.plugin.cabal.completionOn": {
+      "default": true,
+      "description": "Enables cabal completions",
+      "scope": "resource",
+      "type": "boolean"
+    },
     "haskell.plugin.cabal.globalOn": {
       "default": true,
       "description": "Enables cabal plugin",

schemas/jdtls.json

@@ -388,12 +388,34 @@
       "scope": "window",
       "type": "boolean"
     },
+    "java.edit.smartSemicolonDetection.enabled": {
+      "default": false,
+      "markdownDescription": "Defines the `smart semicolon` detection. Defaults to `false`.",
+      "scope": "window",
+      "type": "boolean"
+    },
     "java.edit.validateAllOpenBuffersOnChanges": {
       "default": false,
       "markdownDescription": "Specifies whether to recheck all open Java files for diagnostics when editing a Java file.",
       "scope": "window",
       "type": "boolean"
     },
+    "java.editor.reloadChangedSources": {
+      "default": "ask",
+      "enum": [
+        "ask",
+        "auto",
+        "manual"
+      ],
+      "enumDescriptions": [
+        "Ask to reload the sources of the open class files",
+        "Automatically reload the sources of the open class files",
+        "Manually reload the sources of the open class files"
+      ],
+      "markdownDescription": "Specifies whether to reload the sources of the open class files when their source jar files are changed.",
+      "scope": "window",
+      "type": "string"
+    },
     "java.errors.incompleteClasspath.severity": {
       "default": "warning",
       "description": "Specifies the severity of the message when the classpath is incomplete for a Java file",
@@ -666,12 +688,6 @@
       "scope": "window",
       "type": "integer"
     },
-    "java.progressReports.enabled": {
-      "default": true,
-      "description": "[Experimental] Enable/disable progress reports from background processes on the server.",
-      "scope": "window",
-      "type": "boolean"
-    },
     "java.project.encoding": {
       "default": "ignore",
       "enum": [

schemas/jsonls.json

@@ -45,10 +45,10 @@
         },
         "properties": {
           "fileMatch": {
-            "description": "An array of file patterns to match against when resolving JSON files to schemas. `*` can be used as a wildcard. Exclusion patterns can also be defined and start with '!'. A file matches when there is at least one matching pattern and the last matching pattern is not an exclusion pattern.",
+            "description": "An array of file patterns to match against when resolving JSON files to schemas. `*` and '**' can be used as a wildcard. Exclusion patterns can also be defined and start with '!'. A file matches when there is at least one matching pattern and the last matching pattern is not an exclusion pattern.",
             "items": {
               "default": "MyFile.json",
-              "description": "A file pattern that can contain '*' to match against when resolving JSON files to schemas.",
+              "description": "A file pattern that can contain '*' and '**' to match against when resolving JSON files to schemas. When beginning with '!', it defines an exclusion pattern.",
               "type": "string"
             },
             "minItems": 1,
@@ -60,7 +60,7 @@
           },
           "url": {
             "default": "/user.schema.json",
-            "description": "A URL to a schema or a relative path to a schema in the current directory",
+            "description": "A URL or absolute file path to a schema. Can be a relative path in workspace and workspace folder settings.",
             "type": "string"
           }
         },
@@ -69,6 +69,12 @@
       "scope": "resource",
       "type": "array"
     },
+    "json.sortOnSave.enable": {
+      "default": false,
+      "description": "Enable/disable default sorting on save",
+      "scope": "window",
+      "type": "boolean"
+    },
     "json.trace.server": {
       "default": "off",
       "description": "Traces the communication between VS Code and the JSON language server.",