@powerlines/core 0.43.31 → 0.44.0

package/dist/lib/logger.d.cts

@@ -1,24 +1,6 @@
-import { LogFn, WorkspaceConfig } from "../types/config.cjs";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { LogFn, LogFnConfig } from "../types/log.cjs";
 
 //#region src/lib/logger.d.ts
-interface CreateLogOptions {
-  source?: string;
-  command?: string;
-  environment?: string;
-  plugin?: string;
-  logLevel?: LogLevelLabel | null;
-  customLogger?: LogFn;
-  colors?: WorkspaceConfig["colors"];
-}
-/**
- * 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.
- * @returns A logging function.
- */
-declare const createLog: (name: string | null, options?: CreateLogOptions) => LogFn;
 /**
  * Generate a consistent color based on the input text.
  *
@@ -40,15 +22,21 @@ declare const colorText: (text: string) => string;
  * @return A hexadecimal color string.
  */
 declare const colorBackground: (text: string) => string;
+/**
+ * Create a logging function with a specific name and options.
+ *
+ * @param config - 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 createLogFn: (config: LogFnConfig) => LogFn;
 /**
  * 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 name - The name to use for the badge in the log output.
+ * @param config - The overlay metadata to use for the badge in the log output.
  * @returns A new logging function that includes the badge in its output.
  */
-declare const extendLog: (logFn: LogFn, name: string) => LogFn;
-declare type __ΩCreateLogOptions = any[];
+declare const extendLogFn: (logFn: LogFn, config: LogFnConfig) => LogFn;
 //#endregion
-export { CreateLogOptions, __ΩCreateLogOptions, colorBackground, colorText, createLog, extendLog, getTextColor };
+export { colorBackground, colorText, createLogFn, extendLogFn, getTextColor };
 //# sourceMappingURL=logger.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.cts","names":[],"sources":["../../src/lib/logger.ts"],"mappings":";;;;UA4BiB,gBAAA;EACf,MAAA;EACA,OAAA;EACA,WAAA;EACA,MAAA;EACA,QAAA,GAAW,aAAA;EACX,YAAA,GAAe,KAAA;EACf,MAAA,GAAS,eAAA;AAAA;;;;;;;;cAUE,SAAA,GACX,IAAA,iBACA,OAAA,GAAS,gBAAA,KACR,KAAA;;;;;;;cAyEU,YAAA,GAAgB,IAAA;;;;;;;cAiBhB,SAAA,GAAa,IAAA;;;AAjB1B;;;;cA6Ba,eAAA,GAAmB,IAAA;AAZhC;;;;;AAYA;;AAZA,cAyBa,SAAA,GAAa,KAAA,EAAO,KAAA,EAAO,IAAA,aAAe,KAAA;AAAA"}
+{"version":3,"file":"logger.d.cts","names":[],"sources":["../../src/lib/logger.ts"],"mappings":";;;;;AA6DA;;;;cAAa,YAAA,GAAgB,IAAA;AAiB7B;;;;;AAYA;AAZA,cAAa,SAAA,GAAa,IAAA;;;;AAwB1B;;;cAZa,eAAA,GAAmB,IAAA;;;;;;AAgEhC;cApDa,WAAA,GAAe,MAAA,EAAQ,WAAA,KAAc,KAAA;;;;;;;;cAoDrC,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,WAAA,KAAc,KAAA"}

package/dist/lib/logger.d.mts

@@ -1,24 +1,6 @@
-import { LogFn, WorkspaceConfig } from "../types/config.mjs";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { LogFn, LogFnConfig } from "../types/log.mjs";
 
 //#region src/lib/logger.d.ts
-interface CreateLogOptions {
-  source?: string;
-  command?: string;
-  environment?: string;
-  plugin?: string;
-  logLevel?: LogLevelLabel | null;
-  customLogger?: LogFn;
-  colors?: WorkspaceConfig["colors"];
-}
-/**
- * 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.
- * @returns A logging function.
- */
-declare const createLog: (name: string | null, options?: CreateLogOptions) => LogFn;
 /**
  * Generate a consistent color based on the input text.
  *
@@ -40,15 +22,21 @@ declare const colorText: (text: string) => string;
  * @return A hexadecimal color string.
  */
 declare const colorBackground: (text: string) => string;
+/**
+ * Create a logging function with a specific name and options.
+ *
+ * @param config - 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 createLogFn: (config: LogFnConfig) => LogFn;
 /**
  * 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 name - The name to use for the badge in the log output.
+ * @param config - The overlay metadata to use for the badge in the log output.
  * @returns A new logging function that includes the badge in its output.
  */
-declare const extendLog: (logFn: LogFn, name: string) => LogFn;
-declare type __ΩCreateLogOptions = any[];
+declare const extendLogFn: (logFn: LogFn, config: LogFnConfig) => LogFn;
 //#endregion
-export { CreateLogOptions, __ΩCreateLogOptions, colorBackground, colorText, createLog, extendLog, getTextColor };
+export { colorBackground, colorText, createLogFn, extendLogFn, getTextColor };
 //# sourceMappingURL=logger.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/lib/logger.ts"],"mappings":";;;;UA4BiB,gBAAA;EACf,MAAA;EACA,OAAA;EACA,WAAA;EACA,MAAA;EACA,QAAA,GAAW,aAAA;EACX,YAAA,GAAe,KAAA;EACf,MAAA,GAAS,eAAA;AAAA;;;;;;;;cAUE,SAAA,GACX,IAAA,iBACA,OAAA,GAAS,gBAAA,KACR,KAAA;;;;;;;cAyEU,YAAA,GAAgB,IAAA;;;;;;;cAiBhB,SAAA,GAAa,IAAA;;;AAjB1B;;;;cA6Ba,eAAA,GAAmB,IAAA;AAZhC;;;;;AAYA;;AAZA,cAyBa,SAAA,GAAa,KAAA,EAAO,KAAA,EAAO,IAAA,aAAe,KAAA;AAAA"}
+{"version":3,"file":"logger.d.mts","names":[],"sources":["../../src/lib/logger.ts"],"mappings":";;;;;AA6DA;;;;cAAa,YAAA,GAAgB,IAAA;AAiB7B;;;;;AAYA;AAZA,cAAa,SAAA,GAAa,IAAA;;;;AAwB1B;;;cAZa,eAAA,GAAmB,IAAA;;;;;;AAgEhC;cApDa,WAAA,GAAe,MAAA,EAAQ,WAAA,KAAc,KAAA;;;;;;;;cAoDrC,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,WAAA,KAAc,KAAA"}

