@powerlines/plugin-babel 0.1.0

package/dist/helpers/create-plugin.d.ts

@@ -0,0 +1,13 @@
+import { BabelTransformPluginBuilder, DeclareBabelTransformPluginReturn } from 'powerlines/types/babel';
+import { Context } from 'powerlines/types/context';
+
+/**
+ * Create a Babel plugin using the provided builder function.
+ *
+ * @param name - The name of the plugin.
+ * @param builder - The builder function that defines the plugin behavior.
+ * @returns A Babel plugin declaration.
+ */
+declare function createBabelPlugin<TContext extends Context = Context, TOptions extends Record<string, any> = Record<string, any>>(name: string, builder: BabelTransformPluginBuilder<TContext, TOptions>): DeclareBabelTransformPluginReturn<TContext, TOptions>;
+
+export { createBabelPlugin };

package/dist/helpers/create-plugin.js

@@ -0,0 +1,32 @@
+import { __name } from '../chunk-SHUYVCID.js';
+import { declare } from '@babel/helper-plugin-utils';
+import { LogLevelLabel } from '@storm-software/config-tools/types';
+import chalk from 'chalk';
+import { extendLog } from 'powerlines/lib/logger';
+
+function createBabelPlugin(name, builder) {
+  const plugin = /* @__PURE__ */ __name((context) => {
+    return declare((api, options, dirname) => {
+      api.cache.using(() => context.meta.checksum);
+      api.assertVersion("^7.0.0-0");
+      const log = extendLog(context.log, name);
+      log(LogLevelLabel.TRACE, `Initializing the ${chalk.bold.cyanBright(name)} Babel plugin`);
+      const result = builder({
+        log,
+        name,
+        api,
+        options,
+        context,
+        dirname
+      });
+      result.name = name;
+      log(LogLevelLabel.TRACE, `Completed initialization of the ${chalk.bold.cyanBright(name)} Babel plugin`);
+      return result;
+    });
+  }, "plugin");
+  plugin.$$name = name;
+  return plugin;
+}
+__name(createBabelPlugin, "createBabelPlugin");
+
+export { createBabelPlugin };

package/dist/helpers/filters.cjs

@@ -0,0 +1,50 @@
+'use strict';
+
+var chunkUSNT2KNT_cjs = require('../chunk-USNT2KNT.cjs');
+var isFunction = require('@stryke/type-checks/is-function');
+var isObject = require('@stryke/type-checks/is-object');
+var isSetString = require('@stryke/type-checks/is-set-string');
+
+function getPluginName(plugin) {
+  return isSetString.isSetString(plugin) ? plugin : Array.isArray(plugin) && plugin.length > 0 ? getPluginName(plugin[0]) : plugin.$$name || plugin.name ? plugin.$$name || plugin.name : void 0;
+}
+chunkUSNT2KNT_cjs.__name(getPluginName, "getPluginName");
+function isDuplicatePlugin(plugins, plugin) {
+  return !!(getPluginName(plugin) && plugins.some((existing) => Array.isArray(existing) && getPluginName(existing[0]) === getPluginName(plugin)));
+}
+chunkUSNT2KNT_cjs.__name(isDuplicatePlugin, "isDuplicatePlugin");
+function filterPluginByRuntimeId(context, runtimeId) {
+  return (code, id) => !context.fs.isMatchingBuiltinId(runtimeId, id);
+}
+chunkUSNT2KNT_cjs.__name(filterPluginByRuntimeId, "filterPluginByRuntimeId");
+function addPluginFilter(context, pluginOrPlugins, filter, name) {
+  if (!Array.isArray(pluginOrPlugins) || !pluginOrPlugins.some((plugin) => Array.isArray(plugin)) && pluginOrPlugins.length < 4 && pluginOrPlugins.length > 0 && (isSetString.isSetString(pluginOrPlugins[0]) || isFunction.isFunction(pluginOrPlugins[0]) || pluginOrPlugins.length > 1 && isObject.isObject(pluginOrPlugins[1]) || pluginOrPlugins.length > 2 && isObject.isObject(pluginOrPlugins[2]))) {
+    return Array.isArray(pluginOrPlugins) ? [
+      pluginOrPlugins[0],
+      pluginOrPlugins.length > 1 ? pluginOrPlugins[1] : {},
+      {
+        filter: /* @__PURE__ */ chunkUSNT2KNT_cjs.__name((code, id) => filter(code, id) && (pluginOrPlugins.length < 2 || !isFunction.isFunction(pluginOrPlugins[2]) || pluginOrPlugins[2]?.(code, id)), "filter")
+      }
+    ] : [
+      pluginOrPlugins,
+      {},
+      {
+        filter
+      }
+    ];
+  }
+  if (!name) {
+    throw new Error("No name was provided to `addPluginFilter`, could not find babel plugin without it.");
+  }
+  const foundIndex = pluginOrPlugins.findIndex((plugin) => getPluginName(plugin)?.toLowerCase() === name.toLowerCase());
+  if (foundIndex > -1) {
+    pluginOrPlugins[foundIndex] = addPluginFilter(context, pluginOrPlugins[foundIndex], filter, name);
+  }
+  return pluginOrPlugins;
+}
+chunkUSNT2KNT_cjs.__name(addPluginFilter, "addPluginFilter");
+
+exports.addPluginFilter = addPluginFilter;
+exports.filterPluginByRuntimeId = filterPluginByRuntimeId;
+exports.getPluginName = getPluginName;
+exports.isDuplicatePlugin = isDuplicatePlugin;

