draft-v3-release.md

[ANN] vim-rescript v3.0.0 release

Hi everyone!!!

We've just released the newest plugin for Vim. This release has some important changes.

We only provide the Vim runtime files that provide the following features:

1. Indentation
2. Syntax Highlight
3. Filetype detection
4. Commenting support (Neovim v10 (only) has a built-in commenting)

Breaking Changes

• We removed the vendored server and native Vim commands (e.g :RescriptBuild, etc)

Improvements

• Better syntax highlighting

The rescript-language-server server is a dedicated package published on NPM. Users must do installation and setup to get all the features.

If you are using mason.nvim you can install the ReScript Language Server using the command MasonInstall rescript-language-server. Also you can install LSP pre-release using MasonInstall rescript-language-server@next --force

When installing LSP via mason.nvim the binary will be available inside Neovim only

Or install globally:

npm install -g @rescript/language-server

Neovim LSP builtin users

Install nvim-lspconfig package.

local lspconfig = require('lspconfig')

lspconfig.rescriptls.setup{}

How enable incrementalTypechecking?

lspconfig.rescriptls.setup{
  init_options = {
    extensionConfiguration = {
      incrementalTypechecking = {
        enabled = true
      },
    },
  },
}

For more details, see server configuration

vim-coc users

Coc users can use LSP using --stdio or --node-ipc channel.

"languageserver": {
  "rescript": {
    "enable": true,
    "module": "rescript-language-server",
    "args": ["--node-ipc"],
    "filetypes": ["rescript"],
    "rootPatterns": ["rescript.json", "bsconfig.json"]
  }
}

ReScript grammar Tree-sitter

The Tree-sitter parser is now part of the rescript-lang organization, https://github.com/rescript-lang/tree-sitter-rescript.

It's been a while since Victor moved the repository. We still have to add support for the syntax changes introduced in v11. The parser has also been added to nvim-treesitter, PR.

The parser provides some important features in addition to highlight, indentation, language injection, folds and locals (used to extract keyword definitions, scopes, references, etc.).

You can install the parser with TSInstall rescript, more details here

The nvim-treesitter-rescript plugin is no longer needed and will be archived.