LSP Configuration documentation

[samael042]

How can the language server be configured to support multi-package setups? Specifically:

1. We want to define source and test directories explicitly (e.g., src/, tst/).
2. In some cases, other packages are not directory-based but are provided as JARs.
3. The LSP should resolve imports, diagnostics, symbol navigation, and other features correctly across these inputs.

Is there a way to declaratively configure these settings, or is support for this kind of layout planned? I'm looking for documentation around how this configuration can be fed to the LSP.

[darthorimar]

Hi @samael042! We have an experimental and not stable JSON format for describing project structure via workspace.json file in the root of your project. You can check out examples in the https://github.com/Kotlin/kotlin-lsp/tree/main/workspace-import/test/testData/gradle. The format is descibed as data classes in https://github.com/Kotlin/kotlin-lsp/blob/main/workspace-import/src/com/jetbrains/ls/imports/json/model.kt.

Keep in mind that this format is not stable yet and may (and probably will) change in the future.

[samael042]

Thanks, is it possible for you to leave a message once the configuration file is documented and is considered stable?

[darthorimar]

Sure!
also, cc @strangepleasures

[samael042]

Edit: ignore.

[nayeemzen]

@darthorimar - in the workspace.json examples it seems like the dependencies have to be explicitly referenced. Does this mean every time we add a new dependency, we need to manually update the workspace.json file?