package/dist/helpers/filters.d.cts

@@ -0,0 +1,41 @@
+import { Context } from 'powerlines/types';
+import { BabelTransformPluginOptions, ResolvedBabelTransformPluginOptions, BabelTransformPluginFilter, BabelTransformPlugin } from 'powerlines/types/babel';
+
+declare function getPluginName(plugin: BabelTransformPluginOptions): string | undefined;
+/**
+ * Check if a Babel plugin is a duplicate of another plugin in the list.
+ *
+ * @param plugins - The list of existing Babel plugins.
+ * @param plugin - The Babel plugin to check for duplicates.
+ * @returns True if the plugin is a duplicate, false otherwise.
+ */
+declare function isDuplicatePlugin(plugins: (ResolvedBabelTransformPluginOptions | undefined)[], plugin: BabelTransformPluginOptions): boolean;
+/**
+ * Filters a Babel plugin by its runtime ID.
+ *
+ * @param context - The context in which the filter is applied.
+ * @param runtimeId - The runtime ID to filter by.
+ * @returns A filter function that checks if a plugin's ID matches the runtime ID.
+ */
+declare function filterPluginByRuntimeId<TContext extends Context = Context>(context: TContext, runtimeId: string): BabelTransformPluginFilter;
+/**
+ * Adds a filter to a Babel plugin or a list of Babel plugins.
+ *
+ * @param context - The context in which the plugin is being added.
+ * @param plugins - The Babel plugins to add the filter to.
+ * @param filter - The filter function to apply to the plugins.
+ * @param name - The name of the plugin to add the filter to.
+ * @returns The updated list of Babel plugins with the filter applied.
+ */
+declare function addPluginFilter(context: Context, plugins: BabelTransformPluginOptions[], filter: BabelTransformPluginFilter | null | undefined, name: string): BabelTransformPluginOptions[];
+/**
+ * Adds a filter to a Babel plugin or a list of Babel plugins.
+ *
+ * @param context - The context in which the plugin is being added.
+ * @param plugin - The Babel plugin to add the filter to.
+ * @param filter - The filter function to apply to the plugin.
+ * @returns The updated Babel plugin with the filter applied.
+ */
+declare function addPluginFilter(context: Context, plugin: BabelTransformPlugin | BabelTransformPluginOptions, filter: NonNullable<BabelTransformPluginFilter>): BabelTransformPluginOptions;
+
+export { addPluginFilter, filterPluginByRuntimeId, getPluginName, isDuplicatePlugin };

package/dist/helpers/filters.d.ts

