powerlines 0.41.23 → 0.42.1

package/dist/{api-BYbfR23c.cjs → api-BEe2vHNH.cjs}

@@ -76,7 +76,7 @@ let unplugin = require("unplugin");
 
 //#region package.json
 var name = "powerlines";
-var version = "0.41.23";
+var version = "0.42.1";
 
 //#endregion
 //#region src/_internal/helpers/generate-types.ts
@@ -3232,6 +3232,54 @@ var PowerlinesAPI = class PowerlinesAPI {
 		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 typegen command
+	*/
+	async typegen(inlineConfig = { command: "typegen" }) {
+		this.context.info(" 🏗️  Generating typescript declarations for the Powerlines project");
+		this.context.debug(" Aggregating configuration options for the Powerlines project");
+		inlineConfig.command ??= "typegen";
+		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 ${(0, _stryke_type_checks_is_object.isObject)(context.config.input) ? Object.keys(context.config.input).length : (0, _stryke_convert_to_array.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${(0, _storm_software_config_tools_logger_console.formatLogMessage)({
+				...context.config,
+				userConfig: (0, _stryke_type_checks_is_set_object.isSetObject)(context.config.userConfig) ? (0, _stryke_helpers_omit.omit)(context.config.userConfig, ["plugins"]) : void 0,
+				inlineConfig: (0, _stryke_type_checks_is_set_object.isSetObject)(context.config.inlineConfig) ? (0, _stryke_helpers_omit.omit)(context.config.inlineConfig, ["plugins"]) : void 0,
+				plugins: context.plugins.map((plugin) => plugin.plugin.name)
+			})}`);
+			if (!context.fs.existsSync(context.cachePath)) await (0, _stryke_fs_helpers.createDirectory)(context.cachePath);
+			if (!context.fs.existsSync(context.dataPath)) await (0, _stryke_fs_helpers.createDirectory)(context.dataPath);
+			await this.#typegen(context);
+			this.context.debug("Formatting files generated during the typegen step.");
+			await (0, require_utils.utils_exports.format)(context, context.typegenPath, await context.fs.read(context.typegenPath) ?? "");
+			await writeMetaFile(context);
+			context.persistedMeta = context.meta;
+		});
+		this.context.debug("✔ Powerlines typegen has completed successfully");
+	}
+	/**
 	* Prepare the Powerlines API
 	*
 	* @remarks
@@ -3242,6 +3290,7 @@ var PowerlinesAPI = class PowerlinesAPI {
 	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.`);
@@ -3282,78 +3331,7 @@ var PowerlinesAPI = class PowerlinesAPI {
 				environment: context,
 				order: "post"
 			});
-			if (context.config.output.typegen !== false) {
-				context.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
-				if (context.fs.existsSync(context.typegenPath)) await context.fs.remove(context.typegenPath);
-				if (!await (0, _stryke_fs_resolve.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 types = await emitBuiltinTypes(context, (await context.getBuiltins()).reduce((ret, builtin) => {
-					const formatted = (0, _stryke_path_replace.replacePath)(builtin.path, context.workspaceConfig.workspaceRoot);
-					if (!ret.includes(formatted)) ret.push(formatted);
-					return ret;
-				}, []));
-				context.debug(`Generating TypeScript declaration file ${context.typegenPath}.`);
-				const directives = [];
-				const asNextParam = (previousResult) => (0, _stryke_type_checks_is_object.isObject)(previousResult) ? previousResult.code : previousResult;
-				let result = await this.callHook("types", {
-					environment: context,
-					sequential: true,
-					order: "pre",
-					result: "merge",
-					asNextParam
-				}, types);
-				if (result) {
-					if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
-						types = result.code;
-						if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
-					} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) types = result;
-				}
-				result = await this.callHook("types", {
-					environment: context,
-					sequential: true,
-					order: "normal",
-					result: "merge",
-					asNextParam
-				}, types);
-				if (result) {
-					if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
-						types = result.code;
-						if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
-					} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) types = result;
-				}
-				result = await this.callHook("types", {
-					environment: context,
-					sequential: true,
-					order: "post",
-					result: "merge",
-					asNextParam
-				}, types);
-				if (result) {
-					if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
-						types = result.code;
-						if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
-					} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) types = result;
-				}
-				if ((0, _stryke_type_checks_is_set_string.isSetString)(types?.trim()) || directives.length > 0) await context.fs.write(context.typegenPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
-
-` : ""}${(0, require_utils.utils_exports.getTypescriptFileHeader)(context, {
-					directive: null,
-					prettierIgnore: false
-				})}
-
-${formatTypes(types)}
-`);
-				else {
-					const dtsRelativePath = getTsconfigDtsPath(context);
-					if (context.tsconfig.tsconfigJson.include && require_tsconfig.isIncludeMatchFound(dtsRelativePath, context.tsconfig.tsconfigJson.include)) {
-						const normalizedDtsRelativePath = dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath;
-						context.tsconfig.tsconfigJson.include = context.tsconfig.tsconfigJson.include.filter((includeValue) => includeValue?.toString() !== normalizedDtsRelativePath);
-						await context.fs.write(context.tsconfig.tsconfigFilePath, JSON.stringify(context.tsconfig.tsconfigJson, null, 2));
-					}
-				}
-			}
-			context.tsconfig = require_tsconfig.getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.root, context.config.tsconfig);
-			if (!context.tsconfig) throw new Error("Failed to parse the TypeScript configuration file.");
+			if (context.config.output.typegen !== false) await this.#typegen(context);
 			this.context.debug("Formatting files generated during the prepare step.");
 			await Promise.all([(0, require_utils.utils_exports.formatFolder)(context, context.builtinsPath), (0, require_utils.utils_exports.formatFolder)(context, context.entryPath)]);
 			await writeMetaFile(context);
