Examples

This section contains example projects demonstrating how to use rollup-plugin-replace-shebang with different Rollup versions.

Online Examples

Try the plugin online with StackBlitz:

Example	Description	Link
Rollup v2	Rollup 2.x with custom shebang, template variables, and Plugin API	Open in StackBlitz
Rollup v4	Rollup 4.x with all features including skipBackslash	Open in StackBlitz

Local Examples

Clone the repository and try the examples locally:

git clone https://github.com/saqqdy/rollup-plugin-replace-shebang.git
cd rollup-plugin-replace-shebang/examples/rollup-v4
pnpm install
pnpm run build
./dist/cli.js info

Feature Coverage

Feature	rollup-v2	rollup-v4
Basic shebang	✓	✓
Custom shebang	✓	-
Template variables (${name}, ${version})	✓	-
chmod	✓	✓
include	-	✓
exclude	-	✓
warnOnMultiple	-	✓
skipBackslash	-	✓
preserve	✓ (commented)	-
Plugin API	✓	✓

Pattern Matching

The plugin supports various glob patterns for include and exclude:

Pattern	Example	Matches
Exact match	src/cli.ts	Only src/cli.ts
Extension match	**/*.ts	Any .ts file
Prefix match	src/**	Any file under src/
Directory match	**/node_modules/**	Any file in node_modules
Wildcard match	src/*.test.ts	src/foo.test.ts only
Plain string	node_modules	Any path containing node_modules

Plugin API Usage

The plugin exposes an API for accessing shebang information:

const plugin = replaceShebang({ /* options */ })

// After transform phase, access shebang info
plugin.api.getShebang('/path/to/file.js')  // Returns shebang string or undefined
plugin.api.getAllShebangs()                  // Returns Map<string, ModuleInfo>