@@ -0,0 +1,41 @@
+import { Context } from 'powerlines/types';
+import { BabelTransformPluginOptions, ResolvedBabelTransformPluginOptions, BabelTransformPluginFilter, BabelTransformPlugin } from 'powerlines/types/babel';
+
+declare function getPluginName(plugin: BabelTransformPluginOptions): string | undefined;
+/**
+ * Check if a Babel plugin is a duplicate of another plugin in the list.
+ *
+ * @param plugins - The list of existing Babel plugins.
+ * @param plugin - The Babel plugin to check for duplicates.
+ * @returns True if the plugin is a duplicate, false otherwise.
+ */
+declare function isDuplicatePlugin(plugins: (ResolvedBabelTransformPluginOptions | undefined)[], plugin: BabelTransformPluginOptions): boolean;
+/**
+ * Filters a Babel plugin by its runtime ID.
+ *
+ * @param context - The context in which the filter is applied.
+ * @param runtimeId - The runtime ID to filter by.
+ * @returns A filter function that checks if a plugin's ID matches the runtime ID.
+ */
+declare function filterPluginByRuntimeId<TContext extends Context = Context>(context: TContext, runtimeId: string): BabelTransformPluginFilter;
+/**
+ * Adds a filter to a Babel plugin or a list of Babel plugins.
+ *
+ * @param context - The context in which the plugin is being added.
+ * @param plugins - The Babel plugins to add the filter to.
+ * @param filter - The filter function to apply to the plugins.
+ * @param name - The name of the plugin to add the filter to.
+ * @returns The updated list of Babel plugins with the filter applied.
+ */
+declare function addPluginFilter(context: Context, plugins: BabelTransformPluginOptions[], filter: BabelTransformPluginFilter | null | undefined, name: string): BabelTransformPluginOptions[];
+/**
+ * Adds a filter to a Babel plugin or a list of Babel plugins.
+ *
+ * @param context - The context in which the plugin is being added.
+ * @param plugin - The Babel plugin to add the filter to.
+ * @param filter - The filter function to apply to the plugin.
+ * @returns The updated Babel plugin with the filter applied.
+ */
+declare function addPluginFilter(context: Context, plugin: BabelTransformPlugin | BabelTransformPluginOptions, filter: NonNullable<BabelTransformPluginFilter>): BabelTransformPluginOptions;
+
+export { addPluginFilter, filterPluginByRuntimeId, getPluginName, isDuplicatePlugin };

package/dist/helpers/filters.js

@@ -0,0 +1,45 @@
+import { __name } from '../chunk-SHUYVCID.js';
+import { isFunction } from '@stryke/type-checks/is-function';
+import { isObject } from '@stryke/type-checks/is-object';
+import { isSetString } from '@stryke/type-checks/is-set-string';
+
+function getPluginName(plugin) {
+  return isSetString(plugin) ? plugin : Array.isArray(plugin) && plugin.length > 0 ? getPluginName(plugin[0]) : plugin.$$name || plugin.name ? plugin.$$name || plugin.name : void 0;
+}
+__name(getPluginName, "getPluginName");
+function isDuplicatePlugin(plugins, plugin) {
+  return !!(getPluginName(plugin) && plugins.some((existing) => Array.isArray(existing) && getPluginName(existing[0]) === getPluginName(plugin)));
+}
+__name(isDuplicatePlugin, "isDuplicatePlugin");
+function filterPluginByRuntimeId(context, runtimeId) {
+  return (code, id) => !context.fs.isMatchingBuiltinId(runtimeId, id);
+}
+__name(filterPluginByRuntimeId, "filterPluginByRuntimeId");
+function addPluginFilter(context, pluginOrPlugins, filter, name) {
+  if (!Array.isArray(pluginOrPlugins) || !pluginOrPlugins.some((plugin) => Array.isArray(plugin)) && pluginOrPlugins.length < 4 && pluginOrPlugins.length > 0 && (isSetString(pluginOrPlugins[0]) || isFunction(pluginOrPlugins[0]) || pluginOrPlugins.length > 1 && isObject(pluginOrPlugins[1]) || pluginOrPlugins.length > 2 && isObject(pluginOrPlugins[2]))) {
+    return Array.isArray(pluginOrPlugins) ? [
+      pluginOrPlugins[0],
+      pluginOrPlugins.length > 1 ? pluginOrPlugins[1] : {},
+      {
+        filter: /* @__PURE__ */ __name((code, id) => filter(code, id) && (pluginOrPlugins.length < 2 || !isFunction(pluginOrPlugins[2]) || pluginOrPlugins[2]?.(code, id)), "filter")
+      }
+    ] : [
+      pluginOrPlugins,
+      {},
+      {
+        filter
+      }
+    ];
+  }
+  if (!name) {
+    throw new Error("No name was provided to `addPluginFilter`, could not find babel plugin without it.");
+  }
+  const foundIndex = pluginOrPlugins.findIndex((plugin) => getPluginName(plugin)?.toLowerCase() === name.toLowerCase());
+  if (foundIndex > -1) {
+    pluginOrPlugins[foundIndex] = addPluginFilter(context, pluginOrPlugins[foundIndex], filter, name);
+  }
+  return pluginOrPlugins;
+}
+__name(addPluginFilter, "addPluginFilter");
+
+export { addPluginFilter, filterPluginByRuntimeId, getPluginName, isDuplicatePlugin };

