tsc-multi

tsc-multi

Compile multiple TypeScript projects into multiple targets.

Features

Multiple targets

tsc-multi can compile your TypeScript projects into multiple modules (e.g. CommonJS, ESM) or targets (e.g. ES6, ES2018) in parallel.

Project references

tsc-multi supports project references, which are very useful for monorepo. It works just like tsc --build. File watching is also supported.

Rewrite import paths

tsc-multi rewrites all import paths in output files to maximize the compatibility across different platforms such as Node.js, web browser and Deno, because import paths are more strict in ESM.

Example:

// Input
import dir from "./dir";
import file from "./file";

// Output
import dir from "./dir/index.js";
import file from "./file.js";

Installation

npm install tsc-multi --save-dev

Usage

Create a tsc-multi.json in the folder.

{
  "targets": [
    { "extname": ".cjs", "module": "commonjs" },
    { "extname": ".mjs", "module": "esnext" }
  ],
  "projects": ["packages/*/tsconfig.json"]
}

Build TypeScript files.

tsc-multi

Watch changes and rebuild TypeScript files.

tsc-multi --watch

Delete built files.

tsc-multi --clean

Configuration

targets

Build targets. All options except extname will override compilerOptions in tsconfig.json.

{
  // Rename the extension of output files
  extname: ".js",
  // Compiler options
  module: "esnext",
  target: "es2018",
}

projects

Path to TypeScript projects. It can be either a folder which contains tsconfig.json, or the path to tsconfig.json. This option can be set in either config file or CLI.

[
  // CWD
  ".",
  // Folder
  "pkg-a",
  // tsconfig.json path
  "tsconfig.custom.json",
  // Glob
  "packages/*/tsconfig.json",
];

compiler

Specify a custom TypeScript compiler (e.g. ttypescript).

CLI Options

--watch

Watch input files and rebuild when they are changed.

--clean

Delete built files. Only available when compilerOptions.rootDir is specified in tsconfig.json.

--verbose

Print debug logs.

--cwd

Specify the current working directory (CWD).

--config

Specify the path of the config file. The path can be either a relative path or an absolute path. Default to $CWD/tsc-multi.json.

--compiler

Specify a custom TypeScript compiler.

License

MIT