https://github.com/sandydoo/ember-cli-es6-transform

Import ES6 modules from npm, bower or anywhere else in your app.
https://github.com/sandydoo/ember-cli-es6-transform

ember-addon ember-cli es6-modules import node-module npm transform

Last synced: 3 months ago
JSON representation

Import ES6 modules from npm, bower or anywhere else in your app.

• Host: GitHub
• URL: https://github.com/sandydoo/ember-cli-es6-transform
• Owner: sandydoo
• License: mit
• Archived: true
• Created: 2017-12-24T04:49:21.000Z (almost 7 years ago)
• Default Branch: master
• Last Pushed: 2022-04-10T08:26:45.000Z (over 2 years ago)
• Last Synced: 2024-07-05T16:35:49.768Z (4 months ago)
• Topics: ember-addon, ember-cli, es6-modules, import, node-module, npm, transform
• Language: JavaScript
• Size: 161 KB
• Stars: 14
• Watchers: 3
• Forks: 7
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

• awesome-ember - ember-cli-es6-transform - Import ES6 modules from npm, bower or anywhere else in your app. (Packages / Include external JS code)

README

        
# Try using [ember-auto-import](https://github.com/ef4/ember-auto-import) before this addon.

# ⚙️ ember-cli-es6-transform

[![Build Status](https://travis-ci.org/sandydoo/ember-cli-es6-transform.svg?branch=master)](https://travis-ci.org/sandydoo/ember-cli-es6-transform)

> Import ES6 modules from npm, bower or anywhere else in your Ember app.

##### Table of contents

[Requirements](#requirements)  

[Why](#why)  

[Installation](#installation)  

[Usage](#usage)  

## Requirements

`[email protected]` and greater.

For older versions of `ember-cli`, use the `0.0.*` versions of this addon.

## Why

Ember currently lacks official support for importing and transpiling external ES6 modules.

`[email protected]` introduced the ability to import files from `node_modules`. `[email protected]` then gave us the ability to register and apply custom `importTransforms` to our imports. Currently, anything imported using `app.import` bypasses the Babel pipeline and is inserted into the final `vendor.js` verbatim. If your desired dependency is a ✨shiny new ES6 module, the import will break your app. This addon leverages both concepts to pass your dependency through `ember-cli-babel`.

## Installation

`ember install ember-cli-es6-transform`

## Usage

#### Importing a single (file) dependency

Define the transformation when importing the ES6 module in your `ember-cli-build.js`. The syntax is the same as the built-in `amd` transform.

Remember that `app.import` only works one file at a time!

Options:

* `as` – (**required**) specify the module name.

```js

// Importing spin.js as spin.js

app.import('node_modules/spin.js/spin.js', {

  using: [

    { transformation: 'es6', as: 'spin.js' }

  ]

});

```

In your app, you can then import the module using the name you specified in `as`.

```js

import { Spinner } from 'spin.js';

```

## Contributing

### Installation

* `git clone ` this repository

* `cd ember-cli-es6-transform`

* `yarn install`

### Running Tests

* `yarn test`