powerlines 0.41.20 → 0.42.0

package/dist/{api-DSbiwkgX.cjs → api-BGV1CwNT.cjs}

@@ -76,7 +76,7 @@ let unplugin = require("unplugin");
 
 //#region package.json
 var name = "powerlines";
-var version = "0.41.20";
+var version = "0.42.0";
 
 //#endregion
 //#region src/_internal/helpers/generate-types.ts
@@ -1170,8 +1170,8 @@ var VirtualFileSystem = class VirtualFileSystem {
 			...this.#context.config.output.storage
 		};
 		this.#storage.virtual ??= new require_virtual.VirtualStorageAdapter(context, { base: "/_virtual" });
-		this.#storage[this.#context.config.output.outputPath] ??= new require_virtual.FileSystemStorageAdapter(context, { base: this.#context.config.output.outputPath });
-		this.#storage[this.#context.config.output.buildPath] ??= new require_virtual.FileSystemStorageAdapter(context, { base: this.#context.config.output.buildPath });
+		this.#storage[this.#context.config.output.publishPath] ??= new require_virtual.FileSystemStorageAdapter(context, { base: this.#context.config.output.publishPath });
+		this.#storage[this.#context.config.output.path] ??= new require_virtual.FileSystemStorageAdapter(context, { base: this.#context.config.output.path });
 		if (this.#context.config.output.storage !== "fs") {
 			this.#storage[this.#context.artifactsPath] ??= new require_virtual.VirtualStorageAdapter(context, { base: this.#context.artifactsPath });
 			this.#storage[this.#context.builtinsPath] ??= new require_virtual.VirtualStorageAdapter(context, { base: this.#context.builtinsPath });
@@ -2576,7 +2576,7 @@ var PowerlinesContext = class PowerlinesContext {
 			version: this.packageJson?.version,
 			description: this.packageJson?.description,
 			output: (0, require_plugin_utils.plugin_utils_exports.mergeConfig)(config.output ?? {}, {
-				outputPath: cacheKey.root ? (0, _stryke_path_join.joinPaths)(this.workspaceConfig?.directories?.build || "dist", cacheKey.root) : this.workspaceConfig?.directories?.build || "dist",
+				publishPath: cacheKey.root ? (0, _stryke_path_join.joinPaths)(this.workspaceConfig?.directories?.build || "dist", cacheKey.root) : this.workspaceConfig?.directories?.build || "dist",
 				artifactsPath: `.${config.framework ?? "powerlines"}`,
 				dts: true,
 				typegen: (0, _stryke_path_join.joinPaths)(cacheKey.root, `${config.framework ?? "powerlines"}.d.ts`),
@@ -2615,17 +2615,17 @@ var PowerlinesContext = class PowerlinesContext {
 		this.config.output.format = (0, _stryke_helpers_get_unique.getUnique)((0, _stryke_convert_to_array.toArray)(this.config.output?.format ?? (this.config.projectType === "library" ? ["cjs", "esm"] : ["esm"])));
 		if (this.config.output.dts !== false && !this.config.output.typegen) this.config.output.typegen = `${this.config.root ? `${this.config.root}/` : ""}${this.config.framework ?? "powerlines"}.d.ts`;
 		if (this.config.root && this.config.root !== "." && this.config.root !== "./" && this.config.root !== this.workspaceConfig.workspaceRoot) {
-			this.config.output.outputPath ??= (0, _stryke_path_join.joinPaths)("dist", this.config.root);
-			this.config.output.buildPath ??= (0, _stryke_path_join.joinPaths)(this.config.root, "dist");
+			this.config.output.path ??= (0, _stryke_path_join.joinPaths)(this.config.root, "dist");
+			this.config.output.publishPath ??= (0, _stryke_path_join.joinPaths)("dist", this.config.root);
 		} else {
-			this.config.output.outputPath ??= "dist";
-			this.config.output.buildPath ??= "dist";
+			this.config.output.path ??= "dist";
+			this.config.output.publishPath ??= this.config.output.path;
 		}
 		this.config.output.assets = (0, _stryke_helpers_get_unique.getUniqueBy)(this.config.output.assets.map((asset) => {
 			return {
 				glob: (0, _stryke_type_checks_is_set_object.isSetObject)(asset) ? asset.glob : asset,
 				input: (0, _stryke_type_checks_is_string.isString)(asset) || !asset.input || asset.input === "." || asset.input === "/" || asset.input === "./" ? this.workspaceConfig.workspaceRoot : (0, _stryke_path_is_parent_path.isParentPath)(asset.input, this.workspaceConfig.workspaceRoot) || asset.input === this.workspaceConfig.workspaceRoot ? asset.input : (0, _stryke_path_append.appendPath)(asset.input, this.workspaceConfig.workspaceRoot),
-				output: (0, _stryke_type_checks_is_set_object.isSetObject)(asset) && asset.output ? (0, _stryke_path_is_parent_path.isParentPath)(asset.output, this.workspaceConfig.workspaceRoot) ? asset.output : (0, _stryke_path_append.appendPath)((0, _stryke_path_join.joinPaths)(this.config.output.outputPath, (0, _stryke_path_replace.replacePath)((0, _stryke_path_replace.replacePath)(asset.output, (0, _stryke_path_replace.replacePath)(this.config.output.outputPath, this.workspaceConfig.workspaceRoot)), this.config.output.outputPath)), this.workspaceConfig.workspaceRoot) : (0, _stryke_path_append.appendPath)(this.config.output.outputPath, this.workspaceConfig.workspaceRoot),
+				output: (0, _stryke_type_checks_is_set_object.isSetObject)(asset) && asset.output ? (0, _stryke_path_is_parent_path.isParentPath)(asset.output, this.workspaceConfig.workspaceRoot) ? asset.output : (0, _stryke_path_append.appendPath)((0, _stryke_path_join.joinPaths)(this.config.output.publishPath, (0, _stryke_path_replace.replacePath)((0, _stryke_path_replace.replacePath)(asset.output, (0, _stryke_path_replace.replacePath)(this.config.output.publishPath, this.workspaceConfig.workspaceRoot)), this.config.output.publishPath)), this.workspaceConfig.workspaceRoot) : (0, _stryke_path_append.appendPath)(this.config.output.publishPath, this.workspaceConfig.workspaceRoot),
 				ignore: (0, _stryke_type_checks_is_set_object.isSetObject)(asset) && asset.ignore ? (0, _stryke_convert_to_array.toArray)(asset.ignore) : void 0
 			};
 		}), (a) => `${a.input}-${a.glob}-${a.output}`);
@@ -3232,6 +3232,53 @@ 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: "prepare" }) {
+		this.context.info(" 🏗️  Generating typescript declarations for the Powerlines project");
+		this.context.debug(" Aggregating configuration options for the Powerlines project");
+		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
@@ -3282,78 +3329,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);
@@ -3425,7 +3401,7 @@ ${formatTypes(types)}
 		await this.prepare(inlineConfig);
 		await this.#executeEnvironments(async (context) => {
 			context.debug("Cleaning the project's dist and artifacts directories.");
-			await context.fs.remove((0, _stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.output.buildPath));
+			await context.fs.remove((0, _stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.output.path));
 			await context.fs.remove((0, _stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.root, context.config.output.artifactsPath));
 			await this.callHook("clean", {
 				environment: context,
@@ -3560,16 +3536,16 @@ ${formatTypes(types)}
 			environment: context,
 			order: "normal"
 		});
-		if (context.config.output.buildPath !== context.config.output.outputPath) {
-			const sourcePath = (0, _stryke_path_append.appendPath)(context.config.output.buildPath, context.workspaceConfig.workspaceRoot);
-			const destinationPath = (0, _stryke_path_join_paths.joinPaths)((0, _stryke_path_append.appendPath)(context.config.output.outputPath, context.workspaceConfig.workspaceRoot), "dist");
+		if (context.config.output.path !== context.config.output.publishPath) {
+			const sourcePath = (0, _stryke_path_append.appendPath)(context.config.output.path, context.workspaceConfig.workspaceRoot);
+			const destinationPath = (0, _stryke_path_join_paths.joinPaths)((0, _stryke_path_append.appendPath)(context.config.output.publishPath, context.workspaceConfig.workspaceRoot), "dist");
 			if (context.fs.existsSync(sourcePath) && sourcePath !== destinationPath) {
-				context.debug(`Copying build output files from project's build directory (${context.config.output.buildPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
+				context.debug(`Copying output files from project's output directory (${context.config.output.path}) to the publish output directory (${context.config.output.publishPath}).`);
 				await context.fs.copy(sourcePath, destinationPath);
 			}
 		}
 		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_join_paths.joinPaths)((0, _stryke_path_replace.replacePath)(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${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 +3687,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-D2cw-NSF.mjs → api-Cq6oqcq8.mjs}

@@ -72,7 +72,7 @@ import { setParseImpl } from "unplugin";
 
 //#region package.json
 var name = "powerlines";
-var version = "0.41.20";
+var version = "0.42.0";
 
 //#endregion
 //#region src/_internal/helpers/generate-types.ts
@@ -1166,8 +1166,8 @@ var VirtualFileSystem = class VirtualFileSystem {
 			...this.#context.config.output.storage
 		};
 		this.#storage.virtual ??= new VirtualStorageAdapter(context, { base: "/_virtual" });
-		this.#storage[this.#context.config.output.outputPath] ??= new FileSystemStorageAdapter(context, { base: this.#context.config.output.outputPath });
-		this.#storage[this.#context.config.output.buildPath] ??= new FileSystemStorageAdapter(context, { base: this.#context.config.output.buildPath });
+		this.#storage[this.#context.config.output.publishPath] ??= new FileSystemStorageAdapter(context, { base: this.#context.config.output.publishPath });
+		this.#storage[this.#context.config.output.path] ??= new FileSystemStorageAdapter(context, { base: this.#context.config.output.path });
 		if (this.#context.config.output.storage !== "fs") {
 			this.#storage[this.#context.artifactsPath] ??= new VirtualStorageAdapter(context, { base: this.#context.artifactsPath });
 			this.#storage[this.#context.builtinsPath] ??= new VirtualStorageAdapter(context, { base: this.#context.builtinsPath });
@@ -2572,7 +2572,7 @@ var PowerlinesContext = class PowerlinesContext {
 			version: this.packageJson?.version,
 			description: this.packageJson?.description,
 			output: (0, plugin_utils_exports.mergeConfig)(config.output ?? {}, {
-				outputPath: cacheKey.root ? joinPaths$1(this.workspaceConfig?.directories?.build || "dist", cacheKey.root) : this.workspaceConfig?.directories?.build || "dist",
+				publishPath: cacheKey.root ? joinPaths$1(this.workspaceConfig?.directories?.build || "dist", cacheKey.root) : this.workspaceConfig?.directories?.build || "dist",
 				artifactsPath: `.${config.framework ?? "powerlines"}`,
 				dts: true,
 				typegen: joinPaths$1(cacheKey.root, `${config.framework ?? "powerlines"}.d.ts`),
@@ -2611,17 +2611,17 @@ var PowerlinesContext = class PowerlinesContext {
 		this.config.output.format = getUnique(toArray(this.config.output?.format ?? (this.config.projectType === "library" ? ["cjs", "esm"] : ["esm"])));
 		if (this.config.output.dts !== false && !this.config.output.typegen) this.config.output.typegen = `${this.config.root ? `${this.config.root}/` : ""}${this.config.framework ?? "powerlines"}.d.ts`;
 		if (this.config.root && this.config.root !== "." && this.config.root !== "./" && this.config.root !== this.workspaceConfig.workspaceRoot) {
-			this.config.output.outputPath ??= joinPaths$1("dist", this.config.root);
-			this.config.output.buildPath ??= joinPaths$1(this.config.root, "dist");
+			this.config.output.path ??= joinPaths$1(this.config.root, "dist");
+			this.config.output.publishPath ??= joinPaths$1("dist", this.config.root);
 		} else {
-			this.config.output.outputPath ??= "dist";
-			this.config.output.buildPath ??= "dist";
+			this.config.output.path ??= "dist";
+			this.config.output.publishPath ??= this.config.output.path;
 		}
 		this.config.output.assets = getUniqueBy(this.config.output.assets.map((asset) => {
 			return {
 				glob: isSetObject(asset) ? asset.glob : asset,
 				input: isString(asset) || !asset.input || asset.input === "." || asset.input === "/" || asset.input === "./" ? this.workspaceConfig.workspaceRoot : isParentPath(asset.input, this.workspaceConfig.workspaceRoot) || asset.input === this.workspaceConfig.workspaceRoot ? asset.input : appendPath(asset.input, this.workspaceConfig.workspaceRoot),
-				output: isSetObject(asset) && asset.output ? isParentPath(asset.output, this.workspaceConfig.workspaceRoot) ? asset.output : appendPath(joinPaths$1(this.config.output.outputPath, replacePath(replacePath(asset.output, replacePath(this.config.output.outputPath, this.workspaceConfig.workspaceRoot)), this.config.output.outputPath)), this.workspaceConfig.workspaceRoot) : appendPath(this.config.output.outputPath, this.workspaceConfig.workspaceRoot),
+				output: isSetObject(asset) && asset.output ? isParentPath(asset.output, this.workspaceConfig.workspaceRoot) ? asset.output : appendPath(joinPaths$1(this.config.output.publishPath, replacePath(replacePath(asset.output, replacePath(this.config.output.publishPath, this.workspaceConfig.workspaceRoot)), this.config.output.publishPath)), this.workspaceConfig.workspaceRoot) : appendPath(this.config.output.publishPath, this.workspaceConfig.workspaceRoot),
 				ignore: isSetObject(asset) && asset.ignore ? toArray(asset.ignore) : void 0
 			};
 		}), (a) => `${a.input}-${a.glob}-${a.output}`);
@@ -3229,6 +3229,53 @@ 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: "prepare" }) {
+		this.context.info(" 🏗️  Generating typescript declarations for the Powerlines project");
+		this.context.debug(" Aggregating configuration options for the Powerlines project");
+		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
@@ -3279,78 +3326,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);
@@ -3422,7 +3398,7 @@ ${formatTypes(types)}
 		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.buildPath));
+			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,
@@ -3557,16 +3533,16 @@ ${formatTypes(types)}
 			environment: context,
 			order: "normal"
 		});
-		if (context.config.output.buildPath !== context.config.output.outputPath) {
-			const sourcePath = appendPath(context.config.output.buildPath, context.workspaceConfig.workspaceRoot);
-			const destinationPath = joinPaths(appendPath(context.config.output.outputPath, context.workspaceConfig.workspaceRoot), "dist");
+		if (context.config.output.path !== context.config.output.publishPath) {
+			const sourcePath = appendPath(context.config.output.path, context.workspaceConfig.workspaceRoot);
+			const destinationPath = joinPaths(appendPath(context.config.output.publishPath, context.workspaceConfig.workspaceRoot), "dist");
 			if (context.fs.existsSync(sourcePath) && sourcePath !== destinationPath) {
-				context.debug(`Copying build output files from project's build directory (${context.config.output.buildPath}) to the workspace's output directory (${context.config.output.outputPath}).`);
+				context.debug(`Copying output files from project's output directory (${context.config.output.path}) to the publish output directory (${context.config.output.publishPath}).`);
 				await context.fs.copy(sourcePath, destinationPath);
 			}
 		}
 		await Promise.all(context.config.output.assets.map(async (asset) => {
-			context.trace(`Copying asset(s): ${chalk.redBright(context.workspaceConfig.workspaceRoot === asset.input ? asset.glob : joinPaths(replacePath(asset.input, context.workspaceConfig.workspaceRoot), asset.glob))} -> ${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 +3684,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-D2cw-NSF.mjs.map
+//# sourceMappingURL=api-Cq6oqcq8.mjs.map