@rank-lang/lsp

Language Server Protocol implementation for Rank.

Full documentation →

Status

This is a core workspace package used by the VS Code extension and the shared CLI/runtime toolchain.

Surface

• executable entrypoint: rank-lsp
• transport: stdio
• document sync: incremental
• editor features: diagnostics, hover, go-to-definition, and completion

Diagnostic suppression

For intentionally invalid fixtures, the LSP supports declaration-scoped suppression with doc comments:

/// rank-ignore NAM002 NAM005
value: Missing<string> = missing_value

This filters only the published LSP diagnostics for the annotated top-level declaration. The compiler still evaluates the file and still emits the underlying diagnostics for non-LSP tooling.

The server is implemented in src/server.ts and wires requests into compiler-backed feature handlers through ProjectSession.

Running locally

npm run build -w @rank-lang/lsp
node packages/lsp/dist/server.js

In practice this package is normally launched by rank-language-support rather than by hand.

Development

npm run build -w @rank-lang/lsp
npm run test -w @rank-lang/lsp
npm run typecheck -w @rank-lang/lsp