A Gulp plugin for Rollup ES6 Bundler. In comparison with gulp-rollup, this plugin integrates Rollup deeper into Gulps pipeline chain. It takes some of the Rollup API out of your hands, in exchange for giving you full power over the pipeline (to use any gulp plugins).
How it works
Rollup is designed to handle reading files, building a dependency tree, transforming content and then writing the transformed files. This doesn't play well with gulp, since gulp is also designed to handle files with gulp.src() and gulp.dest(). Gulp plugins, by design should just handle in-memory transformations. Not actual files.
To tackle this problem gulp-better-rollup passes the file paths loaded in gulp.src() to rollup, rather than the gulp buffer.
This comes with some caveats:
If you use other gulp plugin before gulp-better-rollup, their transformations will be lost. If the plugin doesn't do source transformations (like for example gulp-sourcemaps) this is fine.
The Rollup "input" argument is unsupported.
Since the output location is determined by gulp.dest(), the output "file" argument passed to Rollup can at most be used to set the file name for a bundle. If you pass a full directory path, only the file name part will be used. In addition, if you pass a file path to gulp.dest(), the Rollup "file" argument will be ignored entirely.
The gulp-sourcemaps plugin doesn't (yet) support the .mjs extension, that you may want to use to support the ES module format in Node.js. It can inline the sourcemap into the bundle file (using sourcemaps.write()), and create an external sourcemap file with sourcemaps.write(PATH_TO_SOURCEMAP_FOLDER). It won't however insert the //# sourceMappingURL= linking comment at the end of your .mjs file, which effectively renders the sourcemaps useless.
Installation
npm install gulp-better-rollup --save-dev
You also need to install your own rollup (version 1.x.x). gulp-better-rollup depends on your rollup as a peer-dependency.
npm install rollup@^1 --save-dev
Usage
vargulp=require('gulp')varrename=require('gulp-rename')varsourcemaps=require('gulp-sourcemaps')varrollup=require('gulp-better-rollup')varbabel=require('rollup-plugin-babel')gulp.task('lib-build',()=>{gulp.src('lib/index.js').pipe(sourcemaps.init()).pipe(rollup({// There is no `input` option as rollup integrates into the gulp pipelineplugins: [babel()]},{// Rollups `sourcemap` option is unsupported. Use `gulp-sourcemaps` plugin insteadformat: 'cjs',}))// inlining the sourcemap into the exported .js file.pipe(sourcemaps.write()).pipe(gulp.dest('dist'))})
Or simply:
gulp.task('lib-build',()=>{gulp.src('lib/mylibrary.js').pipe(sourcemaps.init())// note that UMD and IIFE format requires `name` but it will be inferred from the source file name `mylibrary.js`.pipe(rollup({plugins: [babel()]},'umd'))// save sourcemap as separate file (in the same folder).pipe(sourcemaps.write('')).pipe(gulp.dest('dist'))})
cache is enabled by default and taken care of by the plugin, because usage in conjunction with watchers like gulp-watch is expected. It can however be disabled by settings cache to false.
name and amd.id are inferred from the module file name by default, but can be explicitly specified to override this. For example, if your main file is named index.js or main.js, then your module would also be named index or main, which you may not want.
To use unnamed modules for amd, set amd.id to an empty string, ex: .pipe(rollup({amd:{id:''}})).
intro and outro are supported, but we encouraged you to use gulps standard plugins like gulp-header and gulp-footer.
sourcemap and sourcemapFile are unsupported. Use the standard gulp-sourcemaps plugin instead.
shortcuts
You can skip this first argument if you don't need to specify inputOptions.
outputOptions accepts a string with the module format, in case you only want to support a single format.
请发表评论