@powerlines/plugin-tsdown 0.1.243 → 0.1.244

package/dist/core/src/lib/logger.mjs

@@ -0,0 +1,40 @@
+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 "@storm-software/config-tools/logger";
+import "@storm-software/config-tools/utilities/colors";
+import "@stryke/helpers/noop";
+import chalk from "chalk";
+
+//#region ../core/src/lib/logger.ts
+const BADGE_COLORS = [
+	"#00A0DD",
+	"#6FCE4E",
+	"#FBBF24",
+	"#F43F5E",
+	"#3B82F6",
+	"#A855F7",
+	"#469592",
+	"#288EDF",
+	"#D8B4FE",
+	"#10B981",
+	"#EF4444",
+	"#F0EC56",
+	"#F472B6",
+	"#22D3EE",
+	"#EAB308",
+	"#84CC16",
+	"#F87171",
+	"#0EA5E9",
+	"#D946EF",
+	"#FACC15",
+	"#34D399",
+	"#8B5CF6"
+];
+const extendLog = (logFn, name) => {
+	return (type, ...args) => logFn(type, ` ${chalk.inverse.hex(BADGE_COLORS[name.split("").map((char) => char.charCodeAt(0)).reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length] || BADGE_COLORS[0])(` ${titleCase(name)} `)}  ${args.join(" ")} `);
+};
+
+//#endregion
+export { extendLog };
+//# sourceMappingURL=logger.mjs.map

package/dist/core/src/lib/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","names":[],"sources":["../../../../../core/src/lib/logger.ts"],"sourcesContent":["/* -------------------------------------------------------------------\n\n                   ⚡ Storm Software - Powerlines\n\n This code was released as part of the Powerlines project. Powerlines\n is maintained by Storm Software under the Apache-2.0 license, and is\n free for commercial and private use. For more information, please visit\n our licensing page at https://stormsoftware.com/licenses/projects/powerlines.\n\n Website:                  https://stormsoftware.com\n Repository:               https://github.com/storm-software/powerlines\n Documentation:            https://docs.stormsoftware.com/projects/powerlines\n Contact:                  https://stormsoftware.com/contact\n\n SPDX-License-Identifier:  Apache-2.0\n\n ------------------------------------------------------------------- */\n\nimport { getLogFn, getLogLevel } from \"@storm-software/config-tools/logger\";\nimport { LogLevelLabel } from \"@storm-software/config-tools/types\";\nimport { getColor } from \"@storm-software/config-tools/utilities/colors\";\nimport { noop } from \"@stryke/helpers/noop\";\nimport { kebabCase } from \"@stryke/string-format/kebab-case\";\nimport { titleCase } from \"@stryke/string-format/title-case\";\nimport chalk from \"chalk\";\nimport type { LogFn, WorkspaceConfig } from \"../types\";\n\nexport interface CreateLogOptions {\n  name?: string;\n  logLevel?: LogLevelLabel | null;\n  customLogger?: LogFn;\n  colors?: WorkspaceConfig[\"colors\"];\n}\n\n/**\n * Create a logging function with a specific name and options.\n *\n * @param name - The name of the logging function.\n * @param options - The options to configure the logging function.\n * @returns A logging function.\n */\nexport const createLog = (\n  name: string | null,\n  options: CreateLogOptions = {}\n): LogFn => {\n  const logLevel =\n    options.logLevel === null\n      ? LogLevelLabel.SILENT\n      : options.logLevel || LogLevelLabel.INFO;\n  if (logLevel === LogLevelLabel.SILENT) {\n    return noop;\n  }\n\n  if (options.customLogger) {\n    return options.customLogger;\n  }\n\n  return (type: LogLevelLabel, ...args: string[]) =>\n    getLogFn(getLogLevel(type), {\n      ...options,\n      logLevel\n    })(\n      `${chalk.bold.hex(\n        getColor(\"brand\", options as Parameters<typeof getColor>[1])\n      )(\n        `${name ? kebabCase(name) : \"\"}${options.name ? `${name ? chalk.gray(\" > \") : \"\"}${kebabCase(options.name)}` : \"\"}${chalk.gray(\" > \")}`\n      )}${args.join(\" \")} `.trim()\n    );\n};\n\nconst BADGE_COLORS = [\n  \"#00A0DD\",\n  \"#6FCE4E\",\n  \"#FBBF24\",\n  \"#F43F5E\",\n  \"#3B82F6\",\n  \"#A855F7\",\n  \"#469592\",\n  \"#288EDF\",\n  \"#D8B4FE\",\n  \"#10B981\",\n  \"#EF4444\",\n  \"#F0EC56\",\n  \"#F472B6\",\n  \"#22D3EE\",\n  \"#EAB308\",\n  \"#84CC16\",\n  \"#F87171\",\n  \"#0EA5E9\",\n  \"#D946EF\",\n  \"#FACC15\",\n  \"#34D399\",\n  \"#8B5CF6\"\n] as const;\n\nexport const extendLog = (logFn: LogFn, name: string): LogFn => {\n  return (type: LogLevelLabel, ...args: string[]) =>\n    logFn(\n      type,\n      ` ${chalk.inverse.hex(\n        BADGE_COLORS[\n          name\n            .split(\"\")\n            .map(char => char.charCodeAt(0))\n            .reduce((ret, charCode) => ret + charCode, 0) % BADGE_COLORS.length\n        ] || BADGE_COLORS[0]\n      )(` ${titleCase(name)} `)}  ${args.join(\" \")} `\n    );\n};\n"],"mappings":";;;;;;;;;AAsEA,MAAM,eAAe;CACnB;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,aAAa,OAAc,SAAwB;AAC9D,SAAQ,MAAqB,GAAG,SAC9B,MACE,MACA,IAAI,MAAM,QAAQ,IAChB,aACE,KACG,MAAM,GAAG,CACT,KAAI,SAAQ,KAAK,WAAW,EAAE,CAAC,CAC/B,QAAQ,KAAK,aAAa,MAAM,UAAU,EAAE,GAAG,aAAa,WAC5D,aAAa,GACnB,CAAC,IAAI,UAAU,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,GAC9C"}

package/dist/core/src/lib/unplugin/helpers.mjs

@@ -0,0 +1,19 @@
+import "../../types/unplugin.mjs";
+import { defu } from "defu";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+
+//#region ../core/src/lib/unplugin/helpers.ts
+/**
+* Merges a base plugin context with an unplugin context, combining their properties.
+*
+* @param contextA - The base plugin context to merge into.
+* @param contextB - The unplugin context to merge from.
+* @returns The merged context.
+*/
+function combineContexts(contextA, contextB) {
+	return defu(contextA, contextB);
+}
+
+//#endregion
+export { combineContexts };
+//# sourceMappingURL=helpers.mjs.map

