# babel-plugin-bundled-import-meta

> Babel plugin to rewrite import.meta for bundled usage

Latest version **0.3.2** (published 2019-12-31) · BSD-3-Clause license · 0 weekly downloads

## Install

```sh
npm install babel-plugin-bundled-import-meta
pnpm add babel-plugin-bundled-import-meta
yarn add babel-plugin-bundled-import-meta
bun add babel-plugin-bundled-import-meta
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.3.2 |
| Published | 2019-12-31 |
| First published | 2018-11-03 |
| Weekly downloads | 0 |
| License | BSD-3-Clause |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=8 |
| Dependencies | 2 |
| Unpacked size | 10.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Corey Farrell |
| Maintainers | coreyfarrell |
| Keywords | babel, esm, browser, import.meta.url, rollup |

## Links

- npm: https://www.npmjs.com/package/babel-plugin-bundled-import-meta
- Repository: https://github.com/cfware/babel-plugin-bundled-import-meta
- Homepage: https://github.com/cfware/babel-plugin-bundled-import-meta#readme
- Issues: https://github.com/cfware/babel-plugin-bundled-import-meta/issues
- npm.io page: https://npm.io/package/babel-plugin-bundled-import-meta

## Dependencies (2)

- [@babel/template](https://npm.io/package/@babel/template.md) ^7.7.0
- [@babel/plugin-syntax-import-meta](https://npm.io/package/@babel/plugin-syntax-import-meta.md) ^7.2.0

## Alternatives

- [base64url](https://npm.io/package/base64url.md) — 6.1M weekly downloads
- [get-installed-path](https://npm.io/package/get-installed-path.md) — 502.9K weekly downloads
- [@uppy/url](https://npm.io/package/@uppy/url.md) — 185.8K weekly downloads
- [@d3fc/d3fc-shape](https://npm.io/package/@d3fc/d3fc-shape.md) — 16.2K weekly downloads
- [localizer](https://npm.io/package/localizer.md) — 226 weekly downloads

## Recent versions

- 0.3.2 (latest) — 2019-12-31
- 0.3.1 — 2019-06-07
- 0.3.0 — 2019-03-02
- 0.2.2 — 2019-02-12
- 0.2.1 — 2019-01-08
- 0.2.0 — 2018-11-03
- 0.1.0 — 2018-11-03

## README

# babel-plugin-bundled-import-meta

[![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 import.meta.url for use in bundles.

## Install babel-plugin-bundled-import-meta

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

```sh
npm i babel-plugin-bundled-import-meta
```

## Usage

Add `bundled-import-meta` to `plugins` in your babel settings.

## Settings

```json
{
	"plugins": [
		["bundled-import-meta", {
			"mappings": {
				"node_modules": "/assets"
			},
			"bundleDir": "html"
		}]
	]
}
```

This example will assume that `html/` will directly contain the bundled JavaScript.
`node_modules/` served from `/assets`.  Any use of `import.meta` outside these
two folders will throw an exception.

### bundleDir

If no mappings match it is assumed that `bundleDir` is served from the same directory
as the output bundle.  In the example where bundleDir is set to `html` it is assumed
that assets in `html/components` will be published in `./components` relative to the
bundled JavaScript.

Default `process.cwd()`.

### mappings

This maps source paths to server URL's.  Key's represent local source paths, values
represent base URL which would be used for the unbundled build.  Value URL's can be
relative or absolute.  Relative URL's will be resolved at runtime using the bundle
URL as the base URL.

Default `{}`.

### importStyle

It's necessary to know the full URL of the bundle as loaded by the browser.  The best
way to determine this is different based on what type of bundle will be used.

Supported styles are: `amd`, `cjs`, `esm`, `iife`, `umd`, `system`.  Default `esm`.

The `esm` import style generates `import.meta.url` to detect the bundled URL.  This
is not compatible with webpack so use another method.  If anyone knows of a 'best'
option for use with webpack please open an issue or PR.

When bundling with rollup you should generally use `esm` here.  The only exception is
if rollup is generating an `esm` bundle for targets that do not support
`import.meta.url`.  If you are using `import.meta.url` in your code but must maintain
compatibility with browsers that do not support this it is probably best to have rollup
generate a different bundle format.

## Example

See [rollup-demo] for a mock package showing use of this plugin with rollup.

## 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].

## `babel-plugin-bundled-import-meta` for enterprise

Available as part of the Tidelift Subscription.

The maintainers of `babel-plugin-bundled-import-meta` 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.](https://tidelift.com/subscription/pkg/npm-babel-plugin-bundled-import-meta?utm_source=npm-babel-plugin-bundled-import-meta&utm_medium=referral&utm_campaign=enterprise&utm_term=repo)

[npm-image]: https://img.shields.io/npm/v/babel-plugin-bundled-import-meta.svg
[npm-url]: https://npmjs.org/package/babel-plugin-bundled-import-meta
[travis-image]: https://travis-ci.org/cfware/babel-plugin-bundled-import-meta.svg?branch=master
[travis-url]: https://travis-ci.org/cfware/babel-plugin-bundled-import-meta
[gk-image]: https://badges.greenkeeper.io/cfware/babel-plugin-bundled-import-meta.svg
[downloads-image]: https://img.shields.io/npm/dm/babel-plugin-bundled-import-meta.svg
[downloads-url]: https://npmjs.org/package/babel-plugin-bundled-import-meta
[license-image]: https://img.shields.io/npm/l/babel-plugin-bundled-import-meta.svg
[polymer-build]: https://github.com/Polymer/tools/blob/fdc9e5472674c63435e8188fdc00b342184ce8f3/packages/build/src/babel-plugin-import-meta.ts
[rollup-demo]: https://github.com/cfware/babel-plugin-bundled-import-meta/tree/master/rollup-demo

---
_Source: https://npm.io/package/babel-plugin-bundled-import-meta · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._