Vim: support coc.nvim

Author: strager

docs/CHANGELOG.md

@@ -31,6 +31,7 @@ Beta release.
 * The macOS and Windows executables now include embedded code signatures. These
   signatures are made with a self-signed certificate.
 * The Linux executables are now signed with a GPG signature (`.asc` files).
+* Vim: [coc.nvim][] is now supported.
 
 ### Fixed
 
@@ -202,6 +203,7 @@ Beta release.
 [Lee Wannacott]: https://github.com/LeeWannacott
 [Matheus Sousa]: https://github.com/keyehzy
 [Shivam Mehta]: https://github.com/maniac-en
+[coc.nvim]: https://github.com/neoclide/coc.nvim
 [config-global-groups]: https://quick-lint-js.com/config/#global-groups
 [tiagovla]: https://github.com/tiagovla
 [wagner riffel]: https://github.com/wgrr

plugin/vim/quick-lint-js.vim/doc/quick-lint-js.txt

@@ -14,7 +14,8 @@ newer version might or might not work.
 2. Installing the plugin	|quick-lint-js-vim-install|
 3. Configuring			|quick-lint-js-configure|
    3.1. ALE			|quick-lint-js-configure-ale|
-   3.2. nvim-lspconfig		|quick-lint-js-configure-nvim-lspconfig|
+   3.2. coc.nvim		|quick-lint-js-configure-coc-nvim|
+   3.3. nvim-lspconfig		|quick-lint-js-configure-nvim-lspconfig|
 
 ==============================================================================
 1. Installing quick-lint-js		*quick-lint-js-app-install*
@@ -112,7 +113,41 @@ could run arbitrary code on your computer through `node_modules` if you open a
 JavaScript file.
 
 ==============================================================================
-3.2. Configuring for nvim-lspconfig	*quick-lint-js-configure-nvim-lspconfig*
+3.2. Configuring for coc.nvim		*quick-lint-js-configure-coc-nvim*
+
+The quick-lint-js Vim plugin comes with a plugin for coc.nvim (Conquer of
+Completion). https://github.com/neoclide/coc.nvim
+
+Supported coc.nvim versions: v0.0.80 or newer
+
+quick-lint-js is fast. To feel the speed, you should configure
+`diagnostic.messageDelay` and `diagnostic.refreshOnInsertMode`. Add the
+following code to your |coc-configuration| (run `:CocConfig`) to make
+JavaScript linting as fast as possible:
+
+  "diagnostic.messageDelay": 0,
+  "diagnostic.refreshOnInsertMode": true,
+
+Unfortunately, there is an unconfigurable 400 millisecond delay hard-coded
+into coc.nvim:
+https://github.com/neoclide/coc.nvim/blob/9f6e29b6f9661ebba10ff3df84de11d96c8a9e56/src/model/document.ts#L75,L78
+If you want linting to feel faster, try ALE or nvim-lspconfig instead of
+coc.nvim.
+
+You can customize this plugin's configuration by copy-pasting the following
+snippet into your |coc-configuration| then tweaking it according to
+|coc-config-languageserver|:
+
+    "languageserver": {
+      "quick-lint-js": {
+        "args": ["--lsp-server"],
+        "command": "quick-lint-js",
+        "filetypes": ["javascript", "json"]
+      }
+    }
+
+==============================================================================
+3.3. Configuring for nvim-lspconfig	*quick-lint-js-configure-nvim-lspconfig*
 
 The quick-lint-js Vim plugin comes with a plugin for nvim-lspconfig.
 https://github.com/neovim/nvim-lspconfig

plugin/vim/quick-lint-js.vim/plugin/quick-lint-js.vim

@@ -0,0 +1,34 @@
+" Copyright (C) 2020  Matthew "strager" Glazar
+" See end of file for extended copyright information.
+
+" Register quick-lint-js with coc.nvim (Conquer of Completion).
+" https://github.com/neoclide/coc.nvim
+try
+  call coc#config('languageserver', {
+    \ 'quick-lint-js': {
+      \ 'args': ['--lsp-server'],
+      \ 'command': 'quick-lint-js',
+      \ 'filetypes': ['javascript', 'json'],
+    \ }
+  \ })
+catch /E117/
+  " coc#config does not exist; coc.nvim is not installed. Ignore.
+endtry
+
+" quick-lint-js finds bugs in JavaScript programs.
+" Copyright (C) 2020  Matthew "strager" Glazar
+"
+" This file is part of quick-lint-js.
+"
+" quick-lint-js is free software: you can redistribute it and/or modify
+" it under the terms of the GNU General Public License as published by
+" the Free Software Foundation, either version 3 of the License, or
+" (at your option) any later version.
+"
+" quick-lint-js is distributed in the hope that it will be useful,
+" but WITHOUT ANY WARRANTY; without even the implied warranty of
+" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+" GNU General Public License for more details.
+"
+" You should have received a copy of the GNU General Public License
+" along with quick-lint-js.  If not, see <https://www.gnu.org/licenses/>.

website/public/install/neovim/common-prerequisites.ejs.html

@@ -11,6 +11,12 @@
     >
     v2.1.1 or newer, or version v3.0.0 or newer
   </li>
+  <li>
+    <a href="https://github.com/neoclide/coc.nvim"
+      >coc.nvim - Conquer of Completion</a
+    >
+    v0.0.80 or newer
+  </li>
   <li>
     <a href="https://github.com/neovim/nvim-lspconfig">nvim-lspconfig</a>
     (requires Neovim 0.5.0 or newer)

website/public/install/vim/common-prerequisites.ejs.html

@@ -11,6 +11,12 @@
     >
     v2.1.1 or newer, or version v3.0.0 or newer
   </li>
+  <li>
+    <a href="https://github.com/neoclide/coc.nvim"
+      >coc.nvim - Conquer of Completion</a
+    >
+    v0.0.80 or newer
+  </li>
 </ul>
 
 <%#