powerlines 0.20.0 → 0.22.0

package/dist/plugin-utils/{config-pwKiZvzJ.d.cts → context-BseW8r26.d.cts}

@@ -1,23 +1,21 @@
+import { EnvPaths } from '@stryke/env/get-env-paths';
+import { NonUndefined, MaybePromise, FunctionLike, DeepPartial as DeepPartial$1 } from '@stryke/types/base';
+import { PackageJson } from '@stryke/types/package-json';
+import { Jiti } from 'jiti';
+import { ParserOptions, ParseResult } from 'oxc-parser';
+import { Range } from 'semver';
+import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginContext, UnpluginBuildContext, UnpluginMessage } from 'unplugin';
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { StormWorkspaceConfig } from '@storm-software/config/types';
-import { NonUndefined, MaybePromise, FunctionLike, DeepPartial as DeepPartial$1 } from '@stryke/types/base';
 import { TypeDefinition, TypeDefinitionParameter } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
 import { ResolvedPreviewOptions, PreviewOptions } from 'vite';
-import { EnvPaths } from '@stryke/env/get-env-paths';
-import { PackageJson } from '@stryke/types/package-json';
-import { Jiti } from 'jiti';
-import { ParserOptions, ParseResult } from 'oxc-parser';
-import { Range } from 'semver';
-import { TransformResult, ExternalIdResult, HookFilter, UnpluginOptions, UnpluginMessage, UnpluginBuildContext, UnpluginContext } from 'unplugin';
-import { ArrayValues } from '@stryke/types/array';
 import { TsConfigJson, CompilerOptions } from '@stryke/types/tsconfig';
 import ts from 'typescript';
 import { PrimitiveJsonValue } from '@stryke/json/types';
-import { Volume } from 'memfs';
 import { PathLike, StatSyncOptions, Stats, RmDirOptions, RmOptions, Mode, MakeDirectoryOptions as MakeDirectoryOptions$1, PathOrFileDescriptor, WriteFileOptions as WriteFileOptions$1 } from 'node:fs';
-import { IUnionFs } from 'unionfs';
+import { ArrayValues } from '@stryke/types/array';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
 type BuildVariant = UnpluginBuildVariant | "tsup" | "unbuild";