package/dist/lib/logger.mjs

@@ -1,6 +1,9 @@
 import { DEFAULT_ENVIRONMENT } from "../constants/environments.mjs";
+import { resolveLogLevel } from "../plugin-utils/logging.mjs";
+import "../plugin-utils/index.mjs";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
 import { getLogFn, getLogLevel } from "@storm-software/config-tools/logger";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
 import { getColor } from "@storm-software/config-tools/utilities/colors";
 import { noop } from "@stryke/helpers/noop";
 import { kebabCase } from "@stryke/string-format/kebab-case";
@@ -8,23 +11,6 @@ import { titleCase } from "@stryke/string-format/title-case";
 import chalk from "chalk";
 
 //#region src/lib/logger.ts
-/**
-* 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.
-* @returns A logging function.
-*/
-const createLog = (name, options = {}) => {
-	const logLevel = options.logLevel === null ? LogLevelLabel.SILENT : options.logLevel || LogLevelLabel.INFO;
-	if (logLevel === LogLevelLabel.SILENT) return noop;
-	if (options.customLogger) return options.customLogger;
-	const source = options.plugin || options.source;
-	return (type, ...args) => getLogFn(getLogLevel(type), {
-		...options,
-		logLevel
-	})(`${name ? chalk.bold.hex(getColor("brand", options))(kebabCase(name)) : ""}${options.command ? chalk.hex(getColor("brand", options))(` (${options.command})`) : ""}${name ? chalk.grey(" > ") : ""}${source && (!name || kebabCase(source) !== kebabCase(name)) ? `${chalk.bold.hex(getColor("brand", options))(kebabCase(source))}${chalk.grey(" > ")}` : ""}${options.environment && options.environment !== "default" ? `${chalk.bold.hex(getColor("brand", options))(kebabCase(options.environment))}${chalk.grey(" > ")}` : ""}${args.join(" ")} `.trim());
-};
 const BADGE_COLORS = [
 	"#00A0DD",
 	"#6FCE4E",
@@ -79,16 +65,36 @@ const colorBackground = (text) => {
 	return chalk.inverse.hex(getTextColor(title))(` ${title} `);
 };
 /**
+* Create a logging function with a specific name and options.
+*
+* @param config - 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 = (config) => {
+	if (config.logLevel === "silent") return noop;
+	const logLevel = resolveLogLevel(config.logLevel || "info", config.mode);
+	return (meta, ...args) => getLogFn(getLogLevel(isSetString(meta) ? meta : meta.level), {
+		...config,
+		logLevel: logLevel[isSetObject(meta) && isSetString(meta.category) ? meta.category : isSetString(meta) ? meta : "general"]
+	})(`${config.source ? chalk.bold.hex(getColor("brand", config))(kebabCase(config.source)) : ""}${config.command ? chalk.hex(getColor("brand", config))(` (${config.command})`) : ""}${config.source ? chalk.grey(" > ") : ""}${config.plugin && (!config.source || kebabCase(config.plugin) !== kebabCase(config.source)) ? `${chalk.bold.hex(getColor("brand", config))(kebabCase(config.plugin))}${chalk.grey(" > ")}` : ""}${config.environment && config.environment !== "default" ? `${chalk.bold.hex(getColor("brand", config))(kebabCase(config.environment))}${chalk.grey(" > ")}` : ""}${args.join(" ")} `.trim());
+};
+/**
 * 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 name - The name to use for the badge in the log output.
+* @param config - 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 extendLog = (logFn, name) => {
-	return (type, ...args) => logFn(type, `${colorBackground(name)} ${args.filter(Boolean).map((arg) => String(arg).trim()).join(" ")} `);
+const extendLogFn = (logFn, config) => {
+	return (meta, ...args) => config.source || config.category ? logFn(isSetObject(meta) ? {
+		...config,
+		...meta
+	} : {
+		...config,
+		level: meta
+	}, `${colorBackground(String(config.source || config.category))} ${args.filter(Boolean).map((arg) => String(arg).trim()).join(" ")} `) : logFn(meta, ...args);
 };
 
 //#endregion
-export { colorBackground, colorText, createLog, extendLog, getTextColor };
+export { colorBackground, colorText, createLogFn, extendLogFn, getTextColor };
 //# sourceMappingURL=logger.mjs.map

package/dist/lib/logger.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/lib/logger.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 { getLogFn, getLogLevel } from \"@storm-software/config-tools/logger\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { getColor } from \"@storm-software/config-tools/utilities/colors\";\nimport { noop } from \"@stryke/helpers/noop\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport chalk from \"chalk\";\nimport { DEFAULT_ENVIRONMENT } from \"../constants/environments\";\nimport type { LogFn, WorkspaceConfig } from \"../types\";\n\nexport interface CreateLogOptions {\n  source?: string;\n  command?: string;\n  environment?: string;\n  plugin?: string;\n  logLevel?: LogLevelLabel | null;\n  customLogger?: LogFn;\n  colors?: WorkspaceConfig[\"colors\"];\n}\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param name - The name of the logging function.\n * @param options - The options to configure the logging function.\n * @returns A logging function.\n */\nexport const createLog = (\n  name: string | null,\n  options: CreateLogOptions = {}\n): LogFn => {\n  const logLevel =\n    options.logLevel === null\n      ? LogLevelLabel.SILENT\n      : options.logLevel || LogLevelLabel.INFO;\n  if (logLevel === LogLevelLabel.SILENT) {\n    return noop;\n  }\n\n  if (options.customLogger) {\n    return options.customLogger;\n  }\n\n  const source = options.plugin || options.source;\n\n  return (type: LogLevelLabel, ...args: string[]) =>\n    getLogFn(getLogLevel(type), {\n      ...options,\n      logLevel\n    })(\n      `${\n        name ? chalk.bold.hex(getColor(\"brand\", options))(kebabCase(name)) : \"\"\n      }${\n        options.command\n          ? chalk.hex(getColor(\"brand\", options))(` (${options.command})`)\n          : \"\"\n      }${name ? chalk.grey(\" > \") : \"\"}${\n        source && (!name || kebabCase(source) !== kebabCase(name))\n          ? `${chalk.bold.hex(getColor(\"brand\", options))(\n              kebabCase(source)\n            )}${chalk.grey(\" > \")}`\n          : \"\"\n      }${\n        options.environment && options.environment !== DEFAULT_ENVIRONMENT\n          ? `${chalk.bold.hex(getColor(\"brand\", options))(\n              kebabCase(options.environment)\n            )}${chalk.grey(\" > \")}`\n          : \"\"\n      }${args.join(\" \")} `.trim()\n    );\n};\n\nconst BADGE_COLORS = [\n  \"#00A0DD\",\n  \"#6FCE4E\",\n  \"#FBBF24\",\n  \"#F43F5E\",\n  \"#3B82F6\",\n  \"#A855F7\",\n  \"#469592\",\n  \"#288EDF\",\n  \"#D8B4FE\",\n  \"#10B981\",\n  \"#EF4444\",\n  \"#F0EC56\",\n  \"#F472B6\",\n  \"#22D3EE\",\n  \"#EAB308\",\n  \"#84CC16\",\n  \"#F87171\",\n  \"#0EA5E9\",\n  \"#D946EF\",\n  \"#FACC15\",\n  \"#34D399\",\n  \"#8B5CF6\"\n] as const;\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const getTextColor = (text: string): string => {\n  return (\n    BADGE_COLORS[\n      text\n        .split(\"\")\n        .map(char => char.charCodeAt(0))\n        .reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length\n    ] || BADGE_COLORS[0]\n  );\n};\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const colorText = (text: string): string => {\n  const title = titleCase(text);\n\n  return chalk.hex(getTextColor(title))(title);\n};\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const colorBackground = (text: string): string => {\n  const title = titleCase(text);\n\n  return chalk.inverse.hex(getTextColor(title))(` ${title} `);\n};\n\n/**\n * Extend a logging function with a specific name, adding a colored badge to the log output.\n *\n * @param logFn - The original logging function to extend.\n * @param name - The name to use for the badge in the log output.\n * @returns A new logging function that includes the badge in its output.\n */\nexport const extendLog = (logFn: LogFn, name: string): LogFn => {\n  return (type: LogLevelLabel, ...args: string[]) =>\n    logFn(\n      type,\n      `${colorBackground(name)} ${args\n        .filter(Boolean)\n        .map(arg => String(arg).trim())\n        .join(\" \")} `\n    );\n};\n"],"mappings":";;;;;;;;;;;;;;;;;AA6CA,MAAa,aACX,MACA,UAA4B,EAAE,KACpB;CACV,MAAM,WACJ,QAAQ,aAAa,OACjB,cAAc,SACd,QAAQ,YAAY,cAAc;AACxC,KAAI,aAAa,cAAc,OAC7B,QAAO;AAGT,KAAI,QAAQ,aACV,QAAO,QAAQ;CAGjB,MAAM,SAAS,QAAQ,UAAU,QAAQ;AAEzC,SAAQ,MAAqB,GAAG,SAC9B,SAAS,YAAY,KAAK,EAAE;EAC1B,GAAG;EACH;EACD,CAAC,CACA,GACE,OAAO,MAAM,KAAK,IAAI,SAAS,SAAS,QAAQ,CAAC,CAAC,UAAU,KAAK,CAAC,GAAG,KAErE,QAAQ,UACJ,MAAM,IAAI,SAAS,SAAS,QAAQ,CAAC,CAAC,KAAK,QAAQ,QAAQ,GAAG,GAC9D,KACH,OAAO,MAAM,KAAK,MAAM,GAAG,KAC5B,WAAW,CAAC,QAAQ,UAAU,OAAO,KAAK,UAAU,KAAK,IACrD,GAAG,MAAM,KAAK,IAAI,SAAS,SAAS,QAAQ,CAAC,CAC3C,UAAU,OAAO,CAClB,GAAG,MAAM,KAAK,MAAM,KACrB,KAEJ,QAAQ,eAAe,QAAQ,4BAC3B,GAAG,MAAM,KAAK,IAAI,SAAS,SAAS,QAAQ,CAAC,CAC3C,UAAU,QAAQ,YAAY,CAC/B,GAAG,MAAM,KAAK,MAAM,KACrB,KACH,KAAK,KAAK,IAAI,CAAC,GAAG,MAAM,CAC5B;;AAGL,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;AAQD,MAAa,gBAAgB,SAAyB;AACpD,QACE,aACE,KACG,MAAM,GAAG,CACT,KAAI,SAAQ,KAAK,WAAW,EAAE,CAAC,CAC/B,QAAQ,KAAK,aAAa,MAAM,UAAU,EAAE,GAAG,aAAa,WAC5D,aAAa;;;;;;;;AAUtB,MAAa,aAAa,SAAyB;CACjD,MAAM,QAAQ,UAAU,KAAK;AAE7B,QAAO,MAAM,IAAI,aAAa,MAAM,CAAC,CAAC,MAAM;;;;;;;;AAS9C,MAAa,mBAAmB,SAAyB;CACvD,MAAM,QAAQ,UAAU,KAAK;AAE7B,QAAO,MAAM,QAAQ,IAAI,aAAa,MAAM,CAAC,CAAC,IAAI,MAAM,GAAG;;;;;;;;;AAU7D,MAAa,aAAa,OAAc,SAAwB;AAC9D,SAAQ,MAAqB,GAAG,SAC9B,MACE,MACA,GAAG,gBAAgB,KAAK,CAAC,GAAG,KACzB,OAAO,QAAQ,CACf,KAAI,QAAO,OAAO,IAAI,CAAC,MAAM,CAAC,CAC9B,KAAK,IAAI,CAAC,GACd"}
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../src/lib/logger.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 { getLogFn, getLogLevel } from \"@storm-software/config-tools/logger\";\nimport { getColor } from \"@storm-software/config-tools/utilities/colors\";\nimport { noop } from \"@stryke/helpers/noop\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport chalk from \"chalk\";\nimport { DEFAULT_ENVIRONMENT } from \"../constants/environments\";\nimport { resolveLogLevel } from \"../plugin-utils\";\nimport type { LogFn, LogFnConfig } from \"../types/log\";\n\nconst BADGE_COLORS = [\n  \"#00A0DD\",\n  \"#6FCE4E\",\n  \"#FBBF24\",\n  \"#F43F5E\",\n  \"#3B82F6\",\n  \"#A855F7\",\n  \"#469592\",\n  \"#288EDF\",\n  \"#D8B4FE\",\n  \"#10B981\",\n  \"#EF4444\",\n  \"#F0EC56\",\n  \"#F472B6\",\n  \"#22D3EE\",\n  \"#EAB308\",\n  \"#84CC16\",\n  \"#F87171\",\n  \"#0EA5E9\",\n  \"#D946EF\",\n  \"#FACC15\",\n  \"#34D399\",\n  \"#8B5CF6\"\n] as const;\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const getTextColor = (text: string): string => {\n  return (\n    BADGE_COLORS[\n      text\n        .split(\"\")\n        .map(char => char.charCodeAt(0))\n        .reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length\n    ] || BADGE_COLORS[0]\n  );\n};\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const colorText = (text: string): string => {\n  const title = titleCase(text);\n\n  return chalk.hex(getTextColor(title))(title);\n};\n\n/**\n * Generate a consistent color based on the input text.\n *\n * @param text - The input text to generate the color from.\n * @return A hexadecimal color string.\n */\nexport const colorBackground = (text: string): string => {\n  const title = titleCase(text);\n\n  return chalk.inverse.hex(getTextColor(title))(` ${title} `);\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param config - 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.\n * @returns A logging function.\n */\nexport const createLogFn = (config: LogFnConfig): LogFn => {\n  if (config.logLevel === \"silent\") {\n    return noop;\n  }\n\n  const logLevel = resolveLogLevel(config.logLevel || \"info\", config.mode);\n\n  return (meta, ...args) =>\n    getLogFn(getLogLevel(isSetString(meta) ? meta : meta.level), {\n      ...config,\n      logLevel:\n        logLevel[\n          (isSetObject(meta) && isSetString(meta.category)\n            ? meta.category\n            : isSetString(meta)\n              ? meta\n              : \"general\") as keyof typeof logLevel\n        ]\n    })(\n      `${\n        config.source\n          ? chalk.bold.hex(getColor(\"brand\", config))(kebabCase(config.source))\n          : \"\"\n      }${\n        config.command\n          ? chalk.hex(getColor(\"brand\", config))(` (${config.command})`)\n          : \"\"\n      }${config.source ? chalk.grey(\" > \") : \"\"}${\n        config.plugin &&\n        (!config.source ||\n          kebabCase(config.plugin) !== kebabCase(config.source))\n          ? `${chalk.bold.hex(getColor(\"brand\", config))(\n              kebabCase(config.plugin)\n            )}${chalk.grey(\" > \")}`\n          : \"\"\n      }${\n        config.environment && config.environment !== DEFAULT_ENVIRONMENT\n          ? `${chalk.bold.hex(getColor(\"brand\", config))(\n              kebabCase(config.environment)\n            )}${chalk.grey(\" > \")}`\n          : \"\"\n      }${args.join(\" \")} `.trim()\n    );\n};\n\n/**\n * Extend a logging function with a specific name, adding a colored badge to the log output.\n *\n * @param logFn - The original logging function to extend.\n * @param config - The overlay metadata to use for the badge in the log output.\n * @returns A new logging function that includes the badge in its output.\n */\nexport const extendLogFn = (logFn: LogFn, config: LogFnConfig): LogFn => {\n  return (meta, ...args) =>\n    config.source || config.category\n      ? logFn(\n          isSetObject(meta)\n            ? { ...config, ...meta }\n            : { ...config, level: meta },\n          `${colorBackground(String(config.source || config.category))} ${args\n            .filter(Boolean)\n            .map(arg => String(arg).trim())\n            .join(\" \")} `\n        )\n      : logFn(meta, ...args);\n};\n"],"mappings":";;;;;;;;;;;;;AA8BA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;;;;;;;AAQD,MAAa,gBAAgB,SAAyB;AACpD,QACE,aACE,KACG,MAAM,GAAG,CACT,KAAI,SAAQ,KAAK,WAAW,EAAE,CAAC,CAC/B,QAAQ,KAAK,aAAa,MAAM,UAAU,EAAE,GAAG,aAAa,WAC5D,aAAa;;;;;;;;AAUtB,MAAa,aAAa,SAAyB;CACjD,MAAM,QAAQ,UAAU,KAAK;AAE7B,QAAO,MAAM,IAAI,aAAa,MAAM,CAAC,CAAC,MAAM;;;;;;;;AAS9C,MAAa,mBAAmB,SAAyB;CACvD,MAAM,QAAQ,UAAU,KAAK;AAE7B,QAAO,MAAM,QAAQ,IAAI,aAAa,MAAM,CAAC,CAAC,IAAI,MAAM,GAAG;;;;;;;;AAS7D,MAAa,eAAe,WAA+B;AACzD,KAAI,OAAO,aAAa,SACtB,QAAO;CAGT,MAAM,WAAW,gBAAgB,OAAO,YAAY,QAAQ,OAAO,KAAK;AAExE,SAAQ,MAAM,GAAG,SACf,SAAS,YAAY,YAAY,KAAK,GAAG,OAAO,KAAK,MAAM,EAAE;EAC3D,GAAG;EACH,UACE,SACG,YAAY,KAAK,IAAI,YAAY,KAAK,SAAS,GAC5C,KAAK,WACL,YAAY,KAAK,GACf,OACA;EAEX,CAAC,CACA,GACE,OAAO,SACH,MAAM,KAAK,IAAI,SAAS,SAAS,OAAO,CAAC,CAAC,UAAU,OAAO,OAAO,CAAC,GACnE,KAEJ,OAAO,UACH,MAAM,IAAI,SAAS,SAAS,OAAO,CAAC,CAAC,KAAK,OAAO,QAAQ,GAAG,GAC5D,KACH,OAAO,SAAS,MAAM,KAAK,MAAM,GAAG,KACrC,OAAO,WACN,CAAC,OAAO,UACP,UAAU,OAAO,OAAO,KAAK,UAAU,OAAO,OAAO,IACnD,GAAG,MAAM,KAAK,IAAI,SAAS,SAAS,OAAO,CAAC,CAC1C,UAAU,OAAO,OAAO,CACzB,GAAG,MAAM,KAAK,MAAM,KACrB,KAEJ,OAAO,eAAe,OAAO,4BACzB,GAAG,MAAM,KAAK,IAAI,SAAS,SAAS,OAAO,CAAC,CAC1C,UAAU,OAAO,YAAY,CAC9B,GAAG,MAAM,KAAK,MAAM,KACrB,KACH,KAAK,KAAK,IAAI,CAAC,GAAG,MAAM,CAC5B;;;;;;;;;AAUL,MAAa,eAAe,OAAc,WAA+B;AACvE,SAAQ,MAAM,GAAG,SACf,OAAO,UAAU,OAAO,WACpB,MACE,YAAY,KAAK,GACb;EAAE,GAAG;EAAQ,GAAG;EAAM,GACtB;EAAE,GAAG;EAAQ,OAAO;EAAM,EAC9B,GAAG,gBAAgB,OAAO,OAAO,UAAU,OAAO,SAAS,CAAC,CAAC,GAAG,KAC7D,OAAO,QAAQ,CACf,KAAI,QAAO,OAAO,IAAI,CAAC,MAAM,CAAC,CAC9B,KAAK,IAAI,CAAC,GACd,GACD,MAAM,MAAM,GAAG,KAAK"}

package/dist/lib/unplugin/plugin.cjs

@@ -5,9 +5,9 @@ const require_lib_unplugin_helpers = require('./helpers.cjs');
 const require_virtual_modules = require('../../constants/virtual-modules.cjs');
 const require_lib_unplugin_module_resolution = require('./module-resolution.cjs');
 const require_lib_utilities_source_file = require('../utilities/source-file.cjs');
-let _storm_software_config_tools_types = require("@storm-software/config-tools/types");
 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_types = require("@storm-software/config-tools/types");
 let unplugin = require("unplugin");
 
 //#region src/lib/unplugin/plugin.ts
@@ -22,7 +22,7 @@ function createUnpluginResolver(context, options = {}) {
 	(0, unplugin.setParseImpl)(ctx.parse);
 	const name = options.name || "powerlines";
 	return () => {
-		const log = require_lib_logger.extendLog(ctx.log, name);
+		const log = require_lib_logger.extendLogFn(ctx.log, name);
 		log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, `Initializing ${(0, _stryke_string_format_title_case.titleCase)(name)} plugin`);
 		try {
 			const { resolveId, load } = require_lib_unplugin_module_resolution.createUnpluginModuleResolutionFunctions(context, options);
@@ -49,7 +49,7 @@ function createUnplugin(context, options = {}) {
 	(0, unplugin.setParseImpl)(ctx.parse);
 	const name = options.name || "powerlines";
 	return () => {
-		const log = options.name ? require_lib_logger.extendLog(ctx.log, name) : ctx.log;
+		const log = options.name ? require_lib_logger.extendLogFn(ctx.log, name) : ctx.log;
 		log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, `Initializing ${(0, _stryke_string_format_title_case.titleCase)(name)} plugin`);
 		try {
 			const { resolveId, load } = require_lib_unplugin_module_resolution.createUnpluginModuleResolutionFunctions(context, options);

package/dist/lib/unplugin/plugin.mjs

@@ -1,11 +1,11 @@
-import { extendLog } from "../logger.mjs";
+import { extendLogFn } from "../logger.mjs";
 import { combineContexts } from "./helpers.mjs";
 import { VIRTUAL_MODULE_PREFIX_REGEX } from "../../constants/virtual-modules.mjs";
 import { createUnpluginModuleResolutionFunctions } from "./module-resolution.mjs";
 import { getString } from "../utilities/source-file.mjs";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
 import { kebabCase } from "@stryke/string-format/kebab-case";
 import { titleCase } from "@stryke/string-format/title-case";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
 import { setParseImpl } from "unplugin";
 
 //#region src/lib/unplugin/plugin.ts
@@ -20,7 +20,7 @@ function createUnpluginResolver(context, options = {}) {
 	setParseImpl(ctx.parse);
 	const name = options.name || "powerlines";
 	return () => {
-		const log = extendLog(ctx.log, name);
+		const log = extendLogFn(ctx.log, name);
 		log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);
 		try {
 			const { resolveId, load } = createUnpluginModuleResolutionFunctions(context, options);
@@ -47,7 +47,7 @@ function createUnplugin(context, options = {}) {
 	setParseImpl(ctx.parse);
 	const name = options.name || "powerlines";
 	return () => {
-		const log = options.name ? extendLog(ctx.log, name) : ctx.log;
+		const log = options.name ? extendLogFn(ctx.log, name) : ctx.log;
 		log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);
 		try {
 			const { resolveId, load } = createUnpluginModuleResolutionFunctions(context, options);

package/dist/lib/unplugin/plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/lib/unplugin/plugin.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 { Unstable_PluginContext } from \"@powerlines/core/types/_internal\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport type {\n  TransformResult,\n  UnpluginBuildContext,\n  UnpluginContext\n} from \"unplugin\";\nimport { setParseImpl } from \"unplugin\";\nimport { VIRTUAL_MODULE_PREFIX_REGEX } from \"../../constants/virtual-modules\";\nimport { PluginContext } from \"../../types/context\";\nimport { UnpluginFactory } from \"../../types/unplugin\";\nimport { extendLog } from \"../logger\";\nimport { getString } from \"../utilities/source-file\";\nimport { combineContexts } from \"./helpers\";\nimport {\n  createUnpluginModuleResolutionFunctions,\n  CreateUnpluginModuleResolutionFunctionsOptions\n} from \"./module-resolution\";\n\nexport interface CreateUnpluginResolverOptions extends CreateUnpluginModuleResolutionFunctionsOptions {\n  /**\n   * A name to use for the unplugin instance. This is used for logging and to generate the plugin name. It does not affect the functionality of the plugin.\n   *\n   * @remarks\n   * If not provided, the plugin will be named \"powerlines\". If provided, the plugin will be named `${name} - Powerlines` (e.g., \"MyPlugin - Powerlines\").\n   *\n   * @defaultValue \"powerlines\"\n   */\n  name?: string;\n}\n\n/**\n * Creates a Powerlines unplugin instance.\n *\n * @param context - The plugin context.\n * @returns The unplugin instance.\n */\nexport function createUnpluginResolver<\n  TContext extends PluginContext = PluginContext\n>(\n  context: TContext,\n  options: CreateUnpluginResolverOptions = {}\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as Unstable_PluginContext;\n  setParseImpl(ctx.parse);\n\n  const name = options.name || \"powerlines\";\n\n  return () => {\n    const log = extendLog(ctx.log, name);\n    log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context, options);\n\n      return {\n        name:\n          name.toLowerCase() === \"powerlines\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId,\n        load\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\n}\n\nexport interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {\n  /**\n   * Whether to silence logging for the plugin hooks. This can be useful for plugins that run frequently or have hooks that are called often, to reduce noise in the logs. When set to `true`, the plugin will not log any messages for its hooks. When set to `false` (the default), the plugin will log messages for its hooks as normal.\n   *\n   * @defaultValue false\n   */\n  silenceHookLogging?: boolean;\n}\n\n/**\n * Creates a Powerlines unplugin instance.\n *\n * @param context - The plugin context.\n * @returns The unplugin instance.\n */\nexport function createUnplugin<TContext extends PluginContext = PluginContext>(\n  context: TContext,\n  options: CreateUnpluginOptions = {}\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as Unstable_PluginContext;\n  setParseImpl(ctx.parse);\n\n  const name = options.name || \"powerlines\";\n\n  return () => {\n    const log = options.name ? extendLog(ctx.log, name) : ctx.log;\n    log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context, options);\n\n      async function buildStart(this: UnpluginBuildContext) {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Powerlines build plugin starting...\");\n        }\n\n        await ctx.$$internal.callHook(\"buildStart\", {\n          sequential: true\n        });\n      }\n\n      async function transform(\n        this: UnpluginBuildContext & UnpluginContext,\n        code: string,\n        id: string\n      ): Promise<TransformResult | null | undefined> {\n        let transformed: TransformResult | string = code;\n\n        for (const hook of ctx.$$internal.environment.selectHooks(\n          \"transform\"\n        )) {\n          const result: TransformResult | string | undefined =\n            await hook.handler.apply(combineContexts(ctx, this), [\n              getString(transformed),\n              id.replace(VIRTUAL_MODULE_PREFIX_REGEX, \"\")\n            ]);\n          if (result) {\n            transformed = result;\n          }\n        }\n\n        return transformed;\n      }\n\n      async function buildEnd(this: UnpluginBuildContext): Promise<void> {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Powerlines build plugin finishing...\");\n        }\n\n        return ctx.$$internal.callHook(\"buildEnd\", {\n          sequential: true\n        });\n      }\n\n      async function writeBundle(): Promise<void> {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Finalizing Powerlines project output...\");\n        }\n\n        return ctx.$$internal.callHook(\"writeBundle\", {\n          sequential: true\n        });\n      }\n\n      return {\n        name:\n          name.toLowerCase() === \"powerlines\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId,\n        load,\n        transform,\n        buildStart,\n        buildEnd,\n        writeBundle,\n        vite: {\n          sharedDuringBuild: true\n        }\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyDA,SAAgB,uBAGd,SACA,UAAyC,EAAE,EAChB;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,MAAM,UAAU,IAAI,KAAK,KAAK;AACpC,MAAI,cAAc,OAAO,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAElE,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;AAErE,UAAO;IACL,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB;IACA;IACD;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM;;;;;;;;;;AAoBZ,SAAgB,eACd,SACA,UAAiC,EAAE,EACR;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,MAAM,QAAQ,OAAO,UAAU,IAAI,KAAK,KAAK,GAAG,IAAI;AAC1D,MAAI,cAAc,OAAO,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAElE,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;GAErE,eAAe,aAAuC;AACpD,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,sCAAsC;AAGjE,UAAM,IAAI,WAAW,SAAS,cAAc,EAC1C,YAAY,MACb,CAAC;;GAGJ,eAAe,UAEb,MACA,IAC6C;IAC7C,IAAI,cAAwC;AAE5C,SAAK,MAAM,QAAQ,IAAI,WAAW,YAAY,YAC5C,YACD,EAAE;KACD,MAAM,SACJ,MAAM,KAAK,QAAQ,MAAM,gBAAgB,KAAK,KAAK,EAAE,CACnD,UAAU,YAAY,EACtB,GAAG,QAAQ,6BAA6B,GAAG,CAC5C,CAAC;AACJ,SAAI,OACF,eAAc;;AAIlB,WAAO;;GAGT,eAAe,WAAoD;AACjE,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,uCAAuC;AAGlE,WAAO,IAAI,WAAW,SAAS,YAAY,EACzC,YAAY,MACb,CAAC;;GAGJ,eAAe,cAA6B;AAC1C,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,0CAA0C;AAGrE,WAAO,IAAI,WAAW,SAAS,eAAe,EAC5C,YAAY,MACb,CAAC;;AAGJ,UAAO;IACL,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB;IACA;IACA;IACA;IACA;IACA;IACA,MAAM,EACJ,mBAAmB,MACpB;IACF;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/lib/unplugin/plugin.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 { Unstable_PluginContext } from \"@powerlines/core/types/_internal\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport type {\n  TransformResult,\n  UnpluginBuildContext,\n  UnpluginContext\n} from \"unplugin\";\nimport { setParseImpl } from \"unplugin\";\nimport { VIRTUAL_MODULE_PREFIX_REGEX } from \"../../constants/virtual-modules\";\nimport { PluginContext } from \"../../types/context\";\nimport { UnpluginFactory } from \"../../types/unplugin\";\nimport { extendLogFn } from \"../logger\";\nimport { getString } from \"../utilities/source-file\";\nimport { combineContexts } from \"./helpers\";\nimport {\n  createUnpluginModuleResolutionFunctions,\n  CreateUnpluginModuleResolutionFunctionsOptions\n} from \"./module-resolution\";\n\nexport interface CreateUnpluginResolverOptions extends CreateUnpluginModuleResolutionFunctionsOptions {\n  /**\n   * A name to use for the unplugin instance. This is used for logging and to generate the plugin name. It does not affect the functionality of the plugin.\n   *\n   * @remarks\n   * If not provided, the plugin will be named \"powerlines\". If provided, the plugin will be named `${name} - Powerlines` (e.g., \"MyPlugin - Powerlines\").\n   *\n   * @defaultValue \"powerlines\"\n   */\n  name?: string;\n}\n\n/**\n * Creates a Powerlines unplugin instance.\n *\n * @param context - The plugin context.\n * @returns The unplugin instance.\n */\nexport function createUnpluginResolver<\n  TContext extends PluginContext = PluginContext\n>(\n  context: TContext,\n  options: CreateUnpluginResolverOptions = {}\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as Unstable_PluginContext;\n  setParseImpl(ctx.parse);\n\n  const name = options.name || \"powerlines\";\n\n  return () => {\n    const log = extendLogFn(ctx.log, name);\n    log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context, options);\n\n      return {\n        name:\n          name.toLowerCase() === \"powerlines\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId,\n        load\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\n}\n\nexport interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {\n  /**\n   * Whether to silence logging for the plugin hooks. This can be useful for plugins that run frequently or have hooks that are called often, to reduce noise in the logs. When set to `true`, the plugin will not log any messages for its hooks. When set to `false` (the default), the plugin will log messages for its hooks as normal.\n   *\n   * @defaultValue false\n   */\n  silenceHookLogging?: boolean;\n}\n\n/**\n * Creates a Powerlines unplugin instance.\n *\n * @param context - The plugin context.\n * @returns The unplugin instance.\n */\nexport function createUnplugin<TContext extends PluginContext = PluginContext>(\n  context: TContext,\n  options: CreateUnpluginOptions = {}\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as Unstable_PluginContext;\n  setParseImpl(ctx.parse);\n\n  const name = options.name || \"powerlines\";\n\n  return () => {\n    const log = options.name ? extendLogFn(ctx.log, name) : ctx.log;\n    log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context, options);\n\n      async function buildStart(this: UnpluginBuildContext) {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Powerlines build plugin starting...\");\n        }\n\n        await ctx.$$internal.callHook(\"buildStart\", {\n          sequential: true\n        });\n      }\n\n      async function transform(\n        this: UnpluginBuildContext & UnpluginContext,\n        code: string,\n        id: string\n      ): Promise<TransformResult | null | undefined> {\n        let transformed: TransformResult | string = code;\n\n        for (const hook of ctx.$$internal.environment.selectHooks(\n          \"transform\"\n        )) {\n          const result: TransformResult | string | undefined =\n            await hook.handler.apply(combineContexts(ctx, this), [\n              getString(transformed),\n              id.replace(VIRTUAL_MODULE_PREFIX_REGEX, \"\")\n            ]);\n          if (result) {\n            transformed = result;\n          }\n        }\n\n        return transformed;\n      }\n\n      async function buildEnd(this: UnpluginBuildContext): Promise<void> {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Powerlines build plugin finishing...\");\n        }\n\n        return ctx.$$internal.callHook(\"buildEnd\", {\n          sequential: true\n        });\n      }\n\n      async function writeBundle(): Promise<void> {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Finalizing Powerlines project output...\");\n        }\n\n        return ctx.$$internal.callHook(\"writeBundle\", {\n          sequential: true\n        });\n      }\n\n      return {\n        name:\n          name.toLowerCase() === \"powerlines\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId,\n        load,\n        transform,\n        buildStart,\n        buildEnd,\n        writeBundle,\n        vite: {\n          sharedDuringBuild: true\n        }\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyDA,SAAgB,uBAGd,SACA,UAAyC,EAAE,EAChB;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,MAAM,YAAY,IAAI,KAAK,KAAK;AACtC,MAAI,cAAc,OAAO,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAElE,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;AAErE,UAAO;IACL,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB;IACA;IACD;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM;;;;;;;;;;AAoBZ,SAAgB,eACd,SACA,UAAiC,EAAE,EACR;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,MAAM,QAAQ,OAAO,YAAY,IAAI,KAAK,KAAK,GAAG,IAAI;AAC5D,MAAI,cAAc,OAAO,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAElE,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;GAErE,eAAe,aAAuC;AACpD,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,sCAAsC;AAGjE,UAAM,IAAI,WAAW,SAAS,cAAc,EAC1C,YAAY,MACb,CAAC;;GAGJ,eAAe,UAEb,MACA,IAC6C;IAC7C,IAAI,cAAwC;AAE5C,SAAK,MAAM,QAAQ,IAAI,WAAW,YAAY,YAC5C,YACD,EAAE;KACD,MAAM,SACJ,MAAM,KAAK,QAAQ,MAAM,gBAAgB,KAAK,KAAK,EAAE,CACnD,UAAU,YAAY,EACtB,GAAG,QAAQ,6BAA6B,GAAG,CAC5C,CAAC;AACJ,SAAI,OACF,eAAc;;AAIlB,WAAO;;GAGT,eAAe,WAAoD;AACjE,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,uCAAuC;AAGlE,WAAO,IAAI,WAAW,SAAS,YAAY,EACzC,YAAY,MACb,CAAC;;GAGJ,eAAe,cAA6B;AAC1C,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,0CAA0C;AAGrE,WAAO,IAAI,WAAW,SAAS,eAAe,EAC5C,YAAY,MACb,CAAC;;AAGJ,UAAO;IACL,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB;IACA;IACA;IACA;IACA;IACA;IACA,MAAM,EACJ,mBAAmB,MACpB;IACF;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM"}

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.cjs

@@ -1,6 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-let _storm_software_config_tools_types = require("@storm-software/config-tools/types");
 let prettier = require("prettier");
 let _stryke_fs_write_file = require("@stryke/fs/write-file");
 
@@ -21,7 +20,7 @@ async function writeFile(log, filepath, content, skipFormat = false) {
 			filepath
 		}) || "");
 	} catch (error) {
-		log(_storm_software_config_tools_types.LogLevelLabel.ERROR, `Failed to write file ${filepath} to disk \n${error?.message ? error.message : ""}`);
+		log("error", `Failed to write file ${filepath} to disk \n${error?.message ? error.message : ""}`);
 	}
 }
 

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"write-file.d.cts","names":[],"sources":["../../../src/lib/utilities/write-file.ts"],"mappings":";;;;;AA+BA;;;;;;iBAAsB,SAAA,CACpB,GAAA,EAAK,KAAA,EACL,QAAA,UACA,OAAA,UACA,UAAA,aAAkB,OAAA"}
+{"version":3,"file":"write-file.d.cts","names":[],"sources":["../../../src/lib/utilities/write-file.ts"],"mappings":";;;;;AA8BA;;;;;;iBAAsB,SAAA,CACpB,GAAA,EAAK,KAAA,EACL,QAAA,UACA,OAAA,UACA,UAAA,aAAkB,OAAA"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"write-file.d.mts","names":[],"sources":["../../../src/lib/utilities/write-file.ts"],"mappings":";;;;;AA+BA;;;;;;iBAAsB,SAAA,CACpB,GAAA,EAAK,KAAA,EACL,QAAA,UACA,OAAA,UACA,UAAA,aAAkB,OAAA"}
+{"version":3,"file":"write-file.d.mts","names":[],"sources":["../../../src/lib/utilities/write-file.ts"],"mappings":";;;;;AA8BA;;;;;;iBAAsB,SAAA,CACpB,GAAA,EAAK,KAAA,EACL,QAAA,UACA,OAAA,UACA,UAAA,aAAkB,OAAA"}

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

@@ -1,4 +1,3 @@
-import { LogLevelLabel } from "@storm-software/config-tools/types";
 import { format, resolveConfig } from "prettier";
 import { writeFile as writeFile$1 } from "@stryke/fs/write-file";
 
@@ -19,7 +18,7 @@ async function writeFile(log, filepath, content, skipFormat = false) {
 			filepath
 		}) || "");
 	} catch (error) {
-		log(LogLevelLabel.ERROR, `Failed to write file ${filepath} to disk \n${error?.message ? error.message : ""}`);
+		log("error", `Failed to write file ${filepath} to disk \n${error?.message ? error.message : ""}`);
 	}
 }
 

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 { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { writeFile as writeFileBase } from \"@stryke/fs/write-file\";\nimport { format, resolveConfig } from \"prettier\";\nimport type { LogFn } from \"../../types/config\";\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      LogLevelLabel.ERROR,\n      `Failed to write file ${filepath} to disk \\n${(error as Error)?.message ? (error as Error).message : \"\"}`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA+BA,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,cAAc,OACd,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/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"}