package/dist/core/src/lib/unplugin/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../../../../core/src/lib/unplugin/helpers.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 { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { defu } from \"defu\";\nimport { UnpluginBuildContext } from \"unplugin\";\nimport { UnresolvedContext } from \"../../types/context\";\nimport {\n  UNPLUGIN_BUILDER_VARIANTS,\n  UnpluginBuilderVariant\n} from \"../../types/unplugin\";\n\n/**\n * Merges a base plugin context with an unplugin context, combining their properties.\n *\n * @param contextA - The base plugin context to merge into.\n * @param contextB - The unplugin context to merge from.\n * @returns The merged context.\n */\nexport function combineContexts<\n  TContextA extends UnresolvedContext | UnpluginBuildContext,\n  TContextB extends UnresolvedContext | UnpluginBuildContext\n>(contextA: TContextA, contextB: TContextB): TContextA & TContextB {\n  return defu(contextA, contextB) as TContextA & TContextB;\n}\n\n/**\n * Checks if a value is a valid UnpluginBuilderVariant.\n *\n * @param str - The value to check.\n * @returns True if the value is a UnpluginBuilderVariant, false otherwise.\n */\nexport function isUnpluginBuilderVariant(\n  str: unknown\n): str is UnpluginBuilderVariant {\n  return (\n    isSetString(str) &&\n    UNPLUGIN_BUILDER_VARIANTS.includes(str as UnpluginBuilderVariant)\n  );\n}\n"],"mappings":";;;;;;;;;;;;AAkCA,SAAgB,gBAGd,UAAqB,UAA4C;AACjE,QAAO,KAAK,UAAU,SAAS"}

package/dist/core/src/lib/unplugin/index.mjs

@@ -0,0 +1,5 @@
+import { combineContexts } from "./helpers.mjs";
+import { createUnpluginModuleResolutionFunctions } from "./module-resolution.mjs";
+import { createUnplugin } from "./plugin.mjs";
+
+export {  };

package/dist/core/src/lib/unplugin/module-resolution.mjs

@@ -0,0 +1,66 @@
+//#region ../core/src/lib/unplugin/module-resolution.ts
+/**
+* Creates the module resolution hook functions for a Powerlines unplugin plugin instance.
+*
+* @remarks
+* This includes the `resolveId` and `load` hooks.
+*
+* @see https://rollupjs.org/plugin-development/#resolveid
+* @see https://rollupjs.org/plugin-development/#load
+*
+* @param context - The plugin context.
+* @returns The module resolution hooks (`resolveId` and `load`).
+*/
+function createUnpluginModuleResolutionFunctions(context) {
+	const ctx = context;
+	async function resolveId(id, importer, opts = { isEntry: false }) {
+		let result = await ctx.$$internal.callHook("resolveId", {
+			sequential: true,
+			result: "first",
+			order: "pre"
+		}, id, importer, opts);
+		if (result) return result;
+		result = await ctx.$$internal.callHook("resolveId", {
+			sequential: true,
+			result: "first",
+			order: "normal"
+		}, id, importer, opts);
+		if (result) return result;
+		result = await ctx.resolve(id, importer, opts);
+		if (result) return result;
+		return ctx.$$internal.callHook("resolveId", {
+			sequential: true,
+			result: "first",
+			order: "post"
+		}, id, importer, opts);
+	}
+	async function load(id) {
+		let result = await ctx.$$internal.callHook("load", {
+			sequential: true,
+			result: "first",
+			order: "pre"
+		}, id);
+		if (result) return result;
+		result = await ctx.$$internal.callHook("load", {
+			sequential: true,
+			result: "first",
+			order: "normal"
+		}, id);
+		if (result) return result;
+		result = await ctx.load(id);
+		if (result) return result;
+		return ctx.$$internal.callHook("load", {
+			sequential: true,
+			result: "first",
+			order: "post"
+		}, id);
+	}
+	return {
+		resolveId,
+		load
+	};
+}
+
+//#endregion
+export { createUnpluginModuleResolutionFunctions };
+//# sourceMappingURL=module-resolution.mjs.map

package/dist/core/src/lib/unplugin/module-resolution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-resolution.mjs","names":[],"sources":["../../../../../../core/src/lib/unplugin/module-resolution.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 { LoadResult } from \"rollup\";\nimport type {\n  ExternalIdResult,\n  HookFnMap,\n  UnpluginBuildContext,\n  UnpluginContext\n} from \"unplugin\";\nimport { UNSAFE_PluginContext } from \"../../types/_internal\";\nimport { PluginContext } from \"../../types/context\";\n\n/**\n * Creates the module resolution hook functions for a Powerlines unplugin plugin instance.\n *\n * @remarks\n * This includes the `resolveId` and `load` hooks.\n *\n * @see https://rollupjs.org/plugin-development/#resolveid\n * @see https://rollupjs.org/plugin-development/#load\n *\n * @param context - The plugin context.\n * @returns The module resolution hooks (`resolveId` and `load`).\n */\nexport function createUnpluginModuleResolutionFunctions<\n  TContext extends PluginContext = PluginContext\n>(context: TContext): Pick<HookFnMap, \"resolveId\" | \"load\"> {\n  const ctx = context as unknown as UNSAFE_PluginContext;\n\n  async function resolveId(\n    this: UnpluginBuildContext & UnpluginContext,\n    id: string,\n    importer?: string,\n    opts: {\n      isEntry: boolean;\n    } = { isEntry: false }\n  ): Promise<string | ExternalIdResult | null | undefined> {\n    let result = await ctx.$$internal.callHook(\n      \"resolveId\",\n      {\n        sequential: true,\n        result: \"first\",\n        order: \"pre\"\n      },\n      id,\n      importer,\n      opts\n    );\n    if (result) {\n      return result;\n    }\n\n    result = await ctx.$$internal.callHook(\n      \"resolveId\",\n      {\n        sequential: true,\n        result: \"first\",\n        order: \"normal\"\n      },\n      id,\n      importer,\n      opts\n    );\n    if (result) {\n      return result;\n    }\n\n    result = await ctx.resolve(id, importer, opts);\n    if (result) {\n      return result;\n    }\n\n    return ctx.$$internal.callHook(\n      \"resolveId\",\n      {\n        sequential: true,\n        result: \"first\",\n        order: \"post\"\n      },\n      id,\n      importer,\n      opts\n    );\n  }\n\n  async function load(\n    this: UnpluginBuildContext & UnpluginContext,\n    id: string\n  ): Promise<LoadResult | null | undefined> {\n    let result = await ctx.$$internal.callHook(\n      \"load\",\n      {\n        sequential: true,\n        result: \"first\",\n        order: \"pre\"\n      },\n      id\n    );\n    if (result) {\n      return result;\n    }\n\n    result = await ctx.$$internal.callHook(\n      \"load\",\n      {\n        sequential: true,\n        result: \"first\",\n        order: \"normal\"\n      },\n      id\n    );\n    if (result) {\n      return result;\n    }\n\n    result = await ctx.load(id);\n    if (result) {\n      return result;\n    }\n\n    return ctx.$$internal.callHook(\n      \"load\",\n      {\n        sequential: true,\n        result: \"first\",\n        order: \"post\"\n      },\n      id\n    );\n  }\n\n  return {\n    resolveId,\n    load\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AAwCA,SAAgB,wCAEd,SAA0D;CAC1D,MAAM,MAAM;CAEZ,eAAe,UAEb,IACA,UACA,OAEI,EAAE,SAAS,OAAO,EACiC;EACvD,IAAI,SAAS,MAAM,IAAI,WAAW,SAChC,aACA;GACE,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,EACD,IACA,UACA,KACD;AACD,MAAI,OACF,QAAO;AAGT,WAAS,MAAM,IAAI,WAAW,SAC5B,aACA;GACE,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,EACD,IACA,UACA,KACD;AACD,MAAI,OACF,QAAO;AAGT,WAAS,MAAM,IAAI,QAAQ,IAAI,UAAU,KAAK;AAC9C,MAAI,OACF,QAAO;AAGT,SAAO,IAAI,WAAW,SACpB,aACA;GACE,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,EACD,IACA,UACA,KACD;;CAGH,eAAe,KAEb,IACwC;EACxC,IAAI,SAAS,MAAM,IAAI,WAAW,SAChC,QACA;GACE,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,EACD,GACD;AACD,MAAI,OACF,QAAO;AAGT,WAAS,MAAM,IAAI,WAAW,SAC5B,QACA;GACE,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,EACD,GACD;AACD,MAAI,OACF,QAAO;AAGT,WAAS,MAAM,IAAI,KAAK,GAAG;AAC3B,MAAI,OACF,QAAO;AAGT,SAAO,IAAI,WAAW,SACpB,QACA;GACE,YAAY;GACZ,QAAQ;GACR,OAAO;GACR,EACD,GACD;;AAGH,QAAO;EACL;EACA;EACD"}

