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

5.2 KiB

Raw Blame History

Auto-Generate Package Exports

Automatically generate package.json exports field from build output.

Overview

tsdown can automatically infer and generate the exports, main, module, and types fields in your package.json based on your build outputs.

Status: Experimental - review before publishing.

Basic Usage

CLI

tsdown --exports

Config File

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

What Gets Generated

Single Entry

Config:

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

Generated in package.json:

{
  "main": "./dist/index.cjs",
  "module": "./dist/index.mjs",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    }
  }
}

Multiple Entries

Config:

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

Generated in package.json:

{
  "main": "./dist/index.cjs",
  "module": "./dist/index.mjs",
  "types": "./dist/index.d.ts",
  "exports": {
    ".": {
      "types": "./dist/index.d.ts",
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    },
    "./utils": {
      "types": "./dist/utils.d.ts",
      "import": "./dist/utils.mjs",
      "require": "./dist/utils.cjs"
    }
  }
}

Export All Files

Include all output files, not just entry points:

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

Result: All .mjs, .cjs, and .d.ts files will be added to exports.

Dev-Time Source Linking

Dev Exports

Link to source files during development:

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

Generated:

{
  "exports": {
    ".": "./src/index.ts" // Points to source
  },
  "publishConfig": {
    "exports": {
      ".": {
        "import": "./dist/index.mjs",
        "require": "./dist/index.cjs"
      }
    }
  }
}

Note: Supported by pnpm/yarn, not npm.

Conditional Dev Exports

Use specific condition for dev exports:

export default defineConfig({
  exports: {
    devExports: 'development',
  },
});

Generated:

{
  "exports": {
    ".": {
      "development": "./src/index.ts",
      "import": "./dist/index.mjs",
      "require": "./dist/index.cjs"
    }
  }
}

Use with TypeScript customConditions:

// tsconfig.json
{
  "compilerOptions": {
    "customConditions": ["development"]
  }
}

Custom Exports

Add custom export mappings:

export default defineConfig({
  entry: ['src/index.ts'],
  exports: {
    customExports(pkg, context) {
      // Add custom export
      pkg['./foo'] = './dist/foo.js';

      // Add package.json export
      pkg['./package.json'] = './package.json';

      return pkg;
    },
  },
});

Common Patterns

Complete Library Setup

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

Multiple Exports with Dev Mode

export default defineConfig({
  entry: {
    index: 'src/index.ts',
    client: 'src/client.ts',
    server: 'src/server.ts',
  },
  format: ['esm', 'cjs'],
  dts: true,
  exports: {
    all: false, // Only entries
    devExports: 'development',
  },
});

Monorepo Package

export default defineConfig({
  workspace: 'packages/*',
  entry: ['src/index.ts'],
  format: ['esm', 'cjs'],
  dts: true,
  exports: true, // Generate for each package
});

Validation

Enable Publint

Validate generated exports:

tsdown --exports --publint

Or in config:

export default defineConfig({
  exports: true,
  publint: true, // Validate exports
});

Tips

Review before publishing - Check generated fields
Use with publint - Validate exports field
Enable for libraries - Especially with multiple exports
Use devExports - Better DX during development
Test exports - Verify imports work correctly

Troubleshooting

Exports Not Generated

Ensure exports: true is set
Check build completed successfully
Verify output files exist

Wrong Export Paths

Check outDir configuration
Verify entry names match expectations
Review format settings

Dev Exports Not Working

Only supported by pnpm/yarn
Check package manager
Use publishConfig for publishing

Types Not Exported

Enable dts: true
Ensure TypeScript is installed
Check .d.ts files are generated

CLI Examples

# Generate exports
tsdown --exports

# With publint validation
tsdown --exports --publint

# Export all files
tsdown --exports

# With dev exports
tsdown --exports

Entry - Configure entry points
Output Format - Module formats
DTS - Type declarations

5.2 KiB Raw Blame History