tsc-alias

Replace alias paths with relative paths after typescript compilation. You can add aliases that reference other projects outside your tsconfig.json project by providing a relative path to the baseUrl.

Comparison to tsconfig-paths

+ Compile time (no runtime dependencies)

Getting Started

First, install tsc-alias as devDependency using npm.

1npm install -g tsc-alias

npm install --save-dev tsc-alias

Add it to your build scripts in package.json

1"scripts": {
2  "build": "tsc --project tsconfig.json && tsc-alias -p tsconfig.json",
3}

or

1"scripts": {
2  "build": "tsc && tsc-alias",
3  "build:watch": "tsc && (concurrently \"tsc -w\" \"tsc-alias -w\")"
4}

Issues

If you have an issue, please create one. But, before:

• try to check the FAQ.
• try to check if there exits alike issues.
• try to run with --debug and check if config is correctly loaded and all sourcefiles are found.

API

Installation

1npm install tsc-alias

Usage

1import { replaceTscAliasPaths } from 'tsc-alias';
2
3replaceTscAliasPaths(options?);

Here are all the available options:

Option	Description	Default Value
project, p	path to tsconfig.json	'tsconfig.json'
watch	Observe file changes	false
outDir	Run in a folder leaving the "outDir" of the tsconfig.json (relative path to tsconfig)	tsconfig.compilerOptions.outDir
declarationDir	Works the same as outDir but for declarationDir	tsconfig.compilerOptions.declarationDir
resolveFullPaths	Attempt to replace incomplete import paths (those not ending in .js) with fully resolved paths (for ECMAScript Modules compatibility)	false
resolveFullExtension	Allows you to specify the extension of incomplete import paths, works with resolveFullPaths	'.js' | '.mjs' | '.cjs'
silent	Reduced terminal output. This is a deprecated option and no longer has any effect.	true
verbose	Additional information is output to the terminal	false
debug	Debug information is send to the terminal	false
replacers	Files to import as extra replacers More info	[]
output	The output object tsc-alias will send logs to.	new Output(options.verbose)
fileExtensions	Overwrite file extensions tsc-alias will use to scan and resolve files.	undefined

Configuration via tsconfig.json Example

1{
2  "compilerOptions": {
3    ...
4  },
5  "tsc-alias": {
6    "verbose": false,
7    "resolveFullPaths": true,
8    "replacers": {
9      "exampleReplacer": {
10        "enabled": true,
11        "file": "./exampleReplacer.js"
12      },
13      "otherReplacer": {
14        "enabled": true,
15        "file": "./otherReplacer.js"
16      }
17    },
18    "fileExtensions": {
19      "inputGlob": "{js,jsx,mjs}",
20      "outputCheck": ["js", "json", "jsx", "mjs"]
21    }
22  }
23}

Single file replacer

We can use tsc-alias in a single file, with a function that returns the modified contents.

We prepare the replacer with prepareSingleFileReplaceTscAliasPaths(), passing the same options that we would pass to replaceTscAliasPaths(). That will return a promise of a function that receives the file contents and path, and returns the transformed contents, synchronously.

1import { prepareSingleFileReplaceTscAliasPaths } from 'tsc-alias';
2
3const runFile: SingleFileReplacer = await prepareSingleFileReplaceTscAliasPaths(options?);
4
5function treatFile(filePath: string) {
6  const fileContents = fs.readFileSync(filePath, 'utf8');
7  const newContents = runFile({fileContents, filePath});
8  // do stuff with newContents
9}