@powerlines/plugin-webpack 0.5.126 → 0.5.128

package/dist/powerlines/src/internal/babel/module-resolver-plugin.mjs

@@ -1 +1,84 @@
-import{declare as e}from"@babel/helper-plugin-utils";import*as t from"@babel/types";function n(e,n){if(!t.isStringLiteral(e.node))return;let r=n.context?.fs.resolveSync(e.node.value);r&&e.replaceWith(t.stringLiteral(r.replace(/\.(?:ts|mts|cts)x?$/,``)))}const r=[`require`,`require.resolve`,`System.import`,`jest.genMockFromModule`,`jest.mock`,`jest.unmock`,`jest.doMock`,`jest.dontMock`,`jest.setMock`,`jest.requireActual`,`jest.requireMock`,`require.requireActual`,`require.requireMock`];function i(e,n,r){let{node:i}=n;if(t.isMemberExpression(i))return n.matchesPattern(r);if(!t.isIdentifier(i)||r.includes(`.`))return!1;let a=r.split(`.`)[0];return i.name===a}const a={CallExpression:(e,a)=>{if(a.moduleResolverVisited.has(e))return;let o=e.get(`callee`);(o&&r.some(e=>i(a,o,e))||t.isImport(e.node.callee))&&(a.moduleResolverVisited.add(e),n(e.get(`arguments.0`),a))},"ImportDeclaration|ExportDeclaration|ExportAllDeclaration":(e,t)=>{!e||!e.get(`source`)||t.moduleResolverVisited.has(e)||(t.moduleResolverVisited.add(e),n(e.get(`source`),t))}},o=t=>e(function(e){let n=new Set;return{name:`powerlines:module-resolver`,manipulateOptions(e){e.filename??=`unknown`},pre(){n=new Set},visitor:{Program:{enter(r,i){r.traverse(a,{...i,context:t,moduleResolverVisited:n,api:e})},exit(r,i){r.traverse(a,{...i,context:t,moduleResolverVisited:n,api:e})}}},post(){n.clear()}}});export{o as moduleResolverBabelPlugin};
+import { declare } from "@babel/helper-plugin-utils";
+import * as t from "@babel/types";
+
+//#region ../powerlines/src/internal/babel/module-resolver-plugin.ts
+function resolveModulePath(nodePath, state) {
+	if (!t.isStringLiteral(nodePath.node)) return;
+	const resolvedPath = state.context?.fs.resolveSync(nodePath.node.value);
+	if (resolvedPath) nodePath.replaceWith(t.stringLiteral(resolvedPath.replace(/\.(?:ts|mts|cts)x?$/, "")));
+}
+const TRANSFORM_FUNCTIONS = [
+	"require",
+	"require.resolve",
+	"System.import",
+	"jest.genMockFromModule",
+	"jest.mock",
+	"jest.unmock",
+	"jest.doMock",
+	"jest.dontMock",
+	"jest.setMock",
+	"jest.requireActual",
+	"jest.requireMock",
+	"require.requireActual",
+	"require.requireMock"
+];
+function matchesPattern(state, calleePath, pattern) {
+	const { node } = calleePath;
+	if (t.isMemberExpression(node)) return calleePath.matchesPattern(pattern);
+	if (!t.isIdentifier(node) || pattern.includes(".")) return false;
+	const name = pattern.split(".")[0];
+	return node.name === name;
+}
+const importVisitors = {
+	CallExpression: (nodePath, state) => {
+		if (state.moduleResolverVisited.has(nodePath)) return;
+		const calleePath = nodePath.get("callee");
+		if (calleePath && TRANSFORM_FUNCTIONS.some((pattern) => matchesPattern(state, calleePath, pattern)) || t.isImport(nodePath.node.callee)) {
+			state.moduleResolverVisited.add(nodePath);
+			resolveModulePath(nodePath.get("arguments.0"), state);
+		}
+	},
+	"ImportDeclaration|ExportDeclaration|ExportAllDeclaration": (nodePath, state) => {
+		if (!nodePath || !nodePath.get("source") || state.moduleResolverVisited.has(nodePath)) return;
+		state.moduleResolverVisited.add(nodePath);
+		resolveModulePath(nodePath.get("source"), state);
+	}
+};
+const moduleResolverBabelPlugin = (context) => {
+	return declare(function builder(api) {
+		let moduleResolverVisited = /* @__PURE__ */ new Set();
+		return {
+			name: "powerlines:module-resolver",
+			manipulateOptions(opts) {
+				opts.filename ??= "unknown";
+			},
+			pre() {
+				moduleResolverVisited = /* @__PURE__ */ new Set();
+			},
+			visitor: { Program: {
+				enter(programPath, state) {
+					programPath.traverse(importVisitors, {
+						...state,
+						context,
+						moduleResolverVisited,
+						api
+					});
+				},
+				exit(programPath, state) {
+					programPath.traverse(importVisitors, {
+						...state,
+						context,
+						moduleResolverVisited,
+						api
+					});
+				}
+			} },
+			post() {
+				moduleResolverVisited.clear();
+			}
+		};
+	});
+};
+
+//#endregion
+export { moduleResolverBabelPlugin };

package/dist/powerlines/src/internal/helpers/environment.cjs

