powerlines 0.10.2 → 0.12.0

package/dist/lib/{config-B_WTwd49.d.ts → context-tEqvC3yI.d.ts}

@@ -1,11 +1,15 @@
-import { Format } from '@storm-software/build-tools/types';
+import { EnvPaths } from '@stryke/env/get-env-paths';
+import { PackageJson } from '@stryke/types/package-json';
+import { Worker } from 'jest-worker';
+import { Jiti } from 'jiti';
+import { ParserOptions, ParseResult } from 'oxc-parser';
+import { Range } from 'semver';
+import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext } from 'unplugin';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
-import { StormWorkspaceConfig } from '@storm-software/config/types';
-import { NonUndefined, MaybePromise, FunctionLike } from '@stryke/types/base';
-import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
+import { MaybePromise, FunctionLike, NonUndefined } from '@stryke/types/base';
+import { TypeDefinitionParameter, TypeDefinition } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
-import { ResolvedConfig as ResolvedConfig$1, ConfigLayer } from 'c12';
-import { UserConfig as UserConfig$1, ResolvedPreviewOptions, PreviewOptions } from 'vite';
+import { UserConfig as UserConfig$1, PreviewOptions, ResolvedPreviewOptions } from 'vite';
 import { UserConfig as UserConfig$2 } from '@farmfe/core';
 import { Configuration as Configuration$1 } from '@rspack/core';
 import { ESBuildOptions } from '@storm-software/esbuild/types';
@@ -14,18 +18,14 @@ import { BuildOptions } from 'esbuild';
 import { RolldownOptions, RolldownOutput } from 'rolldown';
 import { RollupOptions, OutputOptions } from 'rollup';
 import { Configuration } from 'webpack';
-import { EnvPaths } from '@stryke/env/get-env-paths';
-import { PackageJson } from '@stryke/types/package-json';
-import { Worker } from 'jest-worker';
-import { Jiti } from 'jiti';
-import { ParserOptions, ParseResult } from 'oxc-parser';
-import { Range } from 'semver';
-import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext } from 'unplugin';
+import { Format } from '@storm-software/build-tools/types';
+import { StormWorkspaceConfig } from '@storm-software/config/types';
+import { ResolvedConfig as ResolvedConfig$1, ConfigLayer } from 'c12';
+import { T as TSConfig, P as ParsedTypeScriptConfig } from './tsconfig-Bz-CiFqD.js';
 import { ArrayValues } from '@stryke/types/array';
-import { P as ParsedTypeScriptConfig, T as TSConfig } from './tsconfig-Bz-CiFqD.js';
 import { PrimitiveJsonValue } from '@stryke/json/types';
 import { Volume } from 'memfs';
-import { StatSyncOptions, Stats, PathLike, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
+import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
 import { IUnionFs } from 'unionfs';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
@@ -103,82 +103,6 @@ type UnbuildResolvedBuildConfig = UnbuildOptions & BuildResolvedConfig;
 type FarmBuildConfig = Partial<Omit<UserConfig$2, "tsconfig" | "tsconfigRaw" | "assets" | "outputPath" | "mode" | "format" | "platform" | "projectRoot" | "env" | "entry" | "entryPoints">> & BuildConfig;
 type FarmResolvedBuildConfig = UserConfig$2 & BuildResolvedConfig;
 
-interface ResolvedEntryTypeDefinition extends TypeDefinition {
-    /**
-     * The user provided entry point in the source code
-     */
-    input: TypeDefinition;
-    /**
-     * An optional name to use in the package export during the build process
-     */
-    output?: string;
-}
-type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview" | "mainFields" | "extensions"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr" | "mainFields" | "extensions">> & {
-    /**
-     * The name of the environment
-     */
-    name: string;
-    /**
-     * Configuration options for the preview server
-     */
-    preview?: ResolvedPreviewOptions;
-};
-type ResolvedAssetGlob = AssetGlob & Required<Pick<AssetGlob, "input">>;
-type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
-    assets: ResolvedAssetGlob[];
-}>;
-/**
- * The resolved options for the Powerlines project configuration.
- */
-type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "build" | "transform" | "override" | "framework">> & {
-    /**
-     * The configuration options that were provided inline to the Powerlines CLI.
-     */
-    inlineConfig: InlineConfig<TUserConfig>;
-    /**
-     * The original configuration options that were provided by the user to the Powerlines process.
-     */
-    userConfig: TUserConfig;
-    /**
-     * A string identifier for the Powerlines command being executed.
-     */
-    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
-    /**
-     * The root directory of the project's source code
-     *
-     * @defaultValue "\{projectRoot\}/src"
-     */
-    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
-    /**
-     * The root directory of the project.
-     */
-    projectRoot: NonUndefined<TUserConfig["root"]>;
-    /**
-     * The type of project being built.
-     */
-    projectType: NonUndefined<TUserConfig["type"]>;
-    /**
-     * The output configuration options to use for the build process
-     */
-    output: OutputResolvedConfig;
-    /**
-     * The log level to use for the Powerlines processes.
-     *
-     * @defaultValue "info"
-     */
-    logLevel: LogLevelLabel | null;
-};
-type ViteResolvedConfig = ResolvedConfig<ViteUserConfig>;
-type WebpackResolvedConfig = ResolvedConfig<WebpackUserConfig>;
-type RspackResolvedConfig = ResolvedConfig<RspackUserConfig>;
-type ESBuildResolvedConfig = ResolvedConfig<ESBuildUserConfig>;
-type RollupResolvedConfig = ResolvedConfig<RollupUserConfig>;
-type RolldownResolvedConfig = ResolvedConfig<RolldownUserConfig>;
-type TsupResolvedConfig = ResolvedConfig<TsupUserConfig>;
-type UnbuildResolvedConfig = ResolvedConfig<UnbuildUserConfig>;
-type FarmResolvedConfig = ResolvedConfig<FarmUserConfig>;
-type InferResolvedConfig<TBuildVariant extends BuildVariant | undefined> = TBuildVariant extends undefined ? ResolvedConfig : TBuildVariant extends "webpack" ? WebpackResolvedConfig : TBuildVariant extends "rspack" ? RspackResolvedConfig : TBuildVariant extends "vite" ? ViteResolvedConfig : TBuildVariant extends "esbuild" ? ESBuildResolvedConfig : TBuildVariant extends "unbuild" ? UnbuildResolvedConfig : TBuildVariant extends "tsup" ? TsupResolvedConfig : TBuildVariant extends "rolldown" ? RolldownResolvedConfig : TBuildVariant extends "rollup" ? RollupResolvedConfig : TBuildVariant extends "farm" ? FarmResolvedConfig : ResolvedConfig;
-
 declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "release", "finalize"];
 type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
 
@@ -391,35 +315,6 @@ interface Plugin<in out TContext extends PluginContext<ResolvedConfig> = PluginC
     applyToEnvironment?: (environment: EnvironmentResolvedConfig) => MaybePromise<boolean | Plugin<any>>;
 }
 
