@powerlines/core 0.44.1 → 0.44.2

package/dist/constants/log-level.cjs

@@ -3,12 +3,12 @@
 const DEFAULT_DEVELOPMENT_LOG_LEVEL = {
 	general: "debug",
 	fs: "info",
-	config: "debug",
+	config: "info",
 	plugins: "debug",
 	hooks: "debug",
 	performance: "debug",
 	env: "debug",
-	ipc: "info",
+	ipc: "debug",
 	network: "debug",
 	babel: "debug"
 };

package/dist/constants/log-level.d.cts

@@ -2,12 +2,12 @@
 declare const DEFAULT_DEVELOPMENT_LOG_LEVEL: {
   readonly general: "debug";
   readonly fs: "info";
-  readonly config: "debug";
+  readonly config: "info";
   readonly plugins: "debug";
   readonly hooks: "debug";
   readonly performance: "debug";
   readonly env: "debug";
-  readonly ipc: "info";
+  readonly ipc: "debug";
   readonly network: "debug";
   readonly babel: "debug";
 };

package/dist/constants/log-level.d.mts

@@ -2,12 +2,12 @@
 declare const DEFAULT_DEVELOPMENT_LOG_LEVEL: {
   readonly general: "debug";
   readonly fs: "info";
-  readonly config: "debug";
+  readonly config: "info";
   readonly plugins: "debug";
   readonly hooks: "debug";
   readonly performance: "debug";
   readonly env: "debug";
-  readonly ipc: "info";
+  readonly ipc: "debug";
   readonly network: "debug";
   readonly babel: "debug";
 };

package/dist/constants/log-level.mjs

@@ -2,12 +2,12 @@
 const DEFAULT_DEVELOPMENT_LOG_LEVEL = {
 	general: "debug",
 	fs: "info",
-	config: "debug",
+	config: "info",
 	plugins: "debug",
 	hooks: "debug",
 	performance: "debug",
 	env: "debug",
-	ipc: "info",
+	ipc: "debug",
 	network: "debug",
 	babel: "debug"
 };

package/dist/constants/log-level.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"log-level.mjs","names":[],"sources":["../../src/constants/log-level.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\nexport const DEFAULT_DEVELOPMENT_LOG_LEVEL = {\n  general: \"debug\",\n  fs: \"info\",\n  config: \"debug\",\n  plugins: \"debug\",\n  hooks: \"debug\",\n  performance: \"debug\",\n  env: \"debug\",\n  ipc: \"info\",\n  network: \"debug\",\n  babel: \"debug\"\n} as const;\n\nexport const DEFAULT_TEST_LOG_LEVEL = {\n  general: \"info\",\n  fs: \"warn\",\n  config: \"warn\",\n  plugins: \"warn\",\n  hooks: \"warn\",\n  performance: \"info\",\n  env: \"warn\",\n  ipc: \"warn\",\n  network: \"warn\",\n  babel: \"warn\"\n} as const;\n\nexport const DEFAULT_PRODUCTION_LOG_LEVEL = {\n  general: \"info\",\n  fs: \"error\",\n  config: \"warn\",\n  plugins: \"warn\",\n  hooks: \"warn\",\n  performance: \"info\",\n  env: \"error\",\n  ipc: \"error\",\n  network: \"error\",\n  babel: \"warn\"\n} as const;\n"],"mappings":";AAkBA,MAAa,gCAAgC;CAC3C,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACR;AAED,MAAa,yBAAyB;CACpC,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACR;AAED,MAAa,+BAA+B;CAC1C,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACR"}
+{"version":3,"file":"log-level.mjs","names":[],"sources":["../../src/constants/log-level.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\nexport const DEFAULT_DEVELOPMENT_LOG_LEVEL = {\n  general: \"debug\",\n  fs: \"info\",\n  config: \"info\",\n  plugins: \"debug\",\n  hooks: \"debug\",\n  performance: \"debug\",\n  env: \"debug\",\n  ipc: \"debug\",\n  network: \"debug\",\n  babel: \"debug\"\n} as const;\n\nexport const DEFAULT_TEST_LOG_LEVEL = {\n  general: \"info\",\n  fs: \"warn\",\n  config: \"warn\",\n  plugins: \"warn\",\n  hooks: \"warn\",\n  performance: \"info\",\n  env: \"warn\",\n  ipc: \"warn\",\n  network: \"warn\",\n  babel: \"warn\"\n} as const;\n\nexport const DEFAULT_PRODUCTION_LOG_LEVEL = {\n  general: \"info\",\n  fs: \"error\",\n  config: \"warn\",\n  plugins: \"warn\",\n  hooks: \"warn\",\n  performance: \"info\",\n  env: \"error\",\n  ipc: \"error\",\n  network: \"error\",\n  babel: \"warn\"\n} as const;\n"],"mappings":";AAkBA,MAAa,gCAAgC;CAC3C,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACR;AAED,MAAa,yBAAyB;CACpC,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACR;AAED,MAAa,+BAA+B;CAC1C,SAAS;CACT,IAAI;CACJ,QAAQ;CACR,SAAS;CACT,OAAO;CACP,aAAa;CACb,KAAK;CACL,KAAK;CACL,SAAS;CACT,OAAO;CACR"}

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 { 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 { 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 logger = ctx.extendLogger({ source: name });\n    logger.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      logger.error(error instanceof Error ? error.message : String(error));\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 logger = ctx.extendLogger({ source: name });\n    logger.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          logger.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          logger.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          logger.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      logger.error(error instanceof Error ? error.message : String(error));\n\n      throw error;\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuDA,SAAgB,uBAGd,SACA,UAAyC,EAAE,EAChB;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,SAAS,IAAI,aAAa,EAAE,QAAQ,MAAM,CAAC;AACjD,SAAO,MAAM,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAEtD,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,UAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAEpE,SAAM;;;;;;;;;;AAoBZ,SAAgB,eACd,SACA,UAAiC,EAAE,EACR;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,SAAS,IAAI,aAAa,EAAE,QAAQ,MAAM,CAAC;AACjD,SAAO,MAAM,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAEtD,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;GAErE,eAAe,aAAuC;AACpD,QAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,sCAAsC;AAGrD,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,QAAO,MAAM,uCAAuC;AAGtD,WAAO,IAAI,WAAW,SAAS,YAAY,EACzC,YAAY,MACb,CAAC;;GAGJ,eAAe,cAA6B;AAC1C,QAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,0CAA0C;AAGzD,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,UAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAEpE,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 { 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 { 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 logger = ctx.extendLogger({ source: name });\n    logger.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      logger.error(error instanceof Error ? error.message : String(error));\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 logger = ctx.extendLogger({ source: name });\n    logger.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          logger.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            ] as [code: string, id: string]);\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          logger.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          logger.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      logger.error(error instanceof Error ? error.message : String(error));\n\n      throw error;\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuDA,SAAgB,uBAGd,SACA,UAAyC,EAAE,EAChB;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,SAAS,IAAI,aAAa,EAAE,QAAQ,MAAM,CAAC;AACjD,SAAO,MAAM,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAEtD,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,UAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAEpE,SAAM;;;;;;;;;;AAoBZ,SAAgB,eACd,SACA,UAAiC,EAAE,EACR;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,SAAS,IAAI,aAAa,EAAE,QAAQ,MAAM,CAAC;AACjD,SAAO,MAAM,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAEtD,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;GAErE,eAAe,aAAuC;AACpD,QAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,sCAAsC;AAGrD,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,CAA+B;AAClC,SAAI,OACF,eAAc;;AAIlB,WAAO;;GAGT,eAAe,WAAoD;AACjE,QAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,uCAAuC;AAGtD,WAAO,IAAI,WAAW,SAAS,YAAY,EACzC,YAAY,MACb,CAAC;;GAGJ,eAAe,cAA6B;AAC1C,QAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,0CAA0C;AAGzD,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,UAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAEpE,SAAM"}

package/dist/plugin-utils/logging.cjs

@@ -131,7 +131,7 @@ 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());
+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);
@@ -248,7 +248,7 @@ const withLogger = (logger, secondaryLogger) => {
 		...secondaryLogger.options,
 		...logger.options
 	};