package/dist/core/src/lib/unplugin/plugin.mjs

@@ -0,0 +1,71 @@
+import { combineContexts } from "./helpers.mjs";
+import { createUnpluginModuleResolutionFunctions } from "./module-resolution.mjs";
+import { extendLog } from "../logger.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";
+
+//#region ../core/src/lib/unplugin/plugin.ts
+/**
+* Creates a Powerlines unplugin instance.
+*
+* @param context - The plugin context.
+* @returns The unplugin instance.
+*/
+function createUnplugin(context, name = "unplugin") {
+	const ctx = context;
+	setParseImpl(ctx.parse);
+	return () => {
+		const log = extendLog(ctx.log, name);
+		log(LogLevelLabel.DEBUG, `Initializing ${name.toLowerCase() === "unplugin" ? "Unplugin" : `${titleCase(name)} - Unplugin`} plugin`);
+		try {
+			const { resolveId, load } = createUnpluginModuleResolutionFunctions(context);
+			async function buildStart() {
+				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]);
+					if (result) transformed = result;
+				}
+				return transformed;
+			}
+			async function buildEnd() {
+				log(LogLevelLabel.DEBUG, "Powerlines build plugin finishing...");
+				return ctx.$$internal.callHook("buildEnd", { sequential: true });
+			}
+			async function writeBundle() {
+				log(LogLevelLabel.DEBUG, "Finalizing Powerlines project output...");
+				return ctx.$$internal.callHook("writeBundle", { sequential: true });
+			}
+			return {
+				name: name.toLowerCase() === "unplugin" ? "powerlines" : `powerlines:${kebabCase(name)}`,
+				api: ctx.$$internal.api,
+				resolveId: {
+					filter: { id: { include: [/.*/] } },
+					handler: resolveId
+				},
+				load: {
+					filter: { id: { include: [/.*/] } },
+					handler: load
+				},
+				transform,
+				buildStart,
+				buildEnd,
+				writeBundle,
+				vite: { sharedDuringBuild: true }
+			};
+		} catch (error) {
+			log(LogLevelLabel.FATAL, error?.message);
+			throw error;
+		}
+	};
+}
+
+//#endregion
+export { createUnplugin };
+//# sourceMappingURL=plugin.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.mjs","names":["transformed: TransformResult | string","result: TransformResult | string | undefined"],"sources":["../../../../../../core/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 { 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 { UNSAFE_PluginContext } from \"../../types/_internal\";\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 { createUnpluginModuleResolutionFunctions } from \"./module-resolution\";\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>(context: TContext, name = \"unplugin\"): UnpluginFactory<TContext> {\n  const ctx = context as unknown as UNSAFE_PluginContext;\n  setParseImpl(ctx.parse);\n\n  return () => {\n    const log = extendLog(ctx.log, name);\n    log(\n      LogLevelLabel.DEBUG,\n      `Initializing ${\n        name.toLowerCase() === \"unplugin\"\n          ? \"Unplugin\"\n          : `${titleCase(name)} - Unplugin`\n      } plugin`\n    );\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context);\n\n      return {\n        name:\n          name.toLowerCase() === \"unplugin\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId: {\n          filter: {\n            id: {\n              include: [/.*/]\n            }\n          },\n          handler: resolveId\n        },\n        load: {\n          filter: {\n            id: {\n              include: [/.*/]\n            }\n          },\n          handler: load\n        }\n      };\n    } catch (error) {\n      log(LogLevelLabel.FATAL, (error as Error)?.message);\n\n      throw error;\n    }\n  };\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  name = \"unplugin\"\n): UnpluginFactory<TContext> {\n  const ctx = context as unknown as UNSAFE_PluginContext;\n  setParseImpl(ctx.parse);\n\n  return () => {\n    const log = extendLog(ctx.log, name);\n    log(\n      LogLevelLabel.DEBUG,\n      `Initializing ${\n        name.toLowerCase() === \"unplugin\"\n          ? \"Unplugin\"\n          : `${titleCase(name)} - Unplugin`\n      } plugin`\n    );\n\n    try {\n      const { resolveId, load } =\n        createUnpluginModuleResolutionFunctions<TContext>(context);\n\n      async function buildStart(this: UnpluginBuildContext) {\n        log(LogLevelLabel.DEBUG, \"Powerlines build plugin starting...\");\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\n            ]);\n          if (result) {\n            transformed = result;\n          }\n        }\n\n        return transformed;\n      }\n\n      async function buildEnd(this: UnpluginBuildContext): Promise<void> {\n        log(LogLevelLabel.DEBUG, \"Powerlines build plugin finishing...\");\n\n        return ctx.$$internal.callHook(\"buildEnd\", {\n          sequential: true\n        });\n      }\n\n      async function writeBundle(): Promise<void> {\n        log(LogLevelLabel.DEBUG, \"Finalizing Powerlines project output...\");\n\n        return ctx.$$internal.callHook(\"writeBundle\", {\n          sequential: true\n        });\n      }\n\n      return {\n        name:\n          name.toLowerCase() === \"unplugin\"\n            ? \"powerlines\"\n            : `powerlines:${kebabCase(name)}`,\n        api: ctx.$$internal.api,\n        resolveId: {\n          filter: {\n            id: {\n              include: [/.*/]\n            }\n          },\n          handler: resolveId\n        },\n        load: {\n          filter: {\n            id: {\n              include: [/.*/]\n            }\n          },\n          handler: load\n        },\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":";;;;;;;;;;;;;;;;AAmGA,SAAgB,eACd,SACA,OAAO,YACoB;CAC3B,MAAM,MAAM;AACZ,cAAa,IAAI,MAAM;AAEvB,cAAa;EACX,MAAM,MAAM,UAAU,IAAI,KAAK,KAAK;AACpC,MACE,cAAc,OACd,gBACE,KAAK,aAAa,KAAK,aACnB,aACA,GAAG,UAAU,KAAK,CAAC,aACxB,SACF;AAED,MAAI;GACF,MAAM,EAAE,WAAW,SACjB,wCAAkD,QAAQ;GAE5D,eAAe,aAAuC;AACpD,QAAI,cAAc,OAAO,sCAAsC;AAE/D,UAAM,IAAI,WAAW,SAAS,cAAc,EAC1C,YAAY,MACb,CAAC;;GAGJ,eAAe,UAEb,MACA,IAC6C;IAC7C,IAAIA,cAAwC;AAE5C,SAAK,MAAM,QAAQ,IAAI,WAAW,YAAY,YAC5C,YACD,EAAE;KACD,MAAMC,SACJ,MAAM,KAAK,QAAQ,MAAM,gBAAgB,KAAK,KAAK,EAAE,CACnD,UAAU,YAAY,EACtB,GACD,CAAC;AACJ,SAAI,OACF,eAAc;;AAIlB,WAAO;;GAGT,eAAe,WAAoD;AACjE,QAAI,cAAc,OAAO,uCAAuC;AAEhE,WAAO,IAAI,WAAW,SAAS,YAAY,EACzC,YAAY,MACb,CAAC;;GAGJ,eAAe,cAA6B;AAC1C,QAAI,cAAc,OAAO,0CAA0C;AAEnE,WAAO,IAAI,WAAW,SAAS,eAAe,EAC5C,YAAY,MACb,CAAC;;AAGJ,UAAO;IACL,MACE,KAAK,aAAa,KAAK,aACnB,eACA,cAAc,UAAU,KAAK;IACnC,KAAK,IAAI,WAAW;IACpB,WAAW;KACT,QAAQ,EACN,IAAI,EACF,SAAS,CAAC,KAAK,EAChB,EACF;KACD,SAAS;KACV;IACD,MAAM;KACJ,QAAQ,EACN,IAAI,EACF,SAAS,CAAC,KAAK,EAChB,EACF;KACD,SAAS;KACV;IACD;IACA;IACA;IACA;IACA,MAAM,EACJ,mBAAmB,MACpB;IACF;WACM,OAAO;AACd,OAAI,cAAc,OAAQ,OAAiB,QAAQ;AAEnD,SAAM"}

