Babel Runtime Transform: A Minimal Architecture for Shared Helpers

The Problem: Duplicate Helpers in Every Module

When Babel transpiles ES6+ features like async/await, generators, or spread operators, it injects helper functions directly into each transformed module. This creates duplicate code across your bundle—identical helper functions repeated wherever they're needed.

Requirements for a Better Solution

• Eliminate duplicate helper code without changing application behavior
• Maintain compatibility with Babel 7+ and modern bundlers
• Support tree-shaking so unused helpers don't ship to production
• Require minimal configuration to adopt

The Smallest Suitable Design: @babel/plugin-transform-runtime

The solution is a single plugin that externalizes helpers to @babel/runtime. Instead of embedding helpers in each file, the plugin rewrites them to import from a shared location:

// Before (without plugin):
var _asyncToGenerator = require("babel-runtime/helpers/asyncToGenerator");
var _spreadToArray = require("babel-runtime/helpers/spreadToArray");

function _asyncToGeneratorGenerator() { /* ... */ }

// After (with plugin):
var _asyncToGenerator = _require("babel-runtime/helpers/asyncToGenerator");
var _spreadToArray = _require("babel-runtime/helpers/spreadToArray");
// No function definitions—helpers loaded once from package

Trust and Data Boundaries

Trust boundary: The plugin trusts that @babel/runtime is available and correctly versioned. This is enforced through package.json dependencies.

Data flow: Source code → Babel transform → Import statements → Bundler resolves to @babel/runtime package → Tree-shaker removes unused helpers.

Operational Checks

Run these checks after configuration:

1. Verify installation:

   npm install @babel/plugin-transform-runtime @babel/runtime --save-dev

   Check that both packages appear in package.json.
2. Confirm plugin is active:

   npm run build -- --config .babelrc.js

   Examine output for externalized helpers (imports, not definitions).
3. Test tree-shaking: Build for production and verify unused helpers are excluded from the final bundle.

Configuration Example

{
  "presets": ["@babel/preset-env"],
  "plugins": [
    ["@babel/plugin-transform-runtime", {
      "corejs": 3,
      "regenerator": true
    }]
  ]
}