@powerlines/core 0.15.0 → 0.15.1

package/dist/lib/unplugin/plugin.cjs

@@ -1,11 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_lib_logger = require('../logger.cjs');
+const require_plugin_utils_virtual = require('../../plugin-utils/virtual.cjs');
+require('../../plugin-utils/index.cjs');
 const require_lib_unplugin_helpers = require('./helpers.cjs');
-const require_virtual_modules = require('../../constants/virtual-modules.cjs');
 const require_lib_unplugin_module_resolution = require('./module-resolution.cjs');
 const require_lib_utilities_source_file = require('../utilities/source-file.cjs');
-let _storm_software_config_tools_types = require("@storm-software/config-tools/types");
 let _stryke_string_format_kebab_case = require("@stryke/string-format/kebab-case");
 let _stryke_string_format_title_case = require("@stryke/string-format/title-case");
 let unplugin = require("unplugin");
@@ -18,25 +17,22 @@ let unplugin = require("unplugin");
 * @returns The unplugin instance.
 */
 function createUnpluginResolver(context, options = {}) {
-	const ctx = context;
-	(0, unplugin.setParseImpl)(ctx.parse);
+	(0, unplugin.setParseImpl)(context.parse);
 	const name = options.name || "powerlines";
-	return () => {
-		const log = require_lib_logger.extendLog(ctx.log, name);
-		log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, `Initializing ${(0, _stryke_string_format_title_case.titleCase)(name)} plugin`);
-		try {
-			const { resolveId, load } = require_lib_unplugin_module_resolution.createUnpluginModuleResolutionFunctions(context, options);
-			return {
-				name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${(0, _stryke_string_format_kebab_case.kebabCase)(name)}`,
-				api: ctx.$$internal.api,
-				resolveId,
-				load
-			};
-		} catch (error) {
-			log(_storm_software_config_tools_types.LogLevelLabel.FATAL, error?.message);
-			throw error;
-		}
-	};
+	const logger = context.extendLogger(!options.silenceHookLogging && name !== "powerlines" ? { source: name } : {});
+	logger.debug(`Initializing ${(0, _stryke_string_format_title_case.titleCase)(name)} plugin`);
+	try {
+		const { resolveId, load } = require_lib_unplugin_module_resolution.createUnpluginModuleResolutionFunctions(context, options);
+		return () => ({
+			name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${(0, _stryke_string_format_kebab_case.kebabCase)(name)}`,
+			context,
+			resolveId,
+			load
+		});
+	} catch (error) {
+		logger.error(error instanceof Error ? error.message : String(error));
+		throw error;
+	}
 }
 /**
 * Creates a Powerlines unplugin instance.
@@ -45,50 +41,47 @@ function createUnpluginResolver(context, options = {}) {
 * @returns The unplugin instance.
 */
 function createUnplugin(context, options = {}) {
-	const ctx = context;
-	(0, unplugin.setParseImpl)(ctx.parse);
+	(0, unplugin.setParseImpl)(context.parse.bind(context));
 	const name = options.name || "powerlines";
-	return () => {
-		const log = options.name ? require_lib_logger.extendLog(ctx.log, name) : ctx.log;
-		log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, `Initializing ${(0, _stryke_string_format_title_case.titleCase)(name)} plugin`);
-		try {
-			const { resolveId, load } = require_lib_unplugin_module_resolution.createUnpluginModuleResolutionFunctions(context, options);
-			async function buildStart() {
-				if (!options.silenceHookLogging) log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, "Powerlines build plugin starting...");
-				await ctx.$$internal.callHook("buildStart", { sequential: true });
-			}
-			async function transform(code, id) {
-				let transformed = code;
-				for (const hook of ctx.$$internal.environment.selectHooks("transform")) {
-					const result = await hook.handler.apply(require_lib_unplugin_helpers.combineContexts(ctx, this), [require_lib_utilities_source_file.getString(transformed), id.replace(require_virtual_modules.VIRTUAL_MODULE_PREFIX_REGEX, "")]);
-					if (result) transformed = result;
-				}
-				return transformed;
-			}
-			async function buildEnd() {
-				if (!options.silenceHookLogging) log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, "Powerlines build plugin finishing...");
-				return ctx.$$internal.callHook("buildEnd", { sequential: true });
-			}
-			async function writeBundle() {
-				if (!options.silenceHookLogging) log(_storm_software_config_tools_types.LogLevelLabel.DEBUG, "Finalizing Powerlines project output...");
-				return ctx.$$internal.callHook("writeBundle", { sequential: true });
+	const logger = context.extendLogger(!options.silenceHookLogging && name !== "powerlines" ? { source: name } : {});
+	logger.debug(`Initializing ${(0, _stryke_string_format_title_case.titleCase)(name)} plugin`);
+	try {
+		const { resolveId, load } = require_lib_unplugin_module_resolution.createUnpluginModuleResolutionFunctions(context, options);
+		async function buildStart() {
+			if (!options.silenceHookLogging) logger.debug("Powerlines build plugin starting...");
+			await context.callHook("buildStart", { sequential: true });
+		}
+		async function transform(code, id) {
+			let transformed = code;
+			for (const hook of context.environment.selectHooks("transform")) {
+				const result = await hook.handler.apply(require_lib_unplugin_helpers.combineContexts(context, this), [require_lib_utilities_source_file.getString(transformed), require_plugin_utils_virtual.removeVirtualPrefix(id)]);
+				if (result) transformed = result;
 			}
-			return {
-				name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${(0, _stryke_string_format_kebab_case.kebabCase)(name)}`,
-				api: ctx.$$internal.api,
-				resolveId,
-				load,
-				transform,
-				buildStart,
-				buildEnd,
-				writeBundle,
-				vite: { sharedDuringBuild: true }
-			};
-		} catch (error) {
-			log(_storm_software_config_tools_types.LogLevelLabel.FATAL, error?.message);
-			throw error;
+			return transformed;
+		}
+		async function buildEnd() {
+			if (!options.silenceHookLogging) logger.debug("Powerlines build plugin finishing...");
+			return context.callHook("buildEnd", { sequential: true });
+		}
+		async function writeBundle() {
+			if (!options.silenceHookLogging) logger.debug("Finalizing Powerlines project output...");
+			return context.callHook("writeBundle", { sequential: true });
 		}
-	};
+		return () => ({
+			name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${(0, _stryke_string_format_kebab_case.kebabCase)(name)}`,
+			context,
+			resolveId,
+			load,
+			transform,
+			buildStart,
+			buildEnd,
+			writeBundle,
+			vite: { sharedDuringBuild: true }
+		});
+	} catch (error) {
+		logger.error(error instanceof Error ? error.message : String(error));
+		throw error;
+	}
 }
 
 //#endregion

