@powerlines/plugin-webpack 0.5.132 → 0.5.134

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

@@ -0,0 +1,94 @@
+import { getParsedTypeScriptConfig, getTsconfigFilePath, isIncludeMatchFound } from "../../lib/typescript/tsconfig.mjs";
+import { LogLevelLabel } from "@storm-software/config-tools/types";
+import { joinPaths } from "@stryke/path/join-paths";
+import { isPackageExists } from "@stryke/fs/package-fns";
+import chalk from "chalk";
+import { getObjectDiff } from "@donedeal0/superdiff";
+import { readJsonFile } from "@stryke/fs/json";
+import { StormJSON } from "@stryke/json/storm-json";
+import { findFileName, findFilePath, relativePath } from "@stryke/path/file-path-fns";
+import { titleCase } from "@stryke/string-format/title-case";
+
+//#region ../powerlines/src/internal/helpers/resolve-tsconfig.ts
+function getTsconfigDtsPath(context) {
+	return joinPaths(relativePath(joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot), findFilePath(context.dtsPath)), findFileName(context.dtsPath));
+}
+async function resolveTsconfigChanges(context) {
+	const tsconfig = getParsedTypeScriptConfig(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig, context.config.tsconfigRaw);
+	const tsconfigJson = await readJsonFile(getTsconfigFilePath(context.workspaceConfig.workspaceRoot, context.config.projectRoot, context.config.tsconfig));
+	tsconfigJson.compilerOptions ??= {};
+	if (context.config.output.dts !== false) {
+		const dtsRelativePath = getTsconfigDtsPath(context);
+		if (!tsconfigJson.include?.some((filePattern) => isIncludeMatchFound(filePattern, [context.dtsPath, dtsRelativePath]))) {
+			tsconfigJson.include ??= [];
+			tsconfigJson.include.push(dtsRelativePath.startsWith("./") ? dtsRelativePath.slice(2) : dtsRelativePath);
+		}
+	}
+	if (!tsconfig.options.lib?.some((lib) => [
+		"lib.esnext.d.ts",
+		"lib.es2021.d.ts",
+		"lib.es2022.d.ts",
+		"lib.es2023.d.ts"
+	].includes(lib.toLowerCase()))) {
+		tsconfigJson.compilerOptions.lib ??= [];
+		tsconfigJson.compilerOptions.lib.push("esnext");
+	}
+	if (tsconfig.options.esModuleInterop !== true) tsconfigJson.compilerOptions.esModuleInterop = true;
+	if (tsconfig.options.isolatedModules !== true) tsconfigJson.compilerOptions.isolatedModules = true;
+	if (context.config.build.platform === "node") {
+		if (!tsconfig.options.types?.some((type) => type.toLowerCase() === "node" || type.toLowerCase() === "@types/node")) {
+			tsconfigJson.compilerOptions.types ??= [];
+			tsconfigJson.compilerOptions.types.push("node");
+		}
+	}
+	return tsconfigJson;
+}
+async function initializeTsconfig(context) {
+	context.log(LogLevelLabel.TRACE, "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.projectRoot, context.config.tsconfig);
+	context.tsconfig.originalTsconfigJson = await readJsonFile(tsconfigFilePath);
+	context.tsconfig.tsconfigJson = await resolveTsconfigChanges(context);
+	context.log(LogLevelLabel.TRACE, "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.projectRoot, 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.log(LogLevelLabel.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.projectRoot, context.config.tsconfig);
+	if (!context.tsconfig) throw new Error("Failed to parse the TypeScript configuration file.");
+}
+
+//#endregion
+export { getTsconfigDtsPath, initializeTsconfig, resolveTsconfig };

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

@@ -0,0 +1,43 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let jiti = require("jiti");
+
+//#region ../powerlines/src/internal/helpers/resolver.ts
+/**
+* Create a Jiti resolver for the given workspace and project root.
+*
+* @param options - The options for creating the resolver.
+* @returns A Jiti instance configured for the specified workspace and project root.
+*/
+function resolveOptions(options) {
+	return (0, defu.default)(options, {
+		interopDefault: true,
+		fsCache: options.mode !== "development" ? (0, __stryke_path_join_paths.joinPaths)(options.cacheDir, "jiti") : false,
+		moduleCache: options.mode !== "development"
+	});
+}
+/**
+* Create a Jiti resolver for the given workspace and project root.
+*
+* @param options - The options for creating the resolver.
+* @returns A Jiti instance configured for the specified workspace and project root.
+*/
+function createPluginResolver(options) {
+	return (0, jiti.createJiti)((0, __stryke_path_join_paths.joinPaths)(options.workspaceRoot, options.projectRoot), resolveOptions({ ...options }));
+}
+/**
+* Create a Jiti resolver for the given workspace and project root.
+*
+* @param options - The options for creating the resolver.
+* @returns A Jiti instance configured for the specified workspace and project root.
+*/
+function createResolver(options) {
+	const baseResolver = (0, jiti.createJiti)((0, __stryke_path_join_paths.joinPaths)(options.workspaceRoot, options.projectRoot), resolveOptions(options));
+	baseResolver.plugin = createPluginResolver(options);
+	return baseResolver;
+}
+
+//#endregion
+exports.createResolver = createResolver;

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

@@ -0,0 +1,41 @@
+import defu$1 from "defu";
+import { joinPaths } from "@stryke/path/join-paths";
+import { createJiti } from "jiti";
+
+//#region ../powerlines/src/internal/helpers/resolver.ts
+/**
+* Create a Jiti resolver for the given workspace and project root.
+*
+* @param options - The options for creating the resolver.
+* @returns A Jiti instance configured for the specified workspace and project root.
+*/
+function resolveOptions(options) {
+	return defu$1(options, {
+		interopDefault: true,
+		fsCache: options.mode !== "development" ? joinPaths(options.cacheDir, "jiti") : false,
+		moduleCache: options.mode !== "development"
+	});
+}
+/**
+* Create a Jiti resolver for the given workspace and project root.
+*
+* @param options - The options for creating the resolver.
+* @returns A Jiti instance configured for the specified workspace and project root.
+*/
+function createPluginResolver(options) {
+	return createJiti(joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions({ ...options }));
+}
+/**
+* Create a Jiti resolver for the given workspace and project root.
+*
+* @param options - The options for creating the resolver.
+* @returns A Jiti instance configured for the specified workspace and project root.
+*/
+function createResolver(options) {
+	const baseResolver = createJiti(joinPaths(options.workspaceRoot, options.projectRoot), resolveOptions(options));
+	baseResolver.plugin = createPluginResolver(options);
+	return baseResolver;
+}
+
+//#endregion
+export { createResolver };

package/dist/powerlines/src/lib/build/webpack.cjs

@@ -0,0 +1,47 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_helpers_omit = require("@stryke/helpers/omit");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+
+//#region ../powerlines/src/lib/build/webpack.ts
+/**
+* Resolves the options for [webpack](https://webpack.js.org/).
+*
+* @param context - The build context.
+* @returns The resolved options.
+*/
+function extractWebpackConfig(context) {
+	return (0, defu.default)({ resolve: { alias: context.builtins.reduce((ret, id) => {
+		if (!ret[id]) {
+			const path = context.fs.ids[id];
+			if (path) ret[id] = path;
+		}
+		return ret;
+	}, context.config.build.alias ? Array.isArray(context.config.build.alias) ? context.config.build.alias.reduce((ret, alias) => {
+		if (!ret[alias.find.toString()]) ret[alias.find.toString()] = alias.replacement;
+		return ret;
+	}, {}) : context.config.build.alias : {}) } }, context.config.build.variant === "webpack" ? context.config.build.override : {}, context.config.build.variant === "webpack" ? (0, __stryke_helpers_omit.omit)(context.config.build, ["override", "variant"]) : {}, {
+		output: { path: (0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.output.buildPath) },
+		name: context.config.name,
+		node: context.config.build.platform === "node" ? {
+			__dirname: true,
+			__filename: true,
+			global: true
+		} : false,
+		mode: context.config.mode === "development" ? "development" : "production",
+		cache: {
+			type: "filesystem",
+			cacheDirectory: (0, __stryke_path_join_paths.joinPaths)(context.cachePath, "webpack", "cache")
+		},
+		recordsInputPath: (0, __stryke_path_join_paths.joinPaths)(context.cachePath, "webpack", ".webpack-records.json"),
+		recordsOutputPath: (0, __stryke_path_join_paths.joinPaths)(context.cachePath, "webpack", ".webpack-records.json"),
+		context: (0, __stryke_path_join_paths.joinPaths)(context.workspaceConfig.workspaceRoot, context.config.projectRoot),
+		noExternal: context.builtins,
+		devtool: context.config.mode !== "development" ? false : "source-map",
+		optimization: { minimize: context.config.mode !== "development" }
+	});
+}
+
+//#endregion
+exports.extractWebpackConfig = extractWebpackConfig;

package/dist/powerlines/src/lib/build/webpack.mjs

@@ -0,0 +1,45 @@
+import defu$1 from "defu";
+import { omit } from "@stryke/helpers/omit";
+import { joinPaths } from "@stryke/path/join-paths";
+
+//#region ../powerlines/src/lib/build/webpack.ts
+/**
+* Resolves the options for [webpack](https://webpack.js.org/).
+*
+* @param context - The build context.
+* @returns The resolved options.
+*/
+function extractWebpackConfig(context) {
+	return defu$1({ resolve: { alias: context.builtins.reduce((ret, id) => {
+		if (!ret[id]) {
+			const path = context.fs.ids[id];
+			if (path) ret[id] = path;
+		}
+		return ret;
+	}, context.config.build.alias ? Array.isArray(context.config.build.alias) ? context.config.build.alias.reduce((ret, alias) => {
+		if (!ret[alias.find.toString()]) ret[alias.find.toString()] = alias.replacement;
+		return ret;
+	}, {}) : context.config.build.alias : {}) } }, context.config.build.variant === "webpack" ? context.config.build.override : {}, context.config.build.variant === "webpack" ? omit(context.config.build, ["override", "variant"]) : {}, {
+		output: { path: joinPaths(context.workspaceConfig.workspaceRoot, context.config.output.buildPath) },
+		name: context.config.name,
+		node: context.config.build.platform === "node" ? {
+			__dirname: true,
+			__filename: true,
+			global: true
+		} : false,
+		mode: context.config.mode === "development" ? "development" : "production",
+		cache: {
+			type: "filesystem",
+			cacheDirectory: joinPaths(context.cachePath, "webpack", "cache")
+		},
+		recordsInputPath: joinPaths(context.cachePath, "webpack", ".webpack-records.json"),
+		recordsOutputPath: joinPaths(context.cachePath, "webpack", ".webpack-records.json"),
+		context: joinPaths(context.workspaceConfig.workspaceRoot, context.config.projectRoot),
+		noExternal: context.builtins,
+		devtool: context.config.mode !== "development" ? false : "source-map",
+		optimization: { minimize: context.config.mode !== "development" }
+	});
+}
+
+//#endregion
+export { extractWebpackConfig };

package/dist/powerlines/src/lib/config-file.cjs

@@ -0,0 +1,79 @@
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_path_append = require("@stryke/path/append");
+let __stryke_path_replace = require("@stryke/path/replace");
+let __stryke_type_checks_is_function = require("@stryke/type-checks/is-function");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_fs_exists = require("@stryke/fs/exists");
+let __storm_software_config_tools_get_config = require("@storm-software/config-tools/get-config");
+let c12 = require("c12");
+
+//#region ../powerlines/src/lib/config-file.ts
+/**
+* Loads the workspace configuration.
+*
+* @param workspaceRoot - The root directory of the workspace.
+* @param cwd - The current working directory to start searching from.
+* @returns A promise that resolves to the loaded workspace configuration.
+*/
+async function loadWorkspaceConfig(workspaceRoot, cwd) {
+	return (0, defu.default)({ workspaceRoot }, await (0, __storm_software_config_tools_get_config.getWorkspaceConfig)(true, {
+		cwd,
+		workspaceRoot,
+		useDefault: true
+	}));
+}
+/**
+* Loads the user configuration file for the project.
+*
+* @param projectRoot - The root directory of the project.
+* @param workspaceRoot - The root directory of the workspace.
+* @param jiti - An instance of Jiti to resolve modules from
+* @param command - The {@link PowerlinesCommand} string associated with the current running process
+* @param mode - The mode in which the project is running (default is "production").
+* @param configFile - An optional path to a specific configuration file.
+* @param framework - The framework name to use for default configuration file names.
+* @returns A promise that resolves to the resolved user configuration.
+*/
+async function loadUserConfigFile(projectRoot, workspaceRoot, jiti, command, mode = "production", configFile, framework = "powerlines") {
+	let resolvedUserConfig = {};
+	let resolvedUserConfigFile;
+	if (configFile) resolvedUserConfigFile = (0, __stryke_fs_exists.existsSync)((0, __stryke_path_replace.replacePath)(configFile, projectRoot)) ? (0, __stryke_path_replace.replacePath)(configFile, projectRoot) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), (0, __stryke_path_replace.replacePath)(configFile, projectRoot))) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), (0, __stryke_path_replace.replacePath)(configFile, projectRoot)) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), configFile)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), configFile) : void 0;
+	if (!resolvedUserConfigFile) resolvedUserConfigFile = (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.ts`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.ts`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.js`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.js`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.mts`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.mts`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.mjs`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.${mode}.config.mjs`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.ts`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.ts`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.js`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.js`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.mts`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.mts`) : (0, __stryke_fs_exists.existsSync)((0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.mjs`)) ? (0, __stryke_path_join_paths.joinPaths)((0, __stryke_path_append.appendPath)(projectRoot, workspaceRoot), `${framework}.config.mjs`) : void 0;
+	if (resolvedUserConfigFile) {
+		const resolved = await jiti.import(jiti.esmResolve(resolvedUserConfigFile));
+		if (resolved) {
+			let config = {};
+			if ((0, __stryke_type_checks_is_function.isFunction)(resolved)) config = await Promise.resolve(resolved({
+				command,
+				mode,
+				isSsrBuild: false,
+				isPreview: false
+			}));
+			if ((0, __stryke_type_checks_is_set_object.isSetObject)(config)) resolvedUserConfig = {
+				...config,
+				config,
+				configFile: resolvedUserConfigFile
+			};
+		}
+	}
+	const result = await (0, c12.loadConfig)({
+		cwd: projectRoot,
+		name: framework,
+		envName: mode,
+		globalRc: true,
+		packageJson: true,
+		dotenv: true,
+		jiti
+	});
+	return (0, defu.default)(resolvedUserConfig, (0, __stryke_type_checks_is_set_object.isSetObject)(result?.config) ? {
+		...result.config,
+		...result
+	} : {});
+}
+
+//#endregion
+exports.loadUserConfigFile = loadUserConfigFile;
+exports.loadWorkspaceConfig = loadWorkspaceConfig;

package/dist/powerlines/src/lib/config-file.mjs

@@ -0,0 +1,76 @@
+import defu$1 from "defu";
+import { joinPaths } from "@stryke/path/join-paths";
+import { appendPath } from "@stryke/path/append";
+import { replacePath } from "@stryke/path/replace";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { existsSync } from "@stryke/fs/exists";
+import { getWorkspaceConfig } from "@storm-software/config-tools/get-config";
+import { loadConfig } from "c12";
+
+//#region ../powerlines/src/lib/config-file.ts
+/**
+* Loads the workspace configuration.
+*
+* @param workspaceRoot - The root directory of the workspace.
+* @param cwd - The current working directory to start searching from.
+* @returns A promise that resolves to the loaded workspace configuration.
+*/
+async function loadWorkspaceConfig(workspaceRoot, cwd) {
+	return defu$1({ workspaceRoot }, await getWorkspaceConfig(true, {
+		cwd,
+		workspaceRoot,
+		useDefault: true
+	}));
+}
+/**
+* Loads the user configuration file for the project.
+*
+* @param projectRoot - The root directory of the project.
+* @param workspaceRoot - The root directory of the workspace.
+* @param jiti - An instance of Jiti to resolve modules from
+* @param command - The {@link PowerlinesCommand} string associated with the current running process
+* @param mode - The mode in which the project is running (default is "production").
+* @param configFile - An optional path to a specific configuration file.
+* @param framework - The framework name to use for default configuration file names.
+* @returns A promise that resolves to the resolved user configuration.
+*/
+async function loadUserConfigFile(projectRoot, workspaceRoot, jiti, command, mode = "production", configFile, framework = "powerlines") {
+	let resolvedUserConfig = {};
+	let resolvedUserConfigFile;
+	if (configFile) resolvedUserConfigFile = existsSync(replacePath(configFile, projectRoot)) ? replacePath(configFile, projectRoot) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), replacePath(configFile, projectRoot))) ? joinPaths(appendPath(projectRoot, workspaceRoot), replacePath(configFile, projectRoot)) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), configFile)) ? joinPaths(appendPath(projectRoot, workspaceRoot), configFile) : void 0;
+	if (!resolvedUserConfigFile) resolvedUserConfigFile = existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.ts`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.ts`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.js`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.js`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.mts`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.mts`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.mjs`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.${mode}.config.mjs`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.ts`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.ts`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.js`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.js`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.mts`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.mts`) : existsSync(joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.mjs`)) ? joinPaths(appendPath(projectRoot, workspaceRoot), `${framework}.config.mjs`) : void 0;
+	if (resolvedUserConfigFile) {
+		const resolved = await jiti.import(jiti.esmResolve(resolvedUserConfigFile));
+		if (resolved) {
+			let config = {};
+			if (isFunction(resolved)) config = await Promise.resolve(resolved({
+				command,
+				mode,
+				isSsrBuild: false,
+				isPreview: false
+			}));
+			if (isSetObject(config)) resolvedUserConfig = {
+				...config,
+				config,
+				configFile: resolvedUserConfigFile
+			};
+		}
+	}
+	const result = await loadConfig({
+		cwd: projectRoot,
+		name: framework,
+		envName: mode,
+		globalRc: true,
+		packageJson: true,
+		dotenv: true,
+		jiti
+	});
+	return defu$1(resolvedUserConfig, isSetObject(result?.config) ? {
+		...result.config,
+		...result
+	} : {});
+}
+
+//#endregion
+export { loadUserConfigFile, loadWorkspaceConfig };

