Nutritious Pumpkin Masses

    rollup-plugin-peer-deps-external
    DefinitelyTyped icon, indicating that this package has TypeScript declarations provided by the separate @types/rollup-plugin-peer-deps-external package

    2.2.4 • Public • Published

    Build Status npm semantic-release

    Rollup Plugin Peer Deps External

    Automatically externalize peerDependencies in a rollup bundle.

    Motivation

    When bundling a library using rollup, we generally want to keep from including peerDependencies since they are expected to be provided by the consumer of the library. By excluding these dependencies, we keep bundle size down and avoid bundling duplicate dependencies.

    We can achieve this using the rollup external configuration option, providing it a list of the peer dependencies to exclude from the bundle. This plugin automates the process, automatically adding a library's peerDependencies to the external configuration.

    Installation

    npm install --save-dev rollup-plugin-peer-deps-external

    Usage

    // Add to plugins array in rollup.config.js
    import peerDepsExternal from 'rollup-plugin-peer-deps-external';
     
    export default {
      plugins: [
        // Preferably set as first plugin.
        peerDepsExternal(),
      ],
    }

    Options

    packageJsonPath

    If your package.json is not in the current working directory you can specify the path to the file

    // Add to plugins array in rollup.config.js
    import peerDepsExternal from 'rollup-plugin-peer-deps-external';
     
    export default {
      plugins: [
        // Preferably set as first plugin.
        peerDepsExternal({
          packageJsonPath: 'my/folder/package.json'
        }),
      ],
    }

    includeDependencies **deprecated**

    Set includeDependencies to true to also externalize regular dependencies in addition to peer deps.

    // Add to plugins array in rollup.config.js
    import peerDepsExternal from 'rollup-plugin-peer-deps-external';
     
    export default {
      plugins: [
        // Preferably set as first plugin.
        peerDepsExternal({
          includeDependencies: true,
        }),
      ],
    }

    Module paths

    This plugin is compatible with module path format applied by, for example, babel-plugin-lodash. For any module name in peerDependencies, all paths beginning with that module name will also be added to external.

    E.g.: If lodash is in peerDependencies, an import of lodash/map would be added to externals.

    Install

    npm i rollup-plugin-peer-deps-external

    DownloadsWeekly Downloads

    548,966

    Version

    2.2.4

    License

    MIT

    Unpacked Size

    71.3 kB

    Total Files

    11

    Last publish

    Collaborators

    • pmowrer