package/dist/core/src/lib/utilities/format.mjs

@@ -0,0 +1,29 @@
+import "@stryke/fs/list-files";
+import { appendPath } from "@stryke/path/append";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { format, resolveConfig } from "prettier";
+
+//#region ../core/src/lib/utilities/format.ts
+/**
+* Formats code using Prettier based on the file path.
+*
+* @param context - The Powerlines context.
+* @param path - The file path to use for resolving Prettier configuration.
+* @param data - The code string to format.
+* @param force - Whether to force formatting even for output/build paths.
+* @returns A promise that resolves to the formatted code string.
+*/
+async function format$1(context, path, data, force = false) {
+	if (!force && (isParentPath(path, appendPath(context.config.output.outputPath, context.workspaceConfig.workspaceRoot)) || isParentPath(path, appendPath(context.config.output.buildPath, context.workspaceConfig.workspaceRoot)))) return data;
+	let code = data;
+	const resolvedConfig = await resolveConfig(path);
+	if (resolvedConfig) code = await format(data, {
+		absolutePath: path,
+		...resolvedConfig
+	});
+	return code;
+}
+
+//#endregion
+export { format$1 as format };
+//# sourceMappingURL=format.mjs.map

package/dist/core/src/lib/utilities/format.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.mjs","names":["format","prettier"],"sources":["../../../../../../core/src/lib/utilities/format.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 { listFiles } from \"@stryke/fs/list-files\";\nimport { appendPath } from \"@stryke/path/append\";\nimport { isParentPath } from \"@stryke/path/is-parent-path\";\nimport { format as prettier, resolveConfig } from \"prettier\";\nimport { Context } from \"../../types/context\";\n\n/**\n * Formats code using Prettier based on the file path.\n *\n * @param context - The Powerlines context.\n * @param path - The file path to use for resolving Prettier configuration.\n * @param data - The code string to format.\n * @param force - Whether to force formatting even for output/build paths.\n * @returns A promise that resolves to the formatted code string.\n */\nexport async function format(\n  context: Context,\n  path: string,\n  data: string,\n  force = false\n): Promise<string> {\n  if (\n    !force &&\n    (isParentPath(\n      path,\n      appendPath(\n        context.config.output.outputPath,\n        context.workspaceConfig.workspaceRoot\n      )\n    ) ||\n      isParentPath(\n        path,\n        appendPath(\n          context.config.output.buildPath,\n          context.workspaceConfig.workspaceRoot\n        )\n      ))\n  ) {\n    return data;\n  }\n\n  let code = data;\n  const resolvedConfig = await resolveConfig(path);\n  if (resolvedConfig) {\n    code = await prettier(data, {\n      absolutePath: path,\n      ...resolvedConfig\n    });\n  }\n\n  return code;\n}\n\n/**\n * Formats all files in a folder using Prettier based on their file paths.\n *\n * @param context - The Powerlines context.\n * @param path - The folder path containing files to format.\n * @returns A promise that resolves when all files have been formatted.\n */\nexport async function formatFolder(context: Context, path: string) {\n  if (\n    !isParentPath(\n      path,\n      appendPath(\n        context.config.output.outputPath,\n        context.workspaceConfig.workspaceRoot\n      )\n    ) &&\n    !isParentPath(\n      path,\n      appendPath(\n        context.config.output.buildPath,\n        context.workspaceConfig.workspaceRoot\n      )\n    )\n  ) {\n    await Promise.allSettled(\n      (await listFiles(path)).map(async file => {\n        if (\n          !isParentPath(\n            file,\n            appendPath(\n              context.config.output.outputPath,\n              context.workspaceConfig.workspaceRoot\n            )\n          ) &&\n          !isParentPath(\n            file,\n            appendPath(\n              context.config.output.buildPath,\n              context.workspaceConfig.workspaceRoot\n            )\n          )\n        ) {\n          const data = await context.fs.read(file);\n          if (data) {\n            const formatted = await format(context, file, data);\n\n            return context.fs.write(file, formatted);\n          }\n        }\n      })\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAiCA,eAAsBA,SACpB,SACA,MACA,MACA,QAAQ,OACS;AACjB,KACE,CAAC,UACA,aACC,MACA,WACE,QAAQ,OAAO,OAAO,YACtB,QAAQ,gBAAgB,cACzB,CACF,IACC,aACE,MACA,WACE,QAAQ,OAAO,OAAO,WACtB,QAAQ,gBAAgB,cACzB,CACF,EAEH,QAAO;CAGT,IAAI,OAAO;CACX,MAAM,iBAAiB,MAAM,cAAc,KAAK;AAChD,KAAI,eACF,QAAO,MAAMC,OAAS,MAAM;EAC1B,cAAc;EACd,GAAG;EACJ,CAAC;AAGJ,QAAO"}

package/dist/core/src/lib/utilities/source-file.mjs

@@ -0,0 +1,21 @@
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isString } from "@stryke/type-checks/is-string";
+import "@stryke/fs/read-file";
+
+//#region ../core/src/lib/utilities/source-file.ts
+/**
+* Get the string from the source.
+*
+* @param code - The source string or magic string.
+* @returns The source string.
+*/
+function getString(code) {
+	if (!code) return "";
+	if (isString(code)) return code;
+	if (isSetObject(code) && "code" in code) return code.code;
+	return code.toString();
+}
+
+//#endregion
+export { getString };
+//# sourceMappingURL=source-file.mjs.map