package/dist/helpers/index.cjs

@@ -0,0 +1,40 @@
+'use strict';
+
+var astUtils = require('./ast-utils');
+var createPlugin = require('./create-plugin');
+var filters = require('./filters');
+var moduleHelpers = require('./module-helpers');
+var options = require('./options');
+
+
+
+Object.keys(astUtils).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return astUtils[k]; }
+	});
+});
+Object.keys(createPlugin).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return createPlugin[k]; }
+	});
+});
+Object.keys(filters).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return filters[k]; }
+	});
+});
+Object.keys(moduleHelpers).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return moduleHelpers[k]; }
+	});
+});
+Object.keys(options).forEach(function (k) {
+	if (k !== 'default' && !Object.prototype.hasOwnProperty.call(exports, k)) Object.defineProperty(exports, k, {
+		enumerable: true,
+		get: function () { return options[k]; }
+	});
+});

package/dist/helpers/index.d.cts

@@ -0,0 +1,12 @@
+export { GenerateFromAstOptions, generateFromAst, parseAst } from './ast-utils.cjs';
+export { createBabelPlugin } from './create-plugin.cjs';
+export { addPluginFilter, filterPluginByRuntimeId, getPluginName, isDuplicatePlugin } from './filters.cjs';
+export { addImport, addImportsToProgram, findExport, getImport, isImportCall, listExports, listImports } from './module-helpers.cjs';
+export { resolveBabelPlugin, resolvePluginFunction } from './options.cjs';
+export { GeneratorResult } from '@babel/generator';
+import '@babel/parser';
+import '@babel/types';
+import 'powerlines/types/babel';
+import 'powerlines/types/context';
+import 'powerlines/types';
+import '@babel/core';

package/dist/helpers/index.d.ts

@@ -0,0 +1,12 @@
+export { GenerateFromAstOptions, generateFromAst, parseAst } from './ast-utils.js';
+export { createBabelPlugin } from './create-plugin.js';
+export { addPluginFilter, filterPluginByRuntimeId, getPluginName, isDuplicatePlugin } from './filters.js';
+export { addImport, addImportsToProgram, findExport, getImport, isImportCall, listExports, listImports } from './module-helpers.js';
+export { resolveBabelPlugin, resolvePluginFunction } from './options.js';
+export { GeneratorResult } from '@babel/generator';
+import '@babel/parser';
+import '@babel/types';
+import 'powerlines/types/babel';
+import 'powerlines/types/context';
+import 'powerlines/types';
+import '@babel/core';

package/dist/helpers/index.js

@@ -0,0 +1,5 @@
+export * from './ast-utils';
+export * from './create-plugin';
+export * from './filters';
+export * from './module-helpers';
+export * from './options';

package/dist/helpers/module-helpers.cjs