@@ -3372,6 +3350,7 @@ ${formatTypes(types)}
 	*/
 	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.");
@@ -3422,6 +3401,7 @@ ${formatTypes(types)}
 	*/
 	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.");
@@ -3442,6 +3422,7 @@ ${formatTypes(types)}
 	*/
 	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", {
@@ -3465,6 +3446,7 @@ ${formatTypes(types)}
 		await this.context.generateChecksum();
 		if (this.context.meta.checksum !== this.context.persistedMeta?.checksum || this.context.config.skipCache) {
 			this.context.info("The project has been modified since the last time `prepare` was ran. Re-preparing the project.");
+			inlineConfig.command ??= "build";
 			await this.prepare(inlineConfig);
 		}
 		if (this.context.config.singleBuild) await this.#handleBuild(await this.#context.toEnvironment());
@@ -3481,9 +3463,11 @@ ${formatTypes(types)}
 	*/
 	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 });
@@ -3501,6 +3485,7 @@ ${formatTypes(types)}
 	*/
 	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 });
@@ -3569,7 +3554,7 @@ ${formatTypes(types)}
 			}
 		}
 		await Promise.all(context.config.output.assets.map(async (asset) => {
-			context.trace(`Copying asset(s): ${chalk.default.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : (0, _stryke_path_append.appendPath)(asset.glob, (0, _stryke_path_replace.replacePath)(asset.input, context.workspaceConfig.workspaceRoot)))} -> ${chalk.default.greenBright((0, _stryke_path_join_paths.joinPaths)((0, _stryke_path_replace.replacePath)(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk.default.yellowBright(i)).join(", ")})` : ""}`);
+			context.trace(`Copying asset(s): ${chalk.default.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : (0, _stryke_path_append.appendPath)(asset.glob, (0, _stryke_path_replace.replacePath)(asset.input, context.workspaceConfig.workspaceRoot)))} -> ${chalk.default.greenBright((0, _stryke_path_append.appendPath)(asset.glob, (0, _stryke_path_replace.replacePath)(asset.output, context.workspaceConfig.workspaceRoot)))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk.default.yellowBright(i)).join(", ")})` : ""}`);
 			await context.fs.copy(asset, asset.output);
 		}));
 		await this.callHook("build", {
@@ -3711,6 +3696,87 @@ Note: Please ensure the plugin package's default export is a class that extends
 			}
 		}
 	}
