docs / Tooling

Language Server

@vesk/lsp provides LSP support for .vsk files: diagnostics, autocomplete, go to definition, hover and find references.

`@vesk/lsp` provides Language Server Protocol support for `.vsk` files, enabling editor features like autocomplete, diagnostics, and go-to-definition.

Features

  • Syntax highlighting — .vsk files are recognized as a TypeScript superset with JSX/TSX grammar.
  • Diagnostics — compiler errors reported inline in the editor.
  • Autocomplete — component names, auto-imported runtime APIs (track, effect, derived), props on known components, CSS class names with the Tailwind plugin.
  • Go to definition, hover type info, and find references.

How it works

  • The LSP wraps the compiler's vskToTsx transform to convert .vsk files to standard TypeScript for the editor.
  • Diagnostics come from the same pipeline that `vesk typecheck` uses.
  • Auto-import suggestions come from the VESK_BUILTINS list in the compiler.
  • Setup: add `"*.vsk": "typescriptreact"` to VS Code file associations; any LSP editor can connect over stdio.