-type BaseHooks<TContext extends PluginContext = PluginContext> = BasePluginHookFunctions<TContext>;
-type BaseHookKeys<TContext extends PluginContext = PluginContext> = keyof BaseHooks<TContext>;
-type ExternalHooks<TContext extends PluginContext = PluginContext> = ExternalPluginHookFunctions<TContext>;
-type ExternalHookKeys<TContext extends PluginContext = PluginContext> = keyof ExternalHooks<TContext>;
-type Hooks<TContext extends PluginContext = PluginContext> = PluginHookFunctions<TContext>;
-type HookKeys<TContext extends PluginContext = PluginContext> = keyof Hooks<TContext>;
-interface BaseHooksListItem<TContext extends PluginContext = PluginContext, TKey extends BaseHookKeys<TContext> = BaseHookKeys<TContext>> extends PluginHookObject<BaseHooks<TContext>[TKey]> {
-    plugin: Plugin<TContext>;
-}
-interface BaseHooksList<TContext extends PluginContext = PluginContext, TKey extends BaseHookKeys<TContext> = BaseHookKeys<TContext>> {
-    preOrdered?: BaseHooksListItem<TContext, TKey>[];
-    preEnforced?: BaseHooksListItem<TContext, TKey>[];
-    normal?: BaseHooksListItem<TContext, TKey>[];
-    postEnforced?: BaseHooksListItem<TContext, TKey>[];
-    postOrdered?: BaseHooksListItem<TContext, TKey>[];
-}
-interface ExternalHooksListItem<TContext extends PluginContext = PluginContext, TKey extends ExternalHookKeys<TContext> = ExternalHookKeys<TContext>> {
-    plugin: Plugin<TContext>;
-    handler: ExternalHooks<TContext>[TKey];
-}
-type HooksList<TContext extends PluginContext = PluginContext> = {
-    [TKey in BaseHookKeys<TContext>]?: BaseHooksList<TContext, TKey>;
-} & {
-    [TKey in ExternalHookKeys<TContext>]?: ExternalHooksListItem<TContext, TKey>[];
-};
-type InferHookHandler<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Hooks<TContext>[TKey];
-type InferHookReturnType<TContext extends PluginContext, TKey extends HookKeys<TContext>> = ReturnType<InferHookHandler<TContext, TKey>> extends Promise<infer U> ? U extends Promise<infer V> ? V : U : ReturnType<InferHookHandler<TContext, TKey>>;
-type InferHookParameters<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Parameters<InferHookHandler<TContext, TKey>>;
-
 declare const __VFS_INIT__ = "__VFS_INIT__";
 declare const __VFS_REVERT__ = "__VFS_REVERT__";
 declare const __VFS_CACHE__ = "__VFS_CACHE__";