@@ -0,0 +1,123 @@
+'use strict';
+
+var chunkUSNT2KNT_cjs = require('../chunk-USNT2KNT.cjs');
+var t = require('@babel/types');
+var isString = require('@stryke/type-checks/is-string');
+var astUtils = require('./ast-utils');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var t__namespace = /*#__PURE__*/_interopNamespace(t);
+
+function findExport(ast, key) {
+  const type = key === "default" ? "ExportDefaultDeclaration" : "ExportNamedDeclaration";
+  for (const node of ast.program.body) {
+    if (node.type === type) {
+      if (key === "default") {
+        return node.declaration;
+      }
+      if (node.declaration && "declarations" in node.declaration) {
+        const declaration = node.declaration.declarations[0];
+        if (declaration && "name" in declaration.id && declaration.id.name === key) {
+          return declaration.init;
+        }
+      }
+    }
+  }
+}
+chunkUSNT2KNT_cjs.__name(findExport, "findExport");
+function listExports(codeOrAst) {
+  const ast = isString.isString(codeOrAst) ? astUtils.parseAst(codeOrAst) : codeOrAst;
+  return ast.program.body.flatMap((i) => {
+    if (i.type === "ExportDefaultDeclaration") {
+      return [
+        "default"
+      ];
+    }
+    if (i.type === "ExportNamedDeclaration" && i.declaration && "declarations" in i.declaration) {
+      return i.declaration.declarations.map((d) => "name" in d.id ? d.id.name : "");
+    }
+    return [];
+  }).filter(Boolean);
+}
+chunkUSNT2KNT_cjs.__name(listExports, "listExports");
+function listImports(ast) {
+  return ast.program.body.flatMap((i) => {
+    if (i.type === "ImportDeclaration") {
+      return i.specifiers.map((s) => {
+        if (s.type === "ImportDefaultSpecifier") {
+          return "default";
+        }
+        if (s.type === "ImportSpecifier" && "imported" in s) {
+          return s.imported.type === "Identifier" ? s.imported.name : s.imported.value;
+        }
+        return "";
+      });
+    }
+    return [];
+  }).filter(Boolean);
+}
+chunkUSNT2KNT_cjs.__name(listImports, "listImports");
+function isImportCall(calleePath) {
+  return t__namespace.isImport(calleePath.node.callee);
+}
+chunkUSNT2KNT_cjs.__name(isImportCall, "isImportCall");
+function getImport(specifier, name, named) {
+  return t__namespace.importDeclaration([
+    t__namespace.importSpecifier(t__namespace.identifier(name), t__namespace.stringLiteral(named || name))
+  ], t__namespace.stringLiteral(specifier));
+}
+chunkUSNT2KNT_cjs.__name(getImport, "getImport");
+function addImport(path, specifier) {
+  addImportsToProgram(path.scope.getProgramParent().path, specifier);
+}
+chunkUSNT2KNT_cjs.__name(addImport, "addImport");
+function isNonNamespacedImport(importDeclPath) {
+  return importDeclPath.get("specifiers").filter(Boolean).every((specifier) => specifier?.isImportSpecifier()) && importDeclPath.node.importKind !== "type" && importDeclPath.node.importKind !== "typeof";
+}
+chunkUSNT2KNT_cjs.__name(isNonNamespacedImport, "isNonNamespacedImport");
+function getExistingImports(program) {
+  const existingImports = /* @__PURE__ */ new Map();
+  program.traverse({
+    ImportDeclaration(path) {
+      if (isNonNamespacedImport(path)) {
+        existingImports.set(path.node.source.value, path);
+      }
+    }
+  });
+  return existingImports;
+}
+chunkUSNT2KNT_cjs.__name(getExistingImports, "getExistingImports");
+function addImportsToProgram(path, specifier) {
+  const existingImports = getExistingImports(path);
+  if (!existingImports.get(specifier.module)) {
+    path.unshiftContainer("body", t__namespace.importDeclaration([
+      t__namespace.importSpecifier(t__namespace.identifier(specifier.name || specifier.imported), t__namespace.identifier(specifier.imported))
+    ], t__namespace.stringLiteral(specifier.module)));
+  }
+}
+chunkUSNT2KNT_cjs.__name(addImportsToProgram, "addImportsToProgram");
+
+exports.addImport = addImport;
+exports.addImportsToProgram = addImportsToProgram;
+exports.findExport = findExport;
+exports.getImport = getImport;
+exports.isImportCall = isImportCall;
+exports.listExports = listExports;
+exports.listImports = listImports;

package/dist/helpers/module-helpers.d.cts

@@ -0,0 +1,47 @@
+import { NodePath } from '@babel/core';
+import { ParseResult } from '@babel/parser';
+import * as t from '@babel/types';
+import { ImportSpecifier } from 'powerlines/types/babel';
+
+/**
+ * Finds an export in the given Babel AST program by its key.
+ *
+ * @param ast - The parsed Babel AST result containing the program body.
+ * @param key - The name of the export to find (e.g., "default" or a named export).
+ * @returns The declaration of the export if found, otherwise undefined.
+ */
+declare function findExport(ast: ParseResult<t.File>, key: string): any;
+/**
+ * Lists all exports from the given Babel AST program.
+ *
+ * @param codeOrAst - The parsed Babel AST result containing the program body.
+ * @returns An array of export names, including "default" for default exports.
+ */
+declare function listExports(codeOrAst: ParseResult<t.File> | string): string[];
+/**
+ * Lists all imports from the given Babel AST program.
+ *
+ * @param ast - The parsed Babel AST result containing the program body.
+ * @returns An array of import names, including "default" for default imports.
+ */
+declare function listImports(ast: ParseResult<t.File> | t.File): string[];
+declare function isImportCall(calleePath: NodePath<t.CallExpression | t.NewExpression>): boolean;
+/**
+ * Gets the import declaration for a given name and specifier.
+ *
+ * @param specifier - The specifier of the import.
+ * @param name - The name of the import.
+ * @param named - Optional named import.
+ * @returns The import declaration.
+ */
+declare function getImport(specifier: string, name: string, named?: string): t.ImportDeclaration;
+/**
+ * Adds an import to the program if it doesn't already exist.
+ *
+ * @param path - The current NodePath in the AST.
+ * @param specifier - The import specifier.
+ */
+declare function addImport(path: NodePath<any>, specifier: ImportSpecifier): void;
+declare function addImportsToProgram(path: NodePath<t.Program>, specifier: ImportSpecifier): void;
+
+export { addImport, addImportsToProgram, findExport, getImport, isImportCall, listExports, listImports };

