@powerlines/core 0.15.0 → 0.15.1

package/dist/lib/meta.cjs

@@ -0,0 +1,57 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_constants_meta = require('../constants/meta.cjs');
+require('../constants/index.cjs');
+let _stryke_fs_exists = require("@stryke/fs/exists");
+let _stryke_fs_json = require("@stryke/fs/json");
+let _stryke_path_join_paths = require("@stryke/path/join-paths");
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
+let _stryke_fs_remove_file = require("@stryke/fs/remove-file");
+
+//#region src/lib/meta.ts
+/**
+* Generates a prefixed project root hash object.
+*
+* @remarks
+* This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.
+*
+* @param name - The name of the project.
+* @param rootHash - The hash of the project root.
+* @returns An object containing the name and project root hash.
+*/
+function getPrefixedRootHash(name, rootHash) {
+	const combined = `${(0, _stryke_string_format_kebab_case.kebabCase)(name)}_${rootHash}`;
+	return combined.length > 45 ? combined.slice(0, 45) : combined;
+}
+/**
+* Retrieves the persisted meta information from the context's data path.
+*
+* @param context - The build context.
+* @returns A promise that resolves to the persisted meta information, or undefined if not found.
+*/
+async function getPersistedMeta(context) {
+	const metaFilePath = (0, _stryke_path_join_paths.joinPaths)(context.dataPath, "meta.json");
+	if ((0, _stryke_fs_exists.existsSync)(metaFilePath)) try {
+		return await (0, _stryke_fs_json.readJsonFile)(metaFilePath);
+	} catch {
+		context.warn(`Failed to read meta file at ${metaFilePath}. It may be corrupted.`);
+		await (0, _stryke_fs_remove_file.removeFile)(metaFilePath);
+		context.persistedMeta = void 0;
+	}
+}
+/**
+* Writes the meta file for the context.
+*
+* @param context - The context to write the meta file for.
+* @returns A promise that resolves when the meta file has been written.
+*/
+async function writeMetaFile(context) {
+	const metaFilePath = (0, _stryke_path_join_paths.joinPaths)(context.dataPath, "meta.json");
+	context.debug(`Writing runtime metadata to ${metaFilePath}`);
+	await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));
+}
+
+//#endregion
+exports.getPersistedMeta = getPersistedMeta;
+exports.getPrefixedRootHash = getPrefixedRootHash;
+exports.writeMetaFile = writeMetaFile;

package/dist/lib/meta.d.cts

@@ -0,0 +1,34 @@
+import { Context, MetaInfo } from "../types/context.cjs";
+//#region src/lib/meta.d.ts
+interface CreateContextOptions {
+  name?: string;
+}
+/**
+ * Generates a prefixed project root hash object.
+ *
+ * @remarks
+ * This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.
+ *
+ * @param name - The name of the project.
+ * @param rootHash - The hash of the project root.
+ * @returns An object containing the name and project root hash.
+ */
+declare function getPrefixedRootHash(name: string, rootHash: string): string;
+/**
+ * Retrieves the persisted meta information from the context's data path.
+ *
+ * @param context - The build context.
+ * @returns A promise that resolves to the persisted meta information, or undefined if not found.
+ */
+declare function getPersistedMeta(context: Context): Promise<MetaInfo | undefined>;
+/**
+ * Writes the meta file for the context.
+ *
+ * @param context - The context to write the meta file for.
+ * @returns A promise that resolves when the meta file has been written.
+ */
+declare function writeMetaFile(context: Context): Promise<void>;
+declare type __ΩCreateContextOptions = any[];
+//#endregion
+export { CreateContextOptions, __ΩCreateContextOptions, getPersistedMeta, getPrefixedRootHash, writeMetaFile };
+//# sourceMappingURL=meta.d.cts.map

package/dist/lib/meta.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.cts","names":[],"sources":["../../src/lib/meta.ts"],"mappings":";;UA0BiB,oBAAA;EACf,IAAA;AAAA;AADF;;;;;AAcA;;;;;AAdA,iBAcgB,mBAAA,CAAoB,IAAA,UAAc,QAAA;;;;;;;iBAc5B,gBAAA,CACpB,OAAA,EAAS,OAAA,GACR,OAAA,CAAQ,QAAA;;;;;;;iBAwBW,aAAA,CAAc,OAAA,EAAS,OAAA,GAAU,OAAA;AAAA"}

