@powerlines/engine 0.45.3 → 0.46.1

package/dist/context/index.d.mts

@@ -1,517 +1,49 @@
-import { EnvPaths } from "@stryke/env/get-env-paths";
-import { FlatCache } from "flat-cache";
-import { ParseResult } from "oxc-parser";
-import { RequestInfo, Response } from "undici";
-import { BaseContext, Context, EmitEntryOptions, EmitOptions, EngineContext, EngineOptions, EnvironmentContext, EnvironmentContextPlugin, EnvironmentResolvedConfig, ExecutionContext, ExecutionOptions, ExecutionState, FetchOptions, HooksList, InitialConfig, InlineConfig, LogFn, LogLevelResolvedConfig, LogMessage, Logger, LoggerOptions, MetaInfo, Mode, ParseOptions, ParsedTypeScriptConfig, ParsedUserConfig, Plugin, PluginContext, ResolveOptions, ResolveResult, ResolvedConfig, ResolvedEntryTypeDefinition, Resolver, SelectHookResult, SelectHooksOptions, TransformResult, VirtualFile, VirtualFileSystemInterface, WorkspaceConfig } from "@powerlines/core";
+import { n as PowerlinesContext, r as PowerlinesBaseContext, t as PowerlinesExecutionContext } from "../execution-context-BpRfsnkE.mjs";
+import { EngineContext, EngineOptions, EnvironmentContextPlugin, EnvironmentResolvedConfig, ExecutionOptions, ExecutionState, HooksList, InferOverridableConfig, LogFn, LogLevelResolvedConfig, Logger, LoggerOptions, Plugin, PluginContext, ResolvedConfig, SelectHookResult, SelectHooksOptions, UserConfig } from "@powerlines/core";
+import { DeepPartial, RequiredKeys } from "@stryke/types/base";
 import { Unstable_ContextInternal, Unstable_EnvironmentContext, Unstable_PluginContext } from "@powerlines/core/types/_internal";
-import { PackageJson } from "@stryke/types/package-json";
-import { Range } from "semver";
 