package/dist/helpers/module-helpers.d.ts

@@ -0,0 +1,47 @@
+import { NodePath } from '@babel/core';
+import { ParseResult } from '@babel/parser';
+import * as t from '@babel/types';
+import { ImportSpecifier } from 'powerlines/types/babel';
+
+/**
+ * Finds an export in the given Babel AST program by its key.
+ *
+ * @param ast - The parsed Babel AST result containing the program body.
+ * @param key - The name of the export to find (e.g., "default" or a named export).
+ * @returns The declaration of the export if found, otherwise undefined.
+ */
+declare function findExport(ast: ParseResult<t.File>, key: string): any;
+/**
+ * Lists all exports from the given Babel AST program.
+ *
+ * @param codeOrAst - The parsed Babel AST result containing the program body.
+ * @returns An array of export names, including "default" for default exports.
+ */
+declare function listExports(codeOrAst: ParseResult<t.File> | string): string[];
+/**
+ * Lists all imports from the given Babel AST program.
+ *
+ * @param ast - The parsed Babel AST result containing the program body.
+ * @returns An array of import names, including "default" for default imports.
+ */
+declare function listImports(ast: ParseResult<t.File> | t.File): string[];
+declare function isImportCall(calleePath: NodePath<t.CallExpression | t.NewExpression>): boolean;
+/**
+ * Gets the import declaration for a given name and specifier.
+ *
+ * @param specifier - The specifier of the import.
+ * @param name - The name of the import.
+ * @param named - Optional named import.
+ * @returns The import declaration.
+ */
+declare function getImport(specifier: string, name: string, named?: string): t.ImportDeclaration;
+/**
+ * Adds an import to the program if it doesn't already exist.
+ *
+ * @param path - The current NodePath in the AST.
+ * @param specifier - The import specifier.
+ */
+declare function addImport(path: NodePath<any>, specifier: ImportSpecifier): void;
+declare function addImportsToProgram(path: NodePath<t.Program>, specifier: ImportSpecifier): void;
+
+export { addImport, addImportsToProgram, findExport, getImport, isImportCall, listExports, listImports };

package/dist/helpers/module-helpers.js

