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

4.8 KiB

Raw Blame History

Output Directory Cleaning

Control how the output directory is cleaned before builds.

Overview

By default, tsdown cleans the output directory before each build to remove stale files from previous builds.

Basic Usage

CLI

# Clean enabled (default)
tsdown

# Disable cleaning
tsdown --no-clean

Config File

export default defineConfig({
  entry: ['src/index.ts'],
  clean: true, // Default
});

Behavior

With Cleaning (Default)

Before each build:

All files in outDir are removed
Fresh build starts with empty directory
Only current build outputs remain

Benefits:

No stale files
Predictable output
Clean slate each build

Without Cleaning

Build outputs are added to existing files:

export default defineConfig({
  clean: false,
});

Use when:

Multiple builds to same directory
Incremental builds
Preserving other files
Watch mode (faster rebuilds)

Common Patterns

Production Build

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

Development Mode

export default defineConfig((options) => ({
  entry: ['src/index.ts'],
  clean: !options.watch, // Don't clean in watch mode
  sourcemap: options.watch,
}));

Multiple Builds

export default defineConfig([
  {
    entry: ['src/index.ts'],
    outDir: 'dist',
    clean: true, // Clean once
  },
  {
    entry: ['src/cli.ts'],
    outDir: 'dist',
    clean: false, // Don't clean, add to same dir
  },
]);

Monorepo Package

export default defineConfig({
  workspace: 'packages/*',
  entry: ['src/index.ts'],
  clean: true, // Clean each package's dist
});

Preserve Static Files

export default defineConfig({
  entry: ['src/index.ts'],
  clean: false, // Keep manually added files
  outDir: 'dist',
});

// Manually copy files first
// Then run tsdown --no-clean

Clean Patterns

Selective Cleaning

import { rmSync } from 'fs';

export default defineConfig({
  clean: false, // Disable auto clean
  hooks: {
    'build:prepare': () => {
      // Custom cleaning logic
      rmSync('dist/*.js', { force: true });
      // Keep other files
    },
  },
});

Clean Specific Directories

export default defineConfig({
  clean: false,
  hooks: {
    'build:prepare': async () => {
      const { rm } = await import('fs/promises');
      // Only clean specific subdirectories
      await rm('dist/esm', { recursive: true, force: true });
      await rm('dist/cjs', { recursive: true, force: true });
      // Keep dist/types
    },
  },
});

Watch Mode Behavior

In watch mode, cleaning behavior is important:

Clean on First Build Only

export default defineConfig((options) => ({
  entry: ['src/index.ts'],
  watch: options.watch,
  clean: !options.watch, // Only clean initial build
}));

Result:

First build: Clean
Subsequent rebuilds: Incremental

Always Clean

export default defineConfig({
  watch: true,
  clean: true, // Clean every rebuild
});

Trade-off: Slower rebuilds, but always fresh output.

Tips

Leave enabled for production builds
Disable in watch mode for faster rebuilds
Use multiple configs carefully with cleaning
Custom clean logic via hooks if needed
Be cautious - cleaning removes ALL files in outDir
Test cleaning - ensure no important files are lost

Troubleshooting

Important Files Deleted

Don't put non-build files in outDir
Use separate directory for static files
Disable cleaning and manage manually

Stale Files in Output

Enable cleaning: clean: true
Or manually remove before build

Slow Rebuilds in Watch

Disable cleaning in watch mode
Use incremental builds

CLI Examples

# Default (clean enabled)
tsdown

# Disable cleaning
tsdown --no-clean

# Watch mode without cleaning
tsdown --watch --no-clean

# Multiple formats with cleaning
tsdown --format esm,cjs --clean

Examples

Safe Production Build

# Clean before build
rm -rf dist
tsdown --clean

Incremental Development

export default defineConfig({
  entry: ['src/index.ts'],
  watch: true,
  clean: false, // Faster rebuilds
  sourcemap: true,
});

Multi-Stage Build

// Stage 1: Clean and build main
export default defineConfig([
  {
    entry: ['src/index.ts'],
    outDir: 'dist',
    clean: true,
  },
  {
    entry: ['src/utils.ts'],
    outDir: 'dist',
    clean: false, // Add to same directory
  },
]);

Output Directory - Configure outDir
Watch Mode - Development workflow
Hooks - Custom clean logic
Entry - Entry points

4.8 KiB Raw Blame History