Typst LSP
A language server for Typst.
Features
- Syntax highlighting, error reporting, code completion, and function signature help
- Compiles to PDF on save (configurable to as-you-type, or can be disabled)
This repo consists of:
- an LSP server, written in Rust
- a corresponding VS Code(ium) extension. The extension is available on the VS Code Marketplace and OpenVSX.
Near future goals
- Improved preview (e.g. built-in PDF viewer, render to image for speed)
- Support for more editors
Development guide
Prerequisites
Install:
- Rust for the LSP itself
- Rust Analyzer an extension for Rust LSP for VS Code
- node for the VS Code extension; it may be easiest to install via fnm
First time setup
- Clone this repository locally
- Open it in VS Code; it's needed to run the extension
- In the
addons/vscode
subdirectory:- Run
npm install
to install extension dependencies - Run
npm run compile
to build the extension
- Run
- Run through the development cycle once to initialize and test everything
- (Optional: install the dev version of the extension): Press Ctrl+Shift+P,
and choose
Developer: Install Extension from Location...
and choose the directory for the extension,addons/vscode/
. There will not be any messages, but the extension can be found in the Extensions@installed
list.
Development cycle
- Make any changes
- Run
cargo install --path .
; at present, the VS Code extension just invokes thetypst-lsp
command to start the LSP, and this command will compile and replace that binary with the latest version- If modifying the extension, keep
npm run watch
running, ornpm run compile
after changes
- If modifying the extension, keep
- Press Ctrl+F5 to launch the "Extension Development Host"; if it's already
running, invoke "Developer: Reload Window" from the command palette in the
Extension Development Host
- If prompted, choose "Run Extension"
- Within the Extension Development Host, the extension will be active and ready for testing
Tracing with Jaeger
Jaeger is a tool to visualize tracing data. It shows spans (e.g. a span corresponds to each time a file is opened, each time we calculate semantic tokens, etc.) and associated data (e.g. the URL of the file opened), which provides timing and debugging data.
By default, the LSP does not send data to Jaeger. To enable it:
- Launch the Jaeger server. The
opentelemetry_jaeger
crate recommends the following:$ docker run -d -p6831:6831/udp -p6832:6832/udp -p16686:16686 -p14268:14268 jaegertracing/all-in-one:latest
- Compile the LSP with the
jaeger
feature enabled. In the terminal, run:In VS Code, you can use the "Run Extension [Jaeger]" task to launch the extension with Jaeger support.$ cargo build --features jaeger
- Run the LSP, then eventually close it.
- From Jaeger, search for traces. It may be best to restrict the search to traces with a minimum length, such as 2 seconds, to hide smaller traces that come from the task sending data to Jaeger.
Installation guide
Visual Studio Code
- Install it from Marketplace.
Neovim
Basic setup
Prerequisites:
mason-lspconfig.nvim
,mason.nvim
andnvim-lspconfig
(Optional for advanced users, but required for this guide).
- Run
MasonInstall typst-lsp
. - Edit your
init.lua
settings (For more details, you may consult server_configurations.md#typst_lsp):
require'lspconfig'.typst_lsp.setup{
settings = {
exportPdf = "onType" -- Choose onType, onSave or never.
-- serverPath = "" -- Normally, there is no need to uncomment it.
}
}
- You may also install
typst.vim
for more capabilities in nvim.
coc.nvim
users
Addtional steps for Run CocConfig
to edit the settings so that coc.nvim
could offer functions such as auto-completion:
{
"languageserver": {
"typst": {
"command": "typst-lsp",
"filetypes": ["typst"]
}
}
}