@powerlines/plugin-webpack 0.5.239 → 0.5.241

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

@@ -0,0 +1,78 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_ts_morph = require('../../lib/typescript/ts-morph.cjs');
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_path_append = require("@stryke/path/append");
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __stryke_path_is_parent_path = require("@stryke/path/is-parent-path");
+let __stryke_string_format_pretty_bytes = require("@stryke/string-format/pretty-bytes");
+let ts_morph = require("ts-morph");
+
+//#region ../powerlines/src/internal/helpers/generate-types.ts
+const getModuleCommentBlockRegex = (moduleId) => /* @__PURE__ */ new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${moduleId}(?s:.)*?\\*\\/\\s+`);
+/**
+* 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 emitBuiltinTypes(context, files) {
+	if (files.length === 0) {
+		context.debug("No files provided for TypeScript types generation. Typescript compilation for built-in modules will be skipped.");
+		return "";
+	}
+	context.debug(`Running the TypeScript compiler for ${files.length} generated built-in module files.`);
+	const program = require_ts_morph.createProgram(context, {
+		skipAddingFilesFromTsConfig: true,
+		compilerOptions: {
+			declaration: true,
+			declarationMap: false,
+			emitDeclarationOnly: true,
+			sourceMap: false,
+			outDir: (0, __stryke_path_replace.replacePath)(context.builtinsPath, context.workspaceConfig.workspaceRoot),
+			composite: false,
+			incremental: false,
+			tsBuildInfoFile: void 0
+		}
+	});
+	program.addSourceFilesAtPaths(files);
+	const result = program.emitToMemory({ emitOnlyDtsFiles: true });
+	const diagnostics = result.getDiagnostics();
+	if (diagnostics && diagnostics.length > 0) if (diagnostics.some((d) => d.getCategory() === ts_morph.DiagnosticCategory.Error)) throw new Error(`The Typescript emit process failed while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === ts_morph.DiagnosticCategory.Error).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	else if (diagnostics.some((d) => d.getCategory() === ts_morph.DiagnosticCategory.Warning)) context.warn(`The Typescript emit process completed with warnings while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === ts_morph.DiagnosticCategory.Warning).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	else context.debug(`The Typescript emit process completed with diagnostic messages while generating built-in types: \n ${diagnostics.map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	const emittedFiles = result.getFiles();
+	context.debug(`The TypeScript compiler emitted ${emittedFiles.length} files for built-in types.`);
+	let builtinModules = "";
+	for (const emittedFile of emittedFiles) {
+		context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
+		const filePath = (0, __stryke_path_append.appendPath)(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
+		if (!filePath.endsWith(".map") && (0, __stryke_path_file_path_fns.findFileName)(filePath) !== "tsconfig.tsbuildinfo" && (0, __stryke_path_is_parent_path.isParentPath)(filePath, context.builtinsPath)) {
+			const moduleId = `${context.config.framework}:${(0, __stryke_path_replace.replaceExtension)((0, __stryke_path_replace.replacePath)(filePath, context.builtinsPath), "", { fullExtension: true })}`;
+			const moduleComment = emittedFile.text.match(getModuleCommentBlockRegex(moduleId))?.find((comment) => (0, __stryke_type_checks_is_set_string.isSetString)(comment?.trim()));
+			builtinModules += `${moduleComment ? `\n${moduleComment.trim()}` : ""}
+declare module "${moduleId}" {
+    ${emittedFile.text.replace(moduleComment ?? "", "").trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
+}
+`;
+		}
+	}
+	builtinModules = formatTypes(builtinModules);
+	context.debug(`A TypeScript declaration file (size: ${(0, __stryke_string_format_pretty_bytes.prettyBytes)(new Blob((0, __stryke_convert_to_array.toArray)(builtinModules)).size)}) emitted for the built-in modules types.`);
+	return builtinModules;
+}
+
+//#endregion
+exports.emitBuiltinTypes = emitBuiltinTypes;
+exports.formatTypes = formatTypes;

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

@@ -0,0 +1,76 @@
+import { createProgram } from "../../lib/typescript/ts-morph.mjs";
+import { toArray } from "@stryke/convert/to-array";
+import { appendPath } from "@stryke/path/append";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { findFileName } from "@stryke/path/file-path-fns";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { prettyBytes } from "@stryke/string-format/pretty-bytes";
+import { DiagnosticCategory } from "ts-morph";
+
+//#region ../powerlines/src/internal/helpers/generate-types.ts
+const getModuleCommentBlockRegex = (moduleId) => /* @__PURE__ */ new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${moduleId}(?s:.)*?\\*\\/\\s+`);
+/**
+* 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 emitBuiltinTypes(context, files) {
+	if (files.length === 0) {
+		context.debug("No files provided for TypeScript types generation. Typescript compilation for built-in modules will be skipped.");
+		return "";
+	}
+	context.debug(`Running the TypeScript compiler for ${files.length} generated built-in module files.`);
+	const program = createProgram(context, {
+		skipAddingFilesFromTsConfig: true,
+		compilerOptions: {
+			declaration: true,
+			declarationMap: false,
+			emitDeclarationOnly: true,
+			sourceMap: false,
+			outDir: replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot),
+			composite: false,
+			incremental: false,
+			tsBuildInfoFile: void 0
+		}
+	});
+	program.addSourceFilesAtPaths(files);
+	const result = program.emitToMemory({ emitOnlyDtsFiles: true });
+	const diagnostics = result.getDiagnostics();
+	if (diagnostics && diagnostics.length > 0) if (diagnostics.some((d) => d.getCategory() === DiagnosticCategory.Error)) throw new Error(`The Typescript emit process failed while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === DiagnosticCategory.Error).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	else if (diagnostics.some((d) => d.getCategory() === DiagnosticCategory.Warning)) context.warn(`The Typescript emit process completed with warnings while generating built-in types: \n ${diagnostics.filter((d) => d.getCategory() === DiagnosticCategory.Warning).map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	else context.debug(`The Typescript emit process completed with diagnostic messages while generating built-in types: \n ${diagnostics.map((d) => `-${d.getSourceFile() ? `${d.getSourceFile()?.getFilePath()}:` : ""} ${String(d.getMessageText())} (at ${d.getStart()}:${d.getLength()})`).join("\n")}`);
+	const emittedFiles = result.getFiles();
+	context.debug(`The TypeScript compiler emitted ${emittedFiles.length} files for built-in types.`);
+	let builtinModules = "";
+	for (const emittedFile of emittedFiles) {
+		context.trace(`Processing emitted type declaration file: ${emittedFile.filePath}`);
+		const filePath = appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
+		if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath(filePath, context.builtinsPath)) {
+			const moduleId = `${context.config.framework}:${replaceExtension(replacePath(filePath, context.builtinsPath), "", { fullExtension: true })}`;
+			const moduleComment = emittedFile.text.match(getModuleCommentBlockRegex(moduleId))?.find((comment) => isSetString(comment?.trim()));
+			builtinModules += `${moduleComment ? `\n${moduleComment.trim()}` : ""}
+declare module "${moduleId}" {
+    ${emittedFile.text.replace(moduleComment ?? "", "").trim().replace(/^\s*export\s*declare\s*/gm, "export ").replace(/^\s*declare\s*/gm, "")}
+}
+`;
+		}
+	}
+	builtinModules = formatTypes(builtinModules);
+	context.debug(`A TypeScript declaration file (size: ${prettyBytes(new Blob(toArray(builtinModules)).size)}) emitted for the built-in modules types.`);
+	return builtinModules;
+}
+
+//#endregion
+export { emitBuiltinTypes, formatTypes };

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

@@ -0,0 +1,65 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+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 key - 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, key, options, ...args) {
+	const hooks = context.selectHooks(key, options);
+	if (hooks.length > 0) {
+		context.debug(` 🧩  Calling plugin hook: ${chalk.default.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)}`);
+		const invokeHook = async (hook, hookArgs) => {
+			return Reflect.apply(hook.handler, hook.context, hookArgs);
+		};
+		let results = [];
+		if (options?.sequential === false) results = await Promise.all(hooks.map(async (hook) => {
+			if (!(0, __stryke_type_checks_is_function.isFunction)(hook.handler)) throw new Error(`Plugin hook handler for hook "${key}" is not a function.`);
+			return invokeHook(hook, [...args]);
+		}));
+		else for (const hook of hooks) {
+			if (!(0, __stryke_type_checks_is_function.isFunction)(hook.handler)) throw new Error(`Plugin hook handler for hook "${key}" is not a function.`);
+			if (options?.result === "first" || options?.asNextParam === false) {
+				results.push(await Promise.resolve(invokeHook(hook, [...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(invokeHook(hook, [...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.d.cts

@@ -0,0 +1,47 @@
+import { SelectHooksOptions } from "../../types/context.cjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region ../powerlines/src/internal/helpers/hooks.d.ts
+type CallHookOptions = SelectHooksOptions & (({
+  /**
+   * Whether to call the hooks sequentially or in parallel.
+   *
+   * @defaultValue true
+   */
+  sequential?: true;
+} & ({
+  /**
+   * How to handle multiple return values from hooks.
+   * - "merge": Merge all non-undefined return values (if they are objects).
+   * - "first": Return the first non-undefined value.
+   *
+   * @remarks
+   * Merging only works if the return values are objects.
+   *
+   * @defaultValue "merge"
+   */
+  result: "first";
+} | {
+  /**
+   * How to handle multiple return values from hooks.
+   * - "merge": Merge all non-undefined return values (if they are objects).
+   * - "first": Return the first non-undefined value.
+   *
+   * @remarks
+   * Merging only works if the return values are objects.
+   *
+   * @defaultValue "merge"
+   */
+  result?: "merge" | "last";
+  /**
+   * An indicator specifying if the results of the previous hook should be provided as the **first** parameter of the next hook function, or a function to process the result of the previous hook function and pass the returned value as the next hook's **first** parameter
+   */
+  asNextParam?: false | ((previousResult: any) => MaybePromise<any>);
+})) | {
+  /**
+   * Whether to call the hooks sequentially or in parallel.
+   */
+  sequential: false;
+});
+//#endregion
+export { CallHookOptions };

package/dist/powerlines/src/internal/helpers/hooks.d.mts

@@ -0,0 +1,49 @@
+import "../../types/resolved.mjs";
+import "../../types/hooks.mjs";
+import { SelectHooksOptions } from "../../types/context.mjs";
+import { MaybePromise } from "@stryke/types/base";
+
+//#region ../powerlines/src/internal/helpers/hooks.d.ts
+type CallHookOptions = SelectHooksOptions & (({
+  /**
+   * Whether to call the hooks sequentially or in parallel.
+   *
+   * @defaultValue true
+   */
+  sequential?: true;
+} & ({
+  /**
+   * How to handle multiple return values from hooks.
+   * - "merge": Merge all non-undefined return values (if they are objects).
+   * - "first": Return the first non-undefined value.
+   *
+   * @remarks
+   * Merging only works if the return values are objects.
+   *
+   * @defaultValue "merge"
+   */
+  result: "first";
+} | {
+  /**
+   * How to handle multiple return values from hooks.
+   * - "merge": Merge all non-undefined return values (if they are objects).
+   * - "first": Return the first non-undefined value.
+   *
+   * @remarks
+   * Merging only works if the return values are objects.
+   *
+   * @defaultValue "merge"
+   */
+  result?: "merge" | "last";
+  /**
+   * An indicator specifying if the results of the previous hook should be provided as the **first** parameter of the next hook function, or a function to process the result of the previous hook function and pass the returned value as the next hook's **first** parameter
+   */
+  asNextParam?: false | ((previousResult: any) => MaybePromise<any>);
+})) | {
+  /**
+   * Whether to call the hooks sequentially or in parallel.
+   */
+  sequential: false;
+});
+//#endregion
+export { CallHookOptions };

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

@@ -0,0 +1,63 @@
+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 key - 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, key, options, ...args) {
+	const hooks = context.selectHooks(key, options);
+	if (hooks.length > 0) {
+		context.debug(` 🧩  Calling plugin hook: ${chalk.bold.cyanBright(`${key}${options?.order ? ` (${options.order})` : ""}`)}`);
+		const invokeHook = async (hook, hookArgs) => {
+			return Reflect.apply(hook.handler, hook.context, hookArgs);
+		};
+		let results = [];
+		if (options?.sequential === false) results = await Promise.all(hooks.map(async (hook) => {
+			if (!isFunction(hook.handler)) throw new Error(`Plugin hook handler for hook "${key}" is not a function.`);
+			return invokeHook(hook, [...args]);
+		}));
+		else for (const hook of hooks) {
+			if (!isFunction(hook.handler)) throw new Error(`Plugin hook handler for hook "${key}" is not a function.`);
+			if (options?.result === "first" || options?.asNextParam === false) {
+				results.push(await Promise.resolve(invokeHook(hook, [...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(invokeHook(hook, [...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

@@ -0,0 +1,24 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_install = require('./install.cjs');
+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.debug(`Checking and installing missing project dependencies.`);
+	context.dependencies ??= {};
+	context.devDependencies ??= {};
+	if (Object.keys(context.dependencies).length === 0 && Object.keys(context.devDependencies).length === 0) {
+		context.debug(`No dependencies or devDependencies to install. Skipping installation step.`);
+		return;
+	}
+	context.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

@@ -0,0 +1,23 @@
+import { installPackage } from "./install.mjs";
+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.debug(`Checking and installing missing project dependencies.`);
+	context.dependencies ??= {};
+	context.devDependencies ??= {};
+	if (Object.keys(context.dependencies).length === 0 && Object.keys(context.devDependencies).length === 0) {
+		context.debug(`No dependencies or devDependencies to install. Skipping installation step.`);
+		return;
+	}
+	context.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

@@ -0,0 +1,36 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+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.autoInstall) {
+		context.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.error(result.stderr);
+			throw new Error(`An error occurred while installing the package "${packageName}"`);
+		}
+	} else context.warn(`The package "${packageName}" is not installed. Since the "autoInstall" option is set to false, 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.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

@@ -0,0 +1,35 @@
+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.autoInstall) {
+		context.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.error(result.stderr);
+			throw new Error(`An error occurred while installing the package "${packageName}"`);
+		}
+	} else context.warn(`The package "${packageName}" is not installed. Since the "autoInstall" option is set to false, 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.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 };

package/dist/powerlines/src/internal/helpers/resolve-tsconfig.cjs

@@ -0,0 +1,97 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_tsconfig = require('../../lib/typescript/tsconfig.cjs');
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_fs_package_fns = require("@stryke/fs/package-fns");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+let __stryke_path_file_path_fns = require("@stryke/path/file-path-fns");
+let __donedeal0_superdiff = require("@donedeal0/superdiff");
+let __stryke_fs_json = require("@stryke/fs/json");
+let __stryke_json_storm_json = require("@stryke/json/storm-json");
+let __stryke_string_format_title_case = require("@stryke/string-format/title-case");
+
+//#region ../powerlines/src/internal/helpers/resolve-tsconfig.ts
+function getTsconfigDtsPath(context) {
+	return (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_file_path_fns.relativePath)((0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.projectRoot), (0, __stryke_path_file_path_fns.findFilePath)(context.dtsPath)), (0, __stryke_path_file_path_fns.findFileName)(context.dtsPath));
+}
+async function resolveTsconfigChanges(context) {
+	const tsconfig = require_tsconfig.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig, context.config.tsconfigRaw);
+	const tsconfigJson = await (0, __stryke_fs_json.readJsonFile)(require_tsconfig.getTsconfigFilePath(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig));
+	tsconfigJson.compilerOptions ??= {};
+	if (context.config.output.dts !== false) {
+		const dtsRelativePath = getTsconfigDtsPath(context);
+		if (!tsconfigJson.include?.some((filePattern) => require_tsconfig.isIncludeMatchFound(filePattern, [context.dtsPath, dtsRelativePath]))) {
+			tsconfigJson.include ??= [];
+			tsconfigJson.include.push(dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath);
+		}
+	}
+	if (!tsconfig.options.lib?.some((lib) => [
+		"lib.esnext.d.ts",
+		"lib.es2021.d.ts",
+		"lib.es2022.d.ts",
+		"lib.es2023.d.ts"
+	].includes(lib.toLowerCase()))) {
+		tsconfigJson.compilerOptions.lib ??= [];
+		tsconfigJson.compilerOptions.lib.push("esnext");
+	}
+	if (tsconfig.options.esModuleInterop !== true) tsconfigJson.compilerOptions.esModuleInterop = true;
+	if (tsconfig.options.isolatedModules !== true) tsconfigJson.compilerOptions.isolatedModules = true;
+	if (context.config.build.platform === "node") {
+		if (!tsconfig.options.types?.some((type) => type.toLowerCase() === "node" || type.toLowerCase() === "@types/node")) {
+			tsconfigJson.compilerOptions.types ??= [];
+			tsconfigJson.compilerOptions.types.push("node");
+		}
+	}
+	return tsconfigJson;
+}
+async function initializeTsconfig(context) {
+	context.debug("Initializing TypeScript configuration (tsconfig.json) for the Powerlines project.");
+	if (!(0, __stryke_fs_package_fns.isPackageExists)("typescript")) throw new Error("The TypeScript package is not installed. Please install the package using the command: \"npm install typescript --save-dev\"");
+	const tsconfigFilePath = require_tsconfig.getTsconfigFilePath(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig);
+	context.tsconfig.originalTsconfigJson = await (0, __stryke_fs_json.readJsonFile)(tsconfigFilePath);
+	context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
+	context.debug("Writing updated TypeScript configuration (tsconfig.json) file to disk.");
+	await context.fs.write(tsconfigFilePath, __stryke_json_storm_json.StormJSON.stringify(context.tsconfig.tsconfigJson));
+	context.tsconfig = require_tsconfig.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig, context.config.tsconfigRaw, context.tsconfig.originalTsconfigJson);
+}
+async function resolveTsconfig(context) {
+	const updateTsconfigJson = await (0, __stryke_fs_json.readJsonFile)(context.tsconfig.tsconfigFilePath);
+	if (updateTsconfigJson?.compilerOptions?.types && Array.isArray(updateTsconfigJson.compilerOptions.types) && !updateTsconfigJson.compilerOptions.types.length) delete updateTsconfigJson.compilerOptions.types;
+	const result = (0, __donedeal0_superdiff.getObjectDiff)(context.tsconfig.originalTsconfigJson, updateTsconfigJson, {
+		ignoreArrayOrder: true,
+		showOnly: {
+			statuses: [
+				"added",
+				"deleted",
+				"updated"
+			],
+			granularity: "deep"
+		}
+	});
+	const changes = [];
+	const getChanges = (difference, property) => {
+		if (difference.status === "added" || difference.status === "deleted" || difference.status === "updated") if (difference.diff) for (const diff of difference.diff) getChanges(diff, property ? `${property}.${difference.property}` : difference.property);
+		else changes.push({
+			field: property ? `${property}.${difference.property}` : difference.property,
+			status: difference.status,
+			previous: difference.status === "added" ? "---" : __stryke_json_storm_json.StormJSON.stringify(difference.previousValue),
+			current: difference.status === "deleted" ? "---" : __stryke_json_storm_json.StormJSON.stringify(difference.currentValue)
+		});
+	};
+	for (const diff of result.diff) getChanges(diff);
+	if (changes.length > 0) context.warn(`Updating the following configuration values in "${context.tsconfig.tsconfigFilePath}" file:
+
+    ${changes.map((change, i) => `${chalk.default.bold.whiteBright(`${i + 1}. ${(0, __stryke_string_format_title_case.titleCase)(change.status)} the ${change.field} field: `)}
+    ${chalk.default.red(` - Previous: ${change.previous} `)}
+    ${chalk.default.green(` - Updated: ${change.current} `)}
+  `).join("\n")}
+    `);
+	await context.fs.write(context.tsconfig.tsconfigFilePath, __stryke_json_storm_json.StormJSON.stringify(updateTsconfigJson));
+	context.tsconfig = require_tsconfig.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig);
+	if (!context.tsconfig) throw new Error("Failed to parse the TypeScript configuration file.");
+}
+
+//#endregion
+exports.getTsconfigDtsPath = getTsconfigDtsPath;
+exports.initializeTsconfig = initializeTsconfig;
+exports.resolveTsconfig = resolveTsconfig;