package/dist/powerlines/src/lib/contexts/api-context.cjs

@@ -0,0 +1,184 @@
+const require_rolldown_runtime = require('../../../../_virtual/rolldown_runtime.cjs');
+const require_environment = require('../../internal/helpers/environment.cjs');
+const require_config_file = require('../config-file.cjs');
+const require_context = require('./context.cjs');
+const require_environment_context = require('./environment-context.cjs');
+let __storm_software_config_tools_types = require("@storm-software/config-tools/types");
+let __stryke_convert_to_array = require("@stryke/convert/to-array");
+let __stryke_fs_resolve = require("@stryke/fs/resolve");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let chalk = require("chalk");
+chalk = require_rolldown_runtime.__toESM(chalk);
+
+//#region ../powerlines/src/lib/contexts/api-context.ts
+var PowerlinesAPIContext = class PowerlinesAPIContext extends require_context.PowerlinesContext {
+	#environments = {};
+	#plugins = [];
+	#log;
+	/**
+	* Create a new Storm context from the workspace root and user config.
+	*
+	* @param workspaceRoot - The root directory of the workspace.
+	* @param config - The user configuration options.
+	* @returns A promise that resolves to the new context.
+	*/
+	static async from(workspaceRoot, config) {
+		const context = new PowerlinesAPIContext(await require_config_file.loadWorkspaceConfig(workspaceRoot, config.root));
+		await context.withUserConfig(config);
+		const powerlinesPath = await (0, __stryke_fs_resolve.resolvePackage)("powerlines");
+		if (!powerlinesPath) throw new Error("Could not resolve `powerlines` package location.");
+		context.powerlinesPath = powerlinesPath;
+		return context;
+	}
+	/**
+	* Internal context fields and methods
+	*
+	* @danger
+	* This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*
+	* @internal
+	*/
+	get $$internal() {
+		return super.$$internal;
+	}
+	/**
+	* Internal context fields and methods
+	*
+	* @danger
+	* This field is for internal use only and should not be accessed or modified directly. It is unstable and can be changed at anytime.
+	*
+	* @internal
+	*/
+	set $$internal(value) {
+		super.$$internal = value;
+		for (const environment of Object.values(this.environments)) environment.$$internal = super.$$internal;
+	}
+	/**
+	* A record of all environments by name
+	*/
+	get environments() {
+		return this.#environments;
+	}
+	get log() {
+		if (!this.#log) this.#log = this.createLog();
+		return this.#log;
+	}
+	get plugins() {
+		return this.#plugins;
+	}
+	constructor(workspaceConfig) {
+		super(workspaceConfig);
+	}
+	/**
+	* Initialize the context with the provided configuration options
+	*
+	* @param config - The partial user configuration to use for initialization.
+	*/
+	async init(config = {}) {
+		await super.init(config);
+		await Promise.all((0, __stryke_convert_to_array.toArray)(this.config.userConfig.environments && Object.keys(this.config.userConfig.environments).length > 0 ? Object.keys(this.config.userConfig.environments).map((name) => require_environment.createEnvironment(name, this.config.userConfig)) : require_environment.createDefaultEnvironment(this.config.userConfig)).map(async (env) => {
+			this.#environments[env.name] = await this.in(env);
+		}));
+	}
+	/**
+	* A function to copy the context and update the fields for a specific environment
+	*
+	* @param environment - The environment configuration to use.
+	* @returns A new context instance with the updated environment.
+	*/
+	async in(environment) {
+		let context;
+		if (this.environments[environment.name]) context = this.environments[environment.name];
+		else context = await require_environment_context.PowerlinesEnvironmentContext.fromConfig(this.workspaceConfig, this.config);
+		if ((0, __stryke_type_checks_is_set_object.isSetObject)(this.config.inlineConfig)) await context.withInlineConfig(this.config.inlineConfig);
+		context.environment = environment;
+		context.plugins = [];
+		for (const plugin of this.plugins) await context.addPlugin(plugin);
+		return context;
+	}
+	/**
+	* Update the context using a new user configuration options
+	*
+	* @param userConfig - The new user configuration options.
+	*/
+	async withUserConfig(userConfig, options = { isHighPriority: true }) {
+		await super.withUserConfig(userConfig, options);
+		await Promise.all(Object.keys(this.#environments).map(async (name) => {
+			await this.#environments[name].withUserConfig(userConfig, options);
+		}));
+	}
+	/**
+	* Update the context using a new inline configuration options
+	*
+	* @param inlineConfig - The new inline configuration options.
+	*/
+	async withInlineConfig(inlineConfig, options = { isHighPriority: true }) {
+		await super.withInlineConfig(inlineConfig, options);
+		await Promise.all(Object.keys(this.#environments).map(async (name) => {
+			await this.#environments[name].withInlineConfig(inlineConfig, options);
+		}));
+	}
+	/**
+	* Add a plugin to the API context and all environments
+	*
+	* @param plugin - The plugin to add.
+	*/
+	async addPlugin(plugin) {
+		this.plugins.push(plugin);
+		await Promise.all(Object.keys(this.environments).map(async (name) => {
+			await this.environments[name].addPlugin(plugin);
+		}));
+	}
+	/**
+	* Get an environment by name, or the default environment if no name is provided
+	*
+	* @param name - The name of the environment to retrieve.
+	* @returns The requested environment context.
+	*/
+	async getEnvironment(name) {
+		let environment;
+		if (name) environment = this.environments[name];
+		if (Object.keys(this.environments).length === 1) {
+			environment = this.environments[Object.keys(this.environments)[0]];
+			this.log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Applying the only configured environment: ${chalk.default.bold.cyanBright(environment?.environment.name)}`);
+		}
+		if (!environment) {
+			if (name) throw new Error(`Environment "${name}" not found.`);
+			environment = await this.in(require_environment.createDefaultEnvironment(this.config.userConfig));
+			this.log(__storm_software_config_tools_types.LogLevelLabel.WARN, `No environment specified, and no default environment found. Using a temporary default environment: ${chalk.default.bold.cyanBright(environment?.environment.name)}`);
+		}
+		return environment;
+	}
+	/**
+	* A safe version of `getEnvironment` that returns `undefined` if the environment is not found
+	*
+	* @param name - The name of the environment to retrieve.
+	* @returns The requested environment context or `undefined` if not found.
+	*/
+	async getEnvironmentSafe(name) {
+		try {
+			return await this.getEnvironment(name);
+		} catch {
+			return;
+		}
+	}
+	/**
+	* A function to merge all configured environments into a single context.
+	*
+	* @remarks
+	* If only one environment is configured, that environment will be returned directly.
+	*
+	* @returns A promise that resolves to a merged/global environment context.
+	*/
+	async toEnvironment() {
+		let environment;
+		if (Object.keys(this.environments).length > 1) {
+			environment = await this.in(require_environment.createEnvironment(require_environment.GLOBAL_ENVIRONMENT, this.config.userConfig));
+			this.log(__storm_software_config_tools_types.LogLevelLabel.DEBUG, `Combined all ${Object.keys(this.environments).length} environments into a single global context.`);
+		} else environment = await this.getEnvironment();
+		return environment;
+	}
+};
+
+//#endregion
+exports.PowerlinesAPIContext = PowerlinesAPIContext;