https://github.com/inebhedj/ih-warp
IH Webpack Assets Replicator Plugin (ihWARP)
https://github.com/inebhedj/ih-warp
assets copy html inebhedj javascript npm npm-package vanilla-javascript vanilla-js vanillajs webpack webpack-plugin webpack5
Last synced: 5 months ago
JSON representation
IH Webpack Assets Replicator Plugin (ihWARP)
- Host: GitHub
- URL: https://github.com/inebhedj/ih-warp
- Owner: inebhedj
- License: mpl-2.0
- Created: 2025-04-03T12:21:08.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-04T07:03:18.000Z (over 1 year ago)
- Last Synced: 2025-09-22T17:56:15.551Z (10 months ago)
- Topics: assets, copy, html, inebhedj, javascript, npm, npm-package, vanilla-javascript, vanilla-js, vanillajs, webpack, webpack-plugin, webpack5
- Language: JavaScript
- Homepage:
- Size: 36.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# @inebhedj/ih-warp
IH Webpack Assets Replicator Plugin (ihWARP)
A webpack plugin that copies assets referenced in HTML files into the output directory.
## Description
Webpack plugin for copying assets referenced in HTML files. This plugin scans through Webpack's output assets for HTML files,
extracts asset references (from src, href, meta tags, etc.), and copies the referenced asset files from specified directories (assetPaths) into the Webpack output directory. Files can be excluded from processing via exceptHTML (for HTML files) and exceptAssets (for asset paths). Additionally, if the asset file's extension is listed in mapExtensions, a corresponding .map file will also be copied.
## Requirements
- Node.js LTS (version >=20.17.0 <21 || >=22 <23 || >=24 <25 || >=26 <27)
- Corresponding npm version
- Webpack >= 5 (maybe works with webpack 4)
## Installation
```sh
npm install --save-dev @inebhedj/ih-warp
```
## Example usage in webpack.config.js
```javascript
const ihWARP = require('@inebhedj/ih-warp');
/* other codes */
module.exports = {
/* webpack configuration settings... */
plugins: [
/* other plugins... */
new ihWARP({
assetPaths: ['./src/assets'],
exceptHTML: ['ignore-this.html'],
exceptAssets: ['ignore-this.png'],
mapExtensions: ['.css', '.js'],
verbose: true
})
/* other plugins... */
]
/* other configuration settings... */
};
```
### Options
- `assetPaths`: Array of directory/directories where the asset files are searched.
- `exceptHTML`: Array of HTML file paths (relative) to be excluded.
- `exceptAssets`: Array of asset paths to be omitted from processing.
- `mapExtensions`: Array of file extensions for which associated .map files are copied. (default: ['.css', '.js'])
- `verbose`: Enables vlogging output.
## License
MPL 2.0