@powerlines/core 0.47.4 → 0.48.2

package/dist/plugin-utils/index.d.mts

@@ -1,16 +1,18 @@
-import { GetDependencyConfigResult, __ΩGetDependencyConfigResult, getDependencyConfig } from "./build-helpers.mjs";
-import { CombinePluginsOptions, __ΩCombinePluginsOptions, combinePluginOptions, combinePlugins } from "./combine-plugins.mjs";
+import { GetDependencyConfigResult, getDependencyConfig } from "./build-helpers.mjs";
+import { CombinePluginsOptions, combinePluginOptions, combinePlugins } from "./combine-plugins.mjs";
 import { getOrganizationName, getPackageJsonOrganization, getWorkspaceName } from "./context-helpers.mjs";
 import { getDocsOutputPath } from "./docs-helper.mjs";
+import { enable } from "./enable-plugin.mjs";
 import { extend } from "./extend.mjs";
 import { createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, normalizeFilter, normalizeSingleFilter, patternToCodeFilter, patternToIdFilter } from "./filter.mjs";
 import { formatPackageJson } from "./format-package-json.mjs";
 import { formatConfig } from "./format.mjs";
 import { getConfigPath } from "./get-config-path.mjs";
-import { GetHookHandlerReturnType, __ΩGetHookHandlerReturnType, addPluginHook, dedupeHooklist, extractPluginHook, findInvalidPluginConfig, getHookHandler, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey } from "./helpers.mjs";
+import { GetHookHandlerReturnType, addPluginHook, dedupeHooklist, extractPluginHook, findInvalidPluginConfig, getHookHandler, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey } from "./helpers.mjs";
+import { installPackage, installPackages } from "./install.mjs";
 import { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogFn, withLogger } from "./logging.mjs";
-import { MergeResult, __ΩMergeResult, merge, mergeConfig } from "./merge.mjs";
+import { MergeResult, merge, mergeConfig } from "./merge.mjs";
 import { isBuiltinModule } from "./modules.mjs";
 import { replacePathTokens } from "./paths.mjs";
-import { PrefixRegexOptions, VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, __ΩPrefixRegexOptions, addVirtualPrefix, createVirtualPrefixRegex, isVirtualModule, prefixRegex, removeVirtualPrefix } from "./virtual.mjs";
-export { CombinePluginsOptions, GetDependencyConfigResult, GetHookHandlerReturnType, MergeResult, PrefixRegexOptions, VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, __ΩCombinePluginsOptions, __ΩGetDependencyConfigResult, __ΩGetHookHandlerReturnType, __ΩMergeResult, __ΩPrefixRegexOptions, addPluginHook, addVirtualPrefix, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, createVirtualPrefixRegex, dedupeHooklist, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getPackageJsonOrganization, getTextColor, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, isVirtualModule, merge, mergeConfig, normalizeFilter, normalizeSingleFilter, patternToCodeFilter, patternToIdFilter, prefixRegex, removeVirtualPrefix, replacePathTokens, resolveLogLevel, withCustomLogger, withLogFn, withLogger };
+import { PrefixRegexOptions, VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, addVirtualPrefix, createVirtualPrefixRegex, isVirtualModule, prefixRegex, removeVirtualPrefix } from "./virtual.mjs";
+export { CombinePluginsOptions, GetDependencyConfigResult, GetHookHandlerReturnType, MergeResult, PrefixRegexOptions, VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, addPluginHook, addVirtualPrefix, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, createVirtualPrefixRegex, dedupeHooklist, enable, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getPackageJsonOrganization, getTextColor, getWorkspaceName, installPackage, installPackages, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, isVirtualModule, merge, mergeConfig, normalizeFilter, normalizeSingleFilter, patternToCodeFilter, patternToIdFilter, prefixRegex, removeVirtualPrefix, replacePathTokens, resolveLogLevel, withCustomLogger, withLogFn, withLogger };

package/dist/plugin-utils/index.mjs

@@ -1,17 +1,19 @@
-import { replacePathTokens } from "./paths.mjs";
+import { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogFn, withLogger } from "./logging.mjs";
 import { getDependencyConfig } from "./build-helpers.mjs";
 import { addPluginHook, dedupeHooklist, extractPluginHook, findInvalidPluginConfig, getHookHandler, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey } from "./helpers.mjs";
 import { merge, mergeConfig } from "./merge.mjs";
 import { combinePluginOptions, combinePlugins } from "./combine-plugins.mjs";
 import { getOrganizationName, getPackageJsonOrganization, getWorkspaceName } from "./context-helpers.mjs";
 import { getDocsOutputPath } from "./docs-helper.mjs";