@@ -1 +1,52 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`);let t=require(`defu`);t=e.__toESM(t);let n=require(`@stryke/string-format/title-case`);const r=`default`,i=`__GLOBAL__`;function a(e,r){return(0,t.default)(r.environments?.[e]??{},{name:e,title:r.title||(0,n.titleCase)(r.name),ssr:!1,mainFields:r.build?.platform===`browser`?[`browser`,`module`,`jsnext:main`,`jsnext`]:[`module`,`jsnext:main`,`jsnext`],extensions:[`.mjs`,`.js`,`.mts`,`.ts`,`.jsx`,`.tsx`,`.json`],consumer:r.build?.platform===`browser`?`client`:`server`,preview:r.build?.platform===`browser`?{port:5173,open:!0,strictPort:!1,host:`localhost`,allowedHosts:[`.`],cors:!0,headers:{}}:void 0},r)}function o(e){return a(`default`,e)}exports.GLOBAL_ENVIRONMENT=`__GLOBAL__`,exports.createDefaultEnvironment=o,exports.createEnvironment=a;
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+
+//#region ../powerlines/src/internal/helpers/environment.ts
+const DEFAULT_ENVIRONMENT = "default";
+const GLOBAL_ENVIRONMENT = "__GLOBAL__";
+function createEnvironment(name, userConfig) {
+	return (0, defu.default)(userConfig.environments?.[name] ?? {}, {
+		name,
+		title: userConfig.title || (0, __stryke_string_format_title_case.titleCase)(userConfig.name),
+		ssr: false,
+		mainFields: userConfig.build?.platform === "browser" ? [
+			"browser",
+			"module",
+			"jsnext:main",
+			"jsnext"
+		] : [
+			"module",
+			"jsnext:main",
+			"jsnext"
+		],
+		extensions: [
+			".mjs",
+			".js",
+			".mts",
+			".ts",
+			".jsx",
+			".tsx",
+			".json"
+		],
+		consumer: userConfig.build?.platform === "browser" ? "client" : "server",
+		preview: userConfig.build?.platform === "browser" ? {
+			port: 5173,
+			open: true,
+			strictPort: false,
+			host: "localhost",
+			allowedHosts: ["."],
+			cors: true,
+			headers: {}
+		} : void 0
+	}, userConfig);
+}
+function createDefaultEnvironment(userConfig) {
+	return createEnvironment(DEFAULT_ENVIRONMENT, userConfig);
+}
+
+//#endregion
+exports.GLOBAL_ENVIRONMENT = GLOBAL_ENVIRONMENT;
+exports.createDefaultEnvironment = createDefaultEnvironment;
+exports.createEnvironment = createEnvironment;

package/dist/powerlines/src/internal/helpers/environment.mjs

@@ -1 +1,48 @@
-import e from"defu";import{titleCase as t}from"@stryke/string-format/title-case";const n=`__GLOBAL__`;function r(n,r){return e(r.environments?.[n]??{},{name:n,title:r.title||t(r.name),ssr:!1,mainFields:r.build?.platform===`browser`?[`browser`,`module`,`jsnext:main`,`jsnext`]:[`module`,`jsnext:main`,`jsnext`],extensions:[`.mjs`,`.js`,`.mts`,`.ts`,`.jsx`,`.tsx`,`.json`],consumer:r.build?.platform===`browser`?`client`:`server`,preview:r.build?.platform===`browser`?{port:5173,open:!0,strictPort:!1,host:`localhost`,allowedHosts:[`.`],cors:!0,headers:{}}:void 0},r)}function i(e){return r(`default`,e)}export{n as GLOBAL_ENVIRONMENT,i as createDefaultEnvironment,r as createEnvironment};
+import defu$1 from "defu";
+import { titleCase } from "@stryke/string-format/title-case";
+
+//#region ../powerlines/src/internal/helpers/environment.ts
+const DEFAULT_ENVIRONMENT = "default";
+const GLOBAL_ENVIRONMENT = "__GLOBAL__";
+function createEnvironment(name, userConfig) {
+	return defu$1(userConfig.environments?.[name] ?? {}, {
+		name,
+		title: userConfig.title || titleCase(userConfig.name),
+		ssr: false,
+		mainFields: userConfig.build?.platform === "browser" ? [
+			"browser",
+			"module",
+			"jsnext:main",
+			"jsnext"
+		] : [
+			"module",
+			"jsnext:main",
+			"jsnext"
+		],
+		extensions: [
+			".mjs",
+			".js",
+			".mts",
+			".ts",
+			".jsx",
+			".tsx",
+			".json"
+		],
+		consumer: userConfig.build?.platform === "browser" ? "client" : "server",
+		preview: userConfig.build?.platform === "browser" ? {
+			port: 5173,
+			open: true,
+			strictPort: false,
+			host: "localhost",
+			allowedHosts: ["."],
+			cors: true,
+			headers: {}
+		} : void 0
+	}, userConfig);
+}
+function createDefaultEnvironment(userConfig) {
+	return createEnvironment(DEFAULT_ENVIRONMENT, userConfig);
+}
+
+//#endregion
+export { GLOBAL_ENVIRONMENT, createDefaultEnvironment, createEnvironment };

package/dist/powerlines/src/internal/helpers/generate-types.cjs

@@ -1,8 +1,51 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`),t=require(`../../lib/typescript/ts-morph.cjs`);let n=require(`@storm-software/config-tools/types`),r=require(`typescript`);function i(e){return e.replace(/import\s*(?:type\s*)?\{?[\w,\s]*(?:\}\s*)?from\s*(?:'|")@?[a-zA-Z0-9-\\/.]*(?:'|");?/g,``).replaceAll(`#private;`,``).replace(/__Ω/g,``)}async function a(e,a){e.log(n.LogLevelLabel.TRACE,`Running the TypeScript compiler for ${a.length} generated runtime files.`);let o=t.createProgram(e,{skipAddingFilesFromTsConfig:!0});o.addSourceFilesAtPaths(a);let s=o.emitToMemory({emitOnlyDtsFiles:!0}),c=``;for(let t of s.getFiles())if(!t.filePath.endsWith(`.map`)&&e.builtins.some(n=>n===t.filePath||e.fs.metadata[n]?.id&&e.fs.metadata[n]?.id===t.filePath)){let n=await e.fs.resolve(t.filePath);c+=`
-  declare module "${n}" {
-      ${t.text.trim().replace(/^\s*export\s*declare\s*/gm,`export `).replace(/^\s*declare\s*/gm,``)}
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_ts_morph = require('../../lib/typescript/ts-morph.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let typescript = require("typescript");
+
+//#region ../powerlines/src/internal/helpers/generate-types.ts
+/**
+* Formats the generated TypeScript types source code.
+*
+* @param code - The generated TypeScript code.
+* @returns The formatted TypeScript code.
+*/
+function formatTypes(code) {
+	return code.replace(/import\s*(?:type\s*)?\{?[\w,\s]*(?:\}\s*)?from\s*(?:'|")@?[a-zA-Z0-9-\\/.]*(?:'|");?/g, "").replaceAll("#private;", "").replace(/__Ω/g, "");
+}
+/**
+* Emits TypeScript declaration types for the provided files using the given TypeScript configuration.
+*
+* @param context - The context containing options and environment paths.
+* @param files - The list of files to generate types for.
+* @returns A promise that resolves to the generated TypeScript declaration types.
+*/
+async function emitTypes(context, files) {
+	context.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Running the TypeScript compiler for ${files.length} generated runtime files.`);
+	const program = require_ts_morph.createProgram(context, { skipAddingFilesFromTsConfig: true });
+	program.addSourceFilesAtPaths(files);
+	const result = program.emitToMemory({ emitOnlyDtsFiles: true });
+	let builtinModules = "";
+	for (const file of result.getFiles()) if (!file.filePath.endsWith(".map")) {
+		if (context.builtins.some((builtin) => builtin === file.filePath || context.fs.metadata[builtin]?.id && context.fs.metadata[builtin]?.id === file.filePath)) {
+			const module$1 = await context.fs.resolve(file.filePath);
+			builtinModules += `
+  declare module "${module$1}" {
+      ${file.text.trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
   }
-  `}let l=[];s.getDiagnostics().forEach(e=>{e.getSourceFile()?.getBaseName()?l.push(`${e.getSourceFile()?.getBaseName()} (${(e.getLineNumber()??0)+1}): ${(0,r.flattenDiagnosticMessageText)(e.getMessageText().toString(),`
-`)}`):l.push((0,r.flattenDiagnosticMessageText)(e.getMessageText().toString(),`
-`))});let u=l.join(`
-`);if(u)throw Error(`TypeScript compilation failed: \n\n${u.length>5e3?`${u.slice(0,5e3)}...`:u}`);return i(c)}exports.emitTypes=a,exports.formatTypes=i;
+  `;
+		}
+	}
+	const diagnosticMessages = [];
+	result.getDiagnostics().forEach((diagnostic) => {
+		if (diagnostic.getSourceFile()?.getBaseName()) diagnosticMessages.push(`${diagnostic.getSourceFile()?.getBaseName()} (${(diagnostic.getLineNumber() ?? 0) + 1}): ${(0, typescript.flattenDiagnosticMessageText)(diagnostic.getMessageText().toString(), "\n")}`);
+		else diagnosticMessages.push((0, typescript.flattenDiagnosticMessageText)(diagnostic.getMessageText().toString(), "\n"));
+	});
+	const diagnosticMessage = diagnosticMessages.join("\n");
+	if (diagnosticMessage) throw new Error(`TypeScript compilation failed: \n\n${diagnosticMessage.length > 5e3 ? `${diagnosticMessage.slice(0, 5e3)}...` : diagnosticMessage}`);
+	return formatTypes(builtinModules);
+}
+
+//#endregion
+exports.emitTypes = emitTypes;
+exports.formatTypes = formatTypes;

package/dist/powerlines/src/internal/helpers/generate-types.mjs

@@ -1,8 +1,49 @@
-import{createProgram as e}from"../../lib/typescript/ts-morph.mjs";import{LogLevelLabel as t}from"@storm-software/config-tools/types";import{flattenDiagnosticMessageText as n}from"typescript";function r(e){return e.replace(/import\s*(?:type\s*)?\{?[\w,\s]*(?:\}\s*)?from\s*(?:'|")@?[a-zA-Z0-9-\\/.]*(?:'|");?/g,``).replaceAll(`#private;`,``).replace(/__Ω/g,``)}async function i(i,a){i.log(t.TRACE,`Running the TypeScript compiler for ${a.length} generated runtime files.`);let o=e(i,{skipAddingFilesFromTsConfig:!0});o.addSourceFilesAtPaths(a);let s=o.emitToMemory({emitOnlyDtsFiles:!0}),c=``;for(let e of s.getFiles())if(!e.filePath.endsWith(`.map`)&&i.builtins.some(t=>t===e.filePath||i.fs.metadata[t]?.id&&i.fs.metadata[t]?.id===e.filePath)){let t=await i.fs.resolve(e.filePath);c+=`
-  declare module "${t}" {
-      ${e.text.trim().replace(/^\s*export\s*declare\s*/gm,`export `).replace(/^\s*declare\s*/gm,``)}
+import { createProgram } from "../../lib/typescript/ts-morph.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { flattenDiagnosticMessageText } from "typescript";
+
+//#region ../powerlines/src/internal/helpers/generate-types.ts
+/**
+* Formats the generated TypeScript types source code.
+*
+* @param code - The generated TypeScript code.
+* @returns The formatted TypeScript code.
+*/
+function formatTypes(code) {
+	return code.replace(/import\s*(?:type\s*)?\{?[\w,\s]*(?:\}\s*)?from\s*(?:'|")@?[a-zA-Z0-9-\\/.]*(?:'|");?/g, "").replaceAll("#private;", "").replace(/__Ω/g, "");
+}
+/**
+* Emits TypeScript declaration types for the provided files using the given TypeScript configuration.
+*
+* @param context - The context containing options and environment paths.
+* @param files - The list of files to generate types for.
+* @returns A promise that resolves to the generated TypeScript declaration types.
+*/
+async function emitTypes(context, files) {
+	context.log(LogLevelLabel.TRACE, `Running the TypeScript compiler for ${files.length} generated runtime files.`);
+	const program = createProgram(context, { skipAddingFilesFromTsConfig: true });
+	program.addSourceFilesAtPaths(files);
+	const result = program.emitToMemory({ emitOnlyDtsFiles: true });
+	let builtinModules = "";
+	for (const file of result.getFiles()) if (!file.filePath.endsWith(".map")) {
+		if (context.builtins.some((builtin) => builtin === file.filePath || context.fs.metadata[builtin]?.id && context.fs.metadata[builtin]?.id === file.filePath)) {
+			const module = await context.fs.resolve(file.filePath);
+			builtinModules += `
+  declare module "${module}" {
+      ${file.text.trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
   }
-  `}let l=[];s.getDiagnostics().forEach(e=>{e.getSourceFile()?.getBaseName()?l.push(`${e.getSourceFile()?.getBaseName()} (${(e.getLineNumber()??0)+1}): ${n(e.getMessageText().toString(),`
-`)}`):l.push(n(e.getMessageText().toString(),`
-`))});let u=l.join(`
-`);if(u)throw Error(`TypeScript compilation failed: \n\n${u.length>5e3?`${u.slice(0,5e3)}...`:u}`);return r(c)}export{i as emitTypes,r as formatTypes};
+  `;
+		}
+	}
+	const diagnosticMessages = [];
+	result.getDiagnostics().forEach((diagnostic) => {
+		if (diagnostic.getSourceFile()?.getBaseName()) diagnosticMessages.push(`${diagnostic.getSourceFile()?.getBaseName()} (${(diagnostic.getLineNumber() ?? 0) + 1}): ${flattenDiagnosticMessageText(diagnostic.getMessageText().toString(), "\n")}`);
+		else diagnosticMessages.push(flattenDiagnosticMessageText(diagnostic.getMessageText().toString(), "\n"));
+	});
+	const diagnosticMessage = diagnosticMessages.join("\n");
+	if (diagnosticMessage) throw new Error(`TypeScript compilation failed: \n\n${diagnosticMessage.length > 5e3 ? `${diagnosticMessage.slice(0, 5e3)}...` : diagnosticMessage}`);
+	return formatTypes(builtinModules);
+}
+
+//#endregion
+export { emitTypes, formatTypes };

package/dist/powerlines/src/internal/helpers/hooks.cjs

@@ -1 +1,63 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`);let t=require(`@storm-software/config-tools/types`),n=require(`defu`),r=require(`@stryke/type-checks/is-function`),i=require(`@stryke/type-checks/is-object`),a=require(`@stryke/type-checks/is-set`),o=require(`@stryke/type-checks/is-string`),s=require(`chalk`);s=e.__toESM(s);const c=(0,n.createDefu)((e,t,n)=>(0,o.isString)(e[t])&&(0,o.isString)(n)?(e[t]=`${e[t]||``}\n${n||``}`.trim(),!0):!1);async function l(e,l,u,...d){let f=e.selectHooks(l,u);if(f.length>0){e.log(t.LogLevelLabel.DEBUG,` 🧩  Calling plugin hook: ${s.default.bold.cyanBright(`${l}${u?.order?` (${u.order})`:``}`)}`);let p=[];if(u?.sequential===!1)p=await Promise.all(f.map(async e=>{if(!(0,r.isFunction)(e.handle))throw Error(`Plugin hook handler for hook "${l}" is not a function.`);return Promise.resolve(e.handle.apply(e.context,[...d]))}));else for(let e of f){if(!(0,r.isFunction)(e.handle))throw Error(`Plugin hook handler for hook "${l}" is not a function.`);if(u?.result===`first`||u?.asNextParam===!1){if(p.push(await Promise.resolve(e.handle.apply(e.context,[...d]))),u?.result===`first`&&(0,a.isSet)(p[p.length-1]))break}else{let t=[...d];p.length>0&&t.length>0&&(t[0]=(0,r.isFunction)(u.asNextParam)?await Promise.resolve(u.asNextParam(p[0])):p[0]);let n=await Promise.resolve(e.handle.apply(e.context,[...t]));n&&(u?.result===`last`?p=[n]:(0,o.isString)(n)?p=[`${(0,o.isString)(p[0])&&p[0]||``}\n${n||``}`.trim()]:(0,i.isObject)(n)&&(p=[c(n,p[0]??{})]))}}let m=p.filter(e=>(0,a.isSet)(e));if(m.length>0){let e;for(let t of m)e=(0,n.defu)(t,e??{});return e}}}exports.callHook=l;
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let defu = require("defu");
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_type_checks_is_object = require("@stryke/type-checks/is-object");
+let __stryke_type_checks_is_set = require("@stryke/type-checks/is-set");
+let __stryke_type_checks_is_string = require("@stryke/type-checks/is-string");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+
+//#region ../powerlines/src/internal/helpers/hooks.ts
+const mergeResults = (0, defu.createDefu)((obj, key, value) => {
+	if ((0, __stryke_type_checks_is_string.isString)(obj[key]) && (0, __stryke_type_checks_is_string.isString)(value)) {
+		obj[key] = `${obj[key] || ""}\n${value || ""}`.trim();
+		return true;
+	}
+	return false;
+});
+/**
+* Calls a hook with the given context, options, and arguments.
+*
+* @param context - The context to use when calling the hook.
+* @param hook - The hook to call.
+* @param options - Options for calling the hook.
+* @param args - Arguments to pass to the hook.
+* @returns The return value of the hook.
+*/
+async function callHook(context, hook, options, ...args) {
+	const handlers = context.selectHooks(hook, options);
+	if (handlers.length > 0) {
+		context.log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, ` 🧩  Calling plugin hook: ${chalk.default.bold.cyanBright(`${hook}${options?.order ? ` (${options.order})` : ""}`)}`);
+		let results = [];
+		if (options?.sequential === false) results = await Promise.all(handlers.map(async (handler) => {
+			if (!(0, __stryke_type_checks_is_function.isFunction)(handler.handle)) throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
+			return Promise.resolve(handler.handle.apply(handler.context, [...args]));
+		}));
+		else for (const handler of handlers) {
+			if (!(0, __stryke_type_checks_is_function.isFunction)(handler.handle)) throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
+			if (options?.result === "first" || options?.asNextParam === false) {
+				results.push(await Promise.resolve(handler.handle.apply(handler.context, [...args])));
+				if (options?.result === "first" && (0, __stryke_type_checks_is_set.isSet)(results[results.length - 1])) break;
+			} else {
+				const sequenceArgs = [...args];
+				if (results.length > 0 && sequenceArgs.length > 0) sequenceArgs[0] = (0, __stryke_type_checks_is_function.isFunction)(options.asNextParam) ? await Promise.resolve(options.asNextParam(results[0])) : results[0];
+				const result = await Promise.resolve(handler.handle.apply(handler.context, [...sequenceArgs]));
+				if (result) {
+					if (options?.result === "last") results = [result];
+					else if ((0, __stryke_type_checks_is_string.isString)(result)) results = [`${(0, __stryke_type_checks_is_string.isString)(results[0]) ? results[0] || "" : ""}\n${result || ""}`.trim()];
+					else if ((0, __stryke_type_checks_is_object.isObject)(result)) results = [mergeResults(result, results[0] ?? {})];
+				}
+			}
+		}
+		const definedResults = results.filter((result) => (0, __stryke_type_checks_is_set.isSet)(result));
+		if (definedResults.length > 0) {
+			let mergedResult = void 0;
+			for (const result of definedResults) mergedResult = (0, defu.defu)(result, mergedResult ?? {});
+			return mergedResult;
+		}
+	}
+}
+
+//#endregion
+exports.callHook = callHook;

package/dist/powerlines/src/internal/helpers/hooks.mjs

@@ -1 +1,61 @@
-import{LogLevelLabel as e}from"@storm-software/config-tools/types";import{createDefu as t,defu as n}from"defu";import{isFunction as r}from"@stryke/type-checks/is-function";import{isObject as i}from"@stryke/type-checks/is-object";import{isSet as a}from"@stryke/type-checks/is-set";import{isString as o}from"@stryke/type-checks/is-string";import s from"chalk";const c=t((e,t,n)=>o(e[t])&&o(n)?(e[t]=`${e[t]||``}\n${n||``}`.trim(),!0):!1);async function l(t,l,u,...d){let f=t.selectHooks(l,u);if(f.length>0){t.log(e.DEBUG,` 🧩  Calling plugin hook: ${s.bold.cyanBright(`${l}${u?.order?` (${u.order})`:``}`)}`);let p=[];if(u?.sequential===!1)p=await Promise.all(f.map(async e=>{if(!r(e.handle))throw Error(`Plugin hook handler for hook "${l}" is not a function.`);return Promise.resolve(e.handle.apply(e.context,[...d]))}));else for(let e of f){if(!r(e.handle))throw Error(`Plugin hook handler for hook "${l}" is not a function.`);if(u?.result===`first`||u?.asNextParam===!1){if(p.push(await Promise.resolve(e.handle.apply(e.context,[...d]))),u?.result===`first`&&a(p[p.length-1]))break}else{let t=[...d];p.length>0&&t.length>0&&(t[0]=r(u.asNextParam)?await Promise.resolve(u.asNextParam(p[0])):p[0]);let n=await Promise.resolve(e.handle.apply(e.context,[...t]));n&&(u?.result===`last`?p=[n]:o(n)?p=[`${o(p[0])&&p[0]||``}\n${n||``}`.trim()]:i(n)&&(p=[c(n,p[0]??{})]))}}let m=p.filter(e=>a(e));if(m.length>0){let e;for(let t of m)e=n(t,e??{});return e}}}export{l as callHook};
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { createDefu, defu } from "defu";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isObject } from "@stryke/type-checks/is-object";
+import { isSet } from "@stryke/type-checks/is-set";
+import { isString } from "@stryke/type-checks/is-string";
+import chalk from "chalk";
+
+//#region ../powerlines/src/internal/helpers/hooks.ts
+const mergeResults = createDefu((obj, key, value) => {
+	if (isString(obj[key]) && isString(value)) {
+		obj[key] = `${obj[key] || ""}\n${value || ""}`.trim();
+		return true;
+	}
+	return false;
+});
+/**
+* Calls a hook with the given context, options, and arguments.
+*
+* @param context - The context to use when calling the hook.
+* @param hook - The hook to call.
+* @param options - Options for calling the hook.
+* @param args - Arguments to pass to the hook.
+* @returns The return value of the hook.
+*/
+async function callHook(context, hook, options, ...args) {
+	const handlers = context.selectHooks(hook, options);
+	if (handlers.length > 0) {
+		context.log(LogLevelLabel.DEBUG, ` 🧩  Calling plugin hook: ${chalk.bold.cyanBright(`${hook}${options?.order ? ` (${options.order})` : ""}`)}`);
+		let results = [];
+		if (options?.sequential === false) results = await Promise.all(handlers.map(async (handler) => {
+			if (!isFunction(handler.handle)) throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
+			return Promise.resolve(handler.handle.apply(handler.context, [...args]));
+		}));
+		else for (const handler of handlers) {
+			if (!isFunction(handler.handle)) throw new Error(`Plugin hook handler for hook "${hook}" is not a function.`);
+			if (options?.result === "first" || options?.asNextParam === false) {
+				results.push(await Promise.resolve(handler.handle.apply(handler.context, [...args])));
+				if (options?.result === "first" && isSet(results[results.length - 1])) break;
+			} else {
+				const sequenceArgs = [...args];
+				if (results.length > 0 && sequenceArgs.length > 0) sequenceArgs[0] = isFunction(options.asNextParam) ? await Promise.resolve(options.asNextParam(results[0])) : results[0];
+				const result = await Promise.resolve(handler.handle.apply(handler.context, [...sequenceArgs]));
+				if (result) {
+					if (options?.result === "last") results = [result];
+					else if (isString(result)) results = [`${isString(results[0]) ? results[0] || "" : ""}\n${result || ""}`.trim()];
+					else if (isObject(result)) results = [mergeResults(result, results[0] ?? {})];
+				}
+			}
+		}
+		const definedResults = results.filter((result) => isSet(result));
+		if (definedResults.length > 0) {
+			let mergedResult = void 0;
+			for (const result of definedResults) mergedResult = defu(result, mergedResult ?? {});
+			return mergedResult;
+		}
+	}
+}
+
+//#endregion
+export { callHook };

package/dist/powerlines/src/internal/helpers/install-dependencies.cjs

@@ -1,3 +1,25 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`),t=require(`./install.cjs`);let n=require(`@storm-software/config-tools/types`),r=require(`@stryke/string-format/package`);async function i(e){if(e.log(n.LogLevelLabel.TRACE,`Checking and installing missing project dependencies.`),e.dependencies??={},e.devDependencies??={},Object.keys(e.dependencies).length===0&&Object.keys(e.devDependencies).length===0){e.log(n.LogLevelLabel.TRACE,`No dependencies or devDependencies to install. Skipping installation step.`);return}e.log(n.LogLevelLabel.DEBUG,`The following packages are required: \nDependencies: \n${Object.entries(e.dependencies).map(([e,t])=>`- ${e}@${String(t)}`).join(` 
-`)}\n\nDevDependencies: \n${Object.entries(e.devDependencies).map(([e,t])=>`- ${e}@${String(t)}`).join(` 
-`)}`),await Promise.all([Promise.all(Object.entries(e.dependencies).map(async([n,i])=>t.installPackage(e,`${(0,r.getPackageName)(n)}@${String(i)}`,!1))),Promise.all(Object.entries(e.devDependencies).map(async([n,i])=>t.installPackage(e,`${(0,r.getPackageName)(n)}@${String(i)}`,!0)))])}exports.installDependencies=i;
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_install = require('./install.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_string_format_package = require("@stryke/string-format/package");
+
+//#region ../powerlines/src/internal/helpers/install-dependencies.ts
+/**
+* Install missing project dependencies.
+*
+* @param context - The build context.
+*/
+async function installDependencies(context) {
+	context.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `Checking and installing missing project dependencies.`);
+	context.dependencies ??= {};
+	context.devDependencies ??= {};
+	if (Object.keys(context.dependencies).length === 0 && Object.keys(context.devDependencies).length === 0) {
+		context.log(__storm_software_config_tools_types.LogLevelLabel.TRACE, `No dependencies or devDependencies to install. Skipping installation step.`);
+		return;
+	}
+	context.log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `The following packages are required: \nDependencies: \n${Object.entries(context.dependencies).map(([name, version]) => `- ${name}@${String(version)}`).join(" \n")}\n\nDevDependencies: \n${Object.entries(context.devDependencies).map(([name, version]) => `- ${name}@${String(version)}`).join(" \n")}`);
+	await Promise.all([Promise.all(Object.entries(context.dependencies).map(async ([name, version]) => require_install.installPackage(context, `${(0, __stryke_string_format_package.getPackageName)(name)}@${String(version)}`, false))), Promise.all(Object.entries(context.devDependencies).map(async ([name, version]) => require_install.installPackage(context, `${(0, __stryke_string_format_package.getPackageName)(name)}@${String(version)}`, true)))]);
+}
+
+//#endregion
+exports.installDependencies = installDependencies;

package/dist/powerlines/src/internal/helpers/install-dependencies.mjs

@@ -1,3 +1,24 @@
-import{installPackage as e}from"./install.mjs";import{LogLevelLabel as t}from"@storm-software/config-tools/types";import{getPackageName as n}from"@stryke/string-format/package";async function r(r){if(r.log(t.TRACE,`Checking and installing missing project dependencies.`),r.dependencies??={},r.devDependencies??={},Object.keys(r.dependencies).length===0&&Object.keys(r.devDependencies).length===0){r.log(t.TRACE,`No dependencies or devDependencies to install. Skipping installation step.`);return}r.log(t.DEBUG,`The following packages are required: \nDependencies: \n${Object.entries(r.dependencies).map(([e,t])=>`- ${e}@${String(t)}`).join(` 
-`)}\n\nDevDependencies: \n${Object.entries(r.devDependencies).map(([e,t])=>`- ${e}@${String(t)}`).join(` 
-`)}`),await Promise.all([Promise.all(Object.entries(r.dependencies).map(async([t,i])=>e(r,`${n(t)}@${String(i)}`,!1))),Promise.all(Object.entries(r.devDependencies).map(async([t,i])=>e(r,`${n(t)}@${String(i)}`,!0)))])}export{r as installDependencies};
+import { installPackage } from "./install.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { getPackageName } from "@stryke/string-format/package";
+
+//#region ../powerlines/src/internal/helpers/install-dependencies.ts
+/**
+* Install missing project dependencies.
+*
+* @param context - The build context.
+*/
+async function installDependencies(context) {
+	context.log(LogLevelLabel.TRACE, `Checking and installing missing project dependencies.`);
+	context.dependencies ??= {};
+	context.devDependencies ??= {};
+	if (Object.keys(context.dependencies).length === 0 && Object.keys(context.devDependencies).length === 0) {
+		context.log(LogLevelLabel.TRACE, `No dependencies or devDependencies to install. Skipping installation step.`);
+		return;
+	}
+	context.log(LogLevelLabel.DEBUG, `The following packages are required: \nDependencies: \n${Object.entries(context.dependencies).map(([name, version]) => `- ${name}@${String(version)}`).join(" \n")}\n\nDevDependencies: \n${Object.entries(context.devDependencies).map(([name, version]) => `- ${name}@${String(version)}`).join(" \n")}`);
+	await Promise.all([Promise.all(Object.entries(context.dependencies).map(async ([name, version]) => installPackage(context, `${getPackageName(name)}@${String(version)}`, false))), Promise.all(Object.entries(context.devDependencies).map(async ([name, version]) => installPackage(context, `${getPackageName(name)}@${String(version)}`, true)))]);
+}
+
+//#endregion
+export { installDependencies };

package/dist/powerlines/src/internal/helpers/install.cjs

@@ -1 +1,37 @@
-const e=require(`../../../../_virtual/rolldown_runtime.cjs`);let t=require(`@storm-software/config-tools/types`),n=require(`@stryke/fs/install`),r=require(`@stryke/fs/package-fns`),i=require(`@stryke/type-checks/is-number`),a=require(`@stryke/string-format/package`);async function o(e,o,s=!1){if(await(0,r.isPackageListed)((0,a.getPackageName)(o),{cwd:e.config.projectRoot})){if((0,a.hasPackageVersion)(o)&&!process.env.POWERLINES_SKIP_VERSION_CHECK&&!await(0,r.doesPackageMatch)((0,a.getPackageName)(o),(0,a.getPackageVersion)(o),e.config.projectRoot)){let n=await(0,r.getPackageListing)((0,a.getPackageName)(o),{cwd:e.config.projectRoot});!n?.version.startsWith(`catalog:`)&&!n?.version.startsWith(`workspace:`)&&e.log(t.LogLevelLabel.WARN,`The package "${(0,a.getPackageName)(o)}" is installed but does not match the expected version ${(0,a.getPackageVersion)(o)} (installed version: ${n?.version||`<Unknown>`}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the "STORM_STACK_SKIP_VERSION_CHECK" environment variable.`)}}else if(e.config.skipInstalls!==!0){e.log(t.LogLevelLabel.WARN,`The package "${o}" is not installed. It will be installed automatically.`);let r=await(0,n.install)(o,{cwd:e.config.projectRoot,dev:s});if((0,i.isNumber)(r.exitCode)&&r.exitCode>0)throw e.log(t.LogLevelLabel.ERROR,r.stderr),Error(`An error occurred while installing the package "${o}"`)}else e.log(t.LogLevelLabel.WARN,`The package "${o}" is not installed. Since the "skipInstalls" option is set to true, it will not be installed automatically.`)}exports.installPackage=o;
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_fs_install = require("@stryke/fs/install");
+let __stryke_fs_package_fns = require("@stryke/fs/package-fns");
+let __stryke_type_checks_is_number = require("@stryke/type-checks/is-number");
+let __stryke_string_format_package = require("@stryke/string-format/package");
+
+//#region ../powerlines/src/internal/helpers/install.ts
+/**
+* Installs a package if it is not already installed.
+*
+* @param context - The resolved options
+* @param packageName - The name of the package to install
+* @param dev - Whether to install the package as a dev dependency
+*/
+async function installPackage(context, packageName, dev = false) {
+	if (!await (0, __stryke_fs_package_fns.isPackageListed)((0, __stryke_string_format_package.getPackageName)(packageName), { cwd: context.config.projectRoot })) if (context.config.skipInstalls !== true) {
+		context.log(__storm_software_config_tools_types.LogLevelLabel.WARN, `The package "${packageName}" is not installed. It will be installed automatically.`);
+		const result = await (0, __stryke_fs_install.install)(packageName, {
+			cwd: context.config.projectRoot,
+			dev
+		});
+		if ((0, __stryke_type_checks_is_number.isNumber)(result.exitCode) && result.exitCode > 0) {
+			context.log(__storm_software_config_tools_types.LogLevelLabel.ERROR, result.stderr);
+			throw new Error(`An error occurred while installing the package "${packageName}"`);
+		}
+	} else context.log(__storm_software_config_tools_types.LogLevelLabel.WARN, `The package "${packageName}" is not installed. Since the "skipInstalls" option is set to true, it will not be installed automatically.`);
+	else if ((0, __stryke_string_format_package.hasPackageVersion)(packageName) && !process.env.POWERLINES_SKIP_VERSION_CHECK) {
+		if (!await (0, __stryke_fs_package_fns.doesPackageMatch)((0, __stryke_string_format_package.getPackageName)(packageName), (0, __stryke_string_format_package.getPackageVersion)(packageName), context.config.projectRoot)) {
+			const packageListing = await (0, __stryke_fs_package_fns.getPackageListing)((0, __stryke_string_format_package.getPackageName)(packageName), { cwd: context.config.projectRoot });
+			if (!packageListing?.version.startsWith("catalog:") && !packageListing?.version.startsWith("workspace:")) context.log(__storm_software_config_tools_types.LogLevelLabel.WARN, `The package "${(0, __stryke_string_format_package.getPackageName)(packageName)}" is installed but does not match the expected version ${(0, __stryke_string_format_package.getPackageVersion)(packageName)} (installed version: ${packageListing?.version || "<Unknown>"}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the "STORM_STACK_SKIP_VERSION_CHECK" environment variable.`);
+		}
+	}
+}
+
+//#endregion
+exports.installPackage = installPackage;

package/dist/powerlines/src/internal/helpers/install.mjs

@@ -1 +1,36 @@
-import{LogLevelLabel as e}from"@storm-software/config-tools/types";import{install as t}from"@stryke/fs/install";import{doesPackageMatch as n,getPackageListing as r,isPackageListed as i}from"@stryke/fs/package-fns";import{isNumber as a}from"@stryke/type-checks/is-number";import{getPackageName as o,getPackageVersion as s,hasPackageVersion as c}from"@stryke/string-format/package";async function l(l,u,d=!1){if(await i(o(u),{cwd:l.config.projectRoot})){if(c(u)&&!process.env.POWERLINES_SKIP_VERSION_CHECK&&!await n(o(u),s(u),l.config.projectRoot)){let t=await r(o(u),{cwd:l.config.projectRoot});!t?.version.startsWith(`catalog:`)&&!t?.version.startsWith(`workspace:`)&&l.log(e.WARN,`The package "${o(u)}" is installed but does not match the expected version ${s(u)} (installed version: ${t?.version||`<Unknown>`}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the "STORM_STACK_SKIP_VERSION_CHECK" environment variable.`)}}else if(l.config.skipInstalls!==!0){l.log(e.WARN,`The package "${u}" is not installed. It will be installed automatically.`);let n=await t(u,{cwd:l.config.projectRoot,dev:d});if(a(n.exitCode)&&n.exitCode>0)throw l.log(e.ERROR,n.stderr),Error(`An error occurred while installing the package "${u}"`)}else l.log(e.WARN,`The package "${u}" is not installed. Since the "skipInstalls" option is set to true, it will not be installed automatically.`)}export{l as installPackage};
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { install } from "@stryke/fs/install";
+import { doesPackageMatch, getPackageListing, isPackageListed } from "@stryke/fs/package-fns";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { getPackageName, getPackageVersion, hasPackageVersion } from "@stryke/string-format/package";
+
+//#region ../powerlines/src/internal/helpers/install.ts
+/**
+* Installs a package if it is not already installed.
+*
+* @param context - The resolved options
+* @param packageName - The name of the package to install
+* @param dev - Whether to install the package as a dev dependency
+*/
+async function installPackage(context, packageName, dev = false) {
+	if (!await isPackageListed(getPackageName(packageName), { cwd: context.config.projectRoot })) if (context.config.skipInstalls !== true) {
+		context.log(LogLevelLabel.WARN, `The package "${packageName}" is not installed. It will be installed automatically.`);
+		const result = await install(packageName, {
+			cwd: context.config.projectRoot,
+			dev
+		});
+		if (isNumber(result.exitCode) && result.exitCode > 0) {
+			context.log(LogLevelLabel.ERROR, result.stderr);
+			throw new Error(`An error occurred while installing the package "${packageName}"`);
+		}
+	} else context.log(LogLevelLabel.WARN, `The package "${packageName}" is not installed. Since the "skipInstalls" option is set to true, it will not be installed automatically.`);
+	else if (hasPackageVersion(packageName) && !process.env.POWERLINES_SKIP_VERSION_CHECK) {
+		if (!await doesPackageMatch(getPackageName(packageName), getPackageVersion(packageName), context.config.projectRoot)) {
+			const packageListing = await getPackageListing(getPackageName(packageName), { cwd: context.config.projectRoot });
+			if (!packageListing?.version.startsWith("catalog:") && !packageListing?.version.startsWith("workspace:")) context.log(LogLevelLabel.WARN, `The package "${getPackageName(packageName)}" is installed but does not match the expected version ${getPackageVersion(packageName)} (installed version: ${packageListing?.version || "<Unknown>"}). Please ensure this is intentional before proceeding. Note: You can skip this validation with the "STORM_STACK_SKIP_VERSION_CHECK" environment variable.`);
+		}
+	}
+}
+
+//#endregion
+export { installPackage };