tsc-hooks v1.1.2

TypeScript Compiler Hooks

Installation

For Project Specific tsc:

yarn add tsc-hooks --dev

For Global tsc:

yarn global add tsc-hooks

Getting Started

Example tsconfig.json

{
  "compilerOptions": {
    "outDir": "dist"
  },
  "include": [ "src/**/*" ],
  "exclude": [ "src/**/*.txt" ],
  "hooks": [ "copy-files" ] // hooks is a new property you can add to tsconfig to add custom hooks
  
  /* For more hooks look below... */
}

Hooks are executed in the same order as defined in tsconfig.jsons hook property.

Available Hooks

Examples

file-permissions

1. tsc compiles index.ts to ./dist/index.js
2. The copy-files-hook will copy the src/helperProgram.bin to ./dist/helperProgram.bin
3. The file-permissions-hook will set the permissions r-xr--r-- to ./dist/{helperProgram.bin, index.js} (assuming ./src/index.ts has a shebang like #!/usr/bin/env node, one can now execute ./dist/index.js)

Expample-tsconfig.json:

{
  "compilerOptions": {
    "outDir": "dist"
  },
  "include": [ "src/index.ts", "src/helperProgram.bin" ],
  "exclude": [ "src/**/*.txt" ],
  "hooks": [ "copy-files", "file-permissions" ] 
  "filePermissions": {
    "./dist/helperProgram.bin": "0544",
    "./dist/index.js": "0544"
  }
}

What Can TSC Hooks Do?

• TypeScript Compiler hooks are scripts that can execute on compilation of your TypeScript project using tsc
• They can provide new tsconfig options to help your project run smoother
• They can add new functionality to the compilation process