The @babel/helper-plugin-utils package is designed to simplify the creation and management of Babel plugins. It provides utility functions that help in validating and constructing Babel plugins with the correct structure and options. This package is particularly useful for developers working on custom Babel plugins, as it abstracts away some of the boilerplate code required for plugin development.

What are @babel/helper-plugin-utils's main functionalities?

Creating a simple Babel plugin

This code sample demonstrates how to use the `declare` function from @babel/helper-plugin-utils to create a simple Babel plugin. The `declare` function takes a callback that receives the Babel API, plugin options, and the directory name. Inside the callback, you can define your plugin logic under the `visitor` object, targeting specific types of AST nodes.

const { declare } = require('@babel/helper-plugin-utils');

const myPlugin = declare((api, options, dirname) => {
  api.assertVersion(7);

  return {
    visitor: {
      Identifier(path) {
        // Plugin logic goes here
      }
    }
  };
});

module.exports = myPlugin;

Other packages similar to @babel/helper-plugin-utils

Changelog

Source

v7.24.0 (2024-02-28)

:rocket: New Feature

babel-standalone
- #11696 Export babel tooling packages in @babel/standalone (@ajihyf)
babel-core, babel-helper-create-class-features-plugin, babel-helpers, babel-plugin-transform-class-properties
- #16267 Implement noUninitializedPrivateFieldAccess assumption (@nicolo-ribaudo)
babel-helper-create-class-features-plugin, babel-helpers, babel-plugin-proposal-decorators, babel-plugin-proposal-pipeline-operator, babel-plugin-syntax-decorators, babel-plugin-transform-class-properties, babel-runtime-corejs2, babel-runtime-corejs3, babel-runtime
- #16242 Support decorator 2023-11 normative updates (@JLHwung)
babel-preset-flow
- #16309 [babel 7] Allow setting ignoreExtensions in Flow preset (@nicolo-ribaudo)
- #16284 Add experimental_useHermesParser option in preset-flow (@liuxingbaoyu)
babel-helper-import-to-platform-api, babel-plugin-proposal-import-wasm-source, babel-plugin-proposal-json-modules, babel-standalone
- #16172 Add transform support for JSON modules imports (@nicolo-ribaudo)
babel-plugin-transform-runtime
- #16241 Add back moduleName option to @babel/plugin-transform-runtime (@nicolo-ribaudo)
babel-parser, babel-types
- #16277 Allow import attributes for TSImportType (@sosukesuzuki)

:bug: Bug Fix

babel-plugin-proposal-do-expressions, babel-traverse
- #16305 fix: avoid popContext on unvisited node paths (@JLHwung)
babel-helper-create-class-features-plugin, babel-plugin-transform-private-methods, babel-plugin-transform-private-property-in-object
- #16312 Fix class private properties when privateFieldsAsSymbols (@liuxingbaoyu)
babel-helper-create-class-features-plugin, babel-plugin-transform-private-methods
- #16307 Fix the support of arguments in private get/set method (@liuxingbaoyu)
babel-helper-create-class-features-plugin, babel-helpers, babel-plugin-proposal-decorators
- #16287 Reduce decorator static property size (@liuxingbaoyu)
babel-helper-create-class-features-plugin, babel-plugin-proposal-decorators
- #16281 Fix evaluation order of decorators with cached receiver (@nicolo-ribaudo)
- #16279 Fix decorator this memoization (@JLHwung)
- #16266 Preserve static on decorated private accessor (@nicolo-ribaudo)
- #16258 fix: handle decorated async private method and generator (@JLHwung)
babel-helper-create-class-features-plugin, babel-plugin-proposal-decorators, babel-plugin-transform-async-generator-functions, babel-plugin-transform-private-methods, babel-plugin-transform-private-property-in-object, babel-plugin-transform-typescript, babel-preset-env
- #16275 Fix class private properties when privateFieldsAsProperties (@liuxingbaoyu)
babel-helpers
- #16268 Do not consider arguments in a helper as a global reference (@nicolo-ribaudo)
babel-helpers, babel-plugin-proposal-decorators
- #16270 Handle symbol key class elements decoration (@JLHwung)
- #16265 Do not define access.get for public setter decorators (@nicolo-ribaudo)

:nail_care: Polish

babel-core, babel-helper-create-class-features-plugin, babel-preset-env
- #12428 Suggest using BABEL_SHOW_CONFIG_FOR for config problems (@nicolo-ribaudo)

:house: Internal

babel-helper-transform-fixture-test-runner
- #16278 Continue writing output.js when exec.js throws (@liuxingbaoyu)

:microscope: Output optimization

babel-helper-create-class-features-plugin, babel-plugin-proposal-decorators
- #16306 Avoid intermediate functions for private accessors with decs (@nicolo-ribaudo)
babel-helper-create-class-features-plugin, babel-helpers, babel-plugin-proposal-decorators, babel-plugin-proposal-pipeline-operator, babel-plugin-transform-class-properties
- #16294 More aggressively inline decorators in the static block (@nicolo-ribaudo)
babel-helper-create-class-features-plugin, babel-helpers, babel-plugin-transform-private-methods
- #16283 Do not use classPrivateMethodGet (@liuxingbaoyu)
babel-helper-create-class-features-plugin, babel-helpers, babel-plugin-proposal-decorators
- #16287 Reduce decorator static property size (@liuxingbaoyu)
babel-helper-create-class-features-plugin, babel-plugin-proposal-decorators, babel-plugin-transform-class-properties
- #16280 Reduce element decorator temp variables (@JLHwung)
babel-helper-create-class-features-plugin, babel-helper-fixtures, babel-helpers, babel-plugin-bugfix-v8-spread-parameters-in-optional-chaining, babel-plugin-proposal-decorators, babel-plugin-proposal-destructuring-private, babel-plugin-proposal-optional-chaining-assign, babel-plugin-transform-class-properties, babel-plugin-transform-class-static-block, babel-plugin-transform-private-methods, babel-plugin-transform-private-property-in-object, babel-preset-env, babel-runtime-corejs2, babel-runtime-corejs3, babel-runtime
- #16261 Do not use descriptors for private class elements (@nicolo-ribaudo)
babel-helpers, babel-plugin-proposal-decorators
- #16263 Reduce helper size for decorator 2023-11 (@liuxingbaoyu)

Readme

Source