package/dist/plugin-utils/index.cjs

@@ -1,6 +1,5 @@
 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');
@@ -9,6 +8,7 @@ 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');
@@ -50,4 +50,5 @@ exports.mergeConfig = require_plugin_utils_merge.mergeConfig;
 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.replacePathTokens = require_plugin_utils_paths.replacePathTokens;
+exports.resolveLogLevel = require_plugin_utils_logging.resolveLogLevel;

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 } from "./logging.cjs";
+import { isVerbose, resolveLogLevel } 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 };
+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 };

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 } from "./logging.mjs";
+import { isVerbose, resolveLogLevel } 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 };
+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 };

package/dist/plugin-utils/index.mjs

@@ -1,5 +1,4 @@
 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";
@@ -8,8 +7,9 @@ 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 } from "./logging.mjs";
+import { isVerbose, resolveLogLevel } 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 };
+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 };

package/dist/plugin-utils/logging.cjs

@@ -1,5 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../_virtual/_rolldown/runtime.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");
 
 //#region src/plugin-utils/logging.ts
@@ -13,6 +17,55 @@ function isVerbose(logLevelOrContext) {
 	const level = (0, _stryke_type_checks_is_string.isString)(logLevelOrContext) ? logLevelOrContext : logLevelOrContext.config.logLevel;
 	return level === "debug" || level === "trace";
 }
