Registry / devops / babel-helper-module-transforms

babel-helper-module-transforms

library7.0.0-beta.1jsnpmunverified

Internal Babel helper package providing utility functions for implementing ES6 module transformations, such as converting imports and exports to CommonJS, AMD, or UMD. This package is used by plugins like @babel/plugin-transform-modules-commonjs and @babel/plugin-transform-modules-amd. Version 7.0.0-beta.1 is an early beta; current stable releases follow Babel 7.x line (v7.29.2 as of March 2026) and Babel 8 development on v8.0.0-rc.3. Users should not depend on this package directly; use the respective transform plugins instead. Key differentiator: it centralizes module transformation logic shared across Babel module plugins.

devops

npm install babel-helper-module-transforms

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BABEL-HELPER-MODUL

babel-helper-module-transforms

devopsjavascriptv7.0.0-beta.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import rewriteModuleStatementsAndPrepareHeader from '@babel/helper-module-transforms'

✗ const { rewriteModuleStatementsAndPrepareHeader } = require('@babel/helper-module-transforms')

Default export is a function; named exports exist for other helpers. CJS require works but may not get correct default.

isModule

✓ import { isModule } from '@babel/helper-module-transforms'

✗ import isModule from '@babel/helper-module-transforms'

isModule is a named export, not the default.

rewriteModuleStatementsAndPrepareHeader

✓ import rewriteModuleStatementsAndPrepareHeader from '@babel/helper-module-transforms'

✗ import { rewriteModuleStatementsAndPrepareHeader } from '@babel/helper-module-transforms'

rewriteModuleStatementsAndPrepareHeader is the default export, not a named export.

Shows how to use the default export to rewrite module statements and extract metadata from an AST.

import rewriteModuleStatementsAndPrepareHeader from '@babel/helper-module-transforms'; import traverse from '@babel/traverse'; import { parse } from '@babel/parser'; const code = 'import { foo } from "bar"; export const baz = 1;'; const ast = parse(code, { sourceType: 'module' }); traverse(ast, { Program(path) { const { meta, headers } = rewriteModuleStatementsAndPrepareHeader(path, { exportName: 'module.exports', loose: false, }); console.log('Module meta:', meta); console.log('Module headers:', headers); } });

Debug

Known issues

breakingDefault export changed from a named export to the default export in v7.0.0-beta.1

fix

Use import rewriteModuleStatementsAndPrepareHeader from '@babel/helper-module-transforms' instead of importing a named export.

affects: <7.0.0-beta.1

gotchaThe package is internal; direct imports may break without notice across minor releases.

fix

Prefer using higher-level Babel plugins or @babel/core APIs instead of directly depending on this helper.

affects: *

deprecatedSome helper functions like getModuleName have been deprecated in favor of configuration via @babel/core.

fix

Use the 'moduleId' or 'getModuleId' options in your Babel configuration instead.

affects: >=7.0.0-beta.1

gotchaOnly CommonJS and AMD are supported; no native ESM output.

fix

If you need ESM output, use @babel/preset-env with modules: false or use a bundler like Rollup.

affects: >=7.0.0-beta.1

Errors

Common errors & fixes

TypeError: rewriteModuleStatementsAndPrepareHeader is not a function

Importing as a named export instead of default export.

fix

Change to import rewriteModuleStatementsAndPrepareHeader from '@babel/helper-module-transforms'.

Cannot find module '@babel/helper-module-transforms'

Package not installed; it's a Babel internal dependency.

fix

Ensure you have @babel/core installed, or explicitly install @babel/helper-module-transforms.

Error: Plugin attempted to use a helper that is not available

Version mismatch between Babel packages.

fix

Update all @babel/* packages to the same version.

Upgrade

Version history

7.0.0-beta.1latest on npm

Audit

Dependencies

@babel/typesrequiredUsed for building AST nodes for module declarations and imports/exports.

@babel/templaterequiredUsed for template-based AST construction for module transforms.

@babel/helper-simple-accessoptionalUsed for simple assignment operations in module transformations.

Agent activity

5 hits · last 30 days

node

Resources

githubhttps://github.com/babel/babel ↗

packagehttps://www.npmjs.com/package/babel-helper-module-transforms ↗

homepagehttps://babeljs.io/ ↗