first commit

themes/ceras/node_modules/6to5ify/README.md

@@ -0,0 +1,117 @@
+# 6to5ify
+
+[6to5](https://github.com/6to5/6to5) [browserify](https://github.com/substack/node-browserify) plugin
+
+## Installation
+
+    $ npm install --save-dev 6to5ify
+
+## Usage
+
+### CLI
+
+    $ browserify script.js -t 6to5ify --outfile bundle.js
+
+### Node
+
+```javascript
+var fs = require("fs");
+var browserify = require("browserify");
+var to5ify = require("6to5ify");
+browserify({ debug: true })
+  .transform(to5ify)
+  .require("./script.js", { entry: true })
+  .bundle()
+  .on("error", function (err) { console.log("Error : " + err.message); })
+  .pipe(fs.createWriteStream("bundle.js"));
+```
+
+#### [Options](https://6to5.github.io/usage.html#options)
+
+```javascript
+browserify().transform(to5ify.configure({
+  blacklist: ["generators"]
+}))
+```
+
+```sh
+$ browserify -d -e script.js -t [ 6to5ify --blacklist generators ]
+```
+
+#### Enable Experimental Transforms
+
+By default 6to5's [experimental transforms](http://6to5.org/docs/usage/transformers/#es7-experimental-)
+are disabled. You can turn them on by passing `experimental` as a configuration option.
+
+```javascript
+browserify().transform(to5ify.configure({
+  experimental: true
+}))
+```
+
+```sh
+$ browserify -d -e script.js -t [ 6to5ify --experimental ]
+```
+
+#### Customising extensions
+
+By default all files with the extensions `.js`, `.es`, '`.es6` and `.jsx` are compiled.
+You can change this by passing an array of extensions.
+
+**NOTE:** This will override the default ones so if you want to use any of them
+you have to add them back.
+
+```javascript
+browserify().transform(to5ify.configure({
+  extensions: [".6to5"]
+}))
+```
+
+```sh
+$ browserify -d -e script.js -t [ 6to5ify --extensions .6to5 ]
+```
+
+#### Relative source maps
+
+Browserify passes an absolute path so there's no way to determine what folder
+it's relative to. You can pass a relative path that'll be removed from the
+absolute path with the `sourceMapRelative` option.
+
+```javascript
+browserify().transform(to5ify.configure({
+  sourceMapRelative: "/Users/sebastian/Projects/my-cool-website/assets"
+}))
+```
+
+```sh
+$ browserify -d -e script.js -t [ 6to5ify --sourceMapRelative . ]
+```
+
+#### Additional options
+
+```javascript
+browserify().transform(to5ify.configure({
+  // Optional ignore regex - if any filenames **do** match this regex then they
+  // aren't compiled
+  ignore: /regex/,
+
+  // Optional only regex - if any filenames **don't** match this regex then they
+  // aren't compiled
+  only: /my_es6_folder/
+}))
+```
+
+```sh
+$ browserify -d -e script.js -t [ 6to5ify --ignore regex --only my_es6_folder ]
+```
+
+#### ES6 Polyfill
+
+As a convenience, the 6to5 polyfill is exposed in 6to5ify. If you've got
+a browserify-only package this may alleviate the necessity to have
+*both* 6to5 & 6to5ify installed.
+
+```javascript
+// In browser code
+require("6to5ify/polyfill");
+```