+/**
+* Resolves the log level configuration based on the provided log level and mode, returning a complete LogLevelResolvedConfig object that specifies the log level for each log category.
+*
+* @param logLevel - The user-provided log level configuration, which can be a string or an object specifying log levels for each category.
+* @param mode - The current mode of the application (e.g., "development", "test", "production"), which determines the default log levels.
+* @returns A LogLevelResolvedConfig object specifying the log level for each log category.
+*/
+function resolveLogLevel(logLevel, mode) {
+	if (logLevel === "trace") return {
+		general: "trace",
+		fs: "trace",
+		performance: "trace",
+		network: "trace",
+		plugins: "trace",
+		hooks: "trace",
+		env: "trace",
+		ipc: "trace",
+		config: "trace"
+	};
+	else if (logLevel === "silent") return {
+		general: "silent",
+		fs: "silent",
+		performance: "silent",
+		network: "silent",
+		plugins: "silent",
+		hooks: "silent",
+		env: "silent",
+		ipc: "silent",
+		config: "silent"
+	};
+	let defaultLogLevel;
+	if (mode === "development") defaultLogLevel = require_log_level.DEFAULT_DEVELOPMENT_LOG_LEVEL;
+	else if (mode === "test") defaultLogLevel = require_log_level.DEFAULT_TEST_LOG_LEVEL;
+	else defaultLogLevel = require_log_level.DEFAULT_PRODUCTION_LOG_LEVEL;
+	if ((0, _stryke_type_checks_is_set_string.isSetString)(logLevel)) return {
+		general: logLevel,
+		fs: defaultLogLevel.fs,
+		performance: logLevel,
+		network: defaultLogLevel.network,
+		plugins: logLevel,
+		hooks: logLevel,
+		env: defaultLogLevel.env,
+		ipc: defaultLogLevel.ipc,
+		config: defaultLogLevel.config
+	};
+	else if ((0, _stryke_type_checks_is_set_object.isSetObject)(logLevel)) return (0, defu.defu)(logLevel, defaultLogLevel);
+	return defaultLogLevel;
+}
 
 //#endregion
