Rollup plugin to exclude external dependencies from bundle
\n\n\n\n## Installation\n```shell\n$ yarn add -D @azimutlabs/rollup-plugin-external\n```\n\n## Usage\n```javascript\n// rollup.config.js\nimport external from '@azimutlabs/rollup-plugin-external';\n\nexport default {\n input: 'index.js',\n plugins: [\n external({\n // Default options.\n useDependencies: true,\n usePeerDependencies: true,\n useBuiltins: true,\n checkForBabelMacro: false,\n packagePath: process.cwd(),\n }),\n ],\n};\n```\n\nPlugin does not override rollup's [external](https://rollupjs.org/guide/en/#external) option.\nInstead, it firstly looks for external, then applies plugin's core functionality\n```javascript\n// rollup.package.js\nimport external from '@azimutlabs/rollup-plugin-external';\n\nexport default {\n input: 'index.js',\n plugins: [external()],\n external: id => id.includes('fp-ts'),\n};\n```\n\n## Options\n| Name | Description | Type | Default |\n|------|-------------|------|---------|\n|`useDependencies`|Indicates whether to include `dependencies` from `package.json`|`boolean`|`true`|\n|`usePeerDependencies`|Indicates whether to include `peer dependencies` from `package.json`|`boolean`|`true`|\n|`useBuiltins`|Indicates whether to include **Node.js** builtin modules|`boolean`|`true`|\n|`checkForBabelMacro`|Indicates whether to check `package.json` for [**Babel Macro**](https://github.com/kentcdodds/babel-plugin-macros) packages|`boolean`|`false`|\n|`packagePath`|Directory or path to `package.json`. If not provided, looks for the closest `package.json` starting from current directory|`string`|`process.cwd()`|\n\n## Acknowledgement\nThis plugin was inspired by [`rollup-plugin-auto-external`](https://github.com/stevenbenisek/rollup-plugin-auto-external)\n\n## Contributing\nAny PR is welcomed by our **@js-opensource** team.\nCheck out our [contributing](../../CONTRIBUTING.md) guidelines for more info.\n\n## License\n[](../../LICENSE)\n","readmeFilename":"README.md"}