Nightmarish Pawnshop Mystic

    @jpweeks/rollupify

    0.4.0 • Public • Published

    rollupify Build Status

    Browserify transform to apply Rollup, converting ES6/ES2015 modules into one big CommonJS module.

    This tends to result in smaller bundle sizes, due to Rollup's tree-shaking and scope-hoisting capabilities.

    Usage

    npm install rollupify
    

    Then:

    browserify -t rollupify index.js > output.js
    

    Or in your package.json:

    "browserify": {
      "transform": ["rollupify"]
    }

    Example

    Input:

    // index.js
    import hello from './hello';
    console.log(hello);
    export default hello;
    // hello.js
    export default "hello world";

    Output:

    (function e(t,n,r){function s(o,u){if(!n[o]){if(!t[o]){var a=typeof require=="function"&&require;if(!u&&a)return a(o,!0);if(i)return i(o,!0);var f=new Error("Cannot find module '"+o+"'");throw f.code="MODULE_NOT_FOUND",f}var l=n[o]={exports:{}};t[o][0].call(l.exports,function(e){var n=t[o][1][e];return s(n?n:e)},l,l.exports,e,t,n,r)}return n[o].exports}var i=typeof require=="function"&&require;for(var o=0;o<r.length;o++)s(r[o]);return s})({1:[function(require,module,exports){
    'use strict';
    
    var hello = "hello world";
    
    console.log(hello);
    
    module.exports = hello;
    },{}]},{},[1]);

    Using alongside other transforms

    If you are using other transforms like babelify, make sure you apply the transforms in the right order. rollupify should apply before babelify:

    browserify -t rollupify -t babelify index.js > output.js
    

    Or when configuring:

    "browserify": {
      "transform": ["rollupify", "babelify"]
    }

    Details

    rollupify only works on ES6/ES2015 modules. Any require() statements will be left untouched, and passed on to Browserify like normal.

    Sourcemaps are supported, assuming you pass --debug or {debug: true} into Browserify.

    Need more evidence that Rollup and ES6 modules are awesome? See rollup-comparison and A better build system with Rollup.

    Need to get started converting your CommonJS codebase into ES6? Try cjs-to-es6.

    Customising rollup

    Given a rollup.config.js like:

    module.exports = {
      plugins: [
        require('rollup-plugin-babel')({
          exclude: 'node_modules/**'
        })
      ]
    }

    Use it through the command line:

    browserify -t [ rollupify --config rollup.config.js ] index.js > output.js
    

    Or in your package.json:

    "browserify": {
      "transform": ["rollupify", {"config": "rollup.config.js"}]
    }

    If you are using Browserify in JavaScript, you can also pass in the config object directly:

    var b = browserify('./')
      .transform('rollupify', {
        config: { /* your rollup config goes here */ }
      }).bundle();

    Install

    npm i @jpweeks/rollupify

    DownloadsWeekly Downloads

    1

    Version

    0.4.0

    License

    Apache-2.0

    Last publish

    Collaborators

    • jpweeks