@powerlines/plugin-vite 0.14.9 → 0.14.11

package/dist/helpers/index.d.cts

@@ -1,7 +1,8 @@
 export { createVitePlugin } from './unplugin.cjs';
 import 'vite';
-import '../index-C9Wkx7zv.cjs';
+import '../index-BMkoiiHF.cjs';
 import '@stryke/env/get-env-paths';
+import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
 import 'oxc-parser';
@@ -10,13 +11,10 @@ import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
-import '@stryke/types/base';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';

package/dist/helpers/index.d.ts

@@ -1,7 +1,8 @@
 export { createVitePlugin } from './unplugin.js';
 import 'vite';
-import '../index-C9Wkx7zv.js';
+import '../index-BMkoiiHF.js';
 import '@stryke/env/get-env-paths';
+import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
 import 'oxc-parser';
@@ -10,13 +11,10 @@ import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
-import '@stryke/types/base';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';

package/dist/helpers/unplugin.d.cts

@@ -1,6 +1,7 @@
 import * as vite from 'vite';
-import { V as VitePluginContext } from '../index-C9Wkx7zv.cjs';
+import { V as VitePluginContext } from '../index-BMkoiiHF.cjs';
 import '@stryke/env/get-env-paths';
+import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
 import 'oxc-parser';
@@ -9,16 +10,13 @@ import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
-import '@stryke/types/base';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 declare function createVitePlugin(context: VitePluginContext): vite.Plugin<any> | vite.Plugin<any>[];
 

package/dist/helpers/unplugin.d.ts

@@ -1,6 +1,7 @@
 import * as vite from 'vite';
-import { V as VitePluginContext } from '../index-C9Wkx7zv.js';
+import { V as VitePluginContext } from '../index-BMkoiiHF.js';
 import '@stryke/env/get-env-paths';
+import '@stryke/types/base';
 import '@stryke/types/package-json';
 import 'jiti';
 import 'oxc-parser';
@@ -9,16 +10,13 @@ import 'unplugin';
 import '@storm-software/build-tools/types';
 import '@storm-software/config-tools/types';
 import '@storm-software/config/types';
-import '@stryke/types/base';
 import '@stryke/types/configuration';
 import '@stryke/types/file';
 import '@stryke/types/array';
 import '@stryke/types/tsconfig';
 import 'typescript';
 import '@stryke/json/types';
-import 'memfs';
 import 'node:fs';
-import 'unionfs';
 
 declare function createVitePlugin(context: VitePluginContext): vite.Plugin<any> | vite.Plugin<any>[];
 

package/dist/{index-C9Wkx7zv.d.cts → index-BMkoiiHF.d.cts}

@@ -1,5 +1,6 @@
 import { UserConfig as UserConfig$1, PreviewOptions, ResolvedPreviewOptions } from 'vite';
 import { EnvPaths } from '@stryke/env/get-env-paths';
+import { MaybePromise, NonUndefined, FunctionLike } from '@stryke/types/base';
 import { PackageJson } from '@stryke/types/package-json';
 import { Jiti } from 'jiti';
 import { ParserOptions, ParseResult } from 'oxc-parser';
