Files

T

fargo 1a822493ba format: apply repo prettier (3.8.1) to the folded skills tree

963 markdown files reformatted with the repository's pinned prettier so
pnpm format:check covers the folded tree like every other repo file.

The formatter's embedded-language pass also normalized code fences
(TS semicolons, closed HTML tags in examples, lowercased CSS hex colors,
one renumbered list that skipped an index). Alphanumeric token deltas vs
the fold commit were audited file-by-file; all are formatter-equivalent
markup normalizations plus the four sanitized skills.

2026-08-19 14:37:17 -05:00

3.6 KiB

Raw Blame History

Entry Points

Configure which files to bundle as entry points.

Overview

Entry points are the starting files for the bundling process. Each entry point generates a separate bundle.

Usage Patterns

CLI

# Single entry
tsdown src/index.ts

# Multiple entries
tsdown src/index.ts src/cli.ts

# Glob patterns
tsdown 'src/*.ts'

Config File

Single Entry

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

Multiple Entries (Array)

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

Named Entries (Object)

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

Output files will match the keys:

dist/main.mjs
dist/utils.mjs
dist/cli.mjs

Glob Patterns

Match multiple files dynamically using glob patterns:

All TypeScript Files

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

Exclude Test Files

export default defineConfig({
  entry: ['src/*.ts', '!src/*.test.ts'],
});

Object Entries with Glob Patterns

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',
  },
});

Negation Patterns in Object Entries

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.

Mixed Entries

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.

Windows Compatibility

Use forward slashes / instead of backslashes \ on Windows:

// ✅ Correct
entry: 'src/utils/*.ts';

// ❌ Wrong on Windows
entry: 'src\\utils\\*.ts';

Common Patterns

Library with Main Export

export default defineConfig({
  entry: 'src/index.ts',
  format: ['esm', 'cjs'],
  dts: true,
});

Library with Multiple Exports

export default defineConfig({
  entry: {
    index: 'src/index.ts',
    client: 'src/client.ts',
    server: 'src/server.ts',
  },
  format: ['esm', 'cjs'],
  dts: true,
});

CLI Tool

export default defineConfig({
  entry: {
    cli: 'src/cli.ts',
  },
  format: ['esm'],
  platform: 'node',
});

Preserve Directory Structure

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.mjs
src/utils/helper.ts → dist/utils/helper.mjs

Tips

Use glob patterns for multiple related files
Use object syntax for custom output names
Exclude test files with negation patterns !**/*.test.ts
Combine with unbundle to preserve directory structure
Use named entries for better control over output filenames

3.6 KiB Raw Blame History