Entry

The entry option specifies the entry files for your project. These files serve as the starting points for the bundling process. You can define entry files either via the CLI or in the configuration file.

Using the CLI

You can specify entry files directly as command arguments when using the CLI. For example:

tsdown src/entry1.ts src/entry2.ts

This command will bundle src/entry1.ts and src/entry2.ts as separate entry points.

Using the Config File

In the configuration file, the entry option allows you to define entry files in various formats:

Single Entry File

Specify a single entry file as a string:

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  entry: 'src/index.ts',
})

Multiple Entry Files

Define multiple entry files as an array of strings:

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  entry: ['src/entry1.ts', 'src/entry2.ts'],
})

Entry Files with Aliases

Use an object to define entry files with aliases. The keys represent alias names, and the values represent file paths:

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  entry: {
    main: 'src/index.ts',
    utils: 'src/utils.ts',
  },
})

This configuration will create two bundles: one for src/index.ts (output as dist/main.js) and one for src/utils.ts (output as dist/utils.js).

Using Glob Patterns

The entry option supports glob patterns, enabling you to match multiple files dynamically. For example:

tsdown.config.ts

import { defineConfig } from 'tsdown'

export default defineConfig({
  entry: 'src/**/*.ts',
})

This configuration will include all .ts files in the src directory and its subdirectories as entry points.

WARNING

The entry option is treated as a glob pattern by default. This means:

• On Windows, you must use forward slashes (/) instead of backslashes (\) in file paths.
• You cannot specify files that do not exist in the file system.

If you need to bypass these limitations, you can use inputOptions.input directly in the configuration file for more precise control.