+	/**
+	* 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 #typegen(context) {
+		context.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
+		if (context.fs.existsSync(context.typegenPath)) await context.fs.remove(context.typegenPath);
+		if (!await (0, _stryke_fs_resolve.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 types = await emitBuiltinTypes(context, (await context.getBuiltins()).reduce((ret, builtin) => {
+			const formatted = (0, _stryke_path_replace.replacePath)(builtin.path, context.workspaceConfig.workspaceRoot);
+			if (!ret.includes(formatted)) ret.push(formatted);
+			return ret;
+		}, []));
+		context.debug(`Generating TypeScript declaration file ${context.typegenPath}.`);
+		const directives = [];
+		const asNextParam = (previousResult) => (0, _stryke_type_checks_is_object.isObject)(previousResult) ? previousResult.code : previousResult;
+		let result = await this.callHook("typegen", {
+			environment: context,
+			sequential: true,
+			order: "pre",
+			result: "merge",
+			asNextParam
+		}, types);
+		if (result) {
+			if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
+				types = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
+			} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) types = result;
+		}
+		result = await this.callHook("typegen", {
+			environment: context,
+			sequential: true,
+			order: "normal",
+			result: "merge",
+			asNextParam
+		}, types);
+		if (result) {
+			if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
+				types = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
+			} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) types = result;
+		}
+		result = await this.callHook("typegen", {
+			environment: context,
+			sequential: true,
+			order: "post",
+			result: "merge",
+			asNextParam
+		}, types);
+		if (result) {
+			if ((0, _stryke_type_checks_is_set_object.isSetObject)(result)) {
+				types = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
+			} else if ((0, _stryke_type_checks_is_set_string.isSetString)(result)) types = result;
+		}
+		if ((0, _stryke_type_checks_is_set_string.isSetString)(types?.trim()) || directives.length > 0) await context.fs.write(context.typegenPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+
+` : ""}${(0, require_utils.utils_exports.getTypescriptFileHeader)(context, {
+			directive: null,
+			prettierIgnore: false
+		})}
+
+${formatTypes(types)}
+`);
+		else {
+			const dtsRelativePath = getTsconfigDtsPath(context);
+			if (context.tsconfig.tsconfigJson.include && require_tsconfig.isIncludeMatchFound(dtsRelativePath, context.tsconfig.tsconfigJson.include)) {
+				const normalizedDtsRelativePath = dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath;
+				context.tsconfig.tsconfigJson.include = context.tsconfig.tsconfigJson.include.filter((includeValue) => includeValue?.toString() !== normalizedDtsRelativePath);
+				await context.fs.write(context.tsconfig.tsconfigFilePath, JSON.stringify(context.tsconfig.tsconfigJson, null, 2));
+			}
+		}
+		context.tsconfig = require_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

package/dist/{api-BAybLTQ1.mjs → api-fW_vtcef.mjs}

@@ -72,7 +72,7 @@ import { setParseImpl } from "unplugin";
 
 //#region package.json
 var name = "powerlines";
-var version = "0.41.23";
+var version = "0.42.1";
 
 //#endregion
 //#region src/_internal/helpers/generate-types.ts
@@ -3229,6 +3229,54 @@ var PowerlinesAPI = class PowerlinesAPI {
 		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 typegen command
+	*/
+	async typegen(inlineConfig = { command: "typegen" }) {
+		this.context.info(" 🏗️  Generating typescript declarations for the Powerlines project");
+		this.context.debug(" Aggregating configuration options for the Powerlines project");
+		inlineConfig.command ??= "typegen";
+		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.#typegen(context);
+			this.context.debug("Formatting files generated during the typegen step.");
+			await (0, utils_exports.format)(context, context.typegenPath, await context.fs.read(context.typegenPath) ?? "");
+			await writeMetaFile(context);
+			context.persistedMeta = context.meta;
+		});
+		this.context.debug("✔ Powerlines typegen has completed successfully");
+	}
+	/**
 	* Prepare the Powerlines API
 	*
 	* @remarks
@@ -3239,6 +3287,7 @@ var PowerlinesAPI = class PowerlinesAPI {
 	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.`);
@@ -3279,78 +3328,7 @@ var PowerlinesAPI = class PowerlinesAPI {
 				environment: context,
 				order: "post"
 			});
-			if (context.config.output.typegen !== false) {
-				context.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
-				if (context.fs.existsSync(context.typegenPath)) await context.fs.remove(context.typegenPath);
-				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 types = 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.typegenPath}.`);
-				const directives = [];
-				const asNextParam = (previousResult) => isObject(previousResult) ? previousResult.code : previousResult;
-				let result = await this.callHook("types", {
-					environment: context,
-					sequential: true,
-					order: "pre",
-					result: "merge",
-					asNextParam
-				}, types);
-				if (result) {
-					if (isSetObject(result)) {
-						types = result.code;
-						if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
-					} else if (isSetString(result)) types = result;
-				}
-				result = await this.callHook("types", {
-					environment: context,
-					sequential: true,
-					order: "normal",
-					result: "merge",
-					asNextParam
-				}, types);
-				if (result) {
-					if (isSetObject(result)) {
-						types = result.code;
-						if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
-					} else if (isSetString(result)) types = result;
-				}
-				result = await this.callHook("types", {
-					environment: context,
-					sequential: true,
-					order: "post",
-					result: "merge",
-					asNextParam
-				}, types);
-				if (result) {
-					if (isSetObject(result)) {
-						types = result.code;
-						if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
-					} else if (isSetString(result)) types = result;
-				}
-				if (isSetString(types?.trim()) || directives.length > 0) await context.fs.write(context.typegenPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
-
-` : ""}${(0, utils_exports.getTypescriptFileHeader)(context, {
-					directive: null,
-					prettierIgnore: false
-				})}
-
-${formatTypes(types)}
-`);
-				else {
-					const dtsRelativePath = getTsconfigDtsPath(context);
-					if (context.tsconfig.tsconfigJson.include && isIncludeMatchFound(dtsRelativePath, context.tsconfig.tsconfigJson.include)) {
-						const normalizedDtsRelativePath = dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath;
-						context.tsconfig.tsconfigJson.include = context.tsconfig.tsconfigJson.include.filter((includeValue) => includeValue?.toString() !== normalizedDtsRelativePath);
-						await context.fs.write(context.tsconfig.tsconfigFilePath, JSON.stringify(context.tsconfig.tsconfigJson, null, 2));
-					}
-				}
-			}
-			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.");
+			if (context.config.output.typegen !== false) await this.#typegen(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);
@@ -3369,6 +3347,7 @@ ${formatTypes(types)}
 	*/
 	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.");