@@ -549,6 +444,13 @@ interface VirtualFileSystemInterface {
      * @returns `true` if the file exists, otherwise `false`.
      */
     existsSync: (pathOrId: string) => boolean;
+    /**
+     * Gets the metadata of a file in the virtual file system (VFS).
+     *
+     * @param pathOrId - The path or id of the file.
+     * @returns The metadata of the file if it exists, otherwise undefined.
+     */
+    getMetadata: (pathOrId: PathLike) => VirtualFileSystemMetadata | undefined;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -645,13 +547,20 @@ interface VirtualFileSystemInterface {
      */
     rmdir: (path: PathLike, options?: RmDirOptions & ResolveFSOptions) => Promise<void>;
     /**
-     * Removes a file in the virtual file system (VFS).
+     * Removes a file or directory in the virtual file system (VFS).
      *
-     * @param path - The path to the file to remove.
-     * @param options - Options for removing the file.
-     * @returns A promise that resolves when the file is removed.
+     * @param path - The path to the file or directory to remove.
+     * @param options - Options for removing the file or directory.
+     * @returns A promise that resolves when the file or directory is removed.
      */
     rm: (path: PathLike, options?: RmOptions & ResolveFSOptions) => Promise<void>;
+    /**
+     * Synchronously removes a file or directory in the virtual file system (VFS).
+     *
+     * @param path - The path to the file or directory to remove.
+     * @param options - Options for removing the file or directory.
+     */
+    rmSync: (path: PathLike, options?: RmOptions & ResolveFSOptions) => void;
     /**
      * Creates a directory in the virtual file system (VFS).
      *
@@ -698,6 +607,48 @@ interface VirtualFileSystemInterface {
      * @param options - Optional parameters for writing the file.
      */
     writeFileSync: (path: PathOrFileDescriptor, data?: WriteFileData, options?: WriteFileOptions) => void;
+    /**
+     * Moves a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
+     */
+    move: (srcPath: string, destPath: string) => Promise<void>;
+    /**
+     * Synchronously moves a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to move
+     * @param destPath - The destination path to move to
+     */
+    moveSync: (srcPath: string, destPath: string) => void;
+    /**
+     * Copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
+     */
+    copy: (srcPath: string, destPath: string) => Promise<void>;
+    /**
+     * Synchronously copies a file from one path to another in the virtual file system (VFS).
+     *
+     * @param srcPath - The source path to copy
+     * @param destPath - The destination path to copy to
+     */
+    copySync: (srcPath: string, destPath: string) => void;
+    /**
+     * Glob files in the virtual file system (VFS) based on the provided pattern(s).
+     *
+     * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
+     * @returns An array of file paths matching the provided pattern(s)
+     */
+    glob: (pattern: string | string[]) => Promise<string[]>;
+    /**
+     * Synchronously glob files in the virtual file system (VFS) based on the provided pattern(s).
+     *
+     * @param pattern - A pattern (or multiple patterns) to use to determine the file paths to return
+     * @returns An array of file paths matching the provided pattern(s)
+     */
+    globSync: (pattern: string | string[]) => string[];
     /**
      * Resolves a path or id to a file path in the virtual file system.
      *
@@ -751,664 +702,773 @@ interface VirtualFileSystemInterface {
     [__VFS_UNIFIED__]: IUnionFs;
 }
 
-type WorkerProcess<TExposedMethods extends ReadonlyArray<string>> = {
-    [K in TExposedMethods[number]]: (data: any) => Promise<any>;
-} & {
-    close: () => void;
-    end: () => ReturnType<Worker["end"]>;
+type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
+/**
+ * The {@link StormWorkspaceConfig | configuration} object for an entire Powerlines workspace
+ */
+type WorkspaceConfig = Partial<StormWorkspaceConfig> & Required<Pick<StormWorkspaceConfig, "workspaceRoot">>;
+type PluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<Plugin<TContext>>;
+/**
+ * A configuration tuple for a Powerlines plugin.
+ */
+type PluginConfigTuple<TContext extends PluginContext = PluginContext, TOptions = any> = [string | PluginFactory<TContext, TOptions>, TOptions] | [Plugin<TContext>];
+/**
+ * A configuration object for a Powerlines plugin.
+ */
+type PluginConfigObject<TContext extends PluginContext = PluginContext, TOptions = any> = {
+    plugin: string | PluginFactory<TContext, TOptions>;
+    options: TOptions;
+} | {
+    plugin: Plugin<TContext>;
+    options?: never;
 };
-interface MetaInfo {
+/**
+ * A configuration tuple for a Powerlines plugin.
+ */
+type PluginConfig<TContext extends PluginContext = PluginContext> = string | PluginFactory<TContext, void> | Plugin<TContext> | Promise<Plugin<TContext>> | PluginConfigTuple<TContext> | PluginConfigObject<TContext>;
+type ProjectType = "application" | "library";
+interface OutputConfig {
     /**
-     * The checksum generated from the resolved options
+     * The path to output the final compiled files to
+     *
+     * @remarks
+     * If a value is not provided, Powerlines will attempt to:
+     * 1. Use the `outDir` value in the `tsconfig.json` file.
+     * 2. Use the `dist` directory in the project root directory.
+     *
+     * @defaultValue "dist/\{projectRoot\}"
      */
-    checksum: string;
+    outputPath?: string;
     /**
-     * The build id
+     * The format of the output files
+     *
+     * @defaultValue "virtual"
      */
-    buildId: string;
+    mode?: OutputModeType;
     /**
-     * The release id
+     * The path of the generated runtime declaration file relative to the workspace root.
+     *
+     * @defaultValue "\{projectRoot\}/powerlines.d.ts"
      */
-    releaseId: string;
+    dts?: string | false;
     /**
-     * The build timestamp
+     * A prefix to use for identifying builtin modules
+     *
+     * @remarks
+     * This prefix will be used to identify all builtin modules generated during the "prepare" phase. An example builtin ID for a module called `"utils"` would be `"{builtinPrefix}:utils"`.
+     *
+     * @defaultValue "powerlines"
      */
-    timestamp: number;
+    builtinPrefix?: string;
     /**
-     * A hash that represents the path to the project root directory
+     * The folder where the generated runtime artifacts will be located
+     *
+     * @remarks
+     * This folder will contain all runtime artifacts and builtins generated during the "prepare" phase.
+     *
+     * @defaultValue "\{projectRoot\}/.powerlines"
      */
-    projectRootHash: string;
+    artifactsFolder?: string;
     /**
-     * A hash that represents the path to the project root directory
+     * The module format of the output files
+     *
+     * @remarks
+     * This option can be a single format or an array of formats. If an array is provided, multiple builds will be generated for each format.
+     *
+     * @defaultValue "esm"
      */
-    configHash: string;
+    format?: Format | Format[];
     /**
-     * A mapping of runtime ids to their corresponding file paths
+     * A list of assets to copy to the output directory
+     *
+     * @remarks
+     * The assets can be specified as a string (path to the asset) or as an object with a `glob` property (to match multiple files). The paths are relative to the project root directory.
      */
-    builtinIdMap: Record<string, string>;
+    assets?: Array<string | AssetGlob>;
+}
+interface BaseConfig {
     /**
-     * A mapping of virtual file paths to their corresponding file contents
+     * The name of the project
      */
-    virtualFiles: Record<string, string | null>;
-}
-interface Resolver extends Jiti {
-    plugin: Jiti;
-}
-interface SelectHooksOptions {
-    order?: "pre" | "post" | "normal";
-}
-interface InitContextOptions {
+    name?: string;
     /**
-     * If false, the plugin will be loaded after all other plugins.
+     * The project display title
      *
-     * @defaultValue true
+     * @remarks
+     * This option is used in documentation generation and other places where a human-readable title is needed.
      */
-    isHighPriority: boolean;
-}
-interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+    title?: string;
     /**
-     * The Storm workspace configuration
+     * A description of the project
+     *
+     * @remarks
+     * If this option is not provided, the build process will try to use the \`description\` value from the `\package.json\` file.
      */
-    workspaceConfig: WorkspaceConfig;
+    description?: string;
     /**
-     * An object containing the options provided to Powerlines
+     * The log level to use for the Powerlines processes.
+     *
+     * @defaultValue "info"
      */
-    config: TResolvedConfig;
+    logLevel?: LogLevelLabel | null;
     /**
-     * A logging function for the Powerlines engine
+     * A custom logger function to use for logging messages
      */
-    log: LogFn;
+    customLogger?: LogFn;
     /**
-     * The metadata information
+     * Explicitly set a mode to run in. This mode will be used at various points throughout the Powerlines processes, such as when compiling the source code.
+     *
+     * @defaultValue "production"
      */
-    meta: MetaInfo;
+    mode?: "development" | "test" | "production";
     /**
-     * The metadata information currently written to disk
+     * The entry point(s) for the application
      */
-    persistedMeta?: MetaInfo;
+    entry?: TypeDefinitionParameter | TypeDefinitionParameter[];
     /**
-     * The parsed TypeScript configuration from the `tsconfig.json` file
+     * Configuration for linting the source code
      */
-    tsconfig: ParsedTypeScriptConfig;
+    lint?: Record<string, any> | false;
     /**
-     * The entry points of the source code
+     * Configuration for testing the source code
      */
-    entry: ResolvedEntryTypeDefinition[];
+    test?: Record<string, any> | false;
     /**
-     * The relative path to the Powerlines workspace root directory
+     * Configuration for the output of the build process
      */
-    relativeToWorkspaceRoot: string;
+    output?: OutputConfig;
     /**
-     * The Powerlines artifacts directory
+     * Configuration for the transformation of the source code
      */
-    artifactsPath: string;
+    transform?: Record<string, any>;
     /**
-     * The path to the Powerlines builtin runtime modules directory
+     * Options to to provide to the build process
      */
-    builtinsPath: string;
+    build?: BuildConfig;
     /**
-     * The path to the Powerlines entry modules directory
+     * Configuration for documentation generation
+     *
+     * @remarks
+     * This configuration will be used by the documentation generation plugins during the `docs` command.
      */
-    entryPath: string;
+    docs?: Record<string, any>;
     /**
-     * The path to the Powerlines TypeScript declaration files directory
+     * The path to the tsconfig file to be used by the compiler
+     *
+     * @remarks
+     * If a value is not provided, the plugin will attempt to find the `tsconfig.json` file in the project root directory. The parsed tsconfig compiler options will be merged with the {@link Options.tsconfigRaw} value (if provided).
+     *
+     * @defaultValue "\{projectRoot\}/tsconfig.json"
      */
-    dtsPath: string;
+    tsconfig?: string;
     /**
-     * The path to a directory where the reflection data buffers (used by the build processes) are stored
+     * The raw {@link TSConfig} object to be used by the compiler. This object will be merged with the `tsconfig.json` file.
+     *
+     * @see https://www.typescriptlang.org/tsconfig
+     *
+     * @remarks
+     * If populated, this option takes higher priority than `tsconfig`
      */
-    dataPath: string;
+    tsconfigRaw?: TSConfig;
+}
+interface EnvironmentConfig extends BaseConfig {
     /**
-     * The path to a directory where the project cache (used by the build processes) is stored
+     * Array of strings indicating the order in which fields in a package.json file should be resolved to determine the entry point for a module.
+     *
+     * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
      */
-    cachePath: string;
+    mainFields?: string[];
     /**
-     * The Powerlines environment paths
+     * Array of strings indicating what conditions should be used for module resolution.
      */
-    envPaths: EnvPaths;
+    conditions?: string[];
     /**
-     * The file system path to the Powerlines package installation
+     * Array of strings indicating what conditions should be used for external modules.
      */
-    powerlinesPath: string;
+    externalConditions?: string[];
     /**
-     * The dependency installations required by the project
+     * Array of strings indicating what file extensions should be used for module resolution.
+     *
+     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
      */
-    dependencies: Record<string, string | Range>;
+    extensions?: string[];
     /**
-     * The development dependency installations required by the project
+     * Array of strings indicating what modules should be deduplicated to a single version in the build.
+     *
+     * @remarks
+     * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
      */
-    devDependencies: Record<string, string | Range>;
+    dedupe?: string[];
     /**
-     * The project's `package.json` file content
+     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
      */
-    packageJson: PackageJson & Record<string, any>;
+    builtins?: (string | RegExp)[];
     /**
-     * The project's `project.json` file content
+     * Configuration options for the preview server
      */
-    projectJson?: Record<string, any>;
+    preview?: PreviewOptions;
     /**
-     * The virtual file system manager used during the build process to reference generated runtime files
+     * A flag indicating whether the build is for a Server-Side Rendering environment.
      */
-    fs: VirtualFileSystemInterface;
+    ssr?: boolean;
     /**
-     * The Jiti module resolver
+     * Define if this environment is used for Server-Side Rendering
+     *
+     * @defaultValue "server" (if it isn't the client environment)
      */
-    resolver: Resolver;
+    consumer?: "client" | "server";
+}
+interface CommonUserConfig extends BaseConfig {
     /**
-     * The builtin module id that exist in the Powerlines virtual file system
+     * The type of project being built
+     *
+     * @defaultValue "application"
      */
-    builtins: string[];
+    type?: ProjectType;
     /**
-     * The Powerlines builtin virtual files
+     * The root directory of the project
      */
-    getBuiltins: () => Promise<VirtualFile[]>;
+    root: string;
     /**
-     * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
+     * The root directory of the project's source code
      *
-     * @param code - The source code of the builtin file
-     * @param id - The unique identifier of the builtin file
-     * @param path - An optional path to write the builtin file to
-     * @param options - Options for writing the file
+     * @defaultValue "\{root\}/src"
      */
-    writeBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    sourceRoot?: string;
     /**
-     * Resolves a entry virtual file and writes it to the VFS if it does not already exist
+     * A path to a custom configuration file to be used instead of the default `storm.json`, `powerlines.config.js`, or `powerlines.config.ts` files.
      *
-     * @param code - The source code of the entry file
-     * @param path - An optional path to write the entry file to
-     * @param options - Options for writing the file
+     * @remarks
+     * This option is useful for running Powerlines commands with different configuration files, such as in CI/CD environments or when testing different configurations.
      */
-    writeEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
+    configFile?: string;
     /**
-     * Parses the source code and returns a {@link ParseResult} object.
+     * Should the Powerlines CLI processes skip installing missing packages?
+     *
+     * @remarks
+     * This option is useful for CI/CD environments where the installation of packages is handled by a different process.
+     *
+     * @defaultValue false
      */
-    parse: (code: string, id: string, options?: ParserOptions | null) => Promise<ParseResult>;
+    skipInstalls?: boolean;
     /**
-     * A function to update the context fields using a new user configuration options
+     * Should the compiler processes skip any improvements that make use of cache?
+     *
+     * @defaultValue false
      */
-    withUserConfig: (userConfig: UserConfig, options?: InitContextOptions) => Promise<void>;
+    skipCache?: boolean;
     /**
-     * A function to update the context fields using inline configuration options
+     * A list of resolvable paths to plugins used during the build process
      */
-    withInlineConfig: (inlineConfig: InlineConfig, options?: InitContextOptions) => Promise<void>;
+    plugins?: PluginConfig<PluginContext<any>>[];
     /**
-     * Create a new logger instance
-     *
-     * @param name - The name to use for the logger instance
-     * @returns A logger function
+     * Environment-specific configurations
      */
-    createLog: (name: string | null) => LogFn;
+    environments?: Record<string, EnvironmentConfig>;
     /**
-     * Extend the current logger instance with a new name
+     * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
      *
-     * @param name - The name to use for the extended logger instance
-     * @returns A logger function
+     * @defaultValue "powerlines"
      */
-    extendLog: (name: string) => LogFn;
+    framework?: string;
 }
-interface APIContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
+type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = CommonUserConfig & {
+    build?: TBuildConfig & {
+        /**
+         * The build variant being used by the Powerlines engine.
+         */
+        variant?: TBuildVariant;
+    };
+    override?: Partial<TBuildResolvedConfig>;
+};
+type WebpackUserConfig = UserConfig<WebpackBuildConfig, WebpackResolvedBuildConfig, "webpack">;
+type RspackUserConfig = UserConfig<RspackBuildConfig, RspackResolvedBuildConfig, "rspack">;
+type RollupUserConfig = UserConfig<RollupBuildConfig, RollupResolvedBuildConfig, "rollup">;
+type RolldownUserConfig = UserConfig<RolldownBuildConfig, RolldownResolvedBuildConfig, "rolldown">;
+type ViteUserConfig = UserConfig<ViteBuildConfig, ViteResolvedBuildConfig, "vite">;
+type ESBuildUserConfig = UserConfig<ESBuildBuildConfig, ESBuildResolvedBuildConfig, "esbuild">;
+type UnbuildUserConfig = UserConfig<UnbuildBuildConfig, UnbuildResolvedBuildConfig, "unbuild">;
+type TsupUserConfig = UserConfig<TsupBuildConfig, TsupResolvedBuildConfig, "tsup">;
+type FarmUserConfig = UserConfig<FarmBuildConfig, FarmResolvedBuildConfig, "farm">;
+type InferUserConfig<TBuildVariant extends BuildVariant | undefined> = TBuildVariant extends "webpack" ? WebpackUserConfig : TBuildVariant extends "rspack" ? RspackUserConfig : TBuildVariant extends "vite" ? ViteUserConfig : TBuildVariant extends "esbuild" ? ESBuildUserConfig : TBuildVariant extends "unbuild" ? UnbuildUserConfig : TBuildVariant extends "tsup" ? TsupUserConfig : TBuildVariant extends "rolldown" ? RolldownUserConfig : TBuildVariant extends "rollup" ? RollupUserConfig : TBuildVariant extends "farm" ? FarmUserConfig : UserConfig;
+type InitialUserConfig<TUserConfig extends UserConfig = UserConfig> = Partial<TUserConfig> & {
+    root: string;
+};
+type ParsedUserConfig<TUserConfig extends UserConfig = UserConfig> = TUserConfig & ResolvedConfig$1<TUserConfig> & {
     /**
-     * The expected plugins options for the Powerlines project.
+     * The path to the user configuration file, if it exists.
      *
      * @remarks
-     * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
+     * This is typically the `powerlines.json`, `powerlines.config.js`, or `powerlines.config.ts` file in the project root.
      */
-    plugins: Plugin<PluginContext<TResolvedConfig>>[];
+    configFile?: ConfigLayer<TUserConfig>["configFile"];
+};
+type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "release" | "clean";
+/**
+ * The configuration provided while executing Powerlines commands.
+ */
+type InlineConfig<TUserConfig extends UserConfig = UserConfig> = Partial<TUserConfig> & {
     /**
-     * A function to add a plugin to the context and update the configuration options
+     * A string identifier for the Powerlines command being executed
      */
-    addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
+    command: PowerlinesCommand;
+};
+type NewInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & Required<Pick<InlineConfig<TUserConfig>, "root">> & {
     /**
-     * A table for storing the current context for each configured environment
+     * A string identifier for the Powerlines command being executed
      */
-    environments: Record<string, EnvironmentContext<TResolvedConfig>>;
+    command: "new";
     /**
-     * Retrieves the context for a specific environment by name
-     *
-     * @throws Will throw an error if the environment does not exist
-     *
-     * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
-     * @returns A promise that resolves to the environment context.
-     *
-     * @example
-     * ```ts
-     * const devEnv = await apiContext.getEnvironment("development");
-     * const defaultEnv = await apiContext.getEnvironment();
-     * ```
+     * The package name (from the \`package.json\`) for the project that will be used in the \`new\` command to create a new project based on this configuration
      */
-    getEnvironment: (name?: string) => Promise<EnvironmentContext<TResolvedConfig>>;
+    packageName?: string;
+};
+type CleanInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
-     * Safely retrieves the context for a specific environment by name
-     *
-     * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
-     * @returns A promise that resolves to the environment context, or undefined if the environment does not exist.
-     *
-     * @example
-     * ```ts
-     * const devEnv = await apiContext.getEnvironmentSafe("development");
-     * const defaultEnv = await apiContext.getEnvironmentSafe();
-     * ```
-     *
-     * @remarks
-     * This method is similar to `getEnvironment`, but it returns `undefined` instead of throwing an error if the specified environment does not exist.
-     * This can be useful in scenarios where the existence of an environment is optional or uncertain.
-     *
-     * ```ts
-     * const testEnv = await apiContext.getEnvironmentSafe("test");
-     * if (testEnv) {
-     *   // Environment exists, safe to use it
-     * } else {
-     *   // Environment does not exist, handle accordingly
-     * }
-     * ```
-     *
-     * Using this method helps avoid unhandled exceptions in cases where an environment might not be defined.
+     * A string identifier for the Powerlines command being executed
      */
-    getEnvironmentSafe: (name?: string) => Promise<EnvironmentContext<TResolvedConfig> | undefined>;
+    command: "clean";
+};
+type PrepareInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
-     * 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.
+     * A string identifier for the Powerlines command being executed
      */
-    in: (environment: EnvironmentResolvedConfig) => Promise<EnvironmentContext<TResolvedConfig>>;
-}
-interface EnvironmentContextPlugin<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
-    plugin: Plugin<PluginContext<TResolvedConfig>>;
-    context: PluginContext<TResolvedConfig>;
-}
-interface EnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
+    command: "prepare";
+};
+type BuildInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
-     * The expected plugins options for the Powerlines project.
-     *
-     * @remarks
-     * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
+     * A string identifier for the Powerlines command being executed
      */