@@ -28,6 +26,20 @@ interface BuildConfig {
      * @defaultValue "neutral"
      */
     platform?: "node" | "browser" | "neutral";
+    /**
+     * Array of strings indicating the polyfills to include for the build.
+     *
+     * @remarks
+     * This option allows you to specify which polyfills should be included in the build process to ensure compatibility with the target environment. The paths for the polyfills can use placeholder tokens (the `replacePathTokens` helper function will be used to resolve the actual values).
+     *
+     * @example
+     * ```ts
+     * {
+     *   polyfill: ['{projectRoot}/custom-polyfill.ts']
+     * }
+     * ```
+     */
+    polyfill?: string[];
     /**
      * 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.
      *
@@ -113,7 +125,10 @@ interface BuildConfig {
      *
      * @see https://github.com/rollup/plugins/tree/master/packages/alias
      */
-    alias?: Record<string, string>;
+    alias?: Record<string, string> | Array<{
+        find: string | RegExp;
+        replacement: string;
+    }>;
     /**
      * A list of modules that should not be bundled, even if they are external dependencies.
      *
@@ -139,7 +154,7 @@ interface BuildConfig {
 }
 type BuildResolvedConfig = Omit<BuildConfig, "override">;
 
-declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "release", "finalize"];
+declare const SUPPORTED_COMMANDS: readonly ["new", "clean", "prepare", "lint", "test", "build", "docs", "deploy", "finalize"];
 type CommandType = ArrayValues<typeof SUPPORTED_COMMANDS>;
 
 interface ResolvedEntryTypeDefinition extends TypeDefinition {
@@ -169,7 +184,7 @@ type OutputResolvedConfig = Required<Omit<OutputConfig, "assets"> & {
 /**
  * The resolved options for the Powerlines project configuration.
  */
-type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "framework">> & {
+type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "platform" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "deploy" | "framework">> & {
     /**
      * The configuration options that were provided inline to the Powerlines CLI.
      */
@@ -507,11 +522,8 @@ type ParsedTypeScriptConfig = ts.ParsedCommandLine & {
     tsconfigFilePath: string;
 };
 
-declare const __VFS_INIT__ = "__VFS_INIT__";
-declare const __VFS_REVERT__ = "__VFS_REVERT__";
-declare const __VFS_CACHE__ = "__VFS_CACHE__";
-declare const __VFS_VIRTUAL__ = "__VFS_VIRTUAL__";
-declare const __VFS_UNIFIED__ = "__VFS_UNIFIED__";
+declare const __VFS_PATCH__: unique symbol;
+declare const __VFS_REVERT__: unique symbol;
 type OutputModeType = "fs" | "virtual";
 interface VirtualFile {
     /**
@@ -551,7 +563,24 @@ interface VirtualFile {
      */
     code: string | NodeJS.ArrayBufferView;
 }
-type VirtualFileSystemMetadata = Pick<VirtualFile, "id" | "details" | "variant" | "mode">;
+interface VirtualFileMetadata {
+    /**
+     * The identifier for the file data.
+     */
+    id: string;
+    /**
+     * The variant of the file.
+     */
+    variant: string;
+    /**
+     * The output mode of the file.
+     */
+    mode: string;
+    /**
+     * Additional metadata associated with the file.
+     */
+    properties: Record<string, string>;
+}
 interface ResolveFSOptions {
     mode?: OutputModeType;
 }
@@ -580,12 +609,18 @@ interface ResolvePathOptions extends ResolveFSOptions {
     type?: "file" | "directory";
 }
 interface VirtualFileSystemInterface {
-    [__VFS_INIT__]: () => void;
+    /**
+     * Patches the File System to include the virtual file system (VFS) contents.
+     */
+    [__VFS_PATCH__]: () => void;
+    /**
+     * Reverts the virtual file system (VFS) to its previous state.
+     */
     [__VFS_REVERT__]: () => void;
     /**
      * The underlying file metadata.
      */
-    meta: Record<string, VirtualFileSystemMetadata | undefined>;
+    metadata: Record<string, VirtualFileMetadata | undefined>;
     /**
      * A map of module ids to their file paths.
      */
@@ -605,7 +640,7 @@ interface VirtualFileSystemInterface {
      * @param options - Optional parameters for resolving the path.
      * @returns Whether the path or id corresponds to a file written to the file system **(actually exists on disk)**.
      */
-    isFs: (pathOrId: string, options?: ResolvePathOptions) => boolean;
+    isPhysical: (pathOrId: string, options?: ResolvePathOptions) => boolean;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -620,15 +655,6 @@ interface VirtualFileSystemInterface {
      * @returns `true` if the directory exists, otherwise `false`.
      */
     isDirectory: (path: string) => boolean;
-    /**
-     * Check if a path exists within one of the directories specified in the tsconfig.json's `path` field.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @param pathOrId - The path or id to check.
-     * @returns Whether the path or id corresponds to a virtual file.
-     */
-    isTsconfigPath: (pathOrId: string) => boolean;
     /**
      * Checks if a file exists in the virtual file system (VFS).
      *
@@ -642,7 +668,7 @@ interface VirtualFileSystemInterface {
      * @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;
+    getMetadata: (pathOrId: PathLike) => VirtualFileMetadata | undefined;
     /**
      * Gets the stats of a file in the virtual file system (VFS).
      *
@@ -850,23 +876,12 @@ interface VirtualFileSystemInterface {
      */
     resolve: (pathOrId: string, options?: ResolvePathOptions) => string | false;
     /**
-     * Resolves a path based on TypeScript's `tsconfig.json` paths.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @param path - The path to check.
-     * @returns The resolved file path if it exists, otherwise undefined.
-     */
-    resolveTsconfigPath: (path: string) => string | false;
-    /**
-     * Resolves a package name based on TypeScript's `tsconfig.json` paths.
+     * Formats a path to match the virtual file system (VFS) structure.
      *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @param path - The path to check.
-     * @returns The resolved package name if it exists, otherwise undefined.
+     * @param path - The path to format.
+     * @returns The formatted path.
      */
-    resolveTsconfigPathPackage: (path: string) => string | false;
+    formatPath: (path: string) => string;
     /**
      * Resolves a path or id to a file path in the virtual file system.
      *
@@ -875,131 +890,401 @@ interface VirtualFileSystemInterface {
      */
     realpathSync: (pathOrId: string) => string;
     /**
-     * Retrieves a partial metadata mapping of all files in the virtual file system (VFS).
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
+     */
+    dispose: () => Promise<void>;
+}
+
+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;
+};
+/**
+ * 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 PartialPlugin<in out TContext extends PluginContext = PluginContext> = DeepPartial$1<Plugin<TContext>>;
+type PartialPluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<PartialPlugin<TContext>>;
+type ProjectType = "application" | "library";
+interface OutputConfig {
+    /**
+     * 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.
      *
-     * @returns A record mapping file paths to their partial metadata.
+     * @defaultValue "dist/\{projectRoot\}"
      */
-    getPartialMeta: () => Record<string, Partial<VirtualFileSystemMetadata>>;
+    outputPath?: string;
     /**
-     * A map of cached file paths to their underlying file content.
+     * The format of the output files
+     *
+     * @defaultValue "virtual"
      */
-    [__VFS_CACHE__]: Map<string, string>;
+    mode?: OutputModeType;
     /**
-     * A reference to the underlying virtual file system.
+     * The path of the generated runtime declaration file relative to the workspace root.
+     *
+     * @defaultValue "\{projectRoot\}/powerlines.d.ts"
      */
-    [__VFS_VIRTUAL__]: Volume;
+    dts?: string | false;
     /**
-     * A reference to the underlying unified file system.
+     * 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"
      */
-    [__VFS_UNIFIED__]: IUnionFs;
-}
-
-interface MetaInfo {
+    builtinPrefix?: string;
     /**
-     * The checksum generated from the resolved options
+     * 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"
      */
-    checksum: string;
+    artifactsFolder?: string;
     /**
-     * The build id
+     * 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"
      */
-    buildId: string;
+    format?: Format | Format[];
     /**
-     * The release id
+     * 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.
      */
-    releaseId: string;
+    assets?: Array<string | AssetGlob>;
+}
+interface BaseConfig {
     /**
-     * The build timestamp
+     * The name of the project
      */
-    timestamp: number;
+    name?: string;
     /**
-     * A hash that represents the path to the project root directory
+     * The project display title
+     *
+     * @remarks
+     * This option is used in documentation generation and other places where a human-readable title is needed.
      */
-    projectRootHash: string;
+    title?: string;
     /**
-     * A hash that represents the path to the project root directory
+     * 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.
      */
-    configHash: string;
+    description?: string;
     /**
-     * A mapping of runtime ids to their corresponding file paths
+     * The log level to use for the Powerlines processes.
+     *
+     * @defaultValue "info"
      */
-    builtinIdMap: Record<string, string>;
+    logLevel?: LogLevelLabel | null;
     /**
-     * A mapping of virtual file paths to their corresponding file contents
+     * A custom logger function to use for logging messages
      */
-    virtualFiles: Record<string, string | null>;
-}
-interface Resolver extends Jiti {
-    plugin: Jiti;
-}
-interface InitContextOptions {
+    customLogger?: LogFn;
     /**
-     * If false, the plugin will be loaded after all other plugins.
+     * 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 true
+     * @defaultValue "production"
      */
-    isHighPriority: boolean;
-}
-/**
- * The unresolved Powerlines context.
- *
- * @remarks
- * This context is used before the user configuration has been fully resolved after the `config`.
- */
-interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+    mode?: "development" | "test" | "production";
     /**
-     * The Storm workspace configuration
+     * The entry point(s) for the application
      */
-    workspaceConfig: WorkspaceConfig;
+    entry?: TypeDefinitionParameter | TypeDefinitionParameter[];
     /**
-     * An object containing the options provided to Powerlines
+     * Configuration for the output of the build process
      */
-    config: Omit<TResolvedConfig["userConfig"], "build" | "output"> & Required<Pick<TResolvedConfig["userConfig"], "build" | "output">> & {
-        projectRoot: NonUndefined<TResolvedConfig["userConfig"]["root"]>;
-        output: TResolvedConfig["output"];
-    };
+    output?: OutputConfig;
     /**
-     * A logging function for the Powerlines engine
+     * Configuration for linting the source code
+     *
+     * @remarks
+     * If set to `false`, linting will be disabled.
      */
-    log: LogFn;
+    lint?: Record<string, any> | false;
     /**
-     * A logging function for fatal messages
+     * Configuration for testing the source code
+     *
+     * @remarks
+     * If set to `false`, testing will be disabled.
      */
-    fatal: (message: string | UnpluginMessage) => void;
+    test?: Record<string, any> | false;
     /**
-     * A logging function for error messages
+     * Configuration for the transformation of the source code
      */
-    error: (message: string | UnpluginMessage) => void;
+    transform?: Record<string, any>;
     /**
-     * A logging function for warning messages
+     * Configuration provided to build processes
+     *
+     * @remarks
+     * This configuration can be used by plugins during the `build` command. It will generally contain options specific to the selected {@link BuildVariant | build variant}.
      */
-    warn: (message: string | UnpluginMessage) => void;
+    build?: BuildConfig;
     /**
-     * A logging function for informational messages
+     * Configuration for documentation generation
+     *
+     * @remarks
+     * This configuration will be used by the documentation generation plugins during the `docs` command.
      */
-    info: (message: string | UnpluginMessage) => void;
+    docs?: Record<string, any>;
     /**
-     * A logging function for debug messages
+     * Configuration for deploying the source code
+     *
+     * @remarks
+     * If set to `false`, the deployment will be disabled.
      */
-    debug: (message: string | UnpluginMessage) => void;
+    deploy?: Record<string, any> | false;
     /**
-     * A logging function for trace messages
+     * 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"
      */
-    trace: (message: string | UnpluginMessage) => void;
+    tsconfig?: string;
     /**
-     * The metadata information
+     * 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`
      */
-    meta: MetaInfo;
+    tsconfigRaw?: TSConfig;
+}
+interface EnvironmentConfig extends BaseConfig {
     /**
-     * The metadata information currently written to disk
+     * Configuration options for the preview server
      */
-    persistedMeta?: MetaInfo;
+    preview?: PreviewOptions;
     /**
-     * The Powerlines artifacts directory
+     * A flag indicating whether the build is for a Server-Side Rendering environment.
      */
-    artifactsPath: string;
+    ssr?: boolean;
     /**
-     * The path to the Powerlines builtin runtime modules directory
-     */
+     * Define if this environment is used for Server-Side Rendering
+     *
+     * @defaultValue "server" (if it isn't the client environment)
+     */
+    consumer?: "client" | "server";
+}
+interface CommonUserConfig extends BaseConfig {
+    /**
+     * The type of project being built
+     *
+     * @defaultValue "application"
+     */
+    type?: ProjectType;
+    /**
+     * The root directory of the project
+     */
+    root: string;
+    /**
+     * The root directory of the project's source code
+     *
+     * @defaultValue "\{root\}/src"
+     */
+    sourceRoot?: string;
+    /**
+     * 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.
+     */
+    configFile?: string;
+    /**
+     * 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
+     */
+    skipInstalls?: boolean;
+    /**
+     * Should the compiler processes skip any improvements that make use of cache?
+     *
+     * @defaultValue false
+     */
+    skipCache?: boolean;
+    /**
+     * A list of resolvable paths to plugins used during the build process
+     */
+    plugins?: PluginConfig<PluginContext<any>>[];
+    /**
+     * Environment-specific configurations
+     */
+    environments?: Record<string, EnvironmentConfig>;
+    /**
+     * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
+     *
+     * @remarks
+     * If no values are provided for {@link OutputConfig.dts | output.dts}, {@link OutputConfig.builtinPrefix | output.builtinPrefix}, or {@link OutputConfig.artifactsFolder | output.artifactsFolder}, this value will be used as the default.
+     *
+     * @defaultValue "powerlines"
+     */
+    framework?: string;
+}
+type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = Omit<CommonUserConfig, "build"> & {
+    /**
+     * Configuration provided to build processes
+     *
+     * @remarks
+     * This configuration can be used by plugins during the `build` command. It will generally contain options specific to the selected {@link BuildVariant | build variant}.
+     */
+    build: Omit<TBuildConfig, "override"> & {
+        /**
+         * The build variant being used by the Powerlines engine.
+         */
+        variant?: TBuildVariant;
+        /**
+         * An optional set of override options to apply to the selected build variant.
+         *
+         * @remarks
+         * This option allows you to provide configuration options with the guarantee that they will **not** be overridden and will take precedence over other build configurations.
+         */
+        override?: Partial<TBuildResolvedConfig>;
+    };
+};
+type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "deploy" | "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
+     */
+    command: PowerlinesCommand;
+};
+
+interface MetaInfo {
+    /**
+     * The checksum generated from the resolved options
+     */
+    checksum: string;
+    /**
+     * The build id
+     */
+    buildId: string;
+    /**
+     * The release id
+     */
+    releaseId: string;
+    /**
+     * The build timestamp
+     */
+    timestamp: number;
+    /**
+     * A hash that represents the path to the project root directory
+     */
+    projectRootHash: string;
+    /**
+     * A hash that represents the path to the project root directory
+     */
+    configHash: string;
+}
+interface Resolver extends Jiti {
+    plugin: Jiti;
+}
+interface InitContextOptions {
+    /**
+     * If false, the plugin will be loaded after all other plugins.
+     *
+     * @defaultValue true
+     */
+    isHighPriority: boolean;
+}
+/**
+ * The unresolved Powerlines context.
+ *
+ * @remarks
+ * This context is used before the user configuration has been fully resolved after the `config`.
+ */
+interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+    /**
+     * The Storm workspace configuration
+     */
+    workspaceConfig: WorkspaceConfig;
+    /**
+     * An object containing the options provided to Powerlines
+     */
+    config: Omit<TResolvedConfig["userConfig"], "build" | "output"> & Required<Pick<TResolvedConfig["userConfig"], "build" | "output">> & {
+        projectRoot: NonUndefined<TResolvedConfig["userConfig"]["root"]>;
+        output: TResolvedConfig["output"];
+    };
+    /**
+     * A logging function for the Powerlines engine
+     */
+    log: LogFn;
+    /**
+     * A logging function for fatal messages
+     */
+    fatal: (message: string | UnpluginMessage) => void;
+    /**
+     * A logging function for error messages
+     */
+    error: (message: string | UnpluginMessage) => void;
+    /**
+     * A logging function for warning messages
+     */
+    warn: (message: string | UnpluginMessage) => void;
+    /**
+     * A logging function for informational messages
+     */
+    info: (message: string | UnpluginMessage) => void;
+    /**
+     * A logging function for debug messages
+     */
+    debug: (message: string | UnpluginMessage) => void;
+    /**
+     * A logging function for trace messages
+     */
+    trace: (message: string | UnpluginMessage) => void;
+    /**
+     * The metadata information
+     */
+    meta: MetaInfo;
+    /**
+     * The metadata information currently written to disk
+     */
+    persistedMeta?: MetaInfo;
+    /**
+     * The Powerlines artifacts directory
+     */
+    artifactsPath: string;
+    /**
+     * The path to the Powerlines builtin runtime modules directory
+     */
     builtinsPath: string;
     /**
      * The path to the Powerlines entry modules directory
@@ -1134,289 +1419,4 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
 }
 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;
-};
-/**
- * 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 PartialPlugin<in out TContext extends PluginContext = PluginContext> = DeepPartial$1<Plugin<TContext>>;
-type PartialPluginFactory<in out TContext extends PluginContext = PluginContext, TOptions = any> = (options: TOptions) => MaybePromise<PartialPlugin<TContext>>;
-type ProjectType = "application" | "library";
-interface OutputConfig {
-    /**
-     * 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\}"
-     */
-    outputPath?: string;
-    /**
-     * The format of the output files
-     *
-     * @defaultValue "virtual"
-     */
-    mode?: OutputModeType;
-    /**
-     * The path of the generated runtime declaration file relative to the workspace root.
-     *
-     * @defaultValue "\{projectRoot\}/powerlines.d.ts"
-     */
-    dts?: string | false;
-    /**
-     * 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"
-     */
-    builtinPrefix?: string;
-    /**
-     * 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"
-     */
-    artifactsFolder?: string;
-    /**
-     * 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"
-     */
-    format?: Format | Format[];
-    /**
-     * 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.
-     */
-    assets?: Array<string | AssetGlob>;
-}
-interface BaseConfig {
-    /**
-     * The name of the project
-     */
-    name?: string;
-    /**
-     * The project display title
-     *
-     * @remarks
-     * This option is used in documentation generation and other places where a human-readable title is needed.
-     */
-    title?: 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.
-     */
-    description?: string;
-    /**
-     * The log level to use for the Powerlines processes.
-     *
-     * @defaultValue "info"
-     */
-    logLevel?: LogLevelLabel | null;
-    /**
-     * A custom logger function to use for logging messages
-     */
-    customLogger?: LogFn;
-    /**
-     * 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"
-     */
-    mode?: "development" | "test" | "production";
-    /**
-     * The entry point(s) for the application
-     */
-    entry?: TypeDefinitionParameter | TypeDefinitionParameter[];
-    /**
-     * Configuration for the output of the build process
-     */
-    output?: OutputConfig;
-    /**
-     * Configuration for linting the source code
-     *
-     * @remarks
-     * If set to `false`, linting will be disabled.
-     */
-    lint?: Record<string, any> | false;
-    /**
-     * Configuration for testing the source code
-     *
-     * @remarks
-     * If set to `false`, testing will be disabled.
-     */
-    test?: Record<string, any> | false;
-    /**
-     * Configuration for the transformation of the source code
-     */
-    transform?: Record<string, any>;
-    /**
-     * Configuration provided to build processes
-     *
-     * @remarks
-     * This configuration can be used by plugins during the `build` command. It will generally contain options specific to the selected {@link BuildVariant | build variant}.
-     */
-    build?: BuildConfig;
-    /**
-     * Configuration for documentation generation
-     *
-     * @remarks
-     * This configuration will be used by the documentation generation plugins during the `docs` command.
-     */
-    docs?: Record<string, any>;
-    /**
-     * 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"
-     */
-    tsconfig?: 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`
-     */
-    tsconfigRaw?: TSConfig;
-}
-interface EnvironmentConfig extends BaseConfig {
-    /**
-     * Configuration options for the preview server
-     */
-    preview?: PreviewOptions;
-    /**
-     * A flag indicating whether the build is for a Server-Side Rendering environment.
-     */
-    ssr?: boolean;
-    /**
-     * Define if this environment is used for Server-Side Rendering
-     *
-     * @defaultValue "server" (if it isn't the client environment)
-     */
-    consumer?: "client" | "server";
-}
-interface CommonUserConfig extends BaseConfig {
-    /**
-     * The type of project being built
-     *
-     * @defaultValue "application"
-     */
-    type?: ProjectType;
-    /**
-     * The root directory of the project
-     */
-    root: string;
-    /**
-     * The root directory of the project's source code
-     *
-     * @defaultValue "\{root\}/src"
-     */
-    sourceRoot?: string;
-    /**
-     * 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.
-     */
-    configFile?: string;
-    /**
-     * 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
-     */
-    skipInstalls?: boolean;
-    /**
-     * Should the compiler processes skip any improvements that make use of cache?
-     *
-     * @defaultValue false
-     */
-    skipCache?: boolean;
-    /**
-     * A list of resolvable paths to plugins used during the build process
-     */
-    plugins?: PluginConfig<PluginContext<any>>[];
-    /**
-     * Environment-specific configurations
-     */
-    environments?: Record<string, EnvironmentConfig>;
-    /**
-     * A string identifier that allows a child framework or tool to identify itself when using Powerlines.
-     *
-     * @remarks
-     * If no values are provided for {@link OutputConfig.dts | output.dts}, {@link OutputConfig.builtinPrefix | output.builtinPrefix}, or {@link OutputConfig.artifactsFolder | output.artifactsFolder}, this value will be used as the default.
-     *
-     * @defaultValue "powerlines"
-     */
-    framework?: string;
-}
-type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = Omit<CommonUserConfig, "build"> & {
-    /**
-     * Configuration provided to build processes
-     *
-     * @remarks
-     * This configuration can be used by plugins during the `build` command. It will generally contain options specific to the selected {@link BuildVariant | build variant}.
-     */
-    build: Omit<TBuildConfig, "override"> & {
-        /**
-         * The build variant being used by the Powerlines engine.
-         */
-        variant?: TBuildVariant;
-        /**
-         * An optional set of override options to apply to the selected build variant.
-         *
-         * @remarks
-         * This option allows you to provide configuration options with the guarantee that they will **not** be overridden and will take precedence over other build configurations.
-         */
-        override?: Partial<TBuildResolvedConfig>;
-    };
-};
-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
-     */
-    command: PowerlinesCommand;
-};
-
-export type { BuildVariant as B, Context as C, ExternalPluginHookFunctions as E, GenerateTypesResult as G, PluginContext as P, ResolvedConfig as R, UnresolvedContext as U, Plugin as a, PluginFactory as b, PartialPlugin as c, PartialPluginFactory as d, BasePluginHookFunctions as e, PluginHookFunctions as f, PluginHookObject as g, PluginConfigObject as h, PluginConfigTuple as i, PluginConfig as j, PluginHook as k, ConfigResult as l, EnvironmentConfig as m, EnvironmentResolvedConfig as n };
+export type { BuildVariant as B, ConfigResult as C, ExternalPluginHookFunctions as E, GenerateTypesResult as G, PluginContext as P, ResolvedConfig as R, UnresolvedContext as U, Plugin as a, PluginFactory as b, PartialPlugin as c, PartialPluginFactory as d, BasePluginHookFunctions as e, PluginHookFunctions as f, PluginHookObject as g, PluginConfigObject as h, PluginConfigTuple as i, PluginConfig as j, PluginHook as k, EnvironmentConfig as l, EnvironmentResolvedConfig as m };