package/dist/core/src/lib/utilities/source-file.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-file.mjs","names":[],"sources":["../../../../../../core/src/lib/utilities/source-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 { readFileIfExistingSync } from \"@stryke/fs/read-file\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport MagicString from \"magic-string\";\nimport { TransformResult } from \"unplugin\";\nimport { SourceFile } from \"../../types/context\";\n\n/**\n * Get the string from the source.\n *\n * @param code - The source string or magic string.\n * @returns The source string.\n */\nexport function getString(\n  code: string | MagicString | TransformResult\n): string {\n  if (!code) {\n    return \"\";\n  }\n\n  if (isString(code)) {\n    return code;\n  }\n\n  if (isSetObject(code) && \"code\" in code) {\n    return code.code;\n  }\n\n  return code.toString();\n}\n\n/**\n * Get the magic string.\n *\n * @param code - The source string or magic string.\n * @returns The magic string.\n */\nexport function getMagicString(code: string | MagicString): MagicString {\n  if (isString(code)) {\n    return new MagicString(code);\n  }\n\n  return code;\n}\n\n/**\n * Get the source file.\n *\n * @param code - The source code.\n * @param id - The name of the file.\n * @returns The source file.\n */\nexport function getSourceFile(\n  code: string | MagicString,\n  id: string\n): SourceFile {\n  const content = code ?? readFileIfExistingSync(id);\n\n  return {\n    id,\n    code: getMagicString(content),\n    env: []\n  };\n}\n"],"mappings":";;;;;;;;;;;AA+BA,SAAgB,UACd,MACQ;AACR,KAAI,CAAC,KACH,QAAO;AAGT,KAAI,SAAS,KAAK,CAChB,QAAO;AAGT,KAAI,YAAY,KAAK,IAAI,UAAU,KACjC,QAAO,KAAK;AAGd,QAAO,KAAK,UAAU"}

package/dist/core/src/plugin-utils/build-helpers.mjs

@@ -0,0 +1,35 @@
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { toArray } from "@stryke/convert/to-array";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { isRegExp } from "@stryke/type-checks/is-regexp";
+
+//#region ../core/src/plugin-utils/build-helpers.ts
+/**
+* Get the {@link ResolveConfig.external | external} and {@link ResolveConfig.noExternal | noExternal} dependencies for the build configuration.
+*
+* @param context - The build context.
+* @returns The dependency configuration.
+*/
+function getDependencyConfig(context) {
+	const noExternal = getUnique(toArray(context.config.resolve.noExternal).concat(context.builtins));
+	const external = getUnique(toArray(context.config.resolve.external).reduce((ret, ext) => {
+		if (isRegExp(ext)) {
+			if (noExternal.some((noExt) => isRegExp(noExt) && noExt.source === ext.source)) return ret;
+			const noExts = noExternal.filter((noExt) => isSetString(noExt) && ext.test(noExt));
+			if (noExts.length > 0) {
+				ret.push(new RegExp(noExts.reduce((regex, noExt) => `(?!${isRegExp(noExt) ? noExt.source : `^${noExt}$`})${regex}`, `${ext.source.replace(/^\^@\?/, "^@").replace(/^@\?/, "@").replace(/\$$/, "").replace(/\.\*$/, "")}.*$`)));
+				return ret;
+			}
+		}
+		ret.push(ext);
+		return ret;
+	}, []));
+	return {
+		external: external.length === 0 ? void 0 : external,
+		noExternal: noExternal.length === 0 ? void 0 : noExternal
+	};
+}
+
+//#endregion
+export { getDependencyConfig };
+//# sourceMappingURL=build-helpers.mjs.map

package/dist/core/src/plugin-utils/build-helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-helpers.mjs","names":[],"sources":["../../../../../core/src/plugin-utils/build-helpers.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 { toArray } from \"@stryke/convert/to-array\";\nimport { getUnique } from \"@stryke/helpers/get-unique\";\nimport { isRegExp } from \"@stryke/type-checks/is-regexp\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { ResolveConfig } from \"../types/config\";\nimport { Context } from \"../types/context\";\n\nexport interface GetDependencyConfigResult {\n  external: ResolveConfig[\"external\"];\n  noExternal: ResolveConfig[\"noExternal\"];\n}\n\n/**\n * Get the {@link ResolveConfig.external | external} and {@link ResolveConfig.noExternal | noExternal} dependencies for the build configuration.\n *\n * @param context - The build context.\n * @returns The dependency configuration.\n */\nexport function getDependencyConfig(\n  context: Context\n): GetDependencyConfigResult {\n  const noExternal = getUnique(\n    toArray(context.config.resolve.noExternal).concat(context.builtins)\n  );\n\n  const external = getUnique(\n    toArray(context.config.resolve.external).reduce(\n      (ret, ext) => {\n        if (isRegExp(ext)) {\n          if (\n            noExternal.some(\n              noExt => isRegExp(noExt) && noExt.source === ext.source\n            )\n          ) {\n            return ret;\n          }\n\n          const noExts = noExternal.filter(\n            noExt => isSetString(noExt) && ext.test(noExt)\n          );\n          if (noExts.length > 0) {\n            ret.push(\n              new RegExp(\n                noExts.reduce(\n                  (regex: string, noExt: string | RegExp) =>\n                    `(?!${\n                      isRegExp(noExt) ? noExt.source : `^${noExt}$`\n                    })${regex}`,\n                  `${ext.source\n                    .replace(/^\\^@\\?/, \"^@\")\n                    .replace(/^@\\?/, \"@\")\n                    .replace(/\\$$/, \"\")\n                    .replace(/\\.\\*$/, \"\")}.*$`\n                )\n              )\n            );\n            return ret;\n          }\n        }\n\n        ret.push(ext);\n        return ret;\n      },\n      [] as (string | RegExp)[]\n    )\n  );\n\n  return {\n    external: external.length === 0 ? undefined : external,\n    noExternal: noExternal.length === 0 ? undefined : noExternal\n  };\n}\n"],"mappings":";;;;;;;;;;;;AAoCA,SAAgB,oBACd,SAC2B;CAC3B,MAAM,aAAa,UACjB,QAAQ,QAAQ,OAAO,QAAQ,WAAW,CAAC,OAAO,QAAQ,SAAS,CACpE;CAED,MAAM,WAAW,UACf,QAAQ,QAAQ,OAAO,QAAQ,SAAS,CAAC,QACtC,KAAK,QAAQ;AACZ,MAAI,SAAS,IAAI,EAAE;AACjB,OACE,WAAW,MACT,UAAS,SAAS,MAAM,IAAI,MAAM,WAAW,IAAI,OAClD,CAED,QAAO;GAGT,MAAM,SAAS,WAAW,QACxB,UAAS,YAAY,MAAM,IAAI,IAAI,KAAK,MAAM,CAC/C;AACD,OAAI,OAAO,SAAS,GAAG;AACrB,QAAI,KACF,IAAI,OACF,OAAO,QACJ,OAAe,UACd,MACE,SAAS,MAAM,GAAG,MAAM,SAAS,IAAI,MAAM,GAC5C,GAAG,SACN,GAAG,IAAI,OACJ,QAAQ,UAAU,KAAK,CACvB,QAAQ,QAAQ,IAAI,CACpB,QAAQ,OAAO,GAAG,CAClB,QAAQ,SAAS,GAAG,CAAC,KACzB,CACF,CACF;AACD,WAAO;;;AAIX,MAAI,KAAK,IAAI;AACb,SAAO;IAET,EAAE,CACH,CACF;AAED,QAAO;EACL,UAAU,SAAS,WAAW,IAAI,SAAY;EAC9C,YAAY,WAAW,WAAW,IAAI,SAAY;EACnD"}

package/dist/core/src/plugin-utils/context-helpers.mjs

@@ -0,0 +1,4 @@
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+
+export {  };

package/dist/core/src/plugin-utils/extend.mjs

@@ -0,0 +1,5 @@
+import "./merge.mjs";
+import { toArray } from "@stryke/convert/to-array";
+import { isFunction } from "@stryke/type-checks/is-function";
+
+export {  };

package/dist/core/src/plugin-utils/get-config-path.mjs

