---

Ⅰ. 插件描述

(repo no longer active) vim plugin for TypeScript support (uses typescript-tools)

Ⅱ. 基本信息

创建日期：  2013-08-26 使用用户：  65 Github星：  38 插件作者：  Claus Reinke

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'clausreinke/typescript-tools-vim'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'clausreinke/typescript-tools-vim'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'clausreinke/typescript-tools-vim'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/clausreinke/typescript-tools.vim

Ⅳ. 文档说明

(if you are upgrading from an older version, see CHANGES.txt)

typescript-tools.vim

Vim filetype plugin for TypeScript support, based on
https://github.com/clausreinke/typescript-tools.

Needs Vim 7.3 (with +python or +python3), nodejs/npm.

Installation/Configuration

Alternative 1. Install typescript-tools.vim via a plugin manager, eg. vim-plug

Plug 'clausreinke/typescript-tools.vim', { 'do': 'npm install' }

Alternative 2. Install typescript-tools.vim manually

$ npm install clausreinke/typescript-tools.vim

The installation includes a local tss command (try node_modules/typescript/bin/tss --version).

To use tss from Vim, add the typescript-tools.vim directory to your Vim's rtp (in your ~/.vimrc).

filetype plugin on
au BufRead,BufNewFile *.ts        setlocal filetype=typescript
set rtp+=<your_path_here>/typescript-tools.vim/

tss can be configured the same way as tsc, either via commandline options or
via tsconfig.json files (since about TSv1.5). In both cases, only options that
affect the language service have any effect.

To change how tss is invoked, you can use the g:TSS variable (defaults to
['node_modules/typescript-tools/bin/tss'], assuming a locally installed tss command,
as above). Ubuntu users may want to invoke tss via nodejs (different name for node)

let g:TSS = ['nodejs','<path-to-tss>']

or you may want to pass commandline options for all your projects (for
project-specific options, a tsconfig.json file may be the better choice)

let g:TSS = ['tss','--module','commonjs']

Usage tips

1. the plugin collaborates with a tss server running in the background (via python and nodejs)
2. the tss server will pick up source file dependencies (via import and references)
3. start the tss server while editing your main source file (or your main reference file), by issueing :TSSstarthere, or :TSSstart <main.ts> (the latter allows you to pass options, the former is just a shorthand)
4. now you can use the other commands (or :TSSend, to get rid of the background server), even while opening TS sources from the same project in different windows or tabs (but in the same Vim instance)

In practice, you'll use :TSSstarthere, :TSSend, :TSSreload, TSStype,
TSSdef*, as well as CTRL-X CTRL-O for insert mode completion. Also try the
project (file) navigation commands. Sometimes, calling :TSSshowErrors
directly can give enough error information for the current file --
eventually, you'll probably have to call :TSSreload to account for changes
in dependencies.

(TODO: vim plugin demo)

Vim plugin commands

" echo symbol/type of item under cursor
command! TSSsymbol
command! TSStype

" jump to or show definition of item under cursor
command! TSSdef
command! TSSdefpreview
command! TSSdefsplit
command! TSSdeftab

" create location list for references
command! TSSreferences

" update TSS with current file source
command! TSSupdate

" show TSS errors, with updated current file
command! TSSshowErrors

" for use as balloonexpr, symbol under mouse pointer
" set balloonexpr=TSSballoon()
" set ballooneval
function! TSSballoon()

" completions (omnifunc will be set for all *.ts files)
function! TSScompleteFunc(findstart,base)

" open project file, with filename completion
command! -complete=customlist,TSSfile -nargs=1 TSSfile

" show project file list in preview window
command! TSSfiles

" navigate to project file via popup menu
command! TSSfilesMenu

" create and open navigation menu for file navigation bar items
command! TSSnavigation

" navigate to items in project
" 1. narrow down symbols via completion, modulo case/prefix/infix/camelCase
" 2. offer remaining exact (modulo case) matches as a menu
command! -complete=customlist,TSSnavigateToItems -nargs=1 TSSnavigateTo

" reload project sources - will ask you to save modified buffers first
command! TSSreload

" start typescript service process (asynchronously, via python)
command! -nargs=* TSSstart
command! TSSstarthere

" pass a command to typescript service, get answer
command! -nargs=1 TSScmd call TSScmd(<f-args>,{})

" check typescript service
" (None: still running; <num>: exit status)
command! TSSstatus

" stop typescript service
command! TSSend

" sample keymap
" (highjacking some keys otherwise used for tags,
"  since we support jump to definition directly)
function! TSSkeymap()