@@ -0,0 +1,95 @@
+import { __name } from '../chunk-SHUYVCID.js';
+import * as t from '@babel/types';
+import { isString } from '@stryke/type-checks/is-string';
+import { parseAst } from './ast-utils';
+
+function findExport(ast, key) {
+  const type = key === "default" ? "ExportDefaultDeclaration" : "ExportNamedDeclaration";
+  for (const node of ast.program.body) {
+    if (node.type === type) {
+      if (key === "default") {
+        return node.declaration;
+      }
+      if (node.declaration && "declarations" in node.declaration) {
+        const declaration = node.declaration.declarations[0];
+        if (declaration && "name" in declaration.id && declaration.id.name === key) {
+          return declaration.init;
+        }
+      }
+    }
+  }
+}
+__name(findExport, "findExport");
+function listExports(codeOrAst) {
+  const ast = isString(codeOrAst) ? parseAst(codeOrAst) : codeOrAst;
+  return ast.program.body.flatMap((i) => {
+    if (i.type === "ExportDefaultDeclaration") {
+      return [
+        "default"
+      ];
+    }
+    if (i.type === "ExportNamedDeclaration" && i.declaration && "declarations" in i.declaration) {
+      return i.declaration.declarations.map((d) => "name" in d.id ? d.id.name : "");
+    }
+    return [];
+  }).filter(Boolean);
+}
+__name(listExports, "listExports");
+function listImports(ast) {
+  return ast.program.body.flatMap((i) => {
+    if (i.type === "ImportDeclaration") {
+      return i.specifiers.map((s) => {
+        if (s.type === "ImportDefaultSpecifier") {
+          return "default";
+        }
+        if (s.type === "ImportSpecifier" && "imported" in s) {
+          return s.imported.type === "Identifier" ? s.imported.name : s.imported.value;
+        }
+        return "";
+      });
+    }
+    return [];
+  }).filter(Boolean);
+}
+__name(listImports, "listImports");
+function isImportCall(calleePath) {
+  return t.isImport(calleePath.node.callee);
+}
+__name(isImportCall, "isImportCall");
+function getImport(specifier, name, named) {
+  return t.importDeclaration([
+    t.importSpecifier(t.identifier(name), t.stringLiteral(named || name))
+  ], t.stringLiteral(specifier));
+}
+__name(getImport, "getImport");
+function addImport(path, specifier) {
+  addImportsToProgram(path.scope.getProgramParent().path, specifier);
+}
+__name(addImport, "addImport");
+function isNonNamespacedImport(importDeclPath) {
+  return importDeclPath.get("specifiers").filter(Boolean).every((specifier) => specifier?.isImportSpecifier()) && importDeclPath.node.importKind !== "type" && importDeclPath.node.importKind !== "typeof";
+}
+__name(isNonNamespacedImport, "isNonNamespacedImport");
+function getExistingImports(program) {
+  const existingImports = /* @__PURE__ */ new Map();
+  program.traverse({
+    ImportDeclaration(path) {
+      if (isNonNamespacedImport(path)) {
+        existingImports.set(path.node.source.value, path);
+      }
+    }
+  });
+  return existingImports;
+}
+__name(getExistingImports, "getExistingImports");
+function addImportsToProgram(path, specifier) {
+  const existingImports = getExistingImports(path);
+  if (!existingImports.get(specifier.module)) {
+    path.unshiftContainer("body", t.importDeclaration([
+      t.importSpecifier(t.identifier(specifier.name || specifier.imported), t.identifier(specifier.imported))
+    ], t.stringLiteral(specifier.module)));
+  }
+}
+__name(addImportsToProgram, "addImportsToProgram");
+
+export { addImport, addImportsToProgram, findExport, getImport, isImportCall, listExports, listImports };

package/dist/helpers/options.cjs

@@ -0,0 +1,46 @@
+'use strict';
+
+var chunkUSNT2KNT_cjs = require('../chunk-USNT2KNT.cjs');
+var types = require('@storm-software/config-tools/types');
+var isFunction = require('@stryke/type-checks/is-function');
+var chalk = require('chalk');
+var filters = require('./filters');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var chalk__default = /*#__PURE__*/_interopDefault(chalk);
+
+function resolvePluginFunction(context, plugin) {
+  try {
+    return Array.isArray(plugin) && plugin.length > 0 && plugin[0] ? isFunction.isFunction(plugin[0]) ? plugin[0](context) : plugin[0] : isFunction.isFunction(plugin) ? plugin(context) : plugin;
+  } catch {
+    return plugin[0];
+  }
+}
+chunkUSNT2KNT_cjs.__name(resolvePluginFunction, "resolvePluginFunction");
+function resolveBabelPlugin(context, code, id, plugin) {
+  if (Array.isArray(plugin) && plugin.length > 0 && plugin[0]) {
+    if (plugin.length > 2 && plugin[2] && isFunction.isFunction(plugin[2]) && !plugin[2](code, id)) {
+      context.log(types.LogLevelLabel.TRACE, `Skipping filtered Babel plugin ${chalk__default.default.bold.cyanBright(filters.getPluginName(plugin) || "unnamed")} for ${id}`);
+      return void 0;
+    }
+    return plugin.length > 2 ? [
+      resolvePluginFunction(context, plugin),
+      plugin[1],
+      plugin[2]
+    ] : [
+      resolvePluginFunction(context, plugin),
+      plugin[1],
+      null
+    ];
+  }
+  return [
+    resolvePluginFunction(context, plugin),
+    {},
+    null
+  ];
+}
+chunkUSNT2KNT_cjs.__name(resolveBabelPlugin, "resolveBabelPlugin");
+
+exports.resolveBabelPlugin = resolveBabelPlugin;
+exports.resolvePluginFunction = resolvePluginFunction;