@@ -8,16 +9,13 @@ import { UnpluginMessage, UnpluginContext, UnpluginBuildContext, TransformResult
 import { Format } from '@storm-software/build-tools/types';
 import { LogLevelLabel } from '@storm-software/config-tools/types';
 import { StormWorkspaceConfig } from '@storm-software/config/types';
-import { MaybePromise, NonUndefined, FunctionLike } from '@stryke/types/base';
 import { TypeDefinitionParameter, TypeDefinition } from '@stryke/types/configuration';
 import { AssetGlob } from '@stryke/types/file';
 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';
 
 type UnpluginBuildVariant = "rollup" | "webpack" | "rspack" | "vite" | "esbuild" | "farm" | "unloader" | "rolldown";
 interface BuildConfig {
@@ -27,6 +25,87 @@ 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.
+     *
+     * @defaultValue `['browser', 'module', 'jsnext:main', 'jsnext']`
+     */
+    mainFields?: string[];
+    /**
+     * Array of strings indicating what conditions should be used for module resolution.
+     */
+    conditions?: string[];
+    /**
+     * Array of strings indicating what file extensions should be used for module resolution.
+     *
+     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
+     */
+    extensions?: string[];
+    /**
+     * 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.
+     */
+    dedupe?: string[];
+    /**
+     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
+     */
+    builtins?: (string | RegExp)[];
+    /**
+     * Define global variable replacements.
+     *
+     * @remarks
+     * This option allows you to specify global constants that will be replaced in the code during the build process. It is similar to the `define` option in esbuild and Vite, enabling you to replace specific identifiers with constant expressions at build time.
+     *
+     * @example
+     * ```ts
+     * {
+     *   define: {
+     *     __VERSION__: '"1.0.0"',
+     *     __DEV__: 'process.env.NODE_ENV !== "production"'
+     *   }
+     * }
+     * ```
+     *
+     * @see https://esbuild.github.io/api/#define
+     * @see https://vitejs.dev/config/build-options.html#define
+     * @see https://github.com/rollup/plugins/tree/master/packages/replace
+     */
+    define?: Record<string, any>;
+    /**
+     * Global variables that will have import statements injected where necessary
+     *
+     * @remarks
+     * This option allows you to specify global variables that should be automatically imported from specified modules whenever they are used in the code. This is particularly useful for polyfilling Node.js globals in a browser environment.
+     *
+     * @example
+     * ```ts
+     * {
+     *   inject: {
+     *     process: 'process/browser',
+     *     Buffer: ['buffer', 'Buffer'],
+     *   }
+     * }
+     * ```
+     *
+     * @see https://github.com/rollup/plugins/tree/master/packages/inject
+     */
+    inject?: Record<string, string | string[]>;
     /**
      * The alias mappings to use for module resolution during the build process.
      *
@@ -42,8 +121,13 @@ 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.
      *
@@ -60,13 +144,14 @@ interface BuildConfig {
      */
     skipNodeModulesBundle?: boolean;
     /**
-     * Should the Powerlines processes skip the `"prepare"` task prior to building?
+     * An optional set of override options to apply to the selected build variant.
      *
-     * @defaultValue false
+     * @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.
      */
-    skipPrepare?: boolean;
+    override?: Record<string, any>;
 }
-type BuildResolvedConfig = BuildConfig;
+type BuildResolvedConfig = Omit<BuildConfig, "override">;
 type ViteBuildConfig = Omit<UserConfig$1, "entry" | "entryPoints" | "tsconfig" | "tsconfigRaw" | "environments" | "output"> & BuildConfig;
 type ViteResolvedBuildConfig = UserConfig$1 & BuildResolvedConfig;
 
@@ -134,11 +219,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 {
     /**
@@ -178,7 +260,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;
 }
@@ -207,12 +306,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.
      */
@@ -232,7 +337,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).
      *
@@ -247,15 +352,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).
      *
@@ -269,7 +365,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).
      *
@@ -477,23 +573,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
+     * Formats a path to match the virtual file system (VFS) structure.
      *
-     * @param path - The path to check.
-     * @returns The resolved file path if it exists, otherwise undefined.
+     * @param path - The path to format.
+     * @returns The formatted path.
      */