package/dist/lib/meta.d.mts

@@ -0,0 +1,34 @@
+import { Context, MetaInfo } from "../types/context.mjs";
+//#region src/lib/meta.d.ts
+interface CreateContextOptions {
+  name?: string;
+}
+/**
+ * Generates a prefixed project root hash object.
+ *
+ * @remarks
+ * This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.
+ *
+ * @param name - The name of the project.
+ * @param rootHash - The hash of the project root.
+ * @returns An object containing the name and project root hash.
+ */
+declare function getPrefixedRootHash(name: string, rootHash: string): string;
+/**
+ * Retrieves the persisted meta information from the context's data path.
+ *
+ * @param context - The build context.
+ * @returns A promise that resolves to the persisted meta information, or undefined if not found.
+ */
+declare function getPersistedMeta(context: Context): Promise<MetaInfo | undefined>;
+/**
+ * Writes the meta file for the context.
+ *
+ * @param context - The context to write the meta file for.
+ * @returns A promise that resolves when the meta file has been written.
+ */
+declare function writeMetaFile(context: Context): Promise<void>;
+declare type __ΩCreateContextOptions = any[];
+//#endregion
+export { CreateContextOptions, __ΩCreateContextOptions, getPersistedMeta, getPrefixedRootHash, writeMetaFile };
+//# sourceMappingURL=meta.d.mts.map

package/dist/lib/meta.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.mts","names":[],"sources":["../../src/lib/meta.ts"],"mappings":";;UA0BiB,oBAAA;EACf,IAAA;AAAA;AADF;;;;;AAcA;;;;;AAdA,iBAcgB,mBAAA,CAAoB,IAAA,UAAc,QAAA;;;;;;;iBAc5B,gBAAA,CACpB,OAAA,EAAS,OAAA,GACR,OAAA,CAAQ,QAAA;;;;;;;iBAwBW,aAAA,CAAc,OAAA,EAAS,OAAA,GAAU,OAAA;AAAA"}

package/dist/lib/meta.mjs

@@ -0,0 +1,54 @@
+import { ROOT_HASH_LENGTH } from "../constants/meta.mjs";
+import "../constants/index.mjs";
+import { existsSync } from "@stryke/fs/exists";
+import { readJsonFile } from "@stryke/fs/json";
+import { joinPaths } from "@stryke/path/join-paths";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import { removeFile } from "@stryke/fs/remove-file";
+
+//#region src/lib/meta.ts
+/**
+* Generates a prefixed project root hash object.
+*
+* @remarks
+* This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.
+*
+* @param name - The name of the project.
+* @param rootHash - The hash of the project root.
+* @returns An object containing the name and project root hash.
+*/
+function getPrefixedRootHash(name, rootHash) {
+	const combined = `${kebabCase(name)}_${rootHash}`;
+	return combined.length > 45 ? combined.slice(0, 45) : combined;
+}
+/**
+* Retrieves the persisted meta information from the context's data path.
+*
+* @param context - The build context.
+* @returns A promise that resolves to the persisted meta information, or undefined if not found.
+*/
+async function getPersistedMeta(context) {
+	const metaFilePath = joinPaths(context.dataPath, "meta.json");
+	if (existsSync(metaFilePath)) try {
+		return await readJsonFile(metaFilePath);
+	} catch {
+		context.warn(`Failed to read meta file at ${metaFilePath}. It may be corrupted.`);
+		await removeFile(metaFilePath);
+		context.persistedMeta = void 0;
+	}
+}
+/**
+* Writes the meta file for the context.
+*
+* @param context - The context to write the meta file for.
+* @returns A promise that resolves when the meta file has been written.
+*/
+async function writeMetaFile(context) {
+	const metaFilePath = joinPaths(context.dataPath, "meta.json");
+	context.debug(`Writing runtime metadata to ${metaFilePath}`);
+	await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));
+}
+
+//#endregion
+export { getPersistedMeta, getPrefixedRootHash, writeMetaFile };
+//# sourceMappingURL=meta.mjs.map