-	return {
+	const result = {
 		options,
 		error: validateLogger("error", options.name, options, (message) => {
 			logger.error?.(message);
@@ -271,6 +271,30 @@ const withLogger = (logger, secondaryLogger) => {
 			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.
@@ -280,7 +304,7 @@ const withLogger = (logger, secondaryLogger) => {
 * @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) => {
-	return {
+	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)),
@@ -288,6 +312,30 @@ const withCustomLogger = (logger, 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,
@@ -299,7 +347,7 @@ const consoleLogger = (type, message) => consoleLog((0, _stryke_type_checks_is_s
 	category: require_logging.LogCategories.GENERAL,
 	logId: (0, _stryke_unique_id_uuid.uuid)(),
 	timestamp: Date.now(),
-	...message
+	...message.meta
 }, (0, _stryke_type_checks_is_set_string.isSetString)(message) ? message : message.message);
 /**
 * Create a logging function with a specific name and options.
@@ -309,7 +357,7 @@ const consoleLogger = (type, message) => consoleLog((0, _stryke_type_checks_is_s
 * @returns A logging function.
 */
 const createLogger = (name, options, callback = consoleLogger) => {
-	return {
+	const result = {
 		options: {
 			...options,
 			name
@@ -335,6 +383,30 @@ const createLogger = (name, options, callback = consoleLogger) => {
 			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.
@@ -364,7 +436,7 @@ const extendLogger = (logger, options) => {
 		...logger.options,
 		...options
 	};
-	return {
+	const result = {
 		options: opts,
 		error: validateLogger("error", opts.name, opts, logger.error.bind(logger)),
 		warn: validateLogger("warn", opts.name, opts, logger.warn.bind(logger)),
@@ -372,6 +444,30 @@ const extendLogger = (logger, options) => {
 		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

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

@@ -1 +1 @@
-{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;AA2DA;;;;;iBAAgB,SAAA,CAAU,QAAA;;;;;AAiC1B;;iBAzBgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AA2FH;;cAAa,YAAA,GAAgB,IAAA;;;AAiB7B;;;;cAAa,SAAA,GAAa,IAAA;AAY1B;;;;;AAMA;AANA,cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBA2B7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAXZ;;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AAflE;cAoJa,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cA4DxD,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAyCU,aAAA,GACX,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA;;;;;;AA/OpB;;cA0Qa,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,IACE,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA,cAEnB,MAAA;;;;;;;;cA4BU,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}
+{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;AA2DA;;;;;iBAAgB,SAAA,CAAU,QAAA;;;;;AAiC1B;;iBAzBgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AA2FH;;cAAa,YAAA,GAAgB,IAAA;;;AAiB7B;;;;cAAa,SAAA,GAAa,IAAA;AAY1B;;;;;AAMA;AANA,cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBA2B7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAXZ;;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AAflE;cAoJa,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cAuFxD,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAoEU,aAAA,GACX,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA;;;;;;AArSpB;;cAgUa,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,IACE,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA,cAEnB,MAAA;;;;;;;;cAuDU,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;AA2DA;;;;;iBAAgB,SAAA,CAAU,QAAA;;;;;AAiC1B;;iBAzBgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AA2FH;;cAAa,YAAA,GAAgB,IAAA;;;AAiB7B;;;;cAAa,SAAA,GAAa,IAAA;AAY1B;;;;;AAMA;AANA,cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBA2B7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAXZ;;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AAflE;cAoJa,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cA4DxD,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAyCU,aAAA,GACX,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA;;;;;;AA/OpB;;cA0Qa,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,IACE,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA,cAEnB,MAAA;;;;;;;;cA4BU,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}
+{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/plugin-utils/logging.ts"],"mappings":";;;;;;AA2DA;;;;;iBAAgB,SAAA,CAAU,QAAA;;;;;AAiC1B;;iBAzBgB,SAAA,CAAU,OAAA,EAAS,iBAAA;;;;;;;;iBAyBnB,eAAA,CACd,QAAA,GAAW,kBAAA,EACX,IAAA,GAAO,IAAA,GACN,sBAAA;;;;;AA2FH;;cAAa,YAAA,GAAgB,IAAA;;;AAiB7B;;;;cAAa,SAAA,GAAa,IAAA;AAY1B;;;;;AAMA;AANA,cAAa,eAAA,GAAmB,IAAA;AAAA,cAMnB,UAAA,GAAc,IAAA,EAAM,OAAA,KAAY,IAAA;AAAA,iBA2B7B,eAAA,CAAgB,QAAA,EAAU,QAAA,EAAU,IAAA,EAAM,QAAA;AAAA,iBAQ1C,qBAAA,CACd,IAAA,EAAM,QAAA,EACN,QAAA,EAAU,sBAAA,EACV,QAAA,GAAU,WAAA;;;;;AAXZ;;;cAuBa,WAAA,GAAe,IAAA,UAAc,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;AAflE;cAoJa,UAAA,GAAc,MAAA,EAAQ,MAAA,EAAQ,eAAA,EAAiB,MAAA,KAAS,MAAA;;;;;;;;cAuFxD,gBAAA,GACX,MAAA,EAAQ,MAAA,EACR,YAAA,EAAc,YAAA,KACb,MAAA;AAAA,cAoEU,aAAA,GACX,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA;;;;;;AArSpB;;cAgUa,YAAA,GACX,IAAA,UACA,OAAA,EAAS,aAAA,EACT,QAAA,IACE,IAAA,EAAM,QAAA,EACN,OAAA,WAAkB,aAAA,cAEnB,MAAA;;;;;;;;cAuDU,WAAA,GAAe,KAAA,EAAO,KAAA,EAAO,OAAA,EAAS,YAAA,KAAe,KAAA;;;;;;;;cAsBrD,YAAA,GACX,MAAA,EAAQ,MAAA,EACR,OAAA,EAAS,aAAA,KACR,MAAA"}

package/dist/plugin-utils/logging.mjs

@@ -128,7 +128,7 @@ const colorBackground = (text) => {
 	const title = titleCase(text);
 	return chalk.inverse.hex(getTextColor(title))(` ${title} `);
 };
-const consoleLog = (meta, ...args) => getLogFn(getLogLevel(meta.type), { logLevel: "trace" })(`${meta.name ? chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.name)) : ""}${meta.command ? chalk.hex(BRAND_COLOR)(` (${meta.command})`) : ""}${meta.name ? chalk.grey(" > ") : ""}${(meta.source || meta.plugin) && (!meta.name || kebabCase(meta.source || meta.plugin) !== kebabCase(meta.name)) ? `${chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.source || meta.plugin))}${chalk.grey(" > ")}` : ""}${meta.environment && kebabCase(meta.environment) !== "default" ? `${chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.environment))}${chalk.grey(" > ")}` : ""}${meta.category && meta.category !== LogCategories.GENERAL ? ` ${colorBackground(kebabCase(meta.category))} ` : ""}${args.join(" ")} `.trim());
+const consoleLog = (meta, ...args) => getLogFn(getLogLevel(meta.type), { logLevel: "trace" })(`${meta.name ? chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.name)) : ""}${meta.command ? chalk.hex(BRAND_COLOR)(` (${meta.command})`) : ""}${meta.name ? chalk.grey(" > ") : ""}${(meta.source || meta.plugin) && (!meta.name || kebabCase(meta.source || meta.plugin) !== kebabCase(meta.name)) ? `${chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.source || meta.plugin))}${chalk.grey(" > ")}` : ""}${meta.environment && kebabCase(meta.environment) !== "default" ? `${chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.environment))}${chalk.grey(" > ")}` : ""}${meta.category && meta.category !== LogCategories.GENERAL ? `${colorBackground(kebabCase(meta.category))} ` : ""}${args.join(" ")} `.trim());
 function isValidLogLevel(logLevel, type) {
 	if (logLevel === LogLevels.SILENT) return false;
 	return LOG_LEVELS.indexOf(logLevel) >= LOG_LEVELS.indexOf(type);
@@ -245,7 +245,7 @@ const withLogger = (logger, secondaryLogger) => {
 		...secondaryLogger.options,
 		...logger.options
 	};
-	return {
+	const result = {
 		options,
 		error: validateLogger("error", options.name, options, (message) => {
 			logger.error?.(message);
@@ -268,6 +268,30 @@ const withLogger = (logger, secondaryLogger) => {
 			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.
@@ -277,7 +301,7 @@ const withLogger = (logger, secondaryLogger) => {
 * @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) => {
-	return {
+	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)),
@@ -285,6 +309,30 @@ const withCustomLogger = (logger, 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(isSetString(message) ? {
 	type,
@@ -296,7 +344,7 @@ const consoleLogger = (type, message) => consoleLog(isSetString(message) ? {
 	category: LogCategories.GENERAL,
 	logId: uuid(),
 	timestamp: Date.now(),
-	...message
+	...message.meta
 }, isSetString(message) ? message : message.message);
 /**
 * Create a logging function with a specific name and options.
@@ -306,7 +354,7 @@ const consoleLogger = (type, message) => consoleLog(isSetString(message) ? {
 * @returns A logging function.
 */
 const createLogger = (name, options, callback = consoleLogger) => {
-	return {
+	const result = {
 		options: {
 			...options,
 			name
@@ -332,6 +380,30 @@ const createLogger = (name, options, callback = consoleLogger) => {
 			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.
@@ -361,7 +433,7 @@ const extendLogger = (logger, options) => {
 		...logger.options,
 		...options
 	};
-	return {
+	const result = {
 		options: opts,
 		error: validateLogger("error", opts.name, opts, logger.error.bind(logger)),
 		warn: validateLogger("warn", opts.name, opts, logger.warn.bind(logger)),
@@ -369,6 +441,30 @@ const extendLogger = (logger, options) => {
 		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

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

@@ -1 +1 @@
-{"version":3,"file":"logging.mjs","names":["defu"],"sources":["../../src/plugin-utils/logging.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 { 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 { isString } from \"@stryke/type-checks/is-string\";\nimport { RequiredKeys } from \"@stryke/types/base\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport chalk from \"chalk\";\nimport { defu } from \"defu\";\nimport { DEFAULT_ENVIRONMENT } from \"../constants/environments\";\nimport {\n  DEFAULT_DEVELOPMENT_LOG_LEVEL,\n  DEFAULT_PRODUCTION_LOG_LEVEL,\n  DEFAULT_TEST_LOG_LEVEL\n} from \"../constants/log-level\";\nimport { Mode } from \"../types/config\";\nimport { UnresolvedContext } from \"../types/context\";\nimport type {\n  CustomLogger,\n  CustomLoggerMessage,\n  LogCategory,\n  LogFn,\n  LogFnMeta,\n  LogFnOptions,\n  LoggerMessage,\n  LoggerOptions,\n  LogLevel,\n  LogLevelResolvedConfig,\n  LogLevelUserConfig,\n  LogMeta\n} from \"../types/logging\";\nimport { LOG_LEVELS, LogCategories, Logger, LogLevels } from \"../types/logging\";\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevel - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(logLevel: string): boolean;\n\n/**\n * Determines if the provided context is considered verbose (debug or trace).\n *\n * @param context - The context to check, which contains the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(context: UnresolvedContext): boolean;\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevelOrContext - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(\n  logLevelOrContext: string | UnresolvedContext\n): boolean {\n  const level = isString(logLevelOrContext)\n    ? logLevelOrContext\n    : logLevelOrContext.config.logLevel;\n\n  return level === \"debug\" || level === \"trace\";\n}\n\n/**\n * 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.\n *\n * @param logLevel - The user-provided log level configuration, which can be a string or an object specifying log levels for each category.\n * @param mode - The current mode of the application (e.g., \"development\", \"test\", \"production\"), which determines the default log levels.\n * @returns A LogLevelResolvedConfig object specifying the log level for each log category.\n */\nexport function resolveLogLevel(\n  logLevel?: LogLevelUserConfig,\n  mode?: Mode\n): LogLevelResolvedConfig {\n  if (logLevel === \"trace\") {\n    return {\n      general: \"trace\",\n      fs: \"trace\",\n      performance: \"trace\",\n      network: \"trace\",\n      plugins: \"trace\",\n      hooks: \"trace\",\n      env: \"trace\",\n      ipc: \"trace\",\n      config: \"trace\",\n      babel: \"trace\"\n    };\n  } else if (logLevel === \"silent\") {\n    return {\n      general: \"silent\",\n      fs: \"silent\",\n      performance: \"silent\",\n      network: \"silent\",\n      plugins: \"silent\",\n      hooks: \"silent\",\n      env: \"silent\",\n      ipc: \"silent\",\n      config: \"silent\",\n      babel: \"silent\"\n    };\n  }\n\n  let defaultLogLevel: LogLevelResolvedConfig;\n  if (mode === \"development\") {\n    defaultLogLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;\n  } else if (mode === \"test\") {\n    defaultLogLevel = DEFAULT_TEST_LOG_LEVEL;\n  } else {\n    defaultLogLevel = DEFAULT_PRODUCTION_LOG_LEVEL;\n  }\n\n  if (isSetString(logLevel)) {\n    return {\n      general: logLevel,\n      fs: defaultLogLevel.fs,\n      performance: logLevel,\n      network: defaultLogLevel.network,\n      plugins: logLevel,\n      hooks: logLevel,\n      env: defaultLogLevel.env,\n      ipc: defaultLogLevel.ipc,\n      config: defaultLogLevel.config,\n      babel: logLevel\n    };\n  } else if (isSetObject(logLevel)) {\n    return defu(logLevel, defaultLogLevel) as LogLevelResolvedConfig;\n  }\n\n  return defaultLogLevel;\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\nconst BRAND_COLOR = getColor(\"brand\");\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\nexport const consoleLog = (meta: LogMeta, ...args: string[]) =>\n  getLogFn(getLogLevel(meta.type), {\n    logLevel: \"trace\"\n  })(\n    `${meta.name ? chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.name)) : \"\"}${\n      meta.command ? chalk.hex(BRAND_COLOR)(` (${meta.command})`) : \"\"\n    }${meta.name ? chalk.grey(\" > \") : \"\"}${\n      (meta.source || meta.plugin) &&\n      (!meta.name ||\n        kebabCase(meta.source || meta.plugin) !== kebabCase(meta.name))\n        ? `${chalk.bold.hex(BRAND_COLOR)(\n            kebabCase(meta.source || meta.plugin)\n          )}${chalk.grey(\" > \")}`\n        : \"\"\n    }${\n      meta.environment && kebabCase(meta.environment) !== DEFAULT_ENVIRONMENT\n        ? `${chalk.bold.hex(BRAND_COLOR)(\n            kebabCase(meta.environment)\n          )}${chalk.grey(\" > \")}`\n        : \"\"\n    }${\n      meta.category && meta.category !== LogCategories.GENERAL\n        ? ` ${colorBackground(kebabCase(meta.category))} `\n        : \"\"\n    }${args.join(\" \")} `.trim()\n  );\n\nexport function isValidLogLevel(logLevel: LogLevel, type: LogLevel): boolean {\n  if (logLevel === LogLevels.SILENT) {\n    return false;\n  }\n\n  return LOG_LEVELS.indexOf(logLevel) >= LOG_LEVELS.indexOf(type);\n}\n\nexport function isValidLogLevelConfig(\n  type: LogLevel,\n  logLevel: LogLevelResolvedConfig,\n  category: LogCategory = LogCategories.GENERAL\n): boolean {\n  return isValidLogLevel(logLevel[category], type);\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, 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 = (name: string, options: LogFnOptions): LogFn => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (meta: LogFnMeta | LogLevel, ...args: string[]) => {\n    const logMeta = isSetObject(meta)\n      ? {\n          logId: uuid(),\n          timestamp: Date.now(),\n          category: LogCategories.GENERAL,\n          ...options,\n          ...meta,\n          name\n        }\n      : {\n          logId: uuid(),\n          timestamp: Date.now(),\n          category: LogCategories.GENERAL,\n          ...options,\n          type: meta,\n          name\n        };\n\n    if (\n      isValidLogLevelConfig(\n        logMeta.type,\n        logLevel,\n        logMeta.category ? logMeta.category : LogCategories.GENERAL\n      )\n    ) {\n      consoleLog(logMeta, ...args);\n    }\n  };\n};\n\nconst validateLogger = (\n  type: LogLevel,\n  name: string,\n  options: LoggerOptions,\n  callback: (message: string | LoggerMessage) => void\n) => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (message: string | LoggerMessage) => {\n    const params = isSetString(message)\n      ? {\n          name,\n          plugin: options.plugin,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            ...options\n          },\n          message\n        }\n      : {\n          name,\n          plugin: options.plugin,\n          ...message,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            plugin: message.plugin,\n            ...options,\n            ...message.meta\n          }\n        };\n\n    if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {\n      callback(params);\n    }\n  };\n};\n\nconst validateCustomLogger = (\n  type: LogLevel,\n  name: string,\n  options: LoggerOptions,\n  callback?: (message: string | LoggerMessage) => void,\n  customCallback?: (message: CustomLoggerMessage) => void\n) => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (message: string | LoggerMessage) => {\n    const params = isSetString(message)\n      ? {\n          name,\n          plugin: options.plugin,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            ...options\n          },\n          message\n        }\n      : {\n          name,\n          plugin: options.plugin,\n          ...message,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            plugin: message.plugin,\n            ...options,\n            ...message.meta\n          }\n        };\n\n    if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {\n      callback?.(params);\n      customCallback?.(params);\n    }\n  };\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param logger - The original logger to wrap with the custom logger.\n * @param secondaryLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.\n * @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.\n */\nexport const withLogger = (logger: Logger, secondaryLogger: Logger): Logger => {\n  const options = { ...secondaryLogger.options, ...logger.options };\n\n  return {\n    options,\n    error: validateLogger(\n      \"error\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.error?.(message);\n        secondaryLogger.error?.(message);\n      }\n    ),\n    warn: validateLogger(\n      \"warn\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.warn?.(message);\n        secondaryLogger.warn?.(message);\n      }\n    ),\n    info: validateLogger(\n      \"info\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.info?.(message);\n        secondaryLogger.info?.(message);\n      }\n    ),\n    debug: validateLogger(\n      \"debug\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.debug?.(message);\n        secondaryLogger.debug?.(message);\n      }\n    ),\n    trace: validateLogger(\n      \"trace\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.trace?.(message);\n        secondaryLogger.trace?.(message);\n      }\n    )\n  };\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param logger - The original logger to wrap with the custom logger.\n * @param customLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.\n * @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.\n */\nexport const withCustomLogger = (\n  logger: Logger,\n  customLogger: CustomLogger\n): Logger => {\n  return {\n    options: logger.options,\n    error: validateCustomLogger(\n      \"error\",\n      logger.options.name!,\n      logger.options,\n      logger.error.bind(logger),\n      customLogger.error?.bind(customLogger)\n    ),\n    warn: validateCustomLogger(\n      \"warn\",\n      logger.options.name!,\n      logger.options,\n      logger.warn.bind(logger),\n      customLogger.warn?.bind(customLogger)\n    ),\n    info: validateCustomLogger(\n      \"info\",\n      logger.options.name!,\n      logger.options,\n      logger.info.bind(logger),\n      customLogger.info?.bind(customLogger)\n    ),\n    debug: validateCustomLogger(\n      \"debug\",\n      logger.options.name!,\n      logger.options,\n      logger.debug.bind(logger),\n      customLogger.debug?.bind(customLogger)\n    ),\n    trace: validateCustomLogger(\n      \"trace\",\n      logger.options.name!,\n      logger.options,\n      logger.trace.bind(logger),\n      customLogger.trace?.bind(customLogger)\n    )\n  };\n};\n\nexport const consoleLogger = (\n  type: LogLevel,\n  message: string | LoggerMessage\n) =>\n  consoleLog(\n    isSetString(message)\n      ? {\n          type,\n          category: LogCategories.GENERAL,\n          logId: uuid(),\n          timestamp: Date.now()\n        }\n      : {\n          type,\n          category: LogCategories.GENERAL,\n          logId: uuid(),\n          timestamp: Date.now(),\n          ...message\n        },\n    isSetString(message) ? message : message.message\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, 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 createLogger = (\n  name: string,\n  options: LoggerOptions,\n  callback: (\n    type: LogLevel,\n    message: string | LoggerMessage\n  ) => void = consoleLogger\n): Logger => {\n  return {\n    options: { ...options, name },\n    error: validateLogger(\"error\", name, { ...options, name }, message =>\n      callback(\"error\", message)\n    ),\n    warn: validateLogger(\"warn\", name, { ...options, name }, message =>\n      callback(\"warn\", message)\n    ),\n    info: validateLogger(\"info\", name, { ...options, name }, message =>\n      callback(\"info\", message)\n    ),\n    debug: validateLogger(\"debug\", name, { ...options, name }, message =>\n      callback(\"debug\", message)\n    ),\n    trace: validateLogger(\"trace\", name, { ...options, name }, message =>\n      callback(\"trace\", message)\n    )\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 options - 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, options: LogFnOptions): LogFn => {\n  return (meta, ...args) =>\n    options.source || options.category\n      ? logFn(\n          isSetObject(meta)\n            ? { ...options, ...meta }\n            : { ...options, type: meta },\n          `${colorBackground(String(options.source || options.category))} ${args\n            .filter(Boolean)\n            .map(arg => String(arg).trim())\n            .join(\" \")} `\n        )\n      : logFn(meta, ...args);\n};\n\n/**\n * 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.\n *\n * @param logger - The original logger to extend.\n * @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.\n * @returns A new logger that includes the badge in its output for each log message.\n */\nexport const extendLogger = (\n  logger: Logger,\n  options: LoggerOptions\n): Logger => {\n  const opts = { ...logger.options, ...options } as RequiredKeys<\n    LoggerOptions,\n    \"name\"\n  >;\n\n  return {\n    options: opts,\n    error: validateLogger(\"error\", opts.name, opts, logger.error.bind(logger)),\n    warn: validateLogger(\"warn\", opts.name, opts, logger.warn.bind(logger)),\n    info: validateLogger(\"info\", opts.name, opts, logger.info.bind(logger)),\n    debug: validateLogger(\"debug\", opts.name, opts, logger.debug.bind(logger)),\n    trace: validateLogger(\"trace\", opts.name, opts, logger.trace.bind(logger))\n  };\n};\n"],"mappings":"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"}
+{"version":3,"file":"logging.mjs","names":["defu"],"sources":["../../src/plugin-utils/logging.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 { 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 { isString } from \"@stryke/type-checks/is-string\";\nimport { RequiredKeys } from \"@stryke/types/base\";\nimport { uuid } from \"@stryke/unique-id/uuid\";\nimport chalk from \"chalk\";\nimport { defu } from \"defu\";\nimport { DEFAULT_ENVIRONMENT } from \"../constants/environments\";\nimport {\n  DEFAULT_DEVELOPMENT_LOG_LEVEL,\n  DEFAULT_PRODUCTION_LOG_LEVEL,\n  DEFAULT_TEST_LOG_LEVEL\n} from \"../constants/log-level\";\nimport { Mode } from \"../types/config\";\nimport { UnresolvedContext } from \"../types/context\";\nimport type {\n  CustomLogger,\n  CustomLoggerMessage,\n  LogCategory,\n  LogFn,\n  LogFnMeta,\n  LogFnOptions,\n  LoggerMessage,\n  LoggerOptions,\n  LogLevel,\n  LogLevelResolvedConfig,\n  LogLevelUserConfig,\n  LogMeta\n} from \"../types/logging\";\nimport { LOG_LEVELS, LogCategories, Logger, LogLevels } from \"../types/logging\";\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevel - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(logLevel: string): boolean;\n\n/**\n * Determines if the provided context is considered verbose (debug or trace).\n *\n * @param context - The context to check, which contains the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(context: UnresolvedContext): boolean;\n\n/**\n * Determines if the provided log level is considered verbose (debug or trace).\n *\n * @param logLevelOrContext - The log level to check, which can be a string or an UnresolvedContext containing the log level in its config.\n * @returns True if the log level is \"debug\" or \"trace\", false otherwise.\n */\nexport function isVerbose(\n  logLevelOrContext: string | UnresolvedContext\n): boolean {\n  const level = isString(logLevelOrContext)\n    ? logLevelOrContext\n    : logLevelOrContext.config.logLevel;\n\n  return level === \"debug\" || level === \"trace\";\n}\n\n/**\n * 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.\n *\n * @param logLevel - The user-provided log level configuration, which can be a string or an object specifying log levels for each category.\n * @param mode - The current mode of the application (e.g., \"development\", \"test\", \"production\"), which determines the default log levels.\n * @returns A LogLevelResolvedConfig object specifying the log level for each log category.\n */\nexport function resolveLogLevel(\n  logLevel?: LogLevelUserConfig,\n  mode?: Mode\n): LogLevelResolvedConfig {\n  if (logLevel === \"trace\") {\n    return {\n      general: \"trace\",\n      fs: \"trace\",\n      performance: \"trace\",\n      network: \"trace\",\n      plugins: \"trace\",\n      hooks: \"trace\",\n      env: \"trace\",\n      ipc: \"trace\",\n      config: \"trace\",\n      babel: \"trace\"\n    };\n  } else if (logLevel === \"silent\") {\n    return {\n      general: \"silent\",\n      fs: \"silent\",\n      performance: \"silent\",\n      network: \"silent\",\n      plugins: \"silent\",\n      hooks: \"silent\",\n      env: \"silent\",\n      ipc: \"silent\",\n      config: \"silent\",\n      babel: \"silent\"\n    };\n  }\n\n  let defaultLogLevel: LogLevelResolvedConfig;\n  if (mode === \"development\") {\n    defaultLogLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;\n  } else if (mode === \"test\") {\n    defaultLogLevel = DEFAULT_TEST_LOG_LEVEL;\n  } else {\n    defaultLogLevel = DEFAULT_PRODUCTION_LOG_LEVEL;\n  }\n\n  if (isSetString(logLevel)) {\n    return {\n      general: logLevel,\n      fs: defaultLogLevel.fs,\n      performance: logLevel,\n      network: defaultLogLevel.network,\n      plugins: logLevel,\n      hooks: logLevel,\n      env: defaultLogLevel.env,\n      ipc: defaultLogLevel.ipc,\n      config: defaultLogLevel.config,\n      babel: logLevel\n    };\n  } else if (isSetObject(logLevel)) {\n    return defu(logLevel, defaultLogLevel) as LogLevelResolvedConfig;\n  }\n\n  return defaultLogLevel;\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\nconst BRAND_COLOR = getColor(\"brand\");\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\nexport const consoleLog = (meta: LogMeta, ...args: string[]) =>\n  getLogFn(getLogLevel(meta.type), {\n    logLevel: \"trace\"\n  })(\n    `${meta.name ? chalk.bold.hex(BRAND_COLOR)(kebabCase(meta.name)) : \"\"}${\n      meta.command ? chalk.hex(BRAND_COLOR)(` (${meta.command})`) : \"\"\n    }${meta.name ? chalk.grey(\" > \") : \"\"}${\n      (meta.source || meta.plugin) &&\n      (!meta.name ||\n        kebabCase(meta.source || meta.plugin) !== kebabCase(meta.name))\n        ? `${chalk.bold.hex(BRAND_COLOR)(\n            kebabCase(meta.source || meta.plugin)\n          )}${chalk.grey(\" > \")}`\n        : \"\"\n    }${\n      meta.environment && kebabCase(meta.environment) !== DEFAULT_ENVIRONMENT\n        ? `${chalk.bold.hex(BRAND_COLOR)(\n            kebabCase(meta.environment)\n          )}${chalk.grey(\" > \")}`\n        : \"\"\n    }${\n      meta.category && meta.category !== LogCategories.GENERAL\n        ? `${colorBackground(kebabCase(meta.category))} `\n        : \"\"\n    }${args.join(\" \")} `.trim()\n  );\n\nexport function isValidLogLevel(logLevel: LogLevel, type: LogLevel): boolean {\n  if (logLevel === LogLevels.SILENT) {\n    return false;\n  }\n\n  return LOG_LEVELS.indexOf(logLevel) >= LOG_LEVELS.indexOf(type);\n}\n\nexport function isValidLogLevelConfig(\n  type: LogLevel,\n  logLevel: LogLevelResolvedConfig,\n  category: LogCategory = LogCategories.GENERAL\n): boolean {\n  return isValidLogLevel(logLevel[category], type);\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, 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 = (name: string, options: LogFnOptions): LogFn => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (meta: LogFnMeta | LogLevel, ...args: string[]) => {\n    const logMeta = isSetObject(meta)\n      ? {\n          logId: uuid(),\n          timestamp: Date.now(),\n          category: LogCategories.GENERAL,\n          ...options,\n          ...meta,\n          name\n        }\n      : {\n          logId: uuid(),\n          timestamp: Date.now(),\n          category: LogCategories.GENERAL,\n          ...options,\n          type: meta,\n          name\n        };\n\n    if (\n      isValidLogLevelConfig(\n        logMeta.type,\n        logLevel,\n        logMeta.category ? logMeta.category : LogCategories.GENERAL\n      )\n    ) {\n      consoleLog(logMeta, ...args);\n    }\n  };\n};\n\nconst validateLogger = (\n  type: LogLevel,\n  name: string,\n  options: LoggerOptions,\n  callback: (message: string | LoggerMessage) => void\n) => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (message: string | LoggerMessage) => {\n    const params = isSetString(message)\n      ? {\n          name,\n          plugin: options.plugin,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            ...options\n          },\n          message\n        }\n      : {\n          name,\n          plugin: options.plugin,\n          ...message,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            plugin: message.plugin,\n            ...options,\n            ...message.meta\n          }\n        };\n\n    if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {\n      callback(params);\n    }\n  };\n};\n\nconst validateCustomLogger = (\n  type: LogLevel,\n  name: string,\n  options: LoggerOptions,\n  callback?: (message: string | LoggerMessage) => void,\n  customCallback?: (message: CustomLoggerMessage) => void\n) => {\n  const logLevel = resolveLogLevel(options.logLevel, options.mode);\n\n  return (message: string | LoggerMessage) => {\n    const params = isSetString(message)\n      ? {\n          name,\n          plugin: options.plugin,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            ...options\n          },\n          message\n        }\n      : {\n          name,\n          plugin: options.plugin,\n          ...message,\n          meta: {\n            type,\n            name,\n            category: LogCategories.GENERAL,\n            logId: uuid(),\n            timestamp: Date.now(),\n            plugin: message.plugin,\n            ...options,\n            ...message.meta\n          }\n        };\n\n    if (isValidLogLevelConfig(type, logLevel, params.meta.category)) {\n      callback?.(params);\n      customCallback?.(params);\n    }\n  };\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param logger - The original logger to wrap with the custom logger.\n * @param secondaryLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.\n * @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.\n */\nexport const withLogger = (logger: Logger, secondaryLogger: Logger): Logger => {\n  const options = { ...secondaryLogger.options, ...logger.options };\n\n  const result = {\n    options,\n    error: validateLogger(\n      \"error\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.error?.(message);\n        secondaryLogger.error?.(message);\n      }\n    ),\n    warn: validateLogger(\n      \"warn\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.warn?.(message);\n        secondaryLogger.warn?.(message);\n      }\n    ),\n    info: validateLogger(\n      \"info\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.info?.(message);\n        secondaryLogger.info?.(message);\n      }\n    ),\n    debug: validateLogger(\n      \"debug\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.debug?.(message);\n        secondaryLogger.debug?.(message);\n      }\n    ),\n    trace: validateLogger(\n      \"trace\",\n      options.name!,\n      options,\n      (message: string | LoggerMessage) => {\n        logger.trace?.(message);\n        secondaryLogger.trace?.(message);\n      }\n    )\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param logger - The original logger to wrap with the custom logger.\n * @param customLogger - The custom logger to use for logging messages, which can be used to override the default logging behavior of the original logger.\n * @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.\n */\nexport const withCustomLogger = (\n  logger: Logger,\n  customLogger: CustomLogger\n): Logger => {\n  const result = {\n    options: logger.options,\n    error: validateCustomLogger(\n      \"error\",\n      logger.options.name!,\n      logger.options,\n      logger.error.bind(logger),\n      customLogger.error?.bind(customLogger)\n    ),\n    warn: validateCustomLogger(\n      \"warn\",\n      logger.options.name!,\n      logger.options,\n      logger.warn.bind(logger),\n      customLogger.warn?.bind(customLogger)\n    ),\n    info: validateCustomLogger(\n      \"info\",\n      logger.options.name!,\n      logger.options,\n      logger.info.bind(logger),\n      customLogger.info?.bind(customLogger)\n    ),\n    debug: validateCustomLogger(\n      \"debug\",\n      logger.options.name!,\n      logger.options,\n      logger.debug.bind(logger),\n      customLogger.debug?.bind(customLogger)\n    ),\n    trace: validateCustomLogger(\n      \"trace\",\n      logger.options.name!,\n      logger.options,\n      logger.trace.bind(logger),\n      customLogger.trace?.bind(customLogger)\n    )\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n\nexport const consoleLogger = (\n  type: LogLevel,\n  message: string | LoggerMessage\n) =>\n  consoleLog(\n    isSetString(message)\n      ? {\n          type,\n          category: LogCategories.GENERAL,\n          logId: uuid(),\n          timestamp: Date.now()\n        }\n      : {\n          type,\n          category: LogCategories.GENERAL,\n          logId: uuid(),\n          timestamp: Date.now(),\n          ...message.meta\n        },\n    isSetString(message) ? message : message.message\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, 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 createLogger = (\n  name: string,\n  options: LoggerOptions,\n  callback: (\n    type: LogLevel,\n    message: string | LoggerMessage\n  ) => void = consoleLogger\n): Logger => {\n  const result = {\n    options: { ...options, name },\n    error: validateLogger(\"error\", name, { ...options, name }, message =>\n      callback(\"error\", message)\n    ),\n    warn: validateLogger(\"warn\", name, { ...options, name }, message =>\n      callback(\"warn\", message)\n    ),\n    info: validateLogger(\"info\", name, { ...options, name }, message =>\n      callback(\"info\", message)\n    ),\n    debug: validateLogger(\"debug\", name, { ...options, name }, message =>\n      callback(\"debug\", message)\n    ),\n    trace: validateLogger(\"trace\", name, { ...options, name }, message =>\n      callback(\"trace\", message)\n    )\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\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 options - 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, options: LogFnOptions): LogFn => {\n  return (meta, ...args) =>\n    options.source || options.category\n      ? logFn(\n          isSetObject(meta)\n            ? { ...options, ...meta }\n            : { ...options, type: meta },\n          `${colorBackground(String(options.source || options.category))} ${args\n            .filter(Boolean)\n            .map(arg => String(arg).trim())\n            .join(\" \")} `\n        )\n      : logFn(meta, ...args);\n};\n\n/**\n * 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.\n *\n * @param logger - The original logger to extend.\n * @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.\n * @returns A new logger that includes the badge in its output for each log message.\n */\nexport const extendLogger = (\n  logger: Logger,\n  options: LoggerOptions\n): Logger => {\n  const opts = { ...logger.options, ...options } as RequiredKeys<\n    LoggerOptions,\n    \"name\"\n  >;\n\n  const result = {\n    options: opts,\n    error: validateLogger(\"error\", opts.name, opts, logger.error.bind(logger)),\n    warn: validateLogger(\"warn\", opts.name, opts, logger.warn.bind(logger)),\n    info: validateLogger(\"info\", opts.name, opts, logger.info.bind(logger)),\n    debug: validateLogger(\"debug\", opts.name, opts, logger.debug.bind(logger)),\n    trace: validateLogger(\"trace\", opts.name, opts, logger.trace.bind(logger))\n  } as Logger;\n\n  result.log = (type: LogLevel, message: string | LoggerMessage) => {\n    switch (type) {\n      case \"error\":\n        result.error(message);\n        break;\n      case \"warn\":\n        result.warn(message);\n        break;\n      case \"info\":\n        result.info(message);\n        break;\n      case \"debug\":\n        result.debug(message);\n        break;\n      case \"trace\":\n        result.trace(message);\n        break;\n      case \"silent\":\n        break;\n      default:\n        result.info(message);\n        break;\n    }\n  };\n\n  return result;\n};\n"],"mappings":"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"}

package/dist/plugin-utils/paths.cjs

@@ -44,7 +44,7 @@ let _stryke_path_join = require("@stryke/path/join");
 */
 function replacePathTokens(context, path) {
 	if (!path) return path;
-	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd() || "./").replaceAll("{workspaceRoot}", context.config.cwd || process.cwd() || "./").replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", (0, _stryke_path_join.joinPaths)(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", (0, _stryke_path_replace.replacePath)(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", (0, _stryke_path_replace.replacePath)(context.entryPath, context.config.cwd));
+	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd()).replaceAll("{workspaceRoot}", context.config.cwd || process.cwd()).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", (0, _stryke_path_join.joinPaths)(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", (0, _stryke_path_replace.replacePath)(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", (0, _stryke_path_replace.replacePath)(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", (0, _stryke_path_replace.replacePath)(context.entryPath, context.config.cwd));
 	return context.config.output.copy && (0, _stryke_type_checks_is_set_string.isSetString)(context.config.output.copy.path) ? result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path) : result;
 }
 

package/dist/plugin-utils/paths.mjs

@@ -42,7 +42,7 @@ import { joinPaths } from "@stryke/path/join";
 */
 function replacePathTokens(context, path) {
 	if (!path) return path;
-	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd() || "./").replaceAll("{workspaceRoot}", context.config.cwd || process.cwd() || "./").replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", joinPaths(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", replacePath(context.entryPath, context.config.cwd));
+	const result = path.replaceAll("{cwd}", context.config.cwd || process.cwd()).replaceAll("{workspaceRoot}", context.config.cwd || process.cwd()).replaceAll("{root}", context.config.root).replaceAll("{projectRoot}", context.config.root).replaceAll("{sourceRoot}", joinPaths(context.config.root, "src")).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.path).replaceAll("{output}", context.config.output.path).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.config.cwd)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{builtinsPath}", replacePath(context.builtinsPath, context.config.cwd)).replaceAll("{entryPath}", replacePath(context.entryPath, context.config.cwd));
 	return context.config.output.copy && isSetString(context.config.output.copy.path) ? result.replaceAll("{copyPath}", context.config.output.copy.path).replaceAll("{copy}", context.config.output.copy.path) : result;
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/plugin-utils/paths.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 { joinPaths } from \"@stryke/path/join\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { IsUndefined } from \"@stryke/types/base\";\nimport { UnresolvedContext } from \"../types/context\";\n\n/**\n * Replaces tokens in the given path string with their corresponding values from the context.\n *\n * @remarks\n * The following tokens are supported:\n * - `{cwd}` - The current working directory.\n * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).\n * - `{root}` - The root directory of the project (same as `{projectRoot}`).\n * - `{projectRoot}` - The root directory of the project (same as `{root}`).\n * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).\n * - `{powerlinesPath}` - The directory where Powerlines is installed.\n * - `{cachePath}` - The environment's directory for cached files.\n * - `{dataPath}` - The environment's directory for data files.\n * - `{logPath}` - The environment's directory for log files.\n * - `{tempPath}` - The environment's directory for temporary files.\n * - `{configPath}` - The environment's directory for configuration files.\n * - `{output}` - The configured output directory for the project.\n * - `{outputPath}` - The configured output directory for the project.\n * - `{copy}` - The configured final/copied distribution directory for the project.\n * - `{copyPath}` - The configured final/copied distribution directory for the project.\n * - `{artifactsPath}` - The configured directory for build artifacts.\n * - `{builtinPath}` - The configured directory for generated built-in plugins.\n * - `{entryPath}` - The configured directory for generated entry files.\n *\n * @example\n * ```ts\n * const path = replacePathTokens(context, \"{root}/dist\");\n * // If context.config.root is \"/home/user/project\", this will return \"/home/user/project/dist\"\n *\n * const pathWithCopy = replacePathTokens(context, \"{copy}\");\n * // If context.config.output.copy.path is \"/home/user/project/dist-copy\", this will return \"/home/user/project/dist-copy\"\n * ```\n *\n * @param context - The context containing the values for the path tokens.\n * @param path - The path string with tokens to replace.\n * @returns The path string with tokens replaced by their corresponding values from the context.\n */\nexport function replacePathTokens(\n  context: UnresolvedContext,\n  path?: string\n): IsUndefined<typeof path> extends true ? undefined : string {\n  if (!path) {\n    return path as IsUndefined<typeof path> extends true ? undefined : string;\n  }\n\n  const result = path\n    .replaceAll(\"{cwd}\", context.config.cwd || process.cwd() || \"./\")\n    .replaceAll(\"{workspaceRoot}\", context.config.cwd || process.cwd() || \"./\")\n    .replaceAll(\"{root}\", context.config.root)\n    .replaceAll(\"{projectRoot}\", context.config.root)\n    .replaceAll(\"{sourceRoot}\", joinPaths(context.config.root, \"src\"))\n    .replaceAll(\"{powerlinesPath}\", context.powerlinesPath)\n    .replaceAll(\"{cachePath}\", context.cachePath)\n    .replaceAll(\"{dataPath}\", context.dataPath)\n    .replaceAll(\"{logPath}\", context.envPaths.log)\n    .replaceAll(\"{tempPath}\", context.envPaths.temp)\n    .replaceAll(\"{configPath}\", context.envPaths.config)\n    .replaceAll(\"{outputPath}\", context.config.output.path)\n    .replaceAll(\"{output}\", context.config.output.path)\n\n    .replaceAll(\n      \"{artifactsPath}\",\n      replacePath(context.artifactsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinsPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{entryPath}\",\n      replacePath(context.entryPath, context.config.cwd)\n    );\n\n  return context.config.output.copy &&\n    isSetString(context.config.output.copy.path)\n    ? result\n        .replaceAll(\"{copyPath}\", context.config.output.copy.path)\n        .replaceAll(\"{copy}\", context.config.output.copy.path)\n    : result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,kBACd,SACA,MAC4D;AAC5D,KAAI,CAAC,KACH,QAAO;CAGT,MAAM,SAAS,KACZ,WAAW,SAAS,QAAQ,OAAO,OAAO,QAAQ,KAAK,IAAI,KAAK,CAChE,WAAW,mBAAmB,QAAQ,OAAO,OAAO,QAAQ,KAAK,IAAI,KAAK,CAC1E,WAAW,UAAU,QAAQ,OAAO,KAAK,CACzC,WAAW,iBAAiB,QAAQ,OAAO,KAAK,CAChD,WAAW,gBAAgB,UAAU,QAAQ,OAAO,MAAM,MAAM,CAAC,CACjE,WAAW,oBAAoB,QAAQ,eAAe,CACtD,WAAW,eAAe,QAAQ,UAAU,CAC5C,WAAW,cAAc,QAAQ,SAAS,CAC1C,WAAW,aAAa,QAAQ,SAAS,IAAI,CAC7C,WAAW,cAAc,QAAQ,SAAS,KAAK,CAC/C,WAAW,gBAAgB,QAAQ,SAAS,OAAO,CACnD,WAAW,gBAAgB,QAAQ,OAAO,OAAO,KAAK,CACtD,WAAW,YAAY,QAAQ,OAAO,OAAO,KAAK,CAElD,WACC,mBACA,YAAY,QAAQ,eAAe,QAAQ,OAAO,IAAI,CACvD,CACA,WACC,iBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,kBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,eACA,YAAY,QAAQ,WAAW,QAAQ,OAAO,IAAI,CACnD;AAEH,QAAO,QAAQ,OAAO,OAAO,QAC3B,YAAY,QAAQ,OAAO,OAAO,KAAK,KAAK,GAC1C,OACG,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK,KAAK,CACzD,WAAW,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,GACxD"}
+{"version":3,"file":"paths.mjs","names":[],"sources":["../../src/plugin-utils/paths.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 { joinPaths } from \"@stryke/path/join\";\nimport { replacePath } from \"@stryke/path/replace\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { IsUndefined } from \"@stryke/types/base\";\nimport { UnresolvedContext } from \"../types/context\";\n\n/**\n * Replaces tokens in the given path string with their corresponding values from the context.\n *\n * @remarks\n * The following tokens are supported:\n * - `{cwd}` - The current working directory.\n * - `{workspaceRoot}` - The current working directory (same as `{cwd}`).\n * - `{root}` - The root directory of the project (same as `{projectRoot}`).\n * - `{projectRoot}` - The root directory of the project (same as `{root}`).\n * - `{sourceRoot}` - The source root directory of the project (usually `{root}/src`).\n * - `{powerlinesPath}` - The directory where Powerlines is installed.\n * - `{cachePath}` - The environment's directory for cached files.\n * - `{dataPath}` - The environment's directory for data files.\n * - `{logPath}` - The environment's directory for log files.\n * - `{tempPath}` - The environment's directory for temporary files.\n * - `{configPath}` - The environment's directory for configuration files.\n * - `{output}` - The configured output directory for the project.\n * - `{outputPath}` - The configured output directory for the project.\n * - `{copy}` - The configured final/copied distribution directory for the project.\n * - `{copyPath}` - The configured final/copied distribution directory for the project.\n * - `{artifactsPath}` - The configured directory for build artifacts.\n * - `{builtinPath}` - The configured directory for generated built-in plugins.\n * - `{entryPath}` - The configured directory for generated entry files.\n *\n * @example\n * ```ts\n * const path = replacePathTokens(context, \"{root}/dist\");\n * // If context.config.root is \"/home/user/project\", this will return \"/home/user/project/dist\"\n *\n * const pathWithCopy = replacePathTokens(context, \"{copy}\");\n * // If context.config.output.copy.path is \"/home/user/project/dist-copy\", this will return \"/home/user/project/dist-copy\"\n * ```\n *\n * @param context - The context containing the values for the path tokens.\n * @param path - The path string with tokens to replace.\n * @returns The path string with tokens replaced by their corresponding values from the context.\n */\nexport function replacePathTokens(\n  context: UnresolvedContext,\n  path?: string\n): IsUndefined<typeof path> extends true ? undefined : string {\n  if (!path) {\n    return path as IsUndefined<typeof path> extends true ? undefined : string;\n  }\n\n  const result = path\n    .replaceAll(\"{cwd}\", context.config.cwd || process.cwd())\n    .replaceAll(\"{workspaceRoot}\", context.config.cwd || process.cwd())\n    .replaceAll(\"{root}\", context.config.root)\n    .replaceAll(\"{projectRoot}\", context.config.root)\n    .replaceAll(\"{sourceRoot}\", joinPaths(context.config.root, \"src\"))\n    .replaceAll(\"{powerlinesPath}\", context.powerlinesPath)\n    .replaceAll(\"{cachePath}\", context.cachePath)\n    .replaceAll(\"{dataPath}\", context.dataPath)\n    .replaceAll(\"{logPath}\", context.envPaths.log)\n    .replaceAll(\"{tempPath}\", context.envPaths.temp)\n    .replaceAll(\"{configPath}\", context.envPaths.config)\n    .replaceAll(\"{outputPath}\", context.config.output.path)\n    .replaceAll(\"{output}\", context.config.output.path)\n    .replaceAll(\n      \"{artifactsPath}\",\n      replacePath(context.artifactsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{builtinsPath}\",\n      replacePath(context.builtinsPath, context.config.cwd)\n    )\n    .replaceAll(\n      \"{entryPath}\",\n      replacePath(context.entryPath, context.config.cwd)\n    );\n\n  return context.config.output.copy &&\n    isSetString(context.config.output.copy.path)\n    ? result\n        .replaceAll(\"{copyPath}\", context.config.output.copy.path)\n        .replaceAll(\"{copy}\", context.config.output.copy.path)\n    : result;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6DA,SAAgB,kBACd,SACA,MAC4D;AAC5D,KAAI,CAAC,KACH,QAAO;CAGT,MAAM,SAAS,KACZ,WAAW,SAAS,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CACxD,WAAW,mBAAmB,QAAQ,OAAO,OAAO,QAAQ,KAAK,CAAC,CAClE,WAAW,UAAU,QAAQ,OAAO,KAAK,CACzC,WAAW,iBAAiB,QAAQ,OAAO,KAAK,CAChD,WAAW,gBAAgB,UAAU,QAAQ,OAAO,MAAM,MAAM,CAAC,CACjE,WAAW,oBAAoB,QAAQ,eAAe,CACtD,WAAW,eAAe,QAAQ,UAAU,CAC5C,WAAW,cAAc,QAAQ,SAAS,CAC1C,WAAW,aAAa,QAAQ,SAAS,IAAI,CAC7C,WAAW,cAAc,QAAQ,SAAS,KAAK,CAC/C,WAAW,gBAAgB,QAAQ,SAAS,OAAO,CACnD,WAAW,gBAAgB,QAAQ,OAAO,OAAO,KAAK,CACtD,WAAW,YAAY,QAAQ,OAAO,OAAO,KAAK,CAClD,WACC,mBACA,YAAY,QAAQ,eAAe,QAAQ,OAAO,IAAI,CACvD,CACA,WACC,iBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,kBACA,YAAY,QAAQ,cAAc,QAAQ,OAAO,IAAI,CACtD,CACA,WACC,eACA,YAAY,QAAQ,WAAW,QAAQ,OAAO,IAAI,CACnD;AAEH,QAAO,QAAQ,OAAO,OAAO,QAC3B,YAAY,QAAQ,OAAO,OAAO,KAAK,KAAK,GAC1C,OACG,WAAW,cAAc,QAAQ,OAAO,OAAO,KAAK,KAAK,CACzD,WAAW,UAAU,QAAQ,OAAO,OAAO,KAAK,KAAK,GACxD"}

package/dist/types/logging.d.cts

@@ -106,6 +106,7 @@ interface Logger {
   info: (message: string | LoggerMessage) => void;
   debug: (message: string | LoggerMessage) => void;
   trace: (message: string | LoggerMessage) => void;
+  log: (type: LogLevel, message: string | LoggerMessage) => void;
 }
 /**
  * A type representing a log message that can be passed to a custom logger, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link CustomLogger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in their custom logging implementation.

package/dist/types/logging.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/types/logging.ts"],"mappings":";;;;;cAsBa,SAAA;EAAA;;;;;;;cASA,UAAA;AAAA,KASD,QAAA,WAAmB,UAAA;AAAA,cAElB,aAAA;EAAA;;;;;;;;;;;cAaA,cAAA;AAAA,KAaD,WAAA,WAAsB,cAAA;AAAA,UAEjB,OAAA;EAjBP;;;EAqBR,KAAA;;;;EAIA,IAAA,EAAM,QAAA;;;;EAIN,QAAA,EAAU,WAAA;;;;EAIV,SAAA;EApBQ;;;EAwBR,IAAA;EAtBU;;;EA0BV,WAAA;EA1B8C;AAEhD;;EA4BE,cAAA;EAhBqB;;;EAoBrB,OAAA;EApBA;;;EAwBA,IAAA;EAZA;;;EAgBA,WAAA;EAAA;;;EAIA,MAAA;EAIM;AAGR;;EAHE,MAAA;AAAA;AAAA,KAGU,YAAA,GAAe,IAAA,CACzB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGD,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,KAAc,IAAA;AAAA,KAE7B,UAAA,GAAa,WAAA,CACvB,IAAA,CAAK,OAAA;AAAA,KAIK,aAAA,GAAgB,IAAA,CAAK,UAAA;EAC/B,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,UAGI,iBAAA,gBAAiC,eAAA;EAChD,IAAA,EAAM,KAAA;AAAA;AAAA,KAGI,UAAA,GAAa,iBAAA,CAAkB,OAAA,CAAQ,OAAA;AApBnD;;;AAAA,KAyBY,aAAA,GAAgB,iBAAA,CAAkB,UAAA;;;;UAK7B,MAAA;EACf,OAAA,EAAS,aAAA;EACT,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,KAAA,GAAQ,OAAA,WAAkB,aAAA;AAAA;;;;KAMhB,mBAAA,GAAsB,iBAAA,CAAkB,IAAA,CAAK,OAAA;;;;UAKxC,YAAA;EAzCK;;;;;;EAgDpB,KAAA,IAAS,OAAA,EAAS,mBAAA;EAhDK;;;;;AAKzB;EAkDE,IAAA,IAAQ,OAAA,EAAS,mBAAA;;;;;;;EAOjB,IAAA,IAAQ,OAAA,EAAS,mBAAA;EAzDS;;;;;;EAgE1B,KAAA,IAAS,OAAA,EAAS,mBAAA;EA9DW;AAG/B;;;;;EAkEE,KAAA,IAAS,OAAA,EAAS,mBAAA;AAAA;AAAA,KAGR,kBAAA,GACR,QAAA,GACA,YAAA,CACE,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAId,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}
+{"version":3,"file":"logging.d.cts","names":[],"sources":["../../src/types/logging.ts"],"mappings":";;;;;cAsBa,SAAA;EAAA;;;;;;;cASA,UAAA;AAAA,KASD,QAAA,WAAmB,UAAA;AAAA,cAElB,aAAA;EAAA;;;;;;;;;;;cAaA,cAAA;AAAA,KAaD,WAAA,WAAsB,cAAA;AAAA,UAEjB,OAAA;EAjBP;;;EAqBR,KAAA;;;;EAIA,IAAA,EAAM,QAAA;;;;EAIN,QAAA,EAAU,WAAA;;;;EAIV,SAAA;EApBQ;;;EAwBR,IAAA;EAtBU;;;EA0BV,WAAA;EA1B8C;AAEhD;;EA4BE,cAAA;EAhBqB;;;EAoBrB,OAAA;EApBA;;;EAwBA,IAAA;EAZA;;;EAgBA,WAAA;EAAA;;;EAIA,MAAA;EAIM;AAGR;;EAHE,MAAA;AAAA;AAAA,KAGU,YAAA,GAAe,IAAA,CACzB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGD,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,KAAc,IAAA;AAAA,KAE7B,UAAA,GAAa,WAAA,CACvB,IAAA,CAAK,OAAA;AAAA,KAIK,aAAA,GAAgB,IAAA,CAAK,UAAA;EAC/B,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,UAGI,iBAAA,gBAAiC,eAAA;EAChD,IAAA,EAAM,KAAA;AAAA;AAAA,KAGI,UAAA,GAAa,iBAAA,CAAkB,OAAA,CAAQ,OAAA;AApBnD;;;AAAA,KAyBY,aAAA,GAAgB,iBAAA,CAAkB,UAAA;;;;UAK7B,MAAA;EACf,OAAA,EAAS,aAAA;EACT,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,GAAA,GAAM,IAAA,EAAM,QAAA,EAAU,OAAA,WAAkB,aAAA;AAAA;;;;KAM9B,mBAAA,GAAsB,iBAAA,CAAkB,IAAA,CAAK,OAAA;;;AArCzD;UA0CiB,YAAA;;;;;;;EAOf,KAAA,IAAS,OAAA,EAAS,mBAAA;EAhDlB;;;;AAIF;;EAmDE,IAAA,IAAQ,OAAA,EAAS,mBAAA;EAnDc;;;;;;EA0D/B,IAAA,IAAQ,OAAA,EAAS,mBAAA;EA1Dc;;;;;;EAiE/B,KAAA,IAAS,OAAA,EAAS,mBAAA;EA5DH;;;;;;EAmEf,KAAA,IAAS,OAAA,EAAS,mBAAA;AAAA;AAAA,KAGR,kBAAA,GACR,QAAA,GACA,YAAA,CACE,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAId,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}

package/dist/types/logging.d.mts

@@ -106,6 +106,7 @@ interface Logger {
   info: (message: string | LoggerMessage) => void;
   debug: (message: string | LoggerMessage) => void;
   trace: (message: string | LoggerMessage) => void;
+  log: (type: LogLevel, message: string | LoggerMessage) => void;
 }
 /**
  * A type representing a log message that can be passed to a custom logger, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link CustomLogger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in their custom logging implementation.

package/dist/types/logging.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/types/logging.ts"],"mappings":";;;;;cAsBa,SAAA;EAAA;;;;;;;cASA,UAAA;AAAA,KASD,QAAA,WAAmB,UAAA;AAAA,cAElB,aAAA;EAAA;;;;;;;;;;;cAaA,cAAA;AAAA,KAaD,WAAA,WAAsB,cAAA;AAAA,UAEjB,OAAA;EAjBP;;;EAqBR,KAAA;;;;EAIA,IAAA,EAAM,QAAA;;;;EAIN,QAAA,EAAU,WAAA;;;;EAIV,SAAA;EApBQ;;;EAwBR,IAAA;EAtBU;;;EA0BV,WAAA;EA1B8C;AAEhD;;EA4BE,cAAA;EAhBqB;;;EAoBrB,OAAA;EApBA;;;EAwBA,IAAA;EAZA;;;EAgBA,WAAA;EAAA;;;EAIA,MAAA;EAIM;AAGR;;EAHE,MAAA;AAAA;AAAA,KAGU,YAAA,GAAe,IAAA,CACzB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGD,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,KAAc,IAAA;AAAA,KAE7B,UAAA,GAAa,WAAA,CACvB,IAAA,CAAK,OAAA;AAAA,KAIK,aAAA,GAAgB,IAAA,CAAK,UAAA;EAC/B,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,UAGI,iBAAA,gBAAiC,eAAA;EAChD,IAAA,EAAM,KAAA;AAAA;AAAA,KAGI,UAAA,GAAa,iBAAA,CAAkB,OAAA,CAAQ,OAAA;AApBnD;;;AAAA,KAyBY,aAAA,GAAgB,iBAAA,CAAkB,UAAA;;;;UAK7B,MAAA;EACf,OAAA,EAAS,aAAA;EACT,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,KAAA,GAAQ,OAAA,WAAkB,aAAA;AAAA;;;;KAMhB,mBAAA,GAAsB,iBAAA,CAAkB,IAAA,CAAK,OAAA;;;;UAKxC,YAAA;EAzCK;;;;;;EAgDpB,KAAA,IAAS,OAAA,EAAS,mBAAA;EAhDK;;;;;AAKzB;EAkDE,IAAA,IAAQ,OAAA,EAAS,mBAAA;;;;;;;EAOjB,IAAA,IAAQ,OAAA,EAAS,mBAAA;EAzDS;;;;;;EAgE1B,KAAA,IAAS,OAAA,EAAS,mBAAA;EA9DW;AAG/B;;;;;EAkEE,KAAA,IAAS,OAAA,EAAS,mBAAA;AAAA;AAAA,KAGR,kBAAA,GACR,QAAA,GACA,YAAA,CACE,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAId,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}
+{"version":3,"file":"logging.d.mts","names":[],"sources":["../../src/types/logging.ts"],"mappings":";;;;;cAsBa,SAAA;EAAA;;;;;;;cASA,UAAA;AAAA,KASD,QAAA,WAAmB,UAAA;AAAA,cAElB,aAAA;EAAA;;;;;;;;;;;cAaA,cAAA;AAAA,KAaD,WAAA,WAAsB,cAAA;AAAA,UAEjB,OAAA;EAjBP;;;EAqBR,KAAA;;;;EAIA,IAAA,EAAM,QAAA;;;;EAIN,QAAA,EAAU,WAAA;;;;EAIV,SAAA;EApBQ;;;EAwBR,IAAA;EAtBU;;;EA0BV,WAAA;EA1B8C;AAEhD;;EA4BE,cAAA;EAhBqB;;;EAoBrB,OAAA;EApBA;;;EAwBA,IAAA;EAZA;;;EAgBA,WAAA;EAAA;;;EAIA,MAAA;EAIM;AAGR;;EAHE,MAAA;AAAA;AAAA,KAGU,YAAA,GAAe,IAAA,CACzB,OAAA,CAAQ,OAAA;EAGR,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,KAGD,SAAA,GACR,QAAA,GACA,WAAA,CAAY,OAAA;AAAA,KAEJ,KAAA,IAAS,IAAA,EAAM,SAAA,KAAc,IAAA;AAAA,KAE7B,UAAA,GAAa,WAAA,CACvB,IAAA,CAAK,OAAA;AAAA,KAIK,aAAA,GAAgB,IAAA,CAAK,UAAA;EAC/B,IAAA,GAAO,IAAA;EACP,QAAA,GAAW,kBAAA;AAAA;AAAA,UAGI,iBAAA,gBAAiC,eAAA;EAChD,IAAA,EAAM,KAAA;AAAA;AAAA,KAGI,UAAA,GAAa,iBAAA,CAAkB,OAAA,CAAQ,OAAA;AApBnD;;;AAAA,KAyBY,aAAA,GAAgB,iBAAA,CAAkB,UAAA;;;;UAK7B,MAAA;EACf,OAAA,EAAS,aAAA;EACT,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,IAAA,GAAO,OAAA,WAAkB,aAAA;EACzB,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,KAAA,GAAQ,OAAA,WAAkB,aAAA;EAC1B,GAAA,GAAM,IAAA,EAAM,QAAA,EAAU,OAAA,WAAkB,aAAA;AAAA;;;;KAM9B,mBAAA,GAAsB,iBAAA,CAAkB,IAAA,CAAK,OAAA;;;AArCzD;UA0CiB,YAAA;;;;;;;EAOf,KAAA,IAAS,OAAA,EAAS,mBAAA;EAhDlB;;;;AAIF;;EAmDE,IAAA,IAAQ,OAAA,EAAS,mBAAA;EAnDc;;;;;;EA0D/B,IAAA,IAAQ,OAAA,EAAS,mBAAA;EA1Dc;;;;;;EAiE/B,KAAA,IAAS,OAAA,EAAS,mBAAA;EA5DH;;;;;;EAmEf,KAAA,IAAS,OAAA,EAAS,mBAAA;AAAA;AAAA,KAGR,kBAAA,GACR,QAAA,GACA,YAAA,CACE,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA,KAId,sBAAA,GAAyB,MAAA,CAAO,WAAA,EAAa,QAAA;AAAA"}

package/dist/types/logging.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"logging.mjs","names":[],"sources":["../../src/types/logging.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 { PartialKeys, RequiredKeys } from \"@stryke/types/base\";\nimport { UnpluginMessage } from \"unplugin\";\nimport { Mode } from \"./config\";\n\nexport const LogLevels = {\n  SILENT: \"silent\",\n  ERROR: \"error\",\n  WARN: \"warn\",\n  INFO: \"info\",\n  DEBUG: \"debug\",\n  TRACE: \"trace\"\n} as const;\n\nexport const LOG_LEVELS = [\n  LogLevels.SILENT,\n  LogLevels.ERROR,\n  LogLevels.WARN,\n  LogLevels.INFO,\n  LogLevels.DEBUG,\n  LogLevels.TRACE\n] as const;\n\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\nexport const LogCategories = {\n  GENERAL: \"general\",\n  FS: \"fs\",\n  PERFORMANCE: \"performance\",\n  CONFIG: \"config\",\n  PLUGINS: \"plugins\",\n  HOOKS: \"hooks\",\n  ENV: \"env\",\n  IPC: \"ipc\",\n  BABEL: \"babel\",\n  NETWORK: \"network\"\n} as const;\n\nexport const LOG_CATEGORIES = [\n  LogCategories.GENERAL,\n  LogCategories.FS,\n  LogCategories.PERFORMANCE,\n  LogCategories.CONFIG,\n  LogCategories.PLUGINS,\n  LogCategories.HOOKS,\n  LogCategories.ENV,\n  LogCategories.IPC,\n  LogCategories.NETWORK,\n  LogCategories.BABEL\n] as const;\n\nexport type LogCategory = (typeof LOG_CATEGORIES)[number];\n\nexport interface LogMeta {\n  /**\n   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.\n   */\n  logId: string;\n  /**\n   * The log level of the message, which indicates the severity or importance of the log entry. The log level can be used to filter log messages based on their importance, allowing users to focus on critical issues or relevant information while ignoring less important messages.\n   */\n  type: LogLevel;\n  /**\n   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.\n   */\n  category: LogCategory;\n  /**\n   * The timestamp when the IPC message was created, represented as the number of milliseconds since the Unix epoch.\n   */\n  timestamp: number;\n  /**\n   * The name of the project or package associated with the log message, which can be used to identify the source of the log entry and provide context for the message.\n   */\n  name?: string;\n  /**\n   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.\n   */\n  executionId?: string;\n  /**\n   * The zero-based index of the current execution within the sequence of executions in the same process.\n   */\n  executionIndex?: number;\n  /**\n   * Optional command identifier to specify the command or task associated with the log message, which can be used to provide additional context about the operation being performed when the log entry was generated.\n   */\n  command?: string;\n  /**\n   * Optional hook name to specify the plugin hook associated with the log message, which can be used to provide additional context about the specific plugin hook being executed when the log entry was generated.\n   */\n  hook?: string;\n  /**\n   * Optional environment identifier to specify the context or environment in which the message is being processed.\n   */\n  environment?: string;\n  /**\n   * Optional plugin name to specify the source plugin of the log message.\n   */\n  plugin?: string;\n  /**\n   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.\n   */\n  source?: string;\n}\n\nexport type LogFnOptions = Omit<\n  Partial<LogMeta>,\n  \"logId\" | \"timestamp\" | \"name\" | \"type\"\n> & {\n  mode?: Mode;\n  logLevel?: LogLevelUserConfig;\n};\n\nexport type LogFnMeta =\n  | LogLevel\n  | PartialKeys<LogMeta, \"logId\" | \"timestamp\" | \"name\" | \"category\">;\n\nexport type LogFn = (meta: LogFnMeta, ...args: string[]) => void;\n\nexport type LoggerMeta = PartialKeys<\n  Omit<LogMeta, \"type\">,\n  \"logId\" | \"timestamp\" | \"name\" | \"category\"\n>;\n\nexport type LoggerOptions = Omit<LoggerMeta, \"logId\" | \"timestamp\" | \"type\"> & {\n  mode?: Mode;\n  logLevel?: LogLevelUserConfig;\n};\n\nexport interface PowerlinesMessage<TMeta> extends UnpluginMessage {\n  meta: TMeta;\n}\n\nexport type LogMessage = PowerlinesMessage<Partial<LogMeta>>;\n\n/**\n * A type representing a log message that can be passed to the logging methods defined in the {@link Logger} interface, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link Logger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in the logging implementation.\n */\nexport type LoggerMessage = PowerlinesMessage<LoggerMeta>;\n\n/**\n * An internal interface representing a logger instance used within Powerlines for logging messages at various log levels, including \"error\", \"warn\", \"info\", \"debug\", and \"trace\". This interface defines methods for logging messages at each log level, which accept a message parameter that can be either a string or an object containing the log metadata and message content. The logger instance also includes an options property that contains the configuration options used for the logger, such as the source, command, environment, plugin, log level, and other relevant metadata. This interface is intended for internal use within Powerlines and is not meant to be implemented by users directly; instead, users can provide a custom logger that implements the {@link CustomLogger} interface to integrate with Powerlines' logging system.\n */\nexport interface Logger {\n  options: LoggerOptions;\n  error: (message: string | LoggerMessage) => void;\n  warn: (message: string | LoggerMessage) => void;\n  info: (message: string | LoggerMessage) => void;\n  debug: (message: string | LoggerMessage) => void;\n  trace: (message: string | LoggerMessage) => void;\n}\n\n/**\n * A type representing a log message that can be passed to a custom logger, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link CustomLogger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in their custom logging implementation.\n */\nexport type CustomLoggerMessage = PowerlinesMessage<Omit<LogMeta, \"type\">>;\n\n/**\n * An interface representing a custom logger that can be provided by the user to override the default logging behavior of Powerlines. This interface defines methods for logging messages at different log levels, including \"error\", \"warn\", \"info\", \"debug\", and \"trace\". Each method accepts a message parameter, which can be either a string or an object containing the log metadata and message content. By implementing this interface, users can integrate their own logging system with Powerlines or customize the logging behavior to suit their specific needs.\n */\nexport interface CustomLogger {\n  /**\n   * A function to log messages at the \"error\" level, which indicates a serious issue that has caused a failure in the build process or a critical problem that needs immediate attention.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the error being reported.\n   * @returns void\n   */\n  error?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"warn\" level, which indicates a potential issue or a situation that may require attention but does not necessarily cause a failure in the build process.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the warning being reported.\n   * @returns void\n   */\n  warn?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"info\" level, which indicates general informational messages about the build process, such as the start and completion of tasks, configuration details, or other relevant information that may be useful for monitoring the build process.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the informational message being reported.\n   * @returns void\n   */\n  info?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"debug\" level, which indicates detailed debugging information that may be useful for diagnosing issues during development or troubleshooting problems in the build process.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the debug information being reported.\n   * @returns void\n   */\n  debug?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"trace\" level, which indicates very detailed tracing information that may be useful for in-depth analysis of the build process or for tracking the flow of execution through various stages of the build.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the trace information being reported.\n   * @returns void\n   */\n  trace?: (message: CustomLoggerMessage) => void;\n}\n\nexport type LogLevelUserConfig =\n  | LogLevel\n  | RequiredKeys<\n      Record<LogCategory, LogLevel | boolean | undefined>,\n      \"general\"\n    >;\n\nexport type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;\n"],"mappings":";AAsBA,MAAa,YAAY;CACvB,QAAQ;CACR,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,MAAa,aAAa;CACxB,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACX;AAID,MAAa,gBAAgB;CAC3B,SAAS;CACT,IAAI;CACJ,aAAa;CACb,QAAQ;CACR,SAAS;CACT,OAAO;CACP,KAAK;CACL,KAAK;CACL,OAAO;CACP,SAAS;CACV;AAED,MAAa,iBAAiB;CAC5B,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACf"}
+{"version":3,"file":"logging.mjs","names":[],"sources":["../../src/types/logging.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 { PartialKeys, RequiredKeys } from \"@stryke/types/base\";\nimport { UnpluginMessage } from \"unplugin\";\nimport { Mode } from \"./config\";\n\nexport const LogLevels = {\n  SILENT: \"silent\",\n  ERROR: \"error\",\n  WARN: \"warn\",\n  INFO: \"info\",\n  DEBUG: \"debug\",\n  TRACE: \"trace\"\n} as const;\n\nexport const LOG_LEVELS = [\n  LogLevels.SILENT,\n  LogLevels.ERROR,\n  LogLevels.WARN,\n  LogLevels.INFO,\n  LogLevels.DEBUG,\n  LogLevels.TRACE\n] as const;\n\nexport type LogLevel = (typeof LOG_LEVELS)[number];\n\nexport const LogCategories = {\n  GENERAL: \"general\",\n  FS: \"fs\",\n  PERFORMANCE: \"performance\",\n  CONFIG: \"config\",\n  PLUGINS: \"plugins\",\n  HOOKS: \"hooks\",\n  ENV: \"env\",\n  IPC: \"ipc\",\n  BABEL: \"babel\",\n  NETWORK: \"network\"\n} as const;\n\nexport const LOG_CATEGORIES = [\n  LogCategories.GENERAL,\n  LogCategories.FS,\n  LogCategories.PERFORMANCE,\n  LogCategories.CONFIG,\n  LogCategories.PLUGINS,\n  LogCategories.HOOKS,\n  LogCategories.ENV,\n  LogCategories.IPC,\n  LogCategories.NETWORK,\n  LogCategories.BABEL\n] as const;\n\nexport type LogCategory = (typeof LOG_CATEGORIES)[number];\n\nexport interface LogMeta {\n  /**\n   * A unique identifier for the log message, which can be used to correlate related log entries across different parts of the system or different executions.\n   */\n  logId: string;\n  /**\n   * The log level of the message, which indicates the severity or importance of the log entry. The log level can be used to filter log messages based on their importance, allowing users to focus on critical issues or relevant information while ignoring less important messages.\n   */\n  type: LogLevel;\n  /**\n   * The category of the log message, which can be used to classify and filter log entries based on their purpose or origin.\n   */\n  category: LogCategory;\n  /**\n   * The timestamp when the IPC message was created, represented as the number of milliseconds since the Unix epoch.\n   */\n  timestamp: number;\n  /**\n   * The name of the project or package associated with the log message, which can be used to identify the source of the log entry and provide context for the message.\n   */\n  name?: string;\n  /**\n   * A unique identifier for the current execution instance, which can be used for logging and other purposes to distinguish between different executions in the same process.\n   */\n  executionId?: string;\n  /**\n   * The zero-based index of the current execution within the sequence of executions in the same process.\n   */\n  executionIndex?: number;\n  /**\n   * Optional command identifier to specify the command or task associated with the log message, which can be used to provide additional context about the operation being performed when the log entry was generated.\n   */\n  command?: string;\n  /**\n   * Optional hook name to specify the plugin hook associated with the log message, which can be used to provide additional context about the specific plugin hook being executed when the log entry was generated.\n   */\n  hook?: string;\n  /**\n   * Optional environment identifier to specify the context or environment in which the message is being processed.\n   */\n  environment?: string;\n  /**\n   * Optional plugin name to specify the source plugin of the log message.\n   */\n  plugin?: string;\n  /**\n   * The name of the logger or source of the log message, which can be used to identify the origin of the log entry.\n   */\n  source?: string;\n}\n\nexport type LogFnOptions = Omit<\n  Partial<LogMeta>,\n  \"logId\" | \"timestamp\" | \"name\" | \"type\"\n> & {\n  mode?: Mode;\n  logLevel?: LogLevelUserConfig;\n};\n\nexport type LogFnMeta =\n  | LogLevel\n  | PartialKeys<LogMeta, \"logId\" | \"timestamp\" | \"name\" | \"category\">;\n\nexport type LogFn = (meta: LogFnMeta, ...args: string[]) => void;\n\nexport type LoggerMeta = PartialKeys<\n  Omit<LogMeta, \"type\">,\n  \"logId\" | \"timestamp\" | \"name\" | \"category\"\n>;\n\nexport type LoggerOptions = Omit<LoggerMeta, \"logId\" | \"timestamp\" | \"type\"> & {\n  mode?: Mode;\n  logLevel?: LogLevelUserConfig;\n};\n\nexport interface PowerlinesMessage<TMeta> extends UnpluginMessage {\n  meta: TMeta;\n}\n\nexport type LogMessage = PowerlinesMessage<Partial<LogMeta>>;\n\n/**\n * A type representing a log message that can be passed to the logging methods defined in the {@link Logger} interface, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link Logger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in the logging implementation.\n */\nexport type LoggerMessage = PowerlinesMessage<LoggerMeta>;\n\n/**\n * An internal interface representing a logger instance used within Powerlines for logging messages at various log levels, including \"error\", \"warn\", \"info\", \"debug\", and \"trace\". This interface defines methods for logging messages at each log level, which accept a message parameter that can be either a string or an object containing the log metadata and message content. The logger instance also includes an options property that contains the configuration options used for the logger, such as the source, command, environment, plugin, log level, and other relevant metadata. This interface is intended for internal use within Powerlines and is not meant to be implemented by users directly; instead, users can provide a custom logger that implements the {@link CustomLogger} interface to integrate with Powerlines' logging system.\n */\nexport interface Logger {\n  options: LoggerOptions;\n  error: (message: string | LoggerMessage) => void;\n  warn: (message: string | LoggerMessage) => void;\n  info: (message: string | LoggerMessage) => void;\n  debug: (message: string | LoggerMessage) => void;\n  trace: (message: string | LoggerMessage) => void;\n  log: (type: LogLevel, message: string | LoggerMessage) => void;\n}\n\n/**\n * A type representing a log message that can be passed to a custom logger, which includes the log metadata and message content. This type is used as the parameter for the logging methods defined in the {@link CustomLogger} interface, allowing users to log messages with rich metadata that can be used for filtering, formatting, or other purposes in their custom logging implementation.\n */\nexport type CustomLoggerMessage = PowerlinesMessage<Omit<LogMeta, \"type\">>;\n\n/**\n * An interface representing a custom logger that can be provided by the user to override the default logging behavior of Powerlines. This interface defines methods for logging messages at different log levels, including \"error\", \"warn\", \"info\", \"debug\", and \"trace\". Each method accepts a message parameter, which can be either a string or an object containing the log metadata and message content. By implementing this interface, users can integrate their own logging system with Powerlines or customize the logging behavior to suit their specific needs.\n */\nexport interface CustomLogger {\n  /**\n   * A function to log messages at the \"error\" level, which indicates a serious issue that has caused a failure in the build process or a critical problem that needs immediate attention.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the error being reported.\n   * @returns void\n   */\n  error?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"warn\" level, which indicates a potential issue or a situation that may require attention but does not necessarily cause a failure in the build process.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the warning being reported.\n   * @returns void\n   */\n  warn?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"info\" level, which indicates general informational messages about the build process, such as the start and completion of tasks, configuration details, or other relevant information that may be useful for monitoring the build process.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the informational message being reported.\n   * @returns void\n   */\n  info?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"debug\" level, which indicates detailed debugging information that may be useful for diagnosing issues during development or troubleshooting problems in the build process.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the debug information being reported.\n   * @returns void\n   */\n  debug?: (message: CustomLoggerMessage) => void;\n  /**\n   * A function to log messages at the \"trace\" level, which indicates very detailed tracing information that may be useful for in-depth analysis of the build process or for tracking the flow of execution through various stages of the build.\n   *\n   * @param message - The log message to be recorded, which can be a string or an object containing the log metadata and message content. The log message should provide sufficient information to understand the context and nature of the trace information being reported.\n   * @returns void\n   */\n  trace?: (message: CustomLoggerMessage) => void;\n}\n\nexport type LogLevelUserConfig =\n  | LogLevel\n  | RequiredKeys<\n      Record<LogCategory, LogLevel | boolean | undefined>,\n      \"general\"\n    >;\n\nexport type LogLevelResolvedConfig = Record<LogCategory, LogLevel>;\n"],"mappings":";AAsBA,MAAa,YAAY;CACvB,QAAQ;CACR,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACP,OAAO;CACR;AAED,MAAa,aAAa;CACxB,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACV,UAAU;CACX;AAID,MAAa,gBAAgB;CAC3B,SAAS;CACT,IAAI;CACJ,aAAa;CACb,QAAQ;CACR,SAAS;CACT,OAAO;CACP,KAAK;CACL,KAAK;CACL,OAAO;CACP,SAAS;CACV;AAED,MAAa,iBAAiB;CAC5B,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACd,cAAc;CACf"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/core",
-  "version": "0.44.1",
+  "version": "0.44.2",
   "private": false,
   "description": "An internal core package for Powerlines - please use the `powerlines` package for public usage.",
   "homepage": "https://stormsoftware.com",
@@ -201,5 +201,5 @@
     "typescript": "^6.0.3"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "e246dfd00453dc44868dac37f1b6cefb369c6e48"
+  "gitHead": "e334be23d413125e5ac9d015ba2d26b434129a7c"
 }