ES6 Module Transpiler

0.10.0 verified Fri May 01 auth: no javascript deprecated

ES6 Module Transpiler (v0.10.0) is an experimental compiler that converts a subset of ES6 module syntax into AMD or CommonJS formats. Maintained by Square with irregular releases, it extends transpilers like Babel to support alternative output formats (AMD, CommonJS, bundle) and includes a CLI. Designed for early ES6 adoption; superseded by Babel and TypeScript for production use. Key differentiator: custom format support and integration with legacy build tools (Grunt, Gulp, Brunch, Broccoli, Mimosa).

Common errors

error Error: Cannot find module 'es6-module-transpiler/lib/formatters/bundle' ↓

cause Incorrect import path for formatter in older versions.

fix

Use: import { BundleFormatter } from 'es6-module-transpiler/lib/formatters/bundle'; (for v0.5.x+)

error TypeError: container.getModule is not a function ↓

cause getModule() method requires a string argument; called without argument or on undefined container.

fix

Ensure container is instantiated with 'new Container({...})' and call getModule('modulename').

Warnings

deprecated Package is no longer maintained; use Babel or TypeScript instead. ↓

fix Migrate to Babel (https://babeljs.io) or TypeScript (https://www.typescriptlang.org) for ES6+ module transpilation.

breaking Formatter imports changed in v0.5.x: formatters are now under 'es6-module-transpiler/lib/formatters/{name}'. ↓

fix Update import path to include '/lib/formatters/' subdirectory.

breaking Container options changed: 'resolvers' now requires an array of resolver instances, not a single object. ↓

fix Wrap single resolver in an array: resolvers: [new FileResolver(...)]

gotcha CommonJS output uses 'module.exports.default' for default exports. Consumers must require that property. ↓

fix Access default export via require('module').default.

Install

npm install es6-module-transpiler

yarn add es6-module-transpiler

pnpm add es6-module-transpiler

Imports

Container
```
import { Container } from 'es6-module-transpiler';
```
ESM import; this package is ESM-only in v0.10.0. For CommonJS, use require().

transpiler (default)

wrong

import { transpiler } from 'es6-module-transpiler';

correct

import transpiler from 'es6-module-transpiler';

Default export is the transpiler object. Named import will fail.

FileResolver

wrong

const FileResolver = require('es6-module-transpiler').FileResolver;

correct

import { FileResolver } from 'es6-module-transpiler';

Both work, but ESM import is preferred for consistency.

Quickstart

Demonstrates using the Container, FileResolver, and BundleFormatter to transpile ES6 modules into a single bundle file.

import { Container, FileResolver } from 'es6-module-transpiler';
import { BundleFormatter } from 'es6-module-transpiler/lib/formatters/bundle';

const container = new Container({
  resolvers: [new FileResolver(['lib/'])],
  formatter: new BundleFormatter()
});

container.getModule('index');
container.write('out/mylib.js');
console.log('Module transpiled successfully.');