babel-preset-firecloud

The Babel preset used within Tobii Cloud Services.

In your project's .babelrc.js

module.exports = {
  presets: [
    ['firecloud', {
      // debug: false,
      // loose: false,
      // spec: false,
      // useBuiltIns: true,
      // 'preset|plugin': {...options}
    }]
  ]
};

Optionally, you can run node_modules/babel-preset-firecloud/npm-install-peer-dependencies in order to install the required peer dependencies.

NOTE If you're using an earlier version than Babel 7.0, you can upgrade your .babelrc to be dynamic and use .babelrc.js by setting it to:

{
  "preset": [
    "./.babelrc.js"
  ]
}

See https://fatfisz.com/blog/using-babelrc-js-today .

Options

Pass debug, loose, spec or useBuiltIns to configure presets/plugins, as per the semantics defined by babel-preset-env.

Included presets/plugins can be

• further configured by sending options to each of them
• disabled by sending {"disabled": true} as options

Firecloud plugins

babel-plugin-firecloud-export-all (default: enabled)

Makes all top-level module definitions exported (adding export keyword to declaration).

Additionally all references to these variables will be replaced with exports.<reference>. This is a closer behaviour to ES6 export bindings, where changing the exported value outside of the module would make the change reflect inside the module. See http://2ality.com/2015/07/es6-module-exports.html .

In:

let _a = 5;

let foo = function() {
  return _a;
}

Out:

export let _a = 5;

export let foo = function() {
  return exports._a;
}

NOTE A negative side-effect. While debugging, Chrome won't be able to get the value of an exported variable, because the source map will reference exports.something, while you still hover something. Tracked in #2 .

To disable in .babelrc.js:

module.exports = {
  presets: [
    ['firecloud', {
      'babel-plugin-firecloud-export-all': {
        disabled: true
      }
    }]
  ]
};

babel-plugin-firecloud-src-arg (default: config-needed)

Adds an extra argument with info about location (file/line/column) to calls of a function e.g. logger.

To configure in .babelrc.js:

// provide a static list of function calls to amend with src information
let srcFuns = [
  'console.log',
  'console.error'
];

// or provide a dynamic list
let srcFuns = function() {
  return [
    'log',
    'error'
  ].map(function(consoleFun) {
    return `console.${consoleFun}`;
  });
}

module.exports = {
  presets: [
    ['firecloud', {
      'babel-plugin-firecloud-src-arg': {
        srcFuns
      }
    }]
  ]
};

To disable in .babelrc.js:

module.exports = {
  presets: [
    ['firecloud', {
      'babel-plugin-firecloud-src-arg': {
        disabled: true
      }
    }]
  ]
};

Notable plugins (not included)

1. https://github.com/kmagiera/babel-watch
2. https://github.com/furstenheim/babel-plugin-meaningful-logs
3. https://github.com/kentcdodds/babel-plugin-preval

Misc plugins

1. https://github.com/codemix/flow-runtime/tree/master/packages/babel-plugin-flow-runtime
2. https://github.com/vitalets/babel-plugin-runtyper
3. https://github.com/loganfsmyth/babel-plugin-transform-builtin-extend
4. https://github.com/miraks/babel-plugin-implicit-return
5. https://github.com/andreineculau/babel-plugin-thin-arrows

License

UNLICENSE