-    plugins: EnvironmentContextPlugin<TResolvedConfig>[];
+    command: "build";
+};
+type LintInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
-     * A function to add a plugin to the context and update the configuration options
+     * A string identifier for the Powerlines command being executed
      */
-    addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
+    command: "lint";
+};
+type DocsInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
-     * The environment specific resolved configuration
+     * A string identifier for the Powerlines command being executed
      */
-    environment: EnvironmentResolvedConfig;
+    command: "docs";
+};
+type ReleaseInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
     /**
-     * A table holding references to hook functions registered by plugins
+     * A string identifier for the Powerlines command being executed
      */
-    hooks: HooksList<PluginContext<TResolvedConfig>>;
+    command: "release";
+};
+
+interface ResolvedEntryTypeDefinition extends TypeDefinition {
     /**
-     * Retrieves the hook handlers for a specific hook name
+     * The user provided entry point in the source code
      */
-    selectHooks: <TKey extends HookKeys<PluginContext<TResolvedConfig>>>(hook: TKey, options?: SelectHooksOptions) => Hooks[TKey][];
+    input: TypeDefinition;
+    /**
+     * An optional name to use in the package export during the build process
+     */
+    output?: string;
 }
-interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
+type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview" | "mainFields" | "extensions"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr" | "mainFields" | "extensions">> & {
     /**
-     * The environment specific resolved configuration
+     * The name of the environment
      */
-    environment: EnvironmentResolvedConfig;
+    name: string;
     /**
-     * An alternative property name for the {@link log} property
-     *
-     * @remarks
-     * This is provided for compatibility with other logging libraries that expect a `logger` property.
+     * Configuration options for the preview server
      */
-    logger: LogFn;
-}
-type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & Omit<UnpluginBuildContext, "parse">;
-
-type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
-/**
- * The {@link StormWorkspaceConfig | configuration} object for an entire Powerlines workspace
- */
-type WorkspaceConfig = Partial<StormWorkspaceConfig> & Required<Pick<StormWorkspaceConfig, "workspaceRoot">>;
-type PluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<Plugin<TContext>>;
-/**
- * A configuration tuple for a Powerlines plugin.
- */
-type PluginConfigTuple<TContext extends PluginContext = PluginContext, TOptions = any> = [string | PluginFactory<TContext, TOptions>, TOptions] | [Plugin<TContext>];
-/**
- * A configuration object for a Powerlines plugin.
- */
-type PluginConfigObject<TContext extends PluginContext = PluginContext, TOptions = any> = {
-    plugin: string | PluginFactory<TContext, TOptions>;
-    options: TOptions;
-} | {
-    plugin: Plugin<TContext>;
-    options?: never;
+    preview?: ResolvedPreviewOptions;
 };
