adding full configurability of copy webpack plugin

README.md

@@ -46,14 +46,18 @@ The constructor takes a configuration object with the following properties.
 | `externals[].entry` | string \| array&lt;string&gt; \| object \| array&lt;object \| string&gt; | The path, relative to the vendor module directory, to its pre-bundled distro file. e.g. for React, use `dist/react.js`, since the file exists at `node_modules/react/dist/react.js`. Specify an array if there are multiple CSS/JS files to inject. To use a CDN instead, simply use a fully qualified URL beginning with `http://`, `https://`, or `//`.<br><br>For entries whose type (JS or CSS) cannot be inferred by file extension, pass an object such as `{ path: 'https://some/url', type: 'css' }` (or `type: 'js'`). | *None* |
 | `externals[].entry.path` | string | If entry is an object, the path to the asset. | *None* |
 | `externals[].entry.type` | `'js'`\|`'css'` | The asset type, if it cannot be inferred. | *Inferred by extension when possible* |
+| `externals[].entry.cwpPatternConfig` | object | The properties to set on the [`copy-webpack-plugin` pattern object](https://github.com/webpack-contrib/copy-webpack-plugin#patterns). This object is merged in with the default `from` and `to` properties which are generated by the externals plugin. | `{}` |
 | `externals[].entry.attributes` | object.&lt;string,string&gt; | Additional attributes to add to the injected tag. | `{}` |
 | `externals[].global` | string \| null | For JavaScript modules, this is the name of the object globally exported by the vendor's dist file. e.g. for React, use `React`, since `react.js` creates a `window.React` global. For modules without an export (such as CSS), omit this property or use `null`. | `null` |
-| `externals[].supplements` | array&lt;string&gt; | For modules that require additional resources, specify globs of files to copy over to the output. e.g. for Bootstrap CSS, use `['dist/fonts/']`, since Glyphicon fonts are referenced in the CSS and exist at `node_modules/bootstrap/dist/fonts/`. | `[]` |
+| `externals[].supplements` | array&lt;string&gt; \| array&lt;object&gt; | For modules that require additional resources, specify globs of files to copy over to the output. e.g. for Bootstrap CSS, use `['dist/fonts/']`, since Glyphicon fonts are referenced in the CSS and exist at `node_modules/bootstrap/dist/fonts/`. Supplements can be specified as just an array of paths, or an array of objects with a path and copy plugin pattern object. | `[]` |
+| `externals[].supplements[].path` | string | The glob path to copy assets from. | *None* |
+| `externals[].supplements[].cwpPatternConfig` | object | The properties to set on the [`copy-webpack-plugin` pattern object](https://github.com/webpack-contrib/copy-webpack-plugin#patterns). This object is merged in with the default `from` and `to` properties which are generated by the externals plugin. | `{}` |
 | `externals[].append` | boolean | Set to true to inject this module after your Webpack bundles. | `false` |
 | `hash` | boolean | Set to true to append the injected module distro paths with a unique hash for cache-busting. | `false` |
 | `outputPath` | string | The path (relative to your Webpack `outputPath`) to store externals copied over by this plugin. | `vendor` |
 | `publicPath` | string \| null | Override Webpack config's `publicPath` for the externals files, or `null` to use the default `output.publicPath` value. | `null` |
 | `files` | string \| array&lt;string&gt; \| null | If you have multiple instances of HtmlWebpackPlugin, use this to specify globs of which files you want to inject assets into. Will add assets to all files by default. | `null` |
+| `cwpOptions` | object | The [options object](https://github.com/webpack-contrib/copy-webpack-plugin#options) to pass as the `copy-webpack-plugin` constructor's second parameter. | `{}` |
 | `enabled` | boolean | Set to `false` to disable the plugin (useful for disabling in development mode). | `true` |
 
 ## Examples
@@ -296,6 +300,88 @@ new HtmlWebpackExternalsPlugin({
 })
 ```
 
+### Passing an options argument to the `copy-webpack-plugin` constructor example
+
+You can change the default context for all patterns that are copied by the `copy-webpack-plugin`, enable debug mode, etc. by passing additional options to the plugin.
+
+This example assumes `bootstrap` is installed in the app via bower. It:
+
+1. copies `bower_components/bootstrap/dist/css/bootstrap.min.css` to `<output path>/vendor/bootstrap/dist/css/bootstrap.min.css`
+1. adds `<link href="<public path>/vendor/bootstrap/dist/css/bootstrap.min.css" rel="stylesheet">` to your HTML file, before your chunks
+
+```js
+new HtmlWebpackExternalsPlugin({
+  externals: [
+    {
+      module: 'bootstrap',
+      entry: 'dist/css/bootstrap.min.css',
+    },
+  ],
+  cwpOptions: {
+    context: path.resolve(__dirname, 'bower_components'),
+  },
+})
+```
+
+### Passing custom options to `copy-webpack-plugin` for an entry example
+
+In certain instances, you might want to control the properties that are passed in with the pattern object provided to `copy-webpack-plugin`, in order to control context, caching, output path, etc.
+
+This example assumes `bootstrap` is installed in the app via bower. It:
+
+1. copies `bower_components/bootstrap/dist/css/bootstrap.min.css` to `<output path>/vendor/bootstrap/dist/css/bootstrap.min.css`
+1. adds `<link href="/assets/vendor/bootstrap/dist/css/bootstrap.min.css" rel="stylesheet">` to your HTML file, before your chunks
+
+```js
+new HtmlWebpackExternalsPlugin({
+  externals: [
+    {
+      module: 'bootstrap',
+      entry: {
+        path: 'dist/css/bootstrap.min.css',
+        cwpPatternConfig: {
+          context: path.resolve(__dirname, 'bower_components'),
+        },
+      },
+    },
+  ],
+})
+```
+
+### Passing custom options to `copy-webpack-plugin` for a supplement example
+
+In certain instances, you might want to control the properties that are passed in with the pattern object provided to `copy-webpack-plugin`, in order to control context, caching, output path, etc.
+
+This example assumes `./mod` is a directory in your app that contains some dist files.
+
+1. copies `mod/dist/mod.css` to `<output path>/vendor/mod/dist/mod.css`
+1. copies all contents of `mod/dist/{a,b}/` to `<output path>/vendor/mod/dist/{a,b}/`, passing `nobrace` to `node-glob` so that `{a,b}` is matched literally instead of expanded into a glob
+1. adds `<link href="<public path>/vendor/bootstrap/dist/css/bootstrap.min.css" rel="stylesheet">` to your HTML file, before your chunks
+
+```js
+new HtmlWebpackExternalsPlugin({
+  externals: [
+    {
+      module: 'mod',
+      entry: 'dist/mod.css',
+      supplements: [
+        {
+          path: 'dist/{a,b}/',
+          cwpPatternConfig: {
+            fromArgs: {
+              nobrace: true,
+            },
+          },
+        },
+      ],
+    },
+  ],
+  cwpOptions: {
+    context: __dirname,
+  },
+})
+```
+
 ### Specifying which HTML files to affect example
 
 If you are using multiple instances of html-webpack-plugin, by default the assets will be injected into every file. This is configurable.