rollup-presets is a collection of opinionated, production-ready Rollup presets for building TypeScript libraries and applications.

• Simple & Flexible: Preconfigured yet highly customizable build presets
• TypeScript-First: Built-in TypeScript support with path aliases and declaration files
• Multi-Format: Supports ESM and CJS output with proper Node.js compatibility
• Optimized: Production-ready with minification and tree-shaking
• Extensible: Plugin system with four stages for maximum control

📖 Usage

// rollup.config.js
import { libraryPreset } from 'rollup-presets';

export default libraryPreset();

📙 Presets

libraryPreset()

Creates a production-ready Rollup configuration for TypeScript libraries. Bundle paths are automatically resolved from your package.json exports field or standard fields.

📖 Usage

First, configure your package.json to define the bundle paths. You can use either conditional exports (recommended) or standard fields:

{
    "name": "my-library",
    "version": "1.0.0",
    "exports": {
        ".": {
            "import": "./dist/esm/index.js",
            "require": "./dist/cjs/index.js",
            "types": "./dist/types/index.d.ts",
            "source": "./src/index.ts"
        }
    }
}

Or using standard fields:

{
    "name": "my-library",
    "version": "1.0.0",
    "main": "./dist/cjs/index.js",
    "module": "./dist/esm/index.js",
    "types": "./dist/types/index.d.ts",
    "source": "./src/index.ts"
}

Then create your rollup.config.js:

import { libraryPreset } from 'rollup-presets';

export default libraryPreset();

That's it! This will automatically:

• Build ESM and CJS formats
• Generate TypeScript declarations
• Support path aliases from tsconfig.json
• Optimize for production by default

⚙️ Configuration

libraryPreset({
    // Build environment
    environment: 'production',
    // Keep directory structure
    preserveModules: true,
    // Output formats to generate
    formats: ['esm', 'cjs'],
    // Plugin stages for maximum control
    plugins: {
        // Stage 1: Pre-processing
        // Perfect for file replacements, virtual modules, or environment setup
        pre: [replacePlugin()],

        // Stage 2: Path-aware Transformations
        // Runs after TypeScript paths are resolved
        // Perfect for CSS imports, asset handling, or any path-dependent plugins
        transform: [cssPlugin()],

        // Stage 3: Post-processing
        // Perfect for bundle analysis, compression, or final optimizations
        post: [analyzePlugin()]
    },
    // Customize esbuild options
    esbuildOptions: {
        target: 'es2020'
    },
    // Modify final config for each bundle
    onCreateConfig: (config, bundlePath) => config
});