@@ -3419,6 +3398,7 @@ ${formatTypes(types)}
 	*/
 	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.");
@@ -3439,6 +3419,7 @@ ${formatTypes(types)}
 	*/
 	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", {
@@ -3462,6 +3443,7 @@ ${formatTypes(types)}
 		await this.context.generateChecksum();
 		if (this.context.meta.checksum !== this.context.persistedMeta?.checksum || this.context.config.skipCache) {
 			this.context.info("The project has been modified since the last time `prepare` was ran. Re-preparing the project.");
+			inlineConfig.command ??= "build";
 			await this.prepare(inlineConfig);
 		}
 		if (this.context.config.singleBuild) await this.#handleBuild(await this.#context.toEnvironment());
@@ -3478,9 +3460,11 @@ ${formatTypes(types)}
 	*/
 	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 });
@@ -3498,6 +3482,7 @@ ${formatTypes(types)}
 	*/
 	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 });
@@ -3566,7 +3551,7 @@ ${formatTypes(types)}
 			}
 		}
 		await Promise.all(context.config.output.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(joinPaths(replacePath(asset.output, context.workspaceConfig.workspaceRoot), asset.glob))} ${Array.isArray(asset.ignore) && asset.ignore.length > 0 ? ` (ignoring: ${asset.ignore.map((i) => chalk.yellowBright(i)).join(", ")})` : ""}`);
+			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);
 		}));
 		await this.callHook("build", {
@@ -3708,8 +3693,89 @@ Note: Please ensure the plugin package's default export is a class that extends
 			}
 		}
 	}
+	/**
+	* 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 #typegen(context) {
+		context.debug(`Preparing the TypeScript definitions for the Powerlines project.`);
+		if (context.fs.existsSync(context.typegenPath)) await context.fs.remove(context.typegenPath);
+		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 types = 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.typegenPath}.`);
+		const directives = [];
+		const asNextParam = (previousResult) => isObject(previousResult) ? previousResult.code : previousResult;
+		let result = await this.callHook("typegen", {
+			environment: context,
+			sequential: true,
+			order: "pre",
+			result: "merge",
+			asNextParam
+		}, types);
+		if (result) {
+			if (isSetObject(result)) {
+				types = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
+			} else if (isSetString(result)) types = result;
+		}
+		result = await this.callHook("typegen", {
+			environment: context,
+			sequential: true,
+			order: "normal",
+			result: "merge",
+			asNextParam
+		}, types);
+		if (result) {
+			if (isSetObject(result)) {
+				types = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
+			} else if (isSetString(result)) types = result;
+		}
+		result = await this.callHook("typegen", {
+			environment: context,
+			sequential: true,
+			order: "post",
+			result: "merge",
+			asNextParam
+		}, types);
+		if (result) {
+			if (isSetObject(result)) {
+				types = result.code;
+				if (Array.isArray(result.directives) && result.directives.length > 0) directives.push(...result.directives);
+			} else if (isSetString(result)) types = result;
+		}
+		if (isSetString(types?.trim()) || directives.length > 0) await context.fs.write(context.typegenPath, `${directives.length > 0 ? `${directives.map((directive) => `/// <reference types="${directive}" />`).join("\n")}
+
+` : ""}${(0, utils_exports.getTypescriptFileHeader)(context, {
+			directive: null,
+			prettierIgnore: false
+		})}
+
+${formatTypes(types)}
+`);
+		else {
+			const dtsRelativePath = getTsconfigDtsPath(context);
+			if (context.tsconfig.tsconfigJson.include && isIncludeMatchFound(dtsRelativePath, context.tsconfig.tsconfigJson.include)) {
+				const normalizedDtsRelativePath = dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath;
+				context.tsconfig.tsconfigJson.include = context.tsconfig.tsconfigJson.include.filter((includeValue) => includeValue?.toString() !== normalizedDtsRelativePath);
+				await context.fs.write(context.tsconfig.tsconfigFilePath, JSON.stringify(context.tsconfig.tsconfigJson, null, 2));
+			}
+		}
+		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
 export { createUnpluginFactory as a, FileMetadata as c, FileSystem as d, _capnpFileId as f, createPluginContext as i, FileMetadata_KeyValuePair as l, version as m, PowerlinesAPIContext as n, PowerlinesContext as o, name as p, PowerlinesEnvironmentContext as r, FileId as s, PowerlinesAPI as t, FileStorage as u };
-//# sourceMappingURL=api-BAybLTQ1.mjs.map
+//# sourceMappingURL=api-fW_vtcef.mjs.map