powerlines 0.42.32 → 0.42.34

package/dist/api-0aKfs398.mjs

@@ -0,0 +1,1010 @@
+import { n as createProgram } from "./ts-morph-B85ZbV1Q.mjs";
+import { t as utils_exports } from "./utils.mjs";
+import { t as plugin_utils_exports } from "./plugin-utils.mjs";
+import { d as writeMetaFile, f as callHook, p as mergeConfigs, t as PowerlinesAPIContext } from "./api-context-CmuOyg7q.mjs";
+import { a as isIncludeMatchFound, i as getTsconfigFilePath, r as getParsedTypeScriptConfig } from "./tsconfig-DoV1dUYg.mjs";
+import { formatLogMessage } from "@storm-software/config-tools/logger/console";
+import { toArray } from "@stryke/convert/to-array";
+import { copyFiles } from "@stryke/fs/copy-file";
+import { existsSync } from "@stryke/fs/exists";
+import { createDirectory, removeDirectory } from "@stryke/fs/helpers";
+import { install } from "@stryke/fs/install";
+import { listFiles } from "@stryke/fs/list-files";
+import { doesPackageMatch, getPackageListing, isPackageExists, isPackageListed } from "@stryke/fs/package-fns";
+import { resolvePackage } from "@stryke/fs/resolve";
+import { getUnique } from "@stryke/helpers/get-unique";
+import { omit } from "@stryke/helpers/omit";
+import { appendPath } from "@stryke/path/append";
+import { findFileName, findFilePath, relativePath } from "@stryke/path/file-path-fns";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { joinPaths } from "@stryke/path/join-paths";
+import { replaceExtension, replacePath } from "@stryke/path/replace";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isError } from "@stryke/type-checks/is-error";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isNumber } from "@stryke/type-checks/is-number";
+import { isObject } from "@stryke/type-checks/is-object";
+import { isPromiseLike } from "@stryke/type-checks/is-promise";
+import { isSet } from "@stryke/type-checks/is-set";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isString } from "@stryke/type-checks/is-string";
+import chalk from "chalk";
+import defu$1 from "defu";
+import Handlebars from "handlebars";
+import { prettyBytes } from "@stryke/string-format/pretty-bytes";
+import { DiagnosticCategory, Node, Project } from "ts-morph";
+import { getPackageName, getPackageVersion, hasPackageVersion } from "@stryke/string-format/package";
+import { readJsonFile } from "@stryke/fs/json";
+import { getObjectDiff } from "@donedeal0/superdiff";
+import { StormJSON } from "@stryke/json/storm-json";
+
+//#region package.json
+var name = "powerlines";
+var version = "0.42.34";
+
+//#endregion
+//#region 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.replaceAll("#private;", "").replace(/__Ω/g, "");
+}
+async function extractModuleDeclarations(context, filePath, id, code, fileToModuleMap) {
+	const mappings = /* @__PURE__ */ new Map();
+	const ambient = [];
+	const sourceFile = new Project({ useInMemoryFileSystem: true }).createSourceFile("module.d.ts", code);
+	for (const ref of sourceFile.getTypeReferenceDirectives()) ambient.push({
+		id: ref.getFileName(),
+		external: true
+	});
+	const importLines = [];
+	const reExportLines = [];
+	const declarationLines = [];
+	for (const statement of sourceFile.getStatements()) {
+		if (Node.isImportDeclaration(statement)) {
+			const moduleSpec = statement.getModuleSpecifierValue();
+			const defaultImport = statement.getDefaultImport();
+			const namedImports = statement.getNamedImports();
+			const namespaceImport = statement.getNamespaceImport();
+			if (!defaultImport && namedImports.length === 0 && !namespaceImport) {
+				ambient.push({
+					id: moduleSpec,
+					external: !context.fs.isResolvableId(moduleSpec, filePath)
+				});
+				continue;
+			}
+			let resolvedSpec = moduleSpec;
+			if (context.fs.isResolvableId(moduleSpec, filePath)) {
+				const resolved = await context.resolve(moduleSpec, filePath);
+				if (resolved) {
+					const mapped = fileToModuleMap.get(resolved.id);
+					if (mapped) resolvedSpec = mapped;
+					else context.trace(`Could not resolve relative import '${moduleSpec}' from '${filePath}' to a builtin module. Keeping as-is.`);
+				}
+			}
+			if (namespaceImport) importLines.push(`\timport * as ${namespaceImport.getText()} from '${resolvedSpec}';`);
+			else {
+				const specifiers = [];
+				if (defaultImport) specifiers.push(`default as ${defaultImport.getText()}`);
+				for (const named of namedImports) {
+					const alias = named.getAliasNode()?.getText();
+					specifiers.push(alias ? `${named.getName()} as ${alias}` : named.getName());
+				}
+				if (specifiers.length > 0) {
+					const typeOnly = statement.isTypeOnly() ? " type" : "";
+					importLines.push(`\timport${typeOnly} { ${specifiers.join(", ")} } from '${resolvedSpec}';`);
+				}
+			}
+			continue;
+		}
+		if (Node.isExportDeclaration(statement)) {
+			const moduleSpec = statement.getModuleSpecifierValue();
+			if (moduleSpec) {
+				let resolvedSpec = moduleSpec;
+				if (context.fs.isResolvableId(moduleSpec, filePath)) {
+					const resolved = await context.resolve(moduleSpec, filePath);
+					if (resolved) {
+						const mapped = fileToModuleMap.get(resolved.id);
+						if (mapped) resolvedSpec = mapped;
+						else context.trace(`Could not resolve relative import '${moduleSpec}' from '${filePath}' to a builtin module. Keeping as-is.`);
+					}
+				}
+				const namedExports = statement.getNamedExports();
+				if (namedExports.length > 0) {
+					const specifiers = namedExports.map((named) => {
+						const alias = named.getAliasNode()?.getText();
+						return alias ? `${named.getName()} as ${alias}` : named.getName();
+					});
+					const typeOnly = statement.isTypeOnly() ? " type" : "";
+					reExportLines.push(`\texport${typeOnly} { ${specifiers.join(", ")} } from '${resolvedSpec}';`);
+				} else reExportLines.push(`\texport * from '${resolvedSpec}';`);
+			} else declarationLines.push(`\t${statement.getText()}`);
+			continue;
+		}
+		if (Node.isExportAssignment(statement)) {
+			declarationLines.push(`\t${statement.getText()}`);
+			continue;
+		}
+		const text = statement.getText();
+		if (text.includes("//# sourceMappingURL=")) continue;
+		declarationLines.push(formatTypes(text.replace(/^(export\s+)?declare\s+/, "$1")).split("\n").map((line) => `\t${line}`).join("\n"));
+	}
+	const moduleComment = code.match(new RegExp(`\\/\\*\\*(?s:.)*?@module\\s+${context.config.framework}:${id}(?s:.)*?\\*\\/\\s+`))?.find((comment) => isSetString(comment?.trim()));
+	let content = `${moduleComment ? `${moduleComment.trim()}\n` : ""}declare module "${context.config.framework}:${id}" {`;
+	for (const line of importLines) content += `\n${line}`;
+	for (const line of reExportLines) content += `\n${line}`;
+	for (const line of declarationLines) content += `\n${line}`;
+	content += "\n}";
+	return {
+		content,
+		mappings,
+		ambient
+	};
+}
+/**
+* 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 {
+			code: "",
+			directives: []
+		};
+	}
+	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 emitResult = program.emitToMemory({ emitOnlyDtsFiles: true });
+	const diagnostics = emitResult.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 = emitResult.getFiles();
+	context.debug(`The TypeScript compiler emitted ${emittedFiles.length} files for built-in types.`);
+	if (emittedFiles.length === 0) {
+		context.warn("The TypeScript compiler did not emit any files for built-in types. This may indicate an issue with the TypeScript configuration or the provided files.");
+		return {
+			code: "",
+			directives: []
+		};
+	}
+	const fileToModuleMap = /* @__PURE__ */ new Map();
+	const emittedBuiltinFiles = [];
+	for (const emittedFile of emittedFiles) {
+		const filePath = appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
+		if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo" && isParentPath(filePath, context.builtinsPath)) {
+			const moduleId = replaceExtension(replacePath(replacePath(filePath, context.builtinsPath), replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)), "", { fullExtension: true });
+			if (context.builtins.includes(moduleId)) {
+				fileToModuleMap.set(filePath, moduleId);
+				emittedBuiltinFiles.push({
+					filePath,
+					text: emittedFile.text
+				});
+			}
+		}
+	}
+	const builtins = await context.getBuiltins();
+	const emittedContentMap = /* @__PURE__ */ new Map();
+	for (const emittedFile of emittedFiles) {
+		const filePath = appendPath(emittedFile.filePath, context.workspaceConfig.workspaceRoot);
+		if (!filePath.endsWith(".map") && findFileName(filePath) !== "tsconfig.tsbuildinfo") emittedContentMap.set(filePath, emittedFile.text);
+	}
+	let code = "";
+	const directives = [];
+	const ambientModules = /* @__PURE__ */ new Set();
+	let isFirst = true;
+	for (const entry of emittedBuiltinFiles) {
+		context.trace(`Processing emitted type declaration file: ${entry.filePath}`);
+		const moduleId = fileToModuleMap.get(entry.filePath);
+		const moduleDecl = await extractModuleDeclarations(context, entry.filePath, moduleId, entry.text, fileToModuleMap);
+		if (!isFirst) code += "\n\n";
+		isFirst = false;
+		code += moduleDecl.content;
+		for (const dep of moduleDecl.ambient) if (dep.external) {
+			const directive = dep.id;
+			if (!directives.includes(directive)) directives.push(directive);
+		} else if (builtins.some((builtin) => builtin.id === dep.id)) ambientModules.add(builtins.find((builtin) => builtin.id === dep.id).path);
+		else if (builtins.some((builtin) => replaceExtension(builtin.path) === replaceExtension(dep.id))) ambientModules.add(dep.id);
+		else {
+			const resolved = await context.resolve(dep.id, entry.filePath);
+			if (resolved) {
+				for (const name of [
+					resolved.id,
+					`${resolved.id}.d.ts`,
+					`${resolved.id}.d.mts`,
+					`${resolved.id}.d.cts`,
+					replaceExtension(resolved.id, ".d.ts"),
+					replaceExtension(resolved.id, ".d.mts"),
+					replaceExtension(resolved.id, ".d.cts"),
+					`${resolved.id}/index.d.ts`
+				]) if (emittedContentMap.has(name)) {
+					ambientModules.add(name);
+					break;
+				}
+			}
+		}
+	}
+	for (const ambientFile of ambientModules) {
+		const dts = emittedContentMap.get(ambientFile);
+		if (dts) {
+			const cleaned = dts.replace(/\/\/# sourceMappingURL=.*$/m, "").trim();
+			if (cleaned) code += `\n\n${formatTypes(cleaned)}`;
+		}
+	}
+	code = await (0, utils_exports.format)(context, context.typesPath, code);
+	context.debug(`A TypeScript declaration file (size: ${prettyBytes(new Blob(toArray(code)).size)}) emitted for the built-in modules types.`);
+	return {
+		code,
+		directives
+	};
+}
+
+//#endregion
+//#region 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.root })) 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.root,
+			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.root)) {
+			const packageListing = await getPackageListing(getPackageName(packageName), { cwd: context.config.root });
+			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
+//#region 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
+//#region src/_internal/helpers/resolve-tsconfig.ts
+function getTsconfigDtsPath(context) {
+	return joinPaths(relativePath(joinPaths(context.workspaceConfig.workspaceRoot, context.config.root), findFilePath(context.typesPath)), findFileName(context.typesPath));
+}
+async function resolveTsconfigChanges(context) {
+	const tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.root, context.config.tsconfig, context.config.tsconfigRaw);
+	const tsconfigJson = await readJsonFile(getTsconfigFilePath(context.workspaceConfig.workspaceRoot, context.config.root, context.config.tsconfig));
+	tsconfigJson.compilerOptions ??= {};
+	if (context.config.output.dts !== false) {
+		const dtsRelativePath = getTsconfigDtsPath(context);
+		if (!tsconfigJson.include?.some((filePattern) => isIncludeMatchFound(filePattern, [context.typesPath, 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.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 (!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 = getTsconfigFilePath(context.workspaceConfig.workspaceRoot, context.config.root, context.config.tsconfig);
+	context.tsconfig.originalTsconfigJson = await readJsonFile(tsconfigFilePath);
+	context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
+	context.debug("Writing updated TypeScript configuration (tsconfig.json) file to disk.");
+	await context.fs.write(tsconfigFilePath, StormJSON.stringify(context.tsconfig.tsconfigJson));
+	context.tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.root, context.config.tsconfig, context.config.tsconfigRaw, context.tsconfig.originalTsconfigJson);
+}
+async function resolveTsconfig(context) {
+	const updateTsconfigJson = await readJsonFile(context.tsconfig.tsconfigFilePath);
+	if (updateTsconfigJson?.compilerOptions?.types && Array.isArray(updateTsconfigJson.compilerOptions.types) && !updateTsconfigJson.compilerOptions.types.length) delete updateTsconfigJson.compilerOptions.types;
+	const result = 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" ? "---" : StormJSON.stringify(difference.previousValue),
+			current: difference.status === "deleted" ? "---" : 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.bold.whiteBright(`${i + 1}. ${titleCase(change.status)} the ${change.field} field: `)}
+    ${chalk.red(` - Previous: ${change.previous} `)}
+    ${chalk.green(` - Updated: ${change.current} `)}
+  `).join("\n")}
+    `);
+	await context.fs.write(context.tsconfig.tsconfigFilePath, StormJSON.stringify(updateTsconfigJson));
+	context.tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.root, context.config.tsconfig);
+	if (!context.tsconfig) throw new Error("Failed to parse the TypeScript configuration file.");
+}
+
+//#endregion
+//#region src/api.ts
+/**
+* The Powerlines API class
+*
+* @remarks
+* This class is responsible for managing the Powerlines project lifecycle, including initialization, building, and finalization.
+*
+* @public
+*/
+var PowerlinesAPI = class PowerlinesAPI {
+	/**
+	* The Powerlines context
+	*/
+	#context;
+	/**
+	* The Powerlines context
+	*/
+	get context() {
+		return this.#context;
+	}
+	/**
+	* Create a new Powerlines API instance
+	*
+	* @param context - The Powerlines context
+	*/
+	constructor(context) {
+		this.#context = context;
+	}
+	/**
+	* Initialize a Powerlines API instance
+	*
+	* @param workspaceRoot - The directory of the underlying workspace the Powerlines project exists in
+	* @param config - An object containing the configuration required to run Powerlines tasks.
+	* @returns A new instance of the Powerlines API
+	*/
+	static async from(workspaceRoot, config) {
+		const api = new PowerlinesAPI(await PowerlinesAPIContext.from(workspaceRoot, config));
+		api.#context.$$internal = {
+			api,
+			addPlugin: api.#addPlugin.bind(api)
+		};
+		api.context.info(`🔌 The Powerlines Engine v${version} has started`);
+		for (const plugin of api.context.config.plugins.flat(10) ?? []) await api.#addPlugin(plugin);
+		if (api.context.plugins.length === 0) api.context.warn("No Powerlines plugins were specified in the options. Please ensure this is correct, as it is generally not recommended.");
+		else api.context.info(`Loaded ${api.context.plugins.length} ${titleCase(api.context.config.framework)} plugin${api.context.plugins.length > 1 ? "s" : ""}: \n${api.context.plugins.map((plugin, index) => ` ${index + 1}. ${(0, utils_exports.colorText)(plugin.name)}`).join("\n")}`);
+		const pluginConfig = await api.callHook("config", {
+			environment: await api.context.getEnvironment(),
+			sequential: true,
+			result: "merge",
+			merge: mergeConfigs
+		});
+		await api.context.withUserConfig(pluginConfig, { isHighPriority: false });
+		return api;
+	}
+	/**
+	* Generate the Powerlines typescript declaration file
+	*
+	* @remarks
+	* This method will only generate the typescript declaration file for the Powerlines project. It is generally recommended to run the full `prepare` command, which will run this method as part of its process.
+	*
+	* @param inlineConfig - The inline configuration for the types command
+	*/
+	async types(inlineConfig = { command: "types" }) {
+		this.context.info(" 🏗️  Generating typescript declarations for the Powerlines project");
+		this.context.debug(" Aggregating configuration options for the Powerlines project");
+		inlineConfig.command ??= "types";
+		await this.context.withInlineConfig(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			context.debug(`Initializing the processing options for the Powerlines project.`);
+			await this.callHook("configResolved", {
+				environment: context,
+				order: "pre"
+			});
+			await initializeTsconfig(context);
+			await this.callHook("configResolved", {
+				environment: context,
+				order: "normal"
+			});
+			if (context.entry.length > 0) context.debug(`The configuration provided ${isObject(context.config.input) ? Object.keys(context.config.input).length : toArray(context.config.input).length} entry point(s), Powerlines has found ${context.entry.length} entry files(s) for the ${context.config.title} project${context.entry.length > 0 && context.entry.length < 10 ? `: \n${context.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.output}` : ""}`).join(" \n")}` : ""}`);
+			else context.warn(`No entry files were found for the ${context.config.title} project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`);
+			await resolveTsconfig(context);
+			await installDependencies(context);
+			await this.callHook("configResolved", {
+				environment: context,
+				order: "post"
+			});
+			context.trace(`Powerlines configuration has been resolved: \n\n${formatLogMessage({
+				...context.config,
+				userConfig: isSetObject(context.config.userConfig) ? omit(context.config.userConfig, ["plugins"]) : void 0,
+				inlineConfig: isSetObject(context.config.inlineConfig) ? omit(context.config.inlineConfig, ["plugins"]) : void 0,
+				plugins: context.plugins.map((plugin) => plugin.plugin.name)
+			})}`);
+			if (!context.fs.existsSync(context.cachePath)) await createDirectory(context.cachePath);
+			if (!context.fs.existsSync(context.dataPath)) await createDirectory(context.dataPath);
+			if (context.config.skipCache === true || context.persistedMeta?.checksum !== context.meta.checksum) context.debug(`Using previously prepared files as the meta checksum has not changed.`);
+			else {
+				context.info(`Running \`prepare\` command as the meta checksum has changed since the last run.`);
+				await this.prepare(defu$1({ output: { types: false } }, inlineConfig));
+			}
+			await this.#types(context);
+			this.context.debug("Formatting files generated during the types step.");
+			await (0, utils_exports.format)(context, context.typesPath, await context.fs.read(context.typesPath) ?? "");
+			await writeMetaFile(context);
+			context.persistedMeta = context.meta;
+		});
+		this.context.debug("✔ Powerlines types generation has completed successfully");
+	}
+	/**
+	* Prepare the Powerlines API
+	*
+	* @remarks
+	* This method will prepare the Powerlines API for use, initializing any necessary resources.
+	*
+	* @param inlineConfig - The inline configuration for the prepare command
+	*/
+	async prepare(inlineConfig = { command: "prepare" }) {
+		this.context.info(" 🏗️  Preparing the Powerlines project");
+		this.context.debug(" Aggregating configuration options for the Powerlines project");
+		inlineConfig.command ??= "prepare";
+		await this.context.withInlineConfig(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			context.debug(`Initializing the processing options for the Powerlines project.`);
+			await this.callHook("configResolved", {
+				environment: context,
+				order: "pre"
+			});
+			await initializeTsconfig(context);
+			await this.callHook("configResolved", {
+				environment: context,
+				order: "normal"
+			});
+			if (context.entry.length > 0) context.debug(`The configuration provided ${isObject(context.config.input) ? Object.keys(context.config.input).length : toArray(context.config.input).length} entry point(s), Powerlines has found ${context.entry.length} entry files(s) for the ${context.config.title} project${context.entry.length > 0 && context.entry.length < 10 ? `: \n${context.entry.map((entry) => `- ${entry.file}${entry.output ? ` -> ${entry.output}` : ""}`).join(" \n")}` : ""}`);
+			else context.warn(`No entry files were found for the ${context.config.title} project. Please ensure this is correct. Powerlines plugins generally require at least one entry point to function properly.`);
+			await resolveTsconfig(context);
+			await installDependencies(context);
+			await this.callHook("configResolved", {
+				environment: context,
+				order: "post"
+			});
+			context.trace(`Powerlines configuration has been resolved: \n\n${formatLogMessage({
+				...context.config,
+				userConfig: isSetObject(context.config.userConfig) ? omit(context.config.userConfig, ["plugins"]) : void 0,
+				inlineConfig: isSetObject(context.config.inlineConfig) ? omit(context.config.inlineConfig, ["plugins"]) : void 0,
+				plugins: context.plugins.map((plugin) => plugin.plugin.name)
+			})}`);
+			if (!context.fs.existsSync(context.cachePath)) await createDirectory(context.cachePath);
+			if (!context.fs.existsSync(context.dataPath)) await createDirectory(context.dataPath);
+			await this.callHook("prepare", {
+				environment: context,
+				order: "pre"
+			});
+			await this.callHook("prepare", {
+				environment: context,
+				order: "normal"
+			});
+			await this.callHook("prepare", {
+				environment: context,
+				order: "post"
+			});
+			if (context.config.output.types !== false) await this.#types(context);
+			this.context.debug("Formatting files generated during the prepare step.");
+			await Promise.all([(0, utils_exports.formatFolder)(context, context.builtinsPath), (0, utils_exports.formatFolder)(context, context.entryPath)]);
+			await writeMetaFile(context);
+			context.persistedMeta = context.meta;
+		});
+		this.context.debug("✔ Powerlines preparation has completed successfully");
+	}
+	/**
+	* Create a new Powerlines project
+	*
+	* @remarks
+	* This method will create a new Powerlines project in the current directory.
+	*
+	* @param inlineConfig - The inline configuration for the new command
+	* @returns A promise that resolves when the project has been created
+	*/
+	async new(inlineConfig) {
+		this.context.info(" 🆕 Creating a new Powerlines project");
+		inlineConfig.command ??= "new";
+		await this.prepare(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			context.debug("Initializing the processing options for the Powerlines project.");
+			await this.callHook("new", {
+				environment: context,
+				order: "pre"
+			});
+			const files = await listFiles(joinPaths(context.powerlinesPath, "files/common/**/*.hbs"));
+			for (const file of files) {
+				context.trace(`Adding template file to project: ${file}`);
+				const template = Handlebars.compile(file);
+				await context.fs.write(joinPaths(context.config.root, file.replace(".hbs", "")), template(context));
+			}
+			await this.callHook("new", {
+				environment: context,
+				order: "normal"
+			});
+			if (context.config.projectType === "application") {
+				const files = await listFiles(joinPaths(context.powerlinesPath, "files/application/**/*.hbs"));
+				for (const file of files) {
+					context.trace(`Adding application template file: ${file}`);
+					const template = Handlebars.compile(file);
+					await context.fs.write(joinPaths(context.config.root, file.replace(".hbs", "")), template(context));
+				}
+			} else {
+				const files = await listFiles(joinPaths(context.powerlinesPath, "files/library/**/*.hbs"));
+				for (const file of files) {
+					context.trace(`Adding library template file: ${file}`);
+					const template = Handlebars.compile(file);
+					await context.fs.write(joinPaths(context.config.root, file.replace(".hbs", "")), template(context));
+				}
+			}
+			await this.callHook("new", {
+				environment: context,
+				order: "post"
+			});
+		});
+		this.context.debug("✔ Powerlines new command completed successfully");
+	}
+	/**
+	* Clean any previously prepared artifacts
+	*
+	* @remarks
+	* This method will remove the previous Powerlines artifacts from the project.
+	*
+	* @param inlineConfig - The inline configuration for the clean command
+	* @returns A promise that resolves when the clean command has completed
+	*/
+	async clean(inlineConfig = { command: "clean" }) {
+		this.context.info(" 🧹 Cleaning the previous Powerlines artifacts");
+		inlineConfig.command ??= "clean";
+		await this.prepare(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			context.debug("Cleaning the project's dist and artifacts directories.");
+			await context.fs.remove(joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.path));
+			await context.fs.remove(joinPaths(context.workspaceConfig.workspaceRoot, context.config.root, context.config.output.artifactsPath));
+			await this.callHook("clean", {
+				environment: context,
+				sequential: false
+			});
+		});
+		this.context.debug("✔ Powerlines cleaning completed successfully");
+	}
+	/**
+	* Lint the project
+	*
+	* @param inlineConfig - The inline configuration for the lint command
+	* @returns A promise that resolves when the lint command has completed
+	*/
+	async lint(inlineConfig = { command: "lint" }) {
+		this.context.info(" 📝 Linting the Powerlines project");
+		inlineConfig.command ??= "lint";
+		await this.prepare(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			await this.callHook("lint", {
+				environment: context,
+				sequential: false
+			});
+		});
+		this.context.debug("✔ Powerlines linting completed successfully");
+	}
+	/**
+	* Build the project
+	*
+	* @remarks
+	* This method will build the Powerlines project, generating the necessary artifacts.
+	*
+	* @param inlineConfig - The inline configuration for the build command
+	* @returns A promise that resolves when the build command has completed
+	*/
+	async build(inlineConfig = { command: "build" }) {
+		this.context.info(" 📦  Building the Powerlines project");
+		await this.context.generateChecksum();
+		if (this.context.meta.checksum !== this.context.persistedMeta?.checksum || this.context.config.skipCache) {
+			this.context.info(!this.context.persistedMeta?.checksum ? "No previous build cache found. Preparing the project for the initial build." : this.context.meta.checksum !== this.context.persistedMeta.checksum ? "The project has been modified since the last time `prepare` was ran. Re-preparing the project." : "The project is configured to skip cache. Re-preparing the project.");
+			inlineConfig.command ??= "build";
+			await this.prepare(inlineConfig);
+		}
+		if (this.context.config.singleBuild) await this.#handleBuild(await this.#context.toEnvironment());
+		else await this.#executeEnvironments(async (context) => {
+			await this.#handleBuild(context);
+		});
+		this.context.debug("✔ Powerlines build completed successfully");
+	}
+	/**
+	* Prepare the documentation for the project
+	*
+	* @param inlineConfig - The inline configuration for the docs command
+	* @returns A promise that resolves when the documentation generation has completed
+	*/
+	async docs(inlineConfig = { command: "docs" }) {
+		this.context.info(" 📓 Generating documentation for the Powerlines project");
+		inlineConfig.command ??= "docs";
+		await this.prepare(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			context.debug("Writing documentation for the Powerlines project artifacts.");
+			inlineConfig.command ??= "docs";
+			await this.prepare(inlineConfig);
+			await this.#executeEnvironments(async (context) => {
+				await this.callHook("docs", { environment: context });
+			});
+		});
+		this.context.debug("✔ Powerlines documentation generation completed successfully");
+	}
+	/**
+	* Deploy the project source code
+	*
+	* @remarks
+	* This method will prepare and build the Powerlines project, generating the necessary artifacts for the deployment.
+	*
+	* @param inlineConfig - The inline configuration for the deploy command
+	*/
+	async deploy(inlineConfig = { command: "deploy" }) {
+		this.context.info(" 🚀 Deploying the Powerlines project");
+		inlineConfig.command ??= "deploy";
+		await this.prepare(inlineConfig);
+		await this.#executeEnvironments(async (context) => {
+			await this.callHook("deploy", { environment: context });
+		});
+		this.context.debug("✔ Powerlines deploy completed successfully");
+	}
+	/**
+	* Finalization process
+	*
+	* @remarks
+	* This step includes any final processes or clean up required by Powerlines. It will be run after each Powerlines command.
+	*
+	* @returns A promise that resolves when the finalization process has completed
+	*/
+	async finalize() {
+		this.context.info(" 🏁 Powerlines finalization processes started");
+		await this.#executeEnvironments(async (context) => {
+			await this.callHook("finalize", { environment: context });
+			await context.fs.dispose();
+			if (existsSync(context.cachePath) && !(await listFiles(joinPaths(context.cachePath, "**/*")))?.length) await removeDirectory(context.cachePath);
+		});
+		this.context.debug("✔ Powerlines finalization completed successfully");
+	}
+	/**
+	* Invokes the configured plugin hooks
+	*
+	* @remarks
+	* By default, it will call the `"pre"`, `"normal"`, and `"post"` ordered hooks in sequence
+	*
+	* @param hook - The hook to call
+	* @param options - The options to provide to the hook
+	* @param args - The arguments to pass to the hook
+	* @returns The result of the hook call
+	*/
+	async callHook(hook, options, ...args) {
+		return callHook(isSetObject(options?.environment) ? options.environment : await this.#context.getEnvironment(options?.environment), hook, {
+			sequential: true,
+			...options
+		}, ...args);
+	}
+	/**
+	* Dispose of the Powerlines API instance
+	*
+	* @remarks
+	* This method will finalize the Powerlines API instance, cleaning up any resources used.
+	*/
+	async [Symbol.asyncDispose]() {
+		await this.finalize();
+	}
+	async #handleBuild(context) {
+		await this.callHook("build", {
+			environment: context,
+			order: "pre"
+		});
+		context.debug("Formatting the generated entry files before the build process starts.");
+		await (0, utils_exports.formatFolder)(context, context.entryPath);
+		await this.callHook("build", {
+			environment: context,
+			order: "normal"
+		});
+		if (context.config.output.copy) {
+			context.debug("Copying project's files from build output directory.");
+			const destinationPath = isParentPath(appendPath(context.config.output.path, context.workspaceConfig.workspaceRoot), appendPath(context.config.root, context.workspaceConfig.workspaceRoot)) ? joinPaths(context.config.output.copy.path, relativePath(appendPath(context.config.root, context.workspaceConfig.workspaceRoot), appendPath(context.config.output.path, context.workspaceConfig.workspaceRoot))) : joinPaths(context.config.output.copy.path, "dist");
+			const sourcePath = appendPath(context.config.output.path, context.workspaceConfig.workspaceRoot);
+			if (existsSync(sourcePath) && sourcePath !== destinationPath) {
+				context.debug(`Copying files from project's build output directory (${context.config.output.path}) to the project's copy/publish directory (${destinationPath}).`);
+				await copyFiles(sourcePath, destinationPath);
+			} else context.warn(`The source path for the copy operation ${!existsSync(sourcePath) ? "does not exist" : "is the same as the destination path"}. Source: ${sourcePath}, Destination: ${destinationPath}. Skipping copying of build output files.`);
+			if (context.config.output.copy.assets && Array.isArray(context.config.output.copy.assets)) await Promise.all(context.config.output.copy.assets.map(async (asset) => {
+				context.trace(`Copying asset(s): ${chalk.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : appendPath(asset.glob, replacePath(asset.input, context.workspaceConfig.workspaceRoot)))} -> ${chalk.greenBright(appendPath(asset.glob, replacePath(asset.output, context.workspaceConfig.workspaceRoot)))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk.yellowBright(i)).join(", ")})` : ""}`);
+				await context.fs.copy(asset, asset.output);
+			}));
+		} else context.debug("No copy configuration found for the project output. Skipping the copying of build output files.");
+		await this.callHook("build", {
+			environment: context,
+			order: "post"
+		});
+	}
+	/**
+	* Get the configured environments
+	*
+	* @returns The configured environments
+	*/
+	async #getEnvironments() {
+		if (!this.context.config.environments || Object.keys(this.context.config.environments).length <= 1) {
+			this.context.debug("No environments are configured for this Powerlines project. Using the default environment.");
+			return [await this.context.getEnvironment()];
+		}
+		this.context.debug(`Found ${Object.keys(this.context.config.environments).length} configured environment(s) for this Powerlines project.`);
+		return (await Promise.all(Object.entries(this.context.config.environments).map(async ([name, config]) => {
+			if (!await this.context.getEnvironmentSafe(name)) {
+				const resolvedEnvironment = await this.callHook("configEnvironment", { environment: name }, name, config);
+				if (resolvedEnvironment) this.context.environments[name] = await this.context.in(resolvedEnvironment);
+			}
+			return this.context.environments[name];
+		}))).filter((context) => isSet(context));
+	}
+	/**
+	* Execute a handler function for each environment
+	*
+	* @param handle - The handler function to execute for each environment
+	*/
+	async #executeEnvironments(handle) {
+		await Promise.all((await this.#getEnvironments()).map(async (context) => {
+			return Promise.resolve(handle(context));
+		}));
+	}
+	/**
+	* Add a Powerlines plugin used in the build process
+	*
+	* @param config - The import path of the plugin to add
+	*/
+	async #addPlugin(config) {
+		if (config) {
+			const result = await this.#initPlugin(config);
+			if (!result) return;
+			for (const plugin of result) {
+				this.context.debug(`Successfully initialized the ${chalk.bold.cyanBright(plugin.name)} plugin`);
+				await this.context.addPlugin(plugin);
+			}
+		}
+	}
+	/**
+	* Initialize a Powerlines plugin
+	*
+	* @param config - The configuration for the plugin
+	* @returns The initialized plugin instance, or null if the plugin was a duplicate
+	* @throws Will throw an error if the plugin cannot be found or is invalid
+	*/
+	async #initPlugin(config) {
+		let awaited = config;
+		if (isPromiseLike(config)) awaited = await Promise.resolve(config);
+		if (!(0, plugin_utils_exports.isPluginConfig)(awaited)) {
+			const invalid = (0, plugin_utils_exports.findInvalidPluginConfig)(awaited);
+			throw new Error(`Invalid ${invalid && invalid.length > 1 ? "plugins" : "plugin"} specified in the configuration - ${invalid && invalid.length > 0 ? JSON.stringify(awaited) : invalid?.join("\n\n")} \n\nPlease ensure the value is one of the following: \n - an instance of \`Plugin\` \n - a plugin name \n - an object with the \`plugin\` and \`options\` properties \n - a tuple array with the plugin and options \n - a factory function that returns a plugin or array of plugins \n - an array of plugins or plugin configurations`);
+		}
+		let plugins;
+		if ((0, plugin_utils_exports.isPlugin)(awaited)) plugins = [awaited];
+		else if (isFunction(awaited)) plugins = toArray(await Promise.resolve(awaited()));
+		else if (isString(awaited)) {
+			const resolved = await this.#resolvePlugin(awaited);
+			if (isFunction(resolved)) plugins = toArray(await Promise.resolve(resolved()));
+			else plugins = toArray(resolved);
+		} else if (Array.isArray(awaited) && awaited.every(plugin_utils_exports.isPlugin)) plugins = awaited;
+		else if (Array.isArray(awaited) && awaited.every(plugin_utils_exports.isPluginConfig)) {
+			plugins = [];
+			for (const pluginConfig of awaited) {
+				const initialized = await this.#initPlugin(pluginConfig);
+				if (initialized) plugins.push(...initialized);
+			}
+		} else if ((0, plugin_utils_exports.isPluginConfigTuple)(awaited) || (0, plugin_utils_exports.isPluginConfigObject)(awaited)) {
+			let pluginConfig;
+			let pluginOptions;
+			if ((0, plugin_utils_exports.isPluginConfigTuple)(awaited)) {
+				pluginConfig = awaited[0];
+				pluginOptions = awaited?.length === 2 ? awaited[1] : void 0;
+			} else {
+				pluginConfig = awaited.plugin;
+				pluginOptions = awaited.options;
+			}
+			if (isSetString(pluginConfig)) {
+				const resolved = await this.#resolvePlugin(pluginConfig);
+				if (isFunction(resolved)) plugins = toArray(await Promise.resolve(pluginOptions ? resolved(pluginOptions) : resolved()));
+				else plugins = toArray(resolved);
+			} else if (isFunction(pluginConfig)) plugins = toArray(await Promise.resolve(pluginConfig(pluginOptions)));
+			else if (Array.isArray(pluginConfig) && pluginConfig.every(plugin_utils_exports.isPlugin)) plugins = pluginConfig;
+			else if ((0, plugin_utils_exports.isPlugin)(pluginConfig)) plugins = toArray(pluginConfig);
+		}
+		if (!plugins) throw new Error(`The plugin configuration ${JSON.stringify(awaited)} is invalid. This configuration must point to a valid Powerlines plugin module.`);
+		if (plugins.length > 0 && !plugins.every(plugin_utils_exports.isPlugin)) throw new Error(`The plugin option ${JSON.stringify(plugins)} does not export a valid module. This configuration must point to a valid Powerlines plugin module.`);
+		const result = [];
+		for (const plugin of plugins) if ((0, plugin_utils_exports.isDuplicate)(plugin, this.context.plugins)) this.context.trace(`Duplicate ${chalk.bold.cyanBright(plugin.name)} plugin dependency detected - Skipping initialization.`);
+		else {
+			result.push(plugin);
+			this.context.trace(`Initializing the ${chalk.bold.cyanBright(plugin.name)} plugin...`);
+		}
+		return result;
+	}
+	async #resolvePlugin(pluginPath) {
+		if (pluginPath.startsWith("@") && pluginPath.split("/").filter(Boolean).length > 2) {
+			const splits = pluginPath.split("/").filter(Boolean);
+			pluginPath = `${splits[0]}/${splits[1]}`;
+		}
+		const isInstalled = isPackageExists(pluginPath, { paths: [this.context.workspaceConfig.workspaceRoot, this.context.config.root] });
+		if (!isInstalled && this.context.config.autoInstall) {
+			this.#context.warn(`The plugin package "${pluginPath}" is not installed. It will be installed automatically.`);
+			const result = await install(pluginPath, { cwd: this.context.config.root });
+			if (isNumber(result.exitCode) && result.exitCode > 0) {
+				this.#context.error(result.stderr);
+				throw new Error(`An error occurred while installing the build plugin package "${pluginPath}" `);
+			}
+		}
+		try {
+			const module = await this.context.resolver.plugin.import(this.context.resolver.plugin.esmResolve(joinPaths(pluginPath, "plugin")));
+			const result = module.plugin ?? module.default;
+			if (!result) throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
+			return result;
+		} catch (error) {
+			try {
+				const module = await this.context.resolver.plugin.import(this.context.resolver.plugin.esmResolve(pluginPath));
+				const result = module.plugin ?? module.default;
+				if (!result) throw new Error(`The plugin package "${pluginPath}" does not export a valid module.`);
+				return result;
+			} catch {
+				if (!isInstalled) throw new Error(`The plugin package "${pluginPath}" is not installed. Please install the package using the command: "npm install ${pluginPath} --save-dev"`);
+				else throw new Error(`An error occurred while importing the build plugin package "${pluginPath}":
+${isError(error) ? error.message : String(error)}
+
+Note: Please ensure the plugin package's default export is a class that extends \`Plugin\` with a constructor that excepts a single arguments of type \`PluginOptions\`.`);
+			}
+		}
+	}
+	/**
+	* Generate the Powerlines TypeScript declaration file
+	*
+	* @remarks
+	* This method will generate the TypeScript declaration file for the Powerlines project, including any types provided by plugins.
+	*
+	* @param context - The environment context to use for generating the TypeScript declaration file
+	* @returns A promise that resolves when the TypeScript declaration file has been generated
+	*/
+	async #types(context) {
+		context.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
+		if (context.fs.existsSync(context.typesPath)) await context.fs.remove(context.typesPath);
+		if (!await resolvePackage("typescript")) throw new Error("Could not resolve TypeScript package location. Please ensure TypeScript is installed.");
+		context.debug("Running TypeScript compiler for built-in runtime module files.");
+		let { code, directives } = await emitBuiltinTypes(context, (await context.getBuiltins()).reduce((ret, builtin) => {
+			const formatted = replacePath(builtin.path, context.workspaceConfig.workspaceRoot);
+			if (!ret.includes(formatted)) ret.push(formatted);
+			return ret;
+		}, []));
+		context.debug(`Generating TypeScript declaration file ${context.typesPath}.`);
+		const merge = async (currentResult, previousResult) => {
+			if (!isSetString(currentResult) && !isSetObject(currentResult) && !isSetString(previousResult) && !isSetObject(previousResult)) return {
+				code,
+				directives
+			};
+			const previous = (await (0, utils_exports.format)(context, context.typesPath, isSetString(previousResult) ? previousResult : isSetObject(previousResult) ? previousResult.code : "")).trim().replace(code, "").trim();
+			const current = (await (0, utils_exports.format)(context, context.typesPath, isSetString(currentResult) ? currentResult : isSetObject(currentResult) ? currentResult.code : "")).trim().replace(previous, "").trim().replace(code, "").trim();
+			return {
+				directives: [...isSetObject(currentResult) && currentResult.directives ? currentResult.directives : [], ...isSetObject(previousResult) && previousResult.directives ? previousResult.directives : []],
+				code: await (0, utils_exports.format)(context, context.typesPath, `${!previous.includes((0, utils_exports.getTypescriptFileHeader)(context)) && !current.includes((0, utils_exports.getTypescriptFileHeader)(context)) ? `${code}\n` : ""}${previous}\n${current}`.trim())
+			};
+		};
+		const asNextParam = (previousResult) => isObject(previousResult) ? previousResult.code : previousResult;
+		let result = await this.callHook("types", {
+			environment: context,
+			sequential: true,
+			order: "pre",
+			result: "merge",
+			merge,
+			asNextParam
+		}, code);
+		if (result) {
+			if (isSetObject(result)) {
+				code = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives = getUnique([...directives, ...result.directives]).filter(Boolean);
+			} else if (isSetString(result)) code = result;
+		}
+		result = await this.callHook("types", {
+			environment: context,
+			sequential: true,
+			order: "normal",
+			result: "merge",
+			merge,
+			asNextParam
+		}, code);
+		if (result) {
+			if (isSetObject(result)) {
+				code = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives = getUnique([...directives, ...result.directives]).filter(Boolean);
+			} else if (isSetString(result)) code = result;
+		}
+		result = await this.callHook("types", {
+			environment: context,
+			sequential: true,
+			order: "post",
+			result: "merge",
+			merge,
+			asNextParam
+		}, code);
+		if (result) {
+			if (isSetObject(result)) {
+				code = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives = getUnique([...directives, ...result.directives]).filter(Boolean);
+			} else if (isSetString(result)) code = result;
+		}
+		if (isSetString(code?.trim()) || directives.length > 0) await context.fs.write(context.typesPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+
+` : ""}${(0, utils_exports.getTypescriptFileHeader)(context, {
+			directive: null,
+			prettierIgnore: false
+		})}
+
+${formatTypes(code)}
+`);
+	}
+};
+
+//#endregion
+export { name as n, version as r, PowerlinesAPI as t };
+//# sourceMappingURL=api-0aKfs398.mjs.map