@powerlines/core 0.44.0 → 0.44.2

package/dist/lib/utilities/index.cjs

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_lib_utilities_format = require('./format.cjs');
 const require_lib_utilities_source_file = require('./source-file.cjs');
 const require_lib_utilities_file_header = require('./file-header.cjs');
+const require_lib_utilities_format = require('./format.cjs');
 const require_lib_utilities_source_map = require('./source-map.cjs');
 const require_lib_utilities_write_file = require('./write-file.cjs');
 

package/dist/lib/utilities/index.mjs

@@ -1,6 +1,6 @@
-import { format, formatFolder } from "./format.mjs";
 import { getMagicString, getSourceFile, getString } from "./source-file.mjs";
 import { getFileHeader, getFileHeaderWarning, getFileHeaderWarningText, getTypescriptFileHeader } from "./file-header.mjs";
+import { format, formatFolder } from "./format.mjs";
 import { generateSourceMap } from "./source-map.mjs";
 import { writeFile } from "./write-file.mjs";
 

package/dist/lib/utilities/write-file.d.cts

@@ -1,4 +1,4 @@
-import { LogFn } from "../../types/log.cjs";
+import { LogFn } from "../../types/logging.cjs";
 
 //#region src/lib/utilities/write-file.d.ts
 /**

package/dist/lib/utilities/write-file.d.mts

@@ -1,4 +1,4 @@
-import { LogFn } from "../../types/log.mjs";
+import { LogFn } from "../../types/logging.mjs";
 
 //#region src/lib/utilities/write-file.d.ts
 /**

package/dist/lib/utilities/write-file.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"write-file.mjs","names":["writeFileBase"],"sources":["../../../src/lib/utilities/write-file.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 { writeFile as writeFileBase } from \"@stryke/fs/write-file\";\nimport { format, resolveConfig } from \"prettier\";\nimport type { LogFn } from \"../../types/log\";\n\n/**\n * Writes and formats a file to the file system\n *\n * @param log - The logging function to use for logging errors\n * @param filepath - The file path to write the file\n * @param content - The content to write to the file\n * @param skipFormat - Should the plugin skip formatting the `content` string with Prettier\n */\nexport async function writeFile(\n  log: LogFn,\n  filepath: string,\n  content: string,\n  skipFormat = false\n) {\n  try {\n    if (skipFormat) {\n      await writeFileBase(filepath, content);\n    } else {\n      const config = await resolveConfig(filepath);\n      const formatted = await format(content, {\n        ...(config ?? {}),\n        filepath\n      });\n\n      await writeFileBase(filepath, formatted || \"\");\n    }\n  } catch (error) {\n    log(\n      \"error\",\n      `Failed to write file ${filepath} to disk \\n${(error as Error)?.message ? (error as Error).message : \"\"}`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,eAAsB,UACpB,KACA,UACA,SACA,aAAa,OACb;AACA,KAAI;AACF,MAAI,WACF,OAAMA,YAAc,UAAU,QAAQ;MAQtC,OAAMA,YAAc,UAAU,MALN,OAAO,SAAS;GACtC,GAAI,MAFe,cAAc,SAAS,IAE5B,EAAE;GAChB;GACD,CAAC,IAEyC,GAAG;UAEzC,OAAO;AACd,MACE,SACA,wBAAwB,SAAS,aAAc,OAAiB,UAAW,MAAgB,UAAU,KACtG"}
+{"version":3,"file":"write-file.mjs","names":["writeFileBase"],"sources":["../../../src/lib/utilities/write-file.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 { writeFile as writeFileBase } from \"@stryke/fs/write-file\";\nimport { format, resolveConfig } from \"prettier\";\nimport type { LogFn } from \"../../types/logging\";\n\n/**\n * Writes and formats a file to the file system\n *\n * @param log - The logging function to use for logging errors\n * @param filepath - The file path to write the file\n * @param content - The content to write to the file\n * @param skipFormat - Should the plugin skip formatting the `content` string with Prettier\n */\nexport async function writeFile(\n  log: LogFn,\n  filepath: string,\n  content: string,\n  skipFormat = false\n) {\n  try {\n    if (skipFormat) {\n      await writeFileBase(filepath, content);\n    } else {\n      const config = await resolveConfig(filepath);\n      const formatted = await format(content, {\n        ...(config ?? {}),\n        filepath\n      });\n\n      await writeFileBase(filepath, formatted || \"\");\n    }\n  } catch (error) {\n    log(\n      \"error\",\n      `Failed to write file ${filepath} to disk \\n${(error as Error)?.message ? (error as Error).message : \"\"}`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,eAAsB,UACpB,KACA,UACA,SACA,aAAa,OACb;AACA,KAAI;AACF,MAAI,WACF,OAAMA,YAAc,UAAU,QAAQ;MAQtC,OAAMA,YAAc,UAAU,MALN,OAAO,SAAS;GACtC,GAAI,MAFe,cAAc,SAAS,IAE5B,EAAE;GAChB;GACD,CAAC,IAEyC,GAAG;UAEzC,OAAO;AACd,MACE,SACA,wBAAwB,SAAS,aAAc,OAAiB,UAAW,MAAgB,UAAU,KACtG"}

package/dist/plugin-utils/index.cjs

@@ -1,5 +1,6 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_plugin_utils_paths = require('./paths.cjs');
+const require_plugin_utils_format_package_json = require('./format-package-json.cjs');
 const require_plugin_utils_build_helpers = require('./build-helpers.cjs');
 const require_plugin_utils_helpers = require('./helpers.cjs');
 const require_plugin_utils_merge = require('./merge.cjs');
@@ -8,21 +9,28 @@ const require_plugin_utils_context_helpers = require('./context-helpers.cjs');
 const require_plugin_utils_docs_helper = require('./docs-helper.cjs');
 const require_plugin_utils_extend = require('./extend.cjs');
 const require_plugin_utils_filter = require('./filter.cjs');
-const require_plugin_utils_format_package_json = require('./format-package-json.cjs');
 const require_plugin_utils_get_config_path = require('./get-config-path.cjs');
 const require_plugin_utils_logging = require('./logging.cjs');
 const require_plugin_utils_modules = require('./modules.cjs');
 
 exports.addPluginHook = require_plugin_utils_helpers.addPluginHook;
+exports.colorBackground = require_plugin_utils_logging.colorBackground;
+exports.colorText = require_plugin_utils_logging.colorText;
 exports.combinePluginOptions = require_plugin_utils_combine_plugins.combinePluginOptions;
 exports.combinePlugins = require_plugin_utils_combine_plugins.combinePlugins;
+exports.consoleLog = require_plugin_utils_logging.consoleLog;
+exports.consoleLogger = require_plugin_utils_logging.consoleLogger;
 exports.createCodeFilter = require_plugin_utils_filter.createCodeFilter;
 exports.createFilter = require_plugin_utils_filter.createFilter;
 exports.createFilterForId = require_plugin_utils_filter.createFilterForId;
 exports.createFilterForTransform = require_plugin_utils_filter.createFilterForTransform;
 exports.createIdFilter = require_plugin_utils_filter.createIdFilter;
+exports.createLogFn = require_plugin_utils_logging.createLogFn;
+exports.createLogger = require_plugin_utils_logging.createLogger;
 exports.dedupeHooklist = require_plugin_utils_helpers.dedupeHooklist;
 exports.extend = require_plugin_utils_extend.extend;
+exports.extendLogFn = require_plugin_utils_logging.extendLogFn;
+exports.extendLogger = require_plugin_utils_logging.extendLogger;
 exports.extractPluginHook = require_plugin_utils_helpers.extractPluginHook;
 exports.findInvalidPluginConfig = require_plugin_utils_helpers.findInvalidPluginConfig;
 exports.formatPackageJson = require_plugin_utils_format_package_json.formatPackageJson;
@@ -31,6 +39,7 @@ exports.getDependencyConfig = require_plugin_utils_build_helpers.getDependencyCo
 exports.getDocsOutputPath = require_plugin_utils_docs_helper.getDocsOutputPath;
 exports.getHookHandler = require_plugin_utils_helpers.getHookHandler;
 exports.getOrganizationName = require_plugin_utils_context_helpers.getOrganizationName;
+exports.getTextColor = require_plugin_utils_logging.getTextColor;
 exports.getWorkspaceName = require_plugin_utils_context_helpers.getWorkspaceName;
 exports.isBuiltinModule = require_plugin_utils_modules.isBuiltinModule;
 exports.isDuplicate = require_plugin_utils_helpers.isDuplicate;
@@ -44,6 +53,8 @@ exports.isPluginHookFunction = require_plugin_utils_helpers.isPluginHookFunction
 exports.isPluginHookObject = require_plugin_utils_helpers.isPluginHookObject;
 exports.isUnpluginHookField = require_plugin_utils_helpers.isUnpluginHookField;
 exports.isUnpluginHookKey = require_plugin_utils_helpers.isUnpluginHookKey;
+exports.isValidLogLevel = require_plugin_utils_logging.isValidLogLevel;
+exports.isValidLogLevelConfig = require_plugin_utils_logging.isValidLogLevelConfig;
 exports.isVerbose = require_plugin_utils_logging.isVerbose;
 exports.merge = require_plugin_utils_merge.merge;
 exports.mergeConfig = require_plugin_utils_merge.mergeConfig;
@@ -51,4 +62,6 @@ exports.normalizeFilter = require_plugin_utils_filter.normalizeFilter;
 exports.patternToCodeFilter = require_plugin_utils_filter.patternToCodeFilter;
 exports.patternToIdFilter = require_plugin_utils_filter.patternToIdFilter;
 exports.replacePathTokens = require_plugin_utils_paths.replacePathTokens;
-exports.resolveLogLevel = require_plugin_utils_logging.resolveLogLevel;
+exports.resolveLogLevel = require_plugin_utils_logging.resolveLogLevel;
+exports.withCustomLogger = require_plugin_utils_logging.withCustomLogger;
+exports.withLogger = require_plugin_utils_logging.withLogger;

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

@@ -7,8 +7,8 @@ import { createCodeFilter, createFilter, createFilterForId, createFilterForTrans
 import { formatPackageJson } from "./format-package-json.cjs";
 import { getConfigPath } from "./get-config-path.cjs";
 import { GetHookHandlerReturnType, __ΩGetHookHandlerReturnType, addPluginHook, dedupeHooklist, extractPluginHook, findInvalidPluginConfig, getHookHandler, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey } from "./helpers.cjs";
-import { isVerbose, resolveLogLevel } from "./logging.cjs";
+import { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogger } from "./logging.cjs";
 import { MergeResult, __ΩMergeResult, merge, mergeConfig } from "./merge.cjs";
 import { isBuiltinModule } from "./modules.cjs";
 import { replacePathTokens } from "./paths.cjs";
-export { CombinePluginsOptions, GetDependencyConfigResult, GetHookHandlerReturnType, MergeResult, __ΩCombinePluginsOptions, __ΩGetDependencyConfigResult, __ΩGetHookHandlerReturnType, __ΩMergeResult, addPluginHook, combinePluginOptions, combinePlugins, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, dedupeHooklist, extend, extractPluginHook, findInvalidPluginConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isVerbose, merge, mergeConfig, normalizeFilter, patternToCodeFilter, patternToIdFilter, replacePathTokens, resolveLogLevel };
+export { CombinePluginsOptions, GetDependencyConfigResult, GetHookHandlerReturnType, MergeResult, __ΩCombinePluginsOptions, __ΩGetDependencyConfigResult, __ΩGetHookHandlerReturnType, __ΩMergeResult, addPluginHook, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, dedupeHooklist, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getTextColor, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, merge, mergeConfig, normalizeFilter, patternToCodeFilter, patternToIdFilter, replacePathTokens, resolveLogLevel, withCustomLogger, withLogger };

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

@@ -7,8 +7,8 @@ import { createCodeFilter, createFilter, createFilterForId, createFilterForTrans
 import { formatPackageJson } from "./format-package-json.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 { isVerbose, resolveLogLevel } from "./logging.mjs";
+import { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogger } from "./logging.mjs";
 import { MergeResult, __ΩMergeResult, merge, mergeConfig } from "./merge.mjs";
 import { isBuiltinModule } from "./modules.mjs";
 import { replacePathTokens } from "./paths.mjs";
-export { CombinePluginsOptions, GetDependencyConfigResult, GetHookHandlerReturnType, MergeResult, __ΩCombinePluginsOptions, __ΩGetDependencyConfigResult, __ΩGetHookHandlerReturnType, __ΩMergeResult, addPluginHook, combinePluginOptions, combinePlugins, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, dedupeHooklist, extend, extractPluginHook, findInvalidPluginConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isVerbose, merge, mergeConfig, normalizeFilter, patternToCodeFilter, patternToIdFilter, replacePathTokens, resolveLogLevel };
+export { CombinePluginsOptions, GetDependencyConfigResult, GetHookHandlerReturnType, MergeResult, __ΩCombinePluginsOptions, __ΩGetDependencyConfigResult, __ΩGetHookHandlerReturnType, __ΩMergeResult, addPluginHook, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, dedupeHooklist, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getTextColor, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, merge, mergeConfig, normalizeFilter, patternToCodeFilter, patternToIdFilter, replacePathTokens, resolveLogLevel, withCustomLogger, withLogger };

package/dist/plugin-utils/index.mjs

@@ -1,4 +1,5 @@
 import { replacePathTokens } from "./paths.mjs";
+import { formatPackageJson } from "./format-package-json.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";
@@ -7,9 +8,8 @@ import { getOrganizationName, getWorkspaceName } from "./context-helpers.mjs";
 import { getDocsOutputPath } from "./docs-helper.mjs";
 import { extend } from "./extend.mjs";
 import { createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, normalizeFilter, patternToCodeFilter, patternToIdFilter } from "./filter.mjs";
-import { formatPackageJson } from "./format-package-json.mjs";
 import { getConfigPath } from "./get-config-path.mjs";
-import { isVerbose, resolveLogLevel } from "./logging.mjs";
+import { colorBackground, colorText, consoleLog, consoleLogger, createLogFn, createLogger, extendLogFn, extendLogger, getTextColor, isValidLogLevel, isValidLogLevelConfig, isVerbose, resolveLogLevel, withCustomLogger, withLogger } from "./logging.mjs";
 import { isBuiltinModule } from "./modules.mjs";
 
-export { addPluginHook, combinePluginOptions, combinePlugins, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, dedupeHooklist, extend, extractPluginHook, findInvalidPluginConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isVerbose, merge, mergeConfig, normalizeFilter, patternToCodeFilter, patternToIdFilter, replacePathTokens, resolveLogLevel };
+export { addPluginHook, colorBackground, colorText, combinePluginOptions, combinePlugins, consoleLog, consoleLogger, createCodeFilter, createFilter, createFilterForId, createFilterForTransform, createIdFilter, createLogFn, createLogger, dedupeHooklist, extend, extendLogFn, extendLogger, extractPluginHook, findInvalidPluginConfig, formatPackageJson, getConfigPath, getDependencyConfig, getDocsOutputPath, getHookHandler, getOrganizationName, getTextColor, getWorkspaceName, isBuiltinModule, isDuplicate, isPlugin, isPluginConfig, isPluginConfigObject, isPluginConfigTuple, isPluginHook, isPluginHookField, isPluginHookFunction, isPluginHookObject, isUnpluginHookField, isUnpluginHookKey, isValidLogLevel, isValidLogLevelConfig, isVerbose, merge, mergeConfig, normalizeFilter, patternToCodeFilter, patternToIdFilter, replacePathTokens, resolveLogLevel, withCustomLogger, withLogger };

package/dist/plugin-utils/logging.cjs

@@ -1,10 +1,19 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_logging = require('../types/logging.cjs');
+const require_environments = require('../constants/environments.cjs');
 const require_log_level = require('../constants/log-level.cjs');
 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 _stryke_string_format_title_case = require("@stryke/string-format/title-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_unique_id_uuid = require("@stryke/unique-id/uuid");
+let chalk = require("chalk");
+chalk = require_runtime.__toESM(chalk, 1);
 
 //#region src/plugin-utils/logging.ts
 /**
@@ -34,7 +43,8 @@ function resolveLogLevel(logLevel, mode) {
 		hooks: "trace",
 		env: "trace",
 		ipc: "trace",
-		config: "trace"
+		config: "trace",
+		babel: "trace"
 	};
 	else if (logLevel === "silent") return {
 		general: "silent",
@@ -45,7 +55,8 @@ function resolveLogLevel(logLevel, mode) {
 		hooks: "silent",
 		env: "silent",
 		ipc: "silent",
-		config: "silent"
+		config: "silent",
+		babel: "silent"
 	};
 	let defaultLogLevel;
 	if (mode === "development") defaultLogLevel = require_log_level.DEFAULT_DEVELOPMENT_LOG_LEVEL;
@@ -60,12 +71,418 @@ function resolveLogLevel(logLevel, mode) {
 		hooks: logLevel,
 		env: defaultLogLevel.env,
 		ipc: defaultLogLevel.ipc,
-		config: defaultLogLevel.config
+		config: defaultLogLevel.config,
+		babel: logLevel
 	};
 	else if ((0, _stryke_type_checks_is_set_object.isSetObject)(logLevel)) return (0, defu.defu)(logLevel, defaultLogLevel);
 	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 BRAND_COLOR = (0, _storm_software_config_tools_utilities_colors.getColor)("brand");
+/**
+* Generate a consistent color based on the input text.
+*
+* @param text - The input text to generate the color from.
+* @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];
+};
+/**
+* Generate a consistent color based on the input text.
+*
+* @param text - The input text to generate the color from.
+* @return A hexadecimal color string.
+*/
+const colorText = (text) => {
+	const title = (0, _stryke_string_format_title_case.titleCase)(text);
+	return chalk.default.hex(getTextColor(title))(title);
+};
+/**
+* Generate a consistent color based on the input text.
+*
+* @param text - The input text to generate the color from.
+* @return A hexadecimal color string.
+*/
+const colorBackground = (text) => {
+	const title = (0, _stryke_string_format_title_case.titleCase)(text);
+	return chalk.default.inverse.hex(getTextColor(title))(` ${title} `);
+};
+const consoleLog = (meta, ...args) => (0, _storm_software_config_tools_logger.getLogFn)((0, _storm_software_config_tools_logger.getLogLevel)(meta.type), { logLevel: "trace" })(`${meta.name ? chalk.default.bold.hex(BRAND_COLOR)((0, _stryke_string_format_kebab_case.kebabCase)(meta.name)) : ""}${meta.command ? chalk.default.hex(BRAND_COLOR)(` (${meta.command})`) : ""}${meta.name ? chalk.default.grey(" > ") : ""}${(meta.source || meta.plugin) && (!meta.name || (0, _stryke_string_format_kebab_case.kebabCase)(meta.source || meta.plugin) !== (0, _stryke_string_format_kebab_case.kebabCase)(meta.name)) ? `${chalk.default.bold.hex(BRAND_COLOR)((0, _stryke_string_format_kebab_case.kebabCase)(meta.source || meta.plugin))}${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.category && meta.category !== require_logging.LogCategories.GENERAL ? `${colorBackground((0, _stryke_string_format_kebab_case.kebabCase)(meta.category))} ` : ""}${args.join(" ")} `.trim());
+function isValidLogLevel(logLevel, type) {
+	if (logLevel === require_logging.LogLevels.SILENT) return false;
+	return require_logging.LOG_LEVELS.indexOf(logLevel) >= require_logging.LOG_LEVELS.indexOf(type);
+}
+function isValidLogLevelConfig(type, logLevel, category = require_logging.LogCategories.GENERAL) {
+	return isValidLogLevel(logLevel[category], type);
+}
+/**
+* Create a logging function with a specific name and options.
+*
+* @param name - The name of the logging function.
+* @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.
+*/
+const createLogFn = (name, options) => {
+	const logLevel = resolveLogLevel(options.logLevel, options.mode);
+	return (meta, ...args) => {
+		const logMeta = (0, _stryke_type_checks_is_set_object.isSetObject)(meta) ? {
+			logId: (0, _stryke_unique_id_uuid.uuid)(),
+			timestamp: Date.now(),
+			category: require_logging.LogCategories.GENERAL,
+			...options,
+			...meta,
+			name
+		} : {
+			logId: (0, _stryke_unique_id_uuid.uuid)(),
+			timestamp: Date.now(),
+			category: require_logging.LogCategories.GENERAL,
+			...options,
+			type: meta,
+			name
+		};
+		if (isValidLogLevelConfig(logMeta.type, logLevel, logMeta.category ? logMeta.category : require_logging.LogCategories.GENERAL)) consoleLog(logMeta, ...args);
+	};
+};
+const validateLogger = (type, name, options, callback) => {
+	const logLevel = resolveLogLevel(options.logLevel, options.mode);
+	return (message) => {
+		const params = (0, _stryke_type_checks_is_set_string.isSetString)(message) ? {
+			name,
+			plugin: options.plugin,
+			meta: {
+				type,
+				name,
+				category: require_logging.LogCategories.GENERAL,
+				logId: (0, _stryke_unique_id_uuid.uuid)(),
+				timestamp: Date.now(),
+				...options
+			},
+			message
+		} : {
+			name,
+			plugin: options.plugin,
+			...message,
+			meta: {
+				type,
+				name,
+				category: require_logging.LogCategories.GENERAL,
+				logId: (0, _stryke_unique_id_uuid.uuid)(),
+				timestamp: Date.now(),
+				plugin: message.plugin,
+				...options,
+				...message.meta
+			}
+		};
+		if (isValidLogLevelConfig(type, logLevel, params.meta.category)) callback(params);
+	};
+};
+const validateCustomLogger = (type, name, options, callback, customCallback) => {
+	const logLevel = resolveLogLevel(options.logLevel, options.mode);
+	return (message) => {
+		const params = (0, _stryke_type_checks_is_set_string.isSetString)(message) ? {
+			name,
+			plugin: options.plugin,
+			meta: {
+				type,
+				name,
+				category: require_logging.LogCategories.GENERAL,
+				logId: (0, _stryke_unique_id_uuid.uuid)(),
+				timestamp: Date.now(),
+				...options
+			},
+			message
+		} : {
+			name,
+			plugin: options.plugin,
+			...message,
+			meta: {
+				type,
+				name,
+				category: require_logging.LogCategories.GENERAL,
+				logId: (0, _stryke_unique_id_uuid.uuid)(),
+				timestamp: Date.now(),
+				plugin: message.plugin,
+				...options,
+				...message.meta
+			}
+		};
+		if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {
+			callback?.(params);
+			customCallback?.(params);
+		}
+	};
+};
+/**
+* Create a logging function with a specific name and options.
+*
+* @param logger - The original logger to wrap with the custom logger.
+* @param secondaryLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.
+* @returns A new logger that combines the original logger's options with the custom logger's methods, allowing for customized logging behavior while still maintaining the original logger's configuration.
+*/
+const withLogger = (logger, secondaryLogger) => {
+	const options = {
+		...secondaryLogger.options,
+		...logger.options
+	};
+	const result = {
+		options,
+		error: validateLogger("error", options.name, options, (message) => {
+			logger.error?.(message);
+			secondaryLogger.error?.(message);
+		}),
+		warn: validateLogger("warn", options.name, options, (message) => {
+			logger.warn?.(message);
+			secondaryLogger.warn?.(message);
+		}),
+		info: validateLogger("info", options.name, options, (message) => {
+			logger.info?.(message);
+			secondaryLogger.info?.(message);
+		}),
+		debug: validateLogger("debug", options.name, options, (message) => {
+			logger.debug?.(message);
+			secondaryLogger.debug?.(message);
+		}),
+		trace: validateLogger("trace", options.name, options, (message) => {
+			logger.trace?.(message);
+			secondaryLogger.trace?.(message);
+		})
+	};
+	result.log = (type, message) => {
+		switch (type) {
+			case "error":
+				result.error(message);
+				break;
+			case "warn":
+				result.warn(message);
+				break;
+			case "info":
+				result.info(message);
+				break;
+			case "debug":
+				result.debug(message);
+				break;
+			case "trace":
+				result.trace(message);
+				break;
+			case "silent": break;
+			default:
+				result.info(message);
+				break;
+		}
+	};
+	return result;
+};
+/**
+* Create a logging function with a specific name and options.
+*
+* @param logger - The original logger to wrap with the custom logger.
+* @param customLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.
+* @returns A new logger that combines the original logger's options with the custom logger's methods, allowing for customized logging behavior while still maintaining the original logger's configuration.
+*/
+const withCustomLogger = (logger, customLogger) => {
+	const result = {
+		options: logger.options,
+		error: validateCustomLogger("error", logger.options.name, logger.options, logger.error.bind(logger), customLogger.error?.bind(customLogger)),
+		warn: validateCustomLogger("warn", logger.options.name, logger.options, logger.warn.bind(logger), customLogger.warn?.bind(customLogger)),
+		info: validateCustomLogger("info", logger.options.name, logger.options, logger.info.bind(logger), customLogger.info?.bind(customLogger)),
+		debug: validateCustomLogger("debug", logger.options.name, logger.options, logger.debug.bind(logger), customLogger.debug?.bind(customLogger)),
+		trace: validateCustomLogger("trace", logger.options.name, logger.options, logger.trace.bind(logger), customLogger.trace?.bind(customLogger))
+	};
+	result.log = (type, message) => {
+		switch (type) {
+			case "error":
+				result.error(message);
+				break;
+			case "warn":
+				result.warn(message);
+				break;
+			case "info":
+				result.info(message);
+				break;
+			case "debug":
+				result.debug(message);
+				break;
+			case "trace":
+				result.trace(message);
+				break;
+			case "silent": break;
+			default:
+				result.info(message);
+				break;
+		}
+	};
+	return result;
+};
+const consoleLogger = (type, message) => consoleLog((0, _stryke_type_checks_is_set_string.isSetString)(message) ? {
+	type,
+	category: require_logging.LogCategories.GENERAL,
+	logId: (0, _stryke_unique_id_uuid.uuid)(),
+	timestamp: Date.now()
+} : {
+	type,
+	category: require_logging.LogCategories.GENERAL,
+	logId: (0, _stryke_unique_id_uuid.uuid)(),
+	timestamp: Date.now(),
+	...message.meta
+}, (0, _stryke_type_checks_is_set_string.isSetString)(message) ? message : message.message);
+/**
+* Create a logging function with a specific name and options.
+*
+* @param name - The name of the logging function.
+* @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.
+*/
+const createLogger = (name, options, callback = consoleLogger) => {
+	const result = {
+		options: {
+			...options,
+			name
+		},
+		error: validateLogger("error", name, {
+			...options,
+			name
+		}, (message) => callback("error", message)),
+		warn: validateLogger("warn", name, {
+			...options,
+			name
+		}, (message) => callback("warn", message)),
+		info: validateLogger("info", name, {
+			...options,
+			name
+		}, (message) => callback("info", message)),
+		debug: validateLogger("debug", name, {
+			...options,
+			name
+		}, (message) => callback("debug", message)),
+		trace: validateLogger("trace", name, {
+			...options,
+			name
+		}, (message) => callback("trace", message))
+	};
+	result.log = (type, message) => {
+		switch (type) {
+			case "error":
+				result.error(message);
+				break;
+			case "warn":
+				result.warn(message);
+				break;
+			case "info":
+				result.info(message);
+				break;
+			case "debug":
+				result.debug(message);
+				break;
+			case "trace":
+				result.trace(message);
+				break;
+			case "silent": break;
+			default:
+				result.info(message);
+				break;
+		}
+	};
+	return result;
+};
+/**
+* Extend a logging function with a specific name, adding a colored badge to the log output.
+*
+* @param logFn - The original logging function to extend.
+* @param options - The overlay metadata to use for the badge in the log output.
+* @returns A new logging function that includes the badge in its output.
+*/
+const extendLogFn = (logFn, options) => {
+	return (meta, ...args) => options.source || options.category ? logFn((0, _stryke_type_checks_is_set_object.isSetObject)(meta) ? {
+		...options,
+		...meta
+	} : {
+		...options,
+		type: meta
+	}, `${colorBackground(String(options.source || options.category))} ${args.filter(Boolean).map((arg) => String(arg).trim()).join(" ")} `) : logFn(meta, ...args);
+};
+/**
+* Extend a logger with a specific name and options, adding a colored badge to the log output for each log message generated by the logger.
+*
+* @param logger - The original logger to extend.
+* @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 extended logger.
+* @returns A new logger that includes the badge in its output for each log message.
+*/
+const extendLogger = (logger, options) => {
+	const opts = {
+		...logger.options,
+		...options
+	};
+	const result = {
+		options: opts,
+		error: validateLogger("error", opts.name, opts, logger.error.bind(logger)),
+		warn: validateLogger("warn", opts.name, opts, logger.warn.bind(logger)),
+		info: validateLogger("info", opts.name, opts, logger.info.bind(logger)),
+		debug: validateLogger("debug", opts.name, opts, logger.debug.bind(logger)),
+		trace: validateLogger("trace", opts.name, opts, logger.trace.bind(logger))
+	};
+	result.log = (type, message) => {
+		switch (type) {
+			case "error":
+				result.error(message);
+				break;
+			case "warn":
+				result.warn(message);
+				break;
+			case "info":
+				result.info(message);
+				break;
+			case "debug":
+				result.debug(message);
+				break;
+			case "trace":
+				result.trace(message);
+				break;
+			case "silent": break;
+			default:
+				result.info(message);
+				break;
+		}
+	};
+	return result;
+};
 
 //#endregion
+exports.colorBackground = colorBackground;
+exports.colorText = colorText;
+exports.consoleLog = consoleLog;
+exports.consoleLogger = consoleLogger;
+exports.createLogFn = createLogFn;
+exports.createLogger = createLogger;
+exports.extendLogFn = extendLogFn;
+exports.extendLogger = extendLogger;
+exports.getTextColor = getTextColor;
+exports.isValidLogLevel = isValidLogLevel;
+exports.isValidLogLevelConfig = isValidLogLevelConfig;
 exports.isVerbose = isVerbose;
-exports.resolveLogLevel = resolveLogLevel;
+exports.resolveLogLevel = resolveLogLevel;
+exports.withCustomLogger = withCustomLogger;
+exports.withLogger = withLogger;