@@ -0,0 +1,3 @@
+import { joinPaths } from "@stryke/path/join";
+
+export {  };

package/dist/core/src/plugin-utils/helpers.mjs

@@ -0,0 +1,48 @@
+import "../types/unplugin.mjs";
+import "../types/plugin.mjs";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isFunction } from "@stryke/type-checks/is-function";
+import "@stryke/type-checks/is-undefined";
+
+//#region ../core/src/plugin-utils/helpers.ts
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookObject(value) {
+	return isSetObject(value) && "handler" in value && isFunction(value.handler);
+}
+/**
+* Type guard to check if an value is a {@link PluginHook} function
+*
+* @param value - The value to check
+* @returns True if the value is a {@link PluginHook} function, false otherwise
+*/
+function isPluginHookFunction(value) {
+	return isFunction(value) || isPluginHookObject(value);
+}
+/**
+* Type guard to check if an object is a {@link PluginHook}
+*
+* @param value - The object to check
+* @returns True if the object is a {@link PluginHook}, false otherwise
+*/
+function isPluginHook(value) {
+	return isPluginHookFunction(value) || isPluginHookObject(value);
+}
+/**
+* Extract the hook handler function from a plugin hook
+*
+* @param pluginHook - The plugin hook to extract the handler function from
+* @returns The hook handler function
+*/
+function getHookHandler(pluginHook) {
+	return isFunction(pluginHook) ? pluginHook : pluginHook.handler;
+}
+
+//#endregion
+export { getHookHandler, isPluginHook, isPluginHookFunction, isPluginHookObject };
+//# sourceMappingURL=helpers.mjs.map

