{"id":17595,"library":"ember-cli-import-polyfill","title":"Ember CLI Import Polyfill","description":"This package, `ember-cli-import-polyfill`, is an Ember CLI addon designed to backport a newer addon import API (specifically referencing Ember CLI pull request #5877) to earlier versions of Ember CLI. Ember CLI is a foundational command-line utility for managing Ember.js applications, providing a robust build pipeline, project structure conventions, and an extensible addon system. Released at version 0.2.0 and last published approximately eight years ago, this addon addressed compatibility issues during a transition period in Ember CLI's internal architecture. Its purpose was to enable addon authors to leverage newer JavaScript module APIs while maintaining backward compatibility with older host Ember CLI applications that did not natively support these module APIs. Due to its age and the natural evolution of Ember CLI, the functionality it polyfilled is now standard in modern Ember CLI versions, rendering this specific polyfill obsolete.","status":"abandoned","version":"0.2.0","language":"javascript","source_language":"en","source_url":"ssh://git@github.com/ember-cli/ember-cli-import-polyfill","tags":["javascript","ember-addon"],"install":[{"cmd":"npm install ember-cli-import-polyfill","lang":"bash","label":"npm"},{"cmd":"yarn add ember-cli-import-polyfill","lang":"bash","label":"yarn"},{"cmd":"pnpm add ember-cli-import-polyfill","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"This package is an Ember CLI addon and operates within the context of an Ember CLI project, modifying its build process. It implicitly depends on the host project's `ember-cli` version.","package":"ember-cli","optional":false}],"imports":[],"quickstart":{"code":"npx ember install ember-cli-import-polyfill\n\n// Addons are typically installed and then automatically integrated by Ember CLI.\n// No direct JavaScript import statements are typically made by end-user application code for this type of addon.\n// The addon modifies the Ember CLI build pipeline or provides blueprints/components.\n// For more complex polyfills or build modifications, configuration might be added to ember-cli-build.js, e.g.:\n\n// const EmberApp = require('ember-cli/lib/broccoli/ember-app');\n// module.exports = function(defaults) {\n//   let app = new EmberApp(defaults, {\n//     // Example of hypothetical configuration for a polyfill addon\n//     'ember-cli-import-polyfill': {\n//       enabled: true,\n//       // specific options related to its backporting logic\n//     }\n//   });\n//   return app.toTree();\n// };","lang":"javascript","description":"Installs the Ember CLI addon into an existing Ember.js project via the `ember install` command, which handles package installation and blueprint generation."},"warnings":[{"fix":"For modern Ember.js applications (Ember CLI v3.x and above), simply do not install this package. The 'addon import API' it polyfilled is now standard.","message":"This package is very old (last updated 8 years ago, v0.2.0) and targets a specific, outdated pull request (#5877) in Ember CLI. Its functionality is almost certainly integrated into current Ember CLI versions, making it unnecessary and potentially incompatible with modern Ember.js applications.","severity":"deprecated","affected_versions":"<=0.2.0"},{"fix":"Avoid symlinking this addon. If developing locally, ensure it's installed directly from a registry or a local path without symlinks. This limitation highlights its deep integration with the Ember CLI build process.","message":"The README explicitly states, 'This addon doesn't work when symlinked, because it needs implicit access to your ember-cli module.' This can cause issues in development environments where `npm link` or `yarn link` are used for local addon development.","severity":"gotcha","affected_versions":">=0.0.0"},{"fix":"Remove `ember-cli-import-polyfill` from `package.json` and `node_modules`. Ensure your Ember CLI project is updated to a modern version that natively supports contemporary module import mechanisms.","message":"Using this polyfill in newer Ember CLI versions (e.g., 3.x+) could lead to unexpected build failures or runtime errors due to conflicts with native Ember CLI features or module resolution logic. It targets an architectural gap that no longer exists.","severity":"breaking","affected_versions":">=0.3.0 (hypothetical, as this package is abandoned)"}],"env_vars":null,"last_verified":"2026-04-23T00:00:00.000Z","next_check":"2026-07-22T00:00:00.000Z","problems":[{"fix":"Run `npm install ember-cli-import-polyfill` or `yarn add ember-cli-import-polyfill`. If still failing, check for symlink usage and reinstall without symlinks. Ensure `ember-cli` is also correctly installed.","cause":"The package was not correctly installed, or a symlink is breaking its internal resolution within Ember CLI's build process, as noted in the README.","error":"Error: Cannot find module 'ember-cli-import-polyfill'"},{"fix":"This addon is designed for older Ember CLI versions. If you are on a modern Ember CLI, remove `ember-cli-import-polyfill` from your project. If you *must* use an older Ember CLI, ensure its version aligns with the polyfill's expected environment.","cause":"Likely a conflict with a newer Ember CLI version's internal module handling, as this polyfill attempts to modify core import behavior for older versions.","error":"Build failed. The Broccoli Plugin '...' failed with: ... (related to module resolution or addon processing)"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}