Advanced Usage

Include/Exclude Patterns

Control which files are processed using glob patterns:

replaceShebang({
  include: ['src/cli.ts', 'src/bin/*.ts'],
  exclude: ['node_modules/**', '**/*.test.ts']
})

Supported Pattern Types

Pattern	Example	Matches
Exact match	src/cli.ts	Only src/cli.ts
Extension match	**/*.ts	Any .ts file in any directory
Prefix match	src/**	Any file under src/
Directory match	**/node_modules/**	Any file in node_modules anywhere
Wildcard match	src/*.test.ts	src/foo.test.ts but not src/sub/foo.test.ts
Plain string	node_modules	Any path containing node_modules

Default Patterns

Default include patterns

[
  '**/*.js',
  '**/*.ts',
  '**/*.mjs',
  '**/*.cjs',
  '**/*.jsx',
  '**/*.tsx'
]

Default exclude patterns

['node_modules/**']

Multiple Entry Points

When your project has multiple entry points with shebangs:

export default {
  input: ['src/cli.js', 'src/bin.js'],
  output: {
    dir: 'dist',
    format: 'es'
  },
  plugins: [
    replaceShebang({
      warnOnMultiple: true,  // Warn when multiple files have shebangs
      chmod: true
    })
  ]
}

Plugin API

The plugin exposes an API for external access:

const plugin = replaceShebang()

export default {
  // ... config
  plugins: [plugin]
}

// After build, access shebang information
plugin.api.getShebang('/path/to/file.js')
plugin.api.getAllShebangs()  // Returns Map<string, string>

This is useful for:

• Build scripts that need to know which files have shebangs
• Integration with other tools
• Debugging build issues

Integration with Other Plugins

CommonJS Plugin

import commonjs from '@rollup/plugin-commonjs'
import replaceShebang from 'rollup-plugin-replace-shebang'

export default {
  plugins: [
    replaceShebang(),  // Must come first
    commonjs()
  ]
}

TypeScript Plugin

import typescript from '@rollup/plugin-typescript'
import replaceShebang from 'rollup-plugin-replace-shebang'

export default {
  plugins: [
    replaceShebang(),  // Must come first
    typescript()
  ]
}

Node Resolve Plugin

import { nodeResolve } from '@rollup/plugin-node-resolve'
import replaceShebang from 'rollup-plugin-replace-shebang'

export default {
  plugins: [
    replaceShebang(),  // Must come first
    nodeResolve()
  ]
}

Programmatic Usage

You can use the plugin programmatically:

import { rollup } from 'rollup'
import replaceShebang from 'rollup-plugin-replace-shebang'

const bundle = await rollup({
  input: 'src/cli.js',
  plugins: [
    replaceShebang({ chmod: true })
  ]
})

await bundle.write({
  file: 'dist/cli.js',
  format: 'es'
})