package/dist/core/src/plugin-utils/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../../../../core/src/plugin-utils/helpers.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 { isFunction } from \"@stryke/type-checks/is-function\";\nimport { isSetObject } from \"@stryke/type-checks/is-set-object\";\nimport { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isUndefined } from \"@stryke/type-checks/is-undefined\";\nimport { AnyFunction } from \"@stryke/types/base\";\nimport {\n  PluginConfig,\n  PluginConfigObject,\n  PluginConfigTuple,\n  ResolvedConfig\n} from \"../types/config\";\nimport { PluginContext, WithUnpluginBuildContext } from \"../types/context\";\nimport {\n  HookFields,\n  PluginHooksListItem,\n  UnpluginHooksListItem\n} from \"../types/hooks\";\nimport {\n  PLUGIN_HOOKS_FIELDS,\n  Plugin,\n  PluginHook,\n  PluginHookFields,\n  PluginHookObject,\n  PluginHooks\n} from \"../types/plugin\";\nimport {\n  BUILDER_VARIANTS,\n  UNPLUGIN_BUILDER_VARIANTS,\n  UnpluginBuilderVariant,\n  UnpluginOptions\n} from \"../types/unplugin\";\n\n/**\n * Type guard to check if an object is a {@link Plugin}\n *\n * @param value - The object to check\n * @returns True if the object is a {@link Plugin}, false otherwise\n */\nexport function isPlugin<\n  TContext extends PluginContext = PluginContext<ResolvedConfig>\n>(value: unknown): value is Plugin<TContext> {\n  return (\n    isSetObject(value) &&\n    \"name\" in value &&\n    isSetString(value.name) &&\n    (isUndefined((value as Plugin<TContext>).api) ||\n      (\"api\" in value && isSetObject(value.api))) &&\n    (isUndefined((value as Plugin<TContext>).applyToEnvironment) ||\n      (\"applyToEnvironment\" in value &&\n        isFunction(value.applyToEnvironment))) &&\n    (isUndefined((value as Plugin<TContext>).dedupe) ||\n      (\"dedupe\" in value && isFunction(value.dedupe))) &&\n    PLUGIN_HOOKS_FIELDS.every(\n      hook =>\n        isUndefined((value as Plugin<TContext>)[hook]) ||\n        (hook in value &&\n          (isPluginHookFunction((value as Plugin<TContext>)[hook]) ||\n            (hook === \"config\" &&\n              isSetObject((value as Plugin<TContext>)[hook]))))\n    ) &&\n    BUILDER_VARIANTS.every(\n      variant =>\n        isUndefined((value as Plugin<TContext>)[variant]) ||\n        (variant in value && isSetObject((value as Plugin<TContext>)[variant]))\n    )\n  );\n}\n\n/**\n * Type guard to check if an object is a {@link PluginConfigObject}\n *\n * @param value - The object to check\n * @returns True if the object is a {@link PluginConfigObject}, false otherwise\n */\nexport function isPluginConfigObject<\n  TContext extends PluginContext = PluginContext<ResolvedConfig>\n>(value: unknown): value is PluginConfigObject<TContext> {\n  return (\n    isSetObject(value) &&\n    \"plugin\" in value &&\n    (((isSetString(value.plugin) || isFunction(value.plugin)) &&\n      \"options\" in value &&\n      isSetObject(value.options)) ||\n      isPlugin(value.plugin))\n  );\n}\n\n/**\n * Type guard to check if an object is a {@link PluginConfigTuple}\n *\n * @param value - The object to check\n * @returns True if the object is a {@link PluginConfigTuple}, false otherwise\n */\nexport function isPluginConfigTuple<\n  TContext extends PluginContext = PluginContext<ResolvedConfig>\n>(value: unknown): value is PluginConfigTuple<TContext> {\n  return (\n    Array.isArray(value) &&\n    (value.length === 1 || value.length === 2) &&\n    (((isSetString(value[0]) || isFunction(value[0])) &&\n      value.length > 1 &&\n      isSetObject(value[1])) ||\n      isPlugin(value[0]))\n  );\n}\n\n/**\n * Type guard to check if an object is a {@link PluginConfig}\n *\n * @param value - The object to check\n * @returns True if the object is a {@link PluginConfig}, false otherwise\n */\nexport function isPluginConfig<\n  TContext extends PluginContext = PluginContext<ResolvedConfig>\n>(value: unknown): value is PluginConfig<TContext> {\n  return (\n    isSetString(value) ||\n    isFunction(value) ||\n    isPlugin<TContext>(value) ||\n    isPluginConfigObject(value) ||\n    isPluginConfigTuple(value) ||\n    (Array.isArray(value) && value.every(item => isPluginConfig(item)))\n  );\n}\n\n/**\n * Type guard to check if an value is a {@link PluginHook} function\n *\n * @param value - The value to check\n * @returns True if the value is a {@link PluginHook} function, false otherwise\n */\nexport function isPluginHookObject(\n  value: unknown\n): value is PluginHookObject<AnyFunction> {\n  return isSetObject(value) && \"handler\" in value && isFunction(value.handler);\n}\n\n/**\n * Type guard to check if an value is a {@link PluginHook} function\n *\n * @param value - The value to check\n * @returns True if the value is a {@link PluginHook} function, false otherwise\n */\nexport function isPluginHookFunction(value: unknown): value is AnyFunction {\n  return isFunction(value) || isPluginHookObject(value);\n}\n\n/**\n * Type guard to check if an object is a {@link PluginHook}\n *\n * @param value - The object to check\n * @returns True if the object is a {@link PluginHook}, false otherwise\n */\nexport function isPluginHook(value: unknown): value is PluginHook<AnyFunction> {\n  return isPluginHookFunction(value) || isPluginHookObject(value);\n}\n\nexport type GetHookHandlerReturnType<\n  TContext extends PluginContext = PluginContext,\n  TField extends HookFields<TContext> = HookFields<TContext>\n> = TField extends PluginHookFields\n  ? PluginHooksListItem<TContext, TField>[\"handler\"]\n  : TField extends UnpluginBuilderVariant\n    ? UnpluginHooksListItem<TContext, TField>[\"handler\"]\n    : never;\n\ntype HooksListItemForField<\n  TContext extends PluginContext = PluginContext,\n  TField extends HookFields<TContext> = HookFields<TContext>\n> =\n  TField extends PluginHookFields<TContext>\n    ? PluginHooksListItem<TContext, Extract<TField, PluginHookFields<TContext>>>\n    : TField extends UnpluginBuilderVariant\n      ? UnpluginHooksListItem<TContext, Extract<TField, UnpluginBuilderVariant>>\n      : never;\n\n/**\n * Extract the hook handler function from a plugin hook\n *\n * @param pluginHook - The plugin hook to extract the handler function from\n * @returns The hook handler function\n */\nexport function getHookHandler<\n  TContext extends PluginContext = PluginContext,\n  TField extends HookFields<TContext> = HookFields<TContext>\n>(\n  pluginHook: PluginHook<AnyFunction>\n): GetHookHandlerReturnType<TContext, TField> {\n  return (\n    isFunction(pluginHook) ? pluginHook : pluginHook.handler\n  ) as GetHookHandlerReturnType<TContext, TField>;\n}\n\n/**\n * Extract a plugin hook from a plugin\n *\n * @param context - The build context\n * @param plugin - The plugin to extract the hook from\n * @param hook - The name of the hook to extract\n * @returns The extracted hook, or undefined if the hook does not exist\n */\nexport function extractPluginHook<\n  TContext extends PluginContext = PluginContext,\n  TPlugin extends Plugin<TContext> = Plugin<TContext>\n>(context: TContext, plugin: TPlugin, hook: keyof PluginHooks<TContext>) {\n  const pluginHook = plugin[hook];\n  if (!isPluginHook(pluginHook)) {\n    return undefined;\n  }\n\n  return isFunction(pluginHook)\n    ? {\n        normal: pluginHook.bind(context)\n      }\n    : {\n        [pluginHook.order ? pluginHook.order : \"normal\"]:\n          pluginHook.handler.bind(context)\n      };\n}\n\n/**\n * Check if a hook is external.\n *\n * @param keys - The name of the hook to check.\n * @returns True if the hook is external, false otherwise.\n */\nexport function isUnpluginHookKey<\n  TUnpluginBuilderVariant extends UnpluginBuilderVariant =\n    UnpluginBuilderVariant\n>(\n  keys: string\n): keys is `${TUnpluginBuilderVariant}:${keyof UnpluginOptions[TUnpluginBuilderVariant] & string}` {\n  return UNPLUGIN_BUILDER_VARIANTS.some(variant =>\n    keys.startsWith(`${variant}:`)\n  );\n}\n\n/**\n * Check if a hook is internal.\n *\n * @param keys - The name of the hook to check.\n * @returns True if the hook is external, false otherwise.\n */\nexport function isPluginHookField<TContext extends PluginContext>(\n  keys: string\n): keys is PluginHookFields<TContext> {\n  return (\n    !isUnpluginHookKey(keys) &&\n    PLUGIN_HOOKS_FIELDS.includes(keys as PluginHookFields<TContext>)\n  );\n}\n\n/**\n * Check if a hook is external.\n *\n * @param field - The name of the hook to check.\n * @returns True if the hook is external, false otherwise.\n */\nexport function isUnpluginHookField<\n  TUnpluginBuilderVariant extends UnpluginBuilderVariant =\n    UnpluginBuilderVariant\n>(field: string): field is TUnpluginBuilderVariant {\n  return (\n    !isPluginHookField(field) &&\n    UNPLUGIN_BUILDER_VARIANTS.includes(field as UnpluginBuilderVariant)\n  );\n}\n\n/**\n * Check if a plugin should be deduplicated.\n *\n * @param plugin - The plugin to check\n * @param plugins - The list of plugins to check against\n * @returns True if the plugin should be deduplicated, false otherwise\n */\nexport function checkDedupe<\n  TResolvedConfig extends ResolvedConfig = ResolvedConfig,\n  TContext extends PluginContext<TResolvedConfig> =\n    PluginContext<TResolvedConfig>\n>(plugin: Plugin<TContext>, plugins: Plugin<TContext>[]) {\n  return (\n    plugin.dedupe === false ||\n    plugins.some(\n      p =>\n        p.dedupe !== false &&\n        ((isFunction(p.dedupe) && p.dedupe(plugin)) || p.name === plugin.name)\n    )\n  );\n}\n\n/**\n * Add a plugin hook to the hooks list.\n *\n * @param context - The plugin context\n * @param plugin - The plugin to add the hook from\n * @param pluginHook - The plugin hook to add\n * @param hooksList - The list of hooks to add to\n */\nexport function addPluginHook<\n  TContext extends PluginContext = PluginContext,\n  TField extends PluginHookFields<TContext> = PluginHookFields<TContext>,\n  TList extends PluginHooksListItem<TContext, TField> = PluginHooksListItem<\n    TContext,\n    TField\n  >\n>(\n  context: TContext,\n  plugin: Plugin<TContext>,\n  pluginHook: PluginHook<AnyFunction>,\n  hooksList: TList[]\n) {\n  if (\n    !checkDedupe(plugin, hooksList.map(hook => hook.plugin).filter(Boolean))\n  ) {\n    const handler = ((...args: unknown[]) =>\n      (\n        getHookHandler<WithUnpluginBuildContext<TContext>, TField>(\n          pluginHook\n        ) as unknown as (...args: unknown[]) => unknown\n      ).apply(context, args)) as HooksListItemForField<\n      TContext,\n      TField\n    >[\"handler\"];\n    if (!handler) {\n      return;\n    }\n\n    hooksList.push({\n      plugin,\n      handler\n    } as any);\n  }\n}\n\n/**\n * Check the provided {@link PluginConfig}, and return a stringified version of the invalid configuration. If an array is provided, check each item in the array.\n *\n * @param config - The plugin configuration to check\n * @returns Null if the configuration is valid, otherwise an array of stringified invalid configurations\n */\nexport function findInvalidPluginConfig<\n  TContext extends PluginContext = PluginContext<ResolvedConfig>\n>(config: PluginConfig<TContext>): string[] | null {\n  if (isPluginConfig<TContext>(config)) {\n    return null;\n  }\n\n  if (Array.isArray(config as PluginConfig<TContext>[])) {\n    const invalidItems: string[] = [];\n    (config as PluginConfig<TContext>[]).forEach(item => {\n      const invalid = findInvalidPluginConfig<TContext>(item);\n      if (invalid) {\n        invalidItems.push(...invalid.map(i => JSON.stringify(i, null, 2)));\n      }\n    });\n\n    return invalidItems.length > 0 ? invalidItems : null;\n  }\n\n  return [JSON.stringify(config, null, 2)];\n}\n"],"mappings":";;;;;;;;;;;;;;AAqJA,SAAgB,mBACd,OACwC;AACxC,QAAO,YAAY,MAAM,IAAI,aAAa,SAAS,WAAW,MAAM,QAAQ;;;;;;;;AAS9E,SAAgB,qBAAqB,OAAsC;AACzE,QAAO,WAAW,MAAM,IAAI,mBAAmB,MAAM;;;;;;;;AASvD,SAAgB,aAAa,OAAkD;AAC7E,QAAO,qBAAqB,MAAM,IAAI,mBAAmB,MAAM;;;;;;;;AA4BjE,SAAgB,eAId,YAC4C;AAC5C,QACE,WAAW,WAAW,GAAG,aAAa,WAAW"}