-    resolveTsconfigPath: (path: string) => string | false;
-    /**
-     * Resolves a package name based on TypeScript's `tsconfig.json` paths.
-     *
-     * @see https://www.typescriptlang.org/tsconfig#paths
-     *
-     * @param path - The path to check.
-     * @returns The resolved package name if it exists, otherwise undefined.
-     */
-    resolveTsconfigPathPackage: (path: string) => string | false;
+    formatPath: (path: string) => string;
     /**
      * Resolves a path or id to a file path in the virtual file system.
      *
@@ -502,23 +587,9 @@ interface VirtualFileSystemInterface {
      */
     realpathSync: (pathOrId: string) => string;
     /**
-     * Retrieves a partial metadata mapping of all files in the virtual file system (VFS).
-     *
-     * @returns A record mapping file paths to their partial metadata.
-     */
-    getPartialMeta: () => Record<string, Partial<VirtualFileSystemMetadata>>;
-    /**
-     * A map of cached file paths to their underlying file content.
-     */
-    [__VFS_CACHE__]: Map<string, string>;
-    /**
-     * A reference to the underlying virtual file system.
-     */
-    [__VFS_VIRTUAL__]: Volume;
-    /**
-     * A reference to the underlying unified file system.
+     * Disposes of the virtual file system (VFS), writes any virtual file changes to disk, and releases any associated resources.
      */
-    [__VFS_UNIFIED__]: IUnionFs;
+    dispose: () => Promise<void>;
 }
 
 type LogFn = (type: LogLevelLabel, ...args: string[]) => void;