-exports.isVerbose = isVerbose;
+exports.isVerbose = isVerbose;
+exports.resolveLogLevel = resolveLogLevel;

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

@@ -1,4 +1,6 @@
+import { LogLevelResolvedConfig, LogLevelUserConfig } from "../types/log.cjs";
 import { UnresolvedContext } from "../types/context.cjs";
+import { Mode } from "../types/config.cjs";
 //#region src/plugin-utils/logging.d.ts
 /**
  * Determines if the provided log level is considered verbose (debug or trace).
@@ -14,6 +16,14 @@ declare function isVerbose(logLevel: string): boolean;
  * @returns True if the log level is "debug" or "trace", false otherwise.
  */
 declare function isVerbose(context: UnresolvedContext): boolean;
+/**
+ * Resolves the log level configuration based on the provided log level and mode, returning a complete LogLevelResolvedConfig object that specifies the log level for each log category.
+ *
+ * @param logLevel - The user-provided log level configuration, which can be a string or an object specifying log levels for each category.
+ * @param mode - The current mode of the application (e.g., "development", "test", "production"), which determines the default log levels.
+ * @returns A LogLevelResolvedConfig object specifying the log level for each log category.
+ */
+declare function resolveLogLevel(logLevel: LogLevelUserConfig, mode?: Mode): LogLevelResolvedConfig;
 //#endregion
-export { isVerbose };
+export { isVerbose, resolveLogLevel };
 //# sourceMappingURL=logging.d.cts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;AA2BA;;;iBAAgB,SAAA,CAAU,QAAA;;AAQ1B;;;;;iBAAgB,SAAA,CAAU,OAAA,EAAS,iBAAA"}
+{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;;;AAoCA;;iBAAgB,SAAA,CAAU,QAAA;;;AAQ1B;;;;iBAAgB,SAAA,CAAU,OAAA,EAAS,iBAAA;AAyBnC;;;;;;;AAAA,iBAAgB,eAAA,CACd,QAAA,EAAU,kBAAA,EACV,IAAA,GAAO,IAAA,GACN,sBAAA"}