Skip to content

Latest commit

 

History

History
108 lines (83 loc) · 2.61 KB

README.md

File metadata and controls

108 lines (83 loc) · 2.61 KB

Solid Rollup Preset

Solid Rollup Preset

A small opinionated preset for rollup to bundle your solid libraries with rollup.

Features out of the box:

  • Automatic TypeScript
  • Minimal - two lines config
  • No lock-in - you are in total control of the rollup config
  • Best practices for publishing solid libraries by compiling for esm, cjs, jsx, umd and tsc
  • Automatically clean dist folder on build

Usage

  1. Install with your favorite package manager:
npm install -D rollup-preset-solid rollup
pnpm add -D rollup-preset-solid rollup
yarn add -D rollup-preset-solid rollup
  1. Import withConfig in your rollup.config.js. The first and only argument is (optionally) your rollup config:
// rollup.config.js
import withSolid from "rollup-preset-solid";

export default withSolid();
  1. Configure your package.json
{
  "name": "my-lib",

  "// This is optional but this remove the need to manually configure the source input for rollup": "",
  "source": "src/my-lib.tsx",

  "// All the following properties will be hinted during build": "",
  "// You will just have to copy paste them": "",

  "main": "dist/cjs/my-lib.js",
  "module": "dist/esm/my-lib.js",
  "types": "dist/types/my-lib.d.ts",
  "files": ["dist"],
  "exports": {
    ".": {
      "solid": "./dist/source/my-lib.jsx",
      "import": "./dist/esm/my-lib.js",
      "browser": "./dist/esm/my-lib.js",
      "require": "./dist/cjs/my-lib.js",
      "node": "./dist/cjs/my-lib.js"
    }
  }
}

API

withSolid(options?: Options | Options[]): RollupOptions | RollupOptions[]

The default export. A wrapper function that accepts all of the rollup options and a few extra to configure what to generate.

Options

The options are the exact same as Rollup with a few extra that are specific to the wrapper

Interface

interface Options extends RollupOptions {
  /**
   * Defines which target you want
   * @default ['esm']
   */
  targets?: ModuleFormat[];
  /**
   * Whether to generate a package.json or not
   * This is useful for sub packages
   * @default false
   */
  writePackageJson?: boolean;
  /**
   * Whether to hint what to put in your package.json or not
   * @default false
   */
  printInstructions?: boolean;
}

Example

// rollup.config.js
import withSolid from "rollup-preset-solid";

export default withSolid([
  { input: "browser.ts", targets: ["esm"] },
  { input: "server.ts", targets: ["esm", "cjs"], writePackageJson: true },
]);