+type ResolvedAssetGlob = AssetGlob & Required<Pick<AssetGlob, "input">>;
+type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
+    assets: ResolvedAssetGlob[];
+}>;
 /**
- * A configuration tuple for a Powerlines plugin.
+ * The resolved options for the Powerlines project configuration.
  */
-type PluginConfig<TContext extends PluginContext = PluginContext> = string | PluginFactory<TContext, void> | Plugin<TContext> | Promise<Plugin<TContext>> | PluginConfigTuple<TContext> | PluginConfigObject<TContext>;
-type ProjectType = "application" | "library";
-interface OutputConfig {
+type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "override" | "root" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "override" | "framework">> & {
     /**
-     * The path to output the final compiled files to
-     *
-     * @remarks
-     * If a value is not provided, Powerlines will attempt to:
-     * 1. Use the `outDir` value in the `tsconfig.json` file.
-     * 2. Use the `dist` directory in the project root directory.
-     *
-     * @defaultValue "dist/\{projectRoot\}"
+     * The configuration options that were provided inline to the Powerlines CLI.
      */
-    outputPath?: string;
+    inlineConfig: InlineConfig<TUserConfig>;
     /**
-     * The format of the output files
-     *
-     * @defaultValue "virtual"
+     * The original configuration options that were provided by the user to the Powerlines process.
      */
-    mode?: OutputModeType;
+    userConfig: TUserConfig;
     /**
-     * The path of the generated runtime declaration file relative to the workspace root.
-     *
-     * @defaultValue "\{projectRoot\}/powerlines.d.ts"
+     * A string identifier for the Powerlines command being executed.
      */
-    dts?: string | false;
+    command: NonUndefined<InlineConfig<TUserConfig>["command"]>;
     /**
-     * A prefix to use for identifying builtin modules
-     *
-     * @remarks
-     * This prefix will be used to identify all builtin modules generated during the "prepare" phase. An example builtin ID for a module called `"utils"` would be `"{builtinPrefix}:utils"`.
+     * The root directory of the project's source code
      *
-     * @defaultValue "powerlines"
+     * @defaultValue "\{projectRoot\}/src"
      */
-    builtinPrefix?: string;
+    sourceRoot: NonUndefined<TUserConfig["sourceRoot"]>;
     /**
-     * The folder where the generated runtime artifacts will be located
-     *
-     * @remarks
-     * This folder will contain all runtime artifacts and builtins generated during the "prepare" phase.
-     *
-     * @defaultValue "\{projectRoot\}/.powerlines"
+     * The root directory of the project.
      */
-    artifactsFolder?: string;
+    projectRoot: NonUndefined<TUserConfig["root"]>;
     /**
-     * The module format of the output files
-     *
-     * @remarks
-     * This option can be a single format or an array of formats. If an array is provided, multiple builds will be generated for each format.
-     *
-     * @defaultValue "esm"
+     * The type of project being built.
      */
-    format?: Format | Format[];
+    projectType: NonUndefined<TUserConfig["type"]>;
     /**
-     * A list of assets to copy to the output directory
+     * The output configuration options to use for the build process
+     */
+    output: OutputResolvedConfig;
+    /**
+     * The log level to use for the Powerlines processes.
      *
-     * @remarks
-     * The assets can be specified as a string (path to the asset) or as an object with a `glob` property (to match multiple files). The paths are relative to the project root directory.
+     * @defaultValue "info"
      */
-    assets?: Array<string | AssetGlob>;
+    logLevel: LogLevelLabel | null;
+};
+type ViteResolvedConfig = ResolvedConfig<ViteUserConfig>;
+type WebpackResolvedConfig = ResolvedConfig<WebpackUserConfig>;
+type RspackResolvedConfig = ResolvedConfig<RspackUserConfig>;
+type ESBuildResolvedConfig = ResolvedConfig<ESBuildUserConfig>;
+type RollupResolvedConfig = ResolvedConfig<RollupUserConfig>;
+type RolldownResolvedConfig = ResolvedConfig<RolldownUserConfig>;
+type TsupResolvedConfig = ResolvedConfig<TsupUserConfig>;
+type UnbuildResolvedConfig = ResolvedConfig<UnbuildUserConfig>;
+type FarmResolvedConfig = ResolvedConfig<FarmUserConfig>;
+type InferResolvedConfig<TBuildVariant extends BuildVariant | undefined> = TBuildVariant extends undefined ? ResolvedConfig : TBuildVariant extends "webpack" ? WebpackResolvedConfig : TBuildVariant extends "rspack" ? RspackResolvedConfig : TBuildVariant extends "vite" ? ViteResolvedConfig : TBuildVariant extends "esbuild" ? ESBuildResolvedConfig : TBuildVariant extends "unbuild" ? UnbuildResolvedConfig : TBuildVariant extends "tsup" ? TsupResolvedConfig : TBuildVariant extends "rolldown" ? RolldownResolvedConfig : TBuildVariant extends "rollup" ? RollupResolvedConfig : TBuildVariant extends "farm" ? FarmResolvedConfig : ResolvedConfig;
+
+type BaseHooks<TContext extends PluginContext = PluginContext> = BasePluginHookFunctions<TContext>;
+type BaseHookKeys<TContext extends PluginContext = PluginContext> = keyof BaseHooks<TContext>;
+type ExternalHooks<TContext extends PluginContext = PluginContext> = ExternalPluginHookFunctions<TContext>;
+type ExternalHookKeys<TContext extends PluginContext = PluginContext> = keyof ExternalHooks<TContext>;
+type Hooks<TContext extends PluginContext = PluginContext> = PluginHookFunctions<TContext>;
+type HookKeys<TContext extends PluginContext = PluginContext> = keyof Hooks<TContext>;
+interface BaseHooksListItem<TContext extends PluginContext = PluginContext, TKey extends BaseHookKeys<TContext> = BaseHookKeys<TContext>> extends PluginHookObject<BaseHooks<TContext>[TKey]> {
+    plugin: Plugin<TContext>;
 }
-interface BaseConfig {
+interface BaseHooksList<TContext extends PluginContext = PluginContext, TKey extends BaseHookKeys<TContext> = BaseHookKeys<TContext>> {
+    preOrdered?: BaseHooksListItem<TContext, TKey>[];
+    preEnforced?: BaseHooksListItem<TContext, TKey>[];
+    normal?: BaseHooksListItem<TContext, TKey>[];
+    postEnforced?: BaseHooksListItem<TContext, TKey>[];
+    postOrdered?: BaseHooksListItem<TContext, TKey>[];
+}
+interface ExternalHooksListItem<TContext extends PluginContext = PluginContext, TKey extends ExternalHookKeys<TContext> = ExternalHookKeys<TContext>> {
+    plugin: Plugin<TContext>;
+    handler: ExternalHooks<TContext>[TKey];
+}
+type HooksList<TContext extends PluginContext = PluginContext> = {
+    [TKey in BaseHookKeys<TContext>]?: BaseHooksList<TContext, TKey>;
+} & {
+    [TKey in ExternalHookKeys<TContext>]?: ExternalHooksListItem<TContext, TKey>[];
+};
+type InferHookHandler<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Hooks<TContext>[TKey];
+type InferHookReturnType<TContext extends PluginContext, TKey extends HookKeys<TContext>> = ReturnType<InferHookHandler<TContext, TKey>> extends Promise<infer U> ? U extends Promise<infer V> ? V : U : ReturnType<InferHookHandler<TContext, TKey>>;
+type InferHookParameters<TContext extends PluginContext, TKey extends HookKeys<TContext>> = Parameters<InferHookHandler<TContext, TKey>>;
+
+type WorkerProcess<TExposedMethods extends ReadonlyArray<string>> = {
+    [K in TExposedMethods[number]]: (data: any) => Promise<any>;
+} & {
+    close: () => void;
+    end: () => ReturnType<Worker["end"]>;
+};
+interface MetaInfo {
     /**
-     * The name of the project
+     * The checksum generated from the resolved options
      */
-    name?: string;
+    checksum: string;
     /**
-     * The project display title
-     *
-     * @remarks
-     * This option is used in documentation generation and other places where a human-readable title is needed.
+     * The build id
      */
-    title?: string;
+    buildId: string;
     /**
-     * A description of the project
-     *
-     * @remarks
-     * If this option is not provided, the build process will try to use the \`description\` value from the `\package.json\` file.
+     * The release id
      */
-    description?: string;
+    releaseId: string;
     /**
-     * The log level to use for the Powerlines processes.
-     *
-     * @defaultValue "info"
+     * The build timestamp
      */
-    logLevel?: LogLevelLabel | null;
+    timestamp: number;
     /**
-     * A custom logger function to use for logging messages
+     * A hash that represents the path to the project root directory
      */
-    customLogger?: LogFn;
+    projectRootHash: string;
     /**
-     * Explicitly set a mode to run in. This mode will be used at various points throughout the Powerlines processes, such as when compiling the source code.
+     * A hash that represents the path to the project root directory
+     */
+    configHash: string;
+    /**
+     * A mapping of runtime ids to their corresponding file paths
+     */
+    builtinIdMap: Record<string, string>;
+    /**
+     * A mapping of virtual file paths to their corresponding file contents
+     */
+    virtualFiles: Record<string, string | null>;
+}
+interface Resolver extends Jiti {
+    plugin: Jiti;
+}
+interface SelectHooksOptions {
+    order?: "pre" | "post" | "normal";
+}
+interface InitContextOptions {
+    /**
+     * If false, the plugin will be loaded after all other plugins.
      *
-     * @defaultValue "production"
+     * @defaultValue true
      */
-    mode?: "development" | "test" | "production";
+    isHighPriority: boolean;
+}
+interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
     /**
-     * The entry point(s) for the application
+     * The Storm workspace configuration
      */
-    entry?: TypeDefinitionParameter | TypeDefinitionParameter[];
+    workspaceConfig: WorkspaceConfig;
     /**
-     * Configuration for linting the source code
+     * An object containing the options provided to Powerlines
      */
-    lint?: Record<string, any> | false;
+    config: TResolvedConfig;
     /**
-     * Configuration for the output of the build process
+     * A logging function for the Powerlines engine
      */
-    output?: OutputConfig;
+    log: LogFn;
     /**
-     * Configuration for the transformation of the source code
+     * The metadata information
      */
-    transform?: Record<string, any>;
+    meta: MetaInfo;
     /**
-     * Options to to provide to the build process
+     * The metadata information currently written to disk
      */
-    build?: BuildConfig;
+    persistedMeta?: MetaInfo;
     /**
-     * Configuration for documentation generation
-     *
-     * @remarks
-     * This configuration will be used by the documentation generation plugins during the `docs` command.
+     * The Powerlines artifacts directory
      */
-    docs?: Record<string, any>;
+    artifactsPath: string;
     /**
-     * The path to the tsconfig file to be used by the compiler
-     *
-     * @remarks
-     * If a value is not provided, the plugin will attempt to find the `tsconfig.json` file in the project root directory. The parsed tsconfig compiler options will be merged with the {@link Options.tsconfigRaw} value (if provided).
-     *
-     * @defaultValue "\{projectRoot\}/tsconfig.json"
+     * The path to the Powerlines builtin runtime modules directory
      */
-    tsconfig?: string;
+    builtinsPath: string;
     /**
-     * The raw {@link TSConfig} object to be used by the compiler. This object will be merged with the `tsconfig.json` file.
-     *
-     * @see https://www.typescriptlang.org/tsconfig
-     *
-     * @remarks
-     * If populated, this option takes higher priority than `tsconfig`
+     * The path to the Powerlines entry modules directory
+     */
+    entryPath: string;
+    /**
+     * The path to the Powerlines TypeScript declaration files directory
+     */
+    dtsPath: string;
+    /**
+     * The path to a directory where the reflection data buffers (used by the build processes) are stored
+     */
+    dataPath: string;
+    /**
+     * The path to a directory where the project cache (used by the build processes) is stored
+     */
+    cachePath: string;
+    /**
+     * The Powerlines environment paths
+     */
+    envPaths: EnvPaths;
+    /**
+     * The file system path to the Powerlines package installation
+     */
+    powerlinesPath: string;
+    /**
+     * The relative path to the Powerlines workspace root directory
+     */
+    relativeToWorkspaceRoot: string;
+    /**
+     * The project's `package.json` file content
+     */
+    packageJson: PackageJson & Record<string, any>;
+    /**
+     * The project's `project.json` file content
      */
-    tsconfigRaw?: TSConfig;
-}
-interface EnvironmentConfig extends BaseConfig {
+    projectJson?: Record<string, any>;
     /**
-     * Array of strings indicating the order in which fields in a package.json file should be resolved to determine the entry point for a module.
-     *
-     * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
+     * The dependency installations required by the project
      */
-    mainFields?: string[];
+    dependencies: Record<string, string | Range>;
     /**
-     * Array of strings indicating what conditions should be used for module resolution.
+     * The development dependency installations required by the project
      */
-    conditions?: string[];
+    devDependencies: Record<string, string | Range>;
     /**
-     * Array of strings indicating what conditions should be used for external modules.
+     * The parsed TypeScript configuration from the `tsconfig.json` file
      */
-    externalConditions?: string[];
+    tsconfig: ParsedTypeScriptConfig;
     /**
-     * Array of strings indicating what file extensions should be used for module resolution.
-     *
-     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
+     * The entry points of the source code
      */
-    extensions?: string[];
+    entry: ResolvedEntryTypeDefinition[];
     /**
-     * Array of strings indicating what modules should be deduplicated to a single version in the build.
-     *
-     * @remarks
-     * This option is useful for ensuring that only one version of a module is included in the bundle, which can help reduce bundle size and avoid conflicts.
+     * The virtual file system manager used during the build process to reference generated runtime files
      */
-    dedupe?: string[];
+    fs: VirtualFileSystemInterface;
     /**
-     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
+     * The Jiti module resolver
      */
-    builtins?: (string | RegExp)[];
+    resolver: Resolver;
     /**
-     * Configuration options for the preview server
+     * The builtin module id that exist in the Powerlines virtual file system
      */
-    preview?: PreviewOptions;
+    builtins: string[];
     /**
-     * A flag indicating whether the build is for a Server-Side Rendering environment.
+     * The Powerlines builtin virtual files
      */
-    ssr?: boolean;
+    getBuiltins: () => Promise<VirtualFile[]>;
     /**
-     * Define if this environment is used for Server-Side Rendering
+     * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
      *
-     * @defaultValue "server" (if it isn't the client environment)
+     * @param code - The source code of the builtin file
+     * @param id - The unique identifier of the builtin file
+     * @param path - An optional path to write the builtin file to
+     * @param options - Options for writing the file
      */
-    consumer?: "client" | "server";
-}
-interface CommonUserConfig extends BaseConfig {
+    writeBuiltin: (code: string, id: string, path?: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
     /**
-     * The type of project being built
+     * Resolves a entry virtual file and writes it to the VFS if it does not already exist
      *
-     * @defaultValue "application"
+     * @param code - The source code of the entry file
+     * @param path - An optional path to write the entry file to
+     * @param options - Options for writing the file
      */
-    type?: ProjectType;
+    writeEntry: (code: string, path: string, options?: PowerlinesWriteFileOptions) => Promise<void>;
     /**
-     * The root directory of the project
+     * Parses the source code and returns a {@link ParseResult} object.
      */
-    root: string;
+    parse: (code: string, id: string, options?: ParserOptions | null) => Promise<ParseResult>;
     /**
-     * The root directory of the project's source code
-     *
-     * @defaultValue "\{root\}/src"
+     * A function to update the context fields using a new user configuration options
      */
-    sourceRoot?: string;
+    withUserConfig: (userConfig: UserConfig, options?: InitContextOptions) => Promise<void>;
     /**
-     * A path to a custom configuration file to be used instead of the default `storm.json`, `powerlines.config.js`, or `powerlines.config.ts` files.
-     *
-     * @remarks
-     * This option is useful for running Powerlines commands with different configuration files, such as in CI/CD environments or when testing different configurations.
+     * A function to update the context fields using inline configuration options
      */
-    configFile?: string;
+    withInlineConfig: (inlineConfig: InlineConfig, options?: InitContextOptions) => Promise<void>;
     /**
-     * Should the Powerlines CLI processes skip installing missing packages?
+     * Create a new logger instance
      *
-     * @remarks
-     * This option is useful for CI/CD environments where the installation of packages is handled by a different process.
+     * @param name - The name to use for the logger instance
+     * @returns A logger function
+     */
+    createLog: (name: string | null) => LogFn;
+    /**
+     * Extend the current logger instance with a new name
      *
-     * @defaultValue false
+     * @param name - The name to use for the extended logger instance
+     * @returns A logger function
      */
-    skipInstalls?: boolean;
+    extendLog: (name: string) => LogFn;
+}
+interface APIContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
     /**
-     * Should the compiler processes skip any improvements that make use of cache?
+     * The expected plugins options for the Powerlines project.
      *
-     * @defaultValue false
+     * @remarks
+     * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
      */
-    skipCache?: boolean;
+    plugins: Plugin<PluginContext<TResolvedConfig>>[];
     /**
-     * A list of resolvable paths to plugins used during the build process
+     * A function to add a plugin to the context and update the configuration options
      */
-    plugins?: PluginConfig<PluginContext<any>>[];
+    addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
     /**
-     * Environment-specific configurations
+     * A table for storing the current context for each configured environment
      */
-    environments?: Record<string, EnvironmentConfig>;
+    environments: Record<string, EnvironmentContext<TResolvedConfig>>;
     /**
-     * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
+     * Retrieves the context for a specific environment by name
      *
-     * @defaultValue "powerlines"
+     * @throws Will throw an error if the environment does not exist
+     *
+     * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
+     * @returns A promise that resolves to the environment context.
+     *
+     * @example
+     * ```ts
+     * const devEnv = await apiContext.getEnvironment("development");
+     * const defaultEnv = await apiContext.getEnvironment();
+     * ```
      */
-    framework?: string;
-}
-type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = CommonUserConfig & {
-    build?: TBuildConfig & {
-        /**
-         * The build variant being used by the Powerlines engine.
-         */
-        variant?: TBuildVariant;
-    };
-    override?: Partial<TBuildResolvedConfig>;
-};
-type WebpackUserConfig = UserConfig<WebpackBuildConfig, WebpackResolvedBuildConfig, "webpack">;
-type RspackUserConfig = UserConfig<RspackBuildConfig, RspackResolvedBuildConfig, "rspack">;
-type RollupUserConfig = UserConfig<RollupBuildConfig, RollupResolvedBuildConfig, "rollup">;
-type RolldownUserConfig = UserConfig<RolldownBuildConfig, RolldownResolvedBuildConfig, "rolldown">;
-type ViteUserConfig = UserConfig<ViteBuildConfig, ViteResolvedBuildConfig, "vite">;
-type ESBuildUserConfig = UserConfig<ESBuildBuildConfig, ESBuildResolvedBuildConfig, "esbuild">;
-type UnbuildUserConfig = UserConfig<UnbuildBuildConfig, UnbuildResolvedBuildConfig, "unbuild">;
-type TsupUserConfig = UserConfig<TsupBuildConfig, TsupResolvedBuildConfig, "tsup">;
-type FarmUserConfig = UserConfig<FarmBuildConfig, FarmResolvedBuildConfig, "farm">;
-type InferUserConfig<TBuildVariant extends BuildVariant | undefined> = TBuildVariant extends "webpack" ? WebpackUserConfig : TBuildVariant extends "rspack" ? RspackUserConfig : TBuildVariant extends "vite" ? ViteUserConfig : TBuildVariant extends "esbuild" ? ESBuildUserConfig : TBuildVariant extends "unbuild" ? UnbuildUserConfig : TBuildVariant extends "tsup" ? TsupUserConfig : TBuildVariant extends "rolldown" ? RolldownUserConfig : TBuildVariant extends "rollup" ? RollupUserConfig : TBuildVariant extends "farm" ? FarmUserConfig : UserConfig;
-type InitialUserConfig<TUserConfig extends UserConfig = UserConfig> = Partial<TUserConfig> & {
-    root: string;
-};
-type ParsedUserConfig<TUserConfig extends UserConfig = UserConfig> = TUserConfig & ResolvedConfig$1<TUserConfig> & {
+    getEnvironment: (name?: string) => Promise<EnvironmentContext<TResolvedConfig>>;
     /**
-     * The path to the user configuration file, if it exists.
+     * Safely retrieves the context for a specific environment by name
+     *
+     * @param name - The name of the environment to retrieve. If not provided, the default environment is returned.
+     * @returns A promise that resolves to the environment context, or undefined if the environment does not exist.
+     *
+     * @example
+     * ```ts
+     * const devEnv = await apiContext.getEnvironmentSafe("development");
+     * const defaultEnv = await apiContext.getEnvironmentSafe();
+     * ```
      *
      * @remarks
-     * This is typically the `powerlines.json`, `powerlines.config.js`, or `powerlines.config.ts` file in the project root.
-     */
-    configFile?: ConfigLayer<TUserConfig>["configFile"];
-};
-type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "release" | "clean";
-/**
- * The configuration provided while executing Powerlines commands.
- */
-type InlineConfig<TUserConfig extends UserConfig = UserConfig> = Partial<TUserConfig> & {
-    /**
-     * A string identifier for the Powerlines command being executed
+     * This method is similar to `getEnvironment`, but it returns `undefined` instead of throwing an error if the specified environment does not exist.
+     * This can be useful in scenarios where the existence of an environment is optional or uncertain.
+     *
+     * ```ts
+     * const testEnv = await apiContext.getEnvironmentSafe("test");
+     * if (testEnv) {
+     *   // Environment exists, safe to use it
+     * } else {
+     *   // Environment does not exist, handle accordingly
+     * }
+     * ```
+     *
+     * Using this method helps avoid unhandled exceptions in cases where an environment might not be defined.
      */
-    command: PowerlinesCommand;
-};
-type NewInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & Required<Pick<InlineConfig<TUserConfig>, "root">> & {
+    getEnvironmentSafe: (name?: string) => Promise<EnvironmentContext<TResolvedConfig> | undefined>;
     /**
-     * A string identifier for the Powerlines command being executed
+     * 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.
      */
-    command: "new";
+    in: (environment: EnvironmentResolvedConfig) => Promise<EnvironmentContext<TResolvedConfig>>;
+}
+interface EnvironmentContextPlugin<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+    plugin: Plugin<PluginContext<TResolvedConfig>>;
+    context: PluginContext<TResolvedConfig>;
+}
+interface EnvironmentContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig> {
     /**
-     * The package name (from the \`package.json\`) for the project that will be used in the \`new\` command to create a new project based on this configuration
+     * The expected plugins options for the Powerlines project.
+     *
+     * @remarks
+     * This is a record of plugin identifiers to their respective options. This field is populated by the Powerlines engine during both plugin initialization and the `init` command.
      */
-    packageName?: string;
-};
-type CleanInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+    plugins: EnvironmentContextPlugin<TResolvedConfig>[];
     /**
-     * A string identifier for the Powerlines command being executed
+     * A function to add a plugin to the context and update the configuration options
      */
