--- /dev/null
+# coc-tsserver
+
+Tsserver language server extension for [coc.nvim](https://github.com/neoclide/coc.nvim).
+
+Most of the code is from `typescript-language-features` extension which is bundled with VSCode.
+
+**Note:** for React to work as expected, you need your JSX filetype to be
+`javascript.jsx` and your TSX filetype to be `typescript.jsx` or
+`typescript.tsx`. In coc.nvim, these filetypes are mapped to `javascriptreact`
+and `typescriptreact` because that's what tsserver uses.
+
+**Note** for javascript project, make sure you have [jsconfig.json](https://code.visualstudio.com/docs/languages/jsconfig)
+
+## Install
+
+In your vim/neovim, run command:
+
+```
+:CocInstall coc-tsserver
+```
+
+For yarn2 user what to use local typescript module:
+
+- Add PnPify to your dependencies:
+
+ ```
+ yarn add @yarnpkg/pnpify
+ ```
+
+- Run the following command, which will generate a new directory called .vscode/pnpify
+
+ ```
+ yarn pnpify --sdk
+ ```
+
+### intructions for nvm users
+
+Disable [nvm](https://github.com/creationix/nvm) with the following command:
+
+```
+nvm deactivate
+```
+
+Next, find out what the global path of your installed version of npm with the following command:
+
+```
+which npm
+```
+
+The output of the above command should go into the `tsserver.npm` property in your `coc-settings.json` file, a partial example listed below:
+
+```
+"tsserver.npm": "/usr/local/bin/npm"
+```
+
+## Features
+
+Almost the same as VSCode.
+
+- Supports javascript & typescript and jsx/tsx.
+- Installs typings automatically.
+- Commands to work with tsserver, including:
+ - `tsserver.reloadProjects`
+ - `tsserver.openTsServerLog`
+ - `tsserver.goToProjectConfig`
+ - `tsserver.restart`
+ - `tsserver.format`
+ - `tsserver.organizeImports`
+ - `tsserver.watchBuild`
+- Code completion support.
+- Go to definition.
+- Code validation.
+- Document highlight.
+- Document symbols of current buffer.
+- Folding and folding range of current buffer.
+- Format current buffer, range format and format on type.
+- Hover for documentation.
+- Implementations codeLens and references codeLens.
+- Organize imports command.
+- Quickfix using code actions.
+- Code refactor using code actions.
+- Find references.
+- Signature help.
+- Rename symbols support.
+- Rename imports on file rename, require [watchman](https://facebook.github.io/watchman/) installed in your \$PATH.
+- Search for workspace symbols.
+
+Tsserver module first resolved from your local workspace. If it's not found,
+use tsserver from `tsserver.tsdk` configuration or use bundled tsserver with
+this extension.
+
+## Configuration options
+
+Checkout [using the configuration file](https://github.com/neoclide/coc.nvim/wiki/Using-the-configuration-file) for guide of coc.nvim's configuration.
+
+- `tsserver.enable`:Enable tsserver extension, default: `true`
+- `tsserver.locale`:Locale of tsserver, default: `""`
+- `tsserver.typingsCacheLocation`:Folder path for cache typings, default: `""`
+- `tsserver.formatOnType`:Run format on type special characters., default: `true`
+- `tsserver.enableJavascript`:Use tsserver for javascript files, default: `true`
+- `tsserver.maxTsServerMemory`:Set the maximum amount of memory to allocate to the TypeScript server process
+- `tsserver.tsdk`:Directory contains tsserver.js,, default: `""`
+- `tsserver.npm`:Executable path of npm for download typings, default: `""`
+- `tsserver.log`:Log level of tsserver, default: `"off"`
+- `tsserver.trace.server`:Trace level of tsserver, default: `"off"`
+- `tsserver.pluginRoot`:Folder contains tsserver plugins, default: `[]`
+- `tsserver.debugPort`:Debug port number of tsserver
+- `tsserver.watchOptions`:Configure which watching strategies should be used to keep track of files and directories. Requires using TypeScript 3.8+ in the workspace, default: undefined.
+- `tsserver.reportStyleChecksAsWarnings` default: `true`
+- `tsserver.implicitProjectConfig.checkJs`:Enable checkJs for implicit project, default: `false`
+- `tsserver.implicitProjectConfig.experimentalDecorators`:Enable experimentalDecorators for implicit project, default: `false`
+- `tsserver.disableAutomaticTypeAcquisition`:Disable download of typings, default: `false`
+- `tsserver.useBatchedBufferSync`: use batched buffer synchronize support.
+- `typescript.updateImportsOnFileMove.enable`:Enable update imports on file move., default: `true`
+- `typescript.implementationsCodeLens.enable`:Enable codeLens for implementations, default: `true`
+- `typescript.referencesCodeLens.enable`:Enable codeLens for references, default: `true`
+- `typescript.preferences.importModuleSpecifier` default: `"auto"`
+- `typescript.preferences.importModuleSpecifierEnding` default: `true`
+- `typescript.preferences.quoteStyle` default: `"single"`
+- `typescript.suggestionActions.enabled`:Enable/disable suggestion diagnostics for TypeScript files in the editor. Requires using TypeScript 2.8 or newer in the workspace., default: `true`
+- `typescript.validate.enable`:Enable/disable TypeScript validation., default: `true`
+- `typescript.showUnused`: show unused variable hint, default: `true`.
+- `typescript.suggest.enabled` default: `true`
+- `typescript.suggest.paths`:Enable/disable suggest paths in import statement and require calls, default: `true`
+- `typescript.suggest.autoImports`:Enable/disable auto import suggests., default: `true`
+- `typescript.suggest.completeFunctionCalls`:Enable snippet for method suggestion, default: `true`
+- `typescript.format.enabled`:Enable/disable format of typescript files.
+- `typescript.format.insertSpaceAfterCommaDelimiter` default: `true`
+- `typescript.format.insertSpaceAfterConstructor` default: `false`
+- `typescript.format.insertSpaceAfterSemicolonInForStatements` default: `true`
+- `typescript.format.insertSpaceBeforeAndAfterBinaryOperators` default: `true`
+- `typescript.format.insertSpaceAfterKeywordsInControlFlowStatements` default: `true`
+- `typescript.format.insertSpaceAfterFunctionKeywordForAnonymousFunctions` default: `true`
+- `typescript.format.insertSpaceBeforeFunctionParenthesis` default: `false`
+- `typescript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets` default: `false`
+- `typescript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyBraces` default: `false`
+- `typescript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis` default: `false`
+- `typescript.format.insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces` default: `false`
+- `typescript.format.insertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces` default: `false`
+- `typescript.format.insertSpaceAfterTypeAssertion` default: `false`
+- `typescript.format.placeOpenBraceOnNewLineForFunctions` default: `false`
+- `typescript.format.placeOpenBraceOnNewLineForControlBlocks` default: `false`
+- `typescript.suggest.includeAutomaticOptionalChainCompletions`: default: `true`
+- `javascript.format.enabled`: Enable/disable format for javascript files.
+- `javascript.showUnused`: show unused variable hint.
+- `javascript.updateImportsOnFileMove.enable` default: `true`
+- `javascript.implementationsCodeLens.enable` default: `true`
+- `javascript.referencesCodeLens.enable` default: `true`
+- `javascript.preferences.importModuleSpecifier` default: `"auto"`
+- `javascript.preferences.importModuleSpecifierEnding` default: `true`
+- `javascript.preferences.quoteStyle` default: `"single"`
+- `javascript.validate.enable`: Enable/disable JavaScript validation., default: `true`
+- `javascript.suggestionActions.enabled`: Enable/disable suggestion diagnostics for JavaScript files in the editor. Requires using TypeScript 2.8 or newer in the workspace., default: `true`
+- `javascript.suggest.names`: default `true`
+- `javascript.suggest.enabled`: default `true`
+- `javascript.suggest.paths`: Enable/disable suggest paths in import statement and require calls, default: `true`
+- `javascript.suggest.autoImports`: Enable/disable auto import suggests., default: `true`
+- `javascript.suggest.completeFunctionCalls`:Enable snippet for method suggestion, default: `true`
+- `javascript.format.insertSpaceAfterCommaDelimiter` default: `true`
+- `javascript.format.insertSpaceAfterConstructor` default: `false`
+- `javascript.format.insertSpaceAfterSemicolonInForStatements` default: `true`
+- `javascript.format.insertSpaceBeforeAndAfterBinaryOperators` default: `true`
+- `javascript.format.insertSpaceAfterKeywordsInControlFlowStatements` default: `true`
+- `javascript.format.insertSpaceAfterFunctionKeywordForAnonymousFunctions` default: `true`
+- `javascript.format.insertSpaceBeforeFunctionParenthesis` default: `false`
+- `javascript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyBrackets` default: `false`
+- `javascript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyBraces` default: `false`
+- `javascript.format.insertSpaceAfterOpeningAndBeforeClosingNonemptyParenthesis` default: `false`
+- `javascript.format.insertSpaceAfterOpeningAndBeforeClosingTemplateStringBraces` default: `false`
+- `javascript.format.insertSpaceAfterOpeningAndBeforeClosingJsxExpressionBraces` default: `false`
+- `javascript.format.insertSpaceAfterTypeAssertion` default: `false`
+- `javascript.format.placeOpenBraceOnNewLineForFunctions` default: `false`
+- `javascript.format.placeOpenBraceOnNewLineForControlBlocks` default: `false`
+- `javascript.suggest.includeAutomaticOptionalChainCompletions`: default: `true`
+
+Configurations are the same as with VSCode. Try completion with `tsserver`, `typescript`
+or `javascript` in your `coc-settings.json`.
+
+## Related extensions
+
+- [coc-eslint](https://github.com/neoclide/coc-eslint): enable [eslint](https://github.com/eslint/eslint) plugin for tsserver to lint TypeScript and JavaScript files.
+- [coc-tslint-plugin](https://github.com/neoclide/coc-tslint-plugin): enable [tslint](https://github.com/palantir/tslint)
+ plugin for tsserver ([deprecated](https://github.com/palantir/tslint/issues/4534)).
+- [coc-vetur](https://github.com/neoclide/coc-vetur): [vue](https://github.com/vuejs/vue) extension.
+- [coc-angular](https://github.com/iamcco/coc-angular): [angular](https://github.com/angular/angular) extension.
+
+## Troubleshooting
+
+- Add `"tsserver.log": "verbose"` to your `coc-settings.json` (opened by command
+ `:CocConfig`)
+- To trace LSP communication, add `"tsserver.trace.server": "verbose"` to your
+ `coc-settings.json`
+- Restart coc server by command `:CocRestart`
+- Make the issue happen.
+- Open tsserver log file by command `CocCommand tsserver.openTsServerLog`
+- Open tsserver output channel by command `CocCommand workspace.showOutput tsserver`
+
+If you find any issues, please [create an issue](https://github.com/neoclide/coc-tsserver/issues/new).
+
+## License
+
+MIT
projects / dotfiles / .git / blobdiff