@@ -644,24 +715,33 @@ interface BaseConfig {
      * 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 output of the build process
-     */
-    output?: OutputConfig;
     /**
      * Configuration for the transformation of the source code
      */
     transform?: Record<string, any>;
     /**
-     * Options to to provide to the build process
+     * 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;
     /**
@@ -671,6 +751,13 @@ interface BaseConfig {
      * This configuration will be used by the documentation generation plugins during the `docs` command.
      */
     docs?: Record<string, any>;
+    /**
+     * Configuration for deploying the source code
+     *
+     * @remarks
+     * If set to `false`, the deployment will be disabled.
+     */
+    deploy?: Record<string, any> | false;
     /**
      * The path to the tsconfig file to be used by the compiler
      *
@@ -691,37 +778,6 @@ interface BaseConfig {
     tsconfigRaw?: TSConfig;
 }
 interface EnvironmentConfig extends BaseConfig {
-    /**
-     * 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']`
-     */
-    mainFields?: string[];
-    /**
-     * Array of strings indicating what conditions should be used for module resolution.
-     */
-    conditions?: string[];
-    /**
-     * Array of strings indicating what conditions should be used for external modules.
-     */
-    externalConditions?: string[];
-    /**
-     * Array of strings indicating what file extensions should be used for module resolution.
-     *
-     * @defaultValue `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
-     */
-    extensions?: string[];
-    /**
-     * 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.
-     */
-    dedupe?: string[];
-    /**
-     * Array of strings or regular expressions that indicate what modules are builtin for the environment.
-     */
-    builtins?: (string | RegExp)[];
     /**
      * Configuration options for the preview server
      */
@@ -794,17 +850,29 @@ interface CommonUserConfig extends BaseConfig {
      */
     framework?: string;
 }
-type UserConfig<TBuildConfig extends BuildConfig = BuildConfig, TBuildResolvedConfig extends BuildResolvedConfig = BuildResolvedConfig, TBuildVariant extends string = any> = CommonUserConfig & {
-    build?: TBuildConfig & {
+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>;
     };
-    override?: Partial<TBuildResolvedConfig>;
 };
 type ViteUserConfig = UserConfig<ViteBuildConfig, ViteResolvedBuildConfig, "vite">;
-type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "release" | "clean";
+type PowerlinesCommand = "new" | "prepare" | "build" | "lint" | "test" | "docs" | "deploy" | "clean";
 /**
  * The configuration provided while executing Powerlines commands.
  */
@@ -825,7 +893,7 @@ interface ResolvedEntryTypeDefinition extends TypeDefinition {
      */
     output?: string;
 }
-type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview" | "mainFields" | "extensions"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr" | "mainFields" | "extensions">> & {
+type EnvironmentResolvedConfig = Omit<EnvironmentConfig, "consumer" | "mode" | "ssr" | "preview"> & Required<Pick<EnvironmentConfig, "consumer" | "mode" | "ssr">> & {
     /**
      * The name of the environment
      */
@@ -842,7 +910,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" | "override" | "root" | "variant" | "type" | "output" | "logLevel" | "framework"> & Required<Pick<TUserConfig, "name" | "title" | "plugins" | "mode" | "environments" | "tsconfig" | "lint" | "test" | "build" | "transform" | "override" | "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.
      */
@@ -873,6 +941,13 @@ type ResolvedConfig<TUserConfig extends UserConfig = UserConfig> = Omit<TUserCon
      * The output configuration options to use for the build process
      */
     output: OutputResolvedConfig;
+    /**
+     * 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<TUserConfig["build"], "override"> & Required<Pick<Required<TUserConfig["build"]>, "override">>;
     /**
      * The log level to use for the Powerlines processes.
      *
@@ -907,14 +982,6 @@ interface MetaInfo {
      * 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;
@@ -927,7 +994,13 @@ interface InitContextOptions {
      */
     isHighPriority: boolean;
 }
-interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
+/**
+ * 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
      */
@@ -935,7 +1008,10 @@ interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
     /**
      * An object containing the options provided to Powerlines
      */
-    config: TResolvedConfig;
+    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
      */
@@ -1092,6 +1168,12 @@ interface Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> {
      */
     extendLog: (name: string) => LogFn;
 }
+type Context<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = Omit<UnresolvedContext<TResolvedConfig>, "config"> & {
+    /**
+     * The fully resolved Powerlines configuration
+     */
+    config: TResolvedConfig;
+};
 interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedConfig> extends Context<TResolvedConfig>, UnpluginContext {
     /**
      * The environment specific resolved configuration
@@ -1107,7 +1189,7 @@ interface PluginContext<out TResolvedConfig extends ResolvedConfig = ResolvedCon
 }
 type BuildPluginContext<TResolvedConfig extends ResolvedConfig = ResolvedConfig> = PluginContext<TResolvedConfig> & Omit<UnpluginBuildContext, "parse">;
 
-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 PluginHookObject<THookFunction extends FunctionLike, TFilter extends keyof HookFilter = never> {
@@ -1132,6 +1214,10 @@ interface GenerateTypesResult {
     directives?: string[];
     code: string;
 }
+type DeepPartial<T> = {
+    [K in keyof T]?: DeepPartial<T[K]>;
+};
+type ConfigResult<TContext extends PluginContext = PluginContext> = DeepPartial<TContext["config"]> & Record<string, any>;
 interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext> extends Record<CommandType, (this: TContext) => MaybePromise<void>> {
     /**
      * A function that returns configuration options to be merged with the build context's options.
@@ -1147,7 +1233,7 @@ interface BasePluginHookFunctions<TContext extends PluginContext = PluginContext
      * @param config - The partial configuration object to be modified.
      * @returns A promise that resolves to a partial configuration object.
      */
-    config: (this: Context<TContext["config"]>) => MaybePromise<Partial<TContext["config"]["userConfig"]>>;
+    config: (this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>;
     /**
      * Modify environment configs before it's resolved. The hook can either mutate the passed-in environment config directly, or return a partial config object that will be deeply merged into existing config.
      *
@@ -1250,7 +1336,7 @@ type PluginHooks<TContext extends PluginContext = PluginContext> = {
      * @param config - The partial configuration object to be modified.
      * @returns A promise that resolves to a partial configuration object.
      */
-    config: PluginHook<(this: Context<TContext["config"]>) => MaybePromise<Partial<TContext["config"]["userConfig"]>>> | Partial<TContext["config"]["userConfig"]>;
+    config: PluginHook<(this: UnresolvedContext<TContext["config"]>) => MaybePromise<ConfigResult<TContext>>> | ConfigResult<TContext>;
     /**
      * A hook that is called to transform the source code.
      *