This Neovim plugin provides an asynchronous interface to run project-wide TypeScript type-checking using the TypeScript compiler (tsc
). It displays the type-checking results in a quickfix list and provides visual notifications about the progress and completion of type-checking.
- Project-wide type checking
- Asynchronous execution of the TypeScript compiler to prevent lock ups and input lag
- Progress notifications with spinner animation
- Quickfix list for navigating errors
- Automatic opening of the quickfix list if there are errors
- User-friendly command
:TSC
tsc-errors.mov
tsc-no-errors.mov
Usage without nvim-notify
Screen.Recording.2023-04-23.at.9.50.43.AM.mov
To install the plugin, use your preferred Neovim plugin manager.
To install the plugin using packer.nvim, add the following to your plugin configuration:
use('dmmulroy/tsc.nvim')
To install the plugin using vim-plug, add the following to your plugin configuration:
Plug 'dmmulroy/tsc.nvim'
Then run :PlugInstall
to install the plugin.
For an enhanced UI/UX experience, it is recommended to install the nvim_notify plugin as well. This plugin is optional, and the plugin will work without it.
To set up the plugin, add the following line to your init.vim
or init.lua
file:
require('tsc').setup()
To run TypeScript type-checking, execute the :TSC
command in Neovim. The plugin will display a progress notification while the type-checking is in progress. When the type-checking is complete, it will show a notification with the results and open a quickfix list if there are any errors.
If watch
mode is enabled, tsc.nvim will automatically run in the background every time you save in a typescript or tsx file and report the results back to you. In addition, if auto_start_watch_mode
is enabled, the :TSC
command will be executed on your behalf when you enter a typescript or tsx files.
To stop any running :TSC
command, use the :TSCStop
command in Neovim.
By default, the plugin uses the default tsc
command with the --noEmit
flag to avoid generating output files during type-checking. It also emulates the default tsc behavior of performing a backward search from the current directory for a tsconfig
file. The flags option can accept both a string and a table. Here's the default configuration:
{
auto_open_qflist = true,
auto_close_qflist = false,
auto_focus_qflist = false,
auto_start_watch_mode = false,
use_trouble_qflist = false,
run_as_monorepo = false,
bin_path = utils.find_tsc_bin(),
enable_progress_notifications = true,
flags = {
noEmit = true,
project = function()
return utils.find_nearest_tsconfig()
end,
watch = false,
},
hide_progress_notifications_from_history = true,
spinner = { "⣾", "⣽", "⣻", "⢿", "⡿", "⣟", "⣯", "⣷" },
pretty_errors = true,
}
With this configuration, you can use keys for flag names and their corresponding values to enable/disable the flag (in the case of noEmit = true
), provide a function (as in the case of the project
) or enable watch mode. This makes the configuration more explicit and easier to read. Additionally, the flags option is backwards compatible and can accept a string value if you prefer a simpler configuration:
flags = "--noEmit",
There are two user commands you can use to open and close the quickfix list:
TSCOpen
- open the quickfix list
TSCClose
- close the quickfix list
These commands will respect your configuration options:
auto_open_qflist
auto_close_qflist
use_trouble_qflist
vim.keymap.set('n', '<leader>to', ':TSCOpen<CR>')
vim.keymap.set('n', '<leader>tc', ':TSCClose<CR>')
It's likely that the overwritten default vim.notify
function isn't returning nvim-notify
's notification record, which is used to replace the existing notification. Make sure that you're nvim-notify configuration looks something like this:
local notify = require('notify')
vim.notify = function(message, level, opts)
return notify(message, level, opts) -- <-- Important to return the value from `nvim-notify`
end
By default, tsc.nvim will check only the nearest tsconfig
file. If you would like it to use all tsconfig
files in the current working directory, set run_as_monorepo = true
. All other options will work as usual such as auto_start_watch_mode
, flags.watch
, etc.
require('tsc').setup({
run_as_monorepo = true,
})
With this configuration, tsc.nvim will typecheck all projects in the monorepo, taking into account project references and incremental builds.
Yes, as long as you have the plugin installed you can set use_trouble_qflist = true
in the configuration.
require('tsc').setup({
use_trouble_qflist = true,
})
This will use Trouble for the quickfix list. This will work with all other options such as auto_open_qflist
, auto_close_qflist
, auto_focus_qflist
.
Feel free to open issues or submit pull requests if you encounter any bugs or have suggestions for improvements. Your contributions are welcome!
This plugin is released under the MIT License. See the LICENSE file for details.