package/dist/lib/unplugin/plugin.d.cts

@@ -1,4 +1,4 @@
-import { UnpluginFactory } from "../../types/unplugin.cjs";
+import { UnpluginOptions } from "../../types/unplugin.cjs";
 import { PluginContext } from "../../types/context.cjs";
 import { CreateUnpluginModuleResolutionFunctionsOptions } from "./module-resolution.cjs";
 
@@ -13,15 +13,6 @@ interface CreateUnpluginResolverOptions extends CreateUnpluginModuleResolutionFu
    * @defaultValue "powerlines"
    */
   name?: string;
-}
-/**
- * Creates a Powerlines unplugin instance.
- *
- * @param context - The plugin context.
- * @returns The unplugin instance.
- */
-declare function createUnpluginResolver<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginResolverOptions): UnpluginFactory<TContext>;
-interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {
   /**
    * 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.
    *
@@ -35,7 +26,15 @@ interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {
  * @param context - The plugin context.
  * @returns The unplugin instance.
  */
-declare function createUnplugin<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginOptions): UnpluginFactory<TContext>;
+declare function createUnpluginResolver<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginResolverOptions): () => UnpluginOptions<TContext>;
+interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {}
+/**
+ * Creates a Powerlines unplugin instance.
+ *
+ * @param context - The plugin context.
+ * @returns The unplugin instance.
+ */
+declare function createUnplugin<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginOptions): () => UnpluginOptions<TContext>;
 declare type __ΩCreateUnpluginResolverOptions = any[];
 declare type __ΩCreateUnpluginOptions = any[];
 //#endregion

package/dist/lib/unplugin/plugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../../src/lib/unplugin/plugin.ts"],"mappings":";;;;;UAuCiB,6BAAA,SAAsC,8CAAA;;AAAvD;;;;;AAkBA;;EATE,IAAA;AAAA;;;;;;;iBASc,sBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAEjC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,6BAAA,GACR,eAAA,CAAgB,QAAA;AAAA,UA+BF,qBAAA,SAA8B,6BAAA;EAnC5B;;;;;EAyCjB,kBAAA;AAAA;;;;AANF;;;iBAegB,cAAA,kBAAgC,aAAA,GAAgB,aAAA,CAAA,CAC9D,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,qBAAA,GACR,eAAA,CAAgB,QAAA;AAAA"}
+{"version":3,"file":"plugin.d.cts","names":[],"sources":["../../../src/lib/unplugin/plugin.ts"],"mappings":";;;;;UAoCiB,6BAAA,SAAsC,8CAAA;;AAAvD;;;;;;;EASE,IAAA;EAOkB;AASpB;;;;EATE,kBAAA;AAAA;;;;;;;iBASc,sBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAEjC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,6BAAA,SACF,eAAA,CAAgB,QAAA;AAAA,UA8BR,qBAAA,SAA8B,6BAAA;;;;;;;iBAQ/B,cAAA,kBAAgC,aAAA,GAAgB,aAAA,CAAA,CAC9D,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,qBAAA,SACF,eAAA,CAAgB,QAAA;AAAA"}

package/dist/lib/unplugin/plugin.d.mts

@@ -1,4 +1,4 @@
-import { UnpluginFactory } from "../../types/unplugin.mjs";
+import { UnpluginOptions } from "../../types/unplugin.mjs";
 import { PluginContext } from "../../types/context.mjs";
 import { CreateUnpluginModuleResolutionFunctionsOptions } from "./module-resolution.mjs";
 
@@ -13,15 +13,6 @@ interface CreateUnpluginResolverOptions extends CreateUnpluginModuleResolutionFu
    * @defaultValue "powerlines"
    */
   name?: string;
-}
-/**
- * Creates a Powerlines unplugin instance.
- *
- * @param context - The plugin context.
- * @returns The unplugin instance.
- */
-declare function createUnpluginResolver<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginResolverOptions): UnpluginFactory<TContext>;
-interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {
   /**
    * 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.
    *
@@ -35,7 +26,15 @@ interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {
  * @param context - The plugin context.
  * @returns The unplugin instance.
  */
-declare function createUnplugin<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginOptions): UnpluginFactory<TContext>;
+declare function createUnpluginResolver<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginResolverOptions): () => UnpluginOptions<TContext>;
+interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {}
+/**
+ * Creates a Powerlines unplugin instance.
+ *
+ * @param context - The plugin context.
+ * @returns The unplugin instance.
+ */
+declare function createUnplugin<TContext extends PluginContext = PluginContext>(context: TContext, options?: CreateUnpluginOptions): () => UnpluginOptions<TContext>;
 declare type __ΩCreateUnpluginResolverOptions = any[];
 declare type __ΩCreateUnpluginOptions = any[];
 //#endregion

