rollup-plugin-builder

Copies static asset directories into the build output, minifying text assets on the way and optionally stamping a license banner into html/css files. Banner text is caller-supplied with {{year}}/{{startYear}} placeholders — nothing company- or year-specific is baked into the plugin.

Processing by extension:

| Extension | Treatment | | -------------------- | --------- | | htm, html | minify (@proctorio/hulk) + banner | | css | minify (@proctorio/hulk) + banner | | xml | inter-tag whitespace compression | | json, nmf, svg | copied through untouched | | webp, gif, png | copied byte for byte |

Files with other extensions and nested directories are skipped — configure nested directories as their own dirs entries.

Installation

npm install rollup-plugin-builder

Usage

// rollup.config.js
import builder, { renderBanner } from "rollup-plugin-builder";

const BANNER = "COPYRIGHT (C) {{startYear}}-{{year}} EXAMPLE INC.\nALL RIGHTS RESERVED.";

export default {
	output: {
		// the js-style banner works for rollup's own banner option too
		banner: renderBanner(BANNER, "js", 2010)
	},
	plugins: [
		builder({
			location: "_build/",
			banner: {
				text: BANNER,
				startYear: 2010
			},
			dirs: [
				{ in: "src", out: "assets", rename: { "popup.html": "p.html" } },
				{ in: "webassets", out: "webassets" }
			]
		})
	]
};

Options

| Option | Required | Description | | ------------ | -------- | ----------- | | dirs | yes | Array of { in, out, rename? } mappings. out is resolved against location; rename maps input filenames to output filenames. | | location | yes | Output root directory. | | banner | no | { text, startYear? }. Rendered and stamped into html/css outputs. {{year}} becomes the current year; {{startYear}} requires the startYear value (and vice versa). | | extensions | no | Accepted file extensions (defaults to the table above). |

renderBanner(text, style, startYear?) is exported for stamping banners outside the copy pipeline — style is "js", "css" or "html".

All failures throw and fail the build.

Development

npm install
npm test        # vitest
npm run coverage
npm run lint