-//#region src/context/base-context.d.ts
-declare class PowerlinesBaseContext implements BaseContext {
+//#region src/context/engine-context.d.ts
+declare class PowerlinesEngineContext extends PowerlinesBaseContext implements EngineContext {
   #private;
   /**
-   * The path to the Powerlines package
-   */
-  powerlinesPath: string;
-  /**
-   * The module resolver for the project
-   */
-  resolver: Resolver;
-  /**
-   * The options provided to the Powerlines process
-   */
-  options: EngineOptions;
-  /**
-   * The input options used to initialize the context, which may be used when cloning the context to ensure the same configuration is applied to the new context
-   */
-  initialOptions: Partial<EngineOptions>;
-  /**
-   * The initial configuration provided when initializing the context, which may be used during the setup process to ensure that the configuration is properly merged and applied to the context. This is typically the user configuration provided in the Powerlines configuration file, but may also include additional configuration options provided by plugins or other sources.
-   */
-  initialConfig: InitialConfig<any>;
-  /**
-   * The parsed configuration file for the project
-   */
-  configFile: ParsedUserConfig;
-  /**
-   * The logger instance for the context, which can be used to create log messages with consistent formatting and metadata. This logger is extended by plugin contexts to include additional metadata such as the plugin name and category, which can be used to filter and format log messages in a more granular way.
-   */
-  get logger(): Logger;
-  /**
-   * A timestamp representing when the context was initialized
-   */
-  get timestamp(): number;
-  get logLevel(): LogLevelResolvedConfig;
-  /**
-   * The environment paths for the project
-   */
-  get envPaths(): EnvPaths;
-  /**
-   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
-   *
-   * @remarks
-   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.
-   *
-   * @returns A promise that resolves to the cloned context.
-   */
-  clone(): Promise<BaseContext>;
-  /**
-   * A logging function for fatal messages
-   *
-   * @param message - The message to log.
-   */
-  fatal(message: string | LogMessage): void;
-  /**
-   * A logging function for error messages
-   *
-   * @param message - The message to log.
-   */
-  error(message: string | LogMessage): void;
-  /**
-   * A logging function for warning messages
-   *
-   * @param message - The message to log.
-   */
-  warn(message: string | LogMessage): void;
-  /**
-   * A logging function for informational messages
-   *
-   * @param message - The message to log.
-   */
-  info(message: string | LogMessage): void;
-  /**
-   * A logging function for debug messages
-   *
-   * @param message - The message to log.
-   */
-  debug(message: string | LogMessage): void;
-  /**
-   * A logging function for trace messages
-   *
-   * @param message - The message to log.
-   */
-  trace(message: string | LogMessage): void;
-  /**
-   * A function to create a timer for measuring the duration of asynchronous operations
-   *
-   * @example
-   * ```ts
-   * const stopTimer = context.timer("Your Async Operation");
-   * await performAsyncOperation();
-   * stopTimer(); // "Your Async Operation completed in 123.45 milliseconds"
-   * ```
-   *
-   * @param name - The name of the timer.
-   * @returns A function that, when called, stops the timer and logs the duration.
-   */
-  timer(name: string): () => void;
-  /**
-   * Create a new logger instance
-   *
-   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
-   * @param logFn - The custom logging function to use for logging messages, which can be used to override the default logging behavior of the original logger.
-   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
-   */
-  createLogger(options: LoggerOptions, logFn?: LogFn): Logger;
-  /**
-   * Extend the base logger with additional configuration options
-   *
-   * @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
-   * @returns A new logger client instance that extends the base logger with the provided configuration options.
-   */
-  extendLogger(options: LoggerOptions): Logger;
-  /**
-   * Retrieve the workspace configuration for the current project, if it exists. This function will look for a configuration file in the project root and return its contents as a JavaScript object. If no configuration file is found, it will return undefined.
-   *
-   * @returns A promise that resolves to the workspace configuration object, or undefined if no configuration file is found.
-   */
-  protected getWorkspaceConfig(): Promise<WorkspaceConfig | undefined>;
-  /**
-   * Determine the default mode for the current execution based on the environment and workspace configuration. This function will check the `NODE_ENV` environment variable to determine if the current environment is development, production, or test. If `NODE_ENV` is not set, it will look for a `mode` property in the workspace configuration file. If no mode is specified in the workspace configuration, it will default to "production".
-   *
-   * @returns A promise that resolves to the default mode for the current execution, which can be "development", "production", or "test".
-   */
-  protected getDefaultMode(): Promise<Mode>;
-  /**
-   * Determine the default log level for the current execution based on the environment and workspace configuration. This function will check the `logLevel` property in the workspace configuration file and resolve it to a `LogLevelResolvedConfig` value. If no log level is specified in the workspace configuration, it will default to "info" for development mode and "warn" for production mode.
+   * Creates a new instance of the PowerlinesEngineContext class.
    *
-   * @returns A promise that resolves to the default log level for the current execution, which can be "fatal", "error", "warn", "info", "debug", or "trace".
+   * @param options - The options to initialize the context with.
+   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.
    */
-  protected getDefaultLogLevel(): Promise<LogLevelResolvedConfig>;
+  static fromInitialConfig(options: EngineOptions, initialConfig?: DeepPartial<UserConfig>): Promise<PowerlinesEngineContext>;
   /**
-   * Initialize the context with the provided configuration options
-   *
-   * @remarks
-   * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.
-   *
-   * @param options - The configuration options to initialize the context with
-   * @param initialConfig - The initial configuration to initialize the context with
+   * The initial options provided to the Powerlines process before any resolution or merging. This is typically the user configuration provided in the Powerlines configuration file, but may also include additional configuration options provided by plugins or other sources.
    */
-  protected init(options: EngineOptions, initialConfig: InitialConfig): Promise<void>;
-}
-//#endregion
-//#region src/context/context.d.ts
-declare class PowerlinesContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesBaseContext implements Context<TResolvedConfig> {
-  #private;
+  readonly initialOptions: EngineOptions;
   /**
-   * Create a new Storm context from the workspace root and user config.
-   *
-   * @param options - The options for resolving the context.
-   * @returns A promise that resolves to the new context.
+   * The initial user configuration provided to the Powerlines process before any resolution or merging. This is typically the user configuration provided in the Powerlines configuration file, but may also include additional configuration options provided by plugins or other sources.
    */
-  static init<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(options: ExecutionOptions, initialConfig: InitialConfig<TResolvedConfig["userConfig"]>): Promise<Context<TResolvedConfig>>;
+  readonly initialConfig: DeepPartial<UserConfig>;
   /**
    * The options provided to the Powerlines process
    */
-  options: ExecutionOptions;
-  /**
-   * An object containing the dependencies that should be installed for the project
-   */
-  dependencies: Record<string, string | Range>;
-  /**
-   * An object containing the development dependencies that should be installed for the project
-   */
-  devDependencies: Record<string, string | Range>;
-  /**
-   * The persisted meta information about the current build
-   */
-  persistedMeta: MetaInfo | undefined;
-  /**
-   * The parsed `package.json` file for the project
-   */
-  packageJson: PackageJson;
-  /**
-   * The parsed `project.json` file for the project
-   */
-  projectJson: Record<string, any> | undefined;
-  /**
-   * The resolved tsconfig file paths for the project
-   */
-  resolvePatterns: RegExp[];
-  /**
-   * 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(): Unstable_ContextInternal<TResolvedConfig>;
-  /**
-   * 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: Unstable_ContextInternal<TResolvedConfig>);
-  /**
-   * The resolved entry type definitions for the project
-   */
-  get entry(): ResolvedEntryTypeDefinition[];
-  /**
-   * The TypeScript configuration parsed from the tsconfig file
-   */
-  get tsconfig(): ParsedTypeScriptConfig;
-  /**
-   * Sets the TypeScript configuration parsed from the tsconfig file
-   */
-  set tsconfig(value: ParsedTypeScriptConfig);
-  /**
-   * The virtual file system interface for the project
-   */
-  get fs(): VirtualFileSystemInterface;
-  /**
-   * Get the checksum of the project's current state
-   */
-  get checksum(): string | null;
-  /**
-   * The meta information about the current build
-   */
-  get meta(): MetaInfo;
-  /**
-   * The resolved configuration options
-   */
-  get config(): TResolvedConfig;
-  /**
-   * Get the path to the artifacts directory for the project
-   */
-  get artifactsPath(): string;
-  /**
-   * Get the path to the builtin modules used by the project
-   */
-  get builtinsPath(): string;
-  /**
-   * Get the path to the entry directory for the project
-   */
-  get entryPath(): string;
-  /**
-   * Get the path to the infrastructure modules used by the project
-   */
-  get infrastructurePath(): string;
-  /**
-   * Get the path to the data directory for the project
-   */
-  get dataPath(): string;
-  /**
-   * Get the path to the cache directory for the project
-   */
-  get cachePath(): string;
-  /**
-   * Get the path to the generated declaration file for the project
-   */
-  get typesPath(): string;
-  /**
-   * Get the project root relative to the workspace root
-   */
-  get relativeToWorkspaceRoot(): string;
-  /**
-   * The builtin module id that exist in the Powerlines virtual file system
-   */
-  get builtins(): string[];
-  /**
-   * 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(): Record<string, string | string[]>;
-  /**
-   * 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(): Record<string, string>;
-  /**
-   * Create a new logger instance
-   *
-   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
-   * @param logFn - The custom logging function to use for logging messages, which can be used to override the default logging behavior of the original logger.
-   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
-   */
-  createLogger(options: LoggerOptions, logFn?: LogFn): Logger;
-  /**
-   * 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(): LogLevelResolvedConfig;
-  /**
-   * 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(): EnvPaths;
-  /**
-   * Gets the parser cache.
-   */
-  protected get parserCache(): FlatCache;
+  options: RequiredKeys<Omit<EngineOptions, "logLevel">, "name" | "root" | "cwd" | "mode" | "framework"> & {
+    /**
+     * The log level to use for logging messages during the build process. This can be a string indicating the log level or a more detailed configuration object that allows for specifying different log levels for different categories of logs.
+     */
+    logLevel: LogLevelResolvedConfig;
+  };
   /**
-   * Gets the request cache.
-   */
-  protected get requestCache(): FlatCache;
-  /**
-   * The entry points that exist in the Powerlines virtual file system
-   */
-  protected get resolvedEntry(): ResolvedEntryTypeDefinition[];
-  /**
-   * Creates a new StormContext instance.
+   * Creates a new Context instance.
    *
    * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+   * @param initialConfig - The initial configuration provided by the user, which can 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.
    */
-  protected constructor(options: ExecutionOptions);
-  /**
-   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
-   *
-   * @remarks
-   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.
-   *
-   * @returns A promise that resolves to the cloned context.
-   */
-  clone(): Promise<Context<TResolvedConfig>>;
-  /**
-   * 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.
-   */
-  fetch(input: RequestInfo, options?: FetchOptions): Promise<Response>;
-  /**
-   * 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.
-   */
-  parse(code: string, options?: ParseOptions): Promise<ParseResult>;
-  /**
-   * 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.
-   */
-  resolve(id: string, importer?: string, options?: ResolveOptions): Promise<ResolveResult | undefined>;
-  /**
-   * 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.
-   */
-  load(id: string): Promise<TransformResult | undefined>;
-  /**
-   * Get the builtin virtual files that exist in the Powerlines virtual file system
-   */
-  getBuiltins(): Promise<VirtualFile[]>;
-  /**
-   * 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
-   */
-  emit(code: string, path: string, options?: EmitOptions): Promise<void>;
-  /**
-   * 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: string, path: string, options?: EmitOptions): void;
-  /**
-   * 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
-   */
-  emitEntry(code: string, path: string, options?: EmitEntryOptions): Promise<void>;
-  /**
-   * 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: string, path: string, options?: EmitEntryOptions): void;
-  /**
-   * 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
-   */
-  emitBuiltin(code: string, id: string, options?: EmitOptions): Promise<void>;
-  /**
-   * 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: string, id: string, options?: EmitOptions): void;
-  /**
-   * 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
-   */
-  emitInfrastructure(code: string, id: string, options?: EmitOptions): Promise<void>;
-  /**
-   * 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: string, id: string, options?: EmitOptions): void;
-  /**
-   * Generates a checksum representing the current context state
-   *
-   * @param root - The root directory of the project to generate the checksum for
-   * @returns A promise that resolves to a string representing the checksum
-   */
-  generateChecksum(root?: string): Promise<string>;
+  protected constructor(options: EngineOptions, initialConfig?: DeepPartial<UserConfig>);
   /**
    * Initialize the context with the provided configuration options
-   */
-  setup(): Promise<void>;
-  /**
-   * The resolved configuration for this context
-   */
-  protected resolvedConfig: TResolvedConfig;
-  /**
-   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
    *
    * @remarks
-   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.
-   *
-   * @returns The cloned context.
-   */
-  protected copyTo(context: Context<TResolvedConfig>): Context<TResolvedConfig>;
-  /**
-   * Initialize the context with the provided configuration options
-   *
-   *   @remarks
    * This method will set up the resolver and load the user configuration file based on the provided options. It is called during the construction of the context and can also be called when cloning the context to ensure that the new context has the same configuration and resolver setup.
-   *
-   * @param options - The configuration options to initialize the context with
-   */
-  protected init(options: ExecutionOptions, initialConfig?: InitialConfig<any>): Promise<void>;
-  /**
-   * Initialize the context with the provided configuration options
    */
-  protected innerSetup(): Promise<void>;
-}
-//#endregion
-//#region src/context/engine-context.d.ts
-declare class PowerlinesEngineContext extends PowerlinesBaseContext implements EngineContext {
-  #private;
-  /**
-   * Creates a new instance of the PowerlinesEngineContext class.
-   *
-   * @param options - The options to initialize the context with.
-   * @returns A promise that resolves to an instance of the PowerlinesEngineContext class.
-   */
-  static init(options: EngineOptions, initialConfig?: InitialConfig<any>): Promise<PowerlinesEngineContext>;
+  protected init(): Promise<void>;
   /**
    * A list of all command executions that will be run during the lifecycle of the engine
    *
@@ -521,94 +53,26 @@ declare class PowerlinesEngineContext extends PowerlinesBaseContext implements E
 }
 //#endregion
 //#region src/context/environment-context.d.ts
-declare class PowerlinesEnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesContext<TResolvedConfig> implements EnvironmentContext<TResolvedConfig> {
+declare class PowerlinesEnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesContext<EnvironmentResolvedConfig<TResolvedConfig>> implements Unstable_EnvironmentContext<TResolvedConfig> {
   #private;
   /**
    * Create a new context from the config.
    *
    * @param options - The resolved execution options.
    * @param config - The user configuration options.
-   * @returns A promise that resolves to the new context.
+   * @param overriddenConfig - The configuration options that should override all other configuration sources, such as CLI flags or environment variables. This is used to ensure that certain configuration values take precedence over any other settings defined in the user configuration or environment configuration, allowing for dynamic overrides based on the execution context.
+   * @param environment - The resolved environment configuration, which may include additional properties or modifications made during the configuration loading process. This is used to provide context about the environment in which the command is being executed, allowing for environment-specific behavior and configuration resolution.
+   * @returns A promise that resolves to an instance of the PowerlinesEnvironmentContext class, initialized with the provided configuration and environment data.
    */
-  static fromConfig<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(options: ExecutionOptions, config: TResolvedConfig, environment: EnvironmentResolvedConfig): Promise<PowerlinesEnvironmentContext<TResolvedConfig>>;
+  static createEnvironment<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(options: ExecutionOptions, config: TResolvedConfig, overriddenConfig: InferOverridableConfig<EnvironmentResolvedConfig<TResolvedConfig>>, environment: EnvironmentResolvedConfig<TResolvedConfig>["environment"]): Promise<PowerlinesEnvironmentContext<TResolvedConfig>>;
   /**
-   * The resolved environment configuration
+   * The configuration options provided by plugins added by the user (and other plugins)
    */
-  environment: EnvironmentResolvedConfig;
+  protected environmentConfig: EnvironmentResolvedConfig<TResolvedConfig>["environment"];
   /**
    * The list of plugins applied to this environment
    */
   plugins: EnvironmentContextPlugin<TResolvedConfig>[];
-  /**
-   * The unique identifier of the environment associated with this context, which can be used for logging and other purposes to distinguish between different environments in the same process.
-   */
-  get id(): string;
-  /**
-   * The hooks registered by plugins in this environment
-   */
-  get hooks(): Record<string, HooksList<PluginContext<TResolvedConfig>>>;
-  /**
-   * Create a new logger instance
-   *
-   * @param options - The configuration options to use for the logger instance, which can be used to customize the appearance and behavior of the log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance.
-   * @param logFn - The custom logging function to use for logging messages, which can be used to override the default logging behavior of the original logger.
-   * @returns A logger client instance that can be used to generate log messages with consistent formatting and metadata.
-   */
-  createLogger(options: LoggerOptions, logFn?: LogFn): Logger;
-  /**
-   * Extend the base logger with additional configuration options
-   *
-   * @param options - The configuration options to extend the base logger with, which can be used to add additional metadata or customize the appearance of log messages generated by the logger. This is typically the name of the plugin or module that is creating the logger instance, as well as any additional metadata such as the plugin category or environment.
-   * @returns A new logger client instance that extends the base logger with the provided configuration options.
-   */
-  extendLogger(options: LoggerOptions): Logger;
-  /**
-   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
-   *
-   * @remarks
-   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.
-   *
-   * @returns A promise that resolves to the cloned context.
-   */
-  clone(): Promise<EnvironmentContext<TResolvedConfig>>;
-  /**
-   * Initialize the context with the provided configuration options
-   */
-  setup(): Promise<void>;
-  addPlugin(plugin: Plugin<PluginContext<TResolvedConfig>>): Promise<void>;
-  /**
-   * Retrieves the hook handlers for a specific hook name
-   */
-  selectHooks<TKey extends string>(key: TKey, options?: SelectHooksOptions): SelectHookResult<PluginContext<TResolvedConfig>, TKey>;
-  protected constructor(options: ExecutionOptions, config: TResolvedConfig, environment: EnvironmentResolvedConfig);
-  /**
-   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
-   *
-   * @remarks
-   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.
-   *
-   * @returns The cloned context.
-   */
-  protected copyTo(context: EnvironmentContext<TResolvedConfig>): EnvironmentContext<TResolvedConfig>;
-}
-//#endregion
-//#region src/context/execution-context.d.ts
-declare class PowerlinesExecutionContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends PowerlinesContext<TResolvedConfig> implements ExecutionContext<TResolvedConfig> {
-  #private;
-  /**
-   * Create a new Storm context from the workspace root and user config.
-   *
-   * @param options - The options for resolving the context.
-   * @returns A promise that resolves to the new context.
-   */
-  static init<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(options: ExecutionOptions, initialConfig: InitialConfig<TResolvedConfig["userConfig"]>): Promise<ExecutionContext<TResolvedConfig>>;
-  /**
-   * Create a new Storm context from the workspace root and user config.
-   *
-   * @param options - The options for resolving the context.
-   * @returns A promise that resolves to the new context.
-   */
-  static inline<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(options: ExecutionOptions, initialConfig: InitialConfig<TResolvedConfig["userConfig"]>, inlineConfig: InlineConfig<TResolvedConfig["userConfig"]>): Promise<ExecutionContext<TResolvedConfig>>;
   /**
    * Internal context fields and methods
    *
@@ -628,20 +92,20 @@ declare class PowerlinesExecutionContext<TResolvedConfig extends ResolvedConfig
    */
   set $$internal(value: Unstable_ContextInternal<TResolvedConfig>);
   /**
-   * The unique identifier of the execution context, which can be used for logging and other purposes to distinguish between different executions in the same process.
+   * The unique identifier of the environment associated with this context, which can be used for logging and other purposes to distinguish between different environments in the same process.
    */
   get id(): string;
   /**
-   * A record of all environments by name
+   * The hooks registered by plugins in this environment
    */
-  get environments(): Record<string, Unstable_EnvironmentContext<TResolvedConfig>>;
-  get plugins(): Array<Plugin<PluginContext<TResolvedConfig>>>;
+  get hooks(): Record<string, HooksList<PluginContext<TResolvedConfig>>>;
   /**
-   * Creates a new instance.
+   * A setter function to populate the environment 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 environment configuration values, which may be used during the configuration resolution process to ensure that the final configuration reflects both the user configuration and any environment configuration provided during execution.
    *
-   * @param options - The options to use for creating the context, including the resolved configuration and workspace settings.
+   * @param config - The environment configuration values to set.
+   * @returns A promise that resolves when the environment configuration values have been set.
    */
-  protected constructor(options: ExecutionOptions);
+  protected setEnvironmentConfig(config: EnvironmentResolvedConfig<TResolvedConfig>["environment"]): Promise<void>;
   /**
    * Create a new logger instance
    *
@@ -657,55 +121,18 @@ declare class PowerlinesExecutionContext<TResolvedConfig extends ResolvedConfig
    * @returns A new logger client instance that extends the base logger with the provided configuration options.
    */
   extendLogger(options: LoggerOptions): Logger;
-  /**
-   * Creates a clone of the current context with the same configuration and workspace settings. This can be useful for running multiple builds in parallel or for creating isolated contexts for different parts of the build process.
-   *
-   * @remarks
-   * The cloned context will have the same configuration and workspace settings as the original context, but will have a different build ID, release ID, and timestamp. The virtual file system and caches will also be separate between the original and cloned contexts.
-   *
-   * @returns A promise that resolves to the cloned context.
-   */
-  clone(): Promise<ExecutionContext<TResolvedConfig>>;
-  /**
-   * 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.
-   */
-  in(environment: EnvironmentResolvedConfig): Promise<Unstable_EnvironmentContext<TResolvedConfig>>;
-  /**
-   * Update the context using a new inline configuration options
-   */
-  setup(): Promise<void>;
-  /**
-   * Add a plugin to the API context and all environments
-   *
-   * @param plugin - The plugin to add.
-   */
   addPlugin(plugin: Plugin<PluginContext<TResolvedConfig>>): Promise<void>;
   /**
-   * 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.
-   */
-  getEnvironment(name?: string): Promise<EnvironmentContext<TResolvedConfig>>;
-  /**
-   * 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.
+   * Retrieves the hook handlers for a specific hook name
    */
-  getEnvironmentSafe(name?: string): Promise<EnvironmentContext<TResolvedConfig> | undefined>;
+  selectHooks<TKey extends string>(key: TKey, options?: SelectHooksOptions): SelectHookResult<PluginContext<TResolvedConfig>, TKey>;
+  protected constructor(options: ExecutionOptions, config: TResolvedConfig, overriddenConfig: InferOverridableConfig<EnvironmentResolvedConfig<TResolvedConfig>>);
   /**
-   * A function to merge all configured environments into a single context.
-   *
-   * @remarks
-   * If only one environment is configured, that environment will be returned directly.
+   * 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 A promise that resolves to a merged/global environment context.
+   * @returns The merged configuration object that combines the initial, user, inline, and plugin configurations.
    */
-  toEnvironment(): Promise<EnvironmentContext<TResolvedConfig>>;
+  protected mergeConfig(): EnvironmentResolvedConfig<TResolvedConfig>;
 }
 //#endregion
 //#region src/context/plugin-context.d.ts
@@ -717,7 +144,7 @@ declare class PowerlinesExecutionContext<TResolvedConfig extends ResolvedConfig
  * @param environment - The environment context
  * @returns The proxied plugin context
  */
-declare function createPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(pluginId: string, plugin: Plugin<PluginContext<TResolvedConfig>>, environment: Unstable_EnvironmentContext<TResolvedConfig>): Unstable_PluginContext<TResolvedConfig>;
+declare function createPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig>(pluginId: string, plugin: Plugin<PluginContext<TResolvedConfig>>, environment: PowerlinesEnvironmentContext<TResolvedConfig>): Unstable_PluginContext<TResolvedConfig>;
 //#endregion
 export { PowerlinesBaseContext, PowerlinesContext, PowerlinesEngineContext, PowerlinesEnvironmentContext, PowerlinesExecutionContext, createPluginContext };
 //# sourceMappingURL=index.d.mts.map