package/dist/lib/unplugin/plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../../src/lib/unplugin/plugin.ts"],"mappings":";;;;;UAuCiB,6BAAA,SAAsC,8CAAA;;AAAvD;;;;;AAkBA;;EATE,IAAA;AAAA;;;;;;;iBASc,sBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAEjC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,6BAAA,GACR,eAAA,CAAgB,QAAA;AAAA,UA+BF,qBAAA,SAA8B,6BAAA;EAnC5B;;;;;EAyCjB,kBAAA;AAAA;;;;AANF;;;iBAegB,cAAA,kBAAgC,aAAA,GAAgB,aAAA,CAAA,CAC9D,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,qBAAA,GACR,eAAA,CAAgB,QAAA;AAAA"}
+{"version":3,"file":"plugin.d.mts","names":[],"sources":["../../../src/lib/unplugin/plugin.ts"],"mappings":";;;;;UAoCiB,6BAAA,SAAsC,8CAAA;;AAAvD;;;;;;;EASE,IAAA;EAOkB;AASpB;;;;EATE,kBAAA;AAAA;;;;;;;iBASc,sBAAA,kBACG,aAAA,GAAgB,aAAA,CAAA,CAEjC,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,6BAAA,SACF,eAAA,CAAgB,QAAA;AAAA,UA8BR,qBAAA,SAA8B,6BAAA;;;;;;;iBAQ/B,cAAA,kBAAgC,aAAA,GAAgB,aAAA,CAAA,CAC9D,OAAA,EAAS,QAAA,EACT,OAAA,GAAS,qBAAA,SACF,eAAA,CAAgB,QAAA;AAAA"}

package/dist/lib/unplugin/plugin.mjs

@@ -1,9 +1,8 @@
-import { extendLog } from "../logger.mjs";
+import { removeVirtualPrefix } from "../../plugin-utils/virtual.mjs";
+import "../../plugin-utils/index.mjs";
 import { combineContexts } from "./helpers.mjs";
-import { VIRTUAL_MODULE_PREFIX_REGEX } from "../../constants/virtual-modules.mjs";
 import { createUnpluginModuleResolutionFunctions } from "./module-resolution.mjs";
 import { getString } from "../utilities/source-file.mjs";
-import { LogLevelLabel } from "@storm-software/config-tools/types";
 import { kebabCase } from "@stryke/string-format/kebab-case";
 import { titleCase } from "@stryke/string-format/title-case";
 import { setParseImpl } from "unplugin";
