# vue-tsc

Latest version **3.3.11** (published 2026-08-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install vue-tsc
pnpm add vue-tsc
yarn add vue-tsc
bun add vue-tsc
```

Provides the command `vue-tsc`.

## Health

**Score 65/100 (B)** — status: active.

Positive: has types; no vulnerabilities; has provenance; recently updated; high maintenance score.

Warnings: low downloads; no esm support.

## Facts

| | |
|---|---|
| Version | 3.3.11 |
| Published | 2026-08-21 |
| First published | 2021-03-02 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 2 |
| Unpacked size | 7 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| GitHub stars | 6718 |
| Maintainers | johnsoncodehk, kazariex |

## Links

- npm: https://www.npmjs.com/package/vue-tsc
- Repository: https://github.com/vuejs/language-tools
- Homepage: https://github.com/vuejs/language-tools#readme
- Issues: https://github.com/vuejs/language-tools/issues
- npm.io page: https://npm.io/package/vue-tsc

## Dependencies (2)

- [@volar/typescript](https://npm.io/package/@volar/typescript.md) 2.4.28
- [@vue/language-core](https://npm.io/package/@vue/language-core.md) 3.3.11

## Recent versions

- 3.3.11 (latest) — 2026-08-21
- 3.0.11 (v3.0) — 2026-06-08
- 3.3.10 — 2026-08-15
- 3.3.9 — 2026-07-31
- 3.3.8 — 2026-07-22
- 3.3.7 — 2026-07-08
- 3.3.6 — 2026-06-30
- 3.3.5 — 2026-06-13
- 3.3.4 — 2026-06-08
- 3.3.3 — 2026-05-30
- 3.3.2 — 2026-05-25
- 3.3.1 — 2026-05-19
- 3.3.0 — 2026-05-18
- 3.2.9 — 2026-05-13
- 3.2.8 — 2026-05-04
- … 361 more at https://npm.io/package/vue-tsc/versions

## README

# vue-tsc

<p>
  <a href="https://www.npmjs.com/package/vue-tsc"><img src="https://img.shields.io/npm/v/vue-tsc.svg?labelColor=18181B&color=1584FC" alt="NPM version"></a>
  <a href="https://github.com/vuejs/language-tools/blob/master/LICENSE"><img src="https://img.shields.io/github/license/vuejs/language-tools.svg?labelColor=18181B&color=1584FC" alt="License"></a>
</p>

A command-line type checking tool for Vue, based on a `tsc` wrapper, enabling the TypeScript compiler to understand `.vue` files.

## Installation

```bash
npm install vue-tsc typescript --save-dev
```

Requires TypeScript 5.0.0 or higher.

## Usage

### Type Checking

```bash
vue-tsc --noEmit
```

### Generate Declaration Files

```bash
vue-tsc --declaration --emitDeclarationOnly
```

### Configuration in package.json

```json
{
  "scripts": {
    "type-check": "vue-tsc --noEmit",
    "build:types": "vue-tsc --declaration --emitDeclarationOnly"
  }
}
```

## Supported File Types

`vue-tsc` automatically reads file types to process from `vueCompilerOptions.extensions` in `tsconfig.json`, defaulting to `['.vue']`.

If `vitePressExtensions` or `petiteVueExtensions` are configured, those extensions will also be processed.

## Differences from tsc

`vue-tsc` is a wrapper around `tsc` that:

1. Reads `vueCompilerOptions` from `tsconfig.json`
2. Creates a Vue language plugin to process `.vue` files
3. Transforms `.vue` files into TypeScript virtual code before passing them to `tsc`

All `tsc` command-line arguments can be used directly.

## Programmatic Usage

```typescript
import { run } from 'vue-tsc';

// Use the default tsc path
run();

// Specify a custom tsc path
run('/path/to/typescript/lib/tsc.js');
```

## Related Packages

- [`@vue/language-core`](../language-core) - Core module

## License

[MIT](https://github.com/vuejs/language-tools/blob/master/LICENSE) License

---
_Source: https://npm.io/package/vue-tsc · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._