+import { enable } from "./enable-plugin.mjs";
 import { extend } from "./extend.mjs";
 import { VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, addVirtualPrefix, createVirtualPrefixRegex, isVirtualModule, prefixRegex, removeVirtualPrefix } from "./virtual.mjs";
 import { createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, normalizeFilter, normalizeSingleFilter, patternToCodeFilter, patternToIdFilter } from "./filter.mjs";
 import { formatConfig } from "./format.mjs";
 import { formatPackageJson } from "./format-package-json.mjs";
 import { getConfigPath } from "./get-config-path.mjs";
-import { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogFn, withLogger } from "./logging.mjs";
+import { installPackage, installPackages } from "./install.mjs";
 import { isBuiltinModule } from "./modules.mjs";
+import { replacePathTokens } from "./paths.mjs";
 
-export { VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, addPluginHook, addVirtualPrefix, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, createVirtualPrefixRegex, dedupeHooklist, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getPackageJsonOrganization, getTextColor, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, isVirtualModule, merge, mergeConfig, normalizeFilter, normalizeSingleFilter, patternToCodeFilter, patternToIdFilter, prefixRegex, removeVirtualPrefix, replacePathTokens, resolveLogLevel, withCustomLogger, withLogFn, withLogger };
+export { VIRTUAL_MODULE_PREFIX, VIRTUAL_MODULE_PREFIX_REGEX, addPluginHook, addVirtualPrefix, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, createVirtualPrefixRegex, dedupeHooklist, enable, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getPackageJsonOrganization, getTextColor, getWorkspaceName, installPackage, installPackages, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, isVirtualModule, merge, mergeConfig, normalizeFilter, normalizeSingleFilter, patternToCodeFilter, patternToIdFilter, prefixRegex, removeVirtualPrefix, replacePathTokens, resolveLogLevel, withCustomLogger, withLogFn, withLogger };

package/dist/plugin-utils/install.cjs

