@powerlines/plugin-nodejs 0.1.0 → 0.1.1

package/dist/plugin-automd/src/index.cjs

@@ -0,0 +1,101 @@
+const require_rolldown_runtime = require('../../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_fs_is_file = require("@stryke/fs/is-file");
+let __stryke_fs_list_files = require("@stryke/fs/list-files");
+let __stryke_path_append = require("@stryke/path/append");
+let __stryke_path_is_type = require("@stryke/path/is-type");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let automd = require("automd");
+let c12 = require("c12");
+let markdown_toc = require("markdown-toc");
+markdown_toc = require_rolldown_runtime.__toESM(markdown_toc);
+
+//#region ../plugin-automd/src/index.ts
+/**
+* AutoMD Plugin
+*
+* @remarks
+* A Powerlines plugin to use the AutoMD markdown transformer during the prepare task.
+*
+* @see https://automd.unjs.io/
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "automd",
+		async config() {
+			const config = await (0, automd.loadConfig)((0, __stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.projectRoot), options);
+			if (!config.prefix || !Array.isArray(config.prefix)) config.prefix = (0, __stryke_convert_to_array.toArray)(config.prefix ?? []);
+			if (!config.prefix.includes("automd")) config.prefix.push("automd");
+			if (!config.prefix.includes("powerlines")) config.prefix.push("powerlines");
+			return { automd: (0, defu.default)(config ?? {}, {
+				configFile: options.configFile,
+				allowIssues: true,
+				dir: this.config.projectRoot,
+				watch: false,
+				input: "README.md",
+				toc: {
+					maxDepth: 6,
+					bullets: "-"
+				}
+			}) };
+		},
+		async configResolved() {
+			if (this.config.framework && !(0, __stryke_convert_to_array.toArray)(this.config.automd.prefix).includes(this.config.framework)) this.config.automd.prefix = (0, __stryke_convert_to_array.toArray)(this.config.automd.prefix).concat(this.config.framework);
+			if (this.config.automd.configFile) {
+				const { config } = await (0, c12.loadConfig)({
+					cwd: this.config.automd.dir,
+					configFile: this.config.automd.configFile,
+					defaults: {
+						ignore: [
+							"**/node_modules",
+							"**/dist",
+							"**/.*"
+						],
+						dir: this.config.automd.dir
+					}
+				});
+				this.config.automd = (0, automd.resolveConfig)((0, defu.default)(this.config.automd, {
+					...config,
+					prefix: (0, __stryke_convert_to_array.toArray)(config.prefix ?? [])
+				}));
+			}
+			this.config.automd.input = (await Promise.all((0, __stryke_convert_to_array.toArray)(this.config.automd.input).map(async (input) => {
+				if (input.includes("*")) return (0, __stryke_fs_list_files.listFiles)((0, __stryke_path_is_type.isAbsolutePath)(input) ? input : (0, __stryke_path_append.appendPath)(input, this.config.projectRoot), { ignore: this.config.automd.ignore });
+				return (0, __stryke_path_is_type.isAbsolutePath)(input) ? input : (0, __stryke_path_append.appendPath)(input, this.config.projectRoot);
+			}))).flat();
+			if (this.config.automd.output && !(0, __stryke_path_is_type.isAbsolutePath)(this.config.automd.output)) this.config.automd.output = (0, __stryke_path_append.appendPath)(this.config.automd.output, this.config.projectRoot);
+			this.config.automd.generators ??= {};
+			if (this.config.automd.toc !== false) this.config.automd.generators.toc ??= {
+				name: "toc",
+				generate: (ctx) => {
+					const opts = this.config.automd.toc ?? {};
+					return { contents: (0, markdown_toc.default)(ctx.block.md, {
+						...opts,
+						maxdepth: opts.maxDepth,
+						first1: opts.firstH1
+					}).content };
+				}
+			};
+		},
+		async docs() {
+			await Promise.all((0, __stryke_convert_to_array.toArray)(this.config.automd.input).map(async (input) => {
+				const contents = await this.fs.read(input);
+				if (contents) {
+					const result = await (0, automd.transform)(contents, this.config.automd);
+					if (result.hasIssues && this.config.automd.allowIssues === false) throw new Error(`AutoMD found issues in file "${input}". Please resolve the issues or set \`allowIssues\` to true in the plugin configuration to ignore them.`);
+					if (result.hasChanged) await this.fs.write((0, __stryke_path_append.appendPath)(this.config.automd.output ? (0, __stryke_fs_is_file.isDirectory)(this.config.automd.output) ? (0, __stryke_path_replace.replacePath)(input, this.config.automd.output) : this.config.automd.output : input, this.config.projectRoot), result.contents);
+				}
+			}));
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.default = src_default;

package/dist/plugin-automd/src/index.mjs

@@ -0,0 +1,98 @@
+import defu from "defu";
+import { replacePath } from "@stryke/path/replace";
+import { toArray } from "@stryke/convert/to-array";
+import { isDirectory } from "@stryke/fs/is-file";
+import { listFiles } from "@stryke/fs/list-files";
+import { appendPath } from "@stryke/path/append";
+import { isAbsolutePath } from "@stryke/path/is-type";
+import { joinPaths } from "@stryke/path/join-paths";
+import { loadConfig, resolveConfig, transform } from "automd";
+import { loadConfig as loadConfig$1 } from "c12";
+import toc from "markdown-toc";
+
+//#region ../plugin-automd/src/index.ts
+/**
+* AutoMD Plugin
+*
+* @remarks
+* A Powerlines plugin to use the AutoMD markdown transformer during the prepare task.
+*
+* @see https://automd.unjs.io/
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "automd",
+		async config() {
+			const config = await loadConfig(joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot), options);
+			if (!config.prefix || !Array.isArray(config.prefix)) config.prefix = toArray(config.prefix ?? []);
+			if (!config.prefix.includes("automd")) config.prefix.push("automd");
+			if (!config.prefix.includes("powerlines")) config.prefix.push("powerlines");
+			return { automd: defu(config ?? {}, {
+				configFile: options.configFile,
+				allowIssues: true,
+				dir: this.config.projectRoot,
+				watch: false,
+				input: "README.md",
+				toc: {
+					maxDepth: 6,
+					bullets: "-"
+				}
+			}) };
+		},
+		async configResolved() {
+			if (this.config.framework && !toArray(this.config.automd.prefix).includes(this.config.framework)) this.config.automd.prefix = toArray(this.config.automd.prefix).concat(this.config.framework);
+			if (this.config.automd.configFile) {
+				const { config } = await loadConfig$1({
+					cwd: this.config.automd.dir,
+					configFile: this.config.automd.configFile,
+					defaults: {
+						ignore: [
+							"**/node_modules",
+							"**/dist",
+							"**/.*"
+						],
+						dir: this.config.automd.dir
+					}
+				});
+				this.config.automd = resolveConfig(defu(this.config.automd, {
+					...config,
+					prefix: toArray(config.prefix ?? [])
+				}));
+			}
+			this.config.automd.input = (await Promise.all(toArray(this.config.automd.input).map(async (input) => {
+				if (input.includes("*")) return listFiles(isAbsolutePath(input) ? input : appendPath(input, this.config.projectRoot), { ignore: this.config.automd.ignore });
+				return isAbsolutePath(input) ? input : appendPath(input, this.config.projectRoot);
+			}))).flat();
+			if (this.config.automd.output && !isAbsolutePath(this.config.automd.output)) this.config.automd.output = appendPath(this.config.automd.output, this.config.projectRoot);
+			this.config.automd.generators ??= {};
+			if (this.config.automd.toc !== false) this.config.automd.generators.toc ??= {
+				name: "toc",
+				generate: (ctx) => {
+					const opts = this.config.automd.toc ?? {};
+					return { contents: toc(ctx.block.md, {
+						...opts,
+						maxdepth: opts.maxDepth,
+						first1: opts.firstH1
+					}).content };
+				}
+			};
+		},
+		async docs() {
+			await Promise.all(toArray(this.config.automd.input).map(async (input) => {
+				const contents = await this.fs.read(input);
+				if (contents) {
+					const result = await transform(contents, this.config.automd);
+					if (result.hasIssues && this.config.automd.allowIssues === false) throw new Error(`AutoMD found issues in file "${input}". Please resolve the issues or set \`allowIssues\` to true in the plugin configuration to ignore them.`);
+					if (result.hasChanged) await this.fs.write(appendPath(this.config.automd.output ? isDirectory(this.config.automd.output) ? replacePath(input, this.config.automd.output) : this.config.automd.output : input, this.config.projectRoot), result.contents);
+				}
+			}));
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { src_default as default };

package/dist/plugin-automd/src/types/plugin.d.cts

@@ -0,0 +1,38 @@
+import { TOCOptions } from "./toc.cjs";
+import { Config } from "automd";
+
+//#region ../plugin-automd/src/types/plugin.d.ts
+
+type AutoMDPluginOptions = Omit<Config, "dir" | "watch" | "onWatch" | "prefix"> & {
+  /**
+   * Path to the AutoMD configuration file.
+   *
+   * @remarks
+   * If not provided, the plugin will use the default AutoMD configuration resolution mechanism.
+   */
+  configFile?: string;
+  /**
+   * An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.
+   *
+   * @defaultValue true
+   */
+  allowIssues?: boolean;
+  /**
+   * Alternate prefix strings to use for finding generators
+   *
+   * @remarks
+   * By default, AutoMD looks for generators with the "automd" prefix, so that any `<!-- automd:generator [...args] --> ... <!-- /automd -->` comments will be picked up. If you want to use different prefixes (for example, to avoid conflicts with other tools), you would provide a value like "myPrefix" and AutoMD would also look for `<!-- myPrefix:generator [...args] --> ... <!-- /myPrefix -->` comments.
+   *
+   * @defaultValue ["automd", "powerlines", "\{framework\}"]
+   */
+  prefix?: string | string[];
+  /**
+   * Table of Contents generator options
+   *
+   * @remarks
+   * If set to `false`, the built-in Table of Contents generator will be disabled.
+   */
+  toc?: false | TOCOptions;
+};
+//#endregion
+export { AutoMDPluginOptions };

package/dist/plugin-automd/src/types/plugin.d.mts

@@ -0,0 +1,40 @@
+import "../../../powerlines/src/types/context.mjs";
+import "../../../powerlines/src/types/config.mjs";
+import "../../../powerlines/src/types/resolved.mjs";
+import { TOCOptions } from "./toc.mjs";
+import { Config } from "automd";
+
+//#region ../plugin-automd/src/types/plugin.d.ts
+type AutoMDPluginOptions = Omit<Config, "dir" | "watch" | "onWatch" | "prefix"> & {
+  /**
+   * Path to the AutoMD configuration file.
+   *
+   * @remarks
+   * If not provided, the plugin will use the default AutoMD configuration resolution mechanism.
+   */
+  configFile?: string;
+  /**
+   * An indicator specifying whether or not issues found by AutoMD during the prepare task are considered fatal.
+   *
+   * @defaultValue true
+   */
+  allowIssues?: boolean;
+  /**
+   * Alternate prefix strings to use for finding generators
+   *
+   * @remarks
+   * By default, AutoMD looks for generators with the "automd" prefix, so that any `<!-- automd:generator [...args] --> ... <!-- /automd -->` comments will be picked up. If you want to use different prefixes (for example, to avoid conflicts with other tools), you would provide a value like "myPrefix" and AutoMD would also look for `<!-- myPrefix:generator [...args] --> ... <!-- /myPrefix -->` comments.
+   *
+   * @defaultValue ["automd", "powerlines", "\{framework\}"]
+   */
+  prefix?: string | string[];
+  /**
+   * Table of Contents generator options
+   *
+   * @remarks
+   * If set to `false`, the built-in Table of Contents generator will be disabled.
+   */
+  toc?: false | TOCOptions;
+};
+//#endregion
+export { AutoMDPluginOptions };

package/dist/plugin-automd/src/types/toc.d.cts

@@ -0,0 +1,33 @@
+//#region ../plugin-automd/src/types/toc.d.ts
+interface TOCOptions {
+  /**
+   * A slugify function to generate slugs for the headings.
+   */
+  slugify?: (str: string) => string;
+  /**
+   * The maximum depth of headings to include in the TOC.
+   *
+   * @defaultValue 6
+   */
+  maxDepth?: number;
+  /**
+   * Whether to include the first H1 heading in the TOC.
+   */
+  firstH1?: boolean;
+  /**
+   * The bullet character to use for list items in the TOC.
+   *
+   * @defaultValue "-"
+   */
+  bullets?: string;
+  /**
+   * A prefix to add to each heading in the TOC.
+   */
+  prefix?: string;
+  /**
+   * A filter function to determine which headings to include in the TOC.
+   */
+  filter?: (str: string, level: number) => boolean;
+}
+//#endregion
+export { TOCOptions };

package/dist/plugin-automd/src/types/toc.d.mts

@@ -0,0 +1,33 @@
+//#region ../plugin-automd/src/types/toc.d.ts
+interface TOCOptions {
+  /**
+   * A slugify function to generate slugs for the headings.
+   */
+  slugify?: (str: string) => string;
+  /**
+   * The maximum depth of headings to include in the TOC.
+   *
+   * @defaultValue 6
+   */
+  maxDepth?: number;
+  /**
+   * Whether to include the first H1 heading in the TOC.
+   */
+  firstH1?: boolean;
+  /**
+   * The bullet character to use for list items in the TOC.
+   *
+   * @defaultValue "-"
+   */
+  bullets?: string;
+  /**
+   * A prefix to add to each heading in the TOC.
+   */
+  prefix?: string;
+  /**
+   * A filter function to determine which headings to include in the TOC.
+   */
+  filter?: (str: string, level: number) => boolean;
+}
+//#endregion
+export { TOCOptions };

package/dist/plugin-babel/src/helpers/ast-utils.cjs

@@ -0,0 +1,10 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __babel_generator = require("@babel/generator");
+__babel_generator = require_rolldown_runtime.__toESM(__babel_generator);
+require("@babel/parser");
+
+//#region ../plugin-babel/src/helpers/ast-utils.ts
+let generate = __babel_generator.default;
+if ("default" in generate) generate = generate.default;
+
+//#endregion

package/dist/plugin-babel/src/helpers/ast-utils.mjs

@@ -0,0 +1,9 @@
+import _generate from "@babel/generator";
+import "@babel/parser";
+
+//#region ../plugin-babel/src/helpers/ast-utils.ts
+let generate = _generate;
+if ("default" in generate) generate = generate.default;
+
+//#endregion
+export {  };

package/dist/plugin-babel/src/helpers/create-plugin.cjs

@@ -0,0 +1,41 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_logger = require('../../../powerlines/src/lib/logger.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+let __babel_helper_plugin_utils = require("@babel/helper-plugin-utils");
+
+//#region ../plugin-babel/src/helpers/create-plugin.ts
+/**
+* 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.
+*/
+function createBabelPlugin(name, builder) {
+	const plugin = (context) => {
+		return (0, __babel_helper_plugin_utils.declare)((api, options, dirname) => {
+			api.cache.using(() => context.meta.checksum);
+			api.assertVersion("^7.0.0-0");
+			const log = require_logger.extendLog(context.log, name);
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Initializing the ${chalk.default.bold.cyanBright(name)} Babel plugin`);
+			const result = builder({
+				log,
+				name,
+				api,
+				options,
+				context,
+				dirname
+			});
+			result.name = name;
+			log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Completed initialization of the ${chalk.default.bold.cyanBright(name)} Babel plugin`);
+			return result;
+		});
+	};
+	plugin.$$name = name;
+	return plugin;
+}
+
+//#endregion
+exports.createBabelPlugin = createBabelPlugin;

package/dist/plugin-babel/src/helpers/create-plugin.mjs

@@ -0,0 +1,39 @@
+import { extendLog } from "../../../powerlines/src/lib/logger.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import chalk from "chalk";
+import { declare } from "@babel/helper-plugin-utils";
+
+//#region ../plugin-babel/src/helpers/create-plugin.ts
+/**
+* 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.
+*/
+function createBabelPlugin(name, builder) {
+	const plugin = (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.$$name = name;
+	return plugin;
+}
+
+//#endregion
+export { createBabelPlugin };

package/dist/plugin-babel/src/helpers/filters.cjs

@@ -0,0 +1,23 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+require("@stryke/type-checks/is-object");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+
+//#region ../plugin-babel/src/helpers/filters.ts
+function getPluginName(plugin) {
+	return (0, __stryke_type_checks_is_set_string.isSetString)(plugin) ? plugin : Array.isArray(plugin) && plugin.length > 0 ? getPluginName(plugin[0]) : plugin.$$name || plugin.name ? plugin.$$name || plugin.name : void 0;
+}
+/**
+* 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.
+*/
+function isDuplicatePlugin(plugins, plugin) {
+	return !!(getPluginName(plugin) && plugins.some((existing) => Array.isArray(existing) && getPluginName(existing[0]) === getPluginName(plugin)));
+}
+
+//#endregion
+exports.getPluginName = getPluginName;
+exports.isDuplicatePlugin = isDuplicatePlugin;

package/dist/plugin-babel/src/helpers/filters.mjs

@@ -0,0 +1,21 @@
+import { isFunction } from "@stryke/type-checks/is-function";
+import "@stryke/type-checks/is-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+
+//#region ../plugin-babel/src/helpers/filters.ts
+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;
+}
+/**
+* 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.
+*/
+function isDuplicatePlugin(plugins, plugin) {
+	return !!(getPluginName(plugin) && plugins.some((existing) => Array.isArray(existing) && getPluginName(existing[0]) === getPluginName(plugin)));
+}
+
+//#endregion
+export { getPluginName, isDuplicatePlugin };

package/dist/plugin-babel/src/helpers/index.cjs

@@ -0,0 +1,5 @@
+const require_filters = require('./filters.cjs');
+const require_options = require('./options.cjs');
+require('./ast-utils.cjs');
+const require_create_plugin = require('./create-plugin.cjs');
+const require_module_helpers = require('./module-helpers.cjs');

package/dist/plugin-babel/src/helpers/index.mjs

@@ -0,0 +1,7 @@
+import { getPluginName, isDuplicatePlugin } from "./filters.mjs";
+import { resolveBabelPlugin, resolvePluginFunction } from "./options.mjs";
+import "./ast-utils.mjs";
+import { createBabelPlugin } from "./create-plugin.mjs";
+import { addImport, addImportsToProgram } from "./module-helpers.mjs";
+
+export {  };

package/dist/plugin-babel/src/helpers/module-helpers.cjs

@@ -0,0 +1,38 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+require('./ast-utils.cjs');
+let __babel_types = require("@babel/types");
+__babel_types = require_rolldown_runtime.__toESM(__babel_types);
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+
+//#region ../plugin-babel/src/helpers/module-helpers.ts
+/**
+* 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.
+*/
+function addImport(path, specifier) {
+	addImportsToProgram(path.scope.getProgramParent().path, specifier);
+}
+function isNonNamespacedImport(importDeclPath) {
+	return importDeclPath.get("specifiers").filter(Boolean).every((specifier) => specifier?.isImportSpecifier()) && importDeclPath.node.importKind !== "type" && importDeclPath.node.importKind !== "typeof";
+}
+function getExistingImports(program) {
+	const existingImports = /* @__PURE__ */ new Map();
+	program.traverse({ ImportDeclaration(path) {
+		if (isNonNamespacedImport(path)) existingImports.set(path.node.source.value, path);
+	} });
+	return existingImports;
+}
+function addImportsToProgram(path, specifier) {
+	/**
+	* If an existing import of this module exists (ie \`import \{ ... \} from
+	* '<moduleName>'\`), inject new imported specifiers into the list of
+	* destructured variables.
+	*/
+	if (!getExistingImports(path).get(specifier.module)) path.unshiftContainer("body", __babel_types.importDeclaration([__babel_types.importSpecifier(__babel_types.identifier(specifier.name || specifier.imported), __babel_types.identifier(specifier.imported))], __babel_types.stringLiteral(specifier.module)));
+}
+
+//#endregion
+exports.addImport = addImport;
+exports.addImportsToProgram = addImportsToProgram;

package/dist/plugin-babel/src/helpers/module-helpers.mjs

@@ -0,0 +1,35 @@
+import "./ast-utils.mjs";
+import * as t from "@babel/types";
+import { isString } from "@stryke/type-checks/is-string";
+
+//#region ../plugin-babel/src/helpers/module-helpers.ts
+/**
+* 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.
+*/
+function addImport(path, specifier) {
+	addImportsToProgram(path.scope.getProgramParent().path, specifier);
+}
+function isNonNamespacedImport(importDeclPath) {
+	return importDeclPath.get("specifiers").filter(Boolean).every((specifier) => specifier?.isImportSpecifier()) && importDeclPath.node.importKind !== "type" && importDeclPath.node.importKind !== "typeof";
+}
+function getExistingImports(program) {
+	const existingImports = /* @__PURE__ */ new Map();
+	program.traverse({ ImportDeclaration(path) {
+		if (isNonNamespacedImport(path)) existingImports.set(path.node.source.value, path);
+	} });
+	return existingImports;
+}
+function addImportsToProgram(path, specifier) {
+	/**
+	* If an existing import of this module exists (ie \`import \{ ... \} from
+	* '<moduleName>'\`), inject new imported specifiers into the list of
+	* destructured variables.
+	*/
+	if (!getExistingImports(path).get(specifier.module)) path.unshiftContainer("body", t.importDeclaration([t.importSpecifier(t.identifier(specifier.name || specifier.imported), t.identifier(specifier.imported))], t.stringLiteral(specifier.module)));
+}
+
+//#endregion
+export { addImport, addImportsToProgram };

package/dist/plugin-babel/src/helpers/options.cjs

@@ -0,0 +1,50 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+const require_filters = require('./filters.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+
+//#region ../plugin-babel/src/helpers/options.ts
+function resolvePluginFunction(context, plugin) {
+	try {
+		return Array.isArray(plugin) && plugin.length > 0 && plugin[0] ? (0, __stryke_type_checks_is_function.isFunction)(plugin[0]) ? plugin[0](context) : plugin[0] : (0, __stryke_type_checks_is_function.isFunction)(plugin) ? plugin(context) : plugin;
+	} catch {
+		return plugin[0];
+	}
+}
+/**
+* Resolve the [Babel](https://babeljs.io/) plugin.
+*
+* @param context - The context for the transformation.
+* @param code - The code to be transformed.
+* @param id - The ID of the source file.
+* @param plugin - The Babel plugin to resolve.
+* @returns The resolved Babel plugin options, or undefined if the plugin is filtered out.
+*/
+function resolveBabelPlugin(context, code, id, plugin) {
+	if (Array.isArray(plugin) && plugin.length > 0 && plugin[0]) {
+		if (plugin.length > 2 && plugin[2] && (0, __stryke_type_checks_is_function.isFunction)(plugin[2]) && !plugin[2](code, id)) {
+			context.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Skipping filtered Babel plugin ${chalk.default.bold.cyanBright(require_filters.getPluginName(plugin) || "unnamed")} for ${id}`);
+			return;
+		}
+		return plugin.length > 2 ? [
+			resolvePluginFunction(context, plugin),
+			plugin[1],
+			plugin[2]
+		] : [
+			resolvePluginFunction(context, plugin),
+			plugin[1],
+			null
+		];
+	}
+	return [
+		resolvePluginFunction(context, plugin),
+		{},
+		null
+	];
+}
+
+//#endregion
+exports.resolveBabelPlugin = resolveBabelPlugin;
+exports.resolvePluginFunction = resolvePluginFunction;