-    command: "clean";
-};
-type PrepareInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+    addPlugin: (plugin: Plugin<PluginContext<TResolvedConfig>>) => Promise<void>;
     /**
-     * A string identifier for the Powerlines command being executed
+     * The environment specific resolved configuration
      */
-    command: "prepare";
-};
-type BuildInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+    environment: EnvironmentResolvedConfig;
     /**
-     * A string identifier for the Powerlines command being executed
+     * A table holding references to hook functions registered by plugins
      */
-    command: "build";
-};
-type LintInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+    hooks: HooksList<PluginContext<TResolvedConfig>>;
     /**
-     * A string identifier for the Powerlines command being executed
+     * Retrieves the hook handlers for a specific hook name
      */
-    command: "lint";
-};
-type DocsInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+    selectHooks: <TKey extends HookKeys<PluginContext<TResolvedConfig>>>(hook: TKey, options?: SelectHooksOptions) => Hooks[TKey][];
+}
+interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
     /**
-     * A string identifier for the Powerlines command being executed
+     * The environment specific resolved configuration
      */
-    command: "docs";
-};
-type ReleaseInlineConfig<TUserConfig extends UserConfig = UserConfig> = InlineConfig<TUserConfig> & {
+    environment: EnvironmentResolvedConfig;
     /**
-     * A string identifier for the Powerlines command being executed
+     * An alternative property name for the {@link log} property
+     *
+     * @remarks
+     * This is provided for compatibility with other logging libraries that expect a `logger` property.
      */
-    command: "release";
-};
+    logger: LogFn;
+}
+type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & Omit<UnpluginBuildContext, "parse">;
 
 export type { APIContext as A, BaseHookKeys as B, Context as C, InitialUserConfig as D, ESBuildResolvedBuildConfig as E, PrepareInlineConfig as F, CleanInlineConfig as G, HookKeys as H, InferHookParameters as I, BuildInlineConfig as J, LintInlineConfig as K, LogFn as L, MetaInfo as M, NewInlineConfig as N, DocsInlineConfig as O, PowerlinesCommand as P, ReleaseInlineConfig as Q, ResolvedEntryTypeDefinition as R, SelectHooksOptions as S, TsupBuildConfig as T, UnbuildBuildConfig as U, ViteResolvedBuildConfig as V, WorkspaceConfig as W, ParsedUserConfig as a, RolldownResolvedBuildConfig as b, RollupResolvedBuildConfig as c, TsupResolvedBuildConfig as d, PluginContext as e, ResolvedConfig as f, Plugin as g, PluginConfigObject as h, PluginConfigTuple as i, PluginConfig as j, PluginHookObject as k, PluginHook as l, EnvironmentConfig as m, EnvironmentResolvedConfig as n, ExternalHookKeys as o, BaseHooksListItem as p, WorkerProcess as q, EnvironmentContext as r, InferHookReturnType as s, UnbuildResolvedBuildConfig as t, BuildVariant as u, InferUnpluginVariant as v, BuildPlugin as w, InferResolvedConfig as x, UnpluginBuildVariant as y, InferUserConfig as z };