rollup-preset v0.0.5

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