babel-plugin-bare-import-rewrite

[![Travis CI][travis-image]][travis-url]
[![Greenkeeper badge][gk-image]](https://greenkeeper.io/)
[![NPM Version][npm-image]][npm-url]
[![NPM Downloads][downloads-image]][downloads-url]
[![BSD-3-Clause][license-image]](LICENSE)

Babel plugin to rewrite bare imports. In theory this will become obsolete if/when
browsers get support for import maps. See [domenic/package-name-maps] for information
about the proposal.

Install babel-plugin-bare-import-rewrite

This module requires node.js 10 or above and @babel/core.

``sh npm i babel-plugin-bare-import-rewrite`

`Usage`

Add bare-import-rewrite to plugins in your babel settings.

`Settings`

`json { "plugins": [ ["bare-import-rewrite", { "modulesDir": "/node_modules", "rootBaseDir": ".", "alwaysRootImport": [], "ignorePrefixes": ["//"], "failOnUnresolved": false, "resolveDirectories": ["node_modules"], "processAtProgramExit": false, "preserveSymlinks": true }] ] }`

If the plugin settings object is omitted the defaults are used:`json { "plugins": ["bare-import-rewrite"] }`

`$3`

The URL path in which files from the node_modulesdirectory will be published on the web server. This must be an absolute URL if provided (with or without hostname). Default undefined.

`$3`

The project base directory. This should contain the package.json and node_modules of the application. Defaultprocess.cwd().

`$3`

This contains a list of module bare names which should always be forced to import from the root node_modules.['**']can be used to specify that all modules should be resolved from the root folder. No attempt is made to verify that overridden modules are compatible. Each element is used as a pattern to be processed withminimatch. Default[].

`$3`

This contains a list of module bare names which should never be forced to imported from the root node_modules. Processed withminimatch. Default [].

This example will force all modules to be loaded from the root node_modules except forsome-exception:`json { "alwaysRootImport": ["**"], "neverRootImport": ["some-exception"] }`

`$3`

By default an error is logged when an import could not be resolved, but it does not fail babel compilation. Setting this option to true will fail babel compilation with details.

`$3`

Array of directories which should be search for resolving modules. If multiple directories are specified they are evaluated in order of importance. If the same module exists in both folders, the leftmost module directory is always taken. Defaults to['node_modules'].

`$3`

Setting this option trueforces use of platform specific path separators. This changes the default value ofmodulesDir to the absolute filesystem path of node_modules. This should generally be used when using absolute filesystem paths for bundling.

`$3`

This option can be set to an array of strings. Each represents a module name prefix to be ignored.

`$3`

A list of extensions to use in resolver. Default ['.mjs', '.js', '.json'].

`$3`

This causes processing to occur during the babel Program.exitvisitor. In general this option is not needed.

`$3`

This is passed to the resolve module. Default true.

`$3`

This function is used internally by the babel plugin, is exposed so it can be used by analyzers to build a list of scripts being imported. ThepluginOptionsargument takes the same values as the babel plugin and uses the same defaults.

`js const {resolve} = require('babel-plugin-bare-import-rewrite');

const importModule = '@polymer/lit-element'; const pluginOptions = { "alwaysRootImport": ["@polymer/*"], }; try { const absPath = resolve(importModule, __filename, pluginOptions); console.log(The requested module ${importModule} is in ${absPath}.); } catch (e) { console.error(Cound not resolve ${importModule}:, e); }`

`Web Server Support`

Some web server software has support for live translation of JavaScript sources. These are meant for using during development and testing, a build step should be used to produce static translated sources for production deployments.

* [fastify-babel] can be used with [fastify] and [fastify-static] * [express-transform-bare-module-specifiers] can be used with [express]

Feel free to open an issue or PR if you know of other node.js servers which can use this babel plugin to perform bare import rewrites.

`Running tests`

Tests are provided by xo and ava.

`sh npm install npm test`

`Attribution`

This module is based on code found in [polymer-build] and [polymer-analyzer].

babel-plugin-bare-import-rewrite `for enterprise`

Available as part of the Tidelift Subscription.

The maintainers of babel-plugin-bare-import-rewrite` and thousands of other packages are working with Tidelift to deliver commercial support and maintenance for the open source dependencies you use to build your applications. Save time, reduce risk, and improve code health, while paying the maintainers of the exact dependencies you use. Learn more.

[npm-image]: https://img.shields.io/npm/v/babel-plugin-bare-import-rewrite.svg
[npm-url]: https://npmjs.org/package/babel-plugin-bare-import-rewrite
[travis-image]: https://travis-ci.org/cfware/babel-plugin-bare-import-rewrite.svg?branch=master
[travis-url]: https://travis-ci.org/cfware/babel-plugin-bare-import-rewrite
[gk-image]: https://badges.greenkeeper.io/cfware/babel-plugin-bare-import-rewrite.svg
[downloads-image]: https://img.shields.io/npm/dm/babel-plugin-bare-import-rewrite.svg
[downloads-url]: https://npmjs.org/package/babel-plugin-bare-import-rewrite
[license-image]: https://img.shields.io/npm/l/babel-plugin-bare-import-rewrite.svg
[domenic/package-name-maps]: https://github.com/domenic/package-name-maps/
[polymer-analyzer]: https://github.com/Polymer/tools/blob/219ab4f3f9f8773e75f8c6181109e8966082b9af/packages/analyzer/src/javascript/resolve-specifier-node.ts
[polymer-build]: https://github.com/Polymer/tools/blob/219ab4f3f9f8773e75f8c6181109e8966082b9af/packages/build/src/babel-plugin-bare-specifiers.ts
[fastify]: https://github.com/fastify/fastify#readme
[fastify-static]: https://github.com/fastify/fastify-static#readme
[fastify-babel]: https://github.com/cfware/fastify-babel#readme
[express]: https://github.com/expressjs/express#readme
[express-transform-bare-module-specifiers]: https://github.com/nodecg/express-transform-bare-module-specifiers#readme

babel-plugin-bare-import-rewrite

Babel plugin to rewrite bare imports. In theory this will become obsolete if/when
browsers get support for import maps. See [domenic/package-name-maps] for information
about the proposal.

Install babel-plugin-bare-import-rewrite

This module requires node.js 10 or above and @babel/core.

``sh npm i babel-plugin-bare-import-rewrite`

`Usage`

Add bare-import-rewrite to plugins in your babel settings.

`Settings`

If the plugin settings object is omitted the defaults are used:`json { "plugins": ["bare-import-rewrite"] }`

`$3`

The URL path in which files from the node_modulesdirectory will be published on the web server. This must be an absolute URL if provided (with or without hostname). Default undefined.

`$3`

The project base directory. This should contain the package.json and node_modules of the application. Defaultprocess.cwd().

`$3`

This contains a list of module bare names which should never be forced to imported from the root node_modules. Processed withminimatch. Default [].

This example will force all modules to be loaded from the root node_modules except forsome-exception:`json { "alwaysRootImport": ["**"], "neverRootImport": ["some-exception"] }`

`$3`

By default an error is logged when an import could not be resolved, but it does not fail babel compilation. Setting this option to true will fail babel compilation with details.

`$3`

This option can be set to an array of strings. Each represents a module name prefix to be ignored.

`$3`

A list of extensions to use in resolver. Default ['.mjs', '.js', '.json'].

`$3`

This causes processing to occur during the babel Program.exitvisitor. In general this option is not needed.

`$3`

This is passed to the resolve module. Default true.

`$3`

`js const {resolve} = require('babel-plugin-bare-import-rewrite');

`Web Server Support`

* [fastify-babel] can be used with [fastify] and [fastify-static] * [express-transform-bare-module-specifiers] can be used with [express]

Feel free to open an issue or PR if you know of other node.js servers which can use this babel plugin to perform bare import rewrites.

`Running tests`

Tests are provided by xo and ava.

`sh npm install npm test`

`Attribution`

This module is based on code found in [polymer-build] and [polymer-analyzer].

babel-plugin-bare-import-rewrite `for enterprise`

Available as part of the Tidelift Subscription.

babel-plugin-bare-import-rewrite

babel-plugin-bare-import-rewrite

Install babel-plugin-bare-import-rewrite

Usage

Settings

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

$3

Web Server Support

Running tests

Attribution