• Stars
    star
    596
  • Rank 75,069 (Top 2 %)
  • Language
    TypeScript
  • License
    MIT License
  • Created over 7 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Load modules according to tsconfig paths in webpack.

tsconfig-paths-webpack-plugin

npm version build Coverage Status code style: prettier MIT license

Use this to load modules whose location is specified in the paths section of tsconfig.json when using webpack. This package provides the functionality of the tsconfig-paths package but as a webpack plug-in.

Using this plugin means that you should no longer need to add alias entries in your webpack.config.js which correspond to the paths entries in your tsconfig.json. This plugin creates those alias entries for you, so you don't have to!

How to install

NOTE: If you are using webpack 4 you need to use version >= 3.0.0 (which is aso backwards compatible with webpack 3).

yarn add --dev tsconfig-paths-webpack-plugin

or

npm install --save-dev tsconfig-paths-webpack-plugin

How to use

In your webpack config add this:

const TsconfigPathsPlugin = require('tsconfig-paths-webpack-plugin');

module.exports = {
  ...
  resolve: {
    plugins: [new TsconfigPathsPlugin({/* options: see below */})]
  }
  ...
}

Notice that the plugin is placed in the resolve.plugins section of the configuration. tsconfig-paths-webpack-plugin is a resolve plugin and should only be placed in this part of the configuration. Don't confuse this with the plugins array at the root of the webpack configuration object.

If you're using allowJs in tsconfig.json, or allow other non-TS extensions in webpack, make sure you set extensions option in sync with your webpack config.

Options

configFile (string) (default='tsconfig.json')

Allows you to specify where to find the TypeScript configuration file.

You may provide

  • just a file name. The plugin will search for the filename using the built-in logic in the tsconfig-paths package. The search will start at cwd.
  • a relative path to the configuration file. It will be resolved relative to cwd.
  • an absolute path to the configuration file.

The use of cwd as default above is not optimal but we've found no better solution yet. If you have a suggestion please file an issue.

extensions (string[]) (default=[".ts", ".tsx"])

An array of the extensions that will be tried during resolve. Ideally this would be the same as the extensions from the webpack config but it seems resolver plug-ins does not have access to this information so you need to specify it again for the plugin.

baseUrl (string) (default=undefined)

This allows you to override the baseUrl found in tsconfig.json. The baseUrl specifies from which directory paths should be resolved. So this option enabled you to resolve from another directory than the one where tsconfig.json is located. This can be useful if you want to use webpack with tsc --watch instead of a typescript loader. If this option is undefined then the baseUrl from tsconfig.json will be used.

mainFields (string[]) (default=["main"])

An array of the field names that should be considered when resolving packages. Ideally this would be the same as the mainFields from the webpack config but it seems resolver plug-ins does not have access to this infomration so you need to specify it again for the plugin.

silent (boolean) (default=false)

If true, no console.log messages will be emitted. Note that most error messages are emitted via webpack which is not affected by this flag.

logLevel (string) (default=warn)

Can be info, warn or error which limits the log output to the specified log level. Beware of the fact that errors are written to stderr and everything else is written to stderr (or stdout if logInfoToStdOut is true).

colors (boolean) (default=true)

If false, disables built-in colors in logger messages.

logInfoToStdOut (boolean) (default=false)

This is important if you read from stdout or stderr and for proper error handling. The default value ensures that you can read from stdout e.g. via pipes or you use webpack -j to generate json output.

references _(string[]) (default=undefined)

Support for Typescript Project References.

Typescript support

This package has typescript typings included. If your webpack config is using typescript, you can use this syntax to import the default export:

import TsconfigPathsPlugin from "tsconfig-paths-webpack-plugin";

Or you can use this syntax to import the named export:

import { TsconfigPathsPlugin } from "tsconfig-paths-webpack-plugin";

How to test

To run the provided example:

yarn example

How to publish

yarn version --patch
yarn version --minor
yarn version --major

Prior work

This project uses work done in the awesome-typescript-loader.

More Repositories

1

tsconfig-paths

Load node modules according to tsconfig paths, in run-time or via API.
TypeScript
1,802
star
2

graphql-norm

Normalization and denormalization of GraphQL responses
TypeScript
31
star
3

uom

Extensible unit of measure conversion with type safety for typescript
TypeScript
18
star
4

three-x3d-loader

Three.js Loader for the X3D format.
JavaScript
15
star
5

graphql-add-remove-fields

Add or remove fields in graphql queries
TypeScript
9
star
6

tslint-divid

TSLint rules used in some projects at Divid.
TypeScript
9
star
7

ts-exhaustive-check

Exhaustive check for typescript type never
TypeScript
8
star
8

abstract-visuals

Abstract Visuals
JavaScript
6
star
9

graphql-norm-patch

Declarative patching of normalized GraphQL responses
TypeScript
6
star
10

uom-units

Predefined units for use with the uom package
TypeScript
3
star
11

advent-of-code-2017

Advent of code 2017
3
star
12

double-n

IEEE 754 double-precision binary floating-point with N number of significant precision bits
TypeScript
3
star
13

cron-backup-base

Dumping a backup file and transfer it via FTP or NFS (supports periodic backups and health checking)
Shell
3
star
14

eslint-config-divid

ESLint Sharable Config using typescript and prettier with functional programming style
JavaScript
2
star
15

graphql-norm-stale

Staleness tracking for normalized GraphQL responses
TypeScript
1
star
16

ctors-union

Define unions types via constructor functions
TypeScript
1
star
17

oas-to-ts

Convert an OpenAPI specifcation document to typescript types
TypeScript
1
star
18

cron-backup-postgres

Backup PostgresSQL to FTP or NFS (supports periodic backups)
Shell
1
star
19

scheduled-docker-system-prune

Runs docker system prune on a schedule
Shell
1
star