@powerlines/core 0.14.5 → 0.15.1

package/dist/context/context.mjs

@@ -0,0 +1,932 @@
+import { DEFAULT_DEVELOPMENT_LOG_LEVEL, DEFAULT_PRODUCTION_LOG_LEVEL, DEFAULT_TEST_LOG_LEVEL } from "../constants/log-level.mjs";
+import { createLogger, resolveLogLevel } from "../plugin-utils/logging.mjs";
+import { createResolver } from "../lib/resolver.mjs";
+import { getDefaultMode, loadParsedConfig, resolvePackageConfigs } from "../lib/config.mjs";
+import { isDuplicate, isPlugin } from "../plugin-utils/helpers.mjs";
+import { mergeConfig } from "../plugin-utils/merge.mjs";
+import { getPackageJsonOrganization, getWorkspaceName } from "../plugin-utils/context-helpers.mjs";
+import { formatConfig } from "../plugin-utils/format.mjs";
+import { replacePathTokens } from "../plugin-utils/paths.mjs";
+import { callHook } from "../lib/hooks.mjs";
+import { getConfigProps } from "../lib/context-helpers.mjs";
+import { getUniqueInputs, isTypeDefinition, resolveInputsSync } from "../lib/entry.mjs";
+import { CACHE_HASH_LENGTH, ROOT_HASH_LENGTH } from "../constants/meta.mjs";
+import "../constants/index.mjs";
+import { getPrefixedRootHash } from "../lib/meta.mjs";
+import { getTsconfigFilePath } from "../lib/typescript/tsconfig.mjs";
+import { VirtualFileSystem } from "../lib/vfs.mjs";
+import { PowerlinesBaseContext } from "./base-context.mjs";
+import { getEnvPaths } from "@stryke/env/get-env-paths";
+import { appendPath } from "@stryke/path/append";
+import { findFileDotExtensionSafe, findFileExtensionSafe } from "@stryke/path/file-path-fns";
+import { replacePath } from "@stryke/path/replace";
+import { kebabCase } from "@stryke/string-format/kebab-case";
+import { isFunction } from "@stryke/type-checks/is-function";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import defu from "defu";
+import { titleCase } from "@stryke/string-format/title-case";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import { isString } from "@stryke/type-checks/is-string";
+import { uuid } from "@stryke/unique-id/uuid";
+import { toArray } from "@stryke/convert/to-array";
+import { getUnique, getUniqueBy } from "@stryke/helpers/get-unique";
+import { isUndefined } from "@stryke/type-checks/is-undefined";
+import { joinPaths } from "@stryke/path/join";
+import { omit } from "@stryke/helpers/omit";
+import { isParentPath } from "@stryke/path/is-parent-path";
+import { existsSync } from "node:fs";
+import { murmurhash } from "@stryke/hash";
+import { match, tsconfigPathsToRegExp } from "bundle-require";
+import { create } from "flat-cache";
+import { relativeToWorkspaceRoot } from "@stryke/fs/get-workspace-root";
+import { hashDirectory } from "@stryke/hash/node";
+import { fetchRequest } from "@stryke/http/fetch";
+import { isEqual } from "@stryke/path/is-equal";
+import { resolveCompatibilityDates } from "compatx";
+import { parse } from "oxc-parser";
+import { Agent, Response, interceptors, setGlobalDispatcher } from "undici";
+
+//#region src/context/context.ts
+setGlobalDispatcher(new Agent({ keepAliveTimeout: 1e4 }).compose(interceptors.retry({
+	maxRetries: 3,
+	minTimeout: 1e3,
+	maxTimeout: 1e4,
+	timeoutFactor: 2,
+	retryAfter: true
+})));
+const UNRESOLVED_CONFIG_NAMES = [
+	"userConfig",
+	"inlineConfig",
+	"pluginConfig",
+	"environmentConfig"
+];
+var PowerlinesContext = class extends PowerlinesBaseContext {
+	#checksum = null;
+	#buildId = uuid();
+	#releaseId = uuid();
+	#fs;
+	#tsconfig;
+	#parserCache;
+	#requestCache;
+	#configProxy;
+	resolver;
+	/**
+	* The parsed `package.json` file for the project
+	*/
+	packageJson;
+	/**
+	* The parsed `project.json` file for the project
+	*/
+	projectJson = void 0;
+	/**
+	* The parsed configuration file for the project
+	*/
+	configFile;
+	/**
+	* An object containing the dependencies that should be installed for the project
+	*/
+	dependencies = {};
+	/**
+	* An object containing the development dependencies that should be installed for the project
+	*/
+	devDependencies = {};
+	/**
+	* The persisted meta information about the current build
+	*/
+	persistedMeta = void 0;
+	/**
+	* The resolved tsconfig file paths for the project
+	*/
+	resolvePatterns = [];
+	/**
+	* The resolved configuration for this context
+	*/
+	resolvedConfig = {};
+	/**
+	* The configuration options that were overridden by plugins during the build process, which may include additional properties or modifications made during the configuration loading process.
+	*/
+	overriddenConfig = {};
+	/**
+	* The configuration options provided inline during execution, such as CLI flags or other parameters that may be relevant to the command being executed. These options can be used to override or supplement the configuration options defined in a configuration file on disk, and are typically provided as part of the execution context when running a Powerlines command.
+	*/
+	inlineConfig = {};
+	/**
+	* The configuration options read from a configuration file on disk, which may be used to resolve the final configuration for the context. This typically includes the user configuration options defined in the `powerlines.config.ts` file, as well as any inline configuration options provided during execution.
+	*/
+	userConfig = {};
+	/**
+	* The configuration options provided by plugins added by the user (and other plugins)
+	*/
+	pluginConfig = {};
+	/**
+	* The configuration options provided by the environment
+	*/
+	environmentConfig = {};
+	/**
+	* The resolved entry type definitions for the project
+	*/
+	get entry() {
+		const entry = this.resolvedEntry;
+		return resolveInputsSync(this, entry && entry.length > 0 ? entry : Array.isArray(this.config.input) || isSetObject(this.config.input) && !isTypeDefinition(this.config.input) ? this.config.input : toArray(this.config.input).flat());
+	}
+	/**
+	* The TypeScript configuration parsed from the tsconfig file
+	*/
+	get tsconfig() {
+		if (!this.#tsconfig) this.tsconfig = { tsconfigFilePath: this.config.tsconfig };
+		return this.#tsconfig;
+	}
+	/**
+	* Sets the TypeScript configuration parsed from the tsconfig file
+	*/
+	set tsconfig(value) {
+		this.#tsconfig = value;
+		this.resolvePatterns = tsconfigPathsToRegExp(value?.options?.paths ?? {});
+	}
+	/**
+	* The virtual file system interface for the project
+	*/
+	get fs() {
+		if (!this.#fs) this.#fs = VirtualFileSystem.createSync(this);
+		return this.#fs;
+	}
+	/**
+	* Get the checksum of the project's current state
+	*/
+	get checksum() {
+		return this.#checksum;
+	}
+	/**
+	* Invokes the configured plugin hooks
+	*
+	* @remarks
+	* By default, it will call the `"pre"`, `"normal"`, and `"post"` ordered hooks in sequence
+	*
+	* @param hook - The hook to call
+	* @param options - The options to provide to the hook
+	* @param args - The arguments to pass to the hook
+	* @returns The result of the hook call
+	*/
+	callHook = async (hook, options, ...args) => callHook(this, hook, options, ...args);
+	/**
+	* The meta information about the current build
+	*/
+	get meta() {
+		return {
+			executionId: this.#buildId,
+			releaseId: this.#releaseId,
+			checksum: this.#checksum,
+			timestamp: this.timestamp,
+			rootHash: murmurhash({
+				workspaceRoot: this.config?.cwd,
+				root: this.config?.root
+			}, { maxLength: 45 }),
+			configHash: murmurhash(this.config, { maxLength: 62 })
+		};
+	}
+	/**
+	* The resolved configuration options
+	*/
+	get config() {
+		if (!this.#configProxy) this.#configProxy = this.createConfigProxy();
+		return this.#configProxy;
+	}
+	/**
+	* Get the path to the artifacts directory for the project
+	*/
+	get artifactsPath() {
+		return joinPaths(this.config.cwd, this.config.root, this.config.output?.artifactsPath || `.${this.config.framework?.name || "powerlines"}`);
+	}
+	/**
+	* Get the path to the builtin modules used by the project
+	*/
+	get builtinsPath() {
+		return joinPaths(this.artifactsPath, "builtins");
+	}
+	/**
+	* Get the path to the entry directory for the project
+	*/
+	get entryPath() {
+		return joinPaths(this.artifactsPath, "entry");
+	}
+	/**
+	* Get the path to the infrastructure modules used by the project
+	*/
+	get infrastructurePath() {
+		return joinPaths(this.artifactsPath, "infrastructure");
+	}
+	/**
+	* Get the path to the data directory for the project
+	*/
+	get dataPath() {
+		return joinPaths(this.envPaths.data, "projects", getPrefixedRootHash(this.config.name, this.meta.rootHash));
+	}
+	/**
+	* Get the path to the cache directory for the project
+	*/
+	get cachePath() {
+		return joinPaths(this.envPaths.cache, "projects", murmurhash({
+			checksum: this.#checksum,
+			config: this.meta.configHash
+		}, { maxLength: 62 }));
+	}
+	/**
+	* Get the path to the generated declaration file for the project
+	*/
+	get typesPath() {
+		return this.config.output.types ? appendPath(this.config.output.types, this.config.cwd) : joinPaths(this.config.cwd, this.config.root, "powerlines.d.ts");
+	}
+	/**
+	* Get the project root relative to the workspace root
+	*/
+	get relativeToWorkspaceRoot() {
+		return relativeToWorkspaceRoot(this.config.root);
+	}
+	/**
+	* The builtin module id that exist in the Powerlines virtual file system
+	*/
+	get builtins() {
+		return Object.values(this.fs.metadata).filter((meta) => meta && meta.type === "builtin").map((meta) => meta?.id).filter(Boolean);
+	}
+	/**
+	* Additional arguments provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed.
+	*/
+	get additionalArgs() {
+		return Object.entries(this.config.inlineConfig.additionalArgs ?? {}).reduce((ret, [key, value]) => {
+			const formattedKey = key.replace(/^--?/, "");
+			if (ret[formattedKey]) if (Array.isArray(ret[formattedKey])) if (Array.isArray(value)) ret[formattedKey] = [...toArray(ret[formattedKey]), ...value];
+			else ret[formattedKey] = [...toArray(ret[formattedKey]), value];
+			else ret[formattedKey] = [ret[formattedKey], ...Array.isArray(value) ? value : [value]];
+			else ret[formattedKey] = value;
+			return ret;
+		}, {});
+	}
+	/**
+	* The alias mappings for the project used during module resolution
+	*
+	* @remarks
+	* This includes both the built-in module aliases as well as any custom aliases defined in the build configuration.
+	*/
+	get alias() {
+		return this.builtins.reduce((ret, id) => {
+			const moduleId = `${this.config?.framework?.name || "powerlines"}:${id.replace(/^.*:/, "")}`;
+			if (!ret[moduleId]) {
+				const path = this.fs.paths[id];
+				if (path) ret[moduleId] = path;
+			}
+			return ret;
+		}, this.config.resolve.alias ? Array.isArray(this.config.resolve.alias) ? this.config.resolve.alias.reduce((ret, alias) => {
+			if (!ret[alias.find.toString()]) ret[alias.find.toString()] = alias.replacement;
+			return ret;
+		}, {}) : this.config.resolve.alias : {});
+	}
+	get logger() {
+		return this.createLogger();
+	}
+	/**
+	* The log level for the context, which determines the minimum level of log messages that will be emitted by the logger. This is resolved based on the configuration options provided by the user, and can be set to different levels for development, production, and test environments. The log level can also be overridden by plugins or other parts of the build process to provide more granular control over logging output.
+	*/
+	get logLevel() {
+		return resolveLogLevel(this.config.logLevel, this.config.mode);
+	}
+	/**
+	* The environment paths for the project, which provide the locations of various directories and files used by the Powerlines framework. These paths are resolved based on the organization ID, application ID, and workspace root directory, and can be used to access configuration files, cache directories, and other resources in a consistent manner.
+	*/
+	get envPaths() {
+		return getEnvPaths({
+			orgId: kebabCase(this.config.framework?.orgId || "storm-software"),
+			appId: kebabCase(this.config.framework?.name || "powerlines"),
+			workspaceRoot: this.config.cwd
+		});
+	}
+	/**
+	* Gets the parser cache.
+	*/
+	get parserCache() {
+		if (!this.#parserCache) this.#parserCache = create({
+			cacheId: "parser",
+			cacheDir: this.cachePath,
+			ttl: 7200 * 1e3,
+			lruSize: 5e3,
+			persistInterval: 250
+		});
+		return this.#parserCache;
+	}
+	/**
+	* Gets the request cache.
+	*/
+	get requestCache() {
+		if (!this.#requestCache) this.#requestCache = create({
+			cacheId: "http",
+			cacheDir: this.cachePath,
+			ttl: 360 * 60 * 1e3,
+			lruSize: 5e3,
+			persistInterval: 250
+		});
+		return this.#requestCache;
+	}
+	/**
+	* The entry points that exist in the Powerlines virtual file system
+	*/
+	get resolvedEntry() {
+		return Object.entries(this.fs.metadata).filter(([, meta]) => meta && meta.type === "entry").map(([path, meta]) => {
+			const typeDefinition = { file: path };
+			if (meta.properties) {
+				if (isSetString(meta.properties.file)) typeDefinition.file = meta.properties.file;
+				if (isSetString(meta.properties.name)) typeDefinition.name = meta.properties.name;
+				if (isSetString(meta.properties["input.file"]) || isSetString(meta.properties["input.name"])) {
+					typeDefinition.input ??= {};
+					if (isSetString(meta.properties["input.file"])) typeDefinition.input.file = meta.properties["input.file"];
+					if (isSetString(meta.properties["input.name"])) typeDefinition.input.name = meta.properties["input.name"];
+				}
+				if (isSetString(meta.properties.output)) typeDefinition.output = meta.properties.output;
+			}
+			return typeDefinition;
+		}).filter(Boolean);
+	}
+	/**
+	* Creates a new Context instance.
+	*
+	* @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+	*/
+	constructor(options) {
+		super(options);
+		this.options = options;
+	}
+	createLogger(options = {}) {
+		return createLogger(this.config.name || this.options.root, {
+			logLevel: this.logLevel,
+			...options
+		}, this.options.logFn);
+	}
+	/**
+	* A function to perform HTTP fetch requests
+	*
+	* @remarks
+	* This function uses a caching layer to avoid duplicate requests during the Powerlines process.
+	*
+	* @example
+	* ```ts
+	* const response = await context.fetch("https://api.example.com/data");
+	* const data = await response.json();
+	* ```
+	*
+	* @see https://github.com/nodejs/undici
+	*
+	* @param input - The URL to fetch.
+	* @param options - The fetch request options.
+	* @returns A promise that resolves to a response returned by the fetch.
+	*/
+	async fetch(input, options = {}) {
+		const cacheKey = murmurhash({
+			input: input.toString(),
+			options: JSON.stringify(options)
+		});
+		if (!this.config.skipCache && !options.skipCache) {
+			const cached = this.requestCache.get(cacheKey);
+			if (cached) return new Response(cached.body, {
+				status: cached.status,
+				statusText: cached.statusText,
+				headers: cached.headers
+			});
+		}
+		const logger = this.extendLogger({ category: "communication" });
+		const startTime = Date.now();
+		logger.trace(`Sending fetch request (${options.method?.toUpperCase() || "GET"}): ${input.toString()}`);
+		const response = await fetchRequest(input, {
+			timeout: 12e3,
+			...options
+		});
+		const result = {
+			body: await response.text(),
+			status: response.status,
+			statusText: response.statusText,
+			headers: Object.fromEntries(response.headers.entries())
+		};
+		if (!this.config.skipCache && !options.skipCache) try {
+			this.requestCache.set(cacheKey, result);
+		} catch {}
+		logger.trace(`Fetch request (${options.method?.toUpperCase() || "GET"}) completed in ${Date.now() - startTime}ms: ${input.toString()} - ${response.status} / ${response.statusText} \n - Response Headers: ${JSON.stringify(result.headers)}\n - Response Body: ${typeof result.body === "string" ? result.body.length > 1e3 ? `${result.body.slice(0, 1e3)}... (truncated, total length: ${result.body.length})` : result.body : "[Non-string body]"}`);
+		return new Response(result.body, {
+			status: result.status,
+			statusText: result.statusText,
+			headers: result.headers
+		});
+	}
+	/**
+	* Parse code using [Oxc-Parser](https://github.com/oxc/oxc) into an (ESTree-compatible)[https://github.com/estree/estree] AST object.
+	*
+	* @remarks
+	* This function can be used to parse TypeScript code into an AST for further analysis or transformation.
+	*
+	* @example
+	* ```ts
+	* const ast = context.parse("const x: number = 42;");
+	* ```
+	*
+	* @see https://rollupjs.org/plugin-development/#this-parse
+	* @see https://github.com/oxc/oxc
+	*
+	* @param code - The source code to parse.
+	* @param options - The options to pass to the parser.
+	* @returns An (ESTree-compatible)[https://github.com/estree/estree] AST object.
+	*/
+	async parse(code, options = {}) {
+		const cacheKey = murmurhash({
+			code,
+			options
+		});
+		let result;
+		if (!this.config.skipCache) {
+			result = this.parserCache.get(cacheKey);
+			if (result) return result;
+		}
+		result = await parse(`source.${options.lang || "ts"}`, code, {
+			...options,
+			sourceType: "module",
+			showSemanticErrors: this.config.mode === "development"
+		});
+		if (!this.config.skipCache) this.parserCache.set(cacheKey, result);
+		return result;
+	}
+	/**
+	* A helper function to resolve modules in the Virtual File System
+	*
+	* @remarks
+	* This function can be used to resolve modules relative to the project root directory.
+	*
+	* @example
+	* ```ts
+	* const resolved = await context.resolve("some-module", "/path/to/importer");
+	* ```
+	*
+	* @param id - The module to resolve.
+	* @param importer - An optional path to the importer module.
+	* @param options - Additional resolution options.
+	* @returns A promise that resolves to the resolved module path.
+	*/
+	async resolve(id, importer, options = {}) {
+		let moduleId = id;
+		if (this.config.resolve.alias) {
+			if (Array.isArray(this.config.resolve.alias)) {
+				const alias = this.config.resolve.alias.find((a) => match(moduleId, [a.find]));
+				if (alias) moduleId = alias.replacement;
+			} else if (isSetObject(this.config.resolve.alias) && this.config.resolve.alias[id]) moduleId = this.config.resolve.alias[id];
+		}
+		if (this.fs.isResolvableId(moduleId) || importer && this.fs.isResolvableId(importer)) {
+			let resolvedImporter = importer;
+			if (importer && this.fs.isResolvableId(importer)) resolvedImporter = await this.fs.resolve(importer, void 0, defu({
+				conditions: this.config.resolve.conditions,
+				extensions: this.config.resolve.extensions
+			}, options));
+			const result = await this.fs.resolve(moduleId, resolvedImporter, defu({
+				conditions: this.config.resolve.conditions,
+				extensions: this.config.resolve.extensions
+			}, options));
+			if (!result) return;
+			const external = Boolean(!match(moduleId, this.config.resolve.noExternal) && (match(moduleId, this.config.resolve.external) || moduleId.startsWith("node:") || (!this.fs.isVirtual(moduleId, importer, options) || this.fs.isVirtual(moduleId, importer, options) && this.config.projectType !== "application") && this.config.resolve.skipNodeModulesBundle && !/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(moduleId)));
+			return {
+				id: result,
+				external,
+				virtual: !external
+			};
+		}
+		if (this.config.resolve.skipNodeModulesBundle) {
+			if (match(moduleId, this.resolvePatterns) || match(moduleId, this.config.resolve.noExternal)) return;
+			if (match(moduleId, this.config.resolve.external) || moduleId.startsWith("node:")) return {
+				id: moduleId,
+				external: true,
+				virtual: false
+			};
+			if (!/^[A-Z]:[/\\]|^\.{0,2}\/|^\.{1,2}$/.test(moduleId)) return {
+				id: moduleId,
+				external: true,
+				virtual: false
+			};
+		} else {
+			if (match(moduleId, this.config.resolve.noExternal)) return;
+			if (match(moduleId, this.config.resolve.external) || moduleId.startsWith("node:")) return {
+				id: moduleId,
+				external: true,
+				virtual: false
+			};
+		}
+	}
+	/**
+	* A helper function to load modules from the Virtual File System
+	*
+	* @remarks
+	* This function can be used to load modules relative to the project root directory.
+	*
+	* @example
+	* ```ts
+	* const module = await context.load("some-module", "/path/to/importer");
+	* ```
+	*
+	* @param id - The module to load.
+	* @returns A promise that resolves to the loaded module.
+	*/
+	async load(id) {
+		const resolvedId = await this.fs.resolve(id);
+		if (!resolvedId) return;
+		const code = await this.fs.read(resolvedId);
+		if (!code) return;
+		return {
+			code,
+			map: null
+		};
+	}
+	/**
+	* Get the builtin virtual files that exist in the Powerlines virtual file system
+	*/
+	async getBuiltins() {
+		return Promise.all(Object.entries(this.fs.metadata).filter(([, meta]) => meta && meta.type === "builtin").map(async ([id, meta]) => {
+			const code = await this.fs.read(id);
+			const path = this.fs.paths[id];
+			return {
+				...meta,
+				path,
+				code
+			};
+		}));
+	}
+	/**
+	* Resolves a file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the file
+	* @param path - The path to write the file to
+	* @param options - Additional options for writing the file
+	*/
+	async emit(code, path, options = {}) {
+		const filePath = options.extension ? findFileExtensionSafe(path) ? options.extension.startsWith(".") ? path.replace(findFileDotExtensionSafe(path), options.extension) : path.replace(findFileExtensionSafe(path), options.extension) : options.extension.startsWith(".") ? `${path}${options.extension}` : `${path}.${options.extension}` : findFileExtensionSafe(path) ? path : `${path}.ts`;
+		if (isFunction(this.emitFile) && options.emitWithBundler) return this.emitFile({
+			needsCodeReference: options.needsCodeReference,
+			originalFileName: options.originalFileName,
+			fileName: filePath,
+			source: code,
+			type: "asset"
+		});
+		return this.fs.write(filePath, code, options);
+	}
+	/**
+	* Synchronously resolves a file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the file
+	* @param path - The path to write the file to
+	* @param options - Additional options for writing the file
+	*/
+	emitSync(code, path, options = {}) {
+		const filePath = options.extension ? findFileExtensionSafe(path) ? options.extension.startsWith(".") ? path.replace(findFileDotExtensionSafe(path), options.extension) : path.replace(findFileExtensionSafe(path), options.extension) : options.extension.startsWith(".") ? `${path}${options.extension}` : `${path}.${options.extension}` : findFileExtensionSafe(path) ? path : `${path}.ts`;
+		if (isFunction(this.emitFile) && options.emitWithBundler) return this.emitFile({
+			needsCodeReference: options.needsCodeReference,
+			originalFileName: options.originalFileName,
+			fileName: filePath,
+			source: code,
+			type: "asset"
+		});
+		return this.fs.writeSync(filePath, code, options);
+	}
+	/**
+	* Resolves a entry virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the entry file
+	* @param path - A path to write the entry file to
+	* @param options - Optional write file options
+	*/
+	async emitEntry(code, path, options = {}) {
+		return this.emit(code, appendPath(path, this.entryPath), defu({ meta: {
+			type: "entry",
+			properties: {
+				file: appendPath(path, this.entryPath),
+				name: options?.name,
+				output: options?.output,
+				"input.file": options?.input?.file,
+				"input.name": options?.input?.name
+			}
+		} }, omit(options, ["name"])));
+	}
+	/**
+	* Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the entry file
+	* @param path - A path to write the entry file to
+	* @param options - Optional write file options
+	*/
+	emitEntrySync(code, path, options = {}) {
+		return this.emitSync(code, appendPath(path, this.entryPath), defu({ meta: {
+			type: "entry",
+			properties: {
+				file: appendPath(path, this.entryPath),
+				name: options?.name,
+				output: options?.output,
+				"input.file": options?.input?.file,
+				"input.name": options?.input?.name
+			}
+		} }, omit(options, ["name"])));
+	}
+	/**
+	* Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the builtin file
+	* @param id - The unique identifier of the builtin file
+	* @param options - Optional write file options
+	*/
+	async emitBuiltin(code, id, options = {}) {
+		if (!this.builtinsPath) throw new Error(`The builtins path is not set. Cannot emit builtin file with id "${id}".`);
+		if (!isSetString(id)) throw new Error(`The builtin id must be a non-empty string. Received: ${String(id)}`);
+		return this.emit(code, appendPath(id, this.builtinsPath), defu(options, { meta: {
+			type: "builtin",
+			id
+		} }));
+	}
+	/**
+	* Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the builtin file
+	* @param id - The unique identifier of the builtin file
+	* @param options - Optional write file options
+	*/
+	emitBuiltinSync(code, id, options = {}) {
+		if (!this.builtinsPath) throw new Error(`The builtins path is not set. Cannot emit builtin file with id "${id}".`);
+		if (!isSetString(id)) throw new Error(`The builtin id must be a non-empty string. Received: ${String(id)}`);
+		return this.emitSync(code, appendPath(id, this.builtinsPath), defu(options, { meta: {
+			type: "builtin",
+			id
+		} }));
+	}
+	/**
+	* Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the builtin file
+	* @param id - The unique identifier of the builtin file
+	* @param options - Optional write file options
+	*/
+	async emitInfrastructure(code, id, options = {}) {
+		if (!this.infrastructurePath) throw new Error(`The infrastructure path is not set. Cannot emit infrastructure file with id "${id}".`);
+		if (!isSetString(id)) throw new Error(`The infrastructure id must be a non-empty string. Received: ${String(id)}`);
+		return this.emit(code, appendPath(id, this.infrastructurePath), defu(options, { meta: {
+			type: "infrastructure",
+			id
+		} }));
+	}
+	/**
+	* Synchronously resolves an infrastructure virtual file and writes it to the VFS if it does not already exist
+	*
+	* @param code - The source code of the infrastructure file
+	* @param id - The unique identifier of the infrastructure file
+	* @param options - Optional write file options
+	*/
+	emitInfrastructureSync(code, id, options = {}) {
+		if (!this.infrastructurePath) throw new Error(`The infrastructure path is not set. Cannot emit infrastructure file with id "${id}".`);
+		if (!isSetString(id)) throw new Error(`The infrastructure id must be a non-empty string. Received: ${String(id)}`);
+		return this.emitSync(code, appendPath(id, this.infrastructurePath), defu(options, { meta: {
+			type: "infrastructure",
+			id
+		} }));
+	}
+	/**
+	* Generates a checksum representing the current context state
+	*
+	* @param path - The root directory of the project to generate the checksum for
+	* @returns A promise that resolves to a string representing the checksum
+	*/
+	async generateChecksum(path) {
+		return hashDirectory(path || appendPath(this.options.root, this.options.cwd));
+	}
+	/**
+	* A setter function to populate the inline config values provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed. This function can be used to update the context with the inline configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any inline configuration provided during execution.
+	*
+	* @param config - The inline configuration values to set.
+	* @returns A promise that resolves when the inline configuration values have been set.
+	*/
+	async setInlineConfig(config) {
+		this.logger.debug({
+			meta: { category: "config" },
+			message: `Updating inline configuration object: \n${formatConfig(config)}`
+		});
+		this.inlineConfig = config;
+		this.#checksum = await this.generateChecksum();
+		this.configFile = await loadParsedConfig(this.options.cwd, this.options.root, this.options.framework?.name || "powerlines", this.options.framework?.orgId || "storm-software", config);
+		const result = this.configFile.config && toArray(this.configFile.config).length > this.options.configIndex ? toArray(this.configFile.config)[this.options.configIndex] : this.configFile.config;
+		if (!result) this.logger.warn(`No configuration found in ${this.options.configFile} for execution index ${this.options.configIndex}.`);
+		else await this.setUserConfig(isFunction(result) ? await Promise.resolve(result({
+			cwd: this.cwd,
+			root: this.options.root,
+			mode: this.inlineConfig.mode || await getDefaultMode(this.cwd, this.options.root),
+			command: this.inlineConfig.command
+		})) : result);
+		await this.resolveConfig();
+	}
+	/**
+	* A setter function to populate the plugin config values provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed. This function can be used to update the context with the plugin configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any plugin configuration provided during execution.
+	*
+	* @param config - The plugin configuration values to set.
+	* @returns A promise that resolves when the plugin configuration values have been set.
+	*/
+	async setPluginConfig(config) {
+		this.logger.debug({
+			meta: { category: "config" },
+			message: `Updating plugin configuration object: \n${formatConfig(config)}`
+		});
+		this.pluginConfig = config;
+		await this.resolveConfig();
+	}
+	/**
+	* A function to merge the various configuration objects (initial, user, inline, and plugin) into a single resolved configuration object that can be used throughout the Powerlines process. This function takes into account the different sources of configuration and their respective priorities, ensuring that the final configuration reflects the intended settings for the project. The merged configuration is then returned as a new object that can be accessed through the `config` property of the context.
+	*
+	* @returns The merged configuration object that combines the initial, user, inline, and plugin configurations.
+	*/
+	mergeConfig() {
+		return mergeConfig({
+			inlineConfig: this.inlineConfig,
+			userConfig: this.userConfig,
+			pluginConfig: this.pluginConfig,
+			environmentConfig: this.environmentConfig
+		}, getConfigProps(this.overriddenConfig), this.options, getConfigProps(this.inlineConfig), getConfigProps(this.userConfig), getConfigProps(this.pluginConfig), {
+			version: this.packageJson?.version,
+			description: this.packageJson?.description,
+			environments: {},
+			resolve: {}
+		});
+	}
+	/**
+	* A setter function to populate the user config values provided during execution of the command, such as CLI flags or other parameters that may be relevant to the command being executed. This function can be used to update the context with the user configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any inline configuration provided during execution.
+	*
+	* @param config - The user configuration values to set.
+	* @returns A promise that resolves when the user configuration values have been set.
+	*/
+	async setUserConfig(config) {
+		this.logger.debug({
+			meta: { category: "config" },
+			message: `Updating user configuration object: \n${formatConfig(config)}`
+		});
+		this.userConfig = config;
+		await this.resolveConfig();
+	}
+	/**
+	* Initialize the context with the provided configuration options
+	*/
+	async resolveConfig() {
+		const mergedConfig = this.mergeConfig();
+		this.logger.trace({
+			meta: { category: "config" },
+			message: `Pre-setup Powerlines configuration object: \n --- Merged Config --- \n${formatConfig(mergedConfig)} \n\n --- User Config --- \n${formatConfig(this.userConfig)} \n\n --- Inline Config --- \n${formatConfig(this.inlineConfig)} \n\n --- Plugin Config --- \n${formatConfig(this.pluginConfig)} \n\n --- Environment Config --- \n${formatConfig(this.environmentConfig)} \n\n --- Overridden Config --- \n${formatConfig(this.overriddenConfig)}`
+		});
+		mergedConfig.output = defu(mergedConfig.output ?? {}, {
+			copy: { assets: [
+				{ glob: "LICENSE" },
+				{
+					input: mergedConfig.root,
+					glob: "*.md"
+				},
+				{
+					input: mergedConfig.root,
+					glob: "package.json"
+				}
+			] },
+			dts: true
+		});
+		if (isUndefined(mergedConfig.mode)) mergedConfig.mode = await getDefaultMode(this.cwd, mergedConfig.root);
+		if (isUndefined(mergedConfig.framework) || !isSetString(mergedConfig.framework.name)) {
+			mergedConfig.framework ??= {};
+			mergedConfig.framework.name ??= await getWorkspaceName(this) || "powerlines";
+		}
+		if (isUndefined(mergedConfig.platform)) mergedConfig.platform = "neutral";
+		mergedConfig.compatibilityDate = resolveCompatibilityDates(mergedConfig.compatibilityDate, "latest");
+		if (!this.packageJson && existsSync(joinPaths(appendPath(mergedConfig.root, mergedConfig.cwd), "package.json")) || !this.projectJson && existsSync(joinPaths(appendPath(mergedConfig.root, mergedConfig.cwd), "project.json"))) {
+			const result = await resolvePackageConfigs(mergedConfig.cwd, mergedConfig.root);
+			if (result) {
+				if (result.packageJson) this.packageJson = result.packageJson;
+				if (result.projectJson) this.projectJson = result.projectJson;
+				if (this.packageJson) {
+					mergedConfig.framework ??= {};
+					mergedConfig.framework.name ??= await getWorkspaceName(this) || "powerlines";
+					mergedConfig.framework.orgId ??= getPackageJsonOrganization(this.packageJson) || "storm-software";
+				}
+			}
+		}
+		if (isUndefined(mergedConfig.projectType)) mergedConfig.projectType = this.projectJson?.projectType || "application";
+		this.resolvedConfig = mergedConfig;
+		this.#configProxy = this.createConfigProxy();
+		mergedConfig.input = getUniqueInputs(mergedConfig.input);
+		if (mergedConfig.name?.startsWith("@") && mergedConfig.name.split("/").filter(Boolean).length > 1) mergedConfig.name = mergedConfig.name.split("/").filter(Boolean)[1];
+		mergedConfig.title ??= titleCase(mergedConfig.name);
+		if (mergedConfig.resolve.external) mergedConfig.resolve.external = getUnique(mergedConfig.resolve.external);
+		if (mergedConfig.resolve.noExternal) mergedConfig.resolve.noExternal = getUnique(mergedConfig.resolve.noExternal);
+		mergedConfig.plugins = (mergedConfig.plugins ?? []).flatMap((plugin) => toArray(plugin)).filter(Boolean).reduce((ret, plugin) => {
+			if (isPlugin(plugin) && isDuplicate(plugin, ret.filter((p) => isPlugin(p)))) return ret;
+			ret.push(plugin);
+			return ret;
+		}, []);
+		if (isUndefined(mergedConfig.logLevel)) if (mergedConfig.mode === "development") mergedConfig.logLevel = DEFAULT_DEVELOPMENT_LOG_LEVEL;
+		else if (mergedConfig.mode === "test") mergedConfig.logLevel = DEFAULT_TEST_LOG_LEVEL;
+		else mergedConfig.logLevel = DEFAULT_PRODUCTION_LOG_LEVEL;
+		mergedConfig.logLevel = resolveLogLevel(mergedConfig.logLevel);
+		if (isSetString(mergedConfig.tsconfig)) mergedConfig.tsconfig = replacePath(replacePathTokens(this, mergedConfig.tsconfig), mergedConfig.cwd);
+		else mergedConfig.tsconfig = getTsconfigFilePath(mergedConfig.cwd, mergedConfig.root);
+		mergedConfig.output.format = getUnique(toArray(mergedConfig.output?.format ?? (mergedConfig.projectType === "library" ? ["cjs", "esm"] : ["esm"])));
+		if (isSetString(mergedConfig.output.path)) mergedConfig.output.path = appendPath(replacePathTokens(this, mergedConfig.output.path), mergedConfig.cwd);
+		else mergedConfig.output.path = appendPath(joinPaths(mergedConfig.root, "dist"), mergedConfig.cwd);
+		mergedConfig.output.copy ??= {};
+		if (mergedConfig.output.copy !== false) if (!mergedConfig.root.replace(/^\.\/?/, "")) mergedConfig.output.copy.path = isSetString(mergedConfig.output.copy.path) ? appendPath(replacePathTokens(this, mergedConfig.output.copy.path), mergedConfig.cwd) : mergedConfig.output.path;
+		else mergedConfig.output.copy.path = appendPath(replacePathTokens(this, isSetString(mergedConfig.output.copy.path) ? mergedConfig.output.copy.path : joinPaths("dist", mergedConfig.root)), mergedConfig.cwd);
+		if (mergedConfig.output.types !== false) mergedConfig.output.types = appendPath(replacePathTokens(this, mergedConfig.output.types || joinPaths(mergedConfig.root, `${mergedConfig.framework?.name ?? "powerlines"}.d.ts`)), mergedConfig.cwd);
+		if (mergedConfig.output.copy && mergedConfig.output.copy.path && mergedConfig.output.copy.assets && Array.isArray(mergedConfig.output.copy.assets)) mergedConfig.output.copy.assets = getUniqueBy(mergedConfig.output.copy.assets.map((asset) => {
+			return {
+				glob: isSetObject(asset) ? asset.glob : asset,
+				input: isString(asset) || !asset.input || asset.input === "." || asset.input === "/" || asset.input === "./" ? mergedConfig.cwd : isParentPath(asset.input, mergedConfig.cwd) || isEqual(asset.input, mergedConfig.cwd) ? asset.input : appendPath(asset.input, mergedConfig.cwd),
+				output: isSetObject(asset) && asset.output ? isParentPath(asset.output, mergedConfig.cwd) ? asset.output : appendPath(joinPaths(mergedConfig.output.copy.path, replacePath(replacePath(asset.output, replacePath(mergedConfig.output.copy.path, mergedConfig.cwd)), mergedConfig.output.copy.path)), mergedConfig.cwd) : appendPath(mergedConfig.output.copy.path, mergedConfig.cwd),
+				ignore: isSetObject(asset) && asset.ignore ? toArray(asset.ignore) : void 0
+			};
+		}), (a) => `${a.input}-${a.glob}-${a.output}`);
+		if (isUndefined(mergedConfig.output?.sourceMap)) if (mergedConfig.mode === "development") mergedConfig.output.sourceMap = true;
+		else mergedConfig.output.sourceMap = false;
+		if (isUndefined(mergedConfig.output?.minify)) if (mergedConfig.mode === "production") mergedConfig.output.minify = true;
+		else mergedConfig.output.minify = false;
+		if (isUndefined(mergedConfig.output?.artifactsPath)) mergedConfig.output.artifactsPath = `.${mergedConfig.framework?.name ?? "powerlines"}`;
+		if (mergedConfig.output.copy && mergedConfig.output.copy.assets) mergedConfig.output.copy.assets = mergedConfig.output.copy.assets.map((asset) => ({
+			...asset,
+			glob: replacePathTokens(this, asset.glob),
+			ignore: asset.ignore ? asset.ignore.map((ignore) => replacePathTokens(this, ignore)) : void 0,
+			input: replacePathTokens(this, asset.input),
+			output: replacePathTokens(this, asset.output)
+		}));
+		if (isSetString(mergedConfig.output?.storage) && mergedConfig.output.storage === "virtual" || isSetObject(mergedConfig.output?.storage) && Object.values(mergedConfig.output.storage).every((adapter) => adapter.preset === "virtual")) mergedConfig.output.overwrite = true;
+		this.resolvedConfig = mergedConfig;
+		this.#configProxy = this.createConfigProxy();
+		this.resolver = createResolver({
+			cwd: this.resolvedConfig.cwd,
+			root: this.resolvedConfig.root,
+			cacheDir: this.envPaths.cache,
+			mode: this.resolvedConfig.mode
+		});
+		this.logger.info({
+			meta: { category: "config" },
+			message: `Resolved Powerlines configuration object: \n${formatConfig(this.resolvedConfig)}`
+		});
+		this.#fs ??= await VirtualFileSystem.create(this);
+	}
+	createConfigProxy() {
+		return new Proxy(this.resolvedConfig, {
+			/**
+			* A trap for the `delete` operator.
+			* @param target - The original object which is being proxied.
+			* @param key - The name or `Symbol` of the property to delete.
+			* @returns A `boolean` indicating whether or not the property was deleted.
+			*/
+			deleteProperty: (target, key) => {
+				if (UNRESOLVED_CONFIG_NAMES.includes(key.toString())) throw new Error(`Cannot delete property ${key.toString()} from config - it is only intended to be used as a reference.`);
+				Reflect.deleteProperty(this.overriddenConfig, key);
+				return Reflect.deleteProperty(target, key);
+			},
+			/**
+			* A trap for getting a property value.
+			* @param target - The original object which is being proxied.
+			* @param key - The name or `Symbol` of the property to get.
+			* @param receiver - The proxy or an object that inherits from the proxy.
+			*/
+			get: (target, key, receiver) => {
+				if (UNRESOLVED_CONFIG_NAMES.includes(key.toString())) {
+					if (key === "cwd") return this.cwd;
+					if (key === "userConfig") return this.userConfig;
+					if (key === "inlineConfig") return this.inlineConfig;
+					if (key === "pluginConfig") return this.pluginConfig;
+					if (key === "environmentConfig") return this.environmentConfig;
+				}
+				return Reflect.get(target, key, receiver);
+			},
+			/**
+			* A trap for the `in` operator.
+			* @param target - The original object which is being proxied.
+			* @param key - The name or `Symbol` of the property to check for existence.
+			*/
+			has: (target, key) => {
+				return Reflect.has(target, key) || UNRESOLVED_CONFIG_NAMES.includes(key.toString());
+			},
+			/**
+			* A trap for `Reflect.ownKeys()`.
+			* @param target - The original object which is being proxied.
+			*/
+			ownKeys: (target) => {
+				return getUnique([...Reflect.ownKeys(target), ...UNRESOLVED_CONFIG_NAMES]);
+			},
+			/**
+			* A trap for setting a property value.
+			* @param target - The original object which is being proxied.
+			* @param key - The name or `Symbol` of the property to set.
+			* @param newValue - The new value to assign to the property.
+			* @param receiver - The object to which the assignment was originally directed.
+			* @returns A `boolean` indicating whether or not the property was set.
+			*/
+			set: (target, key, newValue, receiver) => {
+				if (UNRESOLVED_CONFIG_NAMES.includes(key.toString())) throw new Error(`Cannot change property ${key.toString()} from config - it is only intended to be used as a reference.`);
+				Reflect.set(this.overriddenConfig, key, newValue, receiver);
+				return Reflect.set(target, key, newValue, receiver);
+			}
+		});
+	}
+};
+
+//#endregion
+export { PowerlinesContext };
+//# sourceMappingURL=context.mjs.map