https://github.com/ember-cli/babel-plugin-ember-modules-api-polyfill
Polyfill for Ember JS API
https://github.com/ember-cli/babel-plugin-ember-modules-api-polyfill
babel-plugin ember
Last synced: 6 months ago
JSON representation
Polyfill for Ember JS API
- Host: GitHub
- URL: https://github.com/ember-cli/babel-plugin-ember-modules-api-polyfill
- Owner: ember-cli
- License: mit
- Created: 2017-06-21T02:07:14.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-12-11T07:53:21.000Z (about 3 years ago)
- Last Synced: 2025-07-01T23:29:58.165Z (7 months ago)
- Topics: babel-plugin, ember
- Language: JavaScript
- Homepage:
- Size: 2.57 MB
- Stars: 15
- Watchers: 11
- Forks: 21
- Open Issues: 13
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# babel-plugin-ember-modules-api-polyfill
> This plugin transforms [JavaScript modules API](https://github.com/emberjs/rfcs/blob/master/text/0176-javascript-module-api.md) import statements
> back to the legacy "global" ember object syntax
## Example
```js
import { inject } from "@ember/service"
```
back to the legacy
```js
const inject = Ember.inject.service
```
## Installation
`npm install --save babel-plugin-ember-modules-api-polyfill`
## Why
This plugin provides an API polyfill to allow ember addon authors to adopt the new
[JavaScript modules API](https://github.com/emberjs/rfcs/blob/master/text/0176-javascript-module-api.md) whilst still maintaining backwards
compatibility with older versions of Ember that do not support the new modules API.
The intention of this Babel plugin is to also allow for a transition period and allow applications to exist in a mixed state whilst transitioning
from the old "global" ember object pattern, into the new modular pattern.
# How
Using the [ember-rfc176-data](https://github.com/ember-cli/ember-rfc176-data) package, that contains the official mapping of old global
object names to the new JS modules API import statements, addons that adopt the new API can be transpiled back to the legacy format if Ember-CLI
detects that the host application ember version does not support the new modules API.
The plugin supports both default `import Component from "@ember/component"` and named `import { inject } from "@ember/service"` import statements,
converting their syntax back to separate `const` variables within the source file. This transpilation is done at compile time by Ember CLI.
In order for ember addon developers to adopt this new API syntax, they must declare a dependency on `ember-cli-babel:v6.6.0` or above in their
package.json:
```json
{
"dependencies": {
"ember-cli-babel": "^6.6.0"
}
}
```