Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslnode 18–223 runs
build_error
glibcnode 18–223 runs
build_error
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
default
✓ const rollup2 = require('gulp-rollup-2');
✗ import rollup2 from 'gulp-rollup-2';
Package exports a CommonJS default; ESM import may work if bundler supports package.json exports, but CJS require is guaranteed.
rollup
✓ const { rollup } = require('gulp-rollup-2');
✗ const { rollup } = require('gulp-rollup-2').default;
Named export `rollup` is the main plugin function. No `.default` needed.
src
✓ const { src } = require('gulp-rollup-2');
✗ const src = require('gulp-rollup-2').src;
Standalone src() factory for when gulp.src() is not used. Same result as named destructuring.
Basic Gulp task using gulp-rollup-2 to bundle src/index.js with Rollup plugins and output IIFE with sourcemap.
const gulp = require('gulp');
const rollup2 = require('gulp-rollup-2');
const resolve = require('@rollup/plugin-node-resolve');
const commonjs = require('@rollup/plugin-commonjs');
gulp.task('bundle', () =>
gulp
.src('src/index.js')
.pipe(
rollup2.rollup({
input: 'src/index.js',
plugins: [resolve(), commonjs()],
output: {
file: 'bundle.js',
format: 'iife',
name: 'App',
sourcemap: true,
},
})
)
.pipe(gulp.dest('dist'))
);
Errors
Common errors & fixes
Error: Output files must be unique. Duplicate outputs detected: ...
Multiple rollup output configurations target the same `file` path.
fixEnsure each output object has a unique `file` value, e.g., 'bundle.esm.js' and 'bundle.cjs.js'.
TypeError: rollup2.rollup is not a function
Incorrect import - trying to call default export as function or using wrong named import.
fixUse `const { rollup } = require('gulp-rollup-2');` (destructured named export). Error: Cannot find module 'rollup'
Rollup is not installed as a peer dependency.
fixRun `npm install --save-dev rollup@^4.0.0`.
Audit
Dependencies
gulprequiredPeer dependency - requires Gulp >=4.0.0 for pipe() integration
rolluprequiredPeer dependency - core bundler, requires Rollup >=4.0.0