@@ -16,25 +15,22 @@ import { setParseImpl } from "unplugin";
 * @returns The unplugin instance.
 */
 function createUnpluginResolver(context, options = {}) {
-	const ctx = context;
-	setParseImpl(ctx.parse);
+	setParseImpl(context.parse);
 	const name = options.name || "powerlines";
-	return () => {
-		const log = extendLog(ctx.log, name);
-		log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);
-		try {
-			const { resolveId, load } = createUnpluginModuleResolutionFunctions(context, options);
-			return {
-				name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${kebabCase(name)}`,
-				api: ctx.$$internal.api,
-				resolveId,
-				load
-			};
-		} catch (error) {
-			log(LogLevelLabel.FATAL, error?.message);
-			throw error;
-		}
-	};
+	const logger = context.extendLogger(!options.silenceHookLogging && name !== "powerlines" ? { source: name } : {});
+	logger.debug(`Initializing ${titleCase(name)} plugin`);
+	try {
+		const { resolveId, load } = createUnpluginModuleResolutionFunctions(context, options);
+		return () => ({
+			name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${kebabCase(name)}`,
+			context,
+			resolveId,
+			load
+		});
+	} catch (error) {
+		logger.error(error instanceof Error ? error.message : String(error));
+		throw error;
+	}
 }
 /**
 * Creates a Powerlines unplugin instance.
@@ -43,50 +39,47 @@ function createUnpluginResolver(context, options = {}) {
 * @returns The unplugin instance.
 */
 function createUnplugin(context, options = {}) {
-	const ctx = context;
-	setParseImpl(ctx.parse);
+	setParseImpl(context.parse.bind(context));
 	const name = options.name || "powerlines";
-	return () => {
-		const log = options.name ? extendLog(ctx.log, name) : ctx.log;
-		log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);
-		try {
-			const { resolveId, load } = createUnpluginModuleResolutionFunctions(context, options);
-			async function buildStart() {
-				if (!options.silenceHookLogging) log(LogLevelLabel.DEBUG, "Powerlines build plugin starting...");
-				await ctx.$$internal.callHook("buildStart", { sequential: true });
-			}
-			async function transform(code, id) {
-				let transformed = code;
-				for (const hook of ctx.$$internal.environment.selectHooks("transform")) {
-					const result = await hook.handler.apply(combineContexts(ctx, this), [getString(transformed), id.replace(VIRTUAL_MODULE_PREFIX_REGEX, "")]);
-					if (result) transformed = result;
-				}
-				return transformed;
-			}
-			async function buildEnd() {
-				if (!options.silenceHookLogging) log(LogLevelLabel.DEBUG, "Powerlines build plugin finishing...");
-				return ctx.$$internal.callHook("buildEnd", { sequential: true });
-			}
-			async function writeBundle() {
-				if (!options.silenceHookLogging) log(LogLevelLabel.DEBUG, "Finalizing Powerlines project output...");
-				return ctx.$$internal.callHook("writeBundle", { sequential: true });
+	const logger = context.extendLogger(!options.silenceHookLogging && name !== "powerlines" ? { source: name } : {});
+	logger.debug(`Initializing ${titleCase(name)} plugin`);
+	try {
+		const { resolveId, load } = createUnpluginModuleResolutionFunctions(context, options);
+		async function buildStart() {
+			if (!options.silenceHookLogging) logger.debug("Powerlines build plugin starting...");
+			await context.callHook("buildStart", { sequential: true });
+		}
+		async function transform(code, id) {
+			let transformed = code;
+			for (const hook of context.environment.selectHooks("transform")) {
+				const result = await hook.handler.apply(combineContexts(context, this), [getString(transformed), removeVirtualPrefix(id)]);
+				if (result) transformed = result;
 			}
-			return {
-				name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${kebabCase(name)}`,
-				api: ctx.$$internal.api,
-				resolveId,
-				load,
-				transform,
-				buildStart,
-				buildEnd,
-				writeBundle,
-				vite: { sharedDuringBuild: true }
-			};
-		} catch (error) {
-			log(LogLevelLabel.FATAL, error?.message);
-			throw error;
+			return transformed;
+		}
+		async function buildEnd() {
+			if (!options.silenceHookLogging) logger.debug("Powerlines build plugin finishing...");
+			return context.callHook("buildEnd", { sequential: true });
+		}
+		async function writeBundle() {
+			if (!options.silenceHookLogging) logger.debug("Finalizing Powerlines project output...");
+			return context.callHook("writeBundle", { sequential: true });
 		}
-	};
+		return () => ({
+			name: name.toLowerCase() === "powerlines" ? "powerlines" : `powerlines:${kebabCase(name)}`,
+			context,
+			resolveId,
+			load,
+			transform,
+			buildStart,
+			buildEnd,
+			writeBundle,
+			vite: { sharedDuringBuild: true }
+		});
+	} catch (error) {
+		logger.error(error instanceof Error ? error.message : String(error));
+		throw error;
+	}
 }
 
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/lib/unplugin/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { Unstable_PluginContext } from \"@powerlines/core/types/_internal\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport type {\n  TransformResult,\n  UnpluginBuildContext,\n  UnpluginContext\n} from \"unplugin\";\nimport { setParseImpl } from \"unplugin\";\nimport { VIRTUAL_MODULE_PREFIX_REGEX } from \"../../constants/virtual-modules\";\nimport { PluginContext } from \"../../types/context\";\nimport { UnpluginFactory } from \"../../types/unplugin\";\nimport { extendLog } from \"../logger\";\nimport { getString } from \"../utilities/source-file\";\nimport { combineContexts } from \"./helpers\";\nimport {\n  createUnpluginModuleResolutionFunctions,\n  CreateUnpluginModuleResolutionFunctionsOptions\n} from \"./module-resolution\";\n\nexport interface CreateUnpluginResolverOptions extends CreateUnpluginModuleResolutionFunctionsOptions {\n  /**\n   * A name to use for the unplugin instance. This is used for logging and to generate the plugin name. It does not affect the functionality of the plugin.\n   *\n   * @remarks\n   * If not provided, the plugin will be named \"powerlines\". If provided, the plugin will be named `${name} - Powerlines` (e.g., \"MyPlugin - Powerlines\").\n   *\n   * @defaultValue \"powerlines\"\n   */\n  name?: string;\n}\n\n/**\n * Creates a Powerlines unplugin instance.\n *\n * @param context - The plugin context.\n * @returns The unplugin instance.\n */\nexport function createUnpluginResolver<\n  TContext extends PluginContext = PluginContext\n>(\n  context: TContext,\n  options: CreateUnpluginResolverOptions = {}\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as Unstable_PluginContext;\n  setParseImpl(ctx.parse);\n\n  const name = options.name || \"powerlines\";\n\n  return () => {\n    const log = extendLog(ctx.log, name);\n    log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context, options);\n\n      return {\n        name:\n          name.toLowerCase() === \"powerlines\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId,\n        load\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\n}\n\nexport interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {\n  /**\n   * Whether to silence logging for the plugin hooks. This can be useful for plugins that run frequently or have hooks that are called often, to reduce noise in the logs. When set to `true`, the plugin will not log any messages for its hooks. When set to `false` (the default), the plugin will log messages for its hooks as normal.\n   *\n   * @defaultValue false\n   */\n  silenceHookLogging?: boolean;\n}\n\n/**\n * Creates a Powerlines unplugin instance.\n *\n * @param context - The plugin context.\n * @returns The unplugin instance.\n */\nexport function createUnplugin<TContext extends PluginContext = PluginContext>(\n  context: TContext,\n  options: CreateUnpluginOptions = {}\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as Unstable_PluginContext;\n  setParseImpl(ctx.parse);\n\n  const name = options.name || \"powerlines\";\n\n  return () => {\n    const log = options.name ? extendLog(ctx.log, name) : ctx.log;\n    log(LogLevelLabel.DEBUG, `Initializing ${titleCase(name)} plugin`);\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context, options);\n\n      async function buildStart(this: UnpluginBuildContext) {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Powerlines build plugin starting...\");\n        }\n\n        await ctx.$$internal.callHook(\"buildStart\", {\n          sequential: true\n        });\n      }\n\n      async function transform(\n        this: UnpluginBuildContext & UnpluginContext,\n        code: string,\n        id: string\n      ): Promise<TransformResult | null | undefined> {\n        let transformed: TransformResult | string = code;\n\n        for (const hook of ctx.$$internal.environment.selectHooks(\n          \"transform\"\n        )) {\n          const result: TransformResult | string | undefined =\n            await hook.handler.apply(combineContexts(ctx, this), [\n              getString(transformed),\n              id.replace(VIRTUAL_MODULE_PREFIX_REGEX, \"\")\n            ]);\n          if (result) {\n            transformed = result;\n          }\n        }\n\n        return transformed;\n      }\n\n      async function buildEnd(this: UnpluginBuildContext): Promise<void> {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Powerlines build plugin finishing...\");\n        }\n\n        return ctx.$$internal.callHook(\"buildEnd\", {\n          sequential: true\n        });\n      }\n\n      async function writeBundle(): Promise<void> {\n        if (!options.silenceHookLogging) {\n          log(LogLevelLabel.DEBUG, \"Finalizing Powerlines project output...\");\n        }\n\n        return ctx.$$internal.callHook(\"writeBundle\", {\n          sequential: true\n        });\n      }\n\n      return {\n        name:\n          name.toLowerCase() === \"powerlines\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId,\n        load,\n        transform,\n        buildStart,\n        buildEnd,\n        writeBundle,\n        vite: {\n          sharedDuringBuild: true\n        }\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAyDA,SAAgB,uBAGd,SACA,UAAyC,EAAE,EAChB;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,MAAM,UAAU,IAAI,KAAK,KAAK;AACpC,MAAI,cAAc,OAAO,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAElE,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;AAErE,UAAO;IACL,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB;IACA;IACD;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM;;;;;;;;;;AAoBZ,SAAgB,eACd,SACA,UAAiC,EAAE,EACR;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;CAEvB,MAAM,OAAO,QAAQ,QAAQ;AAE7B,cAAa;EACX,MAAM,MAAM,QAAQ,OAAO,UAAU,IAAI,KAAK,KAAK,GAAG,IAAI;AAC1D,MAAI,cAAc,OAAO,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAElE,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;GAErE,eAAe,aAAuC;AACpD,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,sCAAsC;AAGjE,UAAM,IAAI,WAAW,SAAS,cAAc,EAC1C,YAAY,MACb,CAAC;;GAGJ,eAAe,UAEb,MACA,IAC6C;IAC7C,IAAI,cAAwC;AAE5C,SAAK,MAAM,QAAQ,IAAI,WAAW,YAAY,YAC5C,YACD,EAAE;KACD,MAAM,SACJ,MAAM,KAAK,QAAQ,MAAM,gBAAgB,KAAK,KAAK,EAAE,CACnD,UAAU,YAAY,EACtB,GAAG,QAAQ,6BAA6B,GAAG,CAC5C,CAAC;AACJ,SAAI,OACF,eAAc;;AAIlB,WAAO;;GAGT,eAAe,WAAoD;AACjE,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,uCAAuC;AAGlE,WAAO,IAAI,WAAW,SAAS,YAAY,EACzC,YAAY,MACb,CAAC;;GAGJ,eAAe,cAA6B;AAC1C,QAAI,CAAC,QAAQ,mBACX,KAAI,cAAc,OAAO,0CAA0C;AAGrE,WAAO,IAAI,WAAW,SAAS,eAAe,EAC5C,YAAY,MACb,CAAC;;AAGJ,UAAO;IACL,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB;IACA;IACA;IACA;IACA;IACA;IACA,MAAM,EACJ,mBAAmB,MACpB;IACF;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM"}
+{"version":3,"file":"plugin.mjs","names":[],"sources":["../../../src/lib/unplugin/plugin.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { 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 { removeVirtualPrefix } from \"../../plugin-utils\";\nimport type { PluginContext } from \"../../types/context\";\nimport type { UnpluginOptions } 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   * 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 createUnpluginResolver<\n  TContext extends PluginContext = PluginContext\n>(\n  context: TContext,\n  options: CreateUnpluginResolverOptions = {}\n): () => UnpluginOptions<TContext> {\n  setParseImpl(context.parse);\n\n  const name = options.name || \"powerlines\";\n\n  const logger = context.extendLogger(\n    !options.silenceHookLogging && name !== \"powerlines\" ? { source: name } : {}\n  );\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      context,\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\nexport interface CreateUnpluginOptions extends CreateUnpluginResolverOptions {}\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): () => UnpluginOptions<TContext> {\n  setParseImpl(context.parse.bind(context));\n\n  const name = options.name || \"powerlines\";\n\n  const logger = context.extendLogger(\n    !options.silenceHookLogging && name !== \"powerlines\" ? { source: name } : {}\n  );\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 context.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 context.environment.selectHooks(\"transform\")) {\n        const result: TransformResult | string | undefined =\n          await hook.handler.apply(combineContexts(context, this), [\n            getString(transformed),\n            removeVirtualPrefix(id)\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 context.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 context.callHook(\"writeBundle\", {\n        sequential: true\n      });\n    }\n\n    return () => ({\n      name:\n        name.toLowerCase() === \"powerlines\"\n          ? \"powerlines\"\n          : `powerlines:${kebabCase(name)}`,\n      context,\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"],"mappings":";;;;;;;;;;;;;;;;AA6DA,SAAgB,uBAGd,SACA,UAAyC,EAAE,EACV;AACjC,cAAa,QAAQ,MAAM;CAE3B,MAAM,OAAO,QAAQ,QAAQ;CAE7B,MAAM,SAAS,QAAQ,aACrB,CAAC,QAAQ,sBAAsB,SAAS,eAAe,EAAE,QAAQ,MAAM,GAAG,EAAE,CAC7E;AACD,QAAO,MAAM,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAEtD,KAAI;EACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;AAErE,gBAAc;GACZ,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;GACnC;GACA;GACA;GACD;UACM,OAAO;AACd,SAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAEpE,QAAM;;;;;;;;;AAYV,SAAgB,eACd,SACA,UAAiC,EAAE,EACF;AACjC,cAAa,QAAQ,MAAM,KAAK,QAAQ,CAAC;CAEzC,MAAM,OAAO,QAAQ,QAAQ;CAE7B,MAAM,SAAS,QAAQ,aACrB,CAAC,QAAQ,sBAAsB,SAAS,eAAe,EAAE,QAAQ,MAAM,GAAG,EAAE,CAC7E;AACD,QAAO,MAAM,gBAAgB,UAAU,KAAK,CAAC,SAAS;AAEtD,KAAI;EACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,SAAS,QAAQ;EAErE,eAAe,aAAuC;AACpD,OAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,sCAAsC;AAGrD,SAAM,QAAQ,SAAS,cAAc,EACnC,YAAY,MACb,CAAC;;EAGJ,eAAe,UAEb,MACA,IAC6C;GAC7C,IAAI,cAAwC;AAE5C,QAAK,MAAM,QAAQ,QAAQ,YAAY,YAAY,YAAY,EAAE;IAC/D,MAAM,SACJ,MAAM,KAAK,QAAQ,MAAM,gBAAgB,SAAS,KAAK,EAAE,CACvD,UAAU,YAAY,EACtB,oBAAoB,GAAG,CACxB,CAA+B;AAClC,QAAI,OACF,eAAc;;AAIlB,UAAO;;EAGT,eAAe,WAAoD;AACjE,OAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,uCAAuC;AAGtD,UAAO,QAAQ,SAAS,YAAY,EAClC,YAAY,MACb,CAAC;;EAGJ,eAAe,cAA6B;AAC1C,OAAI,CAAC,QAAQ,mBACX,QAAO,MAAM,0CAA0C;AAGzD,UAAO,QAAQ,SAAS,eAAe,EACrC,YAAY,MACb,CAAC;;AAGJ,gBAAc;GACZ,MACE,KAAK,aAAa,KAAK,eACnB,eACA,cAAc,UAAU,KAAK;GACnC;GACA;GACA;GACA;GACA;GACA;GACA;GACA,MAAM,EACJ,mBAAmB,MACpB;GACF;UACM,OAAO;AACd,SAAO,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAEpE,QAAM"}

package/dist/lib/utilities/file-header.cjs

@@ -20,7 +20,7 @@ function getFileHeaderWarningText(overwrite = true, framework = "powerlines") {
 * @returns A string containing the file header warning message.
 */
 function getFileHeaderWarning(context) {
-	return getFileHeaderWarningText(context.config.output?.overwrite, context.config.framework);
+	return getFileHeaderWarningText(context.config.output?.overwrite, context.config.framework?.name);
 }
 /**
 * Generates a file header comment for a generated source file, including a warning about automatic overwriting.
@@ -31,7 +31,7 @@ function getFileHeaderWarning(context) {
 */
 function getFileHeader(context, comment = "//") {
 	return `
-${comment} Generated by ${(0, _stryke_string_format_title_case.titleCase)(context.config.framework) || "Powerlines"}
+${comment} Generated by ${(0, _stryke_string_format_title_case.titleCase)(context.config.framework?.name) || "Powerlines"}
 ${comment} ${getFileHeaderWarning(context)}
 `;
 }

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

@@ -18,7 +18,7 @@ function getFileHeaderWarningText(overwrite = true, framework = "powerlines") {
 * @returns A string containing the file header warning message.
 */
 function getFileHeaderWarning(context) {
-	return getFileHeaderWarningText(context.config.output?.overwrite, context.config.framework);
+	return getFileHeaderWarningText(context.config.output?.overwrite, context.config.framework?.name);
 }
 /**
 * Generates a file header comment for a generated source file, including a warning about automatic overwriting.
@@ -29,7 +29,7 @@ function getFileHeaderWarning(context) {
 */
 function getFileHeader(context, comment = "//") {
 	return `
-${comment} Generated by ${titleCase(context.config.framework) || "Powerlines"}
+${comment} Generated by ${titleCase(context.config.framework?.name) || "Powerlines"}
 ${comment} ${getFileHeaderWarning(context)}
 `;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"file-header.mjs","names":[],"sources":["../../../src/lib/utilities/file-header.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 { titleCase } from \"@stryke/string-format/title-case\";\nimport { Context } from \"../../types/context\";\n\nexport interface FileHeaderOptions {\n  directive?: string | null;\n  prettierIgnore?: boolean;\n}\n\n/**\n * Generates a file header comment with a warning about automatic overwriting.\n *\n * @param overwrite - Whether the file will be automatically overwritten. If `false`, the warning will indicate that the file will not be overwritten. If `true` or omitted, the warning will indicate that the file will be overwritten.\n * @param framework - The name of the framework to include in the warning message. Defaults to \"powerlines\".\n * @returns A string containing the file header warning message.\n */\nexport function getFileHeaderWarningText(\n  overwrite = true,\n  framework = \"powerlines\"\n): string {\n  return overwrite !== false\n    ? `Do not edit this file manually - it will be overwritten automatically. Automatic overwrites can be disabled by using the \\`output.overwrite\\` option.`\n    : `This file was generated on ${new Date().toLocaleString()} - it will not be overwritten by ${titleCase(framework)} while the \\`output.overwrite\\` option is set to \\`true\\`.`;\n}\n\n/**\n * Generates a file header warning message based on the provided context.\n *\n * @param context - The Powerlines context.\n * @returns A string containing the file header warning message.\n */\nexport function getFileHeaderWarning(context: Context): string {\n  return getFileHeaderWarningText(\n    context.config.output?.overwrite,\n    context.config.framework\n  );\n}\n\n/**\n * Generates a file header comment for a generated source file, including a warning about automatic overwriting.\n *\n * @param context - The Powerlines context.\n * @param comment - The comment syntax to use for the header (e.g., `//` for JavaScript/TypeScript, `#` for Python). Defaults to `//`.\n * @returns A string containing the file header comment.\n */\nexport function getFileHeader(context: Context, comment = \"//\"): string {\n  return `\n${comment} Generated by ${titleCase(context.config.framework) || \"Powerlines\"}\n${comment} ${getFileHeaderWarning(context)}\n`;\n}\n\n/**\n * Generates a file header comment for a generated TypeScript source file, including a warning about automatic overwriting.\n *\n * @param context - The Powerlines context.\n * @param options - Additional options for generating the file header, such as a directive to include and whether to add a Prettier ignore comment.\n * @returns A string containing the file header comment for a TypeScript file.\n */\nexport function getTypescriptFileHeader(\n  context: Context,\n  options: FileHeaderOptions = {}\n): string {\n  const { directive = null, prettierIgnore = false } = options;\n\n  return `/* eslint-disable */\n// biome-ignore lint: disable\n${prettierIgnore ? `// prettier-ignore` : \"\"}${directive ? `\\n\\n${directive}\\n` : \"\\n\"}\n${getFileHeader(context)}\n\n`;\n}\n"],"mappings":";;;;;;;;;;AAiCA,SAAgB,yBACd,YAAY,MACZ,YAAY,cACJ;AACR,QAAO,cAAc,QACjB,0JACA,+CAA8B,IAAI,MAAM,EAAC,gBAAgB,CAAC,mCAAmC,UAAU,UAAU,CAAC;;;;;;;;AASxH,SAAgB,qBAAqB,SAA0B;AAC7D,QAAO,yBACL,QAAQ,OAAO,QAAQ,WACvB,QAAQ,OAAO,UAChB;;;;;;;;;AAUH,SAAgB,cAAc,SAAkB,UAAU,MAAc;AACtE,QAAO;EACP,QAAQ,gBAAgB,UAAU,QAAQ,OAAO,UAAU,IAAI,aAAa;EAC5E,QAAQ,GAAG,qBAAqB,QAAQ,CAAC;;;;;;;;;;AAW3C,SAAgB,wBACd,SACA,UAA6B,EAAE,EACvB;CACR,MAAM,EAAE,YAAY,MAAM,iBAAiB,UAAU;AAErD,QAAO;;EAEP,iBAAiB,uBAAuB,KAAK,YAAY,OAAO,UAAU,MAAM,KAAK;EACrF,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"file-header.mjs","names":[],"sources":["../../../src/lib/utilities/file-header.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 { titleCase } from \"@stryke/string-format/title-case\";\nimport { Context } from \"../../types/context\";\n\nexport interface FileHeaderOptions {\n  directive?: string | null;\n  prettierIgnore?: boolean;\n}\n\n/**\n * Generates a file header comment with a warning about automatic overwriting.\n *\n * @param overwrite - Whether the file will be automatically overwritten. If `false`, the warning will indicate that the file will not be overwritten. If `true` or omitted, the warning will indicate that the file will be overwritten.\n * @param framework - The name of the framework to include in the warning message. Defaults to \"powerlines\".\n * @returns A string containing the file header warning message.\n */\nexport function getFileHeaderWarningText(\n  overwrite = true,\n  framework = \"powerlines\"\n): string {\n  return overwrite !== false\n    ? `Do not edit this file manually - it will be overwritten automatically. Automatic overwrites can be disabled by using the \\`output.overwrite\\` option.`\n    : `This file was generated on ${new Date().toLocaleString()} - it will not be overwritten by ${titleCase(framework)} while the \\`output.overwrite\\` option is set to \\`true\\`.`;\n}\n\n/**\n * Generates a file header warning message based on the provided context.\n *\n * @param context - The Powerlines context.\n * @returns A string containing the file header warning message.\n */\nexport function getFileHeaderWarning(context: Context): string {\n  return getFileHeaderWarningText(\n    context.config.output?.overwrite,\n    context.config.framework?.name\n  );\n}\n\n/**\n * Generates a file header comment for a generated source file, including a warning about automatic overwriting.\n *\n * @param context - The Powerlines context.\n * @param comment - The comment syntax to use for the header (e.g., `//` for JavaScript/TypeScript, `#` for Python). Defaults to `//`.\n * @returns A string containing the file header comment.\n */\nexport function getFileHeader(context: Context, comment = \"//\"): string {\n  return `\n${comment} Generated by ${titleCase(context.config.framework?.name) || \"Powerlines\"}\n${comment} ${getFileHeaderWarning(context)}\n`;\n}\n\n/**\n * Generates a file header comment for a generated TypeScript source file, including a warning about automatic overwriting.\n *\n * @param context - The Powerlines context.\n * @param options - Additional options for generating the file header, such as a directive to include and whether to add a Prettier ignore comment.\n * @returns A string containing the file header comment for a TypeScript file.\n */\nexport function getTypescriptFileHeader(\n  context: Context,\n  options: FileHeaderOptions = {}\n): string {\n  const { directive = null, prettierIgnore = false } = options;\n\n  return `/* eslint-disable */\n// biome-ignore lint: disable\n${prettierIgnore ? `// prettier-ignore` : \"\"}${directive ? `\\n\\n${directive}\\n` : \"\\n\"}\n${getFileHeader(context)}\n\n`;\n}\n"],"mappings":";;;;;;;;;;AAiCA,SAAgB,yBACd,YAAY,MACZ,YAAY,cACJ;AACR,QAAO,cAAc,QACjB,0JACA,+CAA8B,IAAI,MAAM,EAAC,gBAAgB,CAAC,mCAAmC,UAAU,UAAU,CAAC;;;;;;;;AASxH,SAAgB,qBAAqB,SAA0B;AAC7D,QAAO,yBACL,QAAQ,OAAO,QAAQ,WACvB,QAAQ,OAAO,WAAW,KAC3B;;;;;;;;;AAUH,SAAgB,cAAc,SAAkB,UAAU,MAAc;AACtE,QAAO;EACP,QAAQ,gBAAgB,UAAU,QAAQ,OAAO,WAAW,KAAK,IAAI,aAAa;EAClF,QAAQ,GAAG,qBAAqB,QAAQ,CAAC;;;;;;;;;;AAW3C,SAAgB,wBACd,SACA,UAA6B,EAAE,EACvB;CACR,MAAM,EAAE,YAAY,MAAM,iBAAiB,UAAU;AAErD,QAAO;;EAEP,iBAAiB,uBAAuB,KAAK,YAAY,OAAO,UAAU,MAAM,KAAK;EACrF,cAAc,QAAQ,CAAC"}

package/dist/lib/utilities/format.cjs

@@ -1,9 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
 let _stryke_path_append = require("@stryke/path/append");
+let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
 let defu = require("defu");
 let _stryke_fs_list_files = require("@stryke/fs/list-files");
-let _stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
 let _stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
 let prettier = require("prettier");
 let prettier_plugin_organize_imports = require("prettier-plugin-organize-imports");

package/dist/lib/utilities/format.mjs

@@ -1,7 +1,7 @@
 import { appendPath } from "@stryke/path/append";
+import { findFileExtension } from "@stryke/path/file-path-fns";
 import { defu as defu$1 } from "defu";
 import { listFiles } from "@stryke/fs/list-files";
-import { findFileExtension } from "@stryke/path/file-path-fns";
 import { isParentPath } from "@stryke/path/is-parent-path";
 import { format as format$1, resolveConfig } from "prettier";
 import importsPlugin from "prettier-plugin-organize-imports";

package/dist/lib/utilities/index.cjs

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

package/dist/lib/utilities/index.mjs

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"write-file.mjs","names":["writeFileBase"],"sources":["../../../src/lib/utilities/write-file.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { writeFile as writeFileBase } from \"@stryke/fs/write-file\";\nimport { format, resolveConfig } from \"prettier\";\nimport type { LogFn } from \"../../types/config\";\n\n/**\n * Writes and formats a file to the file system\n *\n * @param log - The logging function to use for logging errors\n * @param filepath - The file path to write the file\n * @param content - The content to write to the file\n * @param skipFormat - Should the plugin skip formatting the `content` string with Prettier\n */\nexport async function writeFile(\n  log: LogFn,\n  filepath: string,\n  content: string,\n  skipFormat = false\n) {\n  try {\n    if (skipFormat) {\n      await writeFileBase(filepath, content);\n    } else {\n      const config = await resolveConfig(filepath);\n      const formatted = await format(content, {\n        ...(config ?? {}),\n        filepath\n      });\n\n      await writeFileBase(filepath, formatted || \"\");\n    }\n  } catch (error) {\n    log(\n      LogLevelLabel.ERROR,\n      `Failed to write file ${filepath} to disk \\n${(error as Error)?.message ? (error as Error).message : \"\"}`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AA+BA,eAAsB,UACpB,KACA,UACA,SACA,aAAa,OACb;AACA,KAAI;AACF,MAAI,WACF,OAAMA,YAAc,UAAU,QAAQ;MAQtC,OAAMA,YAAc,UAAU,MALN,OAAO,SAAS;GACtC,GAAI,MAFe,cAAc,SAAS,IAE5B,EAAE;GAChB;GACD,CAAC,IAEyC,GAAG;UAEzC,OAAO;AACd,MACE,cAAc,OACd,wBAAwB,SAAS,aAAc,OAAiB,UAAW,MAAgB,UAAU,KACtG"}
+{"version":3,"file":"write-file.mjs","names":["writeFileBase"],"sources":["../../../src/lib/utilities/write-file.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { writeFile as writeFileBase } from \"@stryke/fs/write-file\";\nimport { format, resolveConfig } from \"prettier\";\nimport type { LogFn } from \"../../types/logging\";\n\n/**\n * Writes and formats a file to the file system\n *\n * @param log - The logging function to use for logging errors\n * @param filepath - The file path to write the file\n * @param content - The content to write to the file\n * @param skipFormat - Should the plugin skip formatting the `content` string with Prettier\n */\nexport async function writeFile(\n  log: LogFn,\n  filepath: string,\n  content: string,\n  skipFormat = false\n) {\n  try {\n    if (skipFormat) {\n      await writeFileBase(filepath, content);\n    } else {\n      const config = await resolveConfig(filepath);\n      const formatted = await format(content, {\n        ...(config ?? {}),\n        filepath\n      });\n\n      await writeFileBase(filepath, formatted || \"\");\n    }\n  } catch (error) {\n    log(\n      \"error\",\n      `Failed to write file ${filepath} to disk \\n${(error as Error)?.message ? (error as Error).message : \"\"}`\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;AA8BA,eAAsB,UACpB,KACA,UACA,SACA,aAAa,OACb;AACA,KAAI;AACF,MAAI,WACF,OAAMA,YAAc,UAAU,QAAQ;MAQtC,OAAMA,YAAc,UAAU,MALN,OAAO,SAAS;GACtC,GAAI,MAFe,cAAc,SAAS,IAE5B,EAAE;GAChB;GACD,CAAC,IAEyC,GAAG;UAEzC,OAAO;AACd,MACE,SACA,wBAAwB,SAAS,aAAc,OAAiB,UAAW,MAAgB,UAAU,KACtG"}