package/dist/lib/meta.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.mjs","names":[],"sources":["../../src/lib/meta.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { existsSync } from \"@stryke/fs/exists\";\nimport { readJsonFile } from \"@stryke/fs/json\";\nimport { removeFile } from \"@stryke/fs/remove-file\";\nimport { joinPaths } from \"@stryke/path/join-paths\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { ROOT_HASH_LENGTH } from \"../constants\";\nimport type { Context, MetaInfo } from \"../types\";\n\nexport interface CreateContextOptions {\n  name?: string;\n}\n\n/**\n * Generates a prefixed project root hash object.\n *\n * @remarks\n * This function returns a string where the project root hash is prefixed with the project name plus a hyphen. If the total length of this string combination exceeds 45 characters, it will truncate the hash.\n *\n * @param name - The name of the project.\n * @param rootHash - The hash of the project root.\n * @returns An object containing the name and project root hash.\n */\nexport function getPrefixedRootHash(name: string, rootHash: string): string {\n  const combined = `${kebabCase(name)}_${rootHash}`;\n\n  return combined.length > ROOT_HASH_LENGTH\n    ? combined.slice(0, ROOT_HASH_LENGTH)\n    : combined;\n}\n\n/**\n * Retrieves the persisted meta information from the context's data path.\n *\n * @param context - The build context.\n * @returns A promise that resolves to the persisted meta information, or undefined if not found.\n */\nexport async function getPersistedMeta(\n  context: Context\n): Promise<MetaInfo | undefined> {\n  const metaFilePath = joinPaths(context.dataPath, \"meta.json\");\n  if (existsSync(metaFilePath)) {\n    try {\n      return await readJsonFile<MetaInfo>(metaFilePath);\n    } catch {\n      context.warn(\n        `Failed to read meta file at ${metaFilePath}. It may be corrupted.`\n      );\n      await removeFile(metaFilePath);\n\n      context.persistedMeta = undefined;\n    }\n  }\n\n  return undefined;\n}\n\n/**\n * Writes the meta file for the context.\n *\n * @param context - The context to write the meta file for.\n * @returns A promise that resolves when the meta file has been written.\n */\nexport async function writeMetaFile(context: Context): Promise<void> {\n  const metaFilePath = joinPaths(context.dataPath, \"meta.json\");\n\n  context.debug(`Writing runtime metadata to ${metaFilePath}`);\n\n  await context.fs.write(metaFilePath, JSON.stringify(context.meta, null, 2));\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwCA,SAAgB,oBAAoB,MAAc,UAA0B;CAC1E,MAAM,WAAW,GAAG,UAAU,KAAK,CAAC,GAAG;AAEvC,QAAO,SAAS,cACZ,SAAS,MAAM,MAAoB,GACnC;;;;;;;;AASN,eAAsB,iBACpB,SAC+B;CAC/B,MAAM,eAAe,UAAU,QAAQ,UAAU,YAAY;AAC7D,KAAI,WAAW,aAAa,CAC1B,KAAI;AACF,SAAO,MAAM,aAAuB,aAAa;SAC3C;AACN,UAAQ,KACN,+BAA+B,aAAa,wBAC7C;AACD,QAAM,WAAW,aAAa;AAE9B,UAAQ,gBAAgB;;;;;;;;;AAa9B,eAAsB,cAAc,SAAiC;CACnE,MAAM,eAAe,UAAU,QAAQ,UAAU,YAAY;AAE7D,SAAQ,MAAM,+BAA+B,eAAe;AAE5D,OAAM,QAAQ,GAAG,MAAM,cAAc,KAAK,UAAU,QAAQ,MAAM,MAAM,EAAE,CAAC"}

package/dist/lib/plugins.cjs

@@ -0,0 +1,150 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_plugin_utils_helpers = require('../plugin-utils/helpers.cjs');
+require('../plugin-utils/index.cjs');
+let _stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let _stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let _stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk, 1);
+let _stryke_convert_to_array = require("@stryke/convert/to-array");
+let _stryke_path_join = require("@stryke/path/join");
+let _stryke_fs_install = require("@stryke/fs/install");
+let _stryke_fs_package_fns = require("@stryke/fs/package-fns");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let _stryke_type_checks_is_error = require("@stryke/type-checks/is-error");
+let _stryke_type_checks_is_promise = require("@stryke/type-checks/is-promise");
+
+//#region src/lib/plugins.ts
+/**
+* Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a "plugin" subdirectory within the package.
+*
+* @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+* @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.
+* @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.
+*/
+async function resolvePlugin(context, pluginPath) {
+	if (pluginPath.startsWith("@") && pluginPath.split("/").filter(Boolean).length > 2) {
+		const splits = pluginPath.split("/").filter(Boolean);
+		pluginPath = `${splits[0]}/${splits[1]}`;
+	}
+	const isInstalled = (0, _stryke_fs_package_fns.isPackageExists)(pluginPath, { paths: [context.config.cwd, context.config.root] });
+	if (!isInstalled && context.config.autoInstall) {
+		context.warn(`The plugin package "${pluginPath}" is not installed. It will be installed automatically.`);
+		const result = await (0, _stryke_fs_install.install)(pluginPath, { cwd: context.config.root });
+		if ((0, _stryke_type_checks_is_number.isNumber)(result.exitCode) && result.exitCode > 0) {
+			context.error(result.stderr);
+			throw new Error(`An error occurred while installing the build plugin package "${pluginPath}" `);
+		}
+	}
+	try {
+		const module = await context.resolver.plugin.import(context.resolver.plugin.esmResolve((0, _stryke_path_join.joinPaths)(pluginPath, "plugin")));
+		const result = module.plugin ?? module.default;
+		if (!result) throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
+		return result;
+	} catch (error) {
+		try {
+			const module = await context.resolver.plugin.import(context.resolver.plugin.esmResolve(pluginPath));
+			const result = module.plugin ?? module.default;
+			if (!result) throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
+			return result;
+		} catch {
+			if (!isInstalled) throw new Error(`The plugin package "${pluginPath}" is not installed. Please install the package using the command: "npm install ${pluginPath} --save-dev"`);
+			else throw new Error(`An error occurred while importing the build plugin package "${pluginPath}":
+${(0, _stryke_type_checks_is_error.isError)(error) ? error.message : String(error)}
+
+Note: Please ensure the plugin package's default export is a class that extends \`Plugin\` with a constructor that excepts a single arguments of type \`PluginOptions\`.`);
+		}
+	}
+}
+/**
+* Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.
+*
+* @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+* @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.
+* @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.
+*/
+async function initPlugin(context, config, options = {}) {
+	const { skipLogging = false } = options;
+	let awaited = config;
+	if ((0, _stryke_type_checks_is_promise.isPromiseLike)(config)) awaited = await Promise.resolve(config);
+	if (!require_plugin_utils_helpers.isPluginConfig(awaited)) {
+		const invalid = require_plugin_utils_helpers.findInvalidPluginConfig(awaited);
+		throw new Error(`Invalid ${invalid && invalid.length > 1 ? "plugins" : "plugin"} specified in the configuration - ${invalid && invalid.length > 0 ? JSON.stringify(awaited) : invalid?.join("\n\n")} \n\nPlease ensure the value is one of the following: \n - an instance of \`Plugin\` \n - a plugin name \n - an object with the \`plugin\` and \`options\` properties \n - a tuple array with the plugin and options \n - a factory function that returns a plugin or array of plugins \n - an array of plugins or plugin configurations`);
+	}
+	let plugins;
+	if (require_plugin_utils_helpers.isPlugin(awaited)) plugins = [awaited];
+	else if ((0, _stryke_type_checks_is_function.isFunction)(awaited)) plugins = (0, _stryke_convert_to_array.toArray)(await Promise.resolve(awaited()));
+	else if ((0, _stryke_type_checks_is_string.isString)(awaited)) {
+		const resolved = await resolvePlugin(context, awaited);
+		if ((0, _stryke_type_checks_is_function.isFunction)(resolved)) plugins = (0, _stryke_convert_to_array.toArray)(await Promise.resolve(resolved()));
+		else plugins = (0, _stryke_convert_to_array.toArray)(resolved);
+	} else if (Array.isArray(awaited) && awaited.every(require_plugin_utils_helpers.isPlugin)) plugins = awaited;
+	else if (Array.isArray(awaited) && awaited.every(require_plugin_utils_helpers.isPluginConfig)) {
+		plugins = [];
+		for (const pluginConfig of awaited) {
+			const initialized = await initPlugin(context, pluginConfig);
+			if (initialized) plugins.push(...initialized);
+		}
+	} else if (require_plugin_utils_helpers.isPluginConfigTuple(awaited) || require_plugin_utils_helpers.isPluginConfigObject(awaited)) {
+		let pluginConfig;
+		let pluginOptions;
+		if (require_plugin_utils_helpers.isPluginConfigTuple(awaited)) {
+			pluginConfig = awaited[0];
+			pluginOptions = awaited?.length === 2 ? awaited[1] : void 0;
+		} else {
+			pluginConfig = awaited.plugin;
+			pluginOptions = awaited.options;
+		}
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(pluginConfig)) {
+			const resolved = await resolvePlugin(context, pluginConfig);
+			if ((0, _stryke_type_checks_is_function.isFunction)(resolved)) plugins = (0, _stryke_convert_to_array.toArray)(await Promise.resolve(pluginOptions ? resolved(pluginOptions) : resolved()));
+			else plugins = (0, _stryke_convert_to_array.toArray)(resolved);
+		} else if ((0, _stryke_type_checks_is_function.isFunction)(pluginConfig)) plugins = (0, _stryke_convert_to_array.toArray)(await Promise.resolve(pluginConfig(pluginOptions)));
+		else if (Array.isArray(pluginConfig) && pluginConfig.every(require_plugin_utils_helpers.isPlugin)) plugins = pluginConfig;
+		else if (require_plugin_utils_helpers.isPlugin(pluginConfig)) plugins = (0, _stryke_convert_to_array.toArray)(pluginConfig);
+	}
+	if (!plugins) throw new Error(`The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`);
+	if (plugins.length > 0 && !plugins.every(require_plugin_utils_helpers.isPlugin)) throw new Error(`The plugin option ${JSON.stringify(plugins)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`);
+	const result = [];
+	for (const plugin of plugins) if (require_plugin_utils_helpers.isDuplicate(plugin, context.plugins)) {
+		if (!skipLogging) context.trace({
+			meta: { category: "plugins" },
+			message: `Duplicate ${chalk.default.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`
+		});
+	} else {
+		result.push(plugin);
+		if (!skipLogging) context.trace({
+			meta: { category: "plugins" },
+			message: `Initializing the ${chalk.default.bold.cyanBright(plugin.name)} plugin...`
+		});
+	}
+	return result;
+}
+/**
+* Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.
+*
+* @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+* @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.
+* @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.
+*/
+async function resolvePlugins(context, config, options = {}) {
+	const { skipLogging = false } = options;
+	const plugins = [];
+	if (config) {
+		const result = await initPlugin(context, config);
+		if (result) for (const plugin of result) {
+			if (!skipLogging) context.debug({
+				meta: { category: "plugins" },
+				message: `Successfully initialized the ${chalk.default.bold.cyanBright(plugin.name)} plugin`
+			});
+			plugins.push(plugin);
+		}
+	}
+	return plugins;
+}
+
+//#endregion
+exports.initPlugin = initPlugin;
+exports.resolvePlugin = resolvePlugin;
+exports.resolvePlugins = resolvePlugins;

package/dist/lib/plugins.d.cts

@@ -0,0 +1,40 @@
+import { Plugin } from "../types/plugin.cjs";
+import { EnvironmentContext, ExecutionContext, PluginContext } from "../types/context.cjs";
+import { PluginConfig, ResolvedConfig } from "../types/config.cjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/lib/plugins.d.ts
+/**
+ * Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a "plugin" subdirectory within the package.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.
+ * @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.
+ */
+declare function resolvePlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, pluginPath: string): Promise<Plugin<TPluginContext> | Plugin<TPluginContext>[] | ((options?: any) => MaybePromise<Plugin<TPluginContext> | Plugin<TPluginContext>[]>)>;
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.
+ * @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.
+ */
+declare function initPlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[] | null>;
+interface ResolvePluginsOptions {
+  /**
+   * If true, the plugin resolution process will skip logging messages about the plugin initialization. This can be useful in scenarios where you want to suppress plugin-related logs, such as when running in a non-interactive environment or when you want to reduce log verbosity. By default, this option is false, and plugin initialization messages will be logged using the context's logger.
+   */
+  skipLogging?: boolean;
+}
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.
+ * @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.
+ */
+declare function resolvePlugins<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[]>;
+declare type __ΩResolvePluginsOptions = any[];
+//#endregion
+export { ResolvePluginsOptions, __ΩResolvePluginsOptions, initPlugin, resolvePlugin, resolvePlugins };
+//# sourceMappingURL=plugins.d.cts.map

package/dist/lib/plugins.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.cts","names":[],"sources":["../../src/lib/plugins.ts"],"mappings":";;;;;;;;;;;AAwDA;;iBAAsB,aAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,EAAA,CAEjC,OAAA,EAAS,QAAA,EACT,UAAA,WACC,OAAA,CACC,MAAA,CAAO,cAAA,IACP,MAAA,CAAO,cAAA,QAEL,OAAA,WACG,YAAA,CAAa,MAAA,CAAO,cAAA,IAAkB,MAAA,CAAO,cAAA;;;;;;;;iBAsGhC,UAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,EAAA,CAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,cAAA;AAAA,UAwJD,qBAAA;EAxRX;;;EA4RJ,WAAA;AAAA;;;;;;;;iBAUoB,cAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,EAAA,CAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GAA0B,OAAA,CAAA,MAAA,CAAA,cAAA;AAAA"}

package/dist/lib/plugins.d.mts

@@ -0,0 +1,40 @@
+import { Plugin } from "../types/plugin.mjs";
+import { EnvironmentContext, ExecutionContext, PluginContext } from "../types/context.mjs";
+import { PluginConfig, ResolvedConfig } from "../types/config.mjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region src/lib/plugins.d.ts
+/**
+ * Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a "plugin" subdirectory within the package.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.
+ * @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.
+ */
+declare function resolvePlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, pluginPath: string): Promise<Plugin<TPluginContext> | Plugin<TPluginContext>[] | ((options?: any) => MaybePromise<Plugin<TPluginContext> | Plugin<TPluginContext>[]>)>;
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.
+ * @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.
+ */
+declare function initPlugin<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[] | null>;
+interface ResolvePluginsOptions {
+  /**
+   * If true, the plugin resolution process will skip logging messages about the plugin initialization. This can be useful in scenarios where you want to suppress plugin-related logs, such as when running in a non-interactive environment or when you want to reduce log verbosity. By default, this option is false, and plugin initialization messages will be logged using the context's logger.
+   */
+  skipLogging?: boolean;
+}
+/**
+ * Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.
+ *
+ * @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+ * @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.
+ * @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.
+ */
+declare function resolvePlugins<TResolvedConfig extends ResolvedConfig, TSystemContext, TContext extends EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext> = EnvironmentContext<TResolvedConfig, TSystemContext> | ExecutionContext<TResolvedConfig, TSystemContext>, TPluginContext extends PluginContext<TResolvedConfig, TSystemContext> = PluginContext<TResolvedConfig, TSystemContext>>(context: TContext, config: PluginConfig<TPluginContext>, options?: ResolvePluginsOptions): Promise<Plugin<TPluginContext>[]>;
+declare type __ΩResolvePluginsOptions = any[];
+//#endregion
+export { ResolvePluginsOptions, __ΩResolvePluginsOptions, initPlugin, resolvePlugin, resolvePlugins };
+//# sourceMappingURL=plugins.d.mts.map

package/dist/lib/plugins.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.d.mts","names":[],"sources":["../../src/lib/plugins.ts"],"mappings":";;;;;;;;;;;AAwDA;;iBAAsB,aAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,EAAA,CAEjC,OAAA,EAAS,QAAA,EACT,UAAA,WACC,OAAA,CACC,MAAA,CAAO,cAAA,IACP,MAAA,CAAO,cAAA,QAEL,OAAA,WACG,YAAA,CAAa,MAAA,CAAO,cAAA,IAAkB,MAAA,CAAO,cAAA;;;;;;;;iBAsGhC,UAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,EAAA,CAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GACR,OAAA,CAAQ,MAAA,CAAO,cAAA;AAAA,UAwJD,qBAAA;EAxRX;;;EA4RJ,WAAA;AAAA;;;;;;;;iBAUoB,cAAA,yBACI,cAAA,mCAGpB,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,IAClC,kBAAA,CAAmB,eAAA,EAAiB,cAAA,IACpC,gBAAA,CAAiB,eAAA,EAAiB,cAAA,0BACf,aAAA,CAAc,eAAA,EAAiB,cAAA,IACpD,aAAA,CAAc,eAAA,EAAiB,cAAA,EAAA,CAEjC,OAAA,EAAS,QAAA,EACT,MAAA,EAAQ,YAAA,CAAa,cAAA,GACrB,OAAA,GAAS,qBAAA,GAA0B,OAAA,CAAA,MAAA,CAAA,cAAA;AAAA"}

package/dist/lib/plugins.mjs

@@ -0,0 +1,146 @@
+import { findInvalidPluginConfig, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple } from "../plugin-utils/helpers.mjs";
+import "../plugin-utils/index.mjs";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isString } from "@stryke/type-checks/is-string";
+import chalk from "chalk";
+import { toArray } from "@stryke/convert/to-array";
+import { joinPaths } from "@stryke/path/join";
+import { install } from "@stryke/fs/install";
+import { isPackageExists } from "@stryke/fs/package-fns";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isError } from "@stryke/type-checks/is-error";
+import { isPromiseLike } from "@stryke/type-checks/is-promise";
+
+//#region src/lib/plugins.ts
+/**
+* Resolve a plugin module based on the provided plugin path. This function checks if the plugin package is installed, attempts to import the plugin module, and handles various error cases such as missing packages or invalid module exports. It supports both direct plugin exports and plugins exported from a "plugin" subdirectory within the package.
+*
+* @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+* @param pluginPath - The path to the plugin module. This can be a package name, a scoped package name, or a path to a local module.
+* @returns A promise that resolves to the plugin module, which can be a plugin instance, a factory function that returns a plugin, or an array of plugins.
+*/
+async function resolvePlugin(context, pluginPath) {
+	if (pluginPath.startsWith("@") && pluginPath.split("/").filter(Boolean).length > 2) {
+		const splits = pluginPath.split("/").filter(Boolean);
+		pluginPath = `${splits[0]}/${splits[1]}`;
+	}
+	const isInstalled = isPackageExists(pluginPath, { paths: [context.config.cwd, context.config.root] });
+	if (!isInstalled && context.config.autoInstall) {
+		context.warn(`The plugin package "${pluginPath}" is not installed. It will be installed automatically.`);
+		const result = await install(pluginPath, { cwd: context.config.root });
+		if (isNumber(result.exitCode) && result.exitCode > 0) {
+			context.error(result.stderr);
+			throw new Error(`An error occurred while installing the build plugin package "${pluginPath}" `);
+		}
+	}
+	try {
+		const module = await context.resolver.plugin.import(context.resolver.plugin.esmResolve(joinPaths(pluginPath, "plugin")));
+		const result = module.plugin ?? module.default;
+		if (!result) throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
+		return result;
+	} catch (error) {
+		try {
+			const module = await context.resolver.plugin.import(context.resolver.plugin.esmResolve(pluginPath));
+			const result = module.plugin ?? module.default;
+			if (!result) throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
+			return result;
+		} catch {
+			if (!isInstalled) throw new Error(`The plugin package "${pluginPath}" is not installed. Please install the package using the command: "npm install ${pluginPath} --save-dev"`);
+			else throw new Error(`An error occurred while importing the build plugin package "${pluginPath}":
+${isError(error) ? error.message : String(error)}
+
+Note: Please ensure the plugin package's default export is a class that extends \`Plugin\` with a constructor that excepts a single arguments of type \`PluginOptions\`.`);
+		}
+	}
+}
+/**
+* Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, factory functions, string paths to plugins, and arrays of plugins or plugin configurations. It validates the plugin configuration, resolves any plugin paths, and returns an array of initialized plugins.
+*
+* @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+* @param config - The plugin configuration, which can be in various forms such as a direct plugin instance, a string path to a plugin, a factory function that returns a plugin, or an array of plugins or plugin configurations. This configuration will be processed and validated to initialize the appropriate plugins.
+* @returns A promise that resolves to an array of initialized plugins based on the provided configuration. If the configuration is invalid, an error will be thrown with details about the issue.
+*/
+async function initPlugin(context, config, options = {}) {
+	const { skipLogging = false } = options;
+	let awaited = config;
+	if (isPromiseLike(config)) awaited = await Promise.resolve(config);
+	if (!isPluginConfig(awaited)) {
+		const invalid = findInvalidPluginConfig(awaited);
+		throw new Error(`Invalid ${invalid && invalid.length > 1 ? "plugins" : "plugin"} specified in the configuration - ${invalid && invalid.length > 0 ? JSON.stringify(awaited) : invalid?.join("\n\n")} \n\nPlease ensure the value is one of the following: \n - an instance of \`Plugin\` \n - a plugin name \n - an object with the \`plugin\` and \`options\` properties \n - a tuple array with the plugin and options \n - a factory function that returns a plugin or array of plugins \n - an array of plugins or plugin configurations`);
+	}
+	let plugins;
+	if (isPlugin(awaited)) plugins = [awaited];
+	else if (isFunction(awaited)) plugins = toArray(await Promise.resolve(awaited()));
+	else if (isString(awaited)) {
+		const resolved = await resolvePlugin(context, awaited);
+		if (isFunction(resolved)) plugins = toArray(await Promise.resolve(resolved()));
+		else plugins = toArray(resolved);
+	} else if (Array.isArray(awaited) && awaited.every(isPlugin)) plugins = awaited;
+	else if (Array.isArray(awaited) && awaited.every(isPluginConfig)) {
+		plugins = [];
+		for (const pluginConfig of awaited) {
+			const initialized = await initPlugin(context, pluginConfig);
+			if (initialized) plugins.push(...initialized);
+		}
+	} else if (isPluginConfigTuple(awaited) || isPluginConfigObject(awaited)) {
+		let pluginConfig;
+		let pluginOptions;
+		if (isPluginConfigTuple(awaited)) {
+			pluginConfig = awaited[0];
+			pluginOptions = awaited?.length === 2 ? awaited[1] : void 0;
+		} else {
+			pluginConfig = awaited.plugin;
+			pluginOptions = awaited.options;
+		}
+		if (isSetString(pluginConfig)) {
+			const resolved = await resolvePlugin(context, pluginConfig);
+			if (isFunction(resolved)) plugins = toArray(await Promise.resolve(pluginOptions ? resolved(pluginOptions) : resolved()));
+			else plugins = toArray(resolved);
+		} else if (isFunction(pluginConfig)) plugins = toArray(await Promise.resolve(pluginConfig(pluginOptions)));
+		else if (Array.isArray(pluginConfig) && pluginConfig.every(isPlugin)) plugins = pluginConfig;
+		else if (isPlugin(pluginConfig)) plugins = toArray(pluginConfig);
+	}
+	if (!plugins) throw new Error(`The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`);
+	if (plugins.length > 0 && !plugins.every(isPlugin)) throw new Error(`The plugin option ${JSON.stringify(plugins)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`);
+	const result = [];
+	for (const plugin of plugins) if (isDuplicate(plugin, context.plugins)) {
+		if (!skipLogging) context.trace({
+			meta: { category: "plugins" },
+			message: `Duplicate ${chalk.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`
+		});
+	} else {
+		result.push(plugin);
+		if (!skipLogging) context.trace({
+			meta: { category: "plugins" },
+			message: `Initializing the ${chalk.bold.cyanBright(plugin.name)} plugin...`
+		});
+	}
+	return result;
+}
+/**
+* Initialize a plugin based on the provided plugin configuration. This function handles various forms of plugin configurations, including direct plugin instances, plugin names, factory functions, and arrays of plugins. It validates the configuration, resolves plugin modules if necessary, and returns an array of initialized plugins ready to be added to the execution context.
+*
+* @param context - The execution context in which the plugin will be initialized. This context provides access to configuration, logging, and other utilities that may be needed during plugin initialization.
+* @param config - The plugin configuration, which can be in various forms such as a plugin instance, a plugin name string, a factory function that returns a plugin or an array of plugins, or an array of plugin configurations. The function will handle the resolution and initialization of the plugin(s) based on the provided configuration.
+* @returns A promise that resolves to an array of initialized plugins that can be added to the execution context, or null if the configuration is invalid or results in no plugins being initialized.
+*/
+async function resolvePlugins(context, config, options = {}) {
+	const { skipLogging = false } = options;
+	const plugins = [];
+	if (config) {
+		const result = await initPlugin(context, config);
+		if (result) for (const plugin of result) {
+			if (!skipLogging) context.debug({
+				meta: { category: "plugins" },
+				message: `Successfully initialized the ${chalk.bold.cyanBright(plugin.name)} plugin`
+			});
+			plugins.push(plugin);
+		}
+	}
+	return plugins;
+}
+
+//#endregion
+export { initPlugin, resolvePlugin, resolvePlugins };
+//# sourceMappingURL=plugins.mjs.map