package/dist/core/src/plugin-utils/index.mjs

@@ -0,0 +1,9 @@
+import { getDependencyConfig } from "./build-helpers.mjs";
+import "./context-helpers.mjs";
+import { getHookHandler, isPluginHook, isPluginHookFunction, isPluginHookObject } from "./helpers.mjs";
+import "./merge.mjs";
+import "./extend.mjs";
+import "./get-config-path.mjs";
+import "./paths.mjs";
+
+export {  };

package/dist/core/src/plugin-utils/merge.mjs

@@ -0,0 +1,47 @@
+import { getHookHandler, isPluginHook } from "./helpers.mjs";
+import defu$1, { createDefu } from "defu";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isString } from "@stryke/type-checks/is-string";
+
+//#region ../core/src/plugin-utils/merge.ts
+const mergePlugin = createDefu((obj, key, value) => {
+	if (isPluginHook(obj[key]) && isPluginHook(value)) {
+		obj[key] = {
+			...obj[key],
+			...value,
+			handler: async (...params) => {
+				const [resultA, resultB] = await Promise.all([getHookHandler(obj[key])(...params), getHookHandler(value)(...params)]);
+				return resultB && resultA ? defu$1(resultA, resultB) : resultA || resultB;
+			}
+		};
+		return true;
+	}
+	return false;
+});
+/**
+* Merges two configuration objects together, with special handling for string values.
+* If the value from the second object is a non-empty string, it will overwrite the value from the first object.
+*
+* @example
+* ```ts
+* const configA = { name: "Default", version: "1.0.0" };
+* const configB = { name: "Custom", description: "A custom config" };
+* const mergedConfig = mergeConfig(configA, configB);
+* // Result: { name: "Custom", version: "1.0.0", description: "A custom config" }
+* ```
+*
+* @param objA - The first configuration object.
+* @param objB - The second configuration object.
+* @returns The merged configuration object.
+*/
+const mergeConfig = createDefu((obj, key, value) => {
+	if (isString(obj[key]) && isString(value)) {
+		if (isSetString(value)) obj[key] = value;
+		return true;
+	}
+	return false;
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=merge.mjs.map

package/dist/core/src/plugin-utils/merge.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.mjs","names":["defu"],"sources":["../../../../../core/src/plugin-utils/merge.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 { isSetString } from \"@stryke/type-checks/is-set-string\";\nimport { isString } from \"@stryke/type-checks/is-string\";\nimport defu, { createDefu } from \"defu\";\nimport { PartialPlugin, ResolvedConfig } from \"../types/config\";\nimport { PluginContext } from \"../types/context\";\nimport { Plugin } from \"../types/plugin\";\nimport { getHookHandler, isPluginHook } from \"./helpers\";\n\nexport type MergeResult<\n  TContext extends PluginContext,\n  TPluginA extends Plugin<TContext> | PartialPlugin<TContext>,\n  TPluginB extends Plugin<TContext> | PartialPlugin<TContext>\n> =\n  TPluginA extends Plugin<TContext>\n    ? Plugin<TContext>\n    : TPluginB extends Plugin<TContext>\n      ? Plugin<TContext>\n      : PartialPlugin<TContext>;\n\nconst mergePlugin = createDefu((obj, key, value) => {\n  if (isPluginHook(obj[key]) && isPluginHook(value)) {\n    obj[key] = {\n      ...obj[key],\n      ...value,\n      handler: async (...params: any[]) => {\n        const [resultA, resultB] = await Promise.all([\n          // eslint-disable-next-line ts/no-unsafe-call\n          (getHookHandler(obj[key]) as any)(...params),\n          // eslint-disable-next-line ts/no-unsafe-call\n          (getHookHandler(value) as any)(...params)\n        ]);\n\n        return resultB && resultA ? defu(resultA, resultB) : resultA || resultB;\n      }\n    };\n    return true;\n  }\n\n  return false;\n});\n\n/**\n * Merges two {@link Plugin | plugins} or {@link PartialPlugin | partial plugins} together.\n *\n * @param pluginA - The first {@link Plugin | plugin} or {@link PartialPlugin | partial plugin} to merge.\n * @param pluginB - The second {@link Plugin | plugin} or {@link PartialPlugin | partial plugin} to merge.\n * @returns The merged {@link Plugin | plugin} or {@link PartialPlugin | partial plugin}.\n */\nexport function merge<TContext extends PluginContext = PluginContext>(\n  pluginA: Plugin<TContext> | PartialPlugin<TContext>,\n  pluginB: Plugin<TContext> | PartialPlugin<TContext>\n): MergeResult<TContext, typeof pluginA, typeof pluginB> {\n  return mergePlugin(pluginA, pluginB) as MergeResult<\n    TContext,\n    typeof pluginA,\n    typeof pluginB\n  >;\n}\n\n/**\n * Merges two configuration objects together, with special handling for string values.\n * If the value from the second object is a non-empty string, it will overwrite the value from the first object.\n *\n * @example\n * ```ts\n * const configA = { name: \"Default\", version: \"1.0.0\" };\n * const configB = { name: \"Custom\", description: \"A custom config\" };\n * const mergedConfig = mergeConfig(configA, configB);\n * // Result: { name: \"Custom\", version: \"1.0.0\", description: \"A custom config\" }\n * ```\n *\n * @param objA - The first configuration object.\n * @param objB - The second configuration object.\n * @returns The merged configuration object.\n */\nexport const mergeConfig = createDefu((obj, key, value) => {\n  if (isString(obj[key]) && isString(value)) {\n    if (isSetString(value)) {\n      obj[key] = value;\n    }\n\n    return true;\n  }\n\n  return false;\n}) as (...configs: unknown[]) => ResolvedConfig;\n"],"mappings":";;;;;;AAqCA,MAAM,cAAc,YAAY,KAAK,KAAK,UAAU;AAClD,KAAI,aAAa,IAAI,KAAK,IAAI,aAAa,MAAM,EAAE;AACjD,MAAI,OAAO;GACT,GAAG,IAAI;GACP,GAAG;GACH,SAAS,OAAO,GAAG,WAAkB;IACnC,MAAM,CAAC,SAAS,WAAW,MAAM,QAAQ,IAAI,CAE1C,eAAe,IAAI,KAAK,CAAS,GAAG,OAAO,EAE3C,eAAe,MAAM,CAAS,GAAG,OAAO,CAC1C,CAAC;AAEF,WAAO,WAAW,UAAUA,OAAK,SAAS,QAAQ,GAAG,WAAW;;GAEnE;AACD,SAAO;;AAGT,QAAO;EACP;;;;;;;;;;;;;;;;;AAoCF,MAAa,cAAc,YAAY,KAAK,KAAK,UAAU;AACzD,KAAI,SAAS,IAAI,KAAK,IAAI,SAAS,MAAM,EAAE;AACzC,MAAI,YAAY,MAAM,CACpB,KAAI,OAAO;AAGb,SAAO;;AAGT,QAAO;EACP"}

package/dist/core/src/plugin-utils/paths.mjs

@@ -0,0 +1,4 @@
+import { joinPaths } from "@stryke/path/join";
+import { replacePath } from "@stryke/path/replace";
+
+export {  };