@nx/js:tsc

Builds using TypeScript.

Options can be configured in project.json when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/reference/project-configuration#targets.

Examples

@nx/js:tsc can run the TypeScript Transformers by using the transformers option.

libs/ts-lib/project.json
{
  "build": {
    "executor": "@nx/js:tsc",
    "options": {
      "outputPath": "dist/libs/ts-lib",
      "main": "libs/ts-lib/src/index.ts",
      "tsConfig": "libs/ts-lib/tsconfig.lib.json",
      "assets": ["libs/ts-lib/*.md"],
      "transformers": [
        "@nestjs/swagger/plugin",
        {
          "name": "@automapper/classes/transformer-plugin",
          "options": {}
        }
      ]
    }
  }
}
Nx 15 and lower use @nrwl/ instead of @nx/

Options playground

Try out this interactive editor of the configuration object. Values are validated as you type and hovering over labels will give you more information.

Options

main

Required

string

The name of the main entry-point file.

outputPath

Required

string

The output path of the generated files.

tsConfig

Required

string

The path to the Typescript configuration file.

additionalEntryPoints

Array<string>

Additional entry-points to add to exports field in the package.json file.

generateExportsField

exports

boolean

Default: false

Update the output package.json file's 'exports' field. This field is used by Node and bundles.

transformers

Array<oneOf [string, object ]>

Default: []

List of TypeScript Transformer Plugins.

assets

Array<oneOf [object , string]>

Default: []

List of static assets.

clean

boolean

Default: true

Remove previous output before build.

external

oneOf [string, Array<string>]

A list projects to be treated as external. This feature is experimental

externalBuildTargets

Array<string>

Default: [build]

List of target names that annotate a build target for a project

rootDir

string

Sets the rootDir for TypeScript compilation. When not defined, it uses the root of project.

watch

boolean

Default: false

Enable re-building when files change.

generateLockfile

boolean

Default: false

Generate a lockfile (e.g. package-lock.json) that matches the workspace lockfile to ensure package versions match.

buildableProjectDepsInPackageJsonType

Deprecated

string

Default: peerDependencies

Accepted values: dependencies, peerDependencies

When updateBuildableProjectDepsInPackageJson is true, this adds dependencies to either peerDependencies or dependencies.

Configure the project to use the '@nx/dependency-checks' ESLint rule instead (https://nx.dev/packages/eslint-plugin/documents/dependency-checks). It will be removed in v17.

updateBuildableProjectDepsInPackageJson

Deprecated

boolean

Default: false

Whether to update the buildable project dependencies in the build output package.json.

Configure the project to use the '@nx/dependency-checks' ESLint rule instead (https://nx.dev/packages/eslint-plugin/documents/dependency-checks). It will be removed in v17.