Subchapter 8.16
references/option-entry.mdMarkdown4 KBView on GitHub
Entry points are the starting files for the bundling process. Each entry point generates a separate bundle.
# Single entry
tsdown src/index.ts
# Multiple entries
tsdown src/index.ts src/cli.ts
# Glob patterns
tsdown 'src/*.ts'export default defineConfig({
entry: 'src/index.ts',
})export default defineConfig({
entry: ['src/entry1.ts', 'src/entry2.ts'],
})export default defineConfig({
entry: {
main: 'src/index.ts',
utils: 'src/utils.ts',
cli: 'src/cli.ts',
},
})Output files will match the keys:
dist/main.mjsdist/utils.mjsdist/cli.mjsMatch multiple files dynamically using glob patterns:
export default defineConfig({
entry: 'src/**/*.ts',
})export default defineConfig({
entry: ['src/*.ts', '!src/*.test.ts'],
})Use glob wildcards (*) in both keys and values. The * in the key acts as a placeholder replaced with the matched file name (without extension):
export default defineConfig({
entry: {
// Maps src/foo.ts → dist/lib/foo.js, src/bar.ts → dist/lib/bar.js
'lib/*': 'src/*.ts',
},
})Values can be an array with negation patterns (!):
export default defineConfig({
entry: {
'hooks/*': ['src/hooks/*.ts', '!src/hooks/index.ts'],
},
})Multiple positive and negation patterns:
export default defineConfig({
entry: {
'utils/*': [
'src/utils/*.ts',
'src/utils/*.tsx',
'!src/utils/index.ts',
'!src/utils/internal.ts',
],
},
})Warning: Multiple positive patterns in an array value must share the same base directory.
Mix strings, glob patterns, and object entries in an array:
export default defineConfig({
entry: [
'src/*',
'!src/foo.ts',
{ main: 'index.ts' },
{ 'lib/*': ['src/*.ts', '!src/bar.ts'] },
],
})Object entries take precedence when output names conflict.
Use forward slashes / instead of backslashes \ on Windows:
// ✅ Correct
entry: 'src/utils/*.ts'
// ❌ Wrong on Windows
entry: 'src\\utils\\*.ts'export default defineConfig({
entry: 'src/index.ts',
format: ['esm', 'cjs'],
dts: true,
})export default defineConfig({
entry: {
index: 'src/index.ts',
client: 'src/client.ts',
server: 'src/server.ts',
},
format: ['esm', 'cjs'],
dts: true,
})export default defineConfig({
entry: {
cli: 'src/cli.ts',
},
format: ['esm'],
platform: 'node',
})Use with unbundle: true to keep file structure:
export default defineConfig({
entry: ['src/**/*.ts', '!**/*.test.ts'],
unbundle: true,
format: ['esm'],
dts: true,
})This will output files matching the source structure:
src/index.ts → dist/index.mjssrc/utils/helper.ts → dist/utils/helper.mjs!**/*.test.ts