@@ -0,0 +1,46 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+let _stryke_fs_install = require("@stryke/fs/install");
+let _stryke_fs_package_fns = require("@stryke/fs/package-fns");
+let _stryke_string_format_package = require("@stryke/string-format/package");
+let _stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+
+//#region src/plugin-utils/install.ts
+/**
+* Installs a package if it is not already installed.
+*
+* @param context - The resolved options
+* @param packageName - The name of the package to install
+* @param dev - Whether to install the package as a dev dependency
+*/
+async function installPackage(context, packageName, dev = false) {
+	if (!await (0, _stryke_fs_package_fns.isPackageListed)((0, _stryke_string_format_package.getPackageName)(packageName), { cwd: context.config.root })) if (context.config.autoInstall) {
+		context.warn(`The package "${packageName}" is not installed. It will be installed automatically.`);
+		const result = await (0, _stryke_fs_install.install)(packageName, {
+			cwd: context.config.root,
+			dev
+		});
+		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 package "${packageName}"`);
+		}
+	} else context.warn(`The package "${packageName}" is not installed. Since the "autoInstall" option is set to false, it will not be installed automatically.`);
+	else if ((0, _stryke_string_format_package.hasPackageVersion)(packageName) && !process.env.POWERLINES_SKIP_VERSION_CHECK) {
+		if (!await (0, _stryke_fs_package_fns.doesPackageMatch)((0, _stryke_string_format_package.getPackageName)(packageName), (0, _stryke_string_format_package.getPackageVersion)(packageName), context.config.root)) {
+			const packageListing = await (0, _stryke_fs_package_fns.getPackageListing)((0, _stryke_string_format_package.getPackageName)(packageName), { cwd: context.config.root });
+			if (!packageListing?.version.startsWith("catalog:") && !packageListing?.version.startsWith("workspace:")) context.warn(`The package "${(0, _stryke_string_format_package.getPackageName)(packageName)}" is installed but does not match the expected version ${(0, _stryke_string_format_package.getPackageVersion)(packageName)} (installed version: ${packageListing?.version || "<Unknown>"}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the "STORM_STACK_SKIP_VERSION_CHECK" environment variable.`);
+		}
+	}
+}
+/**
+* Installs a package if it is not already installed.
+*
+* @param context - The resolved options
+* @param packages - The list of packages to install
+*/
+async function installPackages(context, packages) {
+	return Promise.all(packages.map(async (pkg) => installPackage(context, pkg.name, pkg.dev)));
+}
+
+//#endregion
+exports.installPackage = installPackage;
+exports.installPackages = installPackages;

package/dist/plugin-utils/install.d.cts

@@ -0,0 +1,23 @@
+import { Context } from "../types/context.cjs";
+//#region src/plugin-utils/install.d.ts
+/**
+ * Installs a package if it is not already installed.
+ *
+ * @param context - The resolved options
+ * @param packageName - The name of the package to install
+ * @param dev - Whether to install the package as a dev dependency
+ */
+declare function installPackage(context: Context, packageName: string, dev?: boolean): Promise<void>;
+/**
+ * Installs a package if it is not already installed.
+ *
+ * @param context - The resolved options
+ * @param packages - The list of packages to install
+ */
+declare function installPackages(context: Context, packages: Array<{
+  name: string;
+  dev?: boolean;
+}>): Promise<void[]>;
+//#endregion
+export { installPackage, installPackages };
+//# sourceMappingURL=install.d.cts.map

package/dist/plugin-utils/install.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.cts","names":[],"sources":["../../src/plugin-utils/install.ts"],"mappings":";;;;;AAuCA;;;;iBAAsB,cAAA,CACpB,OAAA,EAAS,OAAA,EACT,WAAA,UACA,GAAA,aAAW,OAAA;;;;;;AAAA;iBA+DS,eAAA,CACpB,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,KAAA;EAAQ,IAAA;EAAc,GAAA;AAAA,KAAgB,OAAA"}

package/dist/plugin-utils/install.d.mts

@@ -0,0 +1,23 @@
+import { Context } from "../types/context.mjs";
+//#region src/plugin-utils/install.d.ts
+/**
+ * Installs a package if it is not already installed.
+ *
+ * @param context - The resolved options
+ * @param packageName - The name of the package to install
+ * @param dev - Whether to install the package as a dev dependency
+ */
+declare function installPackage(context: Context, packageName: string, dev?: boolean): Promise<void>;
+/**
+ * Installs a package if it is not already installed.
+ *
+ * @param context - The resolved options
+ * @param packages - The list of packages to install
+ */
+declare function installPackages(context: Context, packages: Array<{
+  name: string;
+  dev?: boolean;
+}>): Promise<void[]>;
+//#endregion
+export { installPackage, installPackages };
+//# sourceMappingURL=install.d.mts.map

package/dist/plugin-utils/install.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.mts","names":[],"sources":["../../src/plugin-utils/install.ts"],"mappings":";;;;;AAuCA;;;;iBAAsB,cAAA,CACpB,OAAA,EAAS,OAAA,EACT,WAAA,UACA,GAAA,aAAW,OAAA;;;;;;AAAA;iBA+DS,eAAA,CACpB,OAAA,EAAS,OAAA,EACT,QAAA,EAAU,KAAA;EAAQ,IAAA;EAAc,GAAA;AAAA,KAAgB,OAAA"}

package/dist/plugin-utils/install.mjs

@@ -0,0 +1,45 @@
+import { install } from "@stryke/fs/install";
+import { doesPackageMatch, getPackageListing, isPackageListed } from "@stryke/fs/package-fns";
+import { getPackageName, getPackageVersion, hasPackageVersion } from "@stryke/string-format/package";
+import { isNumber } from "@stryke/type-checks/is-number";
+
+//#region src/plugin-utils/install.ts
+/**
+* Installs a package if it is not already installed.
+*
+* @param context - The resolved options
+* @param packageName - The name of the package to install
+* @param dev - Whether to install the package as a dev dependency
+*/
+async function installPackage(context, packageName, dev = false) {
+	if (!await isPackageListed(getPackageName(packageName), { cwd: context.config.root })) if (context.config.autoInstall) {
+		context.warn(`The package "${packageName}" is not installed. It will be installed automatically.`);
+		const result = await install(packageName, {
+			cwd: context.config.root,
+			dev
+		});
+		if (isNumber(result.exitCode) && result.exitCode > 0) {
+			context.error(result.stderr);
+			throw new Error(`An error occurred while installing the package "${packageName}"`);
+		}
+	} else context.warn(`The package "${packageName}" is not installed. Since the "autoInstall" option is set to false, it will not be installed automatically.`);
+	else if (hasPackageVersion(packageName) && !process.env.POWERLINES_SKIP_VERSION_CHECK) {
+		if (!await doesPackageMatch(getPackageName(packageName), getPackageVersion(packageName), context.config.root)) {
+			const packageListing = await getPackageListing(getPackageName(packageName), { cwd: context.config.root });
+			if (!packageListing?.version.startsWith("catalog:") && !packageListing?.version.startsWith("workspace:")) context.warn(`The package "${getPackageName(packageName)}" is installed but does not match the expected version ${getPackageVersion(packageName)} (installed version: ${packageListing?.version || "<Unknown>"}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the "STORM_STACK_SKIP_VERSION_CHECK" environment variable.`);
+		}
+	}
+}
+/**
+* Installs a package if it is not already installed.
+*
+* @param context - The resolved options
+* @param packages - The list of packages to install
+*/
+async function installPackages(context, packages) {
+	return Promise.all(packages.map(async (pkg) => installPackage(context, pkg.name, pkg.dev)));
+}
+
+//#endregion
+export { installPackage, installPackages };
+//# sourceMappingURL=install.mjs.map

package/dist/plugin-utils/install.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.mjs","names":[],"sources":["../../src/plugin-utils/install.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 type { Context } from \"@powerlines/core\";\nimport { install } from \"@stryke/fs/install\";\nimport {\n  doesPackageMatch,\n  getPackageListing,\n  isPackageListed\n} from \"@stryke/fs/package-fns\";\nimport {\n  getPackageName,\n  getPackageVersion,\n  hasPackageVersion\n} from \"@stryke/string-format/package\";\nimport { isNumber } from \"@stryke/type-checks/is-number\";\n\n/**\n * Installs a package if it is not already installed.\n *\n * @param context - The resolved options\n * @param packageName - The name of the package to install\n * @param dev - Whether to install the package as a dev dependency\n */\nexport async function installPackage(\n  context: Context,\n  packageName: string,\n  dev = false\n) {\n  if (\n    !(await isPackageListed(getPackageName(packageName), {\n      cwd: context.config.root\n    }))\n  ) {\n    if (context.config.autoInstall) {\n      context.warn(\n        `The package \"${packageName}\" is not installed. It will be installed automatically.`\n      );\n\n      const result = await install(packageName, {\n        cwd: context.config.root,\n        dev\n      });\n      if (isNumber(result.exitCode) && result.exitCode > 0) {\n        context.error(result.stderr);\n        throw new Error(\n          `An error occurred while installing the package \"${packageName}\"`\n        );\n      }\n    } else {\n      context.warn(\n        `The package \"${packageName}\" is not installed. Since the \"autoInstall\" option is set to false, it will not be installed automatically.`\n      );\n    }\n  } else if (\n    hasPackageVersion(packageName) &&\n    !process.env.POWERLINES_SKIP_VERSION_CHECK\n  ) {\n    const isMatching = await doesPackageMatch(\n      getPackageName(packageName),\n      getPackageVersion(packageName)!,\n      context.config.root\n    );\n    if (!isMatching) {\n      const packageListing = await getPackageListing(\n        getPackageName(packageName),\n        {\n          cwd: context.config.root\n        }\n      );\n      if (\n        !packageListing?.version.startsWith(\"catalog:\") &&\n        !packageListing?.version.startsWith(\"workspace:\")\n      ) {\n        context.warn(\n          `The package \"${getPackageName(packageName)}\" is installed but does not match the expected version ${getPackageVersion(\n            packageName\n          )} (installed version: ${packageListing?.version || \"<Unknown>\"}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the \"STORM_STACK_SKIP_VERSION_CHECK\" environment variable.`\n        );\n      }\n    }\n  }\n}\n\n/**\n * Installs a package if it is not already installed.\n *\n * @param context - The resolved options\n * @param packages - The list of packages to install\n */\nexport async function installPackages(\n  context: Context,\n  packages: Array<{ name: string; dev?: boolean }>\n) {\n  return Promise.all(\n    packages.map(async pkg => installPackage(context, pkg.name, pkg.dev))\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAuCA,eAAsB,eACpB,SACA,aACA,MAAM,OACN;CACA,IACE,CAAE,MAAM,gBAAgB,eAAe,WAAW,GAAG,EACnD,KAAK,QAAQ,OAAO,KACtB,CAAC,GAED,IAAI,QAAQ,OAAO,aAAa;EAC9B,QAAQ,KACN,gBAAgB,YAAY,wDAC9B;EAEA,MAAM,SAAS,MAAM,QAAQ,aAAa;GACxC,KAAK,QAAQ,OAAO;GACpB;EACF,CAAC;EACD,IAAI,SAAS,OAAO,QAAQ,KAAK,OAAO,WAAW,GAAG;GACpD,QAAQ,MAAM,OAAO,MAAM;GAC3B,MAAM,IAAI,MACR,mDAAmD,YAAY,EACjE;EACF;CACF,OACE,QAAQ,KACN,gBAAgB,YAAY,4GAC9B;MAEG,IACL,kBAAkB,WAAW,KAC7B,CAAC,QAAQ,IAAI,+BAOb;MAAI,CAAC,MALoB,iBACvB,eAAe,WAAW,GAC1B,kBAAkB,WAAW,GAC7B,QAAQ,OAAO,IACjB,GACiB;GACf,MAAM,iBAAiB,MAAM,kBAC3B,eAAe,WAAW,GAC1B,EACE,KAAK,QAAQ,OAAO,KACtB,CACF;GACA,IACE,CAAC,gBAAgB,QAAQ,WAAW,UAAU,KAC9C,CAAC,gBAAgB,QAAQ,WAAW,YAAY,GAEhD,QAAQ,KACN,gBAAgB,eAAe,WAAW,EAAE,yDAAyD,kBACnG,WACF,EAAE,uBAAuB,gBAAgB,WAAW,YAAY,2JAClE;EAEJ;;AAEJ;;;;;;;AAQA,eAAsB,gBACpB,SACA,UACA;CACA,OAAO,QAAQ,IACb,SAAS,IAAI,OAAM,QAAO,eAAe,SAAS,IAAI,MAAM,IAAI,GAAG,CAAC,CACtE;AACF"}

package/dist/plugin-utils/logging.cjs

@@ -2,14 +2,14 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
 const require_constants_environments = require('../constants/environments.cjs');
 const require_constants_log_level = require('../constants/log-level.cjs');
+let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
 let defu = require("defu");
-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 _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _storm_software_config_tools_logger = require("@storm-software/config-tools/logger");
 let _storm_software_config_tools_utilities_colors = require("@storm-software/config-tools/utilities/colors");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
+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 _stryke_unique_id_uuid = require("@stryke/unique-id/uuid");
 let chalk = require("chalk");
 chalk = require_runtime.__toESM(chalk, 1);
@@ -37,11 +37,11 @@ function resolveLogLevel(logLevel, mode) {
 		general: "trace",
 		fs: "trace",
 		performance: "trace",
-		network: "trace",
+		communication: "trace",
 		plugins: "trace",
 		hooks: "trace",
 		env: "trace",
-		ipc: "trace",
+		rpc: "trace",
 		config: "trace",
 		babel: "trace"
 	};
@@ -49,11 +49,11 @@ function resolveLogLevel(logLevel, mode) {
 		general: "silent",
 		fs: "silent",
 		performance: "silent",
-		network: "silent",
+		communication: "silent",
 		plugins: "silent",
 		hooks: "silent",
 		env: "silent",
-		ipc: "silent",
+		rpc: "silent",
 		config: "silent",
 		babel: "silent"
 	};
@@ -65,11 +65,11 @@ function resolveLogLevel(logLevel, mode) {
 		general: logLevel,
 		fs: defaultLogLevel.fs,
 		performance: logLevel,
-		network: defaultLogLevel.network,
+		communication: defaultLogLevel.communication,
 		plugins: logLevel,
 		hooks: logLevel,
 		env: defaultLogLevel.env,
-		ipc: defaultLogLevel.ipc,
+		rpc: defaultLogLevel.rpc,
 		config: defaultLogLevel.config,
 		babel: logLevel
 	};
@@ -79,29 +79,17 @@ function resolveLogLevel(logLevel, mode) {
 	}
 	return defaultLogLevel;
 }
-const BADGE_COLORS = [
-	"#00A0DD",
-	"#6FCE4E",
-	"#FBBF24",
-	"#F43F5E",
-	"#3B82F6",
-	"#A855F7",
-	"#469592",
-	"#288EDF",
-	"#D8B4FE",
-	"#10B981",
-	"#EF4444",
-	"#F0EC56",
-	"#F472B6",
-	"#22D3EE",
-	"#EAB308",
-	"#84CC16",
-	"#F87171",
-	"#0EA5E9",
-	"#D946EF",
-	"#FACC15",
-	"#34D399",
-	"#8B5CF6"
+const colors = [
+	chalk.default.green,
+	chalk.default.greenBright,
+	chalk.default.red,
+	chalk.default.redBright,
+	chalk.default.cyan,
+	chalk.default.cyanBright,
+	chalk.default.yellow,
+	chalk.default.yellowBright,
+	chalk.default.magenta,
+	chalk.default.magentaBright
 ];
 const BRAND_COLOR = (0, _storm_software_config_tools_utilities_colors.getColor)("brand");
 /**
@@ -111,7 +99,9 @@ const BRAND_COLOR = (0, _storm_software_config_tools_utilities_colors.getColor)(
 * @return A hexadecimal color string.
 */
 const getTextColor = (text) => {
-	return BADGE_COLORS[text.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0];
+	let code = 0;
+	for (let i = 0; i < text.length; ++i) code += text.charCodeAt(i);
+	return colors[code % colors.length] ?? chalk.default.cyanBright;
 };
 /**
 * Generate a consistent color based on the input text.
@@ -121,7 +111,7 @@ const getTextColor = (text) => {
 */
 const colorText = (text) => {
 	const title = (0, _stryke_string_format_title_case.titleCase)(text);
-	return chalk.default.hex(getTextColor(title))(title);
+	return getTextColor(title)(title);
 };
 /**
 * Generate a consistent color based on the input text.
@@ -131,7 +121,7 @@ const colorText = (text) => {
 */
 const colorBackground = (text) => {
 	const title = (0, _stryke_string_format_title_case.titleCase)(text);
-	return chalk.default.inverse.hex(getTextColor(title))(` ${title} `);
+	return chalk.default.inverse(getTextColor(title)(` ${title} `));
 };
 const consoleLog = (meta, ...args) => (0, _storm_software_config_tools_logger.getLogFn)((0, _storm_software_config_tools_logger.getLogLevel)(meta.category === require_constants_log_level.LogCategories.PERFORMANCE ? "performance" : meta.type), { logLevel: "all" })(`${meta.name ? chalk.default.bold.hex(BRAND_COLOR)((0, _stryke_string_format_kebab_case.kebabCase)(meta.name)) : ""}${meta.name ? chalk.default.grey(" > ") : ""}${meta.command ? `${chalk.default.bold.hex(BRAND_COLOR)((0, _stryke_string_format_kebab_case.kebabCase)(meta.command))}${chalk.default.grey(" > ")}` : ""}${meta.environment && (0, _stryke_string_format_kebab_case.kebabCase)(meta.environment) !== "default" ? `${chalk.default.bold.hex(BRAND_COLOR)((0, _stryke_string_format_kebab_case.kebabCase)(meta.environment))}${chalk.default.grey(" > ")}` : ""}${meta.plugin ? `${chalk.default.bold.hex(BRAND_COLOR)(meta.plugin)}${chalk.default.grey(" > ")}` : ""}${meta.source ? `${chalk.default.bold.hex(BRAND_COLOR)((0, _stryke_string_format_kebab_case.kebabCase)(meta.source))}${chalk.default.grey(" > ")}` : ""}${meta.category && meta.category !== require_constants_log_level.LogCategories.GENERAL && meta.category !== require_constants_log_level.LogCategories.PERFORMANCE ? `${colorBackground((0, _stryke_string_format_kebab_case.kebabCase)(meta.category))} ` : ""}${args.join(" ")} `.trim());
 function isValidLogLevel(logLevel, type) {
@@ -184,6 +174,19 @@ const validateLogger = (type, name, options, callback) => {
 				...options
 			},
 			message
+		} : message instanceof Error || message.error ? {
+			name,
+			plugin: options.plugin,
+			message: `${(message instanceof Error ? message : message.error)?.message ? (message instanceof Error ? message : message.error)?.name ? `[${message.name}]: ${message.message}` : message.message : JSON.stringify(message)}${(message instanceof Error ? message : message.error)?.stack ? `
+Stack Trace: ${message.stack}` : ""}`,
+			meta: {
+				type,
+				name,
+				category: require_constants_log_level.LogCategories.GENERAL,
+				logId: (0, _stryke_unique_id_uuid.uuid)(),
+				timestamp: Date.now(),
+				...options
+			}
 		} : {
 			name,
 			plugin: options.plugin,
@@ -447,40 +450,40 @@ const consoleLogger = (meta, message) => consoleLog({
 const createLogger = (name, options, callback = consoleLogger) => {
 	const result = {
 		options: {
-			...options,
-			name
+			name,
+			...options
 		},
 		error: validateLogger("error", name, {
-			...options,
-			name
+			name,
+			...options
 		}, (data) => callback({
 			...data.meta,
 			type: "error"
 		}, data.message)),
 		warn: validateLogger("warn", name, {
-			...options,
-			name
+			name,
+			...options
 		}, (data) => callback({
 			...data.meta,
 			type: "warn"
 		}, data.message)),
 		info: validateLogger("info", name, {
-			...options,
-			name
+			name,
+			...options
 		}, (data) => callback({
 			...data.meta,
 			type: "info"
 		}, data.message)),
 		debug: validateLogger("debug", name, {
-			...options,
-			name
+			name,
+			...options
 		}, (data) => callback({
 			...data.meta,
 			type: "debug"
 		}, data.message)),
 		trace: validateLogger("trace", name, {
-			...options,
-			name
+			name,
+			...options
 		}, (data) => callback({
 			...data.meta,
 			type: "trace"

package/dist/plugin-utils/logging.d.cts

@@ -1,6 +1,7 @@
 import { CustomLogger, LogCategory, LogFn, LogFnOptions, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogMeta, Logger, LoggerOptions } from "../types/logging.cjs";
 import { UnresolvedContext } from "../types/context.cjs";
 import { Mode } from "../types/config.cjs";
+import { ChalkInstance } from "chalk";
 
 //#region src/plugin-utils/logging.d.ts
 /**
@@ -31,7 +32,7 @@ declare function resolveLogLevel(logLevel?: LogLevelUserConfig, mode?: Mode): Lo
  * @param text - The input text to generate the color from.
  * @return A hexadecimal color string.
  */
-declare const getTextColor: (text: string) => string;
+declare const getTextColor: (text: string) => ChalkInstance;
 /**
  * Generate a consistent color based on the input text.
  *
@@ -89,7 +90,7 @@ declare const consoleLogger: LogFn;
  * @param options - The options to configure the logging function, including the source, command, environment, plugin, log level, custom logger, and colors. These options can be used to customize the appearance and behavior of the log messages generated by the logging function.
  * @returns A logging function.
  */
-declare const createLogger: (name: string, options: LoggerOptions, callback?: LogFn) => Logger;
+declare const createLogger: (name: string | undefined, options: LoggerOptions, callback?: LogFn) => Logger;
 /**
  * Extend a logging function with a specific name, adding a colored badge to the log output.
  *

package/dist/plugin-utils/logging.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;;AA+DA;;;;iBAAgB,SAAA,CAAU,QAAA;AAQ1B;;;;;AAyBA;AAzBA,iBAAgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;;AAkGH;cAAa,YAAA,GAAgB,IAAA;;;;AAiB7B;;;cAAa,SAAA,GAAa,IAAA;;AAY1B;;;;;cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBAwC7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;;AAXZ;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cA4IrD,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cAuFxD,SAAA,GAAa,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAA,KAAQ,MAAA;;;;;;;;cAuI5C,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAoEU,aAAA,EAAe,KAAA;;;;;;;;cAmBf,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,GAAU,KAAA,KACT,MAAA;AA5TH;;;;;;;AAAA,cAmXa,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}
+{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;;;AA+DA;;;;iBAAgB,SAAA,CAAU,QAAgB;AAQ1C;;;;AAAoD;AAyBpD;AAzBA,iBAAgB,SAAA,CAAU,OAA0B,EAAjB,iBAAiB;;;;;;;;iBAyBpC,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AAAsB;AAsFzB;cAAa,YAAA,GAAgB,IAAA,aAAe,aAO3C;;;AAAA;AAQD;;;cAAa,SAAA,GAAa,IAAY;AAAA;AAYtC;;;;AAA4C;AAZN,cAYzB,eAAA,GAAmB,IAAY;AAAA,cAM/B,UAAA,GAAc,IAAA,EAAM,OAAO,KAAK,IAAA;AAAA,iBAwC7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAQ;AAAA,iBAQlD,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAnDiC;AAwC7C;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAiCjE;;;;;;;AAxDiE;cA4LrD,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cAuFxD,SAAA,GAAa,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAA,KAAQ,MAAA;;;;;;;AAxQV;cA+YlC,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAoEU,aAAA,EAAe,KAUzB;;;;;;;;cASU,YAAA,GACX,IAAA,sBACA,OAAA,EAAS,aAAA,EACT,QAAA,GAAU,KAAA,KACT,MAAA;AA5TH;;;;;;;AAAA,cAmXa,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AArSjE;cA2TY,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}

package/dist/plugin-utils/logging.d.mts

@@ -1,6 +1,7 @@
 import { CustomLogger, LogCategory, LogFn, LogFnOptions, LogLevel, LogLevelResolvedConfig, LogLevelUserConfig, LogMeta, Logger, LoggerOptions } from "../types/logging.mjs";
 import { UnresolvedContext } from "../types/context.mjs";
 import { Mode } from "../types/config.mjs";
+import { ChalkInstance } from "chalk";
 
 //#region src/plugin-utils/logging.d.ts
 /**
@@ -31,7 +32,7 @@ declare function resolveLogLevel(logLevel?: LogLevelUserConfig, mode?: Mode): Lo
  * @param text - The input text to generate the color from.
  * @return A hexadecimal color string.
  */
-declare const getTextColor: (text: string) => string;
+declare const getTextColor: (text: string) => ChalkInstance;
 /**
  * Generate a consistent color based on the input text.
  *
@@ -89,7 +90,7 @@ declare const consoleLogger: LogFn;
  * @param options - The options to configure the logging function, including the source, command, environment, plugin, log level, custom logger, and colors. These options can be used to customize the appearance and behavior of the log messages generated by the logging function.
  * @returns A logging function.
  */
-declare const createLogger: (name: string, options: LoggerOptions, callback?: LogFn) => Logger;
+declare const createLogger: (name: string | undefined, options: LoggerOptions, callback?: LogFn) => Logger;
 /**
  * Extend a logging function with a specific name, adding a colored badge to the log output.
  *

package/dist/plugin-utils/logging.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;;AA+DA;;;;iBAAgB,SAAA,CAAU,QAAA;AAQ1B;;;;;AAyBA;AAzBA,iBAAgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;;AAkGH;cAAa,YAAA,GAAgB,IAAA;;;;AAiB7B;;;cAAa,SAAA,GAAa,IAAA;;AAY1B;;;;;cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBAwC7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;;AAXZ;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cA4IrD,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cAuFxD,SAAA,GAAa,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAA,KAAQ,MAAA;;;;;;;;cAuI5C,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAoEU,aAAA,EAAe,KAAA;;;;;;;;cAmBf,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,GAAU,KAAA,KACT,MAAA;AA5TH;;;;;;;AAAA,cAmXa,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}
+{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;;;AA+DA;;;;iBAAgB,SAAA,CAAU,QAAgB;AAQ1C;;;;AAAoD;AAyBpD;AAzBA,iBAAgB,SAAA,CAAU,OAA0B,EAAjB,iBAAiB;;;;;;;;iBAyBpC,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AAAsB;AAsFzB;cAAa,YAAA,GAAgB,IAAA,aAAe,aAO3C;;;AAAA;AAQD;;;cAAa,SAAA,GAAa,IAAY;AAAA;AAYtC;;;;AAA4C;AAZN,cAYzB,eAAA,GAAmB,IAAY;AAAA,cAM/B,UAAA,GAAc,IAAA,EAAM,OAAO,KAAK,IAAA;AAAA,iBAwC7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAQ;AAAA,iBAQlD,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAnDiC;AAwC7C;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAiCjE;;;;;;;AAxDiE;cA4LrD,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cAuFxD,SAAA,GAAa,MAAA,EAAQ,MAAA,EAAQ,KAAA,EAAO,KAAA,KAAQ,MAAA;;;;;;;AAxQV;cA+YlC,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAoEU,aAAA,EAAe,KAUzB;;;;;;;;cASU,YAAA,GACX,IAAA,sBACA,OAAA,EAAS,aAAA,EACT,QAAA,GAAU,KAAA,KACT,MAAA;AA5TH;;;;;;;